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
|
.TH NFS 4
.SH NAME
nfs \- Sun network file system client
.SH SYNOPSIS
.B nfs
[
.B -DRv
]
[
.B -p
.I perm
]
[
.B -s
.I srvname
]
[
.B -u
.I passwd
.I group
]
.I addr1
[
.I addr2
]
.PP
.B aux/portmap
[
.B -R
]
.I host
.I cmd
...
.PP
.B aux/nfsmount
[
.B -R
]
.I host
.I cmd
...
.SH DESCRIPTION
.I Nfs
translates between the Sun network file system protocol (NFS)
and 9P, allowing 9P clients to mount file systems on NFS servers.
NFS servers comprise two separate services: a mount service used to
obtain the initial file handle, and a file service used to perform
actual file system operations.
The Sun port mapper service is typically used to find these two services.
If one address is given, it is taken to be the address of a port mapper service;
.I nfs
queries the port mapper to find the addresses
of the NFS mount service and file service.
If two addresses are given, the port mapper is bypassed;
.I addr1
is used as the address of the NFS mount service,
and
.I addr2
is used as the address of the file service.
.PP
The options are:
.TP
.B -D
print all 9P messages.
.TP
.B -R
print all NFS messages.
.TP
.B -v
print verbose information about session startup.
.TP
.B -p \fIperm
set the posted service file to have mode
.IR perm ,
which is assumed to be octal;
the default is
.BR 600 .
.TP
.B -s \fIsrvname
post the service as
.BI /srv/ srvname \fR;
the default is
.BI /srv/ addr1 \fR.
.TP
.B -u \fIpasswd\fR \fIgroup
translate user and group names using the
.I passwd
and
.I group
files, which are in the traditional Unix format.
The translation is used to present names for
user and group in
.IR stat (5)
and
.I wstat
messages.
The translation is also used to
choose the user and group credentials
to present for a user.
Without this option, users and groups are presented
as decimal numbers, and everyone attaches as uid \-1
.RB ( nobody
on most Unix systems).
.PP
.I Portmap
and
.I nfsmount
are test programs to perform port mapper and NFS mount RPCs.
They
are useful mainly to help debug problems with
starting
.I nfs
itself.
The
.B -R
option causes them to print all RPC messages sent and received.
.PP
.I Portmap
queries a Sun RPC portmap server, which maps integer
(program, version, protocol) triples to port numbers.
Program and version are Sun RPC defined, while protocol
is typically TCP (6) or UDP (17).
The commands are:
.TP
.B null
a no-op
.TP
.B dump
print the entire map
.TP
.B set \fIprog\fP \fIvers\fP \fIproto\fP \fIport\fP
add an entry to (or replace an entry in) the map
.TP
.B unset \fIprog\fP \fIvers\fP \fIproto\fP \fIport\fP
remove an entry from the map
.TP
.B getport \fIprog\fP \fIvers\fP \fIproto\fP
look for an entry with \fIprog\fP, \fIvers\fP, \fIproto\fP
in the map, and return the corresponding port
.PD
The default command is
.BR dump .
For running NFS over UDP, there must be an entry
for the NFS v3 mount daemon (100005, 3, 17) and the
NFS v3 server itself (100003, 3, 17).
.PP
.I Nfsmount
queries a Sun NFS mount server, which authenticates (ha!)
connections and hands out file handles naming the root of
an exported file system. This handle is used as the basis
for a conversation with the NFS service daemon itself.
The commands are:
.TP
.B null
a no-op
.TP
.B export
dump the export table;
each line is a path followed by a list of machines or groups
allowed to mount that path
.TP
.B mnt \fIpath\fR
attempt to acquire a file handle for \fIpath\fR.
the request has user and group id 1001 and
.L gnot
as the system name.
.TP
.B umnt \fIpath\fR
notify the mount daemon that a particular path is being
unmounted by the requesting system
.TP
.B umntall
notify the mount daemon that all paths mounted by the
requesting system are being unmounted
.TP
.B dump
should also dump an export table, but typically
does nothing
.PD
.SH EXAMPLE
We use this in our
.B /rc/bin/9fs
script to mount all the home directories served by
.IR bopp :
.IP
.EX
case bopp
if(! test -f /srv/bopp)
nfs -p 666 -u /lib/ndb/1127.passwd /lib/ndb/1127.group bopp
unmount /n/bopp >[2]/dev/null
for(i in u0 u1 u2 u3 u4 u5 u6 u7 u8 u9)
mount -a /srv/bopp /n/bopp /$i
.EE
.SH SOURCE
.B /sys/src/cmd/nfs.c
.br
.B /sys/src/libsunrpc
.SH "SEE ALSO
.IR nfsserver (8),
.IR srv (4)
.SH BUGS
The authentication employed by NFS is laughable.
The server simply trusts the uid, gid, and group list
presented by the client.
.PP
.I Nfs
speaks only NFS version 3.
Older operating systems typically
have reasonable NFS version 2 servers
but crash when serving version 3.
|
