Skip site navigation (1)Skip section navigation (2)

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
USLEEP(3)	       FreeBSD Library Functions Manual		     USLEEP(3)

NAME
     usleep -- suspend process execution for an	interval measured in microsec-
     onds

LIBRARY
     Standard C	Library	(libc, -lc)

SYNOPSIS
     #include <unistd.h>

     int
     usleep(useconds_t microseconds);

DESCRIPTION
     The usleep() function suspends execution of the calling process until
     either microseconds microseconds have elapsed or a	signal is delivered to
     the process and its action	is to invoke a signal-catching function	or to
     terminate the process.  System activity may lengthen the sleep by an
     indeterminate amount.

     This function is implemented using	nanosleep(2) by	pausing	for
     microseconds microseconds or until	a signal occurs.  Consequently,	in
     this implementation, sleeping has no effect on the	state of process
     timers, and there is no special handling for SIGALRM.

RETURN VALUES
     The usleep() function returns the value 0 if successful; otherwise	the
     value -1 is returned and the global variable errno	is set to indicate the
     error.

ERRORS
     The usleep() function will	fail if:

     [EINTR]		A signal was delivered to the process and its action
			was to invoke a	signal-catching	function.

SEE ALSO
     nanosleep(2), sleep(3)

HISTORY
     The usleep() function appeared in 4.3BSD.

FreeBSD	9.3		       February	13, 1998		   FreeBSD 9.3

NAME | LIBRARY | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | SEE ALSO | HISTORY

Want to link to this manual page? Use this URL:
<http://www.freebsd.org/cgi/man.cgi?query=usleep&sektion=3&manpath=FreeBSD+9.2-RELEASE>

home | help