Merge branch 'vendor/FILE'
[dragonfly.git] / contrib / bind / bin / check / named-checkzone.html
1 <!--
2  - Copyright (C) 2004-2007, 2009 Internet Systems Consortium, Inc. ("ISC")
3  - Copyright (C) 2000-2002 Internet Software Consortium.
4  - 
5  - Permission to use, copy, modify, and/or distribute this software for any
6  - purpose with or without fee is hereby granted, provided that the above
7  - copyright notice and this permission notice appear in all copies.
8  - 
9  - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
10  - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
11  - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
12  - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
13  - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
14  - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
15  - PERFORMANCE OF THIS SOFTWARE.
16 -->
17 <!-- $Id: named-checkzone.html,v 1.42.130.2 2009/07/11 01:43:26 tbox Exp $ -->
18 <html>
19 <head>
20 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
21 <title>named-checkzone</title>
22 <meta name="generator" content="DocBook XSL Stylesheets V1.71.1">
23 </head>
24 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en">
25 <a name="man.named-checkzone"></a><div class="titlepage"></div>
26 <div class="refnamediv">
27 <h2>Name</h2>
28 <p><span class="application">named-checkzone</span>, <span class="application">named-compilezone</span> &#8212; zone file validity checking or converting tool</p>
29 </div>
30 <div class="refsynopsisdiv">
31 <h2>Synopsis</h2>
32 <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">-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>
33 <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>
34 </div>
35 <div class="refsect1" lang="en">
36 <a name="id2543672"></a><h2>DESCRIPTION</h2>
37 <p><span><strong class="command">named-checkzone</strong></span>
38       checks the syntax and integrity of a zone file.  It performs the
39       same checks as <span><strong class="command">named</strong></span> does when loading a
40       zone.  This makes <span><strong class="command">named-checkzone</strong></span> useful for
41       checking zone files before configuring them into a name server.
42     </p>
43 <p>
44         <span><strong class="command">named-compilezone</strong></span> is similar to
45         <span><strong class="command">named-checkzone</strong></span>, but it always dumps the
46         zone contents to a specified file in a specified format.
47         Additionally, it applies stricter check levels by default,
48         since the dump output will be used as an actual zone file
49         loaded by <span><strong class="command">named</strong></span>.
50         When manually specified otherwise, the check levels must at
51         least be as strict as those specified in the
52         <span><strong class="command">named</strong></span> configuration file.
53      </p>
54 </div>
55 <div class="refsect1" lang="en">
56 <a name="id2543707"></a><h2>OPTIONS</h2>
57 <div class="variablelist"><dl>
58 <dt><span class="term">-d</span></dt>
59 <dd><p>
60             Enable debugging.
61           </p></dd>
62 <dt><span class="term">-h</span></dt>
63 <dd><p>
64             Print the usage summary and exit.
65           </p></dd>
66 <dt><span class="term">-q</span></dt>
67 <dd><p>
68             Quiet mode - exit code only.
69           </p></dd>
70 <dt><span class="term">-v</span></dt>
71 <dd><p>
72             Print the version of the <span><strong class="command">named-checkzone</strong></span>
73             program and exit.
74           </p></dd>
75 <dt><span class="term">-j</span></dt>
76 <dd><p>
77             When loading the zone file read the journal if it exists.
78           </p></dd>
79 <dt><span class="term">-c <em class="replaceable"><code>class</code></em></span></dt>
80 <dd><p>
81             Specify the class of the zone.  If not specified, "IN" is assumed.
82           </p></dd>
83 <dt><span class="term">-i <em class="replaceable"><code>mode</code></em></span></dt>
84 <dd>
85 <p>
86               Perform post-load zone integrity checks.  Possible modes are
87               <span><strong class="command">"full"</strong></span> (default),
88               <span><strong class="command">"full-sibling"</strong></span>,
89               <span><strong class="command">"local"</strong></span>,
90               <span><strong class="command">"local-sibling"</strong></span> and
91               <span><strong class="command">"none"</strong></span>.
92           </p>
93 <p>
94               Mode <span><strong class="command">"full"</strong></span> checks that MX records
95               refer to A or AAAA record (both in-zone and out-of-zone
96               hostnames).  Mode <span><strong class="command">"local"</strong></span> only
97               checks MX records which refer to in-zone hostnames.
98           </p>
99 <p>
100               Mode <span><strong class="command">"full"</strong></span> checks that SRV records
101               refer to A or AAAA record (both in-zone and out-of-zone
102               hostnames).  Mode <span><strong class="command">"local"</strong></span> only
103               checks SRV records which refer to in-zone hostnames.
104           </p>
105 <p>
106               Mode <span><strong class="command">"full"</strong></span> checks that delegation NS
107               records refer to A or AAAA record (both in-zone and out-of-zone
108               hostnames).  It also checks that glue address records
109               in the zone match those advertised by the child.
110               Mode <span><strong class="command">"local"</strong></span> only checks NS records which
111               refer to in-zone hostnames or that some required glue exists,
112               that is when the nameserver is in a child zone.
113           </p>
114 <p>
115               Mode <span><strong class="command">"full-sibling"</strong></span> and
116               <span><strong class="command">"local-sibling"</strong></span> disable sibling glue
117               checks but are otherwise the same as <span><strong class="command">"full"</strong></span>
118               and <span><strong class="command">"local"</strong></span> respectively.
119           </p>
120 <p>
121               Mode <span><strong class="command">"none"</strong></span> disables the checks.
122           </p>
123 </dd>
124 <dt><span class="term">-f <em class="replaceable"><code>format</code></em></span></dt>
125 <dd><p>
126             Specify the format of the zone file.
127             Possible formats are <span><strong class="command">"text"</strong></span> (default)
128             and <span><strong class="command">"raw"</strong></span>.
129           </p></dd>
130 <dt><span class="term">-F <em class="replaceable"><code>format</code></em></span></dt>
131 <dd><p>
132             Specify the format of the output file specified.
133             Possible formats are <span><strong class="command">"text"</strong></span> (default)
134             and <span><strong class="command">"raw"</strong></span>.
135             For <span><strong class="command">named-checkzone</strong></span>,
136             this does not cause any effects unless it dumps the zone
137             contents.
138           </p></dd>
139 <dt><span class="term">-k <em class="replaceable"><code>mode</code></em></span></dt>
140 <dd><p>
141             Perform <span><strong class="command">"check-names"</strong></span> checks with the
142             specified failure mode.
143             Possible modes are <span><strong class="command">"fail"</strong></span>
144             (default for <span><strong class="command">named-compilezone</strong></span>),
145             <span><strong class="command">"warn"</strong></span>
146             (default for <span><strong class="command">named-checkzone</strong></span>) and
147             <span><strong class="command">"ignore"</strong></span>.
148           </p></dd>
149 <dt><span class="term">-m <em class="replaceable"><code>mode</code></em></span></dt>
150 <dd><p>
151             Specify whether MX records should be checked to see if they
152             are addresses.  Possible modes are <span><strong class="command">"fail"</strong></span>,
153             <span><strong class="command">"warn"</strong></span> (default) and
154             <span><strong class="command">"ignore"</strong></span>.
155           </p></dd>
156 <dt><span class="term">-M <em class="replaceable"><code>mode</code></em></span></dt>
157 <dd><p>
158             Check if a MX record refers to a CNAME.
159             Possible modes are <span><strong class="command">"fail"</strong></span>,
160             <span><strong class="command">"warn"</strong></span> (default) and
161             <span><strong class="command">"ignore"</strong></span>.
162           </p></dd>
163 <dt><span class="term">-n <em class="replaceable"><code>mode</code></em></span></dt>
164 <dd><p>
165             Specify whether NS records should be checked to see if they
166             are addresses.
167             Possible modes are <span><strong class="command">"fail"</strong></span>
168             (default for <span><strong class="command">named-compilezone</strong></span>),
169             <span><strong class="command">"warn"</strong></span>
170             (default for <span><strong class="command">named-checkzone</strong></span>) and
171             <span><strong class="command">"ignore"</strong></span>.
172           </p></dd>
173 <dt><span class="term">-o <em class="replaceable"><code>filename</code></em></span></dt>
174 <dd><p>
175             Write zone output to <code class="filename">filename</code>.
176             If <code class="filename">filename</code> is <code class="filename">-</code> then
177             write to standard out.
178             This is mandatory for <span><strong class="command">named-compilezone</strong></span>.
179           </p></dd>
180 <dt><span class="term">-s <em class="replaceable"><code>style</code></em></span></dt>
181 <dd><p>
182             Specify the style of the dumped zone file.
183             Possible styles are <span><strong class="command">"full"</strong></span> (default)
184             and <span><strong class="command">"relative"</strong></span>.
185             The full format is most suitable for processing
186             automatically by a separate script.
187             On the other hand, the relative format is more
188             human-readable and is thus suitable for editing by hand.
189             For <span><strong class="command">named-checkzone</strong></span>
190             this does not cause any effects unless it dumps the zone
191             contents.
192             It also does not have any meaning if the output format
193             is not text.
194           </p></dd>
195 <dt><span class="term">-S <em class="replaceable"><code>mode</code></em></span></dt>
196 <dd><p>
197             Check if a SRV record refers to a CNAME.
198             Possible modes are <span><strong class="command">"fail"</strong></span>,
199             <span><strong class="command">"warn"</strong></span> (default) and
200             <span><strong class="command">"ignore"</strong></span>.
201           </p></dd>
202 <dt><span class="term">-t <em class="replaceable"><code>directory</code></em></span></dt>
203 <dd><p>
204             Chroot to <code class="filename">directory</code> so that
205             include
206             directives in the configuration file are processed as if
207             run by a similarly chrooted named.
208           </p></dd>
209 <dt><span class="term">-w <em class="replaceable"><code>directory</code></em></span></dt>
210 <dd><p>
211             chdir to <code class="filename">directory</code> so that
212             relative
213             filenames in master file $INCLUDE directives work.  This
214             is similar to the directory clause in
215             <code class="filename">named.conf</code>.
216           </p></dd>
217 <dt><span class="term">-D</span></dt>
218 <dd><p>
219             Dump zone file in canonical format.
220             This is always enabled for <span><strong class="command">named-compilezone</strong></span>.
221           </p></dd>
222 <dt><span class="term">-W <em class="replaceable"><code>mode</code></em></span></dt>
223 <dd><p>
224             Specify whether to check for non-terminal wildcards.
225             Non-terminal wildcards are almost always the result of a
226             failure to understand the wildcard matching algorithm (RFC 1034).
227             Possible modes are <span><strong class="command">"warn"</strong></span> (default)
228             and
229             <span><strong class="command">"ignore"</strong></span>.
230           </p></dd>
231 <dt><span class="term">zonename</span></dt>
232 <dd><p>
233             The domain name of the zone being checked.
234           </p></dd>
235 <dt><span class="term">filename</span></dt>
236 <dd><p>
237             The name of the zone file.
238           </p></dd>
239 </dl></div>
240 </div>
241 <div class="refsect1" lang="en">
242 <a name="id2544328"></a><h2>RETURN VALUES</h2>
243 <p><span><strong class="command">named-checkzone</strong></span>
244       returns an exit status of 1 if
245       errors were detected and 0 otherwise.
246     </p>
247 </div>
248 <div class="refsect1" lang="en">
249 <a name="id2544340"></a><h2>SEE ALSO</h2>
250 <p><span class="citerefentry"><span class="refentrytitle">named</span>(8)</span>,
251       <span class="citerefentry"><span class="refentrytitle">named-checkconf</span>(8)</span>,
252       <em class="citetitle">RFC 1035</em>,
253       <em class="citetitle">BIND 9 Administrator Reference Manual</em>.
254     </p>
255 </div>
256 <div class="refsect1" lang="en">
257 <a name="id2544373"></a><h2>AUTHOR</h2>
258 <p><span class="corpauthor">Internet Systems Consortium</span>
259     </p>
260 </div>
261 </div></body>
262 </html>