4.3BSD - /usr/man/cat3/ualarm.0

UALARM(3)                                                            UALARM(3)


NAME
       ualarm - schedule signal after specified time

SYNOPSIS
       unsigned ualarm(value, interval)
       unsigned value;
       unsigned interval;

DESCRIPTION
       This is a simplified interface to setitimer(2).

       Ualarm  causes signal SIGALRM, see signal(3C), to be sent to the invok‐
       ing process in a number of microseconds given by  the  value  argument.
       Unless caught or ignored, the signal terminates the process.

       If  the  interval argument is non-zero, the SIGALRM signal will be sent
       to the process every interval  microseconds  after  the  timer  expires
       (e.g. after value microseconds have passed).

       Because  of scheduling delays, resumption of execution of when the sig‐
       nal is caught may be delayed an arbitrary amount.  The longest specifi‐
       able delay time (on the vax) is 2147483647 microseconds.

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

SEE ALSO
       getitimer(2),   setitimer(2),   sigpause(2),   sigvec(2),   signal(3C),
       sleep(3), alarm(3), usleep(3)


4.3 Berkeley Distribution        May 13, 1986                        UALARM(3)