1rpc.nfsd(8)                 System Manager's Manual                rpc.nfsd(8)
2
3
4

NAME

6       rpc.nfsd - NFS server process
7

SYNOPSIS

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

DESCRIPTION

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
18       The  rpc.mountd  server provides an ancillary service needed to satisfy
19       mount requests by NFS clients.
20

OPTIONS

22       -d  or  --debug
23              enable logging of debugging messages
24
25       -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
34       -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
38       -r  or  --rdma
39              specify  that NFS requests on the standard RDMA port ("nfsrdma",
40              port 20049) should be honored.
41
42       --rdma=port
43              Listen for RDMA requests on an alternate port - may be a  number
44              or a name listed in /etc/services.
45
46       -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
52       -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
59       -t  or  --tcp
60              Instruct the kernel nfs server to  open  and  listen  on  a  TCP
61              socket. This is the default.
62
63       -T  or  --no-tcp
64              Instruct  the  kernel nfs server not to open and listen on a TCP
65              socket.
66
67       -u  or  --udp
68              Instruct the kernel nfs server to  open  and  listen  on  a  UDP
69              socket.
70
71       -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
75       -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
81       -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
86       -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
92       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
99       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
106

CONFIGURATION FILE

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
112       threads
113              The number of threads to start.
114
115       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
119       grace-time
120              The grace time, for both NFSv4 and NLM, in seconds.
121
122       lease-time
123              The lease time for NFSv4, in seconds.
124
125       port   Set the port for TCP/UDP to bind to.
126
127       rdma   Set RDMA port.  Use "rdma=nfsrdma" to enable standard port.
128
129       UDP    Enable (with "on" or "yes" etc) or  disable  ("off",  "no")  UDP
130              support.
131
132       TCP    Enable or disable TCP support.
133
134       vers2
135
136       vers3
137
138       vers4  Enable  or  disable  a  major NFS version.  3 and 4 are normally
139              enabled by default.
140
141       vers4.1
142
143       vers4.2
144              Setting these to "off" or  similar  will  disable  the  selected
145              minor  versions.  Setting to "on" will enable them.  The default
146              values are determined by the kernel, and usually minor  versions
147              default to being enabled once the implementation is sufficiently
148              complete.
149
150

NOTES

152       If the program is built with TI-RPC support, it will enable any  proto‐
153       col and address family combinations that are marked visible in the net‐
154       config database.
155
156

SEE ALSO

158       nfsd(7), rpc.mountd(8), exports(5), exportfs(8), nfs.conf(5), rpc.rquo‐
159       tad(8), nfsstat(8), netconfig(5).
160

AUTHOR

162       Olaf  Kirch,  Bill  Hawes, H. J. Lu, G. Allan Morris III, and a host of
163       others.
164
165
166
167                                  20 Feb 2014                      rpc.nfsd(8)
Impressum