unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

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

ALARM(3C)                                                            ALARM(3C)



NAME
       alarm - schedule signal after specified time

SYNOPSIS
       alarm(seconds)
       unsigned seconds;

DESCRIPTION
       This interface is obsoleted by setitimer(2).

       Alarm causes signal SIGALRM, see signal(3C), 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 canceled.  Because of sched-
       uling  delays, resumption of execution of when the signal is caught may
       be delayed an arbitrary amount.  The longest specifiable delay time  is
       2147483647 seconds.

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

SEE ALSO
       sigpause(2), sigvec(2), signal(3C), sleep(3)



                                 18 July 1983                        ALARM(3C)