man.named-checkzone.html revision 0ccb0e98c77a9b9636a036f8f64f5679a430aaf4
1633838b8255282d10af15c5c84cee5a51466712Bob Halley<!--
236a983ca3e967ebde379abae6dd621290056732Tinderbox User - Copyright (C) 2004-2013 Internet Systems Consortium, Inc. ("ISC")
40f53fa8d9c6a4fc38c0014495e7a42b08f52481David Lawrence - Copyright (C) 2000-2003 Internet Software Consortium.
0c27b3fe77ac1d5094ba3521e8142d9e7973133fMark Andrews -
0c27b3fe77ac1d5094ba3521e8142d9e7973133fMark Andrews - Permission to use, copy, modify, and/or distribute this software for any
0c27b3fe77ac1d5094ba3521e8142d9e7973133fMark Andrews - purpose with or without fee is hereby granted, provided that the above
1633838b8255282d10af15c5c84cee5a51466712Bob Halley - copyright notice and this permission notice appear in all copies.
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley -
9cee5bb02863bf191e12cd4297adabf1971020deAutomatic Updater - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
9c3531d72aeaad6c5f01efe6a1c82023e1379e4dDavid Lawrence - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley - PERFORMANCE OF THIS SOFTWARE.
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley-->
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley<!-- $Id$ -->
29747dfe5e073a299b3681e01f5c55540f8bfed7Mark Andrews<html>
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein<head>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley<title>named-checkzone</title>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley<meta name="generator" content="DocBook XSL Stylesheets V1.71.1">
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley<link rel="start" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual">
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley<link rel="up" href="Bv9ARM.ch10.html" title="Manual pages">
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley<link rel="prev" href="man.named-checkconf.html" title="named-checkconf">
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley<link rel="next" href="man.named.html" title="named">
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley</head>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley<div class="navheader">
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley<table width="100%" summary="Navigation header">
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley<tr><th colspan="3" align="center"><span class="application">named-checkzone</span></th></tr>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley<tr>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley<td width="20%" align="left">
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley<a accesskey="p" href="man.named-checkconf.html">Prev</a>�</td>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley<th width="60%" align="center">Manual pages</th>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley<td width="20%" align="right">�<a accesskey="n" href="man.named.html">Next</a>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley</td>
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein</tr>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley</table>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley<hr>
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein</div>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley<div class="refentry" lang="en">
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley<a name="man.named-checkzone"></a><div class="titlepage"></div>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley<div class="refnamediv">
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein<h2>Name</h2>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley<p><span class="application">named-checkzone</span>, <span class="application">named-compilezone</span> &#8212; zone file validity checking or converting tool</p>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley</div>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley<div class="refsynopsisdiv">
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein<h2>Synopsis</h2>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley<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>
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein<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>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley</div>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley<div class="refsect1" lang="en">
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley<a name="id2671598"></a><h2>DESCRIPTION</h2>
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein<p><span><strong class="command">named-checkzone</strong></span>
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein checks the syntax and integrity of a zone file. It performs the
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein same checks as <span><strong class="command">named</strong></span> does when loading a
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley zone. This makes <span><strong class="command">named-checkzone</strong></span> useful for
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley checking zone files before configuring them into a name server.
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley </p>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley<p>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley <span><strong class="command">named-compilezone</strong></span> is similar to
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley <span><strong class="command">named-checkzone</strong></span>, but it always dumps the
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley zone contents to a specified file in a specified format.
1a69a1a78cfaa86f3b68bbc965232b7876d4da2aDavid Lawrence Additionally, it applies stricter check levels by default,
1a69a1a78cfaa86f3b68bbc965232b7876d4da2aDavid Lawrence since the dump output will be used as an actual zone file
1a69a1a78cfaa86f3b68bbc965232b7876d4da2aDavid Lawrence loaded by <span><strong class="command">named</strong></span>.
904a5734375869ffb504ed8cde6b68cafadb6d64Bob Halley When manually specified otherwise, the check levels must at
28fc90e6c81338c5f34e065fdda49d320e362583Mark Andrews least be as strict as those specified in the
1a69a1a78cfaa86f3b68bbc965232b7876d4da2aDavid Lawrence <span><strong class="command">named</strong></span> configuration file.
38d2d0e9326a2f70b5893302b89a26978b539405Bob Halley </p>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley</div>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley<div class="refsect1" lang="en">
904a5734375869ffb504ed8cde6b68cafadb6d64Bob Halley<a name="id2671649"></a><h2>OPTIONS</h2>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley<div class="variablelist"><dl>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley<dt><span class="term">-d</span></dt>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley<dd><p>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley Enable debugging.
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley </p></dd>
b6309ed962c4988a314d61742c4fbc4935467d68Mark Andrews<dt><span class="term">-h</span></dt>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley<dd><p>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley Print the usage summary and exit.
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley </p></dd>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley<dt><span class="term">-q</span></dt>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley<dd><p>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley Quiet mode - exit code only.
b6309ed962c4988a314d61742c4fbc4935467d68Mark Andrews </p></dd>
b6309ed962c4988a314d61742c4fbc4935467d68Mark Andrews<dt><span class="term">-v</span></dt>
b6309ed962c4988a314d61742c4fbc4935467d68Mark Andrews<dd><p>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley Print the version of the <span><strong class="command">named-checkzone</strong></span>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley program and exit.
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley </p></dd>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley<dt><span class="term">-j</span></dt>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley<dd><p>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley When loading a zone file, read the journal if it exists.
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein The journal file name is assumed to be the zone file name
d57fd9900a443550dd5f33604e530ef6a7ae3cc4Bob Halley appended with the string <code class="filename">.jnl</code>.
d57fd9900a443550dd5f33604e530ef6a7ae3cc4Bob Halley </p></dd>
d57fd9900a443550dd5f33604e530ef6a7ae3cc4Bob Halley<dt><span class="term">-J <em class="replaceable"><code>filename</code></em></span></dt>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley<dd><p>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley When loading the zone file read the journal from the given
d57fd9900a443550dd5f33604e530ef6a7ae3cc4Bob Halley file, if it exists. (Implies -j.)
d57fd9900a443550dd5f33604e530ef6a7ae3cc4Bob Halley </p></dd>
d57fd9900a443550dd5f33604e530ef6a7ae3cc4Bob Halley<dt><span class="term">-c <em class="replaceable"><code>class</code></em></span></dt>
d57fd9900a443550dd5f33604e530ef6a7ae3cc4Bob Halley<dd><p>
c5839c39bd07c9dd3d4cd598035deb0537098475Bob Halley Specify the class of the zone. If not specified, "IN" is assumed.
d57fd9900a443550dd5f33604e530ef6a7ae3cc4Bob Halley </p></dd>
ce3761f64d3d734cc94605026985898900ecc474Bob Halley<dt><span class="term">-i <em class="replaceable"><code>mode</code></em></span></dt>
d57fd9900a443550dd5f33604e530ef6a7ae3cc4Bob Halley<dd>
14bc0e48c967fa7b4d625b5d515afb84bc2ee3c9Michael Graff<p>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley Perform post-load zone integrity checks. Possible modes are
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley <span><strong class="command">"full"</strong></span> (default),
28fc90e6c81338c5f34e065fdda49d320e362583Mark Andrews <span><strong class="command">"full-sibling"</strong></span>,
048f38385eebbf5a1c68d7ce581754ebce41825cBob Halley <span><strong class="command">"local"</strong></span>,
307d2084502eddc7ce921e5ce439aec3531d90e0Tatuya JINMEI 神明達哉 <span><strong class="command">"local-sibling"</strong></span> and
307d2084502eddc7ce921e5ce439aec3531d90e0Tatuya JINMEI 神明達哉 <span><strong class="command">"none"</strong></span>.
307d2084502eddc7ce921e5ce439aec3531d90e0Tatuya JINMEI 神明達哉 </p>
307d2084502eddc7ce921e5ce439aec3531d90e0Tatuya JINMEI 神明達哉<p>
307d2084502eddc7ce921e5ce439aec3531d90e0Tatuya JINMEI 神明達哉 Mode <span><strong class="command">"full"</strong></span> checks that MX records
3b9b3c21a7d1962817dc048da1b484c3077644f1Bob Halley refer to A or AAAA record (both in-zone and out-of-zone
3b9b3c21a7d1962817dc048da1b484c3077644f1Bob Halley hostnames). Mode <span><strong class="command">"local"</strong></span> only
3b9b3c21a7d1962817dc048da1b484c3077644f1Bob Halley checks MX records which refer to in-zone hostnames.
307d2084502eddc7ce921e5ce439aec3531d90e0Tatuya JINMEI 神明達哉 </p>
307d2084502eddc7ce921e5ce439aec3531d90e0Tatuya JINMEI 神明達哉<p>
307d2084502eddc7ce921e5ce439aec3531d90e0Tatuya JINMEI 神明達哉 Mode <span><strong class="command">"full"</strong></span> checks that SRV records
307d2084502eddc7ce921e5ce439aec3531d90e0Tatuya JINMEI 神明達哉 refer to A or AAAA record (both in-zone and out-of-zone
307d2084502eddc7ce921e5ce439aec3531d90e0Tatuya JINMEI 神明達哉 hostnames). Mode <span><strong class="command">"local"</strong></span> only
307d2084502eddc7ce921e5ce439aec3531d90e0Tatuya JINMEI 神明達哉 checks SRV records which refer to in-zone hostnames.
307d2084502eddc7ce921e5ce439aec3531d90e0Tatuya JINMEI 神明達哉 </p>
307d2084502eddc7ce921e5ce439aec3531d90e0Tatuya JINMEI 神明達哉<p>
307d2084502eddc7ce921e5ce439aec3531d90e0Tatuya JINMEI 神明達哉 Mode <span><strong class="command">"full"</strong></span> checks that delegation NS
2047977ce2dfcfe3a0fa2d638c3242841310fad3Mark Andrews records refer to A or AAAA record (both in-zone and out-of-zone
307d2084502eddc7ce921e5ce439aec3531d90e0Tatuya JINMEI 神明達哉 hostnames). It also checks that glue address records
307d2084502eddc7ce921e5ce439aec3531d90e0Tatuya JINMEI 神明達哉 in the zone match those advertised by the child.
307d2084502eddc7ce921e5ce439aec3531d90e0Tatuya JINMEI 神明達哉 Mode <span><strong class="command">"local"</strong></span> only checks NS records which
2047977ce2dfcfe3a0fa2d638c3242841310fad3Mark Andrews refer to in-zone hostnames or that some required glue exists,
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein that is when the nameserver is in a child zone.
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein </p>
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein<p>
c5223c9cb7c22620d5ee6611228673e95b48a270Mark Andrews Mode <span><strong class="command">"full-sibling"</strong></span> and
c5223c9cb7c22620d5ee6611228673e95b48a270Mark Andrews <span><strong class="command">"local-sibling"</strong></span> disable sibling glue
c5839c39bd07c9dd3d4cd598035deb0537098475Bob Halley checks but are otherwise the same as <span><strong class="command">"full"</strong></span>
f621719829356f27e831507b75e88e8a655e48d8Danny Mayer and <span><strong class="command">"local"</strong></span> respectively.
e61793f0865117ad87a19d6e245bea8f3b712d1bDanny Mayer </p>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley<p>
3ed16e796dba90c96933c8a8a3f5b9404d8d3e61Mark Andrews Mode <span><strong class="command">"none"</strong></span> disables the checks.
3ed16e796dba90c96933c8a8a3f5b9404d8d3e61Mark Andrews </p>
3ed16e796dba90c96933c8a8a3f5b9404d8d3e61Mark Andrews</dd>
3ed16e796dba90c96933c8a8a3f5b9404d8d3e61Mark Andrews<dt><span class="term">-f <em class="replaceable"><code>format</code></em></span></dt>
3ed16e796dba90c96933c8a8a3f5b9404d8d3e61Mark Andrews<dd><p>
3ed16e796dba90c96933c8a8a3f5b9404d8d3e61Mark Andrews Specify the format of the zone file.
3ed16e796dba90c96933c8a8a3f5b9404d8d3e61Mark Andrews Possible formats are <span><strong class="command">"text"</strong></span> (default),
3ed16e796dba90c96933c8a8a3f5b9404d8d3e61Mark Andrews <span><strong class="command">"raw"</strong></span>, and <span><strong class="command">"map"</strong></span>.
3ed16e796dba90c96933c8a8a3f5b9404d8d3e61Mark Andrews </p></dd>
3ed16e796dba90c96933c8a8a3f5b9404d8d3e61Mark Andrews<dt><span class="term">-F <em class="replaceable"><code>format</code></em></span></dt>
3ed16e796dba90c96933c8a8a3f5b9404d8d3e61Mark Andrews<dd>
3ed16e796dba90c96933c8a8a3f5b9404d8d3e61Mark Andrews<p>
3ed16e796dba90c96933c8a8a3f5b9404d8d3e61Mark Andrews Specify the format of the output file specified.
3ed16e796dba90c96933c8a8a3f5b9404d8d3e61Mark Andrews For <span><strong class="command">named-checkzone</strong></span>,
3ed16e796dba90c96933c8a8a3f5b9404d8d3e61Mark Andrews this does not cause any effects unless it dumps the zone
3ed16e796dba90c96933c8a8a3f5b9404d8d3e61Mark Andrews contents.
3ed16e796dba90c96933c8a8a3f5b9404d8d3e61Mark Andrews </p>
3ed16e796dba90c96933c8a8a3f5b9404d8d3e61Mark Andrews<p>
3ed16e796dba90c96933c8a8a3f5b9404d8d3e61Mark Andrews Possible formats are <span><strong class="command">"text"</strong></span> (default),
3ed16e796dba90c96933c8a8a3f5b9404d8d3e61Mark Andrews which is the standard textual representation of the zone,
bc09fd1365d1a48972fa99cd6ed2aa788a28ef33Mark Andrews and <span><strong class="command">"map"</strong></span>, <span><strong class="command">"raw"</strong></span>,
bc09fd1365d1a48972fa99cd6ed2aa788a28ef33Mark Andrews and <span><strong class="command">"raw=N"</strong></span>, which store the zone in a
bc09fd1365d1a48972fa99cd6ed2aa788a28ef33Mark Andrews binary format for rapid loading by <span><strong class="command">named</strong></span>.
bc09fd1365d1a48972fa99cd6ed2aa788a28ef33Mark Andrews <span><strong class="command">"raw=N"</strong></span> specifies the format version of
bc09fd1365d1a48972fa99cd6ed2aa788a28ef33Mark Andrews the raw zone file: if N is 0, the raw file can be read by
bc09fd1365d1a48972fa99cd6ed2aa788a28ef33Mark Andrews any version of <span><strong class="command">named</strong></span>; if N is 1, the file
bc09fd1365d1a48972fa99cd6ed2aa788a28ef33Mark Andrews can be read by release 9.9.0 or higher; the default is 1.
bc09fd1365d1a48972fa99cd6ed2aa788a28ef33Mark Andrews </p>
bc09fd1365d1a48972fa99cd6ed2aa788a28ef33Mark Andrews</dd>
bc09fd1365d1a48972fa99cd6ed2aa788a28ef33Mark Andrews<dt><span class="term">-k <em class="replaceable"><code>mode</code></em></span></dt>
bc09fd1365d1a48972fa99cd6ed2aa788a28ef33Mark Andrews<dd><p>
0d2c3b604808c7096b7a89059ebbefa6718d7da2Mark Andrews Perform <span><strong class="command">"check-names"</strong></span> checks with the
bc09fd1365d1a48972fa99cd6ed2aa788a28ef33Mark Andrews specified failure mode.
bc09fd1365d1a48972fa99cd6ed2aa788a28ef33Mark Andrews Possible modes are <span><strong class="command">"fail"</strong></span>
bc09fd1365d1a48972fa99cd6ed2aa788a28ef33Mark Andrews (default for <span><strong class="command">named-compilezone</strong></span>),
bc09fd1365d1a48972fa99cd6ed2aa788a28ef33Mark Andrews <span><strong class="command">"warn"</strong></span>
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein (default for <span><strong class="command">named-checkzone</strong></span>) and
dc570b92f6cc60def4207733c7a194fbb69a4399Michael Sawyer <span><strong class="command">"ignore"</strong></span>.
dc570b92f6cc60def4207733c7a194fbb69a4399Michael Sawyer </p></dd>
dc570b92f6cc60def4207733c7a194fbb69a4399Michael Sawyer<dt><span class="term">-L <em class="replaceable"><code>serial</code></em></span></dt>
dc570b92f6cc60def4207733c7a194fbb69a4399Michael Sawyer<dd><p>
6cf369f528c4acd8182eada41ad83b8d97623db8Mark Andrews When compiling a zone to "raw" or "map" format, set the
6cf369f528c4acd8182eada41ad83b8d97623db8Mark Andrews "source serial" value in the header to the specified serial
6cf369f528c4acd8182eada41ad83b8d97623db8Mark Andrews number. (This is expected to be used primarily for testing
6cf369f528c4acd8182eada41ad83b8d97623db8Mark Andrews purposes.)
6cf369f528c4acd8182eada41ad83b8d97623db8Mark Andrews </p></dd>
6cf369f528c4acd8182eada41ad83b8d97623db8Mark Andrews<dt><span class="term">-m <em class="replaceable"><code>mode</code></em></span></dt>
6cf369f528c4acd8182eada41ad83b8d97623db8Mark Andrews<dd><p>
6cf369f528c4acd8182eada41ad83b8d97623db8Mark Andrews Specify whether MX records should be checked to see if they
6cf369f528c4acd8182eada41ad83b8d97623db8Mark Andrews are addresses. Possible modes are <span><strong class="command">"fail"</strong></span>,
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley <span><strong class="command">"warn"</strong></span> (default) and
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley <span><strong class="command">"ignore"</strong></span>.
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley </p></dd>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley<dt><span class="term">-M <em class="replaceable"><code>mode</code></em></span></dt>
6d12fdf96621801e80f3f4c2a8a569fe48766a20David Lawrence<dd><p>
6d12fdf96621801e80f3f4c2a8a569fe48766a20David Lawrence Check if a MX record refers to a CNAME.
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein Possible modes are <span><strong class="command">"fail"</strong></span>,
70fdfcd1fa7ebd059deffa9a2cecc29df96dfe52Bob Halley <span><strong class="command">"warn"</strong></span> (default) and
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley <span><strong class="command">"ignore"</strong></span>.
86131d8d7aaf1bb8b8bfc7819985d05ea369b708Bob Halley </p></dd>
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein<dt><span class="term">-n <em class="replaceable"><code>mode</code></em></span></dt>
86131d8d7aaf1bb8b8bfc7819985d05ea369b708Bob Halley<dd><p>
86131d8d7aaf1bb8b8bfc7819985d05ea369b708Bob Halley Specify whether NS records should be checked to see if they
86131d8d7aaf1bb8b8bfc7819985d05ea369b708Bob Halley are addresses.
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley Possible modes are <span><strong class="command">"fail"</strong></span>
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein (default for <span><strong class="command">named-compilezone</strong></span>),
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley <span><strong class="command">"warn"</strong></span>
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein (default for <span><strong class="command">named-checkzone</strong></span>) and
86131d8d7aaf1bb8b8bfc7819985d05ea369b708Bob Halley <span><strong class="command">"ignore"</strong></span>.
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley </p></dd>
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein<dt><span class="term">-o <em class="replaceable"><code>filename</code></em></span></dt>
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein<dd><p>
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein Write zone output to <code class="filename">filename</code>.
da527e4ff6a013364826637963e7ac372e024f33David Lawrence If <code class="filename">filename</code> is <code class="filename">-</code> then
da527e4ff6a013364826637963e7ac372e024f33David Lawrence write to standard out.
da527e4ff6a013364826637963e7ac372e024f33David Lawrence This is mandatory for <span><strong class="command">named-compilezone</strong></span>.
da527e4ff6a013364826637963e7ac372e024f33David Lawrence </p></dd>
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein<dt><span class="term">-r <em class="replaceable"><code>mode</code></em></span></dt>
da527e4ff6a013364826637963e7ac372e024f33David Lawrence<dd><p>
da527e4ff6a013364826637963e7ac372e024f33David Lawrence Check for records that are treated as different by DNSSEC but
da527e4ff6a013364826637963e7ac372e024f33David Lawrence are semantically equal in plain DNS.
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein Possible modes are <span><strong class="command">"fail"</strong></span>,
da527e4ff6a013364826637963e7ac372e024f33David Lawrence <span><strong class="command">"warn"</strong></span> (default) and
da527e4ff6a013364826637963e7ac372e024f33David Lawrence <span><strong class="command">"ignore"</strong></span>.
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein </p></dd>
da527e4ff6a013364826637963e7ac372e024f33David Lawrence<dt><span class="term">-s <em class="replaceable"><code>style</code></em></span></dt>
40f53fa8d9c6a4fc38c0014495e7a42b08f52481David Lawrence<dd><p>
da527e4ff6a013364826637963e7ac372e024f33David Lawrence Specify the style of the dumped zone file.
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein Possible styles are <span><strong class="command">"full"</strong></span> (default)
da527e4ff6a013364826637963e7ac372e024f33David Lawrence and <span><strong class="command">"relative"</strong></span>.
da527e4ff6a013364826637963e7ac372e024f33David Lawrence The full format is most suitable for processing
da527e4ff6a013364826637963e7ac372e024f33David Lawrence automatically by a separate script.
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein On the other hand, the relative format is more
da527e4ff6a013364826637963e7ac372e024f33David Lawrence human-readable and is thus suitable for editing by hand.
da527e4ff6a013364826637963e7ac372e024f33David Lawrence For <span><strong class="command">named-checkzone</strong></span>
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein this does not cause any effects unless it dumps the zone
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein contents.
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein It also does not have any meaning if the output format
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley is not text.
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley </p></dd>
6d12fdf96621801e80f3f4c2a8a569fe48766a20David Lawrence<dt><span class="term">-S <em class="replaceable"><code>mode</code></em></span></dt>
6d12fdf96621801e80f3f4c2a8a569fe48766a20David Lawrence<dd><p>
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein Check if a SRV record refers to a CNAME.
77ca0b57938a8d564676066703cb7fdecacb8976Bob Halley Possible modes are <span><strong class="command">"fail"</strong></span>,
77ca0b57938a8d564676066703cb7fdecacb8976Bob Halley <span><strong class="command">"warn"</strong></span> (default) and
77ca0b57938a8d564676066703cb7fdecacb8976Bob Halley <span><strong class="command">"ignore"</strong></span>.
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein </p></dd>
77ca0b57938a8d564676066703cb7fdecacb8976Bob Halley<dt><span class="term">-t <em class="replaceable"><code>directory</code></em></span></dt>
77ca0b57938a8d564676066703cb7fdecacb8976Bob Halley<dd><p>
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein Chroot to <code class="filename">directory</code> so that
86131d8d7aaf1bb8b8bfc7819985d05ea369b708Bob Halley include
ce3761f64d3d734cc94605026985898900ecc474Bob Halley directives in the configuration file are processed as if
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein run by a similarly chrooted named.
ce3761f64d3d734cc94605026985898900ecc474Bob Halley </p></dd>
ce3761f64d3d734cc94605026985898900ecc474Bob Halley<dt><span class="term">-T <em class="replaceable"><code>mode</code></em></span></dt>
127a4a90b0d03ebf55ad44d25f75b30c3a6fb728Evan Hunt<dd><p>
127a4a90b0d03ebf55ad44d25f75b30c3a6fb728Evan Hunt Check if Sender Policy Framework records (TXT and SPF)
127a4a90b0d03ebf55ad44d25f75b30c3a6fb728Evan Hunt both exist or both don't exist. A warning is issued
127a4a90b0d03ebf55ad44d25f75b30c3a6fb728Evan Hunt if they don't match. Possible modes are
127a4a90b0d03ebf55ad44d25f75b30c3a6fb728Evan Hunt <span><strong class="command">"warn"</strong></span> (default), <span><strong class="command">"ignore"</strong></span>.
ce3761f64d3d734cc94605026985898900ecc474Bob Halley </p></dd>
ce3761f64d3d734cc94605026985898900ecc474Bob Halley<dt><span class="term">-w <em class="replaceable"><code>directory</code></em></span></dt>
ce3761f64d3d734cc94605026985898900ecc474Bob Halley<dd><p>
ce3761f64d3d734cc94605026985898900ecc474Bob Halley chdir to <code class="filename">directory</code> so that
ce3761f64d3d734cc94605026985898900ecc474Bob Halley relative
ce3761f64d3d734cc94605026985898900ecc474Bob Halley filenames in master file $INCLUDE directives work. This
ce3761f64d3d734cc94605026985898900ecc474Bob Halley is similar to the directory clause in
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein <code class="filename">named.conf</code>.
ee03a00244edc6c823ea11bed16437865b395d5dAndreas Gustafsson </p></dd>
ce3761f64d3d734cc94605026985898900ecc474Bob Halley<dt><span class="term">-D</span></dt>
ce3761f64d3d734cc94605026985898900ecc474Bob Halley<dd><p>
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein Dump zone file in canonical format.
45b4efd07f8d0ee11e4695900ac9ac30ec0570c1Francis Dupont This is always enabled for <span><strong class="command">named-compilezone</strong></span>.
ce3761f64d3d734cc94605026985898900ecc474Bob Halley </p></dd>
ce3761f64d3d734cc94605026985898900ecc474Bob Halley<dt><span class="term">-W <em class="replaceable"><code>mode</code></em></span></dt>
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein<dd><p>
ce3761f64d3d734cc94605026985898900ecc474Bob Halley Specify whether to check for non-terminal wildcards.
ce3761f64d3d734cc94605026985898900ecc474Bob Halley Non-terminal wildcards are almost always the result of a
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein failure to understand the wildcard matching algorithm (RFC 1034).
5fc1b54cc6134bd70f4e22df90a2e5631aaea77aBob Halley Possible modes are <span><strong class="command">"warn"</strong></span> (default)
5fc1b54cc6134bd70f4e22df90a2e5631aaea77aBob Halley and
5fc1b54cc6134bd70f4e22df90a2e5631aaea77aBob Halley <span><strong class="command">"ignore"</strong></span>.
5fc1b54cc6134bd70f4e22df90a2e5631aaea77aBob Halley </p></dd>
ce3761f64d3d734cc94605026985898900ecc474Bob Halley<dt><span class="term">zonename</span></dt>
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein<dd><p>
ce3761f64d3d734cc94605026985898900ecc474Bob Halley The domain name of the zone being checked.
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein </p></dd>
5fc1b54cc6134bd70f4e22df90a2e5631aaea77aBob Halley<dt><span class="term">filename</span></dt>
77ca0b57938a8d564676066703cb7fdecacb8976Bob Halley<dd><p>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley The name of the zone file.
ce3761f64d3d734cc94605026985898900ecc474Bob Halley </p></dd>
6d12fdf96621801e80f3f4c2a8a569fe48766a20David Lawrence</dl></div>
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein</div>
ce3761f64d3d734cc94605026985898900ecc474Bob Halley<div class="refsect1" lang="en">
ce3761f64d3d734cc94605026985898900ecc474Bob Halley<a name="id2672590"></a><h2>RETURN VALUES</h2>
ce3761f64d3d734cc94605026985898900ecc474Bob Halley<p><span><strong class="command">named-checkzone</strong></span>
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein returns an exit status of 1 if
ce3761f64d3d734cc94605026985898900ecc474Bob Halley errors were detected and 0 otherwise.
ce3761f64d3d734cc94605026985898900ecc474Bob Halley </p>
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein</div>
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein<div class="refsect1" lang="en">
ce3761f64d3d734cc94605026985898900ecc474Bob Halley<a name="id2672604"></a><h2>SEE ALSO</h2>
ce3761f64d3d734cc94605026985898900ecc474Bob Halley<p><span class="citerefentry"><span class="refentrytitle">named</span>(8)</span>,
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley <span class="citerefentry"><span class="refentrytitle">named-checkconf</span>(8)</span>,
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley <em class="citetitle">RFC 1035</em>,
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley <em class="citetitle">BIND 9 Administrator Reference Manual</em>.
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley </p>
6d12fdf96621801e80f3f4c2a8a569fe48766a20David Lawrence</div>
6d12fdf96621801e80f3f4c2a8a569fe48766a20David Lawrence<div class="refsect1" lang="en">
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein<a name="id2672637"></a><h2>AUTHOR</h2>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley<p><span class="corpauthor">Internet Systems Consortium</span>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley </p>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley</div>
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein</div>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley<div class="navfooter">
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley<hr>
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein<table width="100%" summary="Navigation footer">
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein<tr>
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley<td width="40%" align="left">
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley<a accesskey="p" href="man.named-checkconf.html">Prev</a>�</td>
6d12fdf96621801e80f3f4c2a8a569fe48766a20David Lawrence<td width="20%" align="center"><a accesskey="u" href="Bv9ARM.ch10.html">Up</a></td>
6d12fdf96621801e80f3f4c2a8a569fe48766a20David Lawrence<td width="40%" align="right">�<a accesskey="n" href="man.named.html">Next</a>
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein</td>
00d81794884f1eee59ca058a292f2d1e50d9547cBob Halley</tr>
00d81794884f1eee59ca058a292f2d1e50d9547cBob Halley<tr>
00d81794884f1eee59ca058a292f2d1e50d9547cBob Halley<td width="40%" align="left" valign="top">
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein<span class="application">named-checkconf</span>�</td>
00d81794884f1eee59ca058a292f2d1e50d9547cBob Halley<td width="20%" align="center"><a accesskey="h" href="Bv9ARM.html">Home</a></td>
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein<td width="40%" align="right" valign="top">�<span class="application">named</span>
00d81794884f1eee59ca058a292f2d1e50d9547cBob Halley</td>
00d81794884f1eee59ca058a292f2d1e50d9547cBob Halley</tr>
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein</table>
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein</div>
00d81794884f1eee59ca058a292f2d1e50d9547cBob Halley</body>
00d81794884f1eee59ca058a292f2d1e50d9547cBob Halley</html>
6d12fdf96621801e80f3f4c2a8a569fe48766a20David Lawrence