/contrib/bind9/doc/arm/man.named-checkzone.html
HTML | 308 lines | 291 code | 0 blank | 17 comment | 0 complexity | f79fb0673c0ef313da5adabf6a425de5 MD5 | raw file
Possible License(s): MPL-2.0-no-copyleft-exception, BSD-3-Clause, LGPL-2.0, LGPL-2.1, BSD-2-Clause, 0BSD, JSON, AGPL-1.0, GPL-2.0
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> — 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>