unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (v7man)
Page:
Section:
Apropos / Subsearch:
optional field

ALARM(2)                      System Calls Manual                     ALARM(2)



NAME
       alarm - schedule signal after specified time

SYNOPSIS
       alarm(seconds)
       unsigned seconds;

DESCRIPTION
       Alarm  causes signal SIGALRM, see signal(2), to be sent to the invoking
       process in a number of seconds given by the argument.  Unless caught or
       ignored, the signal terminates the process.

       Alarm requests are not stacked; successive calls reset the alarm clock.
       If the argument is 0, any alarm  request  is  cancelled.   Because  the
       clock  has a 1-second resolution, the signal may occur up to one second
       early; because of scheduling delays, resumption of  execution  of  when
       the  signal  is caught may be delayed an arbitrary amount.  The longest
       specifiable delay time is 65535 seconds.

       The return value is the amount of  time  previously  remaining  in  the
       alarm clock.

SEE ALSO
       pause(2), signal(2), sleep(3)

ASSEMBLER
       (alarm = 27.)
       (seconds in r0)
       sys alarm
       (previous amount in r0)



                                                                      ALARM(2)