1NFS.CONF(5)                   File Formats Manual                  NFS.CONF(5)
2
3
4

NAME

6       nfs.conf - general configuration for NFS daemons and tools
7

SYNOPSIS

9       /etc/nfs.conf
10

DESCRIPTION

12       This  file contains site-specific configuration for various NFS daemons
13       and other processes.  Most configuration can also  be  passed  to  pro‐
14       cesses  via  command  line  arguments, but it can be more convenient to
15       have a central file.  In particular, this encourages consistent config‐
16       uration across different processes.
17
18       When  command  line  options  are provided, they override values set in
19       this file.  When this file does not specify a particular parameter, and
20       no  command line option is provided, each tool provides its own default
21       values.
22
23       The file format supports multiple sections, each of which  can  contain
24       multiple value assignments.  A section is introduced by a line contain‐
25       ing the section name enclosed in square brackets, so
26              [global]
27       would introduce a section called global.  A value assignment is a  sin‐
28       gle  line that has the name of the value, an equals sign, and a setting
29       for the value, so
30              threads = 4
31       would set the value named threads in the current section to 4.  Leading
32       and  trailing  spaces  and tab are ignored, as are spaces and tabs sur‐
33       rounding the equals sign.  Single and double quotes surrounding the as‐
34       signed  value  are also removed.  If the resulting string is empty, the
35       whole assignment is ignored.
36
37       Any line starting with “#” or “;” is ignored, as is any blank line.
38
39       If the assigned value started with a “$” then the remainder is  treated
40       as  a  name  and looked for in the section [environment] or in the pro‐
41       cesses environment (see environ(7)).  The value found is used for  this
42       value.
43
44       The value name include is special.  If a section contains
45              include = /some/file/name
46       then  the  named  file  will  be  read, and any value assignments found
47       there-in will be added to the current section.  If  the  file  contains
48       section  headers,  then new sections will be created just as if the in‐
49       cluded file appeared in place of the include line.  If  the  file  name
50       starts  with  a  hyphen  then  that  is stripped off before the file is
51       opened, and if file doesn't exist no warning is given.  Normally a non-
52       existent include file generates a warning.
53
54       Lookup of section and value names is case-insensitive.
55
56       Where a Boolean value is expected, any of true, t, yes, y, on, or 1 can
57       be used for "true", while false, f, no, n, off, or 0 can  be  used  for
58       "false".  Comparisons are case-insensitive.
59
60

SECTIONS

62       The  following  sections are known to various programs, and can contain
63       the given named values.  Most sections can also contain a debug  value,
64       which can be one or more from the list general, call, auth, parse, all.
65       When a list is given, the members should be comma-separated.
66
67       general
68              Recognized values: pipefs-directory.
69
70              See blkmapd(8), rpc.idmapd(8), and rpc.gssd(8) for details.
71
72
73       exports
74              Recognized values: rootdir.
75
76              Setting rootdir to a valid path causes the nfs server to act  as
77              if  the  supplied path is being prefixed to all the exported en‐
78              tries. For instance, if rootdir=/my/root, and there is an  entry
79              in /etc/exports for /filesystem, then the client will be able to
80              mount the path as /filesystem, but on the server, this will  re‐
81              solve to the path /my/root/filesystem.
82
83
84       exportd
85              Recognized  values: threads, cache-use-upaddr, ttl, state-direc‐
86              tory-path
87
88              See exportd(8) for details.
89
90              Note that setting "debug = auth" for exportd  is  equivalent  to
91              providing the --log-auth option.
92
93
94       nfsdcltrack
95              Recognized values: storagedir.
96
97              The  nfsdcltrack program is run directly by the Linux kernel and
98              there is no opportunity to provide command  line  arguments,  so
99              the  configuration  file  is the only way to configure this pro‐
100              gram.  See nfsdcltrack(8) for details.
101
102
103       nfsd   Recognized values: threads, host, port, grace-time,  lease-time,
104              udp, tcp, vers3, vers4, vers4.0, vers4.1, vers4.2, rdma,
105
106              Version  and  protocol  values  are  Boolean values as described
107              above, and are also used by rpc.mountd.   Threads  and  the  two
108              times are integers.  port and rdma are service names or numbers.
109              See rpc.nfsd(8) for details.
110
111
112       mountd Recognized values: manage-gids, descriptors, port, threads,  re‐
113              verse-lookup,  cache-use-upaddr,  ttl, state-directory-path, ha-
114              callout.
115
116              These, together with the protocol  and  version  values  in  the
117              [nfsd] section, are used to configure mountd.  See rpc.mountd(8)
118              for details.
119
120              Note that setting "debug = auth" for  mountd  is  equivalent  to
121              providing the --log-auth option.
122
123              The  state-directory-path  value in the [mountd] section is also
124              used by exportfs(8).
125
126
127       statd  Recognized values: port, outgoing-port,  name,  state-directory-
128              path, ha-callout.
129
130              See rpc.statd(8) for details.
131
132
133       lockd  Recognized values: port and udp-port.
134
135              See rpc.statd(8) for details.
136
137
138       sm-notify
139              Recognized values: retry-time, outgoing-port, and outgoing-addr.
140
141              See sm-notify(8) for details.
142
143
144       gssd   Recognized  values: verbosity, rpc-verbosity, use-memcache, use-
145              machine-creds,  use-gss-proxy,  avoid-dns,  limit-to-legacy-enc‐
146              types, context-timeout, rpc-timeout, keytab-file, cred-cache-di‐
147              rectory, preferred-realm, set-home.
148
149              See rpc.gssd(8) for details.
150
151
152       svcgssd
153              Recognized values: principal.
154
155              See rpc.svcgssd(8) for details.
156
157
158       exportfs
159              Only debug= is recognized.
160
161
162       nfsrahead
163              Recognized values: nfs, nfsv4, default.
164
165              See nfsrahead(5) for deatils.
166
167

FILES

169       /etc/nfs.conf
170                 Default NFS client configuration file
171
172       /etc/nfs.conf.d
173                 When this directory exists and files ending with ".conf"  ex‐
174                 ist, those files will be used to set configuration variables.
175                 These files will override variables set in /etc/nfs.conf
176

SEE ALSO

178       nfsdcltrack(8), rpc.nfsd(8), rpc.mountd(8), nfsmount.conf(5).
179
180
181
182                                                                   NFS.CONF(5)
Impressum