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