1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
|
.TH SRV 4
.SH NAME
srv, srvold9p, 9fs \- start network file service
.SH SYNOPSIS
.B srv
[
.B -abcCmq
]
.RI [ net !] system\c
.RI [! service ]
[
.I srvname
[
.I mtpt
] ]
.PP
.B 9fs
.RI [ net !] system
.RI [ mountpoint ]
.PP
.B srvold9p
[
.B -abcCd
] [
.B -u
.I user
] [
.B -s
| [
.B -m
.I mountpoint
] ] [
.B -x
.I command
|
.B -n
.I network-addr
|
.B -f
.I file
] [
.B -F
] [
.B -p
.I servicename
]
.SH DESCRIPTION
.I Srv
dials the given machine and initializes the connection to serve the
9P protocol.
It then creates in
.B /srv
a file named
.IR srvname .
Users can then
.B mount
(see
.IR bind (1))
the service, typically on a name in
.BR /n ,
to access the files provided by the remote machine.
If
.I srvname
is omitted, the first argument to
.B srv
is used.
Option
.B m
directs
.I srv
to mount the service on
.BI /n/ system
or onto
.I mtpt
if it is given.
Option
.B q
suppresses complaints if the
.B /srv
file already exists.
The
.BR a ,
.BR b ,
.BR c ,
and
.B C
flags are used to control the mount flag as in
.IR bind (1).
.PP
The specified
.I service
must serve 9P. Usually
.I service
can be omitted; when calling some
non-Plan 9 systems, a
.I service
such as
.B u9fs
must be mentioned explicitly.
.PP
The
.I 9fs
command does the
.I srv
and the
.I mount
necessary to make available the files of
.I system
on network
.IR net .
The files are mounted on
.IR mountpoint ,
if given;
otherwise they are mounted on
.BI /n/ system\f1.
If
.I system
contains
.L /
characters, only the last element of
.I system
is used in the
.B /n
name.
.PP
.I 9fs
recognizes some special names, such as
.B dump
to make the dump file system available on
.BR /n/dump .
.I 9fs
is an
.IR rc (1)
script; examine it to see what local conventions apply.
.PP
.I Srvold9p
is a compatibilty hack to allow Fourth Edition Plan 9 systems
to connect to older 9P servers.
It functions as a variant of
.I srv
that performs a version translation on the 9P messages on the underlying connection.
Some of its options are the same as those of
.IR srv ;
the special ones are:
.TP
.B -d
Enable debuggging
.TP
.BI -u\ user
When connecting to the remote server, log in as
.IR user .
Since
.I srvold9p
does no authentication, and since new kernels cannot authenticate to
old services, the likeliest value of
.I user
is
.BR none .
.TP
.BI -x\ command
Run
.I command
and use its standard input and output as the 9P service connection.
If the
.I command
string contains blanks, it should be quoted.
.TP
.BI -n\ network-addr
Dial
.I network-addr
to establish the connection.
.TP
.BI -f\ file
Use
.I file
(typically an existing
.IR srv (3)
file) as the connection.
.TP
.B -F
Insert a special (internal) filter process to the connection to maintain
message boundaries; usually only needed on TCP connections.
.TP
.BI -p\ servicename
Post the service under
.IR srv (3)
as
.BI /srv/ servicename\f1.
.PP
.I Srvold9p
is run automatically when a
.IR cpu (1)
call is received on the service port for the old protocol.
.SH EXAMPLES
To see kremvax's and deepthought's files in
.B /n/kremvax
and
.BR /n/deepthought :
.IP
.EX
9fs kremvax
9fs hhgttg /n/deepthought
.EE
.PP
To mount as user
.B none
a connection to an older server kgbsun:
.IP
.EX
srvold9p -u none -m /n/kgbsun -p kgbsun -n il!kgbsun
.EE
.PP
Other windows may then mount the connection directly:
.IP
.EX
mount /srv/kgbsun /n/kgbsun
.EE
.SH NOTE
The TCP port used for 9P is 564.
.SH FILES
.TF /srv/*
.TP
.B /srv/*
ports to file systems and servers posted by
.I srv
and
.I 9fs
.SH SOURCE
.B /sys/src/cmd/srv.c
.br
.B /rc/bin/9fs
.br
.SH "SEE ALSO"
.IR bind (1),
.IR dial (2),
.IR srv (3),
.IR ftpfs (4)
|
