named-checkzone.html revision 7be2f6d5df28b207e3e385c555eb4f740150528d
d6fa26d0adaec6c910115be34fe7a5a5f402c14fMark Andrews<!--
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews - Copyright (C) 2004-2007, 2009-2013 Internet Systems Consortium, Inc. ("ISC")
71cef386fae61275b03e203825680b39fedaa8c6Tinderbox User - Copyright (C) 2000-2002 Internet Software Consortium.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews -
5347c0fcb04eaea19d9f39795646239f487c6207Tinderbox User - Permission to use, copy, modify, and/or distribute this software for any
5347c0fcb04eaea19d9f39795646239f487c6207Tinderbox User - purpose with or without fee is hereby granted, provided that the above
5347c0fcb04eaea19d9f39795646239f487c6207Tinderbox User - copyright notice and this permission notice appear in all copies.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews -
d6fa26d0adaec6c910115be34fe7a5a5f402c14fMark Andrews - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
cd32f419a8a5432fbb139f56ee73cbf68b9350ccTinderbox User - PERFORMANCE OF THIS SOFTWARE.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews-->
9b469e3c59015b1a4899c9d8395168126fe094fdAutomatic Updater<!-- $Id$ -->
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<html>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<head>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<title>named-checkzone</title>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<meta name="generator" content="DocBook XSL Stylesheets V1.71.1">
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews</head>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en">
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<a name="man.named-checkzone"></a><div class="titlepage"></div>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<div class="refnamediv">
9b469e3c59015b1a4899c9d8395168126fe094fdAutomatic Updater<h2>Name</h2>
9b469e3c59015b1a4899c9d8395168126fe094fdAutomatic Updater<p><span class="application">named-checkzone</span>, <span class="application">named-compilezone</span> &#8212; zone file validity checking or converting tool</p>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews</div>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<div class="refsynopsisdiv">
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<h2>Synopsis</h2>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark 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">-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>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<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">-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>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews</div>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<div class="refsect1" lang="en">
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<a name="id2543756"></a><h2>DESCRIPTION</h2>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<p><span><strong class="command">named-checkzone</strong></span>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User checks the syntax and integrity of a zone file. It performs the
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User same checks as <span><strong class="command">named</strong></span> does when loading a
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User zone. This makes <span><strong class="command">named-checkzone</strong></span> useful for
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews checking zone files before configuring them into a name server.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User </p>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<p>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <span><strong class="command">named-compilezone</strong></span> is similar to
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <span><strong class="command">named-checkzone</strong></span>, but it always dumps the
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews zone contents to a specified file in a specified format.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User Additionally, it applies stricter check levels by default,
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User since the dump output will be used as an actual zone file
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User loaded by <span><strong class="command">named</strong></span>.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User When manually specified otherwise, the check levels must at
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews least be as strict as those specified in the
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <span><strong class="command">named</strong></span> configuration file.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User </p>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User</div>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<div class="refsect1" lang="en">
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<a name="id2543792"></a><h2>OPTIONS</h2>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<div class="variablelist"><dl>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<dt><span class="term">-d</span></dt>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<dd><p>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User Enable debugging.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User </p></dd>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<dt><span class="term">-h</span></dt>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<dd><p>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User Print the usage summary and exit.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User </p></dd>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<dt><span class="term">-q</span></dt>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<dd><p>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User Quiet mode - exit code only.
7e71f05d8643aca84914437c900cb716444507e4Tinderbox User </p></dd>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<dt><span class="term">-v</span></dt>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<dd><p>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews Print the version of the <span><strong class="command">named-checkzone</strong></span>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt program and exit.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </p></dd>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<dt><span class="term">-j</span></dt>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<dd><p>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt When loading a zone file, read the journal if it exists.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews The journal file name is assumed to be the zone file name
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt appended with the string <code class="filename">.jnl</code>.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </p></dd>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<dt><span class="term">-J <em class="replaceable"><code>filename</code></em></span></dt>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<dd><p>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews When loading the zone file read the journal from the given
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User file, if it exists. (Implies -j.)
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User </p></dd>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<dt><span class="term">-c <em class="replaceable"><code>class</code></em></span></dt>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<dd><p>
7e71f05d8643aca84914437c900cb716444507e4Tinderbox User Specify the class of the zone. If not specified, "IN" is assumed.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User </p></dd>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<dt><span class="term">-i <em class="replaceable"><code>mode</code></em></span></dt>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<dd>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<p>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews Perform post-load zone integrity checks. Possible modes are
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <span><strong class="command">"full"</strong></span> (default),
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <span><strong class="command">"full-sibling"</strong></span>,
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <span><strong class="command">"local"</strong></span>,
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <span><strong class="command">"local-sibling"</strong></span> and
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <span><strong class="command">"none"</strong></span>.
71c66a876ecca77923638d3f94cc0783152b2f03Mark Andrews </p>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<p>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt Mode <span><strong class="command">"full"</strong></span> checks that MX records
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt refer to A or AAAA record (both in-zone and out-of-zone
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews hostnames). Mode <span><strong class="command">"local"</strong></span> only
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews checks MX records which refer to in-zone hostnames.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt </p>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<p>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews Mode <span><strong class="command">"full"</strong></span> checks that SRV records
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews refer to A or AAAA record (both in-zone and out-of-zone
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User hostnames). Mode <span><strong class="command">"local"</strong></span> only
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt checks SRV records which refer to in-zone hostnames.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt </p>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<p>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt Mode <span><strong class="command">"full"</strong></span> checks that delegation NS
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews records refer to A or AAAA record (both in-zone and out-of-zone
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews hostnames). It also checks that glue address records
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews in the zone match those advertised by the child.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User Mode <span><strong class="command">"local"</strong></span> only checks NS records which
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews refer to in-zone hostnames or that some required glue exists,
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt that is when the nameserver is in a child zone.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </p>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<p>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews Mode <span><strong class="command">"full-sibling"</strong></span> and
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <span><strong class="command">"local-sibling"</strong></span> disable sibling glue
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews checks but are otherwise the same as <span><strong class="command">"full"</strong></span>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews and <span><strong class="command">"local"</strong></span> respectively.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </p>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<p>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User Mode <span><strong class="command">"none"</strong></span> disables the checks.
b2f07642fd712c8fda81a116bcdde229ab291f33Tinderbox User </p>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User</dd>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<dt><span class="term">-f <em class="replaceable"><code>format</code></em></span></dt>
b2f07642fd712c8fda81a116bcdde229ab291f33Tinderbox User<dd><p>
b2f07642fd712c8fda81a116bcdde229ab291f33Tinderbox User Specify the format of the zone file.
281ed127e3ed6c7e07792c19c3bc4562f71cfa90Tinderbox User Possible formats are <span><strong class="command">"text"</strong></span> (default),
281ed127e3ed6c7e07792c19c3bc4562f71cfa90Tinderbox User <span><strong class="command">"raw"</strong></span>, and <span><strong class="command">"map"</strong></span>.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User </p></dd>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<dt><span class="term">-F <em class="replaceable"><code>format</code></em></span></dt>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<dd>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<p>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User Specify the format of the output file specified.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews For <span><strong class="command">named-checkzone</strong></span>,
b2f07642fd712c8fda81a116bcdde229ab291f33Tinderbox User this does not cause any effects unless it dumps the zone
b2f07642fd712c8fda81a116bcdde229ab291f33Tinderbox User contents.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User </p>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<p>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews Possible formats are <span><strong class="command">"text"</strong></span> (default),
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User which is the standard textual representation of the zone,
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User and <span><strong class="command">"map"</strong></span>, <span><strong class="command">"raw"</strong></span>,
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt and <span><strong class="command">"raw=N"</strong></span>, which store the zone in a
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews binary format for rapid loading by <span><strong class="command">named</strong></span>.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <span><strong class="command">"raw=N"</strong></span> specifies the format version of
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User the raw zone file: if N is 0, the raw file can be read by
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews any version of <span><strong class="command">named</strong></span>; if N is 1, the file
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User can be read by release 9.9.0 or higher; the default is 1.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User </p>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews</dd>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<dt><span class="term">-k <em class="replaceable"><code>mode</code></em></span></dt>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<dd><p>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User Perform <span><strong class="command">"check-names"</strong></span> checks with the
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews specified failure mode.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User Possible modes are <span><strong class="command">"fail"</strong></span>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User (default for <span><strong class="command">named-compilezone</strong></span>),
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <span><strong class="command">"warn"</strong></span>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews (default for <span><strong class="command">named-checkzone</strong></span>) and
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <span><strong class="command">"ignore"</strong></span>.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User </p></dd>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<dt><span class="term">-L <em class="replaceable"><code>serial</code></em></span></dt>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<dd><p>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User When compiling a zone to "raw" or "map" format, set the
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User "source serial" value in the header to the specified serial
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt number. (This is expected to be used primarily for testing
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt purposes.)
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </p></dd>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<dt><span class="term">-m <em class="replaceable"><code>mode</code></em></span></dt>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<dd><p>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews Specify whether MX records should be checked to see if they
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User are addresses. Possible modes are <span><strong class="command">"fail"</strong></span>,
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <span><strong class="command">"warn"</strong></span> (default) and
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <span><strong class="command">"ignore"</strong></span>.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </p></dd>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<dt><span class="term">-M <em class="replaceable"><code>mode</code></em></span></dt>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<dd><p>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews Check if a MX record refers to a CNAME.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews Possible modes are <span><strong class="command">"fail"</strong></span>,
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <span><strong class="command">"warn"</strong></span> (default) and
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <span><strong class="command">"ignore"</strong></span>.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </p></dd>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<dt><span class="term">-n <em class="replaceable"><code>mode</code></em></span></dt>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<dd><p>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User Specify whether NS records should be checked to see if they
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews are addresses.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User Possible modes are <span><strong class="command">"fail"</strong></span>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User (default for <span><strong class="command">named-compilezone</strong></span>),
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <span><strong class="command">"warn"</strong></span>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews (default for <span><strong class="command">named-checkzone</strong></span>) and
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <span><strong class="command">"ignore"</strong></span>.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </p></dd>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<dt><span class="term">-o <em class="replaceable"><code>filename</code></em></span></dt>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<dd><p>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews Write zone output to <code class="filename">filename</code>.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User If <code class="filename">filename</code> is <code class="filename">-</code> then
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User write to standard out.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt This is mandatory for <span><strong class="command">named-compilezone</strong></span>.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt </p></dd>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<dt><span class="term">-r <em class="replaceable"><code>mode</code></em></span></dt>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<dd><p>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt Check for records that are treated as different by DNSSEC but
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User are semantically equal in plain DNS.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User Possible modes are <span><strong class="command">"fail"</strong></span>,
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <span><strong class="command">"warn"</strong></span> (default) and
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <span><strong class="command">"ignore"</strong></span>.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User </p></dd>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<dt><span class="term">-s <em class="replaceable"><code>style</code></em></span></dt>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<dd><p>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews Specify the style of the dumped zone file.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews Possible styles are <span><strong class="command">"full"</strong></span> (default)
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt and <span><strong class="command">"relative"</strong></span>.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews The full format is most suitable for processing
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews automatically by a separate script.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User On the other hand, the relative format is more
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User human-readable and is thus suitable for editing by hand.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews For <span><strong class="command">named-checkzone</strong></span>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User this does not cause any effects unless it dumps the zone
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User contents.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User It also does not have any meaning if the output format
7e71f05d8643aca84914437c900cb716444507e4Tinderbox User is not text.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User </p></dd>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<dt><span class="term">-S <em class="replaceable"><code>mode</code></em></span></dt>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<dd><p>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews Check if a SRV record refers to a CNAME.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews Possible modes are <span><strong class="command">"fail"</strong></span>,
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <span><strong class="command">"warn"</strong></span> (default) and
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <span><strong class="command">"ignore"</strong></span>.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User </p></dd>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<dt><span class="term">-t <em class="replaceable"><code>directory</code></em></span></dt>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<dd><p>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews Chroot to <code class="filename">directory</code> so that
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews include
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews directives in the configuration file are processed as if
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User run by a similarly chrooted named.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </p></dd>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<dt><span class="term">-T <em class="replaceable"><code>mode</code></em></span></dt>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<dd><p>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User Check if Sender Policy Framework records (TXT and SPF)
7e71f05d8643aca84914437c900cb716444507e4Tinderbox User both exist or both don't exist. A warning is issued
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User if they don't match. Possible modes are
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <span><strong class="command">"warn"</strong></span> (default), <span><strong class="command">"ignore"</strong></span>.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User </p></dd>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<dt><span class="term">-w <em class="replaceable"><code>directory</code></em></span></dt>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<dd><p>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User chdir to <code class="filename">directory</code> so that
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User relative
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User filenames in master file $INCLUDE directives work. This
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User is similar to the directory clause in
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <code class="filename">named.conf</code>.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </p></dd>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<dt><span class="term">-D</span></dt>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<dd><p>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User Dump zone file in canonical format.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews This is always enabled for <span><strong class="command">named-compilezone</strong></span>.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </p></dd>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<dt><span class="term">-W <em class="replaceable"><code>mode</code></em></span></dt>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<dd><p>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews Specify whether to check for non-terminal wildcards.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews Non-terminal wildcards are almost always the result of a
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews failure to understand the wildcard matching algorithm (RFC 1034).
cd32f419a8a5432fbb139f56ee73cbf68b9350ccTinderbox User Possible modes are <span><strong class="command">"warn"</strong></span> (default)
9b469e3c59015b1a4899c9d8395168126fe094fdAutomatic Updater and
9b469e3c59015b1a4899c9d8395168126fe094fdAutomatic Updater <span><strong class="command">"ignore"</strong></span>.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </p></dd>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<dt><span class="term">zonename</span></dt>
4abdfc917e6635a7c81d1f931a0c79227e72d025Mark Andrews<dd><p>
4abdfc917e6635a7c81d1f931a0c79227e72d025Mark Andrews The domain name of the zone being checked.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </p></dd>
9b469e3c59015b1a4899c9d8395168126fe094fdAutomatic Updater<dt><span class="term">filename</span></dt>
9b469e3c59015b1a4899c9d8395168126fe094fdAutomatic Updater<dd><p>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews The name of the zone file.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </p></dd>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews</dl></div>
c313914d0e66b20969215e519bbf2ab4ecf39512Tinderbox User</div>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<div class="refsect1" lang="en">
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<a name="id2544659"></a><h2>RETURN VALUES</h2>
<p><span><strong class="command">named-checkzone</strong></span>
returns an exit status of 1 if
errors were detected and 0 otherwise.
</p>
</div>
<div class="refsect1" lang="en">
<a name="id2544670"></a><h2>SEE ALSO</h2>
<p><span class="citerefentry"><span class="refentrytitle">named</span>(8)</span>,
<span class="citerefentry"><span class="refentrytitle">named-checkconf</span>(8)</span>,
<em class="citetitle">RFC 1035</em>,
<em class="citetitle">BIND 9 Administrator Reference Manual</em>.
</p>
</div>
<div class="refsect1" lang="en">
<a name="id2544704"></a><h2>AUTHOR</h2>
<p><span class="corpauthor">Internet Systems Consortium</span>
</p>
</div>
</div></body>
</html>