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