named-checkzone.docbook revision e9359db5e958bf05f9b9c5fe3c27d533f0f05550
d6fa26d0adaec6c910115be34fe7a5a5f402c14fMark Andrews<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson<!--
5347c0fcb04eaea19d9f39795646239f487c6207Tinderbox User - Copyright (C) 2001 Internet Software Consortium.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein -
5347c0fcb04eaea19d9f39795646239f487c6207Tinderbox User - Permission to use, copy, modify, and distribute this software for any
5347c0fcb04eaea19d9f39795646239f487c6207Tinderbox User - purpose with or without fee is hereby granted, provided that the above
5347c0fcb04eaea19d9f39795646239f487c6207Tinderbox User - copyright notice and this permission notice appear in all copies.
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson -
d6fa26d0adaec6c910115be34fe7a5a5f402c14fMark Andrews - THE SOFTWARE IS PROVIDED "AS IS" AND INTERNET SOFTWARE CONSORTIUM
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - INTERNET SOFTWARE CONSORTIUM BE LIABLE FOR ANY SPECIAL, DIRECT,
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User - NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User - WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User-->
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<!-- $Id: named-checkzone.docbook,v 1.6 2002/07/11 04:49:27 marka Exp $ -->
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<refentry>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <refentryinfo>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <date>June 13, 2000</date>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User </refentryinfo>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <refmeta>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <refentrytitle><application>named-checkzone</application></refentrytitle>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <manvolnum>8</manvolnum>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <refmiscinfo>BIND9</refmiscinfo>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User </refmeta>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <refnamediv>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <refname><application>named-checkzone</application></refname>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <refpurpose>zone file validity checking tool</refpurpose>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User </refnamediv>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <refsynopsisdiv>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <cmdsynopsis>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <command>named-checkzone</command>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <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>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User <arg><option>-c <replaceable class="parameter">class</replaceable></option></arg>
e21a2904f02a03fa06b6db04d348f65fe9c67b2bMark Andrews <arg><option>-t <replaceable class="parameter">directory</replaceable></option></arg>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User <arg><option>-w <replaceable class="parameter">directory</replaceable></option></arg>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <arg choice="req">zonename</arg>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <arg choice="req">filename</arg>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </cmdsynopsis>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </refsynopsisdiv>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User
e21a2904f02a03fa06b6db04d348f65fe9c67b2bMark Andrews <refsect1>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User <title>DESCRIPTION</title>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <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
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User files before configuring them into a name server.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </refsect1>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User <refsect1>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <title>OPTIONS</title>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User <variablelist>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <term>-d</term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Enable debugging.
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User </para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <term>-q</term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <listitem>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User <para>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User Quiet mode - exit code only.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </varlistentry>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User
e21a2904f02a03fa06b6db04d348f65fe9c67b2bMark Andrews <varlistentry>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User <term>-v</term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <listitem>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <para>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User Print the version of the <command>named-checkzone</command>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User program and exit.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User </para>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User </listitem>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User </varlistentry>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <term>-j</term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein When loading the zone file read the journal if it exists.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User </para>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User </listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <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.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User </para>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User </listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <term>-t <replaceable class="parameter">directory</replaceable></term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein chroot to <filename>directory</filename> so that include
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User directives in the configuration file are processed as if
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User run by a similarly chrooted named.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <term>-w <replaceable class="parameter">directory</replaceable></term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <para>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User chdir to <filename>directory</filename> so that relative
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User filenames in master file $INCLUDE directives work. This
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User is similar to the directory clause in
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <filename>named.conf</filename>.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User </para>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User </listitem>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <term>zonename</term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein The domain name of the zone being checked.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </listitem>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User </varlistentry>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User
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>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User </listitem>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User </varlistentry>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User </variablelist>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User </refsect1>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <refsect1>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <title>RETURN VALUES</title>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <command>named-checkzone</command> returns an exit status of 1 if
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User errors were detected and 0 otherwise.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User </refsect1>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <refsect1>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <title>SEE ALSO</title>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <para>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <citerefentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <refentrytitle>named</refentrytitle>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <manvolnum>8</manvolnum>
</citerefentry>,
<citetitle>RFC 1035</citetitle>,
<citetitle>BIND 9 Administrator Reference Manual</citetitle>.
</para>
</refsect1>
<refsect1>
<title>AUTHOR</title>
<para>
<corpauthor>Internet Software Consortium</corpauthor>
</para>
</refsect1>
</refentry>
<!--
- Local variables:
- mode: sgml
- End:
-->