named-checkzone.docbook revision 4d9f3f00d93fcb8743b1105e8cf82e862be220d1
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
bec154197d3d640b0d5b416cd5218ea58dca5d3aTinderbox User<!--
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews - Copyright (C) 2001 Internet Software Consortium.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews -
4a14ce5ba00ab7bc55c99ffdcf59c7a4ab902721Automatic Updater - Permission to use, copy, modify, and distribute this software for any
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews - purpose with or without fee is hereby granted, provided that the above
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews - copyright notice and this permission notice appear in all copies.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews -
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews - THE SOFTWARE IS PROVIDED "AS IS" AND INTERNET SOFTWARE CONSORTIUM
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews - DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews - IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews - INTERNET SOFTWARE CONSORTIUM BE LIABLE FOR ANY SPECIAL, DIRECT,
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews - FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews - NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews - WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
ea94d370123a5892f6c47a97f21d1b28d44bb168Tinderbox User-->
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<!-- $Id: named-checkzone.docbook,v 1.8 2002/07/19 02:34:58 marka Exp $ -->
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<refentry>
e21a2904f02a03fa06b6db04d348f65fe9c67b2bMark Andrews <refentryinfo>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <date>June 13, 2000</date>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </refentryinfo>
0c6ada0a814f3c5417daa1654129bc2af56ed504Automatic Updater
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <refmeta>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <refentrytitle><application>named-checkzone</application></refentrytitle>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <manvolnum>8</manvolnum>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <refmiscinfo>BIND9</refmiscinfo>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </refmeta>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <refnamediv>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <refname><application>named-checkzone</application></refname>
0c6ada0a814f3c5417daa1654129bc2af56ed504Automatic Updater <refpurpose>zone file validity checking tool</refpurpose>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </refnamediv>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <refsynopsisdiv>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <cmdsynopsis>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <command>named-checkzone</command>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <arg><option>-d</option></arg>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <arg><option>-j</option></arg>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <arg><option>-q</option></arg>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <arg><option>-v</option></arg>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <arg><option>-c <replaceable class="parameter">class</replaceable></option></arg>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <arg><option>-n <replaceable class="parameter">mode</replaceable></option></arg>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <arg><option>-t <replaceable class="parameter">directory</replaceable></option></arg>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <arg><option>-w <replaceable class="parameter">directory</replaceable></option></arg>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <arg choice="req">zonename</arg>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <arg choice="req">filename</arg>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </cmdsynopsis>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </refsynopsisdiv>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews
ccee3948124ab4c8bc3afa4369177913edb1fca2Tinderbox User <refsect1>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <title>DESCRIPTION</title>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <para>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <command>named-checkzone</command> checks the syntax and integrity of
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews a zone file. It performs the same checks as <command>named</command>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews does when loading a zone. This makes
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <command>named-checkzone</command> useful for checking zone
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews files before configuring them into a name server.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </para>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </refsect1>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews
b2f07642fd712c8fda81a116bcdde229ab291f33Tinderbox User <refsect1>
b2f07642fd712c8fda81a116bcdde229ab291f33Tinderbox User <title>OPTIONS</title>
b2f07642fd712c8fda81a116bcdde229ab291f33Tinderbox User
c247e3f281613fabe1af362e9f3157e35ebbe52cMark Andrews <variablelist>
b2f07642fd712c8fda81a116bcdde229ab291f33Tinderbox User <varlistentry>
b2f07642fd712c8fda81a116bcdde229ab291f33Tinderbox User <term>-d</term>
b2f07642fd712c8fda81a116bcdde229ab291f33Tinderbox User <listitem>
b2f07642fd712c8fda81a116bcdde229ab291f33Tinderbox User <para>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews Enable debugging.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </para>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </listitem>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </varlistentry>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <varlistentry>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <term>-q</term>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <listitem>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <para>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews Quiet mode - exit code only.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </para>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </listitem>
ccee3948124ab4c8bc3afa4369177913edb1fca2Tinderbox User </varlistentry>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <varlistentry>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <term>-v</term>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <listitem>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <para>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews Print the version of the <command>named-checkzone</command>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews program and exit.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </para>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </listitem>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </varlistentry>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <varlistentry>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <term>-j</term>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <listitem>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <para>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews When loading the zone file read the journal if it exists.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </para>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </listitem>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <varlistentry>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <term>-c <replaceable class="parameter">class</replaceable></term>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <listitem>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <para>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews Specify the class of the zone. If not specified "IN" is assumed.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </para>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </listitem>
1224c3b69b3d18f7127aa042644936af25a2d679Mark Andrews </varlistentry>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews
1224c3b69b3d18f7127aa042644936af25a2d679Mark Andrews <varlistentry>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <term>-n <replaceable class="parameter">mode</replaceable></term>
1224c3b69b3d18f7127aa042644936af25a2d679Mark Andrews <listitem>
b2f07642fd712c8fda81a116bcdde229ab291f33Tinderbox User <para>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews Specify whether NS records should be checked to see if they
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews are addresses. Possible modes are <command>"fail"</command>,
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <command>"warn"</command> (default) and
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <command>"ignore"</command>.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </para>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </listitem>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </varlistentry>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <varlistentry>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <term>-t <replaceable class="parameter">directory</replaceable></term>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <listitem>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <para>
c247e3f281613fabe1af362e9f3157e35ebbe52cMark Andrews chroot to <filename>directory</filename> so that include
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews directives in the configuration file are processed as if
c247e3f281613fabe1af362e9f3157e35ebbe52cMark Andrews run by a similarly chrooted named.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </para>
c247e3f281613fabe1af362e9f3157e35ebbe52cMark Andrews </listitem>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </varlistentry>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <varlistentry>
c247e3f281613fabe1af362e9f3157e35ebbe52cMark Andrews <term>-w <replaceable class="parameter">directory</replaceable></term>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <listitem>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <para>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews chdir to <filename>directory</filename> so that relative
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews filenames in master file $INCLUDE directives work. This
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews is similar to the directory clause in
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <filename>named.conf</filename>.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </para>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </listitem>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </varlistentry>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User <varlistentry>
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User <term>zonename</term>
ccee3948124ab4c8bc3afa4369177913edb1fca2Tinderbox User <listitem>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <para>
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User The domain name of the zone being checked.
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User </para>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </listitem>
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User </varlistentry>
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User <varlistentry>
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User <term>filename</term>
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User <listitem>
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User <para>
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User The name of the zone file.
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User </para>
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User </listitem>
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User </varlistentry>
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User </variablelist>
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User </refsect1>
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User <refsect1>
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User <title>RETURN VALUES</title>
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User <para>
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User <command>named-checkzone</command> returns an exit status of 1 if
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User errors were detected and 0 otherwise.
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User </refsect1>
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User <refsect1>
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User <title>SEE ALSO</title>
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User <para>
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User <citerefentry>
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User <refentrytitle>named</refentrytitle>
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User <manvolnum>8</manvolnum>
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User </citerefentry>,
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User <citetitle>RFC 1035</citetitle>,
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User <citetitle>BIND 9 Administrator Reference Manual</citetitle>.
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User </para>
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User </refsect1>
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User <refsect1>
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User <title>AUTHOR</title>
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User <para>
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User <corpauthor>Internet Software Consortium</corpauthor>
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User </para>
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User </refsect1>
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User</refentry>
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User<!--
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User - Local variables:
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User - mode: sgml
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User - End:
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User-->
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User