| .\" |
| .\" nfsd(8) |
| .\" |
| .\" Copyright (C) 1999 Olaf Kirch <okir@monad.swb.de> |
| .TH rpc.nfsd 8 "20 Feb 2014" |
| .SH NAME |
| rpc.nfsd \- NFS server process |
| .SH SYNOPSIS |
| .BI "/usr/sbin/rpc.nfsd [" options "]" " "nproc |
| .SH DESCRIPTION |
| The |
| .B rpc.nfsd |
| program implements the user level part of the NFS service. The |
| main functionality is handled by the |
| .B 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. |
| .P |
| The |
| .B rpc.mountd |
| server provides an ancillary service needed to satisfy mount requests |
| by NFS clients. |
| .SH OPTIONS |
| .TP |
| .B \-d " or " \-\-debug |
| enable logging of debugging messages |
| .TP |
| .B \-H " or " \-\-host hostname |
| specify a particular hostname (or address) that NFS requests will |
| be accepted on. By default, |
| .B rpc.nfsd |
| will accept NFS requests on all known network addresses. |
| Note that |
| .B 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. |
| .TP |
| .B \-p " or " \-\-port port |
| specify a different port to listen on for NFS requests. By default, |
| .B rpc.nfsd |
| will listen on port 2049. |
| .TP |
| .B \-r " or " \-\-rdma |
| specify that NFS requests on the standard RDMA port ("nfsrdma", port |
| 20049) should be honored. |
| .TP |
| .BI \-\-rdma= port |
| Listen for RDMA requests on an alternate port - may be a number or a |
| name listed in |
| .BR /etc/services . |
| .TP |
| .B \-N " or " \-\-no-nfs-version vers |
| This option can be used to request that |
| .B rpc.nfsd |
| does not offer certain versions of NFS. The current version of |
| .B rpc.nfsd |
| can support NFS versions 2,3,4 and the newer version 4.1. |
| .TP |
| .B \-s " or " \-\-syslog |
| By default, |
| .B rpc.nfsd |
| logs error messages (and debug messages, if enabled) to stderr. This option makes |
| .B 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. |
| .TP |
| .B \-T " or " \-\-no-tcp |
| Disable |
| .B rpc.nfsd |
| from accepting TCP connections from clients. |
| .TP |
| .B \-U " or " \-\-no-udp |
| Disable |
| .B rpc.nfsd |
| from accepting UDP connections from clients. |
| .TP |
| .B \-V " or " \-\-nfs-version vers |
| This option can be used to request that |
| .B rpc.nfsd |
| offer certain versions of NFS. The current version of |
| .B rpc.nfsd |
| can support NFS versions 2,3,4 and the newer version 4.1. |
| .TP |
| .B \-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. |
| .TP |
| .B \-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. |
| .TP |
| .I 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 |
| .BR nfsstat (8) |
| program. |
| .P |
| 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 |
| .B nfsd |
| processes will be increased or decreased to match this number. |
| In particular |
| .B rpc.nfsd 0 |
| will stop all threads and thus close any open connections. |
| |
| .SH NOTES |
| If the program is built with TI-RPC support, it will enable any protocol and |
| address family combinations that are marked visible in the |
| .B netconfig |
| database. |
| |
| .SH SEE ALSO |
| .BR rpc.mountd (8), |
| .BR exports (5), |
| .BR exportfs (8), |
| .BR rpc.rquotad (8), |
| .BR nfsstat (8), |
| .BR netconfig(5). |
| .SH AUTHOR |
| Olaf Kirch, Bill Hawes, H. J. Lu, G. Allan Morris III, |
| and a host of others. |
