named-checkzone.docbook revision 2f4ffd7f5594c0464f2a872aee5ef102f6f7b10f
c40265eba0c99708887d68e67901924065ba2514Brian Wellington<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
2f4ffd7f5594c0464f2a872aee5ef102f6f7b10fMark Andrews - Copyright (C) 2004, 2005 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.
2f4ffd7f5594c0464f2a872aee5ef102f6f7b10fMark Andrews<!-- $Id: named-checkzone.docbook,v 1.14 2005/01/10 23:43:12 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>
508f61f8d699c46f962b682f388e54b446a7194dMark Andrews <arg><option>-W <replaceable class="parameter">mode</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>
508f61f8d699c46f962b682f388e54b446a7194dMark Andrews <varlistentry>
508f61f8d699c46f962b682f388e54b446a7194dMark Andrews <term>-W <replaceable class="parameter">mode</replaceable></term>
508f61f8d699c46f962b682f388e54b446a7194dMark Andrews Specify whether to check for non-terminal wildcards.
508f61f8d699c46f962b682f388e54b446a7194dMark Andrews Non-terminal wildcards are almost always the result of a
508f61f8d699c46f962b682f388e54b446a7194dMark Andrews failure to understand the wildcard matching algorithm (RFC 1034).
508f61f8d699c46f962b682f388e54b446a7194dMark Andrews Possible modes are <command>"warn"</command> (default) and
508f61f8d699c46f962b682f388e54b446a7194dMark 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>.
17cb8353e999e3294e6619613f401af3f7b1540cMark Andrews <corpauthor>Internet Systems Consortium</corpauthor>
c40265eba0c99708887d68e67901924065ba2514Brian Wellington - Local variables: