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