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