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