man.named-checkzone.html revision e67b52444aa179d82a1dea2da9bd4388ce7ded52
911106dfb16696472af8c1b7b4c554a829354fa8jm - Copyright (C) 2004-2012 Internet Systems Consortium, Inc. ("ISC")
911106dfb16696472af8c1b7b4c554a829354fa8jm - Copyright (C) 2000-2003 Internet Software Consortium.
911106dfb16696472af8c1b7b4c554a829354fa8jm - Permission to use, copy, modify, and/or distribute this software for any
911106dfb16696472af8c1b7b4c554a829354fa8jm - purpose with or without fee is hereby granted, provided that the above
911106dfb16696472af8c1b7b4c554a829354fa8jm - copyright notice and this permission notice appear in all copies.
911106dfb16696472af8c1b7b4c554a829354fa8jm - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
911106dfb16696472af8c1b7b4c554a829354fa8jm - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
911106dfb16696472af8c1b7b4c554a829354fa8jm - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
911106dfb16696472af8c1b7b4c554a829354fa8jm - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
911106dfb16696472af8c1b7b4c554a829354fa8jm - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
911106dfb16696472af8c1b7b4c554a829354fa8jm - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
911106dfb16696472af8c1b7b4c554a829354fa8jm - PERFORMANCE OF THIS SOFTWARE.
911106dfb16696472af8c1b7b4c554a829354fa8jm<!-- $Id$ -->
911106dfb16696472af8c1b7b4c554a829354fa8jm<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
911106dfb16696472af8c1b7b4c554a829354fa8jm<meta name="generator" content="DocBook XSL Stylesheets V1.71.1">
d3d50737e566cade9a08d73d2af95105ac7cd960Rafael Vanoni<link rel="start" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual">
911106dfb16696472af8c1b7b4c554a829354fa8jm<link rel="up" href="Bv9ARM.ch10.html" title="Manual pages">
911106dfb16696472af8c1b7b4c554a829354fa8jm<link rel="prev" href="man.named-checkconf.html" title="named-checkconf">
911106dfb16696472af8c1b7b4c554a829354fa8jm<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
911106dfb16696472af8c1b7b4c554a829354fa8jm<tr><th colspan="3" align="center"><span class="application">named-checkzone</span></th></tr>
911106dfb16696472af8c1b7b4c554a829354fa8jm<a accesskey="p" href="man.named-checkconf.html">Prev</a>�</td>
911106dfb16696472af8c1b7b4c554a829354fa8jm<td width="20%" align="right">�<a accesskey="n" href="man.named.html">Next</a>
911106dfb16696472af8c1b7b4c554a829354fa8jm<a name="man.named-checkzone"></a><div class="titlepage"></div>
bfc848c632c9eacb2a640246d96e198f1b185c03jm<p><span class="application">named-checkzone</span>, <span class="application">named-compilezone</span> — zone file validity checking or converting tool</p>
bfc848c632c9eacb2a640246d96e198f1b185c03jm<div class="cmdsynopsis"><p><code class="command">named-checkzone</code> [<code class="option">-d</code>] [<code class="option">-h</code>] [<code class="option">-j</code>] [<code class="option">-q</code>] [<code class="option">-v</code>] [<code class="option">-c <em class="replaceable"><code>class</code></em></code>] [<code class="option">-f <em class="replaceable"><code>format</code></em></code>] [<code class="option">-F <em class="replaceable"><code>format</code></em></code>] [<code class="option">-i <em class="replaceable"><code>mode</code></em></code>] [<code class="option">-k <em class="replaceable"><code>mode</code></em></code>] [<code class="option">-m <em class="replaceable"><code>mode</code></em></code>] [<code class="option">-M <em class="replaceable"><code>mode</code></em></code>] [<code class="option">-n <em class="replaceable"><code>mode</code></em></code>] [<code class="option">-L <em class="replaceable"><code>serial</code></em></code>] [<code class="option">-o <em class="replaceable"><code>filename</code></em></code>] [<code class="option">-r <em class="replaceable"><code>mode</code></em></code>] [<code class="option">-s <em class="replaceable"><code>style</code></em></code>] [<code class="option">-S <em class="replaceable"><code>mode</code></em></code>] [<code class="option">-t <em class="replaceable"><code>directory</code></em></code>] [<code class="option">-w <em class="replaceable"><code>directory</code></em></code>] [<code class="option">-D</code>] [<code class="option">-W <em class="replaceable"><code>mode</code></em></code>] {zonename} {filename}</p></div>
bfc848c632c9eacb2a640246d96e198f1b185c03jm<div class="cmdsynopsis"><p><code class="command">named-compilezone</code> [<code class="option">-d</code>] [<code class="option">-j</code>] [<code class="option">-q</code>] [<code class="option">-v</code>] [<code class="option">-c <em class="replaceable"><code>class</code></em></code>] [<code class="option">-C <em class="replaceable"><code>mode</code></em></code>] [<code class="option">-f <em class="replaceable"><code>format</code></em></code>] [<code class="option">-F <em class="replaceable"><code>format</code></em></code>] [<code class="option">-i <em class="replaceable"><code>mode</code></em></code>] [<code class="option">-k <em class="replaceable"><code>mode</code></em></code>] [<code class="option">-m <em class="replaceable"><code>mode</code></em></code>] [<code class="option">-n <em class="replaceable"><code>mode</code></em></code>] [<code class="option">-L <em class="replaceable"><code>serial</code></em></code>] [<code class="option">-r <em class="replaceable"><code>mode</code></em></code>] [<code class="option">-s <em class="replaceable"><code>style</code></em></code>] [<code class="option">-t <em class="replaceable"><code>directory</code></em></code>] [<code class="option">-w <em class="replaceable"><code>directory</code></em></code>] [<code class="option">-D</code>] [<code class="option">-W <em class="replaceable"><code>mode</code></em></code>] {<code class="option">-o <em class="replaceable"><code>filename</code></em></code>} {zonename} {filename}</p></div>
bfc848c632c9eacb2a640246d96e198f1b185c03jm<p><span><strong class="command">named-checkzone</strong></span>
bfc848c632c9eacb2a640246d96e198f1b185c03jm checks the syntax and integrity of a zone file. It performs the
bfc848c632c9eacb2a640246d96e198f1b185c03jm same checks as <span><strong class="command">named</strong></span> does when loading a
bfc848c632c9eacb2a640246d96e198f1b185c03jm zone. This makes <span><strong class="command">named-checkzone</strong></span> useful for
bfc848c632c9eacb2a640246d96e198f1b185c03jm checking zone files before configuring them into a name server.
bfc848c632c9eacb2a640246d96e198f1b185c03jm <span><strong class="command">named-compilezone</strong></span> is similar to
bfc848c632c9eacb2a640246d96e198f1b185c03jm <span><strong class="command">named-checkzone</strong></span>, but it always dumps the
bfc848c632c9eacb2a640246d96e198f1b185c03jm zone contents to a specified file in a specified format.
bfc848c632c9eacb2a640246d96e198f1b185c03jm Additionally, it applies stricter check levels by default,
bfc848c632c9eacb2a640246d96e198f1b185c03jm since the dump output will be used as an actual zone file
bfc848c632c9eacb2a640246d96e198f1b185c03jm loaded by <span><strong class="command">named</strong></span>.
bfc848c632c9eacb2a640246d96e198f1b185c03jm When manually specified otherwise, the check levels must at
bfc848c632c9eacb2a640246d96e198f1b185c03jm least be as strict as those specified in the
bfc848c632c9eacb2a640246d96e198f1b185c03jm <span><strong class="command">named</strong></span> configuration file.
bfc848c632c9eacb2a640246d96e198f1b185c03jm Enable debugging.
bfc848c632c9eacb2a640246d96e198f1b185c03jm Print the usage summary and exit.
bfc848c632c9eacb2a640246d96e198f1b185c03jm Quiet mode - exit code only.
bfc848c632c9eacb2a640246d96e198f1b185c03jm Print the version of the <span><strong class="command">named-checkzone</strong></span>
bfc848c632c9eacb2a640246d96e198f1b185c03jm program and exit.
bfc848c632c9eacb2a640246d96e198f1b185c03jm When loading the zone file read the journal if it exists.
bfc848c632c9eacb2a640246d96e198f1b185c03jm<dt><span class="term">-c <em class="replaceable"><code>class</code></em></span></dt>
bfc848c632c9eacb2a640246d96e198f1b185c03jm Specify the class of the zone. If not specified, "IN" is assumed.
bfc848c632c9eacb2a640246d96e198f1b185c03jm<dt><span class="term">-i <em class="replaceable"><code>mode</code></em></span></dt>
bfc848c632c9eacb2a640246d96e198f1b185c03jm Perform post-load zone integrity checks. Possible modes are
bfc848c632c9eacb2a640246d96e198f1b185c03jm <span><strong class="command">"full"</strong></span> (default),
bfc848c632c9eacb2a640246d96e198f1b185c03jm <span><strong class="command">"full-sibling"</strong></span>,
bfc848c632c9eacb2a640246d96e198f1b185c03jm <span><strong class="command">"local-sibling"</strong></span> and
bfc848c632c9eacb2a640246d96e198f1b185c03jm Mode <span><strong class="command">"full"</strong></span> checks that MX records
bfc848c632c9eacb2a640246d96e198f1b185c03jm refer to A or AAAA record (both in-zone and out-of-zone
bfc848c632c9eacb2a640246d96e198f1b185c03jm hostnames). Mode <span><strong class="command">"local"</strong></span> only
bfc848c632c9eacb2a640246d96e198f1b185c03jm checks MX records which refer to in-zone hostnames.
bfc848c632c9eacb2a640246d96e198f1b185c03jm Mode <span><strong class="command">"full"</strong></span> checks that SRV records
bfc848c632c9eacb2a640246d96e198f1b185c03jm refer to A or AAAA record (both in-zone and out-of-zone
bfc848c632c9eacb2a640246d96e198f1b185c03jm hostnames). Mode <span><strong class="command">"local"</strong></span> only
bfc848c632c9eacb2a640246d96e198f1b185c03jm checks SRV records which refer to in-zone hostnames.
bfc848c632c9eacb2a640246d96e198f1b185c03jm Mode <span><strong class="command">"full"</strong></span> checks that delegation NS
bfc848c632c9eacb2a640246d96e198f1b185c03jm records refer to A or AAAA record (both in-zone and out-of-zone
bfc848c632c9eacb2a640246d96e198f1b185c03jm hostnames). It also checks that glue address records
bfc848c632c9eacb2a640246d96e198f1b185c03jm in the zone match those advertised by the child.
bfc848c632c9eacb2a640246d96e198f1b185c03jm Mode <span><strong class="command">"local"</strong></span> only checks NS records which
bfc848c632c9eacb2a640246d96e198f1b185c03jm refer to in-zone hostnames or that some required glue exists,
bfc848c632c9eacb2a640246d96e198f1b185c03jm that is when the nameserver is in a child zone.
bfc848c632c9eacb2a640246d96e198f1b185c03jm Mode <span><strong class="command">"full-sibling"</strong></span> and
bfc848c632c9eacb2a640246d96e198f1b185c03jm <span><strong class="command">"local-sibling"</strong></span> disable sibling glue
bfc848c632c9eacb2a640246d96e198f1b185c03jm checks but are otherwise the same as <span><strong class="command">"full"</strong></span>
bfc848c632c9eacb2a640246d96e198f1b185c03jm and <span><strong class="command">"local"</strong></span> respectively.
bfc848c632c9eacb2a640246d96e198f1b185c03jm Mode <span><strong class="command">"none"</strong></span> disables the checks.
bfc848c632c9eacb2a640246d96e198f1b185c03jm<dt><span class="term">-f <em class="replaceable"><code>format</code></em></span></dt>
bfc848c632c9eacb2a640246d96e198f1b185c03jm Specify the format of the zone file.
bfc848c632c9eacb2a640246d96e198f1b185c03jm Possible formats are <span><strong class="command">"text"</strong></span> (default),
bfc848c632c9eacb2a640246d96e198f1b185c03jm <span><strong class="command">"raw"</strong></span>, and <span><strong class="command">"fast"</strong></span>.
bfc848c632c9eacb2a640246d96e198f1b185c03jm<dt><span class="term">-F <em class="replaceable"><code>format</code></em></span></dt>
bfc848c632c9eacb2a640246d96e198f1b185c03jm Specify the format of the output file specified.
bfc848c632c9eacb2a640246d96e198f1b185c03jm For <span><strong class="command">named-checkzone</strong></span>,
bfc848c632c9eacb2a640246d96e198f1b185c03jm this does not cause any effects unless it dumps the zone
bfc848c632c9eacb2a640246d96e198f1b185c03jm Possible formats are <span><strong class="command">"text"</strong></span> (default),
bfc848c632c9eacb2a640246d96e198f1b185c03jm which is the standard textual representation of the zone,
bfc848c632c9eacb2a640246d96e198f1b185c03jm and <span><strong class="command">"fast"</strong></span>, <span><strong class="command">"raw"</strong></span>,
bfc848c632c9eacb2a640246d96e198f1b185c03jm and <span><strong class="command">"raw=N"</strong></span>, which store the zone in a
bfc848c632c9eacb2a640246d96e198f1b185c03jm binary format for rapid loading by <span><strong class="command">named</strong></span>.
bfc848c632c9eacb2a640246d96e198f1b185c03jm <span><strong class="command">"raw=N"</strong></span> specifies the format version of
bfc848c632c9eacb2a640246d96e198f1b185c03jm the raw zone file: if N is 0, the raw file can be read by
bfc848c632c9eacb2a640246d96e198f1b185c03jm any version of <span><strong class="command">named</strong></span>; if N is 1, the file
bfc848c632c9eacb2a640246d96e198f1b185c03jm can be read by release 9.9.0 or higher; the default is 1.
bfc848c632c9eacb2a640246d96e198f1b185c03jm<dt><span class="term">-k <em class="replaceable"><code>mode</code></em></span></dt>
bfc848c632c9eacb2a640246d96e198f1b185c03jm Perform <span><strong class="command">"check-names"</strong></span> checks with the
bfc848c632c9eacb2a640246d96e198f1b185c03jm specified failure mode.
bfc848c632c9eacb2a640246d96e198f1b185c03jm Possible modes are <span><strong class="command">"fail"</strong></span>
bfc848c632c9eacb2a640246d96e198f1b185c03jm (default for <span><strong class="command">named-compilezone</strong></span>),
bfc848c632c9eacb2a640246d96e198f1b185c03jm (default for <span><strong class="command">named-checkzone</strong></span>) and
bfc848c632c9eacb2a640246d96e198f1b185c03jm<dt><span class="term">-L <em class="replaceable"><code>serial</code></em></span></dt>
bfc848c632c9eacb2a640246d96e198f1b185c03jm When compiling a zone to "raw" or "fast" format, set the
bfc848c632c9eacb2a640246d96e198f1b185c03jm "source serial" value in the header to the specified serial
bfc848c632c9eacb2a640246d96e198f1b185c03jm number. (This is expected to be used primarily for testing
bfc848c632c9eacb2a640246d96e198f1b185c03jm purposes.)
911106dfb16696472af8c1b7b4c554a829354fa8jm<dt><span class="term">-m <em class="replaceable"><code>mode</code></em></span></dt>
bfc848c632c9eacb2a640246d96e198f1b185c03jm Specify whether MX records should be checked to see if they
bfc848c632c9eacb2a640246d96e198f1b185c03jm are addresses. Possible modes are <span><strong class="command">"fail"</strong></span>,
bfc848c632c9eacb2a640246d96e198f1b185c03jm <span><strong class="command">"warn"</strong></span> (default) and
bfc848c632c9eacb2a640246d96e198f1b185c03jm<dt><span class="term">-M <em class="replaceable"><code>mode</code></em></span></dt>
bfc848c632c9eacb2a640246d96e198f1b185c03jm Check if a MX record refers to a CNAME.
911106dfb16696472af8c1b7b4c554a829354fa8jm Possible modes are <span><strong class="command">"fail"</strong></span>,
911106dfb16696472af8c1b7b4c554a829354fa8jm <span><strong class="command">"warn"</strong></span> (default) and
911106dfb16696472af8c1b7b4c554a829354fa8jm<dt><span class="term">-n <em class="replaceable"><code>mode</code></em></span></dt>
911106dfb16696472af8c1b7b4c554a829354fa8jm Specify whether NS records should be checked to see if they
911106dfb16696472af8c1b7b4c554a829354fa8jm are addresses.
911106dfb16696472af8c1b7b4c554a829354fa8jm Possible modes are <span><strong class="command">"fail"</strong></span>
911106dfb16696472af8c1b7b4c554a829354fa8jm (default for <span><strong class="command">named-compilezone</strong></span>),
911106dfb16696472af8c1b7b4c554a829354fa8jm (default for <span><strong class="command">named-checkzone</strong></span>) and
bfc848c632c9eacb2a640246d96e198f1b185c03jm<dt><span class="term">-o <em class="replaceable"><code>filename</code></em></span></dt>
bfc848c632c9eacb2a640246d96e198f1b185c03jm Write zone output to <code class="filename">filename</code>.
bfc848c632c9eacb2a640246d96e198f1b185c03jm If <code class="filename">filename</code> is <code class="filename">-</code> then
bfc848c632c9eacb2a640246d96e198f1b185c03jm write to standard out.
bfc848c632c9eacb2a640246d96e198f1b185c03jm This is mandatory for <span><strong class="command">named-compilezone</strong></span>.
bfc848c632c9eacb2a640246d96e198f1b185c03jm<dt><span class="term">-r <em class="replaceable"><code>mode</code></em></span></dt>
bfc848c632c9eacb2a640246d96e198f1b185c03jm Check for records that are treated as different by DNSSEC but
bfc848c632c9eacb2a640246d96e198f1b185c03jm are semantically equal in plain DNS.
bfc848c632c9eacb2a640246d96e198f1b185c03jm Possible modes are <span><strong class="command">"fail"</strong></span>,
bfc848c632c9eacb2a640246d96e198f1b185c03jm <span><strong class="command">"warn"</strong></span> (default) and
911106dfb16696472af8c1b7b4c554a829354fa8jm<dt><span class="term">-s <em class="replaceable"><code>style</code></em></span></dt>
bfc848c632c9eacb2a640246d96e198f1b185c03jm Specify the style of the dumped zone file.
bfc848c632c9eacb2a640246d96e198f1b185c03jm Possible styles are <span><strong class="command">"full"</strong></span> (default)
bfc848c632c9eacb2a640246d96e198f1b185c03jm and <span><strong class="command">"relative"</strong></span>.
bfc848c632c9eacb2a640246d96e198f1b185c03jm The full format is most suitable for processing
bfc848c632c9eacb2a640246d96e198f1b185c03jm automatically by a separate script.
bfc848c632c9eacb2a640246d96e198f1b185c03jm On the other hand, the relative format is more
bfc848c632c9eacb2a640246d96e198f1b185c03jm human-readable and is thus suitable for editing by hand.
911106dfb16696472af8c1b7b4c554a829354fa8jm For <span><strong class="command">named-checkzone</strong></span>
911106dfb16696472af8c1b7b4c554a829354fa8jm this does not cause any effects unless it dumps the zone
bfc848c632c9eacb2a640246d96e198f1b185c03jm It also does not have any meaning if the output format
bfc848c632c9eacb2a640246d96e198f1b185c03jm is not text.
911106dfb16696472af8c1b7b4c554a829354fa8jm<dt><span class="term">-S <em class="replaceable"><code>mode</code></em></span></dt>
bfc848c632c9eacb2a640246d96e198f1b185c03jm Check if a SRV record refers to a CNAME.
bfc848c632c9eacb2a640246d96e198f1b185c03jm Possible modes are <span><strong class="command">"fail"</strong></span>,
bfc848c632c9eacb2a640246d96e198f1b185c03jm <span><strong class="command">"warn"</strong></span> (default) and
911106dfb16696472af8c1b7b4c554a829354fa8jm<dt><span class="term">-t <em class="replaceable"><code>directory</code></em></span></dt>
911106dfb16696472af8c1b7b4c554a829354fa8jm Chroot to <code class="filename">directory</code> so that
911106dfb16696472af8c1b7b4c554a829354fa8jm directives in the configuration file are processed as if
911106dfb16696472af8c1b7b4c554a829354fa8jm run by a similarly chrooted named.
911106dfb16696472af8c1b7b4c554a829354fa8jm<dt><span class="term">-w <em class="replaceable"><code>directory</code></em></span></dt>
bfc848c632c9eacb2a640246d96e198f1b185c03jm filenames in master file $INCLUDE directives work. This
bfc848c632c9eacb2a640246d96e198f1b185c03jm is similar to the directory clause in
911106dfb16696472af8c1b7b4c554a829354fa8jm Dump zone file in canonical format.
911106dfb16696472af8c1b7b4c554a829354fa8jm This is always enabled for <span><strong class="command">named-compilezone</strong></span>.
bfc848c632c9eacb2a640246d96e198f1b185c03jm<dt><span class="term">-W <em class="replaceable"><code>mode</code></em></span></dt>
bfc848c632c9eacb2a640246d96e198f1b185c03jm Specify whether to check for non-terminal wildcards.
bfc848c632c9eacb2a640246d96e198f1b185c03jm Non-terminal wildcards are almost always the result of a
bfc848c632c9eacb2a640246d96e198f1b185c03jm failure to understand the wildcard matching algorithm (RFC 1034).
bfc848c632c9eacb2a640246d96e198f1b185c03jm Possible modes are <span><strong class="command">"warn"</strong></span> (default)
53c110294d8b1410cabc201a52f94b03ae2ef448jm The domain name of the zone being checked.
911106dfb16696472af8c1b7b4c554a829354fa8jm The name of the zone file.
911106dfb16696472af8c1b7b4c554a829354fa8jm<p><span><strong class="command">named-checkzone</strong></span>
911106dfb16696472af8c1b7b4c554a829354fa8jm returns an exit status of 1 if
bfc848c632c9eacb2a640246d96e198f1b185c03jm errors were detected and 0 otherwise.
bfc848c632c9eacb2a640246d96e198f1b185c03jm<p><span class="citerefentry"><span class="refentrytitle">named</span>(8)</span>,
bfc848c632c9eacb2a640246d96e198f1b185c03jm <span class="citerefentry"><span class="refentrytitle">named-checkconf</span>(8)</span>,
bfc848c632c9eacb2a640246d96e198f1b185c03jm <em class="citetitle">BIND 9 Administrator Reference Manual</em>.
bfc848c632c9eacb2a640246d96e198f1b185c03jm<p><span class="corpauthor">Internet Systems Consortium</span>
bfc848c632c9eacb2a640246d96e198f1b185c03jm<a accesskey="p" href="man.named-checkconf.html">Prev</a>�</td>
911106dfb16696472af8c1b7b4c554a829354fa8jm<td width="20%" align="center"><a accesskey="u" href="Bv9ARM.ch10.html">Up</a></td>
911106dfb16696472af8c1b7b4c554a829354fa8jm<td width="40%" align="right">�<a accesskey="n" href="man.named.html">Next</a>
bfc848c632c9eacb2a640246d96e198f1b185c03jm<td width="20%" align="center"><a accesskey="h" href="Bv9ARM.html">Home</a></td>
bfc848c632c9eacb2a640246d96e198f1b185c03jm<td width="40%" align="right" valign="top">�<span class="application">named</span>