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