named-checkconf - named configuration file syntax checking tool
named-checkconf [-chjlvz]
[-p [-x ]]
[-t directory] {filename}
named-checkconf checks the syntax, but not the semantics, of a
named configuration file. The file is parsed and checked for syntax
errors, along with all files included by it. If no file is specified,
/etc/named.conf is read by default.
Note: files that named reads in separate parser contexts,
such as rndc.key and bind.keys, are not automatically read by
named-checkconf. Configuration errors in these files may cause
named to fail to run, even if named-checkconf was successful.
named-checkconf can be run on these files explicitly, however.
-h
Print the usage summary and exit.
-j
When loading a zonefile read the journal if it
exists.
-l
List all the configured zones. Each line of output
contains the zone name, class (e.g. IN), view, and type (e.g. master or
slave).
-c
Check "core" configuration only. This
suppresses the loading of plugin modules, and causes all parameters to
plugin statements to be ignored.
-p
Print out the named.conf and included files in canonical
form if no errors were detected. See also the -x option.
-t directory
Chroot to directory so that include directives in the
configuration file are processed as if run by a similarly chrooted
named.
-v
Print the version of the named-checkconf program
and exit.
-x
When printing the configuration files in canonical form,
obscure shared secrets by replacing them with strings of question marks ('?').
This allows the contents of named.conf and related files to be shared —
for example, when submitting bug reports — without compromising private
data. This option cannot be used without -p.
-z
Perform a test load of all master zones found in
named.conf.
filename
The name of the configuration file to be checked. If not
specified, it defaults to /etc/named.conf.
named-checkconf returns an exit status of 1 if errors were detected and 0
otherwise.
named(8), named-checkzone(8), BIND 9 Administrator Reference
Manual.
Internet Systems Consortium, Inc.
Copyright © 2000-2002, 2004, 2005, 2007, 2009, 2014-2016, 2018, 2019
Internet Systems Consortium, Inc. ("ISC")