---
name: "named-checkconf"
section: "8"
platform: "linux"
package: "bind9-utils"
version: "1:9.16.50-1~deb11u2"
release: "Debian 11 (Bullseye)"
platforms: ["linux", "macos"]
url: "https://new.carta.tech/named-checkconf/8"
---

# named-checkconf(8)

named configuration file syntax checking tool

## NAME

named-checkconf - named configuration file syntax checking tool

## SYNOPSIS

**named-checkconf** \[**-chjlvz**\] \[**-p** \[**-x** \]\] \[**-t** directory\] {filename}

## DESCRIPTION

**named-checkconf** checks the syntax, but not the semantics, of a **named** configuration file. The file, along with all files included by it, is parsed and checked for syntax errors. 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. However, **named-checkconf** can be run on these files explicitly.

## OPTIONS

- **-h**

  This option prints the usage summary and exits.

- **-j**

  When loading a zonefile, this option instructs **named** to read the journal if it exists.

- **-l**

  This option lists all the configured zones. Each line of output contains the zone name, class (e.g. IN), view, and type (e.g. primary or secondary).

- **-c**

  This option specifies that only the "core" configuration should be checked. This suppresses the loading of plugin modules, and causes all parameters to **plugin** statements to be ignored.

- **-i**

  This option ignores warnings on deprecated options.

- **-p**

  This option prints out the **named.conf** and included files in canonical form if no errors were detected. See also the **-x** option.

- **-t directory**

  This option instructs **named** to chroot to **directory**, so that **include** directives in the configuration file are processed as if run by a similarly chrooted **named**.

- **-v**

  This option prints the version of the **named-checkconf** program and exits.

- **-x**

  When printing the configuration files in canonical form, this option obscures 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**

  This option performs a test load of all zones of type **primary** found in **named.conf**.

- **filename**

  This indicates 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/8.md)**, **[named-checkzone(8)](/named-checkzone/8.md)**, BIND 9 Administrator Reference Manual.

## AUTHOR

Internet Systems Consortium

## COPYRIGHT

2024, Internet Systems Consortium