named-checkconf
Prev | Manual pages | Next

## Name

named-checkconf — named configuration file syntax checking tool

## Synopsis

`named-checkconf` [`-h`] [`-v`] [`-j`] [`-t `directory``] {filename} [`-p`] [`-x`] [`-z`]

## 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/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.

## OPTIONS

-h

  Print the usage summary and exit.

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

-p

  Print out the `named.conf` and included files in canonical form if no errors were detected.

-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`.

-j

  When loading a zonefile read the journal if it exists.

filename

  The name of the configuration file to be checked. If not specified, it defaults to `/etc/named.conf`.

## RETURN VALUES

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

## SEE ALSO

named(8), named-checkzone(8), BIND 9 Administrator Reference Manual.

## AUTHOR

Internet Systems Consortium

Prev | Up | Next
dnssec-verify | Home | named-checkzone