PageRenderTime 45ms CodeModel.GetById 24ms app.highlight 16ms RepoModel.GetById 1ms app.codeStats 1ms

/contrib/bind9/doc/arm/man.named-checkzone.html

https://bitbucket.org/freebsd/freebsd-head/
HTML | 308 lines | 291 code | 0 blank | 17 comment | 0 complexity | f79fb0673c0ef313da5adabf6a425de5 MD5 | raw file
  1<!--
  2 - Copyright (C) 2004-2012 Internet Systems Consortium, Inc. ("ISC")
  3 - Copyright (C) 2000-2003 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$ -->
 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<link rel="start" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual">
 24<link rel="up" href="Bv9ARM.ch10.html" title="Manual pages">
 25<link rel="prev" href="man.named-checkconf.html" title="named-checkconf">
 26<link rel="next" href="man.named.html" title="named">
 27</head>
 28<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
 29<div class="navheader">
 30<table width="100%" summary="Navigation header">
 31<tr><th colspan="3" align="center"><span class="application">named-checkzone</span></th></tr>
 32<tr>
 33<td width="20%" align="left">
 34<a accesskey="p" href="man.named-checkconf.html">Prev</a> </td>
 35<th width="60%" align="center">Manual pages</th>
 36<td width="20%" align="right"> <a accesskey="n" href="man.named.html">Next</a>
 37</td>
 38</tr>
 39</table>
 40<hr>
 41</div>
 42<div class="refentry" lang="en">
 43<a name="man.named-checkzone"></a><div class="titlepage"></div>
 44<div class="refnamediv">
 45<h2>Name</h2>
 46<p><span class="application">named-checkzone</span>, <span class="application">named-compilezone</span> &#8212; zone file validity checking or converting tool</p>
 47</div>
 48<div class="refsynopsisdiv">
 49<h2>Synopsis</h2>
 50<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">-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>
 51<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">-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>
 52</div>
 53<div class="refsect1" lang="en">
 54<a name="id2633185"></a><h2>DESCRIPTION</h2>
 55<p><span><strong class="command">named-checkzone</strong></span>
 56      checks the syntax and integrity of a zone file.  It performs the
 57      same checks as <span><strong class="command">named</strong></span> does when loading a
 58      zone.  This makes <span><strong class="command">named-checkzone</strong></span> useful for
 59      checking zone files before configuring them into a name server.
 60    </p>
 61<p>
 62        <span><strong class="command">named-compilezone</strong></span> is similar to
 63	<span><strong class="command">named-checkzone</strong></span>, but it always dumps the
 64        zone contents to a specified file in a specified format.
 65	Additionally, it applies stricter check levels by default,
 66        since the dump output will be used as an actual zone file
 67	loaded by <span><strong class="command">named</strong></span>.
 68	When manually specified otherwise, the check levels must at
 69        least be as strict as those specified in the
 70	<span><strong class="command">named</strong></span> configuration file.
 71     </p>
 72</div>
 73<div class="refsect1" lang="en">
 74<a name="id2633235"></a><h2>OPTIONS</h2>
 75<div class="variablelist"><dl>
 76<dt><span class="term">-d</span></dt>
 77<dd><p>
 78            Enable debugging.
 79          </p></dd>
 80<dt><span class="term">-h</span></dt>
 81<dd><p>
 82            Print the usage summary and exit.
 83          </p></dd>
 84<dt><span class="term">-q</span></dt>
 85<dd><p>
 86            Quiet mode - exit code only.
 87          </p></dd>
 88<dt><span class="term">-v</span></dt>
 89<dd><p>
 90            Print the version of the <span><strong class="command">named-checkzone</strong></span>
 91            program and exit.
 92          </p></dd>
 93<dt><span class="term">-j</span></dt>
 94<dd><p>
 95            When loading the zone file read the journal if it exists.
 96          </p></dd>
 97<dt><span class="term">-c <em class="replaceable"><code>class</code></em></span></dt>
 98<dd><p>
 99            Specify the class of the zone.  If not specified, "IN" is assumed.
