named-checkzone.html revision 3a3705ef7747327df182bf8d009333d2472253d5
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - Copyright (C) 2004, 2005 Internet Systems Consortium, Inc. ("ISC")
f0aad5341752aefe5059832f6cf3abc3283c6e16Tinderbox User - Copyright (C) 2000-2002 Internet Software Consortium.
5347c0fcb04eaea19d9f39795646239f487c6207Tinderbox User - Permission to use, copy, modify, and 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.
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,
cd32f419a8a5432fbb139f56ee73cbf68b9350ccTinderbox User - 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.
cd32f419a8a5432fbb139f56ee73cbf68b9350ccTinderbox User<!-- $Id: named-checkzone.html,v 1.24 2005/05/19 12:34:32 marka Exp $ -->
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
cd32f419a8a5432fbb139f56ee73cbf68b9350ccTinderbox User<meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en">
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<a name="id2456836"></a><div class="titlepage"></div>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<p><span class="application">named-checkzone</span> — zone file validity checking tool</p>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<div class="cmdsynopsis"><p><code class="command">named-checkzone</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">-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">-o <em class="replaceable"><code>filename</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>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<p><span><strong class="command">named-checkzone</strong></span>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt checks the syntax and integrity of a zone file. It performs the
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User same checks as <span><strong class="command">named</strong></span> does when loading a
0da02c26a6631c25f075a8e4ac6de9e58f49a0c2Tinderbox User zone. This makes <span><strong class="command">named-checkzone</strong></span> useful for
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt checking zone files before configuring them into a name server.
ffe29868b4bbc64953fc5d0de51f988c20158967Tinderbox User Enable debugging.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt Quiet mode - exit code only.
0da02c26a6631c25f075a8e4ac6de9e58f49a0c2Tinderbox User Print the version of the <span><strong class="command">named-checkzone</strong></span>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User program and exit.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User When loading the zone file read the journal if it exists.
0da02c26a6631c25f075a8e4ac6de9e58f49a0c2Tinderbox User<dt><span class="term">-c <em class="replaceable"><code>class</code></em></span></dt>
0da02c26a6631c25f075a8e4ac6de9e58f49a0c2Tinderbox User Specify the class of the zone. If not specified "IN" is assumed.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<dt><span class="term">-i <em class="replaceable"><code>mode</code></em></span></dt>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt Perform post load zone integrity checks. Possible modes are
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <span><strong class="command">"full"</strong></span> (default),
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <span><strong class="command">"local"</strong></span> and
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <span><strong class="command">"none"</strong></span>.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt Mode <span><strong class="command">"full"</strong></span> checks that MX records
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt refer to A or AAAA record (both in-zone and out-of-zone
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt hostnames). Mode <span><strong class="command">"local"</strong></span> only
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User checks MX records which refer to in-zone hostnames.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt Mode <span><strong class="command">"full"</strong></span> checks that SRV records
a1ff871f78b7d907d6fc3a382beea2a640fe8423Tinderbox User refer to A or AAAA record (both in-zone and out-of-zone
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User hostnames). Mode <span><strong class="command">"local"</strong></span> only
0da02c26a6631c25f075a8e4ac6de9e58f49a0c2Tinderbox User checks SRV records which refer to in-zone hostnames.
8a48b6b9b6fa8486f24b22d1972b2b6ebb36a4a4Tinderbox User Mode <span><strong class="command">"full"</strong></span> checks that delegation NS
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User records refer to A or AAAA record (both in-zone and out-of-zone
8a48b6b9b6fa8486f24b22d1972b2b6ebb36a4a4Tinderbox User hostnames). It also checks that glue addresses records
8a48b6b9b6fa8486f24b22d1972b2b6ebb36a4a4Tinderbox User in the zone match those advertised by the child.
8a48b6b9b6fa8486f24b22d1972b2b6ebb36a4a4Tinderbox User Mode <span><strong class="command">"local"</strong></span> only checks NS records which
8a48b6b9b6fa8486f24b22d1972b2b6ebb36a4a4Tinderbox User refer to in-zone hostnames or that some required glue exists,
8a48b6b9b6fa8486f24b22d1972b2b6ebb36a4a4Tinderbox User that is when the nameserver is in a child zone.
8a48b6b9b6fa8486f24b22d1972b2b6ebb36a4a4Tinderbox User Mode <span><strong class="command">"none"</strong></span> disables the checks.
8a48b6b9b6fa8486f24b22d1972b2b6ebb36a4a4Tinderbox User<dt><span class="term">-k <em class="replaceable"><code>mode</code></em></span></dt>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User Perform <span><strong class="command">"check-name"</strong></span> checks with
8a48b6b9b6fa8486f24b22d1972b2b6ebb36a4a4Tinderbox User the specified failure mode.
8a48b6b9b6fa8486f24b22d1972b2b6ebb36a4a4Tinderbox User Possible modes are <span><strong class="command">"fail"</strong></span>,
8a48b6b9b6fa8486f24b22d1972b2b6ebb36a4a4Tinderbox User <span><strong class="command">"warn"</strong></span> (default) and
8a48b6b9b6fa8486f24b22d1972b2b6ebb36a4a4Tinderbox User <span><strong class="command">"ignore"</strong></span>.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<dt><span class="term">-m <em class="replaceable"><code>mode</code></em></span></dt>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User Specify whether MX records should be checked to see if they
a1ff871f78b7d907d6fc3a382beea2a640fe8423Tinderbox User are addresses. Possible modes are <span><strong class="command">"fail"</strong></span>,
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <span><strong class="command">"warn"</strong></span> (default) and
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <span><strong class="command">"ignore"</strong></span>.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<dt><span class="term">-n <em class="replaceable"><code>mode</code></em></span></dt>
0da02c26a6631c25f075a8e4ac6de9e58f49a0c2Tinderbox User Specify whether NS records should be checked to see if they
0da02c26a6631c25f075a8e4ac6de9e58f49a0c2Tinderbox User are addresses. Possible modes are <span><strong class="command">"fail"</strong></span>,
0da02c26a6631c25f075a8e4ac6de9e58f49a0c2Tinderbox User <span><strong class="command">"warn"</strong></span> (default) and
0da02c26a6631c25f075a8e4ac6de9e58f49a0c2Tinderbox User <span><strong class="command">"ignore"</strong></span>.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<dt><span class="term">-o <em class="replaceable"><code>filename</code></em></span></dt>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User Write zone output to <code class="filename">filename</code>.
0da02c26a6631c25f075a8e4ac6de9e58f49a0c2Tinderbox User<dt><span class="term">-t <em class="replaceable"><code>directory</code></em></span></dt>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User chroot to <code class="filename">directory</code> so that
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User directives in the configuration file are processed as if
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User run by a similarly chrooted named.
0da02c26a6631c25f075a8e4ac6de9e58f49a0c2Tinderbox User<dt><span class="term">-w <em class="replaceable"><code>directory</code></em></span></dt>
0da02c26a6631c25f075a8e4ac6de9e58f49a0c2Tinderbox User chdir to <code class="filename">directory</code> so that
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User filenames in master file $INCLUDE directives work. This
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User is similar to the directory clause in
0da02c26a6631c25f075a8e4ac6de9e58f49a0c2Tinderbox User Dump zone file in canonical format.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<dt><span class="term">-W <em class="replaceable"><code>mode</code></em></span></dt>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User Specify whether to check for non-terminal wildcards.
0da02c26a6631c25f075a8e4ac6de9e58f49a0c2Tinderbox User Non-terminal wildcards are almost always the result of a
0da02c26a6631c25f075a8e4ac6de9e58f49a0c2Tinderbox User failure to understand the wildcard matching algorithm (RFC 1034).
0da02c26a6631c25f075a8e4ac6de9e58f49a0c2Tinderbox User Possible modes are <span><strong class="command">"warn"</strong></span> (default)
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <span><strong class="command">"ignore"</strong></span>.
0da02c26a6631c25f075a8e4ac6de9e58f49a0c2Tinderbox User The domain name of the zone being checked.
0da02c26a6631c25f075a8e4ac6de9e58f49a0c2Tinderbox User The name of the zone file.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<a name="id2514737"></a><h2>RETURN VALUES</h2>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<p><span><strong class="command">named-checkzone</strong></span>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt returns an exit status of 1 if
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt errors were detected and 0 otherwise.
0da02c26a6631c25f075a8e4ac6de9e58f49a0c2Tinderbox User<p><span class="citerefentry"><span class="refentrytitle">named</span>(8)</span>,
0da02c26a6631c25f075a8e4ac6de9e58f49a0c2Tinderbox User <em class="citetitle">BIND 9 Administrator Reference Manual</em>.
0da02c26a6631c25f075a8e4ac6de9e58f49a0c2Tinderbox User<p><span class="corpauthor">Internet Systems Consortium</span>