NAME

       nfsconf - Query various NFS configuration settings

SYNOPSIS

       nfsconf --dump [-v|--verbose] [-f|--file infile.conf] [outfile]

       nfsconf --entry [--arg subsection] section tag

       nfsconf --get [-v|--verbose] [-f|--file infile.conf] [-a|--arg subsection] section tag

       nfsconf --isset [-v|--verbose] [-f|--file infile.conf] [-a|--arg subsection] section tag

       nfsconf   --set  [-v|--verbose]  [-m|--modified  Modified  by  text]  [-f|--file  infile.conf]  [-a|--arg
       subsection] section tag value

       nfsconf --unset [-v|--verbose] [-f|--file infile.conf] [-a|--arg subsection] section tag

DESCRIPTION

       The nfsconf command can be used to test for and retrieve configuration settings from a range of nfs-utils
       configuration files.

   Modes
       The following modes are available:

       -d, --dump
              Output an alphabetically sorted dump of the current configuration in conf file format. Accepts  an
              optional filename in which to write the output.

       -e, --entry
              retrieve the config entry rather than its current expanded value

       -i, --isset
              Test if a specific tag has a value set.

       -g, --get
              Output the current value of the specified tag.

       -s, --set
              Update  or  Add  a  tag  and  value  to  the config file in a specified section, creating the tag,
              section, and file if necessary. If the section is defined as '#' then a comment is appended to the
              file. If a comment is set with a tag name then any exiting tagged comment with a matching name  is
              replaced.

       -u, --unset
              Remove the specified tag and its value from the config file.

OPTIONS

   Options valid in all modes
       -v, --verbose
              Increase verbosity and print debugging information.

       -f, --file infile
              Select a different config file to operate upon, default is /etc/nfs.conf

   Options only valid in --entry and --get and --isset modes.
       -a, --arg subsection
              Select a specific sub-section

   Options only valid in --set mode.
       -m,  --modified "Modified by nfsconf" Set the text on the Modified date comment in the file. Set to empty
       to remove.

EXIT STATUS

   --isset mode
       In this mode the command will return success (0) if the selected tag has a value,  any  other  exit  code
       indicates the value is not set, or some other error has occurred.

   all other modes
       Success  is  indicated by an exit status of zero, any other status indicates an error. Error messages are
       output on stderr, and increasing verbosity will give more detailed explanations if any are available.

EXAMPLES

       nfsconf -v --dump --file /tmp/testconf.conf sorted.conf
              Check a new config file for syntax errors and output a sorted version for ease of comparison  with
              existing settings.

       if ! nfsconf --isset gssd preferred-realm ; then echo 'No preferred realm configured for gss'; fi
              The  tool  allows  for  easy testing of configuration values from shell scripts, here we test if a
              specific value has been set.

       nfsconf --file /etc/nfsmount.conf --get --arg /home MountPoint background
              Show default value for background option for NFS mounts of the /home path.

       nfsconf --file /etc/nfs.conf --set nfsd debug 1
              Enable debugging in nfsd

FILES

       /etc/nfs.conf

SEE ALSO

       nfsd(8), exportfs(8), idmapd(8), statd(8)

AUTHOR

       Justin Mitchell <jumitche@redhat.com>

                                                   2 May 2018                                         nfsconf(8)