plan9port

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

srv.4 (1762B)

      1 .TH SRV 4
      2 .SH NAME
      3 srv, 9fs \- start network file service
      4 .SH SYNOPSIS
      5 .B srv
      6 [
      7 .B -an
      8 ]
      9 [
     10 .B -k
     11 .I keypattern
     12 ]
     13 .I address
     14 [
     15 .I srvname
     16 ]
     17 .PP
     18 .B 9fs
     19 .I system
     20 .SH DESCRIPTION
     21 .I Srv
     22 dials the given address and initializes the connection to serve the 9P protocol.
     23 It then posts the resulting connection in the current name space 
     24 (see
     25 .MR intro (4) )
     26 as
     27 .I srvname 
     28 (default
     29 .IR address ).
     30 .PP
     31 The
     32 .B -a
     33 option causes
     34 .I srv
     35 to post a pre-authenticated connection to the file system
     36 .I aname
     37 (by default, the empty string;
     38 see
     39 .IR attach (9p)).
     40 .PP
     41 The 
     42 .B -n
     43 option causes 
     44 .I srv
     45 to reject authentication attempts by clients,
     46 useful if the remote server is known not to require authentication.
     47 .PP
     48 .I Srv
     49 authenticates over the 9P connection to establish a valid auth fid.
     50 .IR Keypattern ,
     51 if specified, is used to select the key used for authentication.
     52 Client attach requests are rewritten to use the specified
     53 .I aname
     54 and auth fid.
     55 .PP
     56 The
     57 .I 9fs
     58 command executes the
     59 .I srv
     60 necessary to make available the files of 
     61 .IR system .
     62 .PP
     63 .I 9fs
     64 recognizes some special names,
     65 such as
     66 .B sources
     67 to make the file server
     68 .I sources.cs.bell-labs.com
     69 available as service
     70 .IR sources .
     71 .I 9fs
     72 is an
     73 .MR rc (1)
     74 script; examine it to see what local conventions apply.
     75 .SH EXAMPLES
     76 List the root directory on 
     77 .IR sources :
     78 .IP
     79 .EX
     80 9fs sources
     81 9p ls sources
     82 .EE
     83 .PP
     84 Mount a remote file server 
     85 .I bootes
     86 on Linux using the kernel 9P mount driver,
     87 with 
     88 .I srv
     89 handling authentication:
     90 .IP
     91 .EX
     92 srv -a sources.cs.bell-labs.com sources
     93 sudo mount -t 9p -o trans=unix,uname=$USER,dfltuid=`id -u`,dfltgid=`id -g`
     94            `namespace`/sources /n/sources
     95 .EE
     96 .SH SOURCE
     97 .B \*9/src/cmd/srv.c
     98 .br
     99 .B \*9/bin/9fs
    100 .SH "SEE ALSO
    101 .MR dial (3) ,
    102 .MR intro (4) ,
    103 .MR netfiles (1)