1 058b0118 2005-01-03 devnull .TH 9PSERVE 4
 2 058b0118 2005-01-03 devnull .SH NAME
 3 058b0118 2005-01-03 devnull 9pserve \- announce and multiplex 9P service
 4 058b0118 2005-01-03 devnull .SH SYNOPSIS
 5 058b0118 2005-01-03 devnull .B 9pserve
 6 058b0118 2005-01-03 devnull [
 7 058b0118 2005-01-03 devnull .B -v
 8 058b0118 2005-01-03 devnull ]
 9 058b0118 2005-01-03 devnull .I addr
10 058b0118 2005-01-03 devnull .SH DESCRIPTION
11 058b0118 2005-01-03 devnull On Plan 9, when a user-level file server mounts itself into a name space
12 058b0118 2005-01-03 devnull or posts itself in 
13 058b0118 2005-01-03 devnull .BR /srv ,
14 058b0118 2005-01-03 devnull the Plan 9 kernel multiplexes the potentially many processes 
15 058b0118 2005-01-03 devnull accessing the server into a single 9P conversation.
16 058b0118 2005-01-03 devnull The user-level server need not concern itself with how many
17 058b0118 2005-01-03 devnull processes are accessing it or with cleaning up after a process when it
18 058b0118 2005-01-03 devnull exits unexpectedly.
19 058b0118 2005-01-03 devnull On Unix,
20 058b0118 2005-01-03 devnull .I 9pserve
21 058b0118 2005-01-03 devnull takes the place of the Plan 9 kernel, multiplexing clients onto
22 058b0118 2005-01-03 devnull a single server conversation and cleaning up after clients when
23 058b0118 2005-01-03 devnull they hang up unexpectedly.
24 058b0118 2005-01-03 devnull .PP
25 058b0118 2005-01-03 devnull .I 9pserve
26 058b0118 2005-01-03 devnull announces a 9P service on
27 058b0118 2005-01-03 devnull .I addr
28 058b0118 2005-01-03 devnull and multiplexes any 9P clients connecting to
29 058b0118 2005-01-03 devnull .I addr
30 058b0118 2005-01-03 devnull into a single conversation with a 9P server on
31 058b0118 2005-01-03 devnull .IR 9pserve 's
32 058b0118 2005-01-03 devnull standard input and output.
33 058b0118 2005-01-03 devnull When a client hangs up, 
34 058b0118 2005-01-03 devnull .I 9pserve
35 058b0118 2005-01-03 devnull flushes any outstanding 9P transactions 
36 058b0118 2005-01-03 devnull and clunks any outstanding fids belonging to the client.
37 058b0118 2005-01-03 devnull .PP
38 058b0118 2005-01-03 devnull .I 9pserve
39 058b0118 2005-01-03 devnull is typically not invoked directly; use
40 058b0118 2005-01-03 devnull .IR post9pservice (3)
41 058b0118 2005-01-03 devnull instead.
42 058b0118 2005-01-03 devnull .SH "SEE ALSO
43 058b0118 2005-01-03 devnull .IR intro (4),
44 058b0118 2005-01-03 devnull .IR intro (9p)
45 058b0118 2005-01-03 devnull .SH SOURCE
46 c3674de4 2005-01-11 devnull .B \*9/src/cmd/9pserve.c