named-checkzone.html revision 285254345ce5ab270848f8c11f7be146793f1e00
205c10066a0acfeac52d1a135671f41d207b8557Automatic Updater - Copyright (C) 2004-2006 Internet Systems Consortium, Inc. ("ISC")
205c10066a0acfeac52d1a135671f41d207b8557Automatic Updater - Copyright (C) 2000-2002 Internet Software Consortium.
0c39b3ed9409ecb277d5e32fa763a4e4d6598df8Automatic Updater - Permission to use, copy, modify, and distribute this software for any
46da3117812814a29432a8d9a9ccf8acdbfdadceAutomatic Updater - purpose with or without fee is hereby granted, provided that the above
2bb3422dc683c013db7042f5736240de6b86f182Automatic Updater - copyright notice and this permission notice appear in all copies.
2ec4ab21838e218863d052ebfa3e106e04f50820Evan Hunt - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
ea854b585041ad19f70f7af15e08144ef2c2bd1bMark Andrews - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
78cb74fab4665da2e2641ba909c6f59f74cc4193Automatic Updater - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
cd0aa2d941d1438fabb5337f1f38c49478edf71dAutomatic Updater - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
90ff38a0d8deaf5f9c2aa5916d99b2e572d28738Automatic Updater - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
ac4e70ff8955669341f435bc0a734a17c01af124Mark Andrews - PERFORMANCE OF THIS SOFTWARE.
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington<!-- $Id: named-checkzone.html,v 1.34 2006/08/31 00:19:51 marka Exp $ -->
56874aef380a64a2c183b7c282c3e7a361d67fa1Automatic Updater<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
58be84825d7f5de30e50eb7206b37227ecd8055bAutomatic Updater<meta name="generator" content="DocBook XSL Stylesheets V1.70.1">
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en">
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews<a name="man.named-checkzone"></a><div class="titlepage"></div>
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews<p><span class="application">named-checkzone</span>, <span class="application">named-compilezone</span> — zone file validity checking or converting tool</p>
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson<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">-f <em class="replaceable"><code>format</code></em></code>] [<code class="option">-F <em class="replaceable"><code>format</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">-o <em class="replaceable"><code>filename</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>
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updater<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">-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">-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>] {zonename} {filename}</p></div>
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updater<a name="id2549722"></a><h2>DESCRIPTION</h2>
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updater<p><span><strong class="command">named-checkzone</strong></span>
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updater checks the syntax and integrity of a zone file. It performs the
aa9c561961e9d877946ebaa8795fa2be054ab7bfEvan Hunt same checks as <span><strong class="command">named</strong></span> does when loading a
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updater zone. This makes <span><strong class="command">named-checkzone</strong></span> useful for
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updater checking zone files before configuring them into a name server.
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updater <span><strong class="command">named-compilezone</strong></span> is similar to
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updater <span><strong class="command">named-checkzone</strong></span>, but it always dumps the
aa9c561961e9d877946ebaa8795fa2be054ab7bfEvan Hunt zone contents to a specified file in a specified format.
2d2dc37599979c83495510f8af8d1756753aa2c5Automatic Updater Additionally, it applies stricter check levels by default,
2d2dc37599979c83495510f8af8d1756753aa2c5Automatic Updater since the dump output will be used as an actual zone file
aa9c561961e9d877946ebaa8795fa2be054ab7bfEvan Hunt loaded by <span><strong class="command">named</strong></span>.
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updater When manaully specified otherwise, the check levels must at
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updater least be as strict as those specified in the
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updater <span><strong class="command">named</strong></span> configuration file.
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updater Enable debugging.
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington Quiet mode - exit code only.
129090f0f6f91753b4a085ab635e28549fd018adAutomatic Updater Print the version of the <span><strong class="command">named-checkzone</strong></span>
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews program and exit.
80faf1588895fd26490f82f95a7a1b771df1c324Automatic Updater When loading the zone file read the journal if it exists.
1a06700908f5a1d9f4a8d51285a0fd971e2f9117Automatic Updater<dt><span class="term">-c <em class="replaceable"><code>class</code></em></span></dt>
db5b7e2cdf150c46e8242d3e2e3ad3f5c7300258Automatic Updater Specify the class of the zone. If not specified "IN" is assumed.
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews<dt><span class="term">-i <em class="replaceable"><code>mode</code></em></span></dt>
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updater Perform post load zone integrity checks. Possible modes are
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updater <span><strong class="command">"full"</strong></span> (default),
efb0e886f18894a1d2489f1ad74ad14b579e11c7Mark Andrews <span><strong class="command">"full-sibling"</strong></span>,
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updater <span><strong class="command">"local"</strong></span>,
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson <span><strong class="command">"local-sibling"</strong></span> and
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updater <span><strong class="command">"none"</strong></span>.
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updater Mode <span><strong class="command">"full"</strong></span> checks that MX records
dd65eb1efb40b1c47d57963192bfc54873b219beAutomatic Updater refer to A or AAAA record (both in-zone and out-of-zone
dd65eb1efb40b1c47d57963192bfc54873b219beAutomatic Updater hostnames). Mode <span><strong class="command">"local"</strong></span> only
78f3ed4bc2fcd3d270bfd599804f3b27a1db4d91Mark Andrews checks MX records which refer to in-zone hostnames.
78f3ed4bc2fcd3d270bfd599804f3b27a1db4d91Mark Andrews Mode <span><strong class="command">"full"</strong></span> checks that SRV records
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont refer to A or AAAA record (both in-zone and out-of-zone
0c39b3ed9409ecb277d5e32fa763a4e4d6598df8Automatic Updater hostnames). Mode <span><strong class="command">"local"</strong></span> only
0c39b3ed9409ecb277d5e32fa763a4e4d6598df8Automatic Updater checks SRV records which refer to in-zone hostnames.
f9119ad8f6114b2255e7545bf5cd187f4db0a89bAutomatic Updater Mode <span><strong class="command">"full"</strong></span> checks that delegation NS
e23256e740b238bddb4ba41ffac5f81a01c92245Automatic Updater records refer to A or AAAA record (both in-zone and out-of-zone
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews hostnames). It also checks that glue addresses records
78f3ed4bc2fcd3d270bfd599804f3b27a1db4d91Mark Andrews in the zone match those advertised by the child.
08e3b6797706a13054bad749dea04e94b514b8e7Automatic Updater Mode <span><strong class="command">"local"</strong></span> only checks NS records which
dd65eb1efb40b1c47d57963192bfc54873b219beAutomatic Updater refer to in-zone hostnames or that some required glue exists,
78f3ed4bc2fcd3d270bfd599804f3b27a1db4d91Mark Andrews that is when the nameserver is in a child zone.
418cc932318b1d67f88a36904d88d8a5a0a2ba09Automatic Updater Mode <span><strong class="command">"full-sibling"</strong></span> and
78f3ed4bc2fcd3d270bfd599804f3b27a1db4d91Mark Andrews <span><strong class="command">"local-sibling"</strong></span> disable sibling glue
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews checks but are otherwise the same as <span><strong class="command">"full"</strong></span>
0977f3f39ef6728516be7976452b9122c8f5607aAutomatic Updater and <span><strong class="command">"local"</strong></span> respectively.
0c39b3ed9409ecb277d5e32fa763a4e4d6598df8Automatic Updater Mode <span><strong class="command">"none"</strong></span> disables the checks.
cdfc81e048bd34c1d628380247bda6b80a89e20eAutomatic Updater<dt><span class="term">-f <em class="replaceable"><code>format</code></em></span></dt>
fe80a4909bf62b602feaf246866e9d29f7654194Automatic Updater Specify the format of the zone file.
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updater Possible formats are <span><strong class="command">"text"</strong></span> (default)
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updater and <span><strong class="command">"raw"</strong></span>.
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updater<dt><span class="term">-F <em class="replaceable"><code>format</code></em></span></dt>
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson Specify the format of the output file specified.
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updater Possible formats are <span><strong class="command">"text"</strong></span> (default)
aa1d397c4736cd86540555193d71e55fa3b37b2aMark Andrews and <span><strong class="command">"raw"</strong></span>.
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson For <span><strong class="command">named-checkzone</strong></span>,
dd65eb1efb40b1c47d57963192bfc54873b219beAutomatic Updater this does not cause any effects unless it dumps the zone
133e6d43fa82e80d3798be4de00f4540f485ec6cAutomatic Updater<dt><span class="term">-k <em class="replaceable"><code>mode</code></em></span></dt>
133e6d43fa82e80d3798be4de00f4540f485ec6cAutomatic Updater Perform <span><strong class="command">"check-name"</strong></span> checks with the
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updater specified failure mode.
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson Possible modes are <span><strong class="command">"fail"</strong></span>
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updater (default for <span><strong class="command">named-compilezone</strong></span>),
4104e236f71eb5108fcfda6711878a97f6f4a8e7Automatic Updater <span><strong class="command">"warn"</strong></span>
27794bebe2634b5ac374e78972649c79300b876aAutomatic Updater (default for <span><strong class="command">named-checkzone</strong></span>) and
27794bebe2634b5ac374e78972649c79300b876aAutomatic Updater <span><strong class="command">"ignore"</strong></span>.
0ce87e5749aabb8eef1e0a37e4bd6e6ffa1d7196Automatic Updater<dt><span class="term">-m <em class="replaceable"><code>mode</code></em></span></dt>
be63e68c516117af6af8850904e46a89c7d4423eAutomatic Updater Specify whether MX records should be checked to see if they
59528addd704f8d5757b54e540520f74e588a7c7Automatic Updater are addresses. Possible modes are <span><strong class="command">"fail"</strong></span>,
c453a50776145e9c1c3fc9c846cfa11f42505081Automatic Updater <span><strong class="command">"warn"</strong></span> (default) and
f4029eb7463e99df00618de89f0bee5ac062a237Automatic Updater <span><strong class="command">"ignore"</strong></span>.
d145b64cacc8d9cda51f9924ec70cd4661c3e2cfAutomatic Updater<dt><span class="term">-M <em class="replaceable"><code>mode</code></em></span></dt>
59528addd704f8d5757b54e540520f74e588a7c7Automatic Updater Check if a MX record refers to a CNAME.
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updater Possible modes are <span><strong class="command">"fail"</strong></span>,
f4029eb7463e99df00618de89f0bee5ac062a237Automatic Updater <span><strong class="command">"warn"</strong></span> (default) and
e628576d3b3d91c8954679077f4c208f1e43b433Automatic Updater <span><strong class="command">"ignore"</strong></span>.
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater<dt><span class="term">-n <em class="replaceable"><code>mode</code></em></span></dt>
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater Specify whether NS records should be checked to see if they
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater are addresses.
59528addd704f8d5757b54e540520f74e588a7c7Automatic Updater Possible modes are <span><strong class="command">"fail"</strong></span>
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater (default for <span><strong class="command">named-compilezone</strong></span>),
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater <span><strong class="command">"warn"</strong></span>
7f79131f9a8e804b93c57f3c679065cce878b726Automatic Updater (default for <span><strong class="command">named-checkzone</strong></span>) and
59528addd704f8d5757b54e540520f74e588a7c7Automatic Updater <span><strong class="command">"ignore"</strong></span>.
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater<dt><span class="term">-o <em class="replaceable"><code>filename</code></em></span></dt>
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater Write zone output to <code class="filename">filename</code>.
19b3dc94bce93fa76bd7e066f9298630dbc9dcb4Automatic Updater This is mandatory for <span><strong class="command">named-compilezone</strong></span>.
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updater<dt><span class="term">-s <em class="replaceable"><code>style</code></em></span></dt>
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater Specify the style of the dumped zone file.
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater Possible styles are <span><strong class="command">"full"</strong></span> (default)
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater and <span><strong class="command">"relative"</strong></span>.
59528addd704f8d5757b54e540520f74e588a7c7Automatic Updater The full format is most suitable for processing
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater automatically by a separate script.
71bd43eebd9d6e42dbcae62b730f5b6508d5acd8Automatic Updater On the other hand, the relative format is more
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater human-readable and is thus suitable for editing by hand.
7262eb86f2b465822206122921e2f357218f0cfdAutomatic Updater For <span><strong class="command">named-checkzone</strong></span>
96ea71632887c58a9d00f47eb318bf76b35903c3Mark Andrews this does not cause any effects unless it dumps the zone
9cd5eb6fe0f26d65724b99216cb31dcdd12e4afdAutomatic Updater It also does not have any meaning if the output format
4cda4fd158d6ded5586bacea8c388445d99611eaAutomatic Updater<dt><span class="term">-S <em class="replaceable"><code>mode</code></em></span></dt>
9cd5eb6fe0f26d65724b99216cb31dcdd12e4afdAutomatic Updater Check if a SRV record refers to a CNAME.
80faf1588895fd26490f82f95a7a1b771df1c324Automatic Updater Possible modes are <span><strong class="command">"fail"</strong></span>,
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews <span><strong class="command">"warn"</strong></span> (default) and
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater <span><strong class="command">"ignore"</strong></span>.
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews<dt><span class="term">-t <em class="replaceable"><code>directory</code></em></span></dt>
c453a50776145e9c1c3fc9c846cfa11f42505081Automatic Updater chroot to <code class="filename">directory</code> so that
f7c88d61cc1ad2435b0b7cfaedfc9d5248c0be25Automatic Updater directives in the configuration file are processed as if
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews run by a similarly chrooted named.
957a8884fb712885cdd8ef0474f5ff95ddc46b20Automatic Updater<dt><span class="term">-w <em class="replaceable"><code>directory</code></em></span></dt>
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater chdir to <code class="filename">directory</code> so that
9cd5eb6fe0f26d65724b99216cb31dcdd12e4afdAutomatic Updater filenames in master file $INCLUDE directives work. This
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updater is similar to the directory clause in
bf9b61c7904437745aeeb0f7d5036b35dad2a8a5Automatic Updater Dump zone file in canonical format.
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater This is always enabled for <span><strong class="command">named-compilezone</strong></span>.
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updater<dt><span class="term">-W <em class="replaceable"><code>mode</code></em></span></dt>
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updater Specify whether to check for non-terminal wildcards.
361bec4bdec45042897fb479b7071cd05bbd56b9Automatic Updater Non-terminal wildcards are almost always the result of a
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updater failure to understand the wildcard matching algorithm (RFC 1034).
48b36fa08b2b5bc0d552dc2a4425b3f7007b3d59Automatic Updater Possible modes are <span><strong class="command">"warn"</strong></span> (default)
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington <span><strong class="command">"ignore"</strong></span>.
7858b0168b866c0c2878fc4ea31fb5e581c1a6a9Automatic Updater The domain name of the zone being checked.
9174e44c14b1cb91a651fa1dc29470438c246ab9Automatic Updater<dt><span class="term">filename</span></dt>
e2caa7536302de34de6cc04025abcd53dc3a499aAutomatic Updater The name of the zone file.
7d12a6b412fe47e6d6582923fd6954ab8cd0baebAutomatic Updater<a name="id2550425"></a><h2>RETURN VALUES</h2>
7d12a6b412fe47e6d6582923fd6954ab8cd0baebAutomatic Updater<p><span><strong class="command">named-checkzone</strong></span>
699487d8026a2b931bdce8ce3ae6bc1025d639fbMark Andrews returns an exit status of 1 if
ca35524ce2b57e6f1b261d23565d1288a355d12fAutomatic Updater errors were detected and 0 otherwise.
78f3ed4bc2fcd3d270bfd599804f3b27a1db4d91Mark Andrews<p><span class="citerefentry"><span class="refentrytitle">named</span>(8)</span>,
7d12a6b412fe47e6d6582923fd6954ab8cd0baebAutomatic Updater <em class="citetitle">BIND 9 Administrator Reference Manual</em>.
78f3ed4bc2fcd3d270bfd599804f3b27a1db4d91Mark Andrews<p><span class="corpauthor">Internet Systems Consortium</span>