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