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 re‐
28              quests 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  re‐
31              leases  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  de‐
36              fault, 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 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 op‐
56              tion  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 ma‐
78              jor NFS versions 3,4 and the minor versions 4.0, 4.1 and 4.2.
79
80       -L  or  --lease-time seconds
81              Set the lease-time used for NFSv4.  This corresponds to how  of‐
82              ten  clients  need to confirm their state with the server. Valid
83              range is from 10 to 3600 seconds.
84
85       -G  or  --grace-time seconds
86              Set the grace-time used for NFSv4 and NLM (for NFSv2 and NFSv3).
87              New file open requests (NFSv4) and new file locks (NLM) will not
88              be allowed until after this time has passed to allow clients  to
89              recover state.
90
91       nproc  specify  the  number  of  NFS  server threads. By default, eight
92              threads are started. However, for  optimum  performance  several
93              threads  should be used. The actual figure depends on the number
94              of and the work load created by the NFS clients,  but  a  useful
95              starting  point is eight threads. Effects of modifying that num‐
96              ber can be checked using the nfsstat(8) program.
97
98       Note that if the NFS server is already running, then  the  options  for
99       specifying  host,  port,  and  protocol will be ignored.  The number of
100       processes given will be the only option considered, and the  number  of
101       active nfsd processes will be increased or decreased to match this num‐
102       ber.  In particular rpc.nfsd 0 will stop all threads and thus close any
103       open connections.
104
105

CONFIGURATION FILE

107       Many  of  the  options  that can be set on the command line can also be
108       controlled  through  values  set  in  the   [nfsd]   section   of   the
109       /etc/nfs.conf configuration file.  Values recognized include:
110
111       threads
112              The number of threads to start.
113
114       host   A  host  name,  or  comma  separated  list  of  host names, that
115              rpc.nfsd will listen on.  Use of the --host option replaces  all
116              host names listed here.
117
118       grace-time
119              The grace time, for both NFSv4 and NLM, in seconds.
120
121       lease-time
122              The lease time for NFSv4, in seconds.
123
124       port   Set the port for TCP/UDP to bind to.
125
126       rdma   Enable  RDMA  port (with "on" or "yes" etc) on the standard port
127              ("nfsrdma", port 20049).
128
129       rdma-port
130              Set an alternate RDMA port.
131
132       UDP    Enable (with "on" or "yes" etc) or  disable  ("off",  "no")  UDP
133              support.
134
135       TCP    Enable or disable TCP support.
136
137       vers3
138
139       vers4  Enable or disable a major NFS version.  3 and 4 are normally en‐
140              abled by default.
141
142       vers4.1
143
144       vers4.2
145              Setting these to "off" or similar will disable the selected  mi‐
146              nor  versions.   Setting  to "on" will enable them.  The default
147              values are determined by the kernel, and usually minor  versions
148              default to being enabled once the implementation is sufficiently
149              complete.
150
151

NOTES

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

SEE ALSO

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

AUTHOR

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