1UALARM(3)                  Library Functions Manual                  UALARM(3)
2
3
4

NAME

6       ualarm - schedule signal after specified time
7

SYNOPSIS

9       unsigned ualarm(value, interval)
10       unsigned value;
11       unsigned interval;
12

DESCRIPTION

14       This is a simplified interface to setitimer(2).
15
16       Ualarm  causes signal SIGALRM, see signal(3C), to be sent to the invok‐
17       ing process in a number of microseconds given by  the  value  argument.
18       Unless caught or ignored, the signal terminates the process.
19
20       If  the  interval argument is non-zero, the SIGALRM signal will be sent
21       to the process every interval  microseconds  after  the  timer  expires
22       (e.g. after value microseconds have passed).
23
24       Because  of scheduling delays, resumption of execution of when the sig‐
25       nal is caught may be delayed an arbitrary amount.  The longest specifi‐
26       able delay time (on the vax) is 2147483647 microseconds.
27
28       The  return  value  is  the  amount of time previously remaining in the
29       alarm clock.
30

SEE ALSO

32       getitimer(2),   setitimer(2),   sigpause(2),   sigvec(2),   signal(3C),
33       sleep(3), alarm(3), usleep(3)
34

NOTES (PDP-11)

36       On  the  PDP-11,  setitimer(2)  rounds the number of microseconds up to
37       seconds resolution, therefore ualarm doesn't give you any more  resolu‐
38       tion than alarm(3).
39
40
41
424.3 Berkeley Distribution       August 26, 1988                      UALARM(3)