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