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)