HP-UX Reference (11i v1 00/12) - 3 Library Functions N-Z (vol 7)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

371

372

373

374

375

376

377

378

379

380

__________________________________________________________________________________________________________________________________________________________________________________________________

STANDARD Printed by: Nora Chuang [nchuang] STANDARD

/build/1111/BRICK/man3/nan.3m

________________________________________________________________

___ ___

sleep(3C) sleep(3C)

NAME

sleep() - suspend execution for interval

SYNOPSIS

#include <unistd.h>

unsigned int sleep(unsigned int seconds);

DESCRIPTION

sleep() suspends the current process from execution for the number of seconds speciﬁed by the argu-

ment.

Actual suspension time can be less than that requested for two reasons:

• Scheduled wakeups occur at ﬁxed 1-second intervals (on the second, according to an internal clock),

and

• Any caught signal terminates the sleep following execution of that signal’s catching routine.

Suspension time can be an arbitrary amount longer than requested due to the scheduling of other activity

in the system. The value returned by sleep()

is the ‘‘unslept’’ amount (the requested time minus the

time actually slept) in case the caller had an alarm set to go off earlier than the end of the requested

sleep() time, or premature arousal due to another caught signal.

seconds must be less than 2

APPLICATION USAGE

sleep() is thread-safe. It is not async-cancel-safe. A cancellation point may occur when a thread is exe-

cuting sleep().

If a SIGALRM is generated for a multi-threaded process, it may not be delivered to a thread currently in

sleep(). See sigwait(2) man page for details. In a multi-threaded process delivery of a SIGALRM to a

thread in sleep() simply causes sleep() to return without invoking the SIGALRM handler.