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