named-checkconf.docbook revision 3bc4221346e5045c5679dd0d84f4f7d888a9da79
4a589644c0b4ea2684514116fbbad30d79536f8aMatt Sweeney<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
4a589644c0b4ea2684514116fbbad30d79536f8aMatt Sweeney "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
4a589644c0b4ea2684514116fbbad30d79536f8aMatt Sweeney [<!ENTITY mdash "—">]>
4a589644c0b4ea2684514116fbbad30d79536f8aMatt Sweeney - Copyright (C) 2004, 2005, 2007 Internet Systems Consortium, Inc. ("ISC")
f01d121976553130cab6089d35c71d5b947d1204Matt Sweeney - Copyright (C) 2000-2002 Internet Software Consortium.
4a589644c0b4ea2684514116fbbad30d79536f8aMatt Sweeney - Permission to use, copy, modify, and/or distribute this software for any
4a589644c0b4ea2684514116fbbad30d79536f8aMatt Sweeney - purpose with or without fee is hereby granted, provided that the above
4a589644c0b4ea2684514116fbbad30d79536f8aMatt Sweeney - copyright notice and this permission notice appear in all copies.
4a589644c0b4ea2684514116fbbad30d79536f8aMatt Sweeney - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
4a589644c0b4ea2684514116fbbad30d79536f8aMatt Sweeney - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
4a589644c0b4ea2684514116fbbad30d79536f8aMatt Sweeney - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
4a589644c0b4ea2684514116fbbad30d79536f8aMatt Sweeney - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
4a589644c0b4ea2684514116fbbad30d79536f8aMatt Sweeney - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
4a589644c0b4ea2684514116fbbad30d79536f8aMatt Sweeney - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
4a589644c0b4ea2684514116fbbad30d79536f8aMatt Sweeney - PERFORMANCE OF THIS SOFTWARE.
4a589644c0b4ea2684514116fbbad30d79536f8aMatt Sweeney<!-- $Id: named-checkconf.docbook,v 1.20 2009/07/13 06:57:21 marka Exp $ -->
4a589644c0b4ea2684514116fbbad30d79536f8aMatt Sweeney <refentryinfo>
4a589644c0b4ea2684514116fbbad30d79536f8aMatt Sweeney </refentryinfo>
4a589644c0b4ea2684514116fbbad30d79536f8aMatt Sweeney <refentrytitle><application>named-checkconf</application></refentrytitle>
f01d121976553130cab6089d35c71d5b947d1204Matt Sweeney <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
49b2441cfaf50222c256670b81ff734d8be3f9a4Matt Sweeney </copyright>
49b2441cfaf50222c256670b81ff734d8be3f9a4Matt Sweeney </copyright>
49b2441cfaf50222c256670b81ff734d8be3f9a4Matt Sweeney <refnamediv>
49b2441cfaf50222c256670b81ff734d8be3f9a4Matt Sweeney <refname><application>named-checkconf</application></refname>
49b2441cfaf50222c256670b81ff734d8be3f9a4Matt Sweeney <refpurpose>named configuration file syntax checking tool</refpurpose>
49b2441cfaf50222c256670b81ff734d8be3f9a4Matt Sweeney </refnamediv>
49b2441cfaf50222c256670b81ff734d8be3f9a4Matt Sweeney <refsynopsisdiv>
49b2441cfaf50222c256670b81ff734d8be3f9a4Matt Sweeney <cmdsynopsis>
49b2441cfaf50222c256670b81ff734d8be3f9a4Matt Sweeney <arg><option>-t <replaceable class="parameter">directory</replaceable></option></arg>
49b2441cfaf50222c256670b81ff734d8be3f9a4Matt Sweeney </cmdsynopsis>
49b2441cfaf50222c256670b81ff734d8be3f9a4Matt Sweeney </refsynopsisdiv>
f01d121976553130cab6089d35c71d5b947d1204Matt Sweeney checks the syntax, but not the semantics, of a named
f01d121976553130cab6089d35c71d5b947d1204Matt Sweeney configuration file.
f01d121976553130cab6089d35c71d5b947d1204Matt Sweeney <variablelist>
f01d121976553130cab6089d35c71d5b947d1204Matt Sweeney <varlistentry>
49b2441cfaf50222c256670b81ff734d8be3f9a4Matt Sweeney Print the usage summary and exit.
49b2441cfaf50222c256670b81ff734d8be3f9a4Matt Sweeney </varlistentry>
49b2441cfaf50222c256670b81ff734d8be3f9a4Matt Sweeney <varlistentry>
49b2441cfaf50222c256670b81ff734d8be3f9a4Matt Sweeney <term>-t <replaceable class="parameter">directory</replaceable></term>
49b2441cfaf50222c256670b81ff734d8be3f9a4Matt Sweeney Chroot to <filename>directory</filename> so that include
49b2441cfaf50222c256670b81ff734d8be3f9a4Matt Sweeney directives in the configuration file are processed as if
49b2441cfaf50222c256670b81ff734d8be3f9a4Matt Sweeney run by a similarly chrooted named.
49b2441cfaf50222c256670b81ff734d8be3f9a4Matt Sweeney </varlistentry>
49b2441cfaf50222c256670b81ff734d8be3f9a4Matt Sweeney <varlistentry>
49b2441cfaf50222c256670b81ff734d8be3f9a4Matt Sweeney Print the version of the <command>named-checkconf</command>
49b2441cfaf50222c256670b81ff734d8be3f9a4Matt Sweeney program and exit.
49b2441cfaf50222c256670b81ff734d8be3f9a4Matt Sweeney </varlistentry>
49b2441cfaf50222c256670b81ff734d8be3f9a4Matt Sweeney <varlistentry>
49b2441cfaf50222c256670b81ff734d8be3f9a4Matt Sweeney Print out the <filename>named.conf</filename> and included files
49b2441cfaf50222c256670b81ff734d8be3f9a4Matt Sweeney in canonical form if no errors were detected.
49b2441cfaf50222c256670b81ff734d8be3f9a4Matt Sweeney </varlistentry>
49b2441cfaf50222c256670b81ff734d8be3f9a4Matt Sweeney <varlistentry>
49b2441cfaf50222c256670b81ff734d8be3f9a4Matt Sweeney Perform a test load of all master zones found in
49b2441cfaf50222c256670b81ff734d8be3f9a4Matt Sweeney </varlistentry>
49b2441cfaf50222c256670b81ff734d8be3f9a4Matt Sweeney <varlistentry>
49b2441cfaf50222c256670b81ff734d8be3f9a4Matt Sweeney When loading a zonefile read the journal if it exists.
49b2441cfaf50222c256670b81ff734d8be3f9a4Matt Sweeney </varlistentry>
49b2441cfaf50222c256670b81ff734d8be3f9a4Matt Sweeney <varlistentry>
49b2441cfaf50222c256670b81ff734d8be3f9a4Matt Sweeney The name of the configuration file to be checked. If not
bf3c648d6ab588c8b04fb824a7281898c469bd67Matt Sweeney specified, it defaults to <filename>/etc/named.conf</filename>.
bf3c648d6ab588c8b04fb824a7281898c469bd67Matt Sweeney </varlistentry>
bf3c648d6ab588c8b04fb824a7281898c469bd67Matt Sweeney </variablelist>
bf3c648d6ab588c8b04fb824a7281898c469bd67Matt Sweeney returns an exit status of 1 if
bf3c648d6ab588c8b04fb824a7281898c469bd67Matt Sweeney errors were detected and 0 otherwise.
49b2441cfaf50222c256670b81ff734d8be3f9a4Matt Sweeney <refentrytitle>named</refentrytitle><manvolnum>8</manvolnum>
49b2441cfaf50222c256670b81ff734d8be3f9a4Matt Sweeney </citerefentry>,
49b2441cfaf50222c256670b81ff734d8be3f9a4Matt Sweeney <citerefentry>
49b2441cfaf50222c256670b81ff734d8be3f9a4Matt Sweeney <refentrytitle>named-checkzone</refentrytitle><manvolnum>8</manvolnum>
49b2441cfaf50222c256670b81ff734d8be3f9a4Matt Sweeney </citerefentry>,
49b2441cfaf50222c256670b81ff734d8be3f9a4Matt Sweeney <citetitle>BIND 9 Administrator Reference Manual</citetitle>.
4a589644c0b4ea2684514116fbbad30d79536f8aMatt Sweeney <para><corpauthor>Internet Systems Consortium</corpauthor>
4a589644c0b4ea2684514116fbbad30d79536f8aMatt Sweeney - Local variables:
4a589644c0b4ea2684514116fbbad30d79536f8aMatt Sweeney - mode: sgml