# nfsconf

## 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**
    


* * *