Skip to content

GitLab

BIND
BIND
Switch branch/tag
Find file Normal viewHistoryPermalink
man.named-checkzone.html 20.2 KB
Newer Older
Tinderbox User's avatar
regen master  
Tinderbox User committed
1 2 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!--
Tinderbox User's avatar
prep 9.13.6  
Tinderbox User committed
3 
 - Copyright (C) 2000-2019 Internet Systems Consortium, Inc. ("ISC")
Tinderbox User's avatar
regen master  
Tinderbox User committed
4 5 6 7 8 9 10 11 12 
 - 
 - This Source Code Form is subject to the terms of the Mozilla Public
 - License, v. 2.0. If a copy of the MPL was not distributed with this
 - file, You can obtain one at http://mozilla.org/MPL/2.0/.
-->
<html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>named-checkzone</title>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
13 
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
Tinderbox User's avatar
regen master  
Tinderbox User committed
14 
<link rel="home" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual">
Evan Hunt's avatar
[master] renumber chapters now that the former chapter 5 is gone  
Evan Hunt committed
15 
<link rel="up" href="Bv9ARM.ch12.html" title="Manual pages">
Tinderbox User's avatar
regen master  
Tinderbox User committed
16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 
<link rel="prev" href="man.named-checkconf.html" title="named-checkconf">
<link rel="next" href="man.named-journalprint.html" title="named-journalprint">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<div class="navheader">
<table width="100%" summary="Navigation header">
<tr><th colspan="3" align="center"><span class="application">named-checkzone</span></th></tr>
<tr>
<td width="20%" align="left">
<a accesskey="p" href="man.named-checkconf.html">Prev</a> </td>
<th width="60%" align="center">Manual pages</th>
<td width="20%" align="right"> <a accesskey="n" href="man.named-journalprint.html">Next</a>
</td>
</tr>
</table>
<hr>
</div>
<div class="refentry">
<a name="man.named-checkzone"></a><div class="titlepage"></div>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
35 36 37 38 39 40 41 42 
  
  

  

  

  <div class="refnamediv">
Tinderbox User's avatar
regen master  
Tinderbox User committed
43 
<h2>Name</h2>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
44 45 46 47 48 
<p>
    <span class="application">named-checkzone</span>, 
    <span class="application">named-compilezone</span>
     &#8212; zone file validity checking or converting tool
  </p>
Tinderbox User's avatar
regen master  
Tinderbox User committed
49 
</div>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
50 51 

  <div class="refsynopsisdiv">
Tinderbox User's avatar
regen master  
Tinderbox User committed
52 
<h2>Synopsis</h2>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 
    <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>
    <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>
  </div>

  <div class="refsection">
Tinderbox User's avatar
prep 9.13.5  
Tinderbox User committed
114 
<a name="id-1.13.23.7"></a><h2>DESCRIPTION</h2>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
115 116 

    <p><span class="command"><strong>named-checkzone</strong></span>
Tinderbox User's avatar
regen master  
Tinderbox User committed
117 118 119 120 121 
      checks the syntax and integrity of a zone file.  It performs the
      same checks as <span class="command"><strong>named</strong></span> does when loading a
      zone.  This makes <span class="command"><strong>named-checkzone</strong></span> useful for
      checking zone files before configuring them into a name server.
    </p>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
122 
    <p>
Tinderbox User's avatar
regen master  
Tinderbox User committed
123 124 125 126 127 128 129 130 131 132 
        <span class="command"><strong>named-compilezone</strong></span> is similar to
	<span class="command"><strong>named-checkzone</strong></span>, but it always dumps the
        zone contents to a specified file in a specified format.
	Additionally, it applies stricter check levels by default,
        since the dump output will be used as an actual zone file
	loaded by <span class="command"><strong>named</strong></span>.
	When manually specified otherwise, the check levels must at
        least be as strict as those specified in the
	<span class="command"><strong>named</strong></span> configuration file.
     </p>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
133 134 135 
  </div>

  <div class="refsection">
