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