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

sleep(3)

NAME

sleep - Suspends execution for an interval of time

LIBRARY

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

SYNOPSIS

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

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.

RELATED INFORMATION

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
Index Top of
page