NAME | LIBRARY | SYNOPSIS | DESCRIPTION | RETURN VALUE | ATTRIBUTES | VERSIONS | STANDARDS | HISTORY | CAVEATS | SEE ALSO | COLOPHON |
|
|
sleep(3) Library Functions Manual sleep(3)
sleep - sleep for a specified number of seconds
Standard C library (libc, -lc)
#include <unistd.h> unsigned int sleep(unsigned int seconds);
sleep() causes the calling thread to sleep either until the number of real-time seconds specified in seconds have elapsed or until a signal arrives which is not ignored.
Zero if the requested time has elapsed, or the number of seconds left to sleep, if the call was interrupted by a signal handler.
For an explanation of the terms used in this section, see attributes(7). ┌─────────────────┬───────────────┬─────────────────────────────┐ │ Interface │ Attribute │ Value │ ├─────────────────┼───────────────┼─────────────────────────────┤ │ sleep() │ Thread safety │ MT-Unsafe sig:SIGCHLD/linux │ └─────────────────┴───────────────┴─────────────────────────────┘
On Linux, sleep() is implemented via nanosleep(2). See the nanosleep(2) man page for a discussion of the clock used. On some systems, sleep() may be implemented using alarm(2) and SIGALRM (POSIX.1 permits this); mixing calls to alarm(2) and sleep() is a bad idea.
POSIX.1-2008.
POSIX.1-2001.
Using longjmp(3) from a signal handler or modifying the handling of SIGALRM while sleeping will cause undefined results.
sleep(1), alarm(2), nanosleep(2), signal(2), signal(7)
This page is part of the man-pages (Linux kernel and C library
user-space interface documentation) project. Information about
the project can be found at
⟨https://www.kernel.org/doc/man-pages/⟩. If you have a bug report
for this manual page, see
⟨https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/tree/CONTRIBUTING⟩.
This page was obtained from the tarball man-pages-6.9.1.tar.gz
fetched from
⟨https://mirrors.edge.kernel.org/pub/linux/docs/man-pages/⟩ on
2024-06-26. If you discover any rendering problems in this HTML
version of the page, or you believe there is a better or more up-
to-date source for the page, or you have corrections or
improvements to the information in this COLOPHON (which is not
part of the original manual page), send a mail to
[email protected]
Linux man-pages 6.9.1 2024-05-02 sleep(3)
Pages that refer to this page: sleep(1), alarm(2), clock_nanosleep(2), getitimer(2), nanosleep(2), ualarm(3), usleep(3), signal(7), signal-safety(7), time(7)