nfsd
rpc.nfsd(8) System Manager's Manual rpc.nfsd(8)
NAME
rpc.nfsd - NFS server process
SYNOPSIS
/usr/sbin/rpc.nfsd [options] nproc
DESCRIPTION
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.
OPTIONS
-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 re-
quests 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 re-
leases 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 de-
fault, 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 NFS versions 2,3,4 and the newer version 4.1.
-s or --syslog
By default, rpc.nfsd logs error messages (and debug messages, if
enabled) to stderr. This option makes rpc.nfsd log these mes-
sages to syslog instead. Note that errors encountered during op-
tion processing will still be logged to stderr regardless of
this option.
-T or --no-tcp
Disable rpc.nfsd from accepting TCP connections from clients.
-U or --no-udp
Disable rpc.nfsd from accepting UDP connections from clients.
-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 NFS
versions 2,3,4 and the newer version 4.1.
-L or --lease-time seconds
Set the lease-time used for NFSv4. This corresponds to how of-
ten 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, just one
thread is 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 8 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 num-
ber. In particular rpc.nfsd 0 will stop all threads and thus close any
open connections.
NOTES
If the program is built with TI-RPC support, it will enable any proto-
col and address family combinations that are marked visible in the net-
config database.
SEE ALSO
nfsd(7), rpc.mountd(8), exports(5), exportfs(8), rpc.rquotad(8), nfs-
stat(8), netconfig(5).
AUTHOR
Olaf Kirch, Bill Hawes, H. J. Lu, G. Allan Morris III, and a host of
others.
20 Feb 2014 rpc.nfsd(8)
Man Pages Copyright Respective Owners. Site Copyright (C) 1994 - 2024
Hurricane Electric.
All Rights Reserved.