Content-type: text/html Man page of usleep

usleep

Section: C Library Functions (3)
Index Return to Main Contents
 

NAME

usleep - Suspends execution for an interval of time  

LIBRARY

Standard C Library (libc.so, libc.a)  

SYNOPSIS

#include <unistd.h>

int usleep(
        useconds_t useconds);

The following function declaration does not conform to current standards and is supported only for backward compatibility:

#include <unistd.h>

void usleep(
        unsigned useconds);  

STANDARDS

Interfaces documented on this reference page conform to industry standards as follows:

usleep():  XPG4-UNIX

Refer to the standards(5) reference page for more information about industry standards and associated tags.  

PARAMETERS

Specifies the number of microseconds to sleep.  

DESCRIPTION

The usleep() function suspends the current process from execution for the number of microseconds specified by the useconds parameter. Because of other activity in the system, or because of the time spent in processing the call, the actual suspension time might be longer than specified.

The useconds parameter must be less than 1,000,000. If the value of useconds is 0 (zero), the usleep() function has no effect.

In a multithreaded environment, the sleep() function is redefined to suspend the calling thread.  

RETURN VALUES

On successful completion, the usleep() function returns 0 (zero). Otherwise, it returns -1 and sets errno to indicate the error.  

ERRORS

The usleep() function sets errno to the specified values for the following conditions: The interval specified in the useconds parameter exceeds 1,000,000 microseconds.  

RELATED INFORMATION

Functions: getitimer(2), sigaction(2), sigvec(2), alarm(3), sleep(3)

Standards: standards(5) delim off


 

Index

NAME
LIBRARY
SYNOPSIS
STANDARDS
PARAMETERS
DESCRIPTION
RETURN VALUES
ERRORS
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:40:47 GMT, October 02, 2010