man.named-checkzone.html revision ef8014e56f35bb36daa5fd2c313f5e7963e97aa1
0c27b3fe77ac1d5094ba3521e8142d9e7973133fMark Andrews - Copyright (C) 2004-2015 Internet Systems Consortium, Inc. ("ISC")
5597be9bb88de138dfec9fa9176708443813925eTatuya JINMEI 神明達哉 - Copyright (C) 2000-2003 Internet Software Consortium.
0c27b3fe77ac1d5094ba3521e8142d9e7973133fMark Andrews - Permission to use, copy, modify, and/or distribute this software for any
0c27b3fe77ac1d5094ba3521e8142d9e7973133fMark Andrews - purpose with or without fee is hereby granted, provided that the above
5597be9bb88de138dfec9fa9176708443813925eTatuya JINMEI 神明達哉 - copyright notice and this permission notice appear in all copies.
cbf0854acc9f5d11142dba30b1ab23e0532baaf2Automatic Updater - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
5597be9bb88de138dfec9fa9176708443813925eTatuya JINMEI 神明達哉 - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
5597be9bb88de138dfec9fa9176708443813925eTatuya JINMEI 神明達哉 - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
5597be9bb88de138dfec9fa9176708443813925eTatuya JINMEI 神明達哉 - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
5597be9bb88de138dfec9fa9176708443813925eTatuya JINMEI 神明達哉 - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
5597be9bb88de138dfec9fa9176708443813925eTatuya JINMEI 神明達哉 - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
5597be9bb88de138dfec9fa9176708443813925eTatuya JINMEI 神明達哉 - PERFORMANCE OF THIS SOFTWARE.
5597be9bb88de138dfec9fa9176708443813925eTatuya JINMEI 神明達哉<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
a84724de8db9e52857fb11bbcdb195658f9a05b2Michael Graff<meta name="generator" content="DocBook XSL Stylesheets V1.71.1">
5597be9bb88de138dfec9fa9176708443813925eTatuya JINMEI 神明達哉<link rel="start" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual">
5597be9bb88de138dfec9fa9176708443813925eTatuya JINMEI 神明達哉<link rel="up" href="Bv9ARM.ch13.html" title="Manual pages">
5597be9bb88de138dfec9fa9176708443813925eTatuya JINMEI 神明達哉<link rel="prev" href="man.named-checkconf.html" title="named-checkconf">
5597be9bb88de138dfec9fa9176708443813925eTatuya JINMEI 神明達哉<link rel="next" href="man.named.html" title="named">
5597be9bb88de138dfec9fa9176708443813925eTatuya JINMEI 神明達哉<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
5597be9bb88de138dfec9fa9176708443813925eTatuya JINMEI 神明達哉<table width="100%" summary="Navigation header">
5597be9bb88de138dfec9fa9176708443813925eTatuya JINMEI 神明達哉<tr><th colspan="3" align="center"><span class="application">named-checkzone</span></th></tr>
5597be9bb88de138dfec9fa9176708443813925eTatuya JINMEI 神明達哉<a accesskey="p" href="man.named-checkconf.html">Prev</a>�</td>
5597be9bb88de138dfec9fa9176708443813925eTatuya JINMEI 神明達哉<th width="60%" align="center">Manual pages</th>
5597be9bb88de138dfec9fa9176708443813925eTatuya JINMEI 神明達哉<td width="20%" align="right">�<a accesskey="n" href="man.named.html">Next</a>
1c3ed2a83d176d9023b51b60dfc96c133f678362Tatuya JINMEI 神明達哉<a name="man.named-checkzone"></a><div class="titlepage"></div>
1c3ed2a83d176d9023b51b60dfc96c133f678362Tatuya JINMEI 神明達哉<p><span class="application">named-checkzone</span>, <span class="application">named-compilezone</span> — zone file validity checking or converting tool</p>
1c3ed2a83d176d9023b51b60dfc96c133f678362Tatuya JINMEI 神明達哉<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>ttl</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>
1c3ed2a83d176d9023b51b60dfc96c133f678362Tatuya JINMEI 神明達哉<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>ttl</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>
1c3ed2a83d176d9023b51b60dfc96c133f678362Tatuya JINMEI 神明達哉<a name="id2676875"></a><h2>DESCRIPTION</h2>
1c3ed2a83d176d9023b51b60dfc96c133f678362Tatuya JINMEI 神明達哉<p><span><strong class="command">named-checkzone</strong></span>
5597be9bb88de138dfec9fa9176708443813925eTatuya JINMEI 神明達哉 checks the syntax and integrity of a zone file. It performs the
821ff5e8fa1df2e09fea157ee3e298eef6cf4ec9Evan Hunt same checks as <span><strong class="command">named</strong></span> does when loading a
5597be9bb88de138dfec9fa9176708443813925eTatuya JINMEI 神明達哉 zone. This makes <span><strong class="command">named-checkzone</strong></span> useful for
a84724de8db9e52857fb11bbcdb195658f9a05b2Michael Graff checking zone files before configuring them into a name server.
5597be9bb88de138dfec9fa9176708443813925eTatuya JINMEI 神明達哉 <span><strong class="command">named-compilezone</strong></span> is similar to
5597be9bb88de138dfec9fa9176708443813925eTatuya JINMEI 神明達哉 <span><strong class="command">named-checkzone</strong></span>, but it always dumps the
5597be9bb88de138dfec9fa9176708443813925eTatuya JINMEI 神明達哉 zone contents to a specified file in a specified format.
5597be9bb88de138dfec9fa9176708443813925eTatuya JINMEI 神明達哉 Additionally, it applies stricter check levels by default,
5597be9bb88de138dfec9fa9176708443813925eTatuya JINMEI 神明達哉 since the dump output will be used as an actual zone file
cbf0854acc9f5d11142dba30b1ab23e0532baaf2Automatic Updater loaded by <span><strong class="command">named</strong></span>.
5597be9bb88de138dfec9fa9176708443813925eTatuya JINMEI 神明達哉 When manually specified otherwise, the check levels must at
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉 least be as strict as those specified in the
5597be9bb88de138dfec9fa9176708443813925eTatuya JINMEI 神明達哉 <span><strong class="command">named</strong></span> configuration file.
821ff5e8fa1df2e09fea157ee3e298eef6cf4ec9Evan Hunt Enable debugging.
821ff5e8fa1df2e09fea157ee3e298eef6cf4ec9Evan Hunt Print the usage summary and exit.
821ff5e8fa1df2e09fea157ee3e298eef6cf4ec9Evan Hunt Quiet mode - exit code only.
821ff5e8fa1df2e09fea157ee3e298eef6cf4ec9Evan Hunt Print the version of the <span><strong class="command">named-checkzone</strong></span>
821ff5e8fa1df2e09fea157ee3e298eef6cf4ec9Evan Hunt program and exit.
821ff5e8fa1df2e09fea157ee3e298eef6cf4ec9Evan Hunt When loading a zone file, read the journal if it exists.
821ff5e8fa1df2e09fea157ee3e298eef6cf4ec9Evan Hunt The journal file name is assumed to be the zone file name
821ff5e8fa1df2e09fea157ee3e298eef6cf4ec9Evan Hunt appended with the string <code class="filename">.jnl</code>.
5597be9bb88de138dfec9fa9176708443813925eTatuya JINMEI 神明達哉<dt><span class="term">-J <em class="replaceable"><code>filename</code></em></span></dt>
5597be9bb88de138dfec9fa9176708443813925eTatuya JINMEI 神明達哉 When loading the zone file read the journal from the given
5597be9bb88de138dfec9fa9176708443813925eTatuya JINMEI 神明達哉 file, if it exists. (Implies -j.)
5597be9bb88de138dfec9fa9176708443813925eTatuya JINMEI 神明達哉<dt><span class="term">-c <em class="replaceable"><code>class</code></em></span></dt>
5597be9bb88de138dfec9fa9176708443813925eTatuya JINMEI 神明達哉 Specify the class of the zone. If not specified, "IN" is assumed.
5597be9bb88de138dfec9fa9176708443813925eTatuya JINMEI 神明達哉<dt><span class="term">-i <em class="replaceable"><code>mode</code></em></span></dt>
5597be9bb88de138dfec9fa9176708443813925eTatuya JINMEI 神明達哉 Perform post-load zone integrity checks. Possible modes are
5597be9bb88de138dfec9fa9176708443813925eTatuya JINMEI 神明達哉 <span><strong class="command">"full"</strong></span> (default),
5597be9bb88de138dfec9fa9176708443813925eTatuya JINMEI 神明達哉 <span><strong class="command">"full-sibling"</strong></span>,
5597be9bb88de138dfec9fa9176708443813925eTatuya JINMEI 神明達哉 <span><strong class="command">"local"</strong></span>,
5597be9bb88de138dfec9fa9176708443813925eTatuya JINMEI 神明達哉 <span><strong class="command">"local-sibling"</strong></span> and
5597be9bb88de138dfec9fa9176708443813925eTatuya JINMEI 神明達哉 <span><strong class="command">"none"</strong></span>.
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉 Mode <span><strong class="command">"full"</strong></span> checks that MX records
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉 refer to A or AAAA record (both in-zone and out-of-zone
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉 hostnames). Mode <span><strong class="command">"local"</strong></span> only
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉 checks MX records which refer to in-zone hostnames.
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉 Mode <span><strong class="command">"full"</strong></span> checks that SRV records
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉 refer to A or AAAA record (both in-zone and out-of-zone
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉 hostnames). Mode <span><strong class="command">"local"</strong></span> only
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉 checks SRV records which refer to in-zone hostnames.
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉 Mode <span><strong class="command">"full"</strong></span> checks that delegation NS
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉 records refer to A or AAAA record (both in-zone and out-of-zone
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉 hostnames). It also checks that glue address records
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉 in the zone match those advertised by the child.
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉 Mode <span><strong class="command">"local"</strong></span> only checks NS records which
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉 refer to in-zone hostnames or that some required glue exists,
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉 that is when the nameserver is in a child zone.
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉 Mode <span><strong class="command">"full-sibling"</strong></span> and
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉 <span><strong class="command">"local-sibling"</strong></span> disable sibling glue
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉 checks but are otherwise the same as <span><strong class="command">"full"</strong></span>
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉 and <span><strong class="command">"local"</strong></span> respectively.
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉 Mode <span><strong class="command">"none"</strong></span> disables the checks.
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉<dt><span class="term">-f <em class="replaceable"><code>format</code></em></span></dt>
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉 Specify the format of the zone file.
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉 Possible formats are <span><strong class="command">"text"</strong></span> (default),
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉 <span><strong class="command">"raw"</strong></span>, and <span><strong class="command">"map"</strong></span>.
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉<dt><span class="term">-F <em class="replaceable"><code>format</code></em></span></dt>
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉 Specify the format of the output file specified.
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉 For <span><strong class="command">named-checkzone</strong></span>,
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉 this does not cause any effects unless it dumps the zone
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉 Possible formats are <span><strong class="command">"text"</strong></span> (default),
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉 which is the standard textual representation of the zone,
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉 and <span><strong class="command">"map"</strong></span>, <span><strong class="command">"raw"</strong></span>,
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉 and <span><strong class="command">"raw=N"</strong></span>, which store the zone in a
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉 binary format for rapid loading by <span><strong class="command">named</strong></span>.
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉 <span><strong class="command">"raw=N"</strong></span> specifies the format version of
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉 the raw zone file: if N is 0, the raw file can be read by
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉 any version of <span><strong class="command">named</strong></span>; if N is 1, the file
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉 can be read by release 9.9.0 or higher; the default is 1.
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉<dt><span class="term">-k <em class="replaceable"><code>mode</code></em></span></dt>
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉 Perform <span><strong class="command">"check-names"</strong></span> checks with the
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉 specified failure mode.
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉 Possible modes are <span><strong class="command">"fail"</strong></span>
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉 (default for <span><strong class="command">named-compilezone</strong></span>),
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉 <span><strong class="command">"warn"</strong></span>
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉 (default for <span><strong class="command">named-checkzone</strong></span>) and
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉 <span><strong class="command">"ignore"</strong></span>.
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉<dt><span class="term">-l <em class="replaceable"><code>ttl</code></em></span></dt>
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉 Sets a maximum permissible TTL for the input file.
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉 Any record with a TTL higher than this value will cause
c528bd698637d84a0081d26a58813607c7f52bb7Tatuya JINMEI 神明達哉 the zone to be rejected. This is similar to using the
5597be9bb88de138dfec9fa9176708443813925eTatuya JINMEI 神明達哉 <span><strong class="command">max-zone-ttl</strong></span> option in