NAME

nanosleep − high resolution sleep

SYNOPSIS

cc [ flag ... ] file ... −lposix4 [ library ... ]

#include <time.h>

int nanosleep(const struct timespec ∗rqtp, struct timespec ∗rmtp);

struct timespec {
time_ttv_sec;/∗ seconds ∗/
longtv_nsec; /∗ and nanoseconds ∗/
};

MT-LEVEL

MT-Safe

DESCRIPTION

nanosleep() suspends the current thread from execution until either the time interval specified by rqtp has elapsed, or a signal is delivered to the calling thread and its action is to invoke a signal-catching function or to terminate the thread.  The suspension time may be longer than requested because the argument value is rounded up to an integer multiple of the sleep resolution or because of the scheduling of other activity by the system.  Except for the case of being interrupted by a signal, the suspension time will not be less than the time specified by rqtp, as measured by the system clock, CLOCK_REALTIME. 

nanosleep() will not block nor effect the action of any signal. 

RETURN VALUES

If nanosleep() returns because the requested time has elapsed, it returns 0.  Otherwise, if it returns because it has been interrupted by a signal:

it returns -1 and sets errno to indicate the interruption. 

If rmtp is non-NULL, the timespec structure referenced by rmtp will be updated to contain the remaining amount of time between rqtp and the time actually slept. 

If any of the following error conditions occur, nanosleep() returns -1 and sets errno to indicate the error condition. 

ERRORS

EINTR nanosleep() was interrupted by a signal. 

EINVAL rqtp specified a nanosecond value less than zero or greater than or equal to 1,000,000,000. 

ENOSYS nanosleep() is not supported by this implementation. 

SEE ALSO

sleep(3C)

SunOS 5.4  —  Last change: 19 Aug 1993