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