NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXIT STATUS | EXAMPLES | FILES | SEE ALSO | AUTHOR | COLOPHON

nfsconf(8)                 System Manager's Manual                nfsconf(8)

NAME         top

       nfsconf - Query various NFS configuration settings

SYNOPSIS         top

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

       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] [-f|--file infile.conf] [-a|--arg
       subsection] section tag value

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

DESCRIPTION         top

       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.

       -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, creating the
              file if necessary.

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

OPTIONS         top

   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 --get and --isset modes.
       -a, --arg subsection
              Select a specific sub-section

EXIT STATUS         top

   --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         top

       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         top

       /etc/nfs.conf

SEE ALSO         top

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

AUTHOR         top

       Justin Mitchell <jumitche@redhat.com>

COLOPHON         top

       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
       ⟨http://git.linux-nfs.org/?p=steved/nfs-utils.git;a=summary⟩ on
       2018-10-29.  (At that time, the date of the most recent commit that
       was found in the repository was 2018-10-25.)  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
       man-pages@man7.org

                                 2 May 2018                       nfsconf(8)