# alarm(2)

    NAME
         alarm - schedule signal after specified time

    SYNOPSIS
         #include <unistd.h>

         unsigned int alarm(unsigned int seconds)

    DESCRIPTION
         Alarm causes signal SIGALRM, see sigaction(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  canceled.  Because of
         scheduling delays, resumption of execution of when the signal  is  caught
         may be delayed an arbitrary amount.

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

    SEE ALSO
         pause(2), sigsuspend(2), sigaction(2), sleep(3).