USLEEP(3C)USLEEP(3C)NAMEusleep - suspend execution for interval in microseconds
SYNOPSIS
#include <unistd.h>
int usleep(useconds_t useconds);
DESCRIPTION
The usleep() function suspends the caller from execution for the number
of microseconds specified by the useconds argument. The actual suspen‐
sion time might be less than requested because any caught signal will
terminate usleep() following execution of that signal's catching rou‐
tine. The suspension time might be longer than requested by an arbi‐
trary amount because of the scheduling of other activity in the system.
If the value of useconds is 0, then the call has no effect.
The use of the usleep() function has no effect on the action or block‐
age of any signal. In a multithreaded process, only the invoking thread
is suspended from execution.
RETURN VALUES
On completion, usleep() returns 0. There are no error returns.
ERRORS
No errors are returned.
USAGE
The usleep() function is included for its historical usage. The
nanosleep(3C) function is preferred over this function.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌────────────────────┬───────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├────────────────────┼───────────────────┤
│Interface Stability │ Committed │
├────────────────────┼───────────────────┤
│MT-Level │ Safe │
├────────────────────┼───────────────────┤
│Standard │ See standards(5). │
└────────────────────┴───────────────────┘
SEE ALSOnanosleep(3C), sleep(3C), attributes(5), standards(5)
Feb 5, 2008 USLEEP(3C)
