4.8. named-checkconf --- named.conf syntax checker¶

4.8.1. Synopsis¶

named-checkconf [-h] [-j] [-p [-x]] [-t <directory>] [-v] [-z] [<filename>]

4.8.2. Description¶

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/loop/named.conf is read by default.

Note: files that named reads in separate parser contexts, such as rndc.key, 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.

4.8.3. Options¶

-h¶: Print the usage summary and exit.

-j¶: When loading a zonefile read the journal if it exists.

-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(2) to <directory> so that include directives in the configuration file are processed as if run by a similarly chroot(2)ed named.

-v¶: Print the program's version and exit.

-x¶: When printing the configuration files in canonical form, obscure shared secrets by replacing them with strings of question marks (?). Such configuration files can be shared in 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(5).

<filename>¶: The name of the configuration file to be checked. If not specified, it defaults to /etc/loop/named.conf.

4.8.4. Exit status¶

named-checkconf returns an exit status of 1 if errors were detected and 0 otherwise.

4.8.5. See also¶

named.conf(5), named(8), named-checkzone(1)