Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
SLEEP(3)		    Library Functions Manual		      SLEEP(3)

NAME
       sleep --	suspend	thread execution for an	interval measured in seconds

LIBRARY
       Standard	C Library (libc, -lc)

SYNOPSIS
       #include	<unistd.h>

       unsigned	int
       sleep(unsigned int seconds);

DESCRIPTION
       The sleep() function suspends execution of the calling thread until ei-
       ther  seconds  seconds  have  elapsed  or  a signal is delivered	to the
       thread and its action is	to invoke a  signal-catching  function	or  to
       terminate  the  thread  or  process.   System activity may lengthen the
       sleep by	an indeterminate amount.

       This function is	implemented using nanosleep(2) by pausing for  seconds
       seconds	or  until  a signal occurs.  Consequently, in this implementa-
       tion, sleeping has no effect on the state of process timers, and	 there
       is no special handling for SIGALRM.

RETURN VALUES
       If the sleep() function returns because the requested time has elapsed,
       the  value  returned will be zero.  If the sleep() function returns due
       to the delivery of a signal, the	value returned	will  be  the  unslept
       amount (the requested time minus	the time actually slept) in seconds.

SEE ALSO
       nanosleep(2), usleep(3)

STANDARDS
       The sleep() function conforms to	ISO/IEC	9945-1:1990 ("POSIX.1").

HISTORY
       A sleep() function appeared in Version 7	AT&T UNIX.

FreeBSD	14.3		       February	13, 1998		      SLEEP(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=sleep&sektion=3&manpath=FreeBSD+14.3-RELEASE+and+Ports>

home | help