1 cfa37a7b 2004-04-10 devnull .TH POSTNOTE 3
 2 cfa37a7b 2004-04-10 devnull .SH NAME
 3 cfa37a7b 2004-04-10 devnull postnote \- send a note to a process or process group
 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 .nf
10 cfa37a7b 2004-04-10 devnull .B
11 cfa37a7b 2004-04-10 devnull int	postnote(int who, int pid, char *note)
12 cfa37a7b 2004-04-10 devnull .fi
13 cfa37a7b 2004-04-10 devnull .SH DESCRIPTION
14 cfa37a7b 2004-04-10 devnull .I Postnote
15 cfa37a7b 2004-04-10 devnull sends a note to a process or process group.
16 cfa37a7b 2004-04-10 devnull If
17 cfa37a7b 2004-04-10 devnull .I who
18 cfa37a7b 2004-04-10 devnull is
19 cfa37a7b 2004-04-10 devnull .BR PNPROC ,
20 cfa37a7b 2004-04-10 devnull then
21 cfa37a7b 2004-04-10 devnull .I note
22 cfa37a7b 2004-04-10 devnull is written to
23 cfa37a7b 2004-04-10 devnull .BI /proc/ pid /note\f1.
24 cfa37a7b 2004-04-10 devnull If
25 cfa37a7b 2004-04-10 devnull .I who
26 cfa37a7b 2004-04-10 devnull is
27 cfa37a7b 2004-04-10 devnull .BI PNGROUP , 
28 cfa37a7b 2004-04-10 devnull the note is delivered to the
29 cfa37a7b 2004-04-10 devnull process group by writing
30 cfa37a7b 2004-04-10 devnull .I note
31 cfa37a7b 2004-04-10 devnull to
32 cfa37a7b 2004-04-10 devnull .BI /proc/ pid /notepg\f1.
33 cfa37a7b 2004-04-10 devnull For
34 cfa37a7b 2004-04-10 devnull .B PNGROUP
35 cfa37a7b 2004-04-10 devnull only, if the calling process is in the target group, the note is
36 cfa37a7b 2004-04-10 devnull .I not
37 cfa37a7b 2004-04-10 devnull delivered to that process.
38 cfa37a7b 2004-04-10 devnull .PP
39 cfa37a7b 2004-04-10 devnull If the write is successful, zero is returned.
40 cfa37a7b 2004-04-10 devnull Otherwise \-1 is returned.
41 cfa37a7b 2004-04-10 devnull .SH SOURCE
42 b5fdffee 2004-04-19 devnull .B /usr/local/plan9/src/libc/9sys/postnote.c
43 cfa37a7b 2004-04-10 devnull .SH "SEE ALSO"
44 bf8a59fa 2004-04-11 devnull .IR notify (3),
45 bf8a59fa 2004-04-11 devnull .IR intro (3),
46 cfa37a7b 2004-04-10 devnull .IR proc (3)
47 cfa37a7b 2004-04-10 devnull .SH DIAGNOSTICS
48 cfa37a7b 2004-04-10 devnull Sets
49 cfa37a7b 2004-04-10 devnull .IR errstr .