Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

nsd-checkconf(8) [freebsd man page]

nsd-checkconf(8)						    nsd 3.2.12							  nsd-checkconf(8)

nsd-checkconf - NSD configuration file checker. SYNOPSIS
nsd-checkconf [-v] [-h] [-o option] [-z zonename] [-s keyname] configfile DESCRIPTION
nsd-checkconf reads a configuration file. It prints parse errors to standard error, and performs additional checks on the contents. The configfile format is described in nsd.conf(5). The utility of this program is to check a config file for errors before using it in nsd(8) or zonec(8). This program can also be used for shell scripts to access the nsd config file, using the -o and -z options. OPTIONS
-v After reading print the options to standard output in configfile format. Without this option, only success or parse errors are reported. -h Print usage help information and exit. -o option Return only this option from the config file. This option can to be used in conjunction with the -z option. The special value zones prints out a list of configured zones. This option is primarily used by nsdc to parse the config file from the shell. If the -z option is given, but the -o option is not given, nothing is printed. -s keyname Prints the key secret (base64 blob) configured for this key in the config file. Used to help shell scripts parse the config file. -z zonename Return the option specified with -o for zone 'zonename'. If this option is not given, the server section of the config file is used. This option is primarily used by nsdc to parse the con- fig file from the shell. The -o, -s and -z option print configfile options to standard output. FILES
/etc/nsd3/nsd.conf default NSD configuration file SEE ALSO
nsd(8), nsdc(8), nsd.conf(5), nsd-notify(8), nsd-patch(8), nsd-xfer(8), zonec(8) AUTHORS
NSD was written by NLnet Labs and RIPE NCC joint team. Please see CREDITS file in the distribution for further details. NLnet Labs jul 19, 2012 nsd-checkconf(8)

Check Out this Related Man Page

NSDC(8)                                                             NSDC 3.2.12                                                            NSDC(8)

nsdc - Name Server Daemon (NSD) control script. SYNOPSIS
nsdc [-c configfile] start | stop | reload | rebuild | restart | running | update | notify | patch DESCRIPTION
Nsdc is the shell script that used to control nsd(8) and zonec(8) from NSD distribution. Nsdc is also suitable to be linked into /etc/rc.d directory on BSD like systems for automatic startup of nsd(8) at boot time. At every invokation, nsdc will try to read the nsd.conf(5) configuration file. An example of such configuration file is distributed with the NSD package as nsd.conf.sample. The config file is checked for errors before it is used, see nsd-checkconf(8). Possible nsdc applications are: start Start nsd(8). stop Shut down nsd(8) by sending SIGTERM to it. reload Initiate nsd(8) name space database reload by sending SIGHUP. rebuild Rebuild the nsd(8) database by invoking zonec(8) with appropriate arguments. restart Restart nsd(8). This equals to nsdc stop && nsdc start. running Check whether nsd(8) is running. Returns error message and error code if it is not running, and no message and zero error code oth- erwise. update Updates all the slave zones which have allow-notify: from localhost ( or ::1) allowed. If a TSIG key is specified for the allow-notify statement in the config file, it will be used to secure the notify. Note that NSD keeps track of zone timeouts automat- ically, this is only needed if you want to manually force updates by sending notify messages to the localhost. Another method you can use is to stop nsd, delete the xfrd.state file and then start nsd again. It will try to update all zones. This method does not require allow-notify: statements. notify Sends notify messages to all the slaves for all the zones that have the notify: keyword in the nsd.conf file. If a TSIG key is spec- ified for a notify statement, it will be used to secure the notification message to that slave server. patch Merge zone transfer changes back to zone files. It reads in the nsd database (nsd.db) and difffile (ixfr.db), and overwrites the zone text files if they have been updated. Running this regularly ensures that the difffile does not grow infinitely. If any zone text files have been changed (including those of the master zones), the nsd.db is rebuild and nsd is reloaded. OPTIONS
-c configfile Specify configfile to use instead of the default /etc/nsd3/nsd.conf. FILES
/etc/nsd3/nsd.conf Configuration file for nsd to change default pathnames and NSD flags. The zone names, pathnames to zone files and access control lists are also in nsd.conf(5). /var/lib/nsd3/nsd.db default NSD database /var/lib/nsd3/nsd.db.lock Lockfile for the NSD database access by operator tools. /var/lib/nsd3/ixfr.db Journal of zone transfers, the diff file containing the new zone contents transferred. /var/lib/nsd3/xfrd.state State for the zone transfer process of NSD. Contains timeouts for the zones and whether zones are expired. /var/run/nsd3/ the process id of the name server. DIAGNOSTICS
Nsdc will return zero return code if operation was successful and an error message to standard output plus a non-zero return code other- wise. SEE ALSO
nsd(8), nsd.conf(5), nsd-checkconf(8), nsd-notify(8), nsd-patch(8), nsd-xfer(8), zonec(8) AUTHORS
NSD was written by NLnet Labs and RIPE NCC joint team. Please see CREDITS file in the distribution for further details. BUGS
Syntax checking of the config file is rudimentary and error messages may be wrong. If you do a nsdc patch, whilst a (long) zone transfer is busy, the zone transfer contents will be partially lost. After a reload, this will be detected and the zone transfer should be restarted. The reload that happens at the end of nsdc patch also frees up memory churn in NSD caused by zone transfers. NLnet Labs jul 19, 2012 NSDC(8)
Man Page