harvey/sys/man/4/nfs

.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/nfsmonut
[
.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 bypasswd;
.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).
.PD
.I Portmap
and
.I nfsmount
are test programs to perform port mapper and NFS mount RPCs.
Run
.B aux/portmap
.B -?
and
.B aux/nfsmount
.B -?
for lists of commands.
.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.