man.named-checkzone.html revision 350e5eecadfc5ee72b11b2cc46828c9a0bcd717c
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass - Copyright (C) 2000-2017 Internet Systems Consortium, Inc. ("ISC")
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass - This Source Code Form is subject to the terms of the Mozilla Public
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass - License, v. 2.0. If a copy of the MPL was not distributed with this
60c539309fbe4309d779f7fecd9af50beae463a9Dav Glass - file, You can obtain one at http://mozilla.org/MPL/2.0/.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass<link rel="home" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual">
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass<link rel="up" href="Bv9ARM.ch13.html" title="Manual pages">
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass<link rel="prev" href="man.named-checkconf.html" title="named-checkconf">
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass<link rel="next" href="man.named-journalprint.html" title="named-journalprint">
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass<tr><th colspan="3" align="center"><span class="application">named-checkzone</span></th></tr>
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass<a accesskey="p" href="man.named-checkconf.html">Prev</a>�</td>
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass<td width="20%" align="right">�<a accesskey="n" href="man.named-journalprint.html">Next</a>
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass<a name="man.named-checkzone"></a><div class="titlepage"></div>
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass <span class="application">named-compilezone</span>
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass — zone file validity checking or converting tool
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass [<code class="option">-c <em class="replaceable"><code>class</code></em></code>]
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass [<code class="option">-f <em class="replaceable"><code>format</code></em></code>]
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass [<code class="option">-F <em class="replaceable"><code>format</code></em></code>]
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass [<code class="option">-J <em class="replaceable"><code>filename</code></em></code>]
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass [<code class="option">-i <em class="replaceable"><code>mode</code></em></code>]
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass [<code class="option">-k <em class="replaceable"><code>mode</code></em></code>]
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass [<code class="option">-m <em class="replaceable"><code>mode</code></em></code>]
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass [<code class="option">-M <em class="replaceable"><code>mode</code></em></code>]
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass [<code class="option">-n <em class="replaceable"><code>mode</code></em></code>]
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass [<code class="option">-l <em class="replaceable"><code>ttl</code></em></code>]
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass [<code class="option">-L <em class="replaceable"><code>serial</code></em></code>]
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass [<code class="option">-o <em class="replaceable"><code>filename</code></em></code>]
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass [<code class="option">-r <em class="replaceable"><code>mode</code></em></code>]
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass [<code class="option">-s <em class="replaceable"><code>style</code></em></code>]
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass [<code class="option">-S <em class="replaceable"><code>mode</code></em></code>]
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass [<code class="option">-t <em class="replaceable"><code>directory</code></em></code>]
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass [<code class="option">-T <em class="replaceable"><code>mode</code></em></code>]
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass [<code class="option">-w <em class="replaceable"><code>directory</code></em></code>]
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass [<code class="option">-W <em class="replaceable"><code>mode</code></em></code>]
71c7ae1e1da58359704293bbb8df26fed4e40576Dav Glass [<code class="option">-c <em class="replaceable"><code>class</code></em></code>]
33a04233c7a32ec1ac1b5d5991097fe0b099e87bDav Glass [<code class="option">-C <em class="replaceable"><code>mode</code></em></code>]
33a04233c7a32ec1ac1b5d5991097fe0b099e87bDav Glass [<code class="option">-f <em class="replaceable"><code>format</code></em></code>]
71c7ae1e1da58359704293bbb8df26fed4e40576Dav Glass [<code class="option">-F <em class="replaceable"><code>format</code></em></code>]
1d01372aa06d46fcbeeae1718c35cf404f412a85Dav Glass [<code class="option">-J <em class="replaceable"><code>filename</code></em></code>]
1d01372aa06d46fcbeeae1718c35cf404f412a85Dav Glass [<code class="option">-i <em class="replaceable"><code>mode</code></em></code>]
71c7ae1e1da58359704293bbb8df26fed4e40576Dav Glass [<code class="option">-k <em class="replaceable"><code>mode</code></em></code>]
71c7ae1e1da58359704293bbb8df26fed4e40576Dav Glass [<code class="option">-m <em class="replaceable"><code>mode</code></em></code>]
71c7ae1e1da58359704293bbb8df26fed4e40576Dav Glass [<code class="option">-n <em class="replaceable"><code>mode</code></em></code>]
71c7ae1e1da58359704293bbb8df26fed4e40576Dav Glass [<code class="option">-l <em class="replaceable"><code>ttl</code></em></code>]
1d01372aa06d46fcbeeae1718c35cf404f412a85Dav Glass [<code class="option">-L <em class="replaceable"><code>serial</code></em></code>]
71c7ae1e1da58359704293bbb8df26fed4e40576Dav Glass [<code class="option">-r <em class="replaceable"><code>mode</code></em></code>]
71c7ae1e1da58359704293bbb8df26fed4e40576Dav Glass [<code class="option">-s <em class="replaceable"><code>style</code></em></code>]
71c7ae1e1da58359704293bbb8df26fed4e40576Dav Glass [<code class="option">-t <em class="replaceable"><code>directory</code></em></code>]
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass [<code class="option">-T <em class="replaceable"><code>mode</code></em></code>]
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass [<code class="option">-w <em class="replaceable"><code>directory</code></em></code>]
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass [<code class="option">-W <em class="replaceable"><code>mode</code></em></code>]
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass {<code class="option">-o <em class="replaceable"><code>filename</code></em></code>}
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass <p><span class="command"><strong>named-checkzone</strong></span>
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass checks the syntax and integrity of a zone file. It performs the
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass same checks as <span class="command"><strong>named</strong></span> does when loading a
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass zone. This makes <span class="command"><strong>named-checkzone</strong></span> useful for
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass checking zone files before configuring them into a name server.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass <span class="command"><strong>named-compilezone</strong></span> is similar to
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass <span class="command"><strong>named-checkzone</strong></span>, but it always dumps the
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass zone contents to a specified file in a specified format.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass Additionally, it applies stricter check levels by default,
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass since the dump output will be used as an actual zone file
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass loaded by <span class="command"><strong>named</strong></span>.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass When manually specified otherwise, the check levels must at
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass least be as strict as those specified in the
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass <span class="command"><strong>named</strong></span> configuration file.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass <div class="variablelist"><dl class="variablelist">
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass Enable debugging.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass Print the usage summary and exit.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass Quiet mode - exit code only.
1d01372aa06d46fcbeeae1718c35cf404f412a85Dav Glass Print the version of the <span class="command"><strong>named-checkzone</strong></span>
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass program and exit.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass When loading a zone file, read the journal if it exists.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass The journal file name is assumed to be the zone file name
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass appended with the string <code class="filename">.jnl</code>.
ccdd0fb5433f464069314b58d7a7e4382ece41e3Dav Glass<dt><span class="term">-J <em class="replaceable"><code>filename</code></em></span></dt>
ccdd0fb5433f464069314b58d7a7e4382ece41e3Dav Glass When loading the zone file read the journal from the given
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass file, if it exists. (Implies -j.)
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass<dt><span class="term">-c <em class="replaceable"><code>class</code></em></span></dt>
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass Specify the class of the zone. If not specified, "IN" is assumed.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass<dt><span class="term">-i <em class="replaceable"><code>mode</code></em></span></dt>
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass Perform post-load zone integrity checks. Possible modes are
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass <span class="command"><strong>"full"</strong></span> (default),
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass <span class="command"><strong>"full-sibling"</strong></span>,
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass <span class="command"><strong>"local"</strong></span>,
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass <span class="command"><strong>"local-sibling"</strong></span> and
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass <span class="command"><strong>"none"</strong></span>.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass Mode <span class="command"><strong>"full"</strong></span> checks that MX records
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass refer to A or AAAA record (both in-zone and out-of-zone
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass hostnames). Mode <span class="command"><strong>"local"</strong></span> only
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass checks MX records which refer to in-zone hostnames.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass Mode <span class="command"><strong>"full"</strong></span> checks that SRV records
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass refer to A or AAAA record (both in-zone and out-of-zone
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass hostnames). Mode <span class="command"><strong>"local"</strong></span> only
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass checks SRV records which refer to in-zone hostnames.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass Mode <span class="command"><strong>"full"</strong></span> checks that delegation NS
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass records refer to A or AAAA record (both in-zone and out-of-zone
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass hostnames). It also checks that glue address records
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass in the zone match those advertised by the child.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass Mode <span class="command"><strong>"local"</strong></span> only checks NS records which
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass refer to in-zone hostnames or that some required glue exists,
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass that is when the nameserver is in a child zone.
a7bfbc38da14c7b64b89386f1a4925daf1eba990Dav Glass Mode <span class="command"><strong>"full-sibling"</strong></span> and
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass <span class="command"><strong>"local-sibling"</strong></span> disable sibling glue
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass checks but are otherwise the same as <span class="command"><strong>"full"</strong></span>
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass and <span class="command"><strong>"local"</strong></span> respectively.
a7bfbc38da14c7b64b89386f1a4925daf1eba990Dav Glass Mode <span class="command"><strong>"none"</strong></span> disables the checks.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass<dt><span class="term">-f <em class="replaceable"><code>format</code></em></span></dt>
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass Specify the format of the zone file.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass Possible formats are <span class="command"><strong>"text"</strong></span> (default),
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass <span class="command"><strong>"raw"</strong></span>, and <span class="command"><strong>"map"</strong></span>.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass<dt><span class="term">-F <em class="replaceable"><code>format</code></em></span></dt>
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass Specify the format of the output file specified.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass For <span class="command"><strong>named-checkzone</strong></span>,
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass this does not cause any effects unless it dumps the zone
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass Possible formats are <span class="command"><strong>"text"</strong></span> (default),
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass which is the standard textual representation of the zone,
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass and <span class="command"><strong>"map"</strong></span>, <span class="command"><strong>"raw"</strong></span>,
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass and <span class="command"><strong>"raw=N"</strong></span>, which store the zone in a
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass binary format for rapid loading by <span class="command"><strong>named</strong></span>.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass <span class="command"><strong>"raw=N"</strong></span> specifies the format version of
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass the raw zone file: if N is 0, the raw file can be read by
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass any version of <span class="command"><strong>named</strong></span>; if N is 1, the file
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass can be read by release 9.9.0 or higher; the default is 1.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass<dt><span class="term">-k <em class="replaceable"><code>mode</code></em></span></dt>
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass Perform <span class="command"><strong>"check-names"</strong></span> checks with the
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass specified failure mode.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass Possible modes are <span class="command"><strong>"fail"</strong></span>
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass (default for <span class="command"><strong>named-compilezone</strong></span>),
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass <span class="command"><strong>"warn"</strong></span>
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass (default for <span class="command"><strong>named-checkzone</strong></span>) and
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass <span class="command"><strong>"ignore"</strong></span>.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass<dt><span class="term">-l <em class="replaceable"><code>ttl</code></em></span></dt>
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass Sets a maximum permissible TTL for the input file.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass Any record with a TTL higher than this value will cause
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass the zone to be rejected. This is similar to using the
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass <span class="command"><strong>max-zone-ttl</strong></span> option in
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass<dt><span class="term">-L <em class="replaceable"><code>serial</code></em></span></dt>
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass When compiling a zone to "raw" or "map" format, set the
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass "source serial" value in the header to the specified serial
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass number. (This is expected to be used primarily for testing
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass<dt><span class="term">-m <em class="replaceable"><code>mode</code></em></span></dt>
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass Specify whether MX records should be checked to see if they
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass are addresses. Possible modes are <span class="command"><strong>"fail"</strong></span>,
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass <span class="command"><strong>"warn"</strong></span> (default) and
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass <span class="command"><strong>"ignore"</strong></span>.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass<dt><span class="term">-M <em class="replaceable"><code>mode</code></em></span></dt>
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass Check if a MX record refers to a CNAME.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass Possible modes are <span class="command"><strong>"fail"</strong></span>,
99c4d05a4bdb506516f0dca00fc8bf4b86c93bd1Dav Glass <span class="command"><strong>"warn"</strong></span> (default) and
<p xmlns:db="http://docbook.org/ns/docbook" style="text-align: center;">BIND 9.11.2 (Extended Support Version)</p>