Tinderbox User's avatar
prep 9.13.5  
Tinderbox User committed
136 
<a name="id-1.13.23.8"></a><h2>OPTIONS</h2>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
137 138 139 


    <div class="variablelist"><dl class="variablelist">
Tinderbox User's avatar
regen master  
Tinderbox User committed
140 
<dt><span class="term">-d</span></dt>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
141 142 
<dd>
          <p>
Tinderbox User's avatar
regen master  
Tinderbox User committed
143 
            Enable debugging.
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
144 145 
          </p>
        </dd>
Tinderbox User's avatar
regen master  
Tinderbox User committed
146 
<dt><span class="term">-h</span></dt>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
147 148 
<dd>
          <p>
Tinderbox User's avatar
regen master  
Tinderbox User committed
149 
            Print the usage summary and exit.
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
150 151 
          </p>
        </dd>
Tinderbox User's avatar
regen master  
Tinderbox User committed
152 
<dt><span class="term">-q</span></dt>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
153 154 
<dd>
          <p>
Tinderbox User's avatar
regen master  
Tinderbox User committed
155 
            Quiet mode - exit code only.
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
156 157 
          </p>
        </dd>
Tinderbox User's avatar
regen master  
Tinderbox User committed
158 
<dt><span class="term">-v</span></dt>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
159 160 
<dd>
          <p>
Tinderbox User's avatar
regen master  
Tinderbox User committed
161 162 
            Print the version of the <span class="command"><strong>named-checkzone</strong></span>
            program and exit.
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
163 164 
          </p>
        </dd>
Tinderbox User's avatar
regen master  
Tinderbox User committed
165 
<dt><span class="term">-j</span></dt>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
166 167 
<dd>
          <p>
Tinderbox User's avatar
regen master  
Tinderbox User committed
168 169 170 
            When loading a zone file, read the journal if it exists.
            The journal file name is assumed to be the zone file name
	    appended with the string <code class="filename">.jnl</code>.
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
171 172 
          </p>
        </dd>
Tinderbox User's avatar
regen master  
Tinderbox User committed
173 
<dt><span class="term">-J <em class="replaceable"><code>filename</code></em></span></dt>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
174 175 
<dd>
          <p>
Tinderbox User's avatar
regen master  
Tinderbox User committed
176 177 
            When loading the zone file read the journal from the given
            file, if it exists. (Implies -j.)
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
178 179 
          </p>
        </dd>
Tinderbox User's avatar
regen master  
Tinderbox User committed
180 
<dt><span class="term">-c <em class="replaceable"><code>class</code></em></span></dt>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
181 182 
<dd>
          <p>
Tinderbox User's avatar
regen master  
Tinderbox User committed
183 
            Specify the class of the zone.  If not specified, "IN" is assumed.
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
184 185 
          </p>
        </dd>
Tinderbox User's avatar
regen master  
Tinderbox User committed
186 187 
<dt><span class="term">-i <em class="replaceable"><code>mode</code></em></span></dt>
<dd>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
188 
	  <p>
Tinderbox User's avatar
regen master  
Tinderbox User committed
189 190 191 192 193 194 195 
	      Perform post-load zone integrity checks.  Possible modes are
	      <span class="command"><strong>"full"</strong></span> (default),
	      <span class="command"><strong>"full-sibling"</strong></span>,
	      <span class="command"><strong>"local"</strong></span>,
	      <span class="command"><strong>"local-sibling"</strong></span> and
	      <span class="command"><strong>"none"</strong></span>.
	  </p>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
196 
	  <p>
Tinderbox User's avatar
regen master  
Tinderbox User committed
197 198 199 200 201 
	      Mode <span class="command"><strong>"full"</strong></span> checks that MX records
	      refer to A or AAAA record (both in-zone and out-of-zone
	      hostnames).  Mode <span class="command"><strong>"local"</strong></span> only
	      checks MX records which refer to in-zone hostnames.
	  </p>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
202 
	  <p>
