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).

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

       If  the  _i_n_t_e_r_v_a_l argument is non-zero, the SIGALRM signal will be sent
       to the process every _i_n_t_e_r_v_a_l  microseconds  after  the  timer  expires
       (e.g. after _v_a_l_u_e 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)