1ALARM(2)                      System Calls Manual                     ALARM(2)
2
3
4

NAME

6       alarm - schedule signal after specified time
7

SYNOPSIS

9       alarm(seconds)
10       unsigned seconds;
11

DESCRIPTION

13       Alarm  causes signal SIGALRM, see signal(2), to be sent to the invoking
14       process in a number of seconds given by the argument.  Unless caught or
15       ignored, the signal terminates the process.
16
17       Alarm requests are not stacked; successive calls reset the alarm clock.
18       If the argument is 0, any alarm  request  is  cancelled.   Because  the
19       clock  has a 1-second resolution, the signal may occur up to one second
20       early; because of scheduling delays, resumption of  execution  of  when
21       the  signal  is caught may be delayed an arbitrary amount.  The longest
22       specifiable delay time is 65535 seconds.
23
24       The return value is the amount of  time  previously  remaining  in  the
25       alarm clock.
26

SEE ALSO

28       pause(2), signal(2), sleep(3)
29

ASSEMBLER

31       (alarm = 27.)
32       (seconds in r0)
33       sys alarm
34       (previous amount in r0)
35
36
37
38                                                                      ALARM(2)