NAME    [Toc]    [Back]

       sleep - Suspend execution for an interval of time

SYNOPSIS    [Toc]    [Back]

       #include <unistd.h>

       unsigned int sleep(
               unsigned int seconds );

LIBRARY    [Toc]    [Back]

       Standard C Library (libc)

       Threads Library (libpthreads.a)

STANDARDS    [Toc]    [Back]

       Interfaces  documented  on  this reference page conform to
       industry standards as follows:

       sleep(): XPG4, XPG4-UNIX

       Refer to the standards(5) reference page for more information
 about industry standards and associated tags.

PARAMETERS    [Toc]    [Back]

       Specifies the number of seconds to sleep.

DESCRIPTION    [Toc]    [Back]

       The  sleep()  function suspends execution of a process for
       the interval specified by the seconds parameter.  The suspension
  time  may  be  longer  than  requested due to the
       scheduling of other activity by the system.

       In a multi-threaded environment, the sleep()  function  is
       redefined so that only the calling thread is suspended.

RETURN VALUES    [Toc]    [Back]

       If the sleep() function returns because the requested time
       has elapsed, it returns 0 (zero). If the sleep()  function
       returns  because  it caught a signal, the function returns
       the number of seconds remaining in the suspension.

SEE ALSO    [Toc]    [Back]

       Commands: wall(1), shutdown(8) sleep(1)

       Functions: sigaction(2), alarm(3), pause(3)

       Standards: standards(5)



                                                         sleep(3)