t9pserve.4 - plan9port - [fork] Plan 9 from user space
 (HTM) git clone git://src.adamsgaard.dk/plan9port
 (DIR) Log
 (DIR) Files
 (DIR) Refs
 (DIR) README
 (DIR) LICENSE
       ---
       t9pserve.4 (1822B)
       ---
            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