xref: /386bsd/usr/share/man/cat3/ualarm.0 (revision a2142627)
1UALARM(3)                 386BSD Programmer's Manual                 UALARM(3)
2
3NNAAMMEE
4     uuaallaarrmm - schedule signal after specified time
5
6SSYYNNOOPPSSIISS
7     ##iinncclluuddee <<uunniissttdd..hh>>
8
9     _u__i_n_t
10     uuaallaarrmm(_u__i_n_t _m_i_c_r_o_s_e_c_o_n_d_s, _u__i_n_t _i_n_t_e_r_v_a_l)
11
12DDEESSCCRRIIPPTTIIOONN
13     TThhiiss iiss aa ssiimmpplliiffiieedd iinntteerrffaaccee ttoo sseettiittiimmeerr((22))..
14
15     The uuaallaarrmm() function waits a count of _m_i_c_r_o_s_e_c_o_n_d_s before asserting the
16     terminating signal SIGALRM. System activity or time used in processing
17     the call may cause a slight delay.
18
19     If the _i_n_t_e_r_v_a_l argument is non-zero, the SIGALRM signal will be sent to
20     the process every _i_n_t_e_r_v_a_l microseconds after the timer expires (e.g.
21     after _v_a_l_u_e microseconds have passed).
22
23RREETTUURRNN VVAALLUUEESS
24     When the signal has successfully been caught, aallaarrmm() returns the amount
25     of time left on the clock.  The maximum mumber of _m_i_c_r_o_s_e_c_o_n_d_s allowed is
26     2147483647.
27
28SSEEEE AALLSSOO
29     getitimer(2),  setitimer(2),  sigpause(2),  sigvec(2),  signal(3),
30     sleep(3),  alarm(3),  usleep(3)
31
32HHIISSTTOORRYY
33     The uuaallaarrmm() function appeared in 4.3BSD.
34
354.3 Berkeley Distribution       April 19, 1991                               1
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67