|
HTML rendering created 2025-09-06 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH. |
|
|
NAME | SYNOPSIS | DESCRIPTION | SECTIONS | FILES | SEE ALSO | COLOPHON |
|
|
|
NFS.CONF(5) File Formats Manual NFS.CONF(5)
nfs.conf - general configuration for NFS daemons and tools
/usr/etc/nfs.conf /usr/etc/nfs.conf.d/ /etc/nfs.conf
/etc/nfs.conf.d/
These files contain site-specific configuration for various NFS
daemons and other processes. Most configuration can also be
passed to processes via command line arguments, but it can be more
convenient to have a central file. In particular, this encourages
consistent configuration across different processes.
When command line options are provided, they override values set
in this file. When this file does not specify a particular
parameter, and no command line option is provided, each tool
provides its own default values.
The file format supports multiple sections, each of which can
contain multiple value assignments. A section is introduced by a
line containing the section name enclosed in square brackets, so
[global]
would introduce a section called global. A value assignment is a
single line that has the name of the value, an equals sign, and a
setting for the value, so
threads = 4
would set the value named threads in the current section to 4.
Leading and trailing spaces and tab are ignored, as are spaces and
tabs surrounding the equals sign. Single and double quotes
surrounding the assigned value are also removed. If the resulting
string is empty, the whole assignment is ignored.
Any line starting with “#” or “;” is ignored, as is any blank
line.
If the assigned value started with a “$” then the remainder is
treated as a name and looked for in the section [environment] or
in the processes environment (see environ(7)). The value found is
used for this value.
The value name include is special. If a section contains
include = /some/file/name
then the named file will be read, and any value assignments found
there-in will be added to the current section. If the file
contains section headers, then new sections will be created just
as if the included file appeared in place of the include line. If
the file name starts with a hyphen then that is stripped off
before the file is opened, and if file doesn't exist no warning is
given. Normally a non-existent include file generates a warning.
Lookup of section and value names is case-insensitive.
Where a Boolean value is expected, any of true, t, yes, y, on, or
1 can be used for "true", while false, f, no, n, off, or 0 can be
used for "false". Comparisons are case-insensitive.
The following sections are known to various programs, and can
contain the given named values. Most sections can also contain a
debug value, which can be one or more from the list general, call,
auth, parse, all. When a list is given, the members should be
comma-separated. The values 0 and 1 are also accepted, with '0'
making no changes to the debug level, and '1' equivalent to
specifying 'all'.
general
Recognized values: pipefs-directory.
See blkmapd(8), rpc.idmapd(8), and rpc.gssd(8) for details.
exports
Recognized values: rootdir.
Setting rootdir to a valid path causes the nfs server to
act as if the supplied path is being prefixed to all the
exported entries. For instance, if rootdir=/my/root, and
there is an entry in /etc/exports for /filesystem, then the
client will be able to mount the path as /filesystem, but
on the server, this will resolve to the path
/my/root/filesystem.
exportd
Recognized values: manage-gids, threads, cache-use-ipaddr,
ttl, state-directory-path
See exportd(8) for details.
Note that setting "debug = auth" for exportd is equivalent
to providing the --log-auth option.
nfsd Recognized values: threads, host, scope, port, grace-time,
lease-time, udp, tcp, vers3, vers4, vers4.0, vers4.1,
vers4.2, rdma,
Version and protocol values are Boolean values as described
above, and are also used by rpc.mountd. Threads and the
two times are integers. port and rdma are service names or
numbers. See rpc.nfsd(8) for details.
mountd Recognized values: manage-gids, descriptors, port, threads,
reverse-lookup, cache-use-ipaddr, ttl, state-directory-
path, ha-callout.
These, together with the protocol and version values in the
[nfsd] section, are used to configure mountd. See
rpc.mountd(8) for details.
Note that setting "debug = auth" for mountd is equivalent
to providing the --log-auth option.
The state-directory-path value in the [mountd] section is
also used by exportfs(8).
statd Recognized values: port, outgoing-port, name, state-
directory-path, ha-callout.
See rpc.statd(8) for details.
lockd Recognized values: port and udp-port.
See rpc.statd(8) for details.
sm-notify
Recognized values: retry-time, outgoing-port, and outgoing-
addr.
See sm-notify(8) for details.
gssd Recognized values: verbosity, rpc-verbosity, use-memcache,
use-machine-creds, use-gss-proxy, avoid-dns, limit-to-
legacy-enctypes, context-timeout, rpc-timeout, keytab-file,
cred-cache-directory, preferred-realm, set-home.
See rpc.gssd(8) for details.
svcgssd
Recognized values: principal.
See rpc.svcgssd(8) for details.
exportfs
Only debug= is recognized.
nfsrahead
Recognized values: nfs, nfsv4, default.
See nfsrahead(5) for deatils.
/usr/etc/nfs.conf
/usr/etc/nfs.conf.d/*.conf
/etc/nfs.conf
/etc/nfs.conf.d/*.conf
Various configuration files read in order. Later settings
override earlier settings.
rpc.nfsd(8), rpc.mountd(8), nfsmount.conf(5).
This page is part of the nfs-utils (NFS utilities) project.
Information about the project can be found at
⟨http://linux-nfs.org/wiki/index.php/Main_Page⟩. If you have a bug
report for this manual page, see
⟨http://linux-nfs.org/wiki/index.php/Main_Page⟩. This page was
obtained from the project's upstream Git repository
⟨git://git.linux-nfs.org/projects/steved/nfs-utils.git⟩ on
2025-08-11. (At that time, the date of the most recent commit
that was found in the repository was 2025-06-27.) If you discover
any rendering problems in this HTML version of the page, or you
believe there is a better or more up-to-date source for the page,
or you have corrections or improvements to the information in this
COLOPHON (which is not part of the original manual page), send a
mail to [email protected]
NFS.CONF(5)
Pages that refer to this page: nfsrahead(5), nfs.systemd(7), blkmapd(8), exportd(8), exportfs(8), mountd(8), nfsd(8)
|
HTML rendering created 2025-09-06 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH. |
|