Index Index for
Section 3
Index Alphabetical
listing for S
Bottom of page Bottom of
page

sleep(3)

NAME

sleep - Suspend execution for an interval of time

SYNOPSIS

#include <unistd.h> unsigned int sleep( unsigned int seconds );

LIBRARY

Standard C Library (libc) Threads Library (libpthreads.a)

STANDARDS

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

seconds Specifies the number of seconds to sleep.

DESCRIPTION

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

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

Commands: wall(1), shutdown(8) sleep(1) Functions: sigaction(2), alarm(3), pause(3) Standards: standards(5)

Index Index for
Section 3
Index Alphabetical
listing for S
Top of page Top of
page