named-checkzone.docbook revision dafcb997e390efa4423883dafd100c975c4095d6
c40265eba0c99708887d68e67901924065ba2514Brian Wellington<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews - Copyright (C) 2004 Internet Systems Consortium, Inc. ("ISC")
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews - Copyright (C) 2001, 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.
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews<!-- $Id: named-checkzone.docbook,v 1.11 2004/03/05 04:57:20 marka Exp $ -->
c40265eba0c99708887d68e67901924065ba2514Brian Wellington <refentryinfo>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington </refentryinfo>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington <refentrytitle><application>named-checkzone</application></refentrytitle>
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>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington </cmdsynopsis>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington </refsynopsisdiv>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington <command>named-checkzone</command> checks the syntax and integrity of
c40265eba0c99708887d68e67901924065ba2514Brian Wellington a zone file. It performs the same checks as <command>named</command>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington does when loading a zone. This makes
c40265eba0c99708887d68e67901924065ba2514Brian Wellington <command>named-checkzone</command> useful for checking zone
c40265eba0c99708887d68e67901924065ba2514Brian Wellington files before configuring them into a name server.
c40265eba0c99708887d68e67901924065ba2514Brian Wellington <variablelist>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington <varlistentry>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington Enable debugging.
c40265eba0c99708887d68e67901924065ba2514Brian Wellington </varlistentry>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington <varlistentry>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington Quiet mode - exit code only.
c40265eba0c99708887d68e67901924065ba2514Brian Wellington </varlistentry>
a26ad011f382d12058478704cb5e90e6f4366d01Andreas Gustafsson <varlistentry>
a26ad011f382d12058478704cb5e90e6f4366d01Andreas Gustafsson Print the version of the <command>named-checkzone</command>
a26ad011f382d12058478704cb5e90e6f4366d01Andreas Gustafsson program and exit.
a26ad011f382d12058478704cb5e90e6f4366d01Andreas Gustafsson </varlistentry>
7791dd06ea69d0fb2494788ad4c24d568f40bcdfMark Andrews <varlistentry>
e9359db5e958bf05f9b9c5fe3c27d533f0f05550Mark Andrews When loading the zone file read the journal if it exists.
c40265eba0c99708887d68e67901924065ba2514Brian Wellington <varlistentry>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington <term>-c <replaceable class="parameter">class</replaceable></term>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington 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>
2047977ce2dfcfe3a0fa2d638c3242841310fad3Mark Andrews Perform <command>"check-name"</command> checks with the specified failure mode.
2047977ce2dfcfe3a0fa2d638c3242841310fad3Mark Andrews </varlistentry>
4d9f3f00d93fcb8743b1105e8cf82e862be220d1Mark Andrews <varlistentry>
4d9f3f00d93fcb8743b1105e8cf82e862be220d1Mark Andrews <term>-n <replaceable class="parameter">mode</replaceable></term>
4d9f3f00d93fcb8743b1105e8cf82e862be220d1Mark Andrews Specify whether NS records should be checked to see if they
4d9f3f00d93fcb8743b1105e8cf82e862be220d1Mark Andrews are addresses. Possible modes are <command>"fail"</command>,
4d9f3f00d93fcb8743b1105e8cf82e862be220d1Mark Andrews </varlistentry>
d0aebc5a55b6145297d94f8aee939852357c59fcMark Andrews <varlistentry>
d0aebc5a55b6145297d94f8aee939852357c59fcMark Andrews <term>-o <replaceable class="parameter">filename</replaceable></term>
d0aebc5a55b6145297d94f8aee939852357c59fcMark Andrews Write zone output to <filename>directory</filename>.
d0aebc5a55b6145297d94f8aee939852357c59fcMark Andrews </varlistentry>
43efd9fa56b03e3e285fb58859efc9348c7f4a9fMark Andrews <varlistentry>
43efd9fa56b03e3e285fb58859efc9348c7f4a9fMark Andrews <term>-t <replaceable class="parameter">directory</replaceable></term>
43efd9fa56b03e3e285fb58859efc9348c7f4a9fMark Andrews chroot to <filename>directory</filename> so that include
43efd9fa56b03e3e285fb58859efc9348c7f4a9fMark Andrews directives in the configuration file are processed as if
43efd9fa56b03e3e285fb58859efc9348c7f4a9fMark Andrews run by a similarly chrooted named.
43efd9fa56b03e3e285fb58859efc9348c7f4a9fMark Andrews </varlistentry>
43efd9fa56b03e3e285fb58859efc9348c7f4a9fMark Andrews <varlistentry>
43efd9fa56b03e3e285fb58859efc9348c7f4a9fMark Andrews <term>-w <replaceable class="parameter">directory</replaceable></term>
43efd9fa56b03e3e285fb58859efc9348c7f4a9fMark Andrews chdir to <filename>directory</filename> so that relative
43efd9fa56b03e3e285fb58859efc9348c7f4a9fMark Andrews filenames in master file $INCLUDE directives work. This
43efd9fa56b03e3e285fb58859efc9348c7f4a9fMark Andrews is similar to the directory clause in
43efd9fa56b03e3e285fb58859efc9348c7f4a9fMark Andrews </varlistentry>
d0aebc5a55b6145297d94f8aee939852357c59fcMark Andrews <varlistentry>
d0aebc5a55b6145297d94f8aee939852357c59fcMark Andrews Dump zone file in canonical format.
d0aebc5a55b6145297d94f8aee939852357c59fcMark Andrews </varlistentry>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington <varlistentry>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington The domain name of the zone being checked.
c40265eba0c99708887d68e67901924065ba2514Brian Wellington </varlistentry>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington <varlistentry>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington The name of the zone file.
c40265eba0c99708887d68e67901924065ba2514Brian Wellington </varlistentry>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington </variablelist>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington <command>named-checkzone</command> returns an exit status of 1 if
c40265eba0c99708887d68e67901924065ba2514Brian Wellington errors were detected and 0 otherwise.
c40265eba0c99708887d68e67901924065ba2514Brian Wellington <citerefentry>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington </citerefentry>,
c40265eba0c99708887d68e67901924065ba2514Brian Wellington <citetitle>BIND 9 Administrator Reference Manual</citetitle>.
c40265eba0c99708887d68e67901924065ba2514Brian Wellington <corpauthor>Internet Software Consortium</corpauthor>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington - Local variables: