nanosleep(3R) manual page
Table of Contents
nanosleep - high resolution sleep
cc [ flag ... ] file ... -lposix4
[ library ... ]
#include <time.h>
int nanosleep(const struct timespec *rqtp,
struct timespec *rmtp);
struct timespec {
time_t tv_sec; /* seconds */
long tv_nsec; /* and nanoseconds */
};
MT-Safe
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.
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.
- 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.
sleep(3C)
Table of Contents
![[Go to CFHT Home Page]](/images/cfht-icon.gif){kind=icon}
Man Pages 
Back to Software Index 
Manpage Top Level