rpc.nfsd - NFS server process
/usr/sbin/rpc.nfsd [options] nproc
The
rpc.nfsd program implements the user level part of the NFS service.
The main functionality is handled by the
nfsd kernel module. The user
space program merely specifies what sort of sockets the kernel service should
listen on, what NFS versions it should support, and how many kernel threads it
should use.
The
rpc.mountd server provides an ancillary service needed to satisfy
mount requests by NFS clients.
- -d or --debug
- enable logging of debugging messages
- -H or --host hostname
- specify a particular hostname (or address) that NFS
requests will be accepted on. By default, rpc.nfsd will accept NFS
requests on all known network addresses. Note that lockd (which
performs file locking services for NFS) may still accept request on all
known network addresses. This may change in future releases of the Linux
Kernel. This option can be used multiple time to listen to more than one
interface.
- -p or --port port
- specify a different port to listen on for NFS requests. By
default, rpc.nfsd will listen on port 2049.
- -r or --rdma
- specify that NFS requests on the standard RDMA port
("nfsrdma", port 20049) should be honored.
-
--rdma=port
- Listen for RDMA requests on an alternate port - may be a
number or a name listed in /etc/services.
- -N or --no-nfs-version vers
- This option can be used to request that rpc.nfsd
does not offer certain versions of NFS. The current version of
rpc.nfsd can support major NFS versions 3,4 and the minor versions
4.0, 4.1 and 4.2.
- -s or --syslog
- By default, rpc.nfsd logs error messages (and debug
messages, if enabled) to stderr. This option makes rpc.nfsd log
these messages to syslog instead. Note that errors encountered during
option processing will still be logged to stderr regardless of this
option.
- -t or --tcp
- Instruct the kernel nfs server to open and listen on a TCP
socket. This is the default.
- -T or --no-tcp
- Instruct the kernel nfs server not to open and listen on a
TCP socket.
- -u or --udp
- Instruct the kernel nfs server to open and listen on a UDP
socket.
- -U or --no-udp
- Instruct the kernel nfs server not to open and listen on a
UDP socket. This is the default.
- -V or --nfs-version vers
- This option can be used to request that rpc.nfsd
offer certain versions of NFS. The current version of rpc.nfsd can
support major NFS versions 3,4 and the minor versions 4.0, 4.1 and
4.2.
- -L or --lease-time seconds
- Set the lease-time used for NFSv4. This corresponds to how
often clients need to confirm their state with the server. Valid range is
from 10 to 3600 seconds.
- -G or --grace-time seconds
- Set the grace-time used for NFSv4 and NLM (for NFSv2 and
NFSv3). New file open requests (NFSv4) and new file locks (NLM) will not
be allowed until after this time has passed to allow clients to recover
state.
- nproc
- specify the number of NFS server threads. By default, eight
threads are started. However, for optimum performance several threads
should be used. The actual figure depends on the number of and the work
load created by the NFS clients, but a useful starting point is eight
threads. Effects of modifying that number can be checked using the
nfsstat(8) program.
Note that if the NFS server is already running, then the options for specifying
host, port, and protocol will be ignored. The number of processes given will
be the only option considered, and the number of active
nfsd processes
will be increased or decreased to match this number. In particular
rpc.nfsd
0 will stop all threads and thus close any open connections.
Many of the options that can be set on the command line can also be controlled
through values set in the
[nfsd] section of the
/etc/nfs.conf
configuration file. Values recognized include:
- threads
- The number of threads to start.
- host
- A host name, or comma separated list of host names, that
rpc.nfsd will listen on. Use of the --host option replaces
all host names listed here.
- grace-time
- The grace time, for both NFSv4 and NLM, in seconds.
- lease-time
- The lease time for NFSv4, in seconds.
- port
- Set the port for TCP/UDP to bind to.
- rdma
- Enable RDMA port (with "on" or "yes"
etc) on the standard port ("nfsrdma", port 20049).
- rdma-port
- Set an alternate RDMA port.
- UDP
- Enable (with "on" or "yes" etc) or
disable ("off", "no") UDP support.
- TCP
- Enable or disable TCP support.
- vers3
- vers4
- Enable or disable a major NFS version. 3 and 4 are normally
enabled by default.
- vers4.1
- vers4.2
- Setting these to "off" or similar will disable
the selected minor versions. Setting to "on" will enable them.
The default values are determined by the kernel, and usually minor
versions default to being enabled once the implementation is sufficiently
complete.
If the program is built with TI-RPC support, it will enable any protocol and
address family combinations that are marked visible in the
netconfig
database.
nfsd(7),
rpc.mountd(8),
exports(5),
exportfs(8),
nfs.conf(5),
rpc.rquotad(8),
nfsstat(8),
netconfig(5).
Olaf Kirch, Bill Hawes, H. J. Lu, G. Allan Morris III, and a host of
others.