ALARM(2) DOMAIN/IX Reference Manual (SYS5) ALARM(2)
NAME
alarm - set a process alarm clock
USAGE
unsigned alarm (sec)
unsigned sec;
DESCRIPTION
Alarm instructs the alarm clock of the calling process to
send the signal SIGALRM to the calling process, after the
number of real-time seconds specified by sec have elapsed.
See signal(2) for a discussion of signals.
Alarm requests are not stacked; successive calls by alarm
reset the alarm clock of the calling process.
If sec is zero, any pending alarm request is cancelled.
RETURN VALUE
Alarm returns the amount of time left in the alarm clock
from the previous call.
RELATED INFORMATION
signal(2)
Printed 5/10/85 ALARM-1