man.named-checkzone.html revision e3d49a1c84a79b33e3244c9abc29593d74e8af2f
d6fa26d0adaec6c910115be34fe7a5a5f402c14fMark Andrews<!--
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - Copyright (C) 2004-2013 Internet Systems Consortium, Inc. ("ISC")
5347c0fcb04eaea19d9f39795646239f487c6207Tinderbox User - Copyright (C) 2000-2003 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<link rel="start" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual">
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<link rel="up" href="Bv9ARM.ch10.html" title="Manual pages">
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<link rel="prev" href="man.named-checkconf.html" title="named-checkconf">
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<link rel="next" href="man.named.html" title="named">
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein</head>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<div class="navheader">
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<table width="100%" summary="Navigation header">
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<tr><th colspan="3" align="center"><span class="application">named-checkzone</span></th></tr>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<tr>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<td width="20%" align="left">
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<a accesskey="p" href="man.named-checkconf.html">Prev</a>�</td>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<th width="60%" align="center">Manual pages</th>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<td width="20%" align="right">�<a accesskey="n" href="man.named.html">Next</a>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein</td>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User</tr>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt</table>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<hr>
af40ebed6257e4ac1996144530b3de317cf4da11Tinderbox User</div>
af40ebed6257e4ac1996144530b3de317cf4da11Tinderbox User<div class="refentry" lang="en">
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<a name="man.named-checkzone"></a><div class="titlepage"></div>
af40ebed6257e4ac1996144530b3de317cf4da11Tinderbox User<div class="refnamediv">
af40ebed6257e4ac1996144530b3de317cf4da11Tinderbox User<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>
af40ebed6257e4ac1996144530b3de317cf4da11Tinderbox User</div>
af40ebed6257e4ac1996144530b3de317cf4da11Tinderbox 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">-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">-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>
9c6a5d1f22f972232d7a9fd5c5fa64f10bacbdffAutomatic Updater<div class="refsect1" lang="en">
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<a name="id2635900"></a><h2>DESCRIPTION</h2>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<p><span><strong class="command">named-checkzone</strong></span>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein 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
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>
af40ebed6257e4ac1996144530b3de317cf4da11Tinderbox User <span><strong class="command">named-compilezone</strong></span> is similar to
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <span><strong class="command">named-checkzone</strong></span>, but it always dumps the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein zone contents to a specified file in a specified format.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Additionally, it applies stricter check levels by default,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein since the dump output will be used as an actual zone file
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt loaded by <span><strong class="command">named</strong></span>.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein When manually specified otherwise, the check levels must at
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein least be as strict as those specified in the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <span><strong class="command">named</strong></span> configuration file.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </p>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein</div>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<div class="refsect1" lang="en">
727f5b8846457a33d06f515a10a7e1aa849ddf18Andreas Gustafsson<a name="id2635950"></a><h2>OPTIONS</h2>
f293a69bcd1c1dd7bdac8f4102fc2398b9e475c8Eric Luce<div class="variablelist"><dl>
ac93437301f55ed69bf85883a497a75598c628f9Automatic Updater<dt><span class="term">-d</span></dt>
ac93437301f55ed69bf85883a497a75598c628f9Automatic Updater<dd><p>
ac93437301f55ed69bf85883a497a75598c628f9Automatic Updater Enable debugging.
727f5b8846457a33d06f515a10a7e1aa849ddf18Andreas Gustafsson </p></dd>
f293a69bcd1c1dd7bdac8f4102fc2398b9e475c8Eric Luce<dt><span class="term">-h</span></dt>
ac93437301f55ed69bf85883a497a75598c628f9Automatic Updater<dd><p>
ac93437301f55ed69bf85883a497a75598c628f9Automatic Updater 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>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term">-v</span></dt>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<dd><p>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User Print the version of the <span><strong class="command">named-checkzone</strong></span>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein program and exit.
af40ebed6257e4ac1996144530b3de317cf4da11Tinderbox User </p></dd>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<dt><span class="term">-j</span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dd><p>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein 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>
ac93437301f55ed69bf85883a497a75598c628f9Automatic Updater<dd><p>
ac93437301f55ed69bf85883a497a75598c628f9Automatic Updater When loading the zone file read the journal from the given
ac93437301f55ed69bf85883a497a75598c628f9Automatic Updater file, if it exists. (Implies -j.)
ac93437301f55ed69bf85883a497a75598c628f9Automatic Updater </p></dd>
ac93437301f55ed69bf85883a497a75598c628f9Automatic Updater<dt><span class="term">-c <em class="replaceable"><code>class</code></em></span></dt>
ac93437301f55ed69bf85883a497a75598c628f9Automatic Updater<dd><p>
ac93437301f55ed69bf85883a497a75598c628f9Automatic Updater Specify the class of the zone. If not specified, "IN" is assumed.
ac93437301f55ed69bf85883a497a75598c628f9Automatic Updater </p></dd>
f293a69bcd1c1dd7bdac8f4102fc2398b9e475c8Eric Luce<dt><span class="term">-i <em class="replaceable"><code>mode</code></em></span></dt>
f293a69bcd1c1dd7bdac8f4102fc2398b9e475c8Eric Luce<dd>
ac93437301f55ed69bf85883a497a75598c628f9Automatic Updater<p>
ac93437301f55ed69bf85883a497a75598c628f9Automatic Updater Perform post-load zone integrity checks. Possible modes are
f293a69bcd1c1dd7bdac8f4102fc2398b9e475c8Eric Luce <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
ac93437301f55ed69bf85883a497a75598c628f9Automatic Updater hostnames). Mode <span><strong class="command">"local"</strong></span> only
ac93437301f55ed69bf85883a497a75598c628f9Automatic Updater 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.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein 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,
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User that is when the nameserver is in a child zone.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User </p>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<p>
af40ebed6257e4ac1996144530b3de317cf4da11Tinderbox User Mode <span><strong class="command">"full-sibling"</strong></span> and
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <span><strong class="command">"local-sibling"</strong></span> disable sibling glue
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein checks but are otherwise the same as <span><strong class="command">"full"</strong></span>
1224c3b69b3d18f7127aa042644936af25a2d679Mark Andrews and <span><strong class="command">"local"</strong></span> respectively.
1224c3b69b3d18f7127aa042644936af25a2d679Mark Andrews </p>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<p>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User Mode <span><strong class="command">"none"</strong></span> disables the checks.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </p>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein</dd>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term">-f <em class="replaceable"><code>format</code></em></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dd><p>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Specify the format of the zone file.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User Possible formats are <span><strong class="command">"text"</strong></span> (default),
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <span><strong class="command">"raw"</strong></span>, and <span><strong class="command">"map"</strong></span>.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt </p></dd>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<dt><span class="term">-F <em class="replaceable"><code>format</code></em></span></dt>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<dd>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<p>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt Specify the format of the output file specified.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein 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.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </p>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<p>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Possible formats are <span><strong class="command">"text"</strong></span> (default),
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein which is the standard textual representation of the zone,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein and <span><strong class="command">"map"</strong></span>, <span><strong class="command">"raw"</strong></span>,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein and <span><strong class="command">"raw=N"</strong></span>, which store the zone in a
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein binary format for rapid loading by <span><strong class="command">named</strong></span>.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <span><strong class="command">"raw=N"</strong></span> specifies the format version of
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein the raw zone file: if N is 0, the raw file can be read by
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein any version of <span><strong class="command">named</strong></span>; if N is 1, the file
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein can be read by release 9.9.0 or higher; the default is 1.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </p>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein</dd>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term">-k <em class="replaceable"><code>mode</code></em></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dd><p>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Perform <span><strong class="command">"check-names"</strong></span> checks with the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein specified failure mode.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Possible modes are <span><strong class="command">"fail"</strong></span>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein (default for <span><strong class="command">named-compilezone</strong></span>),
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <span><strong class="command">"warn"</strong></span>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein (default for <span><strong class="command">named-checkzone</strong></span>) and
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <span><strong class="command">"ignore"</strong></span>.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </p></dd>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term">-L <em class="replaceable"><code>serial</code></em></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dd><p>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein When compiling a zone to "raw" or "map" format, set the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein "source serial" value in the header to the specified serial
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein number. (This is expected to be used primarily for testing
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein purposes.)
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </p></dd>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term">-m <em class="replaceable"><code>mode</code></em></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dd><p>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Specify whether MX records should be checked to see if they
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein are addresses. Possible modes are <span><strong class="command">"fail"</strong></span>,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <span><strong class="command">"warn"</strong></span> (default) and
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <span><strong class="command">"ignore"</strong></span>.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </p></dd>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term">-M <em class="replaceable"><code>mode</code></em></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dd><p>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Check if a MX record refers to a CNAME.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Possible modes are <span><strong class="command">"fail"</strong></span>,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <span><strong class="command">"warn"</strong></span> (default) and
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <span><strong class="command">"ignore"</strong></span>.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </p></dd>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term">-n <em class="replaceable"><code>mode</code></em></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dd><p>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Specify whether NS records should be checked to see if they
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein are addresses.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Possible modes are <span><strong class="command">"fail"</strong></span>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein (default for <span><strong class="command">named-compilezone</strong></span>),
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <span><strong class="command">"warn"</strong></span>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein (default for <span><strong class="command">named-checkzone</strong></span>) and
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <span><strong class="command">"ignore"</strong></span>.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </p></dd>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term">-o <em class="replaceable"><code>filename</code></em></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dd><p>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Write zone output to <code class="filename">filename</code>.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein If <code class="filename">filename</code> is <code class="filename">-</code> then
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein write to standard out.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein This is mandatory for <span><strong class="command">named-compilezone</strong></span>.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </p></dd>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term">-r <em class="replaceable"><code>mode</code></em></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dd><p>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Check for records that are treated as different by DNSSEC but
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein are semantically equal in plain DNS.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Possible modes are <span><strong class="command">"fail"</strong></span>,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <span><strong class="command">"warn"</strong></span> (default) and
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <span><strong class="command">"ignore"</strong></span>.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </p></dd>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term">-s <em class="replaceable"><code>style</code></em></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dd><p>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Specify the style of the dumped zone file.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Possible styles are <span><strong class="command">"full"</strong></span> (default)
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein and <span><strong class="command">"relative"</strong></span>.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein The full format is most suitable for processing
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein automatically by a separate script.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein On the other hand, the relative format is more
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein human-readable and is thus suitable for editing by hand.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein 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.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein It also does not have any meaning if the output format
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein is not text.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </p></dd>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term">-S <em class="replaceable"><code>mode</code></em></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dd><p>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Check if a SRV record refers to a CNAME.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Possible modes are <span><strong class="command">"fail"</strong></span>,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <span><strong class="command">"warn"</strong></span> (default) and
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <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>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Chroot to <code class="filename">directory</code> so that
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein include
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein directives in the configuration file are processed as if
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein run by a similarly chrooted named.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </p></dd>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term">-w <em class="replaceable"><code>directory</code></em></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dd><p>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein chdir to <code class="filename">directory</code> so that
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein relative
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein filenames in master file $INCLUDE directives work. This
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein is similar to the directory clause in
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <code class="filename">named.conf</code>.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User </p></dd>
71c66a876ecca77923638d3f94cc0783152b2f03Mark Andrews<dt><span class="term">-D</span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dd><p>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Dump zone file in canonical format.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein This is always enabled for <span><strong class="command">named-compilezone</strong></span>.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </p></dd>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term">-W <em class="replaceable"><code>mode</code></em></span></dt>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<dd><p>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Specify whether to check for non-terminal wildcards.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt Non-terminal wildcards are almost always the result of a
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt failure to understand the wildcard matching algorithm (RFC 1034).
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt Possible modes are <span><strong class="command">"warn"</strong></span> (default)
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein and
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <span><strong class="command">"ignore"</strong></span>.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User </p></dd>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term">zonename</span></dt>
af40ebed6257e4ac1996144530b3de317cf4da11Tinderbox User<dd><p>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User The domain name of the zone being checked.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </p></dd>
af40ebed6257e4ac1996144530b3de317cf4da11Tinderbox User<dt><span class="term">filename</span></dt>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<dd><p>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews The name of the zone file.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </p></dd>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews</dl></div>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews</div>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<div class="refsect1" lang="en">
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<a name="id2679190"></a><h2>RETURN VALUES</h2>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<p><span><strong class="command">named-checkzone</strong></span>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein returns an exit status of 1 if
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User errors were detected and 0 otherwise.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt </p>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt</div>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<div class="refsect1" lang="en">
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<a name="id2679204"></a><h2>SEE ALSO</h2>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<p><span class="citerefentry"><span class="refentrytitle">named</span>(8)</span>,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <span class="citerefentry"><span class="refentrytitle">named-checkconf</span>(8)</span>,
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <em class="citetitle">RFC 1035</em>,
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <em class="citetitle">BIND 9 Administrator Reference Manual</em>.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </p>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User</div>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<div class="refsect1" lang="en">
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<a name="id2679237"></a><h2>AUTHOR</h2>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<p><span class="corpauthor">Internet Systems Consortium</span>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </p>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein</div>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein</div>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<div class="navfooter">
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<hr>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<table width="100%" summary="Navigation footer">
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<tr>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<td width="40%" align="left">
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<a accesskey="p" href="man.named-checkconf.html">Prev</a>�</td>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<td width="20%" align="center"><a accesskey="u" href="Bv9ARM.ch10.html">Up</a></td>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<td width="40%" align="right">�<a accesskey="n" href="man.named.html">Next</a>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt</td>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein</tr>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<tr>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<td width="40%" align="left" valign="top">
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<span class="application">named-checkconf</span>�</td>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<td width="20%" align="center"><a accesskey="h" href="Bv9ARM.html">Home</a></td>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<td width="40%" align="right" valign="top">�<span class="application">named</span>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User</td>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt</tr>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein</table>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User</div>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt</body>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein</html>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein