named-checkzone.html revision d8620c7234281056fdfd2ee40cf16636b8281092
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews - Copyright (C) 2004-2007, 2009-2012 Internet Systems Consortium, Inc. ("ISC")
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews - Copyright (C) 2000-2002 Internet Software Consortium.
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews - Permission to use, copy, modify, and/or distribute this software for any
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews - purpose with or without fee is hereby granted, provided that the above
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews - copyright notice and this permission notice appear in all copies.
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews - PERFORMANCE OF THIS SOFTWARE.
d6dc0d4f584352d2e4305435599ae8c93776d9b4Mark Andrews<!-- $Id$ -->
95317501208f3bf5b159e6a40801b7069f68c486Mark Andrews<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
95317501208f3bf5b159e6a40801b7069f68c486Mark Andrews<meta name="generator" content="DocBook XSL Stylesheets V1.71.1">
95317501208f3bf5b159e6a40801b7069f68c486Mark Andrews<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en">
95317501208f3bf5b159e6a40801b7069f68c486Mark Andrews<a name="man.named-checkzone"></a><div class="titlepage"></div>
95317501208f3bf5b159e6a40801b7069f68c486Mark Andrews<p><span class="application">named-checkzone</span>, <span class="application">named-compilezone</span> — zone file validity checking or converting tool</p>
95317501208f3bf5b159e6a40801b7069f68c486Mark Andrews<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">-J <em class="replaceable"><code>filename</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>
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews<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">-J <em class="replaceable"><code>filename</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>
b08e3be5dbfba22719ae9c428bd6853ac6f09798Mark Andrews<p><span><strong class="command">named-checkzone</strong></span>
b08e3be5dbfba22719ae9c428bd6853ac6f09798Mark Andrews checks the syntax and integrity of a zone file. It performs the
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews same checks as <span><strong class="command">named</strong></span> does when loading a
01163d188b89911c3a23fe1125a4cab6764a408cMark Andrews zone. This makes <span><strong class="command">named-checkzone</strong></span> useful for
01163d188b89911c3a23fe1125a4cab6764a408cMark Andrews checking zone files before configuring them into a name server.
b08e3be5dbfba22719ae9c428bd6853ac6f09798Mark Andrews <span><strong class="command">named-compilezone</strong></span> is similar to
648ba62b1f156cbca14d54d06c535385f1193d13Mark Andrews <span><strong class="command">named-checkzone</strong></span>, but it always dumps the
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews zone contents to a specified file in a specified format.
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews Additionally, it applies stricter check levels by default,
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews since the dump output will be used as an actual zone file
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews loaded by <span><strong class="command">named</strong></span>.
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews When manually specified otherwise, the check levels must at
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews least be as strict as those specified in the
35665db4e49e3e4c0e3776e635449f931f3732cfMark Andrews <span><strong class="command">named</strong></span> configuration file.
bdfd62f497fe0d5281c25b61271595a4c821a040Mark Andrews Enable debugging.
bdfd62f497fe0d5281c25b61271595a4c821a040Mark Andrews Print the usage summary and exit.
bdfd62f497fe0d5281c25b61271595a4c821a040Mark Andrews Quiet mode - exit code only.
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews Print the version of the <span><strong class="command">named-checkzone</strong></span>
64cde9d94a2f6c7050f00d9651df6b05e63d09f2Mark Andrews program and exit.
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews When loading a zone file, read the journal if it exists.
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews The journal file name is assumed to be the zone file name
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews appended with the string <code class="filename">.jnl</code>.
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews<dt><span class="term">-J <em class="replaceable"><code>filename</code></em></span></dt>
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews When loading the zone file read the journal from the given
d6dc0d4f584352d2e4305435599ae8c93776d9b4Mark Andrews file, if it exists. (Implies -j.)
d6dc0d4f584352d2e4305435599ae8c93776d9b4Mark Andrews<dt><span class="term">-c <em class="replaceable"><code>class</code></em></span></dt>
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews Specify the class of the zone. If not specified, "IN" is assumed.
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews<dt><span class="term">-i <em class="replaceable"><code>mode</code></em></span></dt>
61a03692ab84504fb2bd85b71facfe0f6456b466Mark Andrews Perform post-load zone integrity checks. Possible modes are
61a03692ab84504fb2bd85b71facfe0f6456b466Mark Andrews <span><strong class="command">"full"</strong></span> (default),
61a03692ab84504fb2bd85b71facfe0f6456b466Mark Andrews <span><strong class="command">"full-sibling"</strong></span>,
61a03692ab84504fb2bd85b71facfe0f6456b466Mark Andrews <span><strong class="command">"local"</strong></span>,
61a03692ab84504fb2bd85b71facfe0f6456b466Mark Andrews <span><strong class="command">"local-sibling"</strong></span> and
b08e3be5dbfba22719ae9c428bd6853ac6f09798Mark Andrews <span><strong class="command">"none"</strong></span>.
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews Mode <span><strong class="command">"full"</strong></span> checks that MX records
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews refer to A or AAAA record (both in-zone and out-of-zone
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews hostnames). Mode <span><strong class="command">"local"</strong></span> only
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews checks MX records which refer to in-zone hostnames.
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews Mode <span><strong class="command">"full"</strong></span> checks that SRV records
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews refer to A or AAAA record (both in-zone and out-of-zone
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews hostnames). Mode <span><strong class="command">"local"</strong></span> only
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews checks SRV records which refer to in-zone hostnames.
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews Mode <span><strong class="command">"full"</strong></span> checks that delegation NS
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews records refer to A or AAAA record (both in-zone and out-of-zone
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews hostnames). It also checks that glue address records
b08e3be5dbfba22719ae9c428bd6853ac6f09798Mark Andrews in the zone match those advertised by the child.
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews Mode <span><strong class="command">"local"</strong></span> only checks NS records which
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews refer to in-zone hostnames or that some required glue exists,
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews that is when the nameserver is in a child zone.
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews Mode <span><strong class="command">"full-sibling"</strong></span> and
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews <span><strong class="command">"local-sibling"</strong></span> disable sibling glue
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews checks but are otherwise the same as <span><strong class="command">"full"</strong></span>
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews and <span><strong class="command">"local"</strong></span> respectively.
d6dc0d4f584352d2e4305435599ae8c93776d9b4Mark Andrews Mode <span><strong class="command">"none"</strong></span> disables the checks.
d6dc0d4f584352d2e4305435599ae8c93776d9b4Mark Andrews<dt><span class="term">-f <em class="replaceable"><code>format</code></em></span></dt>
d6dc0d4f584352d2e4305435599ae8c93776d9b4Mark Andrews Specify the format of the zone file.
b08e3be5dbfba22719ae9c428bd6853ac6f09798Mark Andrews Possible formats are <span><strong class="command">"text"</strong></span> (default),
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews <span><strong class="command">"raw"</strong></span>, and <span><strong class="command">"fast"</strong></span>.
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews<dt><span class="term">-F <em class="replaceable"><code>format</code></em></span></dt>
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews Specify the format of the output file specified.
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews For <span><strong class="command">named-checkzone</strong></span>,
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews this does not cause any effects unless it dumps the zone
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews Possible formats are <span><strong class="command">"text"</strong></span> (default),
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews which is the standard textual representation of the zone,
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews and <span><strong class="command">"fast"</strong></span>, <span><strong class="command">"raw"</strong></span>,
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews and <span><strong class="command">"raw=N"</strong></span>, which store the zone in a
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews binary format for rapid loading by <span><strong class="command">named</strong></span>.
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews <span><strong class="command">"raw=N"</strong></span> specifies the format version of
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews the raw zone file: if N is 0, the raw file can be read by
b08e3be5dbfba22719ae9c428bd6853ac6f09798Mark Andrews any version of <span><strong class="command">named</strong></span>; if N is 1, the file
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews can be read by release 9.9.0 or higher; the default is 1.
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews<dt><span class="term">-k <em class="replaceable"><code>mode</code></em></span></dt>
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews Perform <span><strong class="command">"check-names"</strong></span> checks with the
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews specified failure mode.
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews Possible modes are <span><strong class="command">"fail"</strong></span>
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews (default for <span><strong class="command">named-compilezone</strong></span>),
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews <span><strong class="command">"warn"</strong></span>
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews (default for <span><strong class="command">named-checkzone</strong></span>) and
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews <span><strong class="command">"ignore"</strong></span>.
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews<dt><span class="term">-L <em class="replaceable"><code>serial</code></em></span></dt>
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews When compiling a zone to "raw" or "fast" format, set the
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews "source serial" value in the header to the specified serial
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews number. (This is expected to be used primarily for testing
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews<dt><span class="term">-m <em class="replaceable"><code>mode</code></em></span></dt>
b08e3be5dbfba22719ae9c428bd6853ac6f09798Mark Andrews Specify whether MX records should be checked to see if they
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews are addresses. Possible modes are <span><strong class="command">"fail"</strong></span>,
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews <span><strong class="command">"warn"</strong></span> (default) and
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews <span><strong class="command">"ignore"</strong></span>.
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews<dt><span class="term">-M <em class="replaceable"><code>mode</code></em></span></dt>
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews Check if a MX record refers to a CNAME.
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews Possible modes are <span><strong class="command">"fail"</strong></span>,
d9b4174233b951f25cd53a2787b9f14314258c2fMark Andrews <span><strong class="command">"warn"</strong></span> (default) and
b08e3be5dbfba22719ae9c428bd6853ac6f09798Mark Andrews <span><strong class="command">"ignore"</strong></span>.
f91671c7dc877a52adc06d0a7d0ed1c7f6391e6eMark Andrews<dt><span class="term">-n <em class="replaceable"><code>mode</code></em></span></dt>