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 5c84c448 2005-03-21 devnull .B -lv
 8 058b0118 2005-01-03 devnull ]
 9 5c84c448 2005-03-21 devnull [
10 5c84c448 2005-03-21 devnull .B -A
11 5c84c448 2005-03-21 devnull .I aname
12 5c84c448 2005-03-21 devnull .I afid
13 5c84c448 2005-03-21 devnull ]
14 5c84c448 2005-03-21 devnull [
15 5c84c448 2005-03-21 devnull .B -M
16 5c84c448 2005-03-21 devnull .I msize
17 5c84c448 2005-03-21 devnull ]
18 058b0118 2005-01-03 devnull .I addr
19 058b0118 2005-01-03 devnull .SH DESCRIPTION
20 058b0118 2005-01-03 devnull On Plan 9, when a user-level file server mounts itself into a name space
21 058b0118 2005-01-03 devnull or posts itself in 
22 058b0118 2005-01-03 devnull .BR /srv ,
23 058b0118 2005-01-03 devnull the Plan 9 kernel multiplexes the potentially many processes 
24 058b0118 2005-01-03 devnull accessing the server into a single 9P conversation.
25 058b0118 2005-01-03 devnull The user-level server need not concern itself with how many
26 058b0118 2005-01-03 devnull processes are accessing it or with cleaning up after a process when it
27 058b0118 2005-01-03 devnull exits unexpectedly.
28 058b0118 2005-01-03 devnull On Unix,
29 058b0118 2005-01-03 devnull .I 9pserve
30 058b0118 2005-01-03 devnull takes the place of the Plan 9 kernel, multiplexing clients onto
31 058b0118 2005-01-03 devnull a single server conversation and cleaning up after clients when
32 058b0118 2005-01-03 devnull they hang up unexpectedly.
33 058b0118 2005-01-03 devnull .PP
34 058b0118 2005-01-03 devnull .I 9pserve
35 058b0118 2005-01-03 devnull announces a 9P service on
36 058b0118 2005-01-03 devnull .I addr
37 058b0118 2005-01-03 devnull and multiplexes any 9P clients connecting to
38 058b0118 2005-01-03 devnull .I addr
39 058b0118 2005-01-03 devnull into a single conversation with a 9P server on
40 058b0118 2005-01-03 devnull .IR 9pserve 's
41 058b0118 2005-01-03 devnull standard input and output.
42 058b0118 2005-01-03 devnull When a client hangs up, 
43 058b0118 2005-01-03 devnull .I 9pserve
44 058b0118 2005-01-03 devnull flushes any outstanding 9P transactions 
45 058b0118 2005-01-03 devnull and clunks any outstanding fids belonging to the client.
46 058b0118 2005-01-03 devnull .PP
47 058b0118 2005-01-03 devnull .I 9pserve
48 058b0118 2005-01-03 devnull is typically not invoked directly; use
49 058b0118 2005-01-03 devnull .IR post9pservice (3)
50 058b0118 2005-01-03 devnull instead.
51 5c84c448 2005-03-21 devnull .PP
52 5c84c448 2005-03-21 devnull The options are:
53 5c84c448 2005-03-21 devnull .TP
54 5c84c448 2005-03-21 devnull .B -l
55 5c84c448 2005-03-21 devnull logging; write a debugging log to
56 5c84c448 2005-03-21 devnull .IB addr .log \fR.
57 5c84c448 2005-03-21 devnull .TP
58 5c84c448 2005-03-21 devnull .B -v
59 5c84c448 2005-03-21 devnull verbose; more verbose when repeated
60 5c84c448 2005-03-21 devnull .TP
61 5c84c448 2005-03-21 devnull .B -A
62 5c84c448 2005-03-21 devnull rewrite all attach messages to use
63 5c84c448 2005-03-21 devnull .I aname
64 5c84c448 2005-03-21 devnull and
65 5c84c448 2005-03-21 devnull .IR afid ;
66 5c84c448 2005-03-21 devnull used to implement
67 5c84c448 2005-03-21 devnull .IR srv (4)'s
68 5c84c448 2005-03-21 devnull .B -a
69 5c84c448 2005-03-21 devnull option
70 5c84c448 2005-03-21 devnull .TP
71 5c84c448 2005-03-21 devnull .B -M
72 5c84c448 2005-03-21 devnull do not initialize the connection with a
73 5c84c448 2005-03-21 devnull .B Tversion
74 5c84c448 2005-03-21 devnull message;
75 5c84c448 2005-03-21 devnull instead assume 9P2000 and a maximum message size of
76 5c84c448 2005-03-21 devnull .IR msize
77 5c84c448 2005-03-21 devnull .PD
78 058b0118 2005-01-03 devnull .SH "SEE ALSO
79 058b0118 2005-01-03 devnull .IR intro (4),
80 058b0118 2005-01-03 devnull .IR intro (9p)
81 058b0118 2005-01-03 devnull .SH SOURCE
82 c3674de4 2005-01-11 devnull .B \*9/src/cmd/9pserve.c