named-checkzone.html revision 60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2
5347c0fcb04eaea19d9f39795646239f487c6207Tinderbox User - Copyright (C) 2004, 2005 Internet Systems Consortium, Inc. ("ISC")
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews - 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
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews - copyright notice and this permission notice appear in all copies.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
cd32f419a8a5432fbb139f56ee73cbf68b9350ccTinderbox User - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
1e9517ea2156b990be21f44676d3370318eacf17Tinderbox User - PERFORMANCE OF THIS SOFTWARE.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en">
1e9517ea2156b990be21f44676d3370318eacf17Tinderbox User<a name="id2456618"></a><div class="titlepage"></div>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<p><span class="application">named-checkzone</span> — zone file validity checking tool</p>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<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">-k <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>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<p><span><strong class="command">named-checkzone</strong></span>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User checks the syntax and integrity of a zone file. It performs the
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews same checks as <span><strong class="command">named</strong></span> does when loading a
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User zone. This makes <span><strong class="command">named-checkzone</strong></span> useful for
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews checking zone files before configuring them into a name server.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews Enable debugging.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User Quiet mode - exit code only.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews Print the version of the <span><strong class="command">named-checkzone</strong></span>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews program and exit.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews When loading the zone file read the journal if it exists.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<dt><span class="term">-c <em class="replaceable"><code>class</code></em></span></dt>
3241ddcf9354c5ab50f4df5a656e72a5c68e172bTinderbox User Specify the class of the zone. If not specified "IN" is assumed.
3241ddcf9354c5ab50f4df5a656e72a5c68e172bTinderbox User<dt><span class="term">-k <em class="replaceable"><code>mode</code></em></span></dt>
3241ddcf9354c5ab50f4df5a656e72a5c68e172bTinderbox User Perform <span><strong class="command">"check-name"</strong></span> checks with
3241ddcf9354c5ab50f4df5a656e72a5c68e172bTinderbox User the specified failure mode.
3241ddcf9354c5ab50f4df5a656e72a5c68e172bTinderbox User Possible modes are <span><strong class="command">"fail"</strong></span>,
3241ddcf9354c5ab50f4df5a656e72a5c68e172bTinderbox User <span><strong class="command">"warn"</strong></span> (default) and
3241ddcf9354c5ab50f4df5a656e72a5c68e172bTinderbox User <span><strong class="command">"ignore"</strong></span>.
3241ddcf9354c5ab50f4df5a656e72a5c68e172bTinderbox User<dt><span class="term">-n <em class="replaceable"><code>mode</code></em></span></dt>
3241ddcf9354c5ab50f4df5a656e72a5c68e172bTinderbox User Specify whether NS records should be checked to see if they
3241ddcf9354c5ab50f4df5a656e72a5c68e172bTinderbox User are addresses. Possible modes are <span><strong class="command">"fail"</strong></span>,
3241ddcf9354c5ab50f4df5a656e72a5c68e172bTinderbox User <span><strong class="command">"warn"</strong></span> (default) and
3241ddcf9354c5ab50f4df5a656e72a5c68e172bTinderbox User <span><strong class="command">"ignore"</strong></span>.
3241ddcf9354c5ab50f4df5a656e72a5c68e172bTinderbox User<dt><span class="term">-o <em class="replaceable"><code>filename</code></em></span></dt>
3241ddcf9354c5ab50f4df5a656e72a5c68e172bTinderbox User Write zone output to <code class="filename">filename</code>.
3241ddcf9354c5ab50f4df5a656e72a5c68e172bTinderbox User<dt><span class="term">-t <em class="replaceable"><code>directory</code></em></span></dt>
260e8e04b0dc24cb884c789b5d9eb046457f264eTinderbox User chroot to <code class="filename">directory</code> so that
3241ddcf9354c5ab50f4df5a656e72a5c68e172bTinderbox User directives in the configuration file are processed as if
3241ddcf9354c5ab50f4df5a656e72a5c68e172bTinderbox User run by a similarly chrooted named.
3241ddcf9354c5ab50f4df5a656e72a5c68e172bTinderbox User<dt><span class="term">-w <em class="replaceable"><code>directory</code></em></span></dt>
3241ddcf9354c5ab50f4df5a656e72a5c68e172bTinderbox User chdir to <code class="filename">directory</code> so that
3241ddcf9354c5ab50f4df5a656e72a5c68e172bTinderbox User filenames in master file $INCLUDE directives work. This
3241ddcf9354c5ab50f4df5a656e72a5c68e172bTinderbox User is similar to the directory clause in
3241ddcf9354c5ab50f4df5a656e72a5c68e172bTinderbox User Dump zone file in canonical format.
3241ddcf9354c5ab50f4df5a656e72a5c68e172bTinderbox User<dt><span class="term">-W <em class="replaceable"><code>mode</code></em></span></dt>
3241ddcf9354c5ab50f4df5a656e72a5c68e172bTinderbox User Specify whether to check for non-terminal wildcards.
3241ddcf9354c5ab50f4df5a656e72a5c68e172bTinderbox User Non-terminal wildcards are almost always the result of a
3241ddcf9354c5ab50f4df5a656e72a5c68e172bTinderbox User failure to understand the wildcard matching algorithm (RFC 1034).
3241ddcf9354c5ab50f4df5a656e72a5c68e172bTinderbox User Possible modes are <span><strong class="command">"warn"</strong></span> (default)
3241ddcf9354c5ab50f4df5a656e72a5c68e172bTinderbox User <span><strong class="command">"ignore"</strong></span>.
3241ddcf9354c5ab50f4df5a656e72a5c68e172bTinderbox User The domain name of the zone being checked.
260e8e04b0dc24cb884c789b5d9eb046457f264eTinderbox User The name of the zone file.
3241ddcf9354c5ab50f4df5a656e72a5c68e172bTinderbox User<a name="id2514488"></a><h2>RETURN VALUES</h2>
3241ddcf9354c5ab50f4df5a656e72a5c68e172bTinderbox User<p><span><strong class="command">named-checkzone</strong></span>
3241ddcf9354c5ab50f4df5a656e72a5c68e172bTinderbox User returns an exit status of 1 if
3241ddcf9354c5ab50f4df5a656e72a5c68e172bTinderbox User errors were detected and 0 otherwise.
3241ddcf9354c5ab50f4df5a656e72a5c68e172bTinderbox User<p><span class="citerefentry"><span class="refentrytitle">named</span>(8)</span>,
3241ddcf9354c5ab50f4df5a656e72a5c68e172bTinderbox User <em class="citetitle">BIND 9 Administrator Reference Manual</em>.
260e8e04b0dc24cb884c789b5d9eb046457f264eTinderbox User<p><span class="corpauthor">Internet Systems Consortium</span>