Tinderbox User's avatar
regen master  
Tinderbox User committed
203 204 205 206 207 
	      Mode <span class="command"><strong>"full"</strong></span> checks that SRV records
	      refer to A or AAAA record (both in-zone and out-of-zone
	      hostnames).  Mode <span class="command"><strong>"local"</strong></span> only
	      checks SRV records which refer to in-zone hostnames.
	  </p>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
208 
	  <p>
Tinderbox User's avatar
regen master  
Tinderbox User committed
209 210 211 212 213 214 215 216 
	      Mode <span class="command"><strong>"full"</strong></span> checks that delegation NS
	      records refer to A or AAAA record (both in-zone and out-of-zone
	      hostnames).  It also checks that glue address records
	      in the zone match those advertised by the child.
	      Mode <span class="command"><strong>"local"</strong></span> only checks NS records which
	      refer to in-zone hostnames or that some required glue exists,
	      that is when the nameserver is in a child zone.
	  </p>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
217 
	  <p>
Tinderbox User's avatar
regen master  
Tinderbox User committed
218 219 220 221 222 
	      Mode <span class="command"><strong>"full-sibling"</strong></span> and
	      <span class="command"><strong>"local-sibling"</strong></span> disable sibling glue
	      checks but are otherwise the same as <span class="command"><strong>"full"</strong></span>
	      and <span class="command"><strong>"local"</strong></span> respectively.
	  </p>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
223 
	  <p>
Tinderbox User's avatar
regen master  
Tinderbox User committed
224 225 
	      Mode <span class="command"><strong>"none"</strong></span> disables the checks.
	  </p>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
226 
	</dd>
Tinderbox User's avatar
regen master  
Tinderbox User committed
227 
<dt><span class="term">-f <em class="replaceable"><code>format</code></em></span></dt>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
228 229 
<dd>
	  <p>
Tinderbox User's avatar
regen master  
Tinderbox User committed
230 231 232 
	    Specify the format of the zone file.
	    Possible formats are <span class="command"><strong>"text"</strong></span> (default),
	    <span class="command"><strong>"raw"</strong></span>, and <span class="command"><strong>"map"</strong></span>.
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
233 234 
	  </p>
	</dd>
Tinderbox User's avatar
regen master  
Tinderbox User committed
235 236 
<dt><span class="term">-F <em class="replaceable"><code>format</code></em></span></dt>
<dd>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
237 
	  <p>
Tinderbox User's avatar
regen master  
Tinderbox User committed
238 239 240 241 242 
	    Specify the format of the output file specified.
	    For <span class="command"><strong>named-checkzone</strong></span>,
	    this does not cause any effects unless it dumps the zone
	    contents.
	  </p>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
243 
	  <p>
Tinderbox User's avatar
regen master  
Tinderbox User committed
244 245 246 247 248 249 250 251 252 253 
	    Possible formats are <span class="command"><strong>"text"</strong></span> (default),
	    which is the standard textual representation of the zone,
	    and <span class="command"><strong>"map"</strong></span>, <span class="command"><strong>"raw"</strong></span>,
            and <span class="command"><strong>"raw=N"</strong></span>, which store the zone in a
            binary format for rapid loading by <span class="command"><strong>named</strong></span>.
            <span class="command"><strong>"raw=N"</strong></span> specifies the format version of
            the raw zone file: if N is 0, the raw file can be read by
            any version of <span class="command"><strong>named</strong></span>; if N is 1, the file
            can be read by release 9.9.0 or higher; the default is 1.
	  </p>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
254 
	</dd>
Tinderbox User's avatar
regen master  
Tinderbox User committed
255 
<dt><span class="term">-k <em class="replaceable"><code>mode</code></em></span></dt>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
256 257 
<dd>
          <p>
Tinderbox User's avatar
regen master  
Tinderbox User committed
258 259 260 261 262 263 264 
            Perform <span class="command"><strong>"check-names"</strong></span> checks with the
	    specified failure mode.
            Possible modes are <span class="command"><strong>"fail"</strong></span>
	    (default for <span class="command"><strong>named-compilezone</strong></span>),
            <span class="command"><strong>"warn"</strong></span>
	    (default for <span class="command"><strong>named-checkzone</strong></span>) and
            <span class="command"><strong>"ignore"</strong></span>.
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
265 266 
          </p>
        </dd>
Tinderbox User's avatar
regen master  
Tinderbox User committed
267 
<dt><span class="term">-l <em class="replaceable"><code>ttl</code></em></span></dt>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
268 269 
<dd>
          <p>
Tinderbox User's avatar
regen master  
Tinderbox User committed
270 271 272 273 274 
            Sets a maximum permissible TTL for the input file.
            Any record with a TTL higher than this value will cause
            the zone to be rejected.  This is similar to using the
            <span class="command"><strong>max-zone-ttl</strong></span> option in
            <code class="filename">named.conf</code>.
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
275 276 
          </p>
        </dd>
Tinderbox User's avatar
regen master  
Tinderbox User committed
277 
<dt><span class="term">-L <em class="replaceable"><code>serial</code></em></span></dt>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
278 279 
<dd>
          <p>
Tinderbox User's avatar
regen master  
Tinderbox User committed
280 281 282 283 
            When compiling a zone to "raw" or "map" format, set the
            "source serial" value in the header to the specified serial
            number.  (This is expected to be used primarily for testing
            purposes.)
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
284 285 
          </p>
        </dd>
Tinderbox User's avatar
regen master  
Tinderbox User committed
286 
<dt><span class="term">-m <em class="replaceable"><code>mode</code></em></span></dt>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
287 288 
<dd>
          <p>
Tinderbox User's avatar
regen master  
Tinderbox User committed
289 290 291 292 
            Specify whether MX records should be checked to see if they
            are addresses.  Possible modes are <span class="command"><strong>"fail"</strong></span>,
            <span class="command"><strong>"warn"</strong></span> (default) and
            <span class="command"><strong>"ignore"</strong></span>.
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
293 294 
          </p>
        </dd>
Tinderbox User's avatar
regen master  
Tinderbox User committed
295 
<dt><span class="term">-M <em class="replaceable"><code>mode</code></em></span></dt>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
296 297 
<dd>
	  <p>
Tinderbox User's avatar
regen master  
Tinderbox User committed
298 299 300 301 
	    Check if a MX record refers to a CNAME.
            Possible modes are <span class="command"><strong>"fail"</strong></span>,
            <span class="command"><strong>"warn"</strong></span> (default) and
            <span class="command"><strong>"ignore"</strong></span>.
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
302 303 
	  </p>
        </dd>
Tinderbox User's avatar
regen master  
Tinderbox User committed
304 
<dt><span class="term">-n <em class="replaceable"><code>mode</code></em></span></dt>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
305 306 
<dd>
          <p>
Tinderbox User's avatar
regen master  
Tinderbox User committed
307 308 309 310 311 312 313 
            Specify whether NS records should be checked to see if they
            are addresses.
	    Possible modes are <span class="command"><strong>"fail"</strong></span>
	    (default for <span class="command"><strong>named-compilezone</strong></span>),
            <span class="command"><strong>"warn"</strong></span>
	    (default for <span class="command"><strong>named-checkzone</strong></span>) and
            <span class="command"><strong>"ignore"</strong></span>.
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
314 315 
          </p>
        </dd>
Tinderbox User's avatar
regen master  
Tinderbox User committed
316 
<dt><span class="term">-o <em class="replaceable"><code>filename</code></em></span></dt>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
317 318 
<dd>
          <p>
Tinderbox User's avatar
regen master  
Tinderbox User committed
319 320 321 322 
            Write zone output to <code class="filename">filename</code>.
	    If <code class="filename">filename</code> is <code class="filename">-</code> then
	    write to standard out.
	    This is mandatory for <span class="command"><strong>named-compilezone</strong></span>.
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
323 324 
          </p>
        </dd>
Tinderbox User's avatar
regen master  
Tinderbox User committed
325 
<dt><span class="term">-r <em class="replaceable"><code>mode</code></em></span></dt>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
326 327 
<dd>
	  <p>
Tinderbox User's avatar
regen master  
Tinderbox User committed
328 329 330 331 332 
            Check for records that are treated as different by DNSSEC but
	    are semantically equal in plain DNS.
            Possible modes are <span class="command"><strong>"fail"</strong></span>,
            <span class="command"><strong>"warn"</strong></span> (default) and
            <span class="command"><strong>"ignore"</strong></span>.
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
333 334 
	  </p>
        </dd>
Tinderbox User's avatar
regen master  
Tinderbox User committed
335 
<dt><span class="term">-s <em class="replaceable"><code>style</code></em></span></dt>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
336 337 
<dd>
	  <p>
Tinderbox User's avatar
regen master  
Tinderbox User committed
338 339 340 341 342 343 344 345 346 347 348 349 
	    Specify the style of the dumped zone file.
	    Possible styles are <span class="command"><strong>"full"</strong></span> (default)
	    and <span class="command"><strong>"relative"</strong></span>.
	    The full format is most suitable for processing
	    automatically by a separate script.
	    On the other hand, the relative format is more
	    human-readable and is thus suitable for editing by hand.
	    For <span class="command"><strong>named-checkzone</strong></span>
	    this does not cause any effects unless it dumps the zone
	    contents.
	    It also does not have any meaning if the output format
	    is not text.
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
350 351 
	  </p>
	</dd>
Tinderbox User's avatar
regen master  
Tinderbox User committed
352 
<dt><span class="term">-S <em class="replaceable"><code>mode</code></em></span></dt>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
353 354 
<dd>
	  <p>
Tinderbox User's avatar
regen master  
Tinderbox User committed
355 356 357 358 
	    Check if a SRV record refers to a CNAME.
            Possible modes are <span class="command"><strong>"fail"</strong></span>,
            <span class="command"><strong>"warn"</strong></span> (default) and
            <span class="command"><strong>"ignore"</strong></span>.
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
359 360 
	  </p>
        </dd>
Tinderbox User's avatar
regen master  
Tinderbox User committed
361 
<dt><span class="term">-t <em class="replaceable"><code>directory</code></em></span></dt>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
362 363 
<dd>
          <p>
Tinderbox User's avatar
regen master  
Tinderbox User committed
364 365 366 367 
            Chroot to <code class="filename">directory</code> so that
            include
            directives in the configuration file are processed as if
            run by a similarly chrooted <span class="command"><strong>named</strong></span>.
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
368 369 
          </p>
        </dd>
Tinderbox User's avatar
regen master  
Tinderbox User committed
370 
<dt><span class="term">-T <em class="replaceable"><code>mode</code></em></span></dt>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
371 372 
<dd>
	  <p>
Tinderbox User's avatar
regen master  
Tinderbox User committed
373 374 375 376 
	    Check if Sender Policy Framework (SPF) records exist
	    and issues a warning if an SPF-formatted TXT record is
	    not also present.  Possible modes are <span class="command"><strong>"warn"</strong></span>
	    (default), <span class="command"><strong>"ignore"</strong></span>.
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
377 378 
	  </p>
	</dd>
Tinderbox User's avatar
regen master  
Tinderbox User committed
379 
<dt><span class="term">-w <em class="replaceable"><code>directory</code></em></span></dt>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
380 381 
<dd>
          <p>
Tinderbox User's avatar
regen master  
Tinderbox User committed
382 383 384 385 386 
            chdir to <code class="filename">directory</code> so that
            relative
            filenames in master file $INCLUDE directives work.  This
            is similar to the directory clause in
            <code class="filename">named.conf</code>.
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
387 388 
          </p>
        </dd>
Tinderbox User's avatar
regen master  
Tinderbox User committed
389 
<dt><span class="term">-D</span></dt>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
390 391 
<dd>
          <p>
Tinderbox User's avatar
regen master  
Tinderbox User committed
392 393 
            Dump zone file in canonical format.
	    This is always enabled for <span class="command"><strong>named-compilezone</strong></span>.
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
394 395 
          </p>
        </dd>
