Click above to get retro games delivered to your door ever month!

alarm
=====

Syntax
------

     #include <unistd.h>
     
     unsigned alarm(unsigned seconds);

Description
-----------

This function causes the signal SIGALRM to be raised in SECONDS seconds.
A value of zero for SECONDS cancels any pending alarm.  If an alarm has
previously been set, the new alarm delay will superceed the prior call.

Return Value
------------

The number of seconds remaining on the timer (i.e. always SECONDS).

Example
-------

     signal(SIGALRM,my_alarm_routine);
     alarm(5);