named-checkzone.docbook revision 2f4ffd7f5594c0464f2a872aee5ef102f6f7b10f
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin - Copyright (C) 2004, 2005 Internet Systems Consortium, Inc. ("ISC")
3e14f97f673e8a630f076077de35afdd43dc1587Roger A. Faulkner - Copyright (C) 2001, 2002 Internet Software Consortium.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin - Permission to use, copy, modify, and distribute this software for any
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin - purpose with or without fee is hereby granted, provided that the above
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin - copyright notice and this permission notice appear in all copies.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin - PERFORMANCE OF THIS SOFTWARE.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin<!-- $Id: named-checkzone.docbook,v 1.14 2005/01/10 23:43:12 marka Exp $ -->
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <refentryinfo>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin </refentryinfo>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <refentrytitle><application>named-checkzone</application></refentrytitle>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin </refmeta>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <refnamediv>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <refname><application>named-checkzone</application></refname>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <refpurpose>zone file validity checking tool</refpurpose>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin </refnamediv>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <refsynopsisdiv>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <cmdsynopsis>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <arg><option>-c <replaceable class="parameter">class</replaceable></option></arg>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <arg><option>-k <replaceable class="parameter">mode</replaceable></option></arg>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <arg><option>-n <replaceable class="parameter">mode</replaceable></option></arg>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <arg><option>-o <replaceable class="parameter">filename</replaceable></option></arg>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <arg><option>-t <replaceable class="parameter">directory</replaceable></option></arg>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <arg><option>-w <replaceable class="parameter">directory</replaceable></option></arg>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <arg><option>-W <replaceable class="parameter">mode</replaceable></option></arg>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin </cmdsynopsis>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin </refsynopsisdiv>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <refsect1>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <command>named-checkzone</command> checks the syntax and integrity of
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin a zone file. It performs the same checks as <command>named</command>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin does when loading a zone. This makes
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <command>named-checkzone</command> useful for checking zone
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin files before configuring them into a name server.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin </refsect1>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <refsect1>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <variablelist>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <varlistentry>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <listitem>
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin Enable debugging.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin </listitem>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin </varlistentry>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <varlistentry>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <listitem>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin Quiet mode - exit code only.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin </listitem>
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz </varlistentry>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <varlistentry>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <listitem>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin Print the version of the <command>named-checkzone</command>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin program and exit.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin </listitem>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin </varlistentry>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <varlistentry>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <listitem>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin When loading the zone file read the journal if it exists.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin </listitem>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <varlistentry>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <term>-c <replaceable class="parameter">class</replaceable></term>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <listitem>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin Specify the class of the zone. If not specified "IN" is assumed.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin </listitem>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin </varlistentry>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <varlistentry>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <term>-k <replaceable class="parameter">mode</replaceable></term>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <listitem>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin Perform <command>"check-name"</command> checks with the specified failure mode.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin </listitem>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin </varlistentry>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <varlistentry>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <term>-n <replaceable class="parameter">mode</replaceable></term>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <listitem>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin Specify whether NS records should be checked to see if they
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin are addresses. Possible modes are <command>"fail"</command>,
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin </listitem>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin </varlistentry>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <varlistentry>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <term>-o <replaceable class="parameter">filename</replaceable></term>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <listitem>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin </listitem>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin </varlistentry>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <varlistentry>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <term>-t <replaceable class="parameter">directory</replaceable></term>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <listitem>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin chroot to <filename>directory</filename> so that include
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin directives in the configuration file are processed as if
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin run by a similarly chrooted named.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin </listitem>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin </varlistentry>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <varlistentry>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <term>-w <replaceable class="parameter">directory</replaceable></term>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <listitem>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin chdir to <filename>directory</filename> so that relative
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin filenames in master file $INCLUDE directives work. This
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin is similar to the directory clause in
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin </listitem>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin </varlistentry>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <varlistentry>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <listitem>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin Dump zone file in canonical format.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin </listitem>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin </varlistentry>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <varlistentry>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <term>-W <replaceable class="parameter">mode</replaceable></term>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin <listitem>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin Specify whether to check for non-terminal wildcards.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin Non-terminal wildcards are almost always the result of a
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin failure to understand the wildcard matching algorithm (RFC 1034).
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin Possible modes are <command>"warn"</command> (default) and
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin </listitem>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin </varlistentry>
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin <varlistentry>
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin The domain name of the zone being checked.
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin </varlistentry>
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin <varlistentry>
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin The name of the zone file.
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin </varlistentry>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin </variablelist>
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin <command>named-checkzone</command> returns an exit status of 1 if
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin errors were detected and 0 otherwise.
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin <citerefentry>
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin </citerefentry>,
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin <citetitle>BIND 9 Administrator Reference Manual</citetitle>.
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin <corpauthor>Internet Systems Consortium</corpauthor>
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin - Local variables:
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin - mode: sgml