100          </p></dd>
101<dt><span class="term">-i <em class="replaceable"><code>mode</code></em></span></dt>
102<dd>
103<p>
104	      Perform post-load zone integrity checks.  Possible modes are
105	      <span><strong class="command">"full"</strong></span> (default),
106	      <span><strong class="command">"full-sibling"</strong></span>,
107	      <span><strong class="command">"local"</strong></span>,
108	      <span><strong class="command">"local-sibling"</strong></span> and
109	      <span><strong class="command">"none"</strong></span>.
110	  </p>
111<p>
112	      Mode <span><strong class="command">"full"</strong></span> checks that MX records
113	      refer to A or AAAA record (both in-zone and out-of-zone
114	      hostnames).  Mode <span><strong class="command">"local"</strong></span> only
115	      checks MX records which refer to in-zone hostnames.
116	  </p>
117<p>
118	      Mode <span><strong class="command">"full"</strong></span> checks that SRV records
119	      refer to A or AAAA record (both in-zone and out-of-zone
120	      hostnames).  Mode <span><strong class="command">"local"</strong></span> only
121	      checks SRV records which refer to in-zone hostnames.
122	  </p>
123<p>
124	      Mode <span><strong class="command">"full"</strong></span> checks that delegation NS
125	      records refer to A or AAAA record (both in-zone and out-of-zone
126	      hostnames).  It also checks that glue address records
127	      in the zone match those advertised by the child.
128	      Mode <span><strong class="command">"local"</strong></span> only checks NS records which
129	      refer to in-zone hostnames or that some required glue exists,
130	      that is when the nameserver is in a child zone.
131	  </p>
132<p>
133	      Mode <span><strong class="command">"full-sibling"</strong></span> and
134	      <span><strong class="command">"local-sibling"</strong></span> disable sibling glue
135	      checks but are otherwise the same as <span><strong class="command">"full"</strong></span>
136	      and <span><strong class="command">"local"</strong></span> respectively.
137	  </p>
138<p>
139	      Mode <span><strong class="command">"none"</strong></span> disables the checks.
140	  </p>
141</dd>
142<dt><span class="term">-f <em class="replaceable"><code>format</code></em></span></dt>
143<dd><p>
144	    Specify the format of the zone file.
145	    Possible formats are <span><strong class="command">"text"</strong></span> (default)
146	    and <span><strong class="command">"raw"</strong></span>.
147	  </p></dd>
148<dt><span class="term">-F <em class="replaceable"><code>format</code></em></span></dt>
149<dd><p>
150	    Specify the format of the output file specified.
151	    Possible formats are <span><strong class="command">"text"</strong></span> (default)
152	    and <span><strong class="command">"raw"</strong></span>.
153	    For <span><strong class="command">named-checkzone</strong></span>,
154	    this does not cause any effects unless it dumps the zone
155	    contents.
156	  </p></dd>
157<dt><span class="term">-k <em class="replaceable"><code>mode</code></em></span></dt>
158<dd><p>
159            Perform <span><strong class="command">"check-names"</strong></span> checks with the
160	    specified failure mode.
161            Possible modes are <span><strong class="command">"fail"</strong></span>
162	    (default for <span><strong class="command">named-compilezone</strong></span>),
163            <span><strong class="command">"warn"</strong></span>
164	    (default for <span><strong class="command">named-checkzone</strong></span>) and
165            <span><strong class="command">"ignore"</strong></span>.
166          </p></dd>
167<dt><span class="term">-m <em class="replaceable"><code>mode</code></em></span></dt>
168<dd><p>
169            Specify whether MX records should be checked to see if they
170            are addresses.  Possible modes are <span><strong class="command">"fail"</strong></span>,
171            <span><strong class="command">"warn"</strong></span> (default) and
172            <span><strong class="command">"ignore"</strong></span>.
173          </p></dd>
174<dt><span class="term">-M <em class="replaceable"><code>mode</code></em></span></dt>
175<dd><p>
176	    Check if a MX record refers to a CNAME.
177            Possible modes are <span><strong class="command">"fail"</strong></span>,
178            <span><strong class="command">"warn"</strong></span> (default) and
179            <span><strong class="command">"ignore"</strong></span>.
180	  </p></dd>
181<dt><span class="term">-n <em class="replaceable"><code>mode</code></em></span></dt>
182<dd><p>
183            Specify whether NS records should be checked to see if they
184            are addresses.
185	    Possible modes are <span><strong class="command">"fail"</strong></span>
186	    (default for <span><strong class="command">named-compilezone</strong></span>),
187            <span><strong class="command">"warn"</strong></span>
188	    (default for <span><strong class="command">named-checkzone</strong></span>) and
189            <span><strong class="command">"ignore"</strong></span>.
190          </p></dd>
191<dt><span class="term">-o <em class="replaceable"><code>filename</code></em></span></dt>
192<dd><p>
193            Write zone output to <code class="filename">filename</code>.
194	    If <code class="filename">filename</code> is <code class="filename">-</code> then
195	    write to standard out.
196	    This is mandatory for <span><strong class="command">named-compilezone</strong></span>.
197          </p></dd>
198<dt><span class="term">-r <em class="replaceable"><code>mode</code></em></span></dt>
199<dd><p>
200            Check for records that are treated as different by DNSSEC but
201	    are semantically equal in plain DNS.  
202            Possible modes are <span><strong class="command">"fail"</strong></span>,
203            <span><strong class="command">"warn"</strong></span> (default) and
204            <span><strong class="command">"ignore"</strong></span>.
205	  </p></dd>
206<dt><span class="term">-s <em class="replaceable"><code>style</code></em></span></dt>
207<dd><p>
208	    Specify the style of the dumped zone file.
209	    Possible styles are <span><strong class="command">"full"</strong></span> (default)
210	    and <span><strong class="command">"relative"</strong></span>.
211	    The full format is most suitable for processing
212	    automatically by a separate script.
213	    On the other hand, the relative format is more
214	    human-readable and is thus suitable for editing by hand.
215	    For <span><strong class="command">named-checkzone</strong></span>
216	    this does not cause any effects unless it dumps the zone
217	    contents.
218	    It also does not have any meaning if the output format
219	    is not text.
220	  </p></dd>
221<dt><span class="term">-S <em class="replaceable"><code>mode</code></em></span></dt>
222<dd><p>
223	    Check if a SRV record refers to a CNAME.
224            Possible modes are <span><strong class="command">"fail"</strong></span>,
225            <span><strong class="command">"warn"</strong></span> (default) and
226            <span><strong class="command">"ignore"</strong></span>.
227	  </p></dd>
228<dt><span class="term">-t <em class="replaceable"><code>directory</code></em></span></dt>
229<dd><p>
230            Chroot to <code class="filename">directory</code> so that
231            include
232            directives in the configuration file are processed as if
233            run by a similarly chrooted named.
234          </p></dd>
235<dt><span class="term">-w <em class="replaceable"><code>directory</code></em></span></dt>
236<dd><p>
237            chdir to <code class="filename">directory</code> so that
238            relative
239            filenames in master file $INCLUDE directives work.  This
240            is similar to the directory clause in
241            <code class="filename">named.conf</code>.
242          </p></dd>
243<dt><span class="term">-D</span></dt>
244<dd><p>
245            Dump zone file in canonical format.
246	    This is always enabled for <span><strong class="command">named-compilezone</strong></span>.
247          </p></dd>
248<dt><span class="term">-W <em class="replaceable"><code>mode</code></em></span></dt>
249<dd><p>
250            Specify whether to check for non-terminal wildcards.
251            Non-terminal wildcards are almost always the result of a
252            failure to understand the wildcard matching algorithm (RFC 1034).
253            Possible modes are <span><strong class="command">"warn"</strong></span> (default)
254            and
255            <span><strong class="command">"ignore"</strong></span>.
256          </p></dd>
257<dt><span class="term">zonename</span></dt>
258<dd><p>
259            The domain name of the zone being checked.
260          </p></dd>
261<dt><span class="term">filename</span></dt>
262<dd><p>
263            The name of the zone file.
264          </p></dd>
265</dl></div>
266</div>
267<div class="refsect1" lang="en">
268<a name="id2673464"></a><h2>RETURN VALUES</h2>
269<p><span><strong class="command">named-checkzone</strong></span>
270      returns an exit status of 1 if
271      errors were detected and 0 otherwise.
272    </p>
273</div>
274<div class="refsect1" lang="en">
275<a name="id2673478"></a><h2>SEE ALSO</h2>
276<p><span class="citerefentry"><span class="refentrytitle">named</span>(8)</span>,
277      <span class="citerefentry"><span class="refentrytitle">named-checkconf</span>(8)</span>,
278      <em class="citetitle">RFC 1035</em>,
279      <em class="citetitle">BIND 9 Administrator Reference Manual</em>.
280    </p>
281</div>
282<div class="refsect1" lang="en">
283<a name="id2673511"></a><h2>AUTHOR</h2>
284<p><span class="corpauthor">Internet Systems Consortium</span>
285    </p>
286</div>
287</div>
288<div class="navfooter">
289<hr>
290<table width="100%" summary="Navigation footer">
291<tr>
292<td width="40%" align="left">
293<a accesskey="p" href="man.named-checkconf.html">Prev</a> </td>
294<td width="20%" align="center"><a accesskey="u" href="Bv9ARM.ch10.html">Up</a></td>
295<td width="40%" align="right"> <a accesskey="n" href="man.named.html">Next</a>
296</td>
297</tr>
298<tr>
299<td width="40%" align="left" valign="top">
300<span class="application">named-checkconf</span> </td>
301<td width="20%" align="center"><a accesskey="h" href="Bv9ARM.html">Home</a></td>
302<td width="40%" align="right" valign="top"> <span class="application">named</span>
303</td>
304</tr>
305</table>
306</div>
307</body>
308</html>