man.named-checkzone.html revision 40f508f08bb887b14739f7b64e4d0a892586948f
5f5870385cff47efd2f58e7892f251cf13761528Timo Sirainen<!--
fd4632d0060b2e9eef513b544ccff1e26d1fc222Timo Sirainen - Copyright (C) 2004-2015 Internet Systems Consortium, Inc. ("ISC")
08d6658a4e2ec8104cd1307f6baa75fdb07a24f8Mark Washenberger - Copyright (C) 2000-2003 Internet Software Consortium.
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen -
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen - Permission to use, copy, modify, and/or distribute this software for any
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen - purpose with or without fee is hereby granted, provided that the above
08d6658a4e2ec8104cd1307f6baa75fdb07a24f8Mark Washenberger - copyright notice and this permission notice appear in all copies.
e5b8b3a57993ab957d389e1c7253698bcd1e6cb1Timo Sirainen -
3517cb9bcf01610a9dfc9862a28414cc78b20dfbTimo Sirainen - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
fd4632d0060b2e9eef513b544ccff1e26d1fc222Timo Sirainen - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen - PERFORMANCE OF THIS SOFTWARE.
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen-->
3517cb9bcf01610a9dfc9862a28414cc78b20dfbTimo Sirainen<!-- $Id$ -->
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen<html>
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen<head>
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen<title>named-checkzone</title>
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen<meta name="generator" content="DocBook XSL Stylesheets V1.71.1">
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen<link rel="start" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual">
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen<link rel="up" href="Bv9ARM.ch13.html" title="Manual pages">
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen<link rel="prev" href="man.named-checkconf.html" title="named-checkconf">
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen<link rel="next" href="man.named.html" title="named">
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen</head>
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen<div class="navheader">
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen<table width="100%" summary="Navigation header">
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen<tr><th colspan="3" align="center"><span class="application">named-checkzone</span></th></tr>
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen<tr>
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen<td width="20%" align="left">
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen<a accesskey="p" href="man.named-checkconf.html">Prev</a>�</td>
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen<th width="60%" align="center">Manual pages</th>
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen<td width="20%" align="right">�<a accesskey="n" href="man.named.html">Next</a>
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen</td>
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen</tr>
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen</table>
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen<hr>
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen</div>
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen<div class="refentry" lang="en">
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen<a name="man.named-checkzone"></a><div class="titlepage"></div>
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen<div class="refnamediv">
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen<h2>Name</h2>
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen<p><span class="application">named-checkzone</span>, <span class="application">named-compilezone</span> &#8212; zone file validity checking or converting tool</p>
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen</div>
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen<div class="refsynopsisdiv">
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen<h2>Synopsis</h2>
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen<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>
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen<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>
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen</div>
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen<div class="refsect1" lang="en">
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen<a name="id2687470"></a><h2>DESCRIPTION</h2>
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen<p><span><strong class="command">named-checkzone</strong></span>
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen checks the syntax and integrity of a zone file. It performs the
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen same checks as <span><strong class="command">named</strong></span> does when loading a
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen zone. This makes <span><strong class="command">named-checkzone</strong></span> useful for
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen checking zone files before configuring them into a name server.
3517cb9bcf01610a9dfc9862a28414cc78b20dfbTimo Sirainen </p>
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen<p>
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen <span><strong class="command">named-compilezone</strong></span> is similar to
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen <span><strong class="command">named-checkzone</strong></span>, but it always dumps the
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen zone contents to a specified file in a specified format.
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen Additionally, it applies stricter check levels by default,
3517cb9bcf01610a9dfc9862a28414cc78b20dfbTimo Sirainen since the dump output will be used as an actual zone file
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen loaded by <span><strong class="command">named</strong></span>.
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen When manually specified otherwise, the check levels must at
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen least be as strict as those specified in the
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen <span><strong class="command">named</strong></span> configuration file.
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen </p>
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen</div>
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen<div class="refsect1" lang="en">
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen<a name="id2687521"></a><h2>OPTIONS</h2>
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen<div class="variablelist"><dl>
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen<dt><span class="term">-d</span></dt>
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen<dd><p>
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen Enable debugging.
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen </p></dd>
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen<dt><span class="term">-h</span></dt>
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen<dd><p>
3517cb9bcf01610a9dfc9862a28414cc78b20dfbTimo Sirainen Print the usage summary and exit.
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen </p></dd>
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen<dt><span class="term">-q</span></dt>
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen<dd><p>
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen Quiet mode - exit code only.
a7386efde8d89b85aa6ee8b56a34a4ddf85e84beTimo Sirainen </p></dd>
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen<dt><span class="term">-v</span></dt>
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen<dd><p>
a914bff43644dd9b3977244203839ca74161e40cTimo Sirainen Print the version of the <span><strong class="command">named-checkzone</strong></span>
a914bff43644dd9b3977244203839ca74161e40cTimo Sirainen program and exit.
a914bff43644dd9b3977244203839ca74161e40cTimo Sirainen </p></dd>
a914bff43644dd9b3977244203839ca74161e40cTimo Sirainen<dt><span class="term">-j</span></dt>
a914bff43644dd9b3977244203839ca74161e40cTimo Sirainen<dd><p>
a914bff43644dd9b3977244203839ca74161e40cTimo Sirainen When loading a zone file, read the journal if it exists.
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen The journal file name is assumed to be the zone file name
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen appended with the string <code class="filename">.jnl</code>.
e2a88d59c0d47d63ce1ad5b1fd95e487124a3fd4Timo Sirainen </p></dd>
e2a88d59c0d47d63ce1ad5b1fd95e487124a3fd4Timo Sirainen<dt><span class="term">-J <em class="replaceable"><code>filename</code></em></span></dt>
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen<dd><p>
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen When loading the zone file read the journal from the given
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen file, if it exists. (Implies -j.)
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen </p></dd>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen<dt><span class="term">-c <em class="replaceable"><code>class</code></em></span></dt>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen<dd><p>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen Specify the class of the zone. If not specified, "IN" is assumed.
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen </p></dd>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen<dt><span class="term">-i <em class="replaceable"><code>mode</code></em></span></dt>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen<dd>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen<p>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen Perform post-load zone integrity checks. Possible modes are
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen <span><strong class="command">"full"</strong></span> (default),
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen <span><strong class="command">"full-sibling"</strong></span>,
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen <span><strong class="command">"local"</strong></span>,
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen <span><strong class="command">"local-sibling"</strong></span> and
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen <span><strong class="command">"none"</strong></span>.
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen </p>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen<p>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen Mode <span><strong class="command">"full"</strong></span> checks that MX records
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen refer to A or AAAA record (both in-zone and out-of-zone
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen hostnames). Mode <span><strong class="command">"local"</strong></span> only
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen checks MX records which refer to in-zone hostnames.
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen </p>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen<p>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen Mode <span><strong class="command">"full"</strong></span> checks that SRV records
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen refer to A or AAAA record (both in-zone and out-of-zone
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen hostnames). Mode <span><strong class="command">"local"</strong></span> only
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen checks SRV records which refer to in-zone hostnames.
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen </p>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen<p>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen Mode <span><strong class="command">"full"</strong></span> checks that delegation NS
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen records refer to A or AAAA record (both in-zone and out-of-zone
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen hostnames). It also checks that glue address records
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen in the zone match those advertised by the child.
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen Mode <span><strong class="command">"local"</strong></span> only checks NS records which
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen refer to in-zone hostnames or that some required glue exists,
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen that is when the nameserver is in a child zone.
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen </p>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen<p>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen Mode <span><strong class="command">"full-sibling"</strong></span> and
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen <span><strong class="command">"local-sibling"</strong></span> disable sibling glue
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen checks but are otherwise the same as <span><strong class="command">"full"</strong></span>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen and <span><strong class="command">"local"</strong></span> respectively.
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen </p>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen<p>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen Mode <span><strong class="command">"none"</strong></span> disables the checks.
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen </p>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen</dd>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen<dt><span class="term">-f <em class="replaceable"><code>format</code></em></span></dt>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen<dd><p>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen Specify the format of the zone file.
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen Possible formats are <span><strong class="command">"text"</strong></span> (default),
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen <span><strong class="command">"raw"</strong></span>, and <span><strong class="command">"map"</strong></span>.
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen </p></dd>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen<dt><span class="term">-F <em class="replaceable"><code>format</code></em></span></dt>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen<dd>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen<p>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen Specify the format of the output file specified.
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen For <span><strong class="command">named-checkzone</strong></span>,
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen this does not cause any effects unless it dumps the zone
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen contents.
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen </p>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen<p>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen Possible formats are <span><strong class="command">"text"</strong></span> (default),
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen which is the standard textual representation of the zone,
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen and <span><strong class="command">"map"</strong></span>, <span><strong class="command">"raw"</strong></span>,
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen and <span><strong class="command">"raw=N"</strong></span>, which store the zone in a
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen binary format for rapid loading by <span><strong class="command">named</strong></span>.
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen <span><strong class="command">"raw=N"</strong></span> specifies the format version of
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen the raw zone file: if N is 0, the raw file can be read by
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen any version of <span><strong class="command">named</strong></span>; if N is 1, the file
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen can be read by release 9.9.0 or higher; the default is 1.
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen </p>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen</dd>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen<dt><span class="term">-k <em class="replaceable"><code>mode</code></em></span></dt>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen<dd><p>
59153e6c6264c5d95eae0a180bb3cd19096fb9c6Timo Sirainen Perform <span><strong class="command">"check-names"</strong></span> checks with the
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen specified failure mode.
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen Possible modes are <span><strong class="command">"fail"</strong></span>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen (default for <span><strong class="command">named-compilezone</strong></span>),
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen <span><strong class="command">"warn"</strong></span>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen (default for <span><strong class="command">named-checkzone</strong></span>) and
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen <span><strong class="command">"ignore"</strong></span>.
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen </p></dd>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen<dt><span class="term">-l <em class="replaceable"><code>ttl</code></em></span></dt>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen<dd><p>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen Sets a maximum permissible TTL for the input file.
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen Any record with a TTL higher than this value will cause
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen the zone to be rejected. This is similar to using the
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen <span><strong class="command">max-zone-ttl</strong></span> option in
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen <code class="filename">named.conf</code>.
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen </p></dd>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen<dt><span class="term">-L <em class="replaceable"><code>serial</code></em></span></dt>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen<dd><p>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen When compiling a zone to "raw" or "map" format, set the
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen "source serial" value in the header to the specified serial
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen number. (This is expected to be used primarily for testing
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen purposes.)
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen </p></dd>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen<dt><span class="term">-m <em class="replaceable"><code>mode</code></em></span></dt>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen<dd><p>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen Specify whether MX records should be checked to see if they
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen are addresses. Possible modes are <span><strong class="command">"fail"</strong></span>,
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen <span><strong class="command">"warn"</strong></span> (default) and
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen <span><strong class="command">"ignore"</strong></span>.
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen </p></dd>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen<dt><span class="term">-M <em class="replaceable"><code>mode</code></em></span></dt>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen<dd><p>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen Check if a MX record refers to a CNAME.
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen Possible modes are <span><strong class="command">"fail"</strong></span>,
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen <span><strong class="command">"warn"</strong></span> (default) and
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen <span><strong class="command">"ignore"</strong></span>.
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen </p></dd>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen<dt><span class="term">-n <em class="replaceable"><code>mode</code></em></span></dt>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen<dd><p>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen Specify whether NS records should be checked to see if they
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen are addresses.
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen Possible modes are <span><strong class="command">"fail"</strong></span>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen (default for <span><strong class="command">named-compilezone</strong></span>),
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen <span><strong class="command">"warn"</strong></span>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen (default for <span><strong class="command">named-checkzone</strong></span>) and
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen <span><strong class="command">"ignore"</strong></span>.
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen </p></dd>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen<dt><span class="term">-o <em class="replaceable"><code>filename</code></em></span></dt>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen<dd><p>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen Write zone output to <code class="filename">filename</code>.
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen If <code class="filename">filename</code> is <code class="filename">-</code> then
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen write to standard out.
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen This is mandatory for <span><strong class="command">named-compilezone</strong></span>.
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen </p></dd>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen<dt><span class="term">-r <em class="replaceable"><code>mode</code></em></span></dt>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen<dd><p>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen Check for records that are treated as different by DNSSEC but
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen are semantically equal in plain DNS.
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen Possible modes are <span><strong class="command">"fail"</strong></span>,
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen <span><strong class="command">"warn"</strong></span> (default) and
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen <span><strong class="command">"ignore"</strong></span>.
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen </p></dd>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen<dt><span class="term">-s <em class="replaceable"><code>style</code></em></span></dt>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen<dd><p>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen Specify the style of the dumped zone file.
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen Possible styles are <span><strong class="command">"full"</strong></span> (default)
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen and <span><strong class="command">"relative"</strong></span>.
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen The full format is most suitable for processing
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen automatically by a separate script.
6ef7e31619edfaa17ed044b45861d106a86191efTimo Sirainen On the other hand, the relative format is more
fd4632d0060b2e9eef513b544ccff1e26d1fc222Timo Sirainen human-readable and is thus suitable for editing by hand.
e60a349c641bb2f4723e4a395a25f55531682d2bTimo Sirainen For <span><strong class="command">named-checkzone</strong></span>
24e3b6aee28a8fb126e1f21348cc80acb2338518Timo Sirainen this does not cause any effects unless it dumps the zone
c4b376dd6e0c423006d7ac83a39253bcaf8e7c47Timo Sirainen contents.
f1e9611e93dcb3b745c1904029084fa81644e1b3Timo Sirainen It also does not have any meaning if the output format
97cfe59cd16ce624e58e8d9b6003d1e29d75b3d2Timo Sirainen is not text.
2f25f180578a4c280c9f5fda1cb9f22410084a1eTimo Sirainen </p></dd>
fd4632d0060b2e9eef513b544ccff1e26d1fc222Timo Sirainen<dt><span class="term">-S <em class="replaceable"><code>mode</code></em></span></dt>
2f25f180578a4c280c9f5fda1cb9f22410084a1eTimo Sirainen<dd><p>
fd4632d0060b2e9eef513b544ccff1e26d1fc222Timo Sirainen Check if a SRV record refers to a CNAME.
fd4632d0060b2e9eef513b544ccff1e26d1fc222Timo Sirainen Possible modes are <span><strong class="command">"fail"</strong></span>,
e60a349c641bb2f4723e4a395a25f55531682d2bTimo Sirainen <span><strong class="command">"warn"</strong></span> (default) and
fd4632d0060b2e9eef513b544ccff1e26d1fc222Timo Sirainen <span><strong class="command">"ignore"</strong></span>.
fd4632d0060b2e9eef513b544ccff1e26d1fc222Timo Sirainen </p></dd>
c2fbbf7515aa419dc8b2d62a3c2bb0471d51a391Timo Sirainen<dt><span class="term">-t <em class="replaceable"><code>directory</code></em></span></dt>
c2fbbf7515aa419dc8b2d62a3c2bb0471d51a391Timo Sirainen<dd><p>
c2fbbf7515aa419dc8b2d62a3c2bb0471d51a391Timo Sirainen Chroot to <code class="filename">directory</code> so that
fd4632d0060b2e9eef513b544ccff1e26d1fc222Timo Sirainen include
fd4632d0060b2e9eef513b544ccff1e26d1fc222Timo Sirainen directives in the configuration file are processed as if
c2fbbf7515aa419dc8b2d62a3c2bb0471d51a391Timo Sirainen run by a similarly chrooted <span><strong class="command">named</strong></span>.
fd4632d0060b2e9eef513b544ccff1e26d1fc222Timo Sirainen </p></dd>
7725332a206824650d486f21cc3c62bad98e3be4Timo Sirainen<dt><span class="term">-T <em class="replaceable"><code>mode</code></em></span></dt>
e60a349c641bb2f4723e4a395a25f55531682d2bTimo Sirainen<dd><p>
fd4632d0060b2e9eef513b544ccff1e26d1fc222Timo Sirainen Check if Sender Policy Framework (SPF) records exist
fd4632d0060b2e9eef513b544ccff1e26d1fc222Timo Sirainen and issues a warning if an SPF-formatted TXT record is
fd4632d0060b2e9eef513b544ccff1e26d1fc222Timo Sirainen not also present. Possible modes are <span><strong class="command">"warn"</strong></span>
c4b376dd6e0c423006d7ac83a39253bcaf8e7c47Timo Sirainen (default), <span><strong class="command">"ignore"</strong></span>.
97cfe59cd16ce624e58e8d9b6003d1e29d75b3d2Timo Sirainen </p></dd>
97cfe59cd16ce624e58e8d9b6003d1e29d75b3d2Timo Sirainen<dt><span class="term">-w <em class="replaceable"><code>directory</code></em></span></dt>
fd4632d0060b2e9eef513b544ccff1e26d1fc222Timo Sirainen<dd><p>
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen chdir to <code class="filename">directory</code> so that
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen relative
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen filenames in master file $INCLUDE directives work. This
cdac58636c2fd38ba5d4ea6cceab9383b13e82f8Timo Sirainen is similar to the directory clause in
c4b376dd6e0c423006d7ac83a39253bcaf8e7c47Timo Sirainen <code class="filename">named.conf</code>.
c4b376dd6e0c423006d7ac83a39253bcaf8e7c47Timo Sirainen </p></dd>
e60a349c641bb2f4723e4a395a25f55531682d2bTimo Sirainen<dt><span class="term">-D</span></dt>
c2fbbf7515aa419dc8b2d62a3c2bb0471d51a391Timo Sirainen<dd><p>
97cfe59cd16ce624e58e8d9b6003d1e29d75b3d2Timo Sirainen Dump zone file in canonical format.
fd4632d0060b2e9eef513b544ccff1e26d1fc222Timo Sirainen This is always enabled for <span><strong class="command">named-compilezone</strong></span>.
fd4632d0060b2e9eef513b544ccff1e26d1fc222Timo Sirainen </p></dd>
97cfe59cd16ce624e58e8d9b6003d1e29d75b3d2Timo Sirainen<dt><span class="term">-W <em class="replaceable"><code>mode</code></em></span></dt>
97cfe59cd16ce624e58e8d9b6003d1e29d75b3d2Timo Sirainen<dd><p>
97cfe59cd16ce624e58e8d9b6003d1e29d75b3d2Timo Sirainen Specify whether to check for non-terminal wildcards.
fd4632d0060b2e9eef513b544ccff1e26d1fc222Timo Sirainen Non-terminal wildcards are almost always the result of a
failure to understand the wildcard matching algorithm (RFC 1034).
Possible modes are <span><strong class="command">"warn"</strong></span> (default)
and
<span><strong class="command">"ignore"</strong></span>.
</p></dd>
<dt><span class="term">zonename</span></dt>
<dd><p>
The domain name of the zone being checked.
</p></dd>
<dt><span class="term">filename</span></dt>
<dd><p>
The name of the zone file.
</p></dd>
</dl></div>
</div>
<div class="refsect1" lang="en">
<a name="id2688496"></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="id2688509"></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="id2688542"></a><h2>AUTHOR</h2>
<p><span class="corpauthor">Internet Systems Consortium</span>
</p>
</div>
</div>
<div class="navfooter">
<hr>
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left">
<a accesskey="p" href="man.named-checkconf.html">Prev</a>�</td>
<td width="20%" align="center"><a accesskey="u" href="Bv9ARM.ch13.html">Up</a></td>
<td width="40%" align="right">�<a accesskey="n" href="man.named.html">Next</a>
</td>
</tr>
<tr>
<td width="40%" align="left" valign="top">
<span class="application">named-checkconf</span>�</td>
<td width="20%" align="center"><a accesskey="h" href="Bv9ARM.html">Home</a></td>
<td width="40%" align="right" valign="top">�<span class="application">named</span>
</td>
</tr>
</table>
</div>
<p style="text-align: center;">BIND 9.11.0pre-alpha</p>
</body>
</html>