usr/src/lib/libc/gen/sleep.3

.\" Copyright (c) 1980 Regents of the University of California.
.\" All rights reserved.  The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\"
.\"	@(#)sleep.3	6.1 (Berkeley) %G%
.\"
.TH SLEEP 3  ""
.UC 4
.SH NAME
sleep \- suspend execution for interval
.SH SYNOPSIS
.nf
.B sleep(seconds)
.B unsigned seconds;
.fi
.SH DESCRIPTION
The current process is suspended from execution for the number
of seconds specified by the argument.
The actual suspension time may be up to 1 second less than
that requested, because scheduled wakeups occur at fixed 1-second intervals,
and an arbitrary amount longer because of other activity
in the system.
.PP
The routine is implemented by setting an interval timer
and pausing until it occurs.
The previous state of this timer is saved and restored.
If the sleep time exceeds the time to the expiration of the
previous timer,
the process sleeps only until the signal would have occurred, and the
signal is sent 1 second later.
.SH "SEE ALSO"
setitimer(2), sigpause(2)
.SH BUGS
An interface with finer resolution is needed.
Commit	Line	Data
	1	.\" Copyright (c) 1980 Regents of the University of California.
	2	.\" All rights reserved. The Berkeley software License Agreement
	3	.\" specifies the terms and conditions for redistribution.
	4	.\"
	5	.\" @(#)sleep.3 6.1 (Berkeley) %G%
	6	.\"
	7	.TH SLEEP 3 ""
	8	.UC 4
	9	.SH NAME
	10	sleep \- suspend execution for interval
	11	.SH SYNOPSIS
	12	.nf
	13	.B sleep(seconds)
	14	.B unsigned seconds;
	15	.fi
	16	.SH DESCRIPTION
	17	The current process is suspended from execution for the number
	18	of seconds specified by the argument.
	19	The actual suspension time may be up to 1 second less than
	20	that requested, because scheduled wakeups occur at fixed 1-second intervals,
	21	and an arbitrary amount longer because of other activity
	22	in the system.
	23	.PP
	24	The routine is implemented by setting an interval timer
	25	and pausing until it occurs.
	26	The previous state of this timer is saved and restored.
	27	If the sleep time exceeds the time to the expiration of the
	28	previous timer,
	29	the process sleeps only until the signal would have occurred, and the
	30	signal is sent 1 second later.
	31	.SH "SEE ALSO"
	32	setitimer(2), sigpause(2)
	33	.SH BUGS
	34	An interface with finer resolution is needed.