plan9port

fork of plan9port with libvec, libstr and libsdb
Log | Files | Refs | README | LICENSE

9pserve.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