ualarm(3c) - osol9

1ualarm(3C)               Standard C Library Functions               ualarm(3C)
2
3
4

NAME

6       ualarm - schedule signal after interval in microseconds
7

SYNOPSIS

9       #include <unistd.h>
10
11       useconds_t ualarm(useconds_t useconds, useconds_t interval);
12
13

DESCRIPTION

15       The ualarm() function causes the SIGALRM signal to be generated for the
16       calling process after the number of real-time microseconds specified by
17       the  useconds argument has elapsed.  When the interval argument is non-
18       zero, repeated timeout notification occurs with a period  in  microsec‐
19       onds  specified  by  the interval argument. If the notification signal,
20       SIGALRM, is not caught or ignored, the calling process is terminated.
21
22
23       Because of scheduling delays, resumption of execution when  the  signal
24       is caught may be delayed an arbitrary amount of time.
25
26
27       Interactions  between  ualarm()  and  either  alarm(2) or sleep(3C) are
28       unspecified.
29

RETURN VALUES

31       The ualarm() function returns the number of microseconds remaining from
32       the  previous ualarm() call.  If no timeouts are pending or if ualarm()
33       has not previously been called, ualarm() returns 0.
34

ERRORS

36       No errors are defined.
37

USAGE

39       The ualarm() function is a simplified interface  to  setitimer(2),  and
40       uses the ITIMER_REAL interval timer.
41

ATTRIBUTES

43       See attributes(5) for descriptions of the following attributes:
44
45
46
47
48       ┌─────────────────────────────┬─────────────────────────────┐
49       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
50       ├─────────────────────────────┼─────────────────────────────┤
51       │Interface Stability          │Standard                     │
52       └─────────────────────────────┴─────────────────────────────┘
53