named-checkzone.docbook revision f5d30e2864e048a42c4dc1134993ae7efdb5d6c3
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.0//EN"
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein "http://www.oasis-open.org/docbook/xml/4.0/docbookx.dtd"
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein [<!ENTITY mdash "—">]>
2f4ffd7f5594c0464f2a872aee5ef102f6f7b10fMark Andrews - Copyright (C) 2004, 2005 Internet Systems Consortium, Inc. ("ISC")
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews - Copyright (C) 2000-2002 Internet Software Consortium.
d4ef65050feac78554addf6e16a06c6e2e0bd331Brian Wellington - Permission to use, copy, modify, and distribute this software for any
d4ef65050feac78554addf6e16a06c6e2e0bd331Brian Wellington - purpose with or without fee is hereby granted, provided that the above
d4ef65050feac78554addf6e16a06c6e2e0bd331Brian Wellington - copyright notice and this permission notice appear in all copies.
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews - PERFORMANCE OF THIS SOFTWARE.
f5d30e2864e048a42c4dc1134993ae7efdb5d6c3Mark Andrews<!-- $Id: named-checkzone.docbook,v 1.18 2005/05/13 01:35:38 marka Exp $ -->
c40265eba0c99708887d68e67901924065ba2514Brian Wellington <refentryinfo>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington </refentryinfo>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington <refentrytitle><application>named-checkzone</application></refentrytitle>
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein </copyright>
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein </copyright>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington <refname><application>named-checkzone</application></refname>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington <refpurpose>zone file validity checking tool</refpurpose>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington </refnamediv>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington <refsynopsisdiv>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington <cmdsynopsis>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington <arg><option>-c <replaceable class="parameter">class</replaceable></option></arg>
2047977ce2dfcfe3a0fa2d638c3242841310fad3Mark Andrews <arg><option>-k <replaceable class="parameter">mode</replaceable></option></arg>
4d9f3f00d93fcb8743b1105e8cf82e862be220d1Mark Andrews <arg><option>-n <replaceable class="parameter">mode</replaceable></option></arg>
d0aebc5a55b6145297d94f8aee939852357c59fcMark Andrews <arg><option>-o <replaceable class="parameter">filename</replaceable></option></arg>
43efd9fa56b03e3e285fb58859efc9348c7f4a9fMark Andrews <arg><option>-t <replaceable class="parameter">directory</replaceable></option></arg>
43efd9fa56b03e3e285fb58859efc9348c7f4a9fMark Andrews <arg><option>-w <replaceable class="parameter">directory</replaceable></option></arg>
508f61f8d699c46f962b682f388e54b446a7194dMark Andrews <arg><option>-W <replaceable class="parameter">mode</replaceable></option></arg>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington </cmdsynopsis>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington </refsynopsisdiv>
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein checks the syntax and integrity of a zone file. It performs the
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein same checks as <command>named</command> does when loading a
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein zone. This makes <command>named-checkzone</command> useful for
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein checking zone files before configuring them into a name server.
c40265eba0c99708887d68e67901924065ba2514Brian Wellington <variablelist>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington <varlistentry>
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein Enable debugging.
c40265eba0c99708887d68e67901924065ba2514Brian Wellington </varlistentry>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington <varlistentry>
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein Quiet mode - exit code only.
c40265eba0c99708887d68e67901924065ba2514Brian Wellington </varlistentry>
a26ad011f382d12058478704cb5e90e6f4366d01Andreas Gustafsson <varlistentry>
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein Print the version of the <command>named-checkzone</command>
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein program and exit.
a26ad011f382d12058478704cb5e90e6f4366d01Andreas Gustafsson </varlistentry>
7791dd06ea69d0fb2494788ad4c24d568f40bcdfMark Andrews <varlistentry>
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein When loading the zone file read the journal if it exists.
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein </varlistentry>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington <varlistentry>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington <term>-c <replaceable class="parameter">class</replaceable></term>
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein Specify the class of the zone. If not specified "IN" is assumed.
c40265eba0c99708887d68e67901924065ba2514Brian Wellington </varlistentry>
2047977ce2dfcfe3a0fa2d638c3242841310fad3Mark Andrews <varlistentry>
2047977ce2dfcfe3a0fa2d638c3242841310fad3Mark Andrews <term>-k <replaceable class="parameter">mode</replaceable></term>
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein Perform <command>"check-name"</command> checks with
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein the specified failure mode.
2047977ce2dfcfe3a0fa2d638c3242841310fad3Mark Andrews </varlistentry>
4d9f3f00d93fcb8743b1105e8cf82e862be220d1Mark Andrews <varlistentry>
4d9f3f00d93fcb8743b1105e8cf82e862be220d1Mark Andrews <term>-n <replaceable class="parameter">mode</replaceable></term>
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein Specify whether NS records should be checked to see if they
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein are addresses. Possible modes are <command>"fail"</command>,
4d9f3f00d93fcb8743b1105e8cf82e862be220d1Mark Andrews </varlistentry>
d0aebc5a55b6145297d94f8aee939852357c59fcMark Andrews <varlistentry>
d0aebc5a55b6145297d94f8aee939852357c59fcMark Andrews <term>-o <replaceable class="parameter">filename</replaceable></term>
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein Write zone output to <filename>filename</filename>.
d0aebc5a55b6145297d94f8aee939852357c59fcMark Andrews </varlistentry>
43efd9fa56b03e3e285fb58859efc9348c7f4a9fMark Andrews <varlistentry>
43efd9fa56b03e3e285fb58859efc9348c7f4a9fMark Andrews <term>-t <replaceable class="parameter">directory</replaceable></term>
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein chroot to <filename>directory</filename> so that
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein directives in the configuration file are processed as if
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein run by a similarly chrooted named.
43efd9fa56b03e3e285fb58859efc9348c7f4a9fMark Andrews </varlistentry>
43efd9fa56b03e3e285fb58859efc9348c7f4a9fMark Andrews <varlistentry>
43efd9fa56b03e3e285fb58859efc9348c7f4a9fMark Andrews <term>-w <replaceable class="parameter">directory</replaceable></term>
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein filenames in master file $INCLUDE directives work. This
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein is similar to the directory clause in
43efd9fa56b03e3e285fb58859efc9348c7f4a9fMark Andrews </varlistentry>
d0aebc5a55b6145297d94f8aee939852357c59fcMark Andrews <varlistentry>
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein Dump zone file in canonical format.
d0aebc5a55b6145297d94f8aee939852357c59fcMark Andrews </varlistentry>
508f61f8d699c46f962b682f388e54b446a7194dMark Andrews <varlistentry>
508f61f8d699c46f962b682f388e54b446a7194dMark Andrews <term>-W <replaceable class="parameter">mode</replaceable></term>
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein Specify whether to check for non-terminal wildcards.
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein Non-terminal wildcards are almost always the result of a
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein failure to understand the wildcard matching algorithm (RFC 1034).
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein Possible modes are <command>"warn"</command> (default)
508f61f8d699c46f962b682f388e54b446a7194dMark Andrews </varlistentry>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington <varlistentry>
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein The domain name of the zone being checked.
c40265eba0c99708887d68e67901924065ba2514Brian Wellington </varlistentry>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington <varlistentry>
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein The name of the zone file.
c40265eba0c99708887d68e67901924065ba2514Brian Wellington </varlistentry>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington </variablelist>
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein returns an exit status of 1 if
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein errors were detected and 0 otherwise.
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein <refentrytitle>named</refentrytitle><manvolnum>8</manvolnum>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington </citerefentry>,
c40265eba0c99708887d68e67901924065ba2514Brian Wellington <citetitle>BIND 9 Administrator Reference Manual</citetitle>.
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein <para><corpauthor>Internet Systems Consortium</corpauthor>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington - Local variables: