1 cfa37a7b 2004-04-10 devnull .TH SLEEP 3
 2 cfa37a7b 2004-04-10 devnull .SH NAME
 3 cfa37a7b 2004-04-10 devnull sleep, alarm \- delay, ask for delayed note
 4 cfa37a7b 2004-04-10 devnull .SH SYNOPSIS
 5 cfa37a7b 2004-04-10 devnull .B #include <u.h>
 6 cfa37a7b 2004-04-10 devnull .br
 7 cfa37a7b 2004-04-10 devnull .B #include <libc.h>
 8 cfa37a7b 2004-04-10 devnull .PP
 9 cfa37a7b 2004-04-10 devnull .B
10 cfa37a7b 2004-04-10 devnull int sleep(long millisecs)
11 cfa37a7b 2004-04-10 devnull .PP
12 cfa37a7b 2004-04-10 devnull .B
13 cfa37a7b 2004-04-10 devnull long alarm(unsigned long millisecs)
14 cfa37a7b 2004-04-10 devnull .SH DESCRIPTION
15 cfa37a7b 2004-04-10 devnull .I Sleep
16 cfa37a7b 2004-04-10 devnull suspends the current process for the number
17 cfa37a7b 2004-04-10 devnull of milliseconds specified by the argument.
18 cfa37a7b 2004-04-10 devnull The actual suspension time may be a little more or less than
19 cfa37a7b 2004-04-10 devnull the requested time. If
20 cfa37a7b 2004-04-10 devnull .I millisecs
21 cfa37a7b 2004-04-10 devnull is 0, the process
22 cfa37a7b 2004-04-10 devnull gives up the CPU if another process is waiting to run, returning
23 cfa37a7b 2004-04-10 devnull immediately if not.
24 cfa37a7b 2004-04-10 devnull Sleep returns \-1 if interrupted, 0 otherwise.
25 cfa37a7b 2004-04-10 devnull .PP
26 cfa37a7b 2004-04-10 devnull .I Alarm
27 cfa37a7b 2004-04-10 devnull causes an
28 cfa37a7b 2004-04-10 devnull .B alarm
29 cfa37a7b 2004-04-10 devnull note (see
30 d32deab1 2020-08-16 rsc .MR notify (3) )
31 cfa37a7b 2004-04-10 devnull to be sent to the invoking process after the number of milliseconds
32 cfa37a7b 2004-04-10 devnull given by the argument.
33 cfa37a7b 2004-04-10 devnull Successive calls to
34 cfa37a7b 2004-04-10 devnull .I alarm
35 cfa37a7b 2004-04-10 devnull reset the alarm clock.
36 cfa37a7b 2004-04-10 devnull A zero argument clears the alarm.
37 cfa37a7b 2004-04-10 devnull The return value is the amount of time previously remaining in
38 cfa37a7b 2004-04-10 devnull the alarm clock.
39 cfa37a7b 2004-04-10 devnull .SH SOURCE
40 c3674de4 2005-01-11 devnull .B \*9/src/lib9/sleep.c
41 cfa37a7b 2004-04-10 devnull .SH SEE ALSO
42 d32deab1 2020-08-16 rsc .MR intro (3)
43 cfa37a7b 2004-04-10 devnull .SH DIAGNOSTICS
44 cfa37a7b 2004-04-10 devnull These functions set
45 cfa37a7b 2004-04-10 devnull .IR errstr .
46 c8b6342d 2005-01-13 devnull .SH BUGS
47 c8b6342d 2005-01-13 devnull To avoid name conflicts with the underlying system,
48 c8b6342d 2005-01-13 devnull .I sleep
49 c8b6342d 2005-01-13 devnull and
50 c8b6342d 2005-01-13 devnull .I alarm
51 c8b6342d 2005-01-13 devnull are preprocessor macros defined as
52 c8b6342d 2005-01-13 devnull .I p9sleep
53 c8b6342d 2005-01-13 devnull and
54 c8b6342d 2005-01-13 devnull .IR p9alarm ;
55 c8b6342d 2005-01-13 devnull see
56 d32deab1 2020-08-16 rsc .MR intro (3) .