nfsconf

Section: Maintenance Commands (8)
Updated: 2 May 2018
Page Index
 

NAME

nfsconf - Query various NFS configuration settings  

SYNOPSIS

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] [-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.
-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 --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>


 

Index

NAME
SYNOPSIS
DESCRIPTION
Modes
OPTIONS
Options valid in all modes
Options only valid in --get and --isset modes.
Options only valid in --set mode.
EXIT STATUS
--isset mode
all other modes
EXAMPLES
FILES
SEE ALSO
AUTHOR