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