named-checkzone.docbook revision 339d2a4d4b3b2e0be9e43afec6e84fe468edfaee
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster [<!ENTITY mdash "—">]>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster - Copyright (C) 2004-2007, 2009-2011 Internet Systems Consortium, Inc. ("ISC")
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster - Copyright (C) 2000-2002 Internet Software Consortium.
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster - Permission to use, copy, modify, and/or distribute this software for any
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster - purpose with or without fee is hereby granted, provided that the above
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster - copyright notice and this permission notice appear in all copies.
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster - PERFORMANCE OF THIS SOFTWARE.
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<!-- $Id: named-checkzone.docbook,v 1.43 2011/12/09 23:47:02 tbox Exp $ -->
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <refentryinfo>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster </refentryinfo>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <refentrytitle><application>named-checkzone</application></refentrytitle>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster </copyright>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster </copyright>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <refnamediv>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <refname><application>named-checkzone</application></refname>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <refname><application>named-compilezone</application></refname>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <refpurpose>zone file validity checking or converting tool</refpurpose>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster </refnamediv>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <refsynopsisdiv>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <cmdsynopsis>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <arg><option>-c <replaceable class="parameter">class</replaceable></option></arg>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <arg><option>-f <replaceable class="parameter">format</replaceable></option></arg>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <arg><option>-F <replaceable class="parameter">format</replaceable></option></arg>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <arg><option>-i <replaceable class="parameter">mode</replaceable></option></arg>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <arg><option>-k <replaceable class="parameter">mode</replaceable></option></arg>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <arg><option>-m <replaceable class="parameter">mode</replaceable></option></arg>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <arg><option>-M <replaceable class="parameter">mode</replaceable></option></arg>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <arg><option>-n <replaceable class="parameter">mode</replaceable></option></arg>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <arg><option>-o <replaceable class="parameter">filename</replaceable></option></arg>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <arg><option>-r <replaceable class="parameter">mode</replaceable></option></arg>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <arg><option>-s <replaceable class="parameter">style</replaceable></option></arg>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <arg><option>-S <replaceable class="parameter">mode</replaceable></option></arg>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <arg><option>-t <replaceable class="parameter">directory</replaceable></option></arg>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <arg><option>-w <replaceable class="parameter">directory</replaceable></option></arg>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <arg><option>-W <replaceable class="parameter">mode</replaceable></option></arg>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster </cmdsynopsis>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <cmdsynopsis>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <arg><option>-c <replaceable class="parameter">class</replaceable></option></arg>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <arg><option>-C <replaceable class="parameter">mode</replaceable></option></arg>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <arg><option>-f <replaceable class="parameter">format</replaceable></option></arg>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <arg><option>-F <replaceable class="parameter">format</replaceable></option></arg>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <arg><option>-i <replaceable class="parameter">mode</replaceable></option></arg>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <arg><option>-k <replaceable class="parameter">mode</replaceable></option></arg>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <arg><option>-m <replaceable class="parameter">mode</replaceable></option></arg>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <arg><option>-n <replaceable class="parameter">mode</replaceable></option></arg>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <arg><option>-r <replaceable class="parameter">mode</replaceable></option></arg>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <arg><option>-s <replaceable class="parameter">style</replaceable></option></arg>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <arg><option>-t <replaceable class="parameter">directory</replaceable></option></arg>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <arg><option>-w <replaceable class="parameter">directory</replaceable></option></arg>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <arg><option>-W <replaceable class="parameter">mode</replaceable></option></arg>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <arg choice="req"><option>-o <replaceable class="parameter">filename</replaceable></option></arg>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster </cmdsynopsis>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster </refsynopsisdiv>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster checks the syntax and integrity of a zone file. It performs the
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster same checks as <command>named</command> does when loading a
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster zone. This makes <command>named-checkzone</command> useful for
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster checking zone files before configuring them into a name server.
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <command>named-compilezone</command> is similar to
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <command>named-checkzone</command>, but it always dumps the
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster zone contents to a specified file in a specified format.
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster Additionally, it applies stricter check levels by default,
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster since the dump output will be used as an actual zone file
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster When manually specified otherwise, the check levels must at
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster least be as strict as those specified in the
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <variablelist>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <varlistentry>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster Enable debugging.
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster </varlistentry>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <varlistentry>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster Print the usage summary and exit.
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster </varlistentry>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <varlistentry>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster Quiet mode - exit code only.
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster </varlistentry>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <varlistentry>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster Print the version of the <command>named-checkzone</command>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster program and exit.
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster </varlistentry>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <varlistentry>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster When loading the zone file read the journal if it exists.
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster </varlistentry>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <varlistentry>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <term>-c <replaceable class="parameter">class</replaceable></term>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster Specify the class of the zone. If not specified, "IN" is assumed.
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster </varlistentry>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <varlistentry>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <term>-i <replaceable class="parameter">mode</replaceable></term>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster Perform post-load zone integrity checks. Possible modes are
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster Mode <command>"full"</command> checks that MX records
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster refer to A or AAAA record (both in-zone and out-of-zone
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster hostnames). Mode <command>"local"</command> only
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster checks MX records which refer to in-zone hostnames.
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster Mode <command>"full"</command> checks that SRV records
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster refer to A or AAAA record (both in-zone and out-of-zone
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster hostnames). Mode <command>"local"</command> only
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster checks SRV records which refer to in-zone hostnames.
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster Mode <command>"full"</command> checks that delegation NS
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster records refer to A or AAAA record (both in-zone and out-of-zone
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster hostnames). It also checks that glue address records
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster in the zone match those advertised by the child.
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster Mode <command>"local"</command> only checks NS records which
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster refer to in-zone hostnames or that some required glue exists,
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster that is when the nameserver is in a child zone.
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <command>"local-sibling"</command> disable sibling glue
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster checks but are otherwise the same as <command>"full"</command>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster Mode <command>"none"</command> disables the checks.
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster </varlistentry>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <varlistentry>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <term>-f <replaceable class="parameter">format</replaceable></term>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster Specify the format of the zone file.
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster Possible formats are <command>"text"</command> (default)
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster </varlistentry>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <varlistentry>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <term>-F <replaceable class="parameter">format</replaceable></term>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster Specify the format of the output file specified.
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster this does not cause any effects unless it dumps the zone
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster Possible formats are <command>"text"</command> (default)
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster and <command>"raw"</command> or <command>"raw=N"</command>,
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster which store the zone in a binary format for rapid loading
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster by <command>named</command>. <command>"raw=N"</command>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster specifies the format version of the raw zone file: if N
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster is 0, the raw file can be read by any version of
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <command>named</command>; if N is 1, the file can be read
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster by release 9.9.0 or higher. The default is 1.
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster </varlistentry>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <varlistentry>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <term>-k <replaceable class="parameter">mode</replaceable></term>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster Perform <command>"check-names"</command> checks with the
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster specified failure mode.
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster (default for <command>named-compilezone</command>),
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster (default for <command>named-checkzone</command>) and
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster </varlistentry>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <varlistentry>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <term>-m <replaceable class="parameter">mode</replaceable></term>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster Specify whether MX records should be checked to see if they
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster are addresses. Possible modes are <command>"fail"</command>,