nfsd: NFS server process - Linux Manuals (8) (2024)

nfsd: NFS server process

Command to display nfsd manual in Linux: $ man 8 nfsd

NAME

rpc.nfsd - NFS server process

SYNOPSIS

/usr/sbin/rpc.nfsd [options] nproc

DESCRIPTION

Therpc.nfsdprogram implements the user level part of the NFS service. Themain functionality is handled by thenfsdkernel module. The user space program merely specifies what sort of socketsthe kernel service should listen on, what NFS versions it should support, andhow many kernel threads it should use.

Therpc.mountdserver provides an ancillary service needed to satisfy mount requestsby NFS clients.

OPTIONS

-d or --debug

enable logging of debugging messages

-H or --host hostname

specify a particular hostname (or address) that NFS requests willbe accepted on. By default,rpc.nfsdwill accept NFS requests on all known network addresses.Note thatlockd(which performs file locking services for NFS) may still acceptrequest on all known network addresses. This may change in futurereleases 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.nfsdwill listen on port 2049.

-r or --rdma

specify that NFS requests on the standard RDMA port ("nfsrdma", port20049) should be honored.

--rdma=port

Listen for RDMA requests on an alternate port - may be a number or aname listed in/etc/services.

-N or --no-nfs-version vers

This option can be used to request that rpc.nfsddoes not offer certain versions of NFS. The current version ofrpc.nfsdcan support major NFS versions 2,3,4 and the minor versions 4.1 and 4.2.

-s or --syslog

By default,rpc.nfsdlogs error messages (and debug messages, if enabled) to stderr. This option makes rpc.nfsdlog these messages to syslog instead. Note that errors encountered duringoption 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

Disablerpc.nfsdfrom accepting UDP connections from clients.

-V or --nfs-version vers

This option can be used to request that rpc.nfsdoffer certain versions of NFS. The current version ofrpc.nfsdcan support major NFS versions 2,3,4 and the minor versions 4.1 and 4.2.

-L or --lease-time seconds

Set the lease-time used for NFSv4. This corresponds to how oftenclients need to confirm their state with the server. Valid range isfrom 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 beallowed until after this time has passed to allow clients to recover state.

nproc

specify the number of NFS server threads. By default, eightthreads are started. However, for optimum performance several threadsshould be used. The actual figure depends on the number of and the workload created by the NFS clients, but a useful starting point iseight threads. Effects of modifying that number can be checked usingthenfsstat(8)program.

Note that if the NFS server is already running, then the options forspecifying host, port, and protocol will be ignored. The number ofprocesses given will be the only option considered, and the number ofactivenfsdprocesses will be increased or decreased to match this number.In particularrpc.nfsd 0will stop all threads and thus close any open connections.

CONFIGURATION FILE

Many of the options that can be set on the command line can also becontrolled through values set in the[nfsd]section of the/etc/nfs.confconfiguration file. Values recognized include:

threads

The number of threads to start.

host

A host name, or comma separated list of host names, thatrpc.nfsdwill listen on. Use of the--hostoption 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

Set RDMA port. Use "rdma=nfsrdma" to enable standard port.

UDP

Enable (with "on" or "yes" etc) or disable ("off", "no") UDP support.

TCP

Enable or disable TCP support.

vers2

vers3

vers4

Enable or disable a major NFS version. 3 and 4 are normally enabledby default.

vers4.1

vers4.2

Setting these to "off" or similar will disable the selected minorversions. Setting to "on" will enable them. The default valuesare determined by the kernel, and usually minor versions default tobeing enabled once the implementation is sufficiently complete.

NOTES

If the program is built with TI-RPC support, it will enable any protocol andaddress family combinations that are marked visible in thenetconfigdatabase.

AUTHOR

Olaf Kirch, Bill Hawes, H. J. Lu, G. Allan Morris III,and a host of others.