nfs.conf(5)

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
34       assigned 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
49       included file appeared in place of the include line.
50
51       Lookup of section and value names is case-insensitive.
52
53       Where a Boolean value is expected, any of true, t, yes, y, on, or 1 can
54       be  used  for  "true", while false, f, no, n, off, or 0 can be used for
55       "false".  Comparisons are case-insensitive.
56
57

SECTIONS

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

FILES

146       /etc/nfs.conf
147

NAME

SYNOPSIS

DESCRIPTION

SECTIONS

FILES

SEE ALSO