named-checkzone.html revision d6fa26d0adaec6c910115be34fe7a5a5f402c14f
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<!--
a7c412f37cc73d0332887a746e81220cbf09dd00Mark Andrews - Copyright (C) 2000-2002, 2004-2007, 2009-2016 Internet Systems Consortium, Inc. ("ISC")
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews -
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews - This Source Code Form is subject to the terms of the Mozilla Public
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews - License, v. 2.0. If a copy of the MPL was not distributed with this
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews - file, You can obtain one at http://mozilla.org/MPL/2.0/.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews-->
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<html lang="en">
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<head>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<title>named-checkzone</title>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews</head>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry">
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<a name="man.named-checkzone"></a><div class="titlepage"></div>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<div class="refnamediv">
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<h2>Name</h2>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<p><span class="application">named-checkzone</span>, <span class="application">named-compilezone</span> &#8212; zone file validity checking or converting tool</p>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews</div>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<div class="refsynopsisdiv">
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<h2>Synopsis</h2>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<div class="cmdsynopsis"><p><code class="command">named-checkzone</code> [<code class="option">-d</code>] [<code class="option">-h</code>] [<code class="option">-j</code>] [<code class="option">-q</code>] [<code class="option">-v</code>] [<code class="option">-c <em class="replaceable"><code>class</code></em></code>] [<code class="option">-f <em class="replaceable"><code>format</code></em></code>] [<code class="option">-F <em class="replaceable"><code>format</code></em></code>] [<code class="option">-J <em class="replaceable"><code>filename</code></em></code>] [<code class="option">-i <em class="replaceable"><code>mode</code></em></code>] [<code class="option">-k <em class="replaceable"><code>mode</code></em></code>] [<code class="option">-m <em class="replaceable"><code>mode</code></em></code>] [<code class="option">-M <em class="replaceable"><code>mode</code></em></code>] [<code class="option">-n <em class="replaceable"><code>mode</code></em></code>] [<code class="option">-l <em class="replaceable"><code>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>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<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>
dbb012765c735ee0d82dedb116cdc7cf18957814Evan Hunt</div>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<div class="refsection">
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<a name="id-1.7"></a><h2>DESCRIPTION</h2>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<p><span class="command"><strong>named-checkzone</strong></span>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews checks the syntax and integrity of a zone file. It performs the
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews same checks as <span class="command"><strong>named</strong></span> does when loading a
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews zone. This makes <span class="command"><strong>named-checkzone</strong></span> useful for
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews checking zone files before configuring them into a name server.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews </p>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<p>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews <span class="command"><strong>named-compilezone</strong></span> is similar to
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews <span class="command"><strong>named-checkzone</strong></span>, but it always dumps the
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews zone contents to a specified file in a specified format.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews Additionally, it applies stricter check levels by default,
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews since the dump output will be used as an actual zone file
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews loaded by <span class="command"><strong>named</strong></span>.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews When manually specified otherwise, the check levels must at
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews least be as strict as those specified in the
2ae159b376dac23870d8005563c585acf85a4b5aEvan Hunt <span class="command"><strong>named</strong></span> configuration file.
2ae159b376dac23870d8005563c585acf85a4b5aEvan Hunt </p>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews</div>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<div class="refsection">
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<a name="id-1.8"></a><h2>OPTIONS</h2>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<div class="variablelist"><dl class="variablelist">
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dt><span class="term">-d</span></dt>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dd><p>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews Enable debugging.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews </p></dd>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dt><span class="term">-h</span></dt>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dd><p>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews Print the usage summary and exit.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews </p></dd>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dt><span class="term">-q</span></dt>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dd><p>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews Quiet mode - exit code only.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews </p></dd>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dt><span class="term">-v</span></dt>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dd><p>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews Print the version of the <span class="command"><strong>named-checkzone</strong></span>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews program and exit.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews </p></dd>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dt><span class="term">-j</span></dt>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dd><p>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews When loading a zone file, read the journal if it exists.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews The journal file name is assumed to be the zone file name
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews appended with the string <code class="filename">.jnl</code>.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews </p></dd>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dt><span class="term">-J <em class="replaceable"><code>filename</code></em></span></dt>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dd><p>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews When loading the zone file read the journal from the given
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews file, if it exists. (Implies -j.)
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews </p></dd>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dt><span class="term">-c <em class="replaceable"><code>class</code></em></span></dt>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dd><p>
ba751492fcc4f161a18b983d4f018a1a52938cb9Evan Hunt Specify the class of the zone. If not specified, "IN" is assumed.
ba751492fcc4f161a18b983d4f018a1a52938cb9Evan Hunt </p></dd>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dt><span class="term">-i <em class="replaceable"><code>mode</code></em></span></dt>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dd>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<p>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews Perform post-load zone integrity checks. Possible modes are
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews <span class="command"><strong>"full"</strong></span> (default),
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews <span class="command"><strong>"full-sibling"</strong></span>,
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews <span class="command"><strong>"local"</strong></span>,
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews <span class="command"><strong>"local-sibling"</strong></span> and
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews <span class="command"><strong>"none"</strong></span>.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews </p>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<p>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews Mode <span class="command"><strong>"full"</strong></span> checks that MX records
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews refer to A or AAAA record (both in-zone and out-of-zone
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews hostnames). Mode <span class="command"><strong>"local"</strong></span> only
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews checks MX records which refer to in-zone hostnames.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews </p>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<p>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews Mode <span class="command"><strong>"full"</strong></span> checks that SRV records
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews refer to A or AAAA record (both in-zone and out-of-zone
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews hostnames). Mode <span class="command"><strong>"local"</strong></span> only
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews checks SRV records which refer to in-zone hostnames.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews </p>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<p>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews Mode <span class="command"><strong>"full"</strong></span> checks that delegation NS
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews records refer to A or AAAA record (both in-zone and out-of-zone
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews hostnames). It also checks that glue address records
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews in the zone match those advertised by the child.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews Mode <span class="command"><strong>"local"</strong></span> only checks NS records which
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews refer to in-zone hostnames or that some required glue exists,
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews that is when the nameserver is in a child zone.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews </p>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<p>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews Mode <span class="command"><strong>"full-sibling"</strong></span> and
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews <span class="command"><strong>"local-sibling"</strong></span> disable sibling glue
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews checks but are otherwise the same as <span class="command"><strong>"full"</strong></span>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews and <span class="command"><strong>"local"</strong></span> respectively.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews </p>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<p>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews Mode <span class="command"><strong>"none"</strong></span> disables the checks.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews </p>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews</dd>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dt><span class="term">-f <em class="replaceable"><code>format</code></em></span></dt>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dd><p>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews Specify the format of the zone file.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews Possible formats are <span class="command"><strong>"text"</strong></span> (default),
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews <span class="command"><strong>"raw"</strong></span>, and <span class="command"><strong>"map"</strong></span>.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews </p></dd>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dt><span class="term">-F <em class="replaceable"><code>format</code></em></span></dt>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dd>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<p>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews Specify the format of the output file specified.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews For <span class="command"><strong>named-checkzone</strong></span>,
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews this does not cause any effects unless it dumps the zone
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews contents.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews </p>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<p>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews Possible formats are <span class="command"><strong>"text"</strong></span> (default),
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews which is the standard textual representation of the zone,
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews and <span class="command"><strong>"map"</strong></span>, <span class="command"><strong>"raw"</strong></span>,
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews and <span class="command"><strong>"raw=N"</strong></span>, which store the zone in a
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews binary format for rapid loading by <span class="command"><strong>named</strong></span>.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews <span class="command"><strong>"raw=N"</strong></span> specifies the format version of
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews the raw zone file: if N is 0, the raw file can be read by
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews any version of <span class="command"><strong>named</strong></span>; if N is 1, the file
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews can be read by release 9.9.0 or higher; the default is 1.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews </p>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews</dd>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dt><span class="term">-k <em class="replaceable"><code>mode</code></em></span></dt>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dd><p>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews Perform <span class="command"><strong>"check-names"</strong></span> checks with the
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews specified failure mode.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews Possible modes are <span class="command"><strong>"fail"</strong></span>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews (default for <span class="command"><strong>named-compilezone</strong></span>),
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews <span class="command"><strong>"warn"</strong></span>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews (default for <span class="command"><strong>named-checkzone</strong></span>) and
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews <span class="command"><strong>"ignore"</strong></span>.
98922b2b2b024dcca25be7c220cf3b16b1e6c4b5Evan Hunt </p></dd>
98922b2b2b024dcca25be7c220cf3b16b1e6c4b5Evan Hunt<dt><span class="term">-l <em class="replaceable"><code>ttl</code></em></span></dt>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dd><p>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews Sets a maximum permissible TTL for the input file.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews Any record with a TTL higher than this value will cause
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews the zone to be rejected. This is similar to using the
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews <span class="command"><strong>max-zone-ttl</strong></span> option in
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews <code class="filename">named.conf</code>.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews </p></dd>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dt><span class="term">-L <em class="replaceable"><code>serial</code></em></span></dt>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dd><p>
98922b2b2b024dcca25be7c220cf3b16b1e6c4b5Evan Hunt When compiling a zone to "raw" or "map" format, set the
98922b2b2b024dcca25be7c220cf3b16b1e6c4b5Evan Hunt "source serial" value in the header to the specified serial
98922b2b2b024dcca25be7c220cf3b16b1e6c4b5Evan Hunt number. (This is expected to be used primarily for testing
98922b2b2b024dcca25be7c220cf3b16b1e6c4b5Evan Hunt purposes.)
98922b2b2b024dcca25be7c220cf3b16b1e6c4b5Evan Hunt </p></dd>
98922b2b2b024dcca25be7c220cf3b16b1e6c4b5Evan Hunt<dt><span class="term">-m <em class="replaceable"><code>mode</code></em></span></dt>
98922b2b2b024dcca25be7c220cf3b16b1e6c4b5Evan Hunt<dd><p>
98922b2b2b024dcca25be7c220cf3b16b1e6c4b5Evan Hunt Specify whether MX records should be checked to see if they
98922b2b2b024dcca25be7c220cf3b16b1e6c4b5Evan Hunt are addresses. Possible modes are <span class="command"><strong>"fail"</strong></span>,
98922b2b2b024dcca25be7c220cf3b16b1e6c4b5Evan Hunt <span class="command"><strong>"warn"</strong></span> (default) and
98922b2b2b024dcca25be7c220cf3b16b1e6c4b5Evan Hunt <span class="command"><strong>"ignore"</strong></span>.
98922b2b2b024dcca25be7c220cf3b16b1e6c4b5Evan Hunt </p></dd>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dt><span class="term">-M <em class="replaceable"><code>mode</code></em></span></dt>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dd><p>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews Check if a MX record refers to a CNAME.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews Possible modes are <span class="command"><strong>"fail"</strong></span>,
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews <span class="command"><strong>"warn"</strong></span> (default) and
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews <span class="command"><strong>"ignore"</strong></span>.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews </p></dd>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dt><span class="term">-n <em class="replaceable"><code>mode</code></em></span></dt>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dd><p>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews Specify whether NS records should be checked to see if they
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews are addresses.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews Possible modes are <span class="command"><strong>"fail"</strong></span>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews (default for <span class="command"><strong>named-compilezone</strong></span>),
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews <span class="command"><strong>"warn"</strong></span>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews (default for <span class="command"><strong>named-checkzone</strong></span>) and
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews <span class="command"><strong>"ignore"</strong></span>.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews </p></dd>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dt><span class="term">-o <em class="replaceable"><code>filename</code></em></span></dt>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dd><p>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews Write zone output to <code class="filename">filename</code>.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews If <code class="filename">filename</code> is <code class="filename">-</code> then
2ae159b376dac23870d8005563c585acf85a4b5aEvan Hunt write to standard out.
2ae159b376dac23870d8005563c585acf85a4b5aEvan Hunt This is mandatory for <span class="command"><strong>named-compilezone</strong></span>.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews </p></dd>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dt><span class="term">-r <em class="replaceable"><code>mode</code></em></span></dt>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dd><p>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews Check for records that are treated as different by DNSSEC but
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews are semantically equal in plain DNS.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews Possible modes are <span class="command"><strong>"fail"</strong></span>,
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews <span class="command"><strong>"warn"</strong></span> (default) and
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews <span class="command"><strong>"ignore"</strong></span>.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews </p></dd>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dt><span class="term">-s <em class="replaceable"><code>style</code></em></span></dt>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dd><p>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews Specify the style of the dumped zone file.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews Possible styles are <span class="command"><strong>"full"</strong></span> (default)
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews and <span class="command"><strong>"relative"</strong></span>.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews The full format is most suitable for processing
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews automatically by a separate script.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews On the other hand, the relative format is more
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews human-readable and is thus suitable for editing by hand.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews For <span class="command"><strong>named-checkzone</strong></span>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews this does not cause any effects unless it dumps the zone
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews contents.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews It also does not have any meaning if the output format
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews is not text.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews </p></dd>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dt><span class="term">-S <em class="replaceable"><code>mode</code></em></span></dt>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dd><p>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews Check if a SRV record refers to a CNAME.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews Possible modes are <span class="command"><strong>"fail"</strong></span>,
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews <span class="command"><strong>"warn"</strong></span> (default) and
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews <span class="command"><strong>"ignore"</strong></span>.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews </p></dd>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dt><span class="term">-t <em class="replaceable"><code>directory</code></em></span></dt>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dd><p>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews Chroot to <code class="filename">directory</code> so that
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews include
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews directives in the configuration file are processed as if
ba751492fcc4f161a18b983d4f018a1a52938cb9Evan Hunt run by a similarly chrooted <span class="command"><strong>named</strong></span>.
ba751492fcc4f161a18b983d4f018a1a52938cb9Evan Hunt </p></dd>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dt><span class="term">-T <em class="replaceable"><code>mode</code></em></span></dt>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dd><p>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews Check if Sender Policy Framework (SPF) records exist
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews and issues a warning if an SPF-formatted TXT record is
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews not also present. Possible modes are <span class="command"><strong>"warn"</strong></span>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews (default), <span class="command"><strong>"ignore"</strong></span>.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews </p></dd>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dt><span class="term">-w <em class="replaceable"><code>directory</code></em></span></dt>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dd><p>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews chdir to <code class="filename">directory</code> so that
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews relative
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews filenames in master file $INCLUDE directives work. This
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews is similar to the directory clause in
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews <code class="filename">named.conf</code>.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews </p></dd>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dt><span class="term">-D</span></dt>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dd><p>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews Dump zone file in canonical format.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews This is always enabled for <span class="command"><strong>named-compilezone</strong></span>.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews </p></dd>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dt><span class="term">-W <em class="replaceable"><code>mode</code></em></span></dt>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dd><p>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews Specify whether to check for non-terminal wildcards.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews Non-terminal wildcards are almost always the result of a
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews failure to understand the wildcard matching algorithm (RFC 1034).
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews Possible modes are <span class="command"><strong>"warn"</strong></span> (default)
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews and
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews <span class="command"><strong>"ignore"</strong></span>.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews </p></dd>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dt><span class="term">zonename</span></dt>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dd><p>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews The domain name of the zone being checked.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews </p></dd>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dt><span class="term">filename</span></dt>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dd><p>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews The name of the zone file.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews </p></dd>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews</dl></div>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews</div>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<div class="refsection">
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<a name="id-1.9"></a><h2>RETURN VALUES</h2>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<p><span class="command"><strong>named-checkzone</strong></span>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews returns an exit status of 1 if
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews errors were detected and 0 otherwise.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews </p>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews</div>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<div class="refsection">
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<a name="id-1.10"></a><h2>SEE ALSO</h2>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<p><span class="citerefentry"><span class="refentrytitle">named</span>(8)</span>,
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews <span class="citerefentry"><span class="refentrytitle">named-checkconf</span>(8)</span>,
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews <em class="citetitle">RFC 1035</em>,
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews <em class="citetitle">BIND 9 Administrator Reference Manual</em>.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews </p>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews</div>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews</div></body>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews</html>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews