usleep()

Suspend a thread for a given time

Synopsis:

#include <unistd.h>

int usleep( useconds_t useconds );

Library:

libc

Description:

The usleep() function suspends the calling thread until useconds microseconds of realtime have elapsed, or until a signal that isn't ignored is received. The time spent suspended could be longer than the requested amount due to the scheduling of other, higher-priority threads.

The useconds argument must be less than 1,000,000. If useconds is 0, usleep() has no effect.

Returns:

0

Success.

-1

An error occurred (errno is set).

Errors:

EAGAIN

No timer resources are available to satisfy the request.

EINVAL

The useconds argument is too large.

Examples:

/*
 * The following program sleeps for the
 * number of microseconds specified in argv[1].
 */
#include <stdlib.h>
#include <unistd.h>

int main( int argc, char **argv )
{
    useconds_t microseconds;

    microseconds = (useconds_t)strtol( argv[1], NULL, 0 );
    if( usleep( microseconds ) == 0 ) {
        return EXIT_SUCCESS;
    }
    
    return EXIT_FAILURE;
}

Classification:

Standard Unix

See also:

alarm(), nanosleep(), sigaction(), sleep(), timer_create(), timer_delete(), timer_getoverrun(), timer_gettime(), timer_settime(), ualarm()