Tinderbox User's avatar
regen master  
Tinderbox User committed
396 
<dt><span class="term">-W <em class="replaceable"><code>mode</code></em></span></dt>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
397 398 
<dd>
          <p>
Tinderbox User's avatar
regen master  
Tinderbox User committed
399 400 401 402 403 404 
            Specify whether to check for non-terminal wildcards.
            Non-terminal wildcards are almost always the result of a
            failure to understand the wildcard matching algorithm (RFC 1034).
            Possible modes are <span class="command"><strong>"warn"</strong></span> (default)
            and
            <span class="command"><strong>"ignore"</strong></span>.
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
405 406 
          </p>
        </dd>
Tinderbox User's avatar
regen master  
Tinderbox User committed
407 
<dt><span class="term">zonename</span></dt>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
408 409 
<dd>
          <p>
Tinderbox User's avatar
regen master  
Tinderbox User committed
410 
            The domain name of the zone being checked.
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
411 412 
          </p>
        </dd>
Tinderbox User's avatar
regen master  
Tinderbox User committed
413 
<dt><span class="term">filename</span></dt>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
414 415 
<dd>
          <p>
Tinderbox User's avatar
regen master  
Tinderbox User committed
416 
            The name of the zone file.
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
417 418 
          </p>
        </dd>
Tinderbox User's avatar
regen master  
Tinderbox User committed
419 
</dl></div>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
420 421 422 423 

  </div>

  <div class="refsection">
Tinderbox User's avatar
prep 9.13.5  
Tinderbox User committed
424 
<a name="id-1.13.23.9"></a><h2>RETURN VALUES</h2>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
425 426 

    <p><span class="command"><strong>named-checkzone</strong></span>
Tinderbox User's avatar
regen master  
Tinderbox User committed
427 428 429 
      returns an exit status of 1 if
      errors were detected and 0 otherwise.
    </p>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
430 431 432 
  </div>

  <div class="refsection">
Tinderbox User's avatar
prep 9.13.5  
Tinderbox User committed
433 
<a name="id-1.13.23.10"></a><h2>SEE ALSO</h2>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
434 435 436 437 438 439 440 

    <p><span class="citerefentry">
        <span class="refentrytitle">named</span>(8)
      </span>,
      <span class="citerefentry">
        <span class="refentrytitle">named-checkconf</span>(8)
      </span>,
Tinderbox User's avatar
regen master  
Tinderbox User committed
441 442 443 
      <em class="citetitle">RFC 1035</em>,
      <em class="citetitle">BIND 9 Administrator Reference Manual</em>.
    </p>
Tinderbox User's avatar
prep 9.13.3  
Tinderbox User committed
444 445 
  </div>
Tinderbox User's avatar
regen master  
Tinderbox User committed
446 447 448 449 450 451 452 
</div>
<div class="navfooter">
<hr>
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left">
<a accesskey="p" href="man.named-checkconf.html">Prev</a> </td>
Evan Hunt's avatar
[master] renumber chapters now that the former chapter 5 is gone  
Evan Hunt committed
453 
<td width="20%" align="center"><a accesskey="u" href="Bv9ARM.ch12.html">Up</a></td>
Tinderbox User's avatar
regen master  
Tinderbox User committed
454 455 456 457 458 459 460 461 462 463 464 465 
<td width="40%" align="right"> <a accesskey="n" href="man.named-journalprint.html">Next</a>
</td>
</tr>
<tr>
<td width="40%" align="left" valign="top">
<span class="application">named-checkconf</span> </td>
<td width="20%" align="center"><a accesskey="h" href="Bv9ARM.html">Home</a></td>
<td width="40%" align="right" valign="top"> <span class="application">named-journalprint</span>
</td>
</tr>
</table>
</div>
Tinderbox User's avatar
doc rebuild  
Tinderbox User committed
466 
<p xmlns:db="http://docbook.org/ns/docbook" style="text-align: center;">BIND 9.14.1 (Stable Release)</p>
Tinderbox User's avatar
regen master  
Tinderbox User committed
467 468 
</body>
</html>