1rpc.nfsd(8) System Manager's Manual rpc.nfsd(8)
2
6 rpc.nfsd - NFS server process
7
9 /usr/sbin/rpc.nfsd [options] nproc
10
12 The rpc.nfsd program implements the user level part of the NFS service.
13 The main functionality is handled by the nfsd kernel module. The user
14 space program merely specifies what sort of sockets the kernel service
15 should listen on, what NFS versions it should support, and how many
16 kernel threads it should use.
17 The rpc.mountd server provides an ancillary service needed to satisfy
19 mount requests by NFS clients.
20
22 -d or --debug
23 enable logging of debugging messages
24 -H or --host hostname
26 specify a particular hostname (or address) that NFS requests
27 will be accepted on. By default, rpc.nfsd will accept NFS
28 requests on all known network addresses. Note that lockd (which
29 performs file locking services for NFS) may still accept request
30 on all known network addresses. This may change in future
31 releases of the Linux Kernel. This option can be used multiple
32 time to listen to more than one interface.
33 -p or --port port
35 specify a different port to listen on for NFS requests. By
36 default, rpc.nfsd will listen on port 2049.
37 -r or --rdma
39 specify that NFS requests on the standard RDMA port ("nfsrdma",
40 port 20049) should be honored.
41 --rdma=port
43 Listen for RDMA requests on an alternate port - may be a number
44 or a name listed in /etc/services.
45 -N or --no-nfs-version vers
47 This option can be used to request that rpc.nfsd does not offer
48 certain versions of NFS. The current version of rpc.nfsd can
49 support major NFS versions 2,3,4 and the minor versions 4.0, 4.1
50 and 4.2.
51 -s or --syslog
53 By default, rpc.nfsd logs error messages (and debug messages, if
54 enabled) to stderr. This option makes rpc.nfsd log these mes‐
55 sages to syslog instead. Note that errors encountered during
56 option processing will still be logged to stderr regardless of
57 this option.
58 -t or --tcp
60 Instruct the kernel nfs server to open and listen on a TCP
61 socket. This is the default.
62 -T or --no-tcp
64 Instruct the kernel nfs server not to open and listen on a TCP
65 socket.
66 -u or --udp
68 Instruct the kernel nfs server to open and listen on a UDP
69 socket.
70 -U or --no-udp
72 Instruct the kernel nfs server not to open and listen on a UDP
73 socket. This is the default.
74 -V or --nfs-version vers
76 This option can be used to request that rpc.nfsd offer certain
77 versions of NFS. The current version of rpc.nfsd can support
78 major NFS versions 2,3,4 and the minor versions 4.0, 4.1 and
79 4.2.
80 -L or --lease-time seconds
82 Set the lease-time used for NFSv4. This corresponds to how
83 often clients need to confirm their state with the server. Valid
84 range is from 10 to 3600 seconds.
85 -G or --grace-time seconds
87 Set the grace-time used for NFSv4 and NLM (for NFSv2 and NFSv3).
88 New file open requests (NFSv4) and new file locks (NLM) will not
89 be allowed until after this time has passed to allow clients to
90 recover state.
91 nproc specify the number of NFS server threads. By default, eight
93 threads are started. However, for optimum performance several
94 threads should be used. The actual figure depends on the number
95 of and the work load created by the NFS clients, but a useful
96 starting point is eight threads. Effects of modifying that num‐
97 ber can be checked using the nfsstat(8) program.
98 Note that if the NFS server is already running, then the options for
100 specifying host, port, and protocol will be ignored. The number of
101 processes given will be the only option considered, and the number of
102 active nfsd processes will be increased or decreased to match this num‐
103 ber. In particular rpc.nfsd 0 will stop all threads and thus close any
104 open connections.
105
108 Many of the options that can be set on the command line can also be
109 controlled through values set in the [nfsd] section of the
110 /etc/nfs.conf configuration file. Values recognized include:
111 threads
113 The number of threads to start.
114 host A host name, or comma separated list of host names, that
116 rpc.nfsd will listen on. Use of the --host option replaces all
117 host names listed here.
118 grace-time
120 The grace time, for both NFSv4 and NLM, in seconds.
121 lease-time
123 The lease time for NFSv4, in seconds.
124 port Set the port for TCP/UDP to bind to.
126 rdma Enable RDMA port (with "on" or "yes" etc) on the standard port
128 ("nfsrdma", port 20049).
129 rdma-port
131 Set an alternate RDMA port.
132 UDP Enable (with "on" or "yes" etc) or disable ("off", "no") UDP
134 support.
135 TCP Enable or disable TCP support.
137 vers2
139 vers3
141 vers4 Enable or disable a major NFS version. 3 and 4 are normally
143 enabled by default.
144 vers4.1
146 vers4.2
148 Setting these to "off" or similar will disable the selected
149 minor versions. Setting to "on" will enable them. The default
150 values are determined by the kernel, and usually minor versions
151 default to being enabled once the implementation is sufficiently
152 complete.
153
156 If the program is built with TI-RPC support, it will enable any proto‐
157 col and address family combinations that are marked visible in the net‐
158 config database.
159
162 nfsd(7), rpc.mountd(8), exports(5), exportfs(8), nfs.conf(5), rpc.rquo‐
163 tad(8), nfsstat(8), netconfig(5).
164
166 Olaf Kirch, Bill Hawes, H. J. Lu, G. Allan Morris III, and a host of
167 others.
168 20 Feb 2014 rpc.nfsd(8)