NAME

zkSleep - suspend execution for an interval of time

SYNOPSIS

#include "zkUnistd.h"

unsigned int zkSleep(unsigned int seconds);

DESCRIPTION

The zkSleep() function will cause the calling thread to be suspended from execution until either the number of real-time seconds specified by the argument seconds has elapsed or a signal is delivered to the calling thread and its action is to invoke a signal-catching function or to terminate the process. The suspension time may be longer than requested due to the scheduling of other activity by the system.

The interaction of the zkSleep() function with other system-dependent mechanisms, such as alarms and signals, is implementation-defined. Consult your target platform's documentation for more information.

RETURN VALUE

If zkSleep() returns because the requested time has elapsed, the value returned will be 0. If zkSleep() returns because of premature arousal due to delivery of a signal, the return value will be the "unslept" amount (the requested time minus the time actually slept) in seconds.

PORTABILITY

The interaction of the zkSleep() function with other system-dependent mechanisms, such as alarms and signals, is implementation-defined. Consult your target platform's documentation for more information.