Go to the previous, next section.

alarm

SYNOPSIS

long alarm(long seconds);

PARAMETERS

seconds: [in] the delay.

DESCRIPTION

If the call completes successfully, the taks will receive a SIGALARM signal after a delay of seconds seconds. A delay of zero seconds simply cancel the alarm. If an previous alarm was activated when the call is made then the previous alarm is cancelled.

Internally, the call just sets an interruption timer.

RETURN VALUE

If a previous alarm was activated, the call returns the time delay before the expiration of that previous alarm (now canceled). Otherwise, it returns zero.

Go to the previous, next section.