14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<!ENTITY mdash "—">]>
0c27b3fe77ac1d5094ba3521e8142d9e7973133fMark Andrews - Copyright (C) 2000-2002, 2004, 2005, 2007, 2009, 2014-2016 Internet Systems Consortium, Inc. ("ISC")
0c27b3fe77ac1d5094ba3521e8142d9e7973133fMark Andrews - This Source Code Form is subject to the terms of the Mozilla Public
0c27b3fe77ac1d5094ba3521e8142d9e7973133fMark Andrews - License, v. 2.0. If a copy of the MPL was not distributed with this
0c27b3fe77ac1d5094ba3521e8142d9e7973133fMark Andrews - file, You can obtain one at http://mozilla.org/MPL/2.0/.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<!-- Converted by db4-upgrade version 1.0 -->
83a28ca274521e15086fc39febde507bcc4e145eMark Andrews<refentry xmlns:db="http://docbook.org/ns/docbook" version="5.0" xml:id="man.named-checkconf">
c40265eba0c99708887d68e67901924065ba2514Brian Wellington <refentryinfo>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <corpauthor>Internet Systems Consortium, Inc.</corpauthor>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington </refentryinfo>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington <refentrytitle><application>named-checkconf</application></refentrytitle>
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein </copyright>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington <refname><application>named-checkconf</application></refname>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington <refpurpose>named configuration file syntax checking tool</refpurpose>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington </refnamediv>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington <refsynopsisdiv>
7d238ed0c71ca817fd1582295c6027c6b925af51Mark Andrews <arg choice="opt" rep="norepeat"><option>-hjvz</option></arg>
7d238ed0c71ca817fd1582295c6027c6b925af51Mark Andrews <arg choice="opt" rep="norepeat"><option>-p</option>
7d238ed0c71ca817fd1582295c6027c6b925af51Mark Andrews <arg choice="opt" rep="norepeat"><option>-x</option>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <arg choice="opt" rep="norepeat"><option>-t <replaceable class="parameter">directory</replaceable></option></arg>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington </cmdsynopsis>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington </refsynopsisdiv>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <refsection><info><title>DESCRIPTION</title></info>
85c5ed3577655f4f710f0af5ee93edd71c336055Evan Hunt checks the syntax, but not the semantics, of a
85c5ed3577655f4f710f0af5ee93edd71c336055Evan Hunt <command>named</command> configuration file. The file is parsed
85c5ed3577655f4f710f0af5ee93edd71c336055Evan Hunt and checked for syntax errors, along with all files included by it.
85c5ed3577655f4f710f0af5ee93edd71c336055Evan Hunt If no file is specified, <filename>/etc/named.conf</filename> is read
85c5ed3577655f4f710f0af5ee93edd71c336055Evan Hunt Note: files that <command>named</command> reads in separate
85c5ed3577655f4f710f0af5ee93edd71c336055Evan Hunt parser contexts, such as <filename>rndc.key</filename> and
85c5ed3577655f4f710f0af5ee93edd71c336055Evan Hunt <filename>bind.keys</filename>, are not automatically read
85c5ed3577655f4f710f0af5ee93edd71c336055Evan Hunt by <command>named-checkconf</command>. Configuration
85c5ed3577655f4f710f0af5ee93edd71c336055Evan Hunt errors in these files may cause <command>named</command> to
85c5ed3577655f4f710f0af5ee93edd71c336055Evan Hunt fail to run, even if <command>named-checkconf</command> was
85c5ed3577655f4f710f0af5ee93edd71c336055Evan Hunt successful. <command>named-checkconf</command> can be run
85c5ed3577655f4f710f0af5ee93edd71c336055Evan Hunt on these files explicitly, however.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt </refsection>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington <variablelist>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington <varlistentry>
0f8c9b5eed7e8714ceb7d6d3675555df9c5f6350Mark Andrews Print the usage summary and exit.
0f8c9b5eed7e8714ceb7d6d3675555df9c5f6350Mark Andrews </varlistentry>
0f8c9b5eed7e8714ceb7d6d3675555df9c5f6350Mark Andrews <varlistentry>
7d238ed0c71ca817fd1582295c6027c6b925af51Mark Andrews When loading a zonefile read the journal if it exists.
c40265eba0c99708887d68e67901924065ba2514Brian Wellington </varlistentry>
a26ad011f382d12058478704cb5e90e6f4366d01Andreas Gustafsson <varlistentry>
7d238ed0c71ca817fd1582295c6027c6b925af51Mark Andrews Print out the <filename>named.conf</filename> and included files
7d238ed0c71ca817fd1582295c6027c6b925af51Mark Andrews in canonical form if no errors were detected.
a26ad011f382d12058478704cb5e90e6f4366d01Andreas Gustafsson </varlistentry>
3bc4221346e5045c5679dd0d84f4f7d888a9da79Mark Andrews <varlistentry>
7d238ed0c71ca817fd1582295c6027c6b925af51Mark Andrews <term>-t <replaceable class="parameter">directory</replaceable></term>
7d238ed0c71ca817fd1582295c6027c6b925af51Mark Andrews Chroot to <filename>directory</filename> so that include
7d238ed0c71ca817fd1582295c6027c6b925af51Mark Andrews directives in the configuration file are processed as if
7d238ed0c71ca817fd1582295c6027c6b925af51Mark Andrews run by a similarly chrooted <command>named</command>.
7d238ed0c71ca817fd1582295c6027c6b925af51Mark Andrews </varlistentry>
7d238ed0c71ca817fd1582295c6027c6b925af51Mark Andrews <varlistentry>
7d238ed0c71ca817fd1582295c6027c6b925af51Mark Andrews Print the version of the <command>named-checkconf</command>
7d238ed0c71ca817fd1582295c6027c6b925af51Mark Andrews program and exit.
3bc4221346e5045c5679dd0d84f4f7d888a9da79Mark Andrews </varlistentry>
ff6de396a93b9b73a37173059a595f3d295b57cbMark Andrews <varlistentry>
ff6de396a93b9b73a37173059a595f3d295b57cbMark Andrews When printing the configuration files in canonical
ff6de396a93b9b73a37173059a595f3d295b57cbMark Andrews form, obscure shared secrets by replacing them with
ff6de396a93b9b73a37173059a595f3d295b57cbMark Andrews strings of question marks ('?'). This allows the
ff6de396a93b9b73a37173059a595f3d295b57cbMark Andrews contents of <filename>named.conf</filename> and related
ff6de396a93b9b73a37173059a595f3d295b57cbMark Andrews files to be shared — for example, when submitting
ff6de396a93b9b73a37173059a595f3d295b57cbMark Andrews bug reports — without compromising private data.
ff6de396a93b9b73a37173059a595f3d295b57cbMark Andrews This option cannot be used without <option>-p</option>.
ff6de396a93b9b73a37173059a595f3d295b57cbMark Andrews </varlistentry>
92551304a9abff9284de5b79a48e83d781989339Mark Andrews <varlistentry>
561a29af8c54a216e7d30b5b4f6e0d21661654ecMark Andrews Perform a test load of all master zones found in
92551304a9abff9284de5b79a48e83d781989339Mark Andrews </varlistentry>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington <varlistentry>
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein The name of the configuration file to be checked. If not
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein specified, it defaults to <filename>/etc/named.conf</filename>.
c40265eba0c99708887d68e67901924065ba2514Brian Wellington </varlistentry>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington </variablelist>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt </refsection>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <refsection><info><title>RETURN VALUES</title></info>
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein returns an exit status of 1 if
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein errors were detected and 0 otherwise.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt </refsection>
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein <refentrytitle>named</refentrytitle><manvolnum>8</manvolnum>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington </citerefentry>,
6043e41fcf5dc91aa8a981c966512d73bdec31c1Mark Andrews <citerefentry>
6043e41fcf5dc91aa8a981c966512d73bdec31c1Mark Andrews <refentrytitle>named-checkzone</refentrytitle><manvolnum>8</manvolnum>
6043e41fcf5dc91aa8a981c966512d73bdec31c1Mark Andrews </citerefentry>,
c40265eba0c99708887d68e67901924065ba2514Brian Wellington <citetitle>BIND 9 Administrator Reference Manual</citetitle>.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt </refsection>