named-checkzone.html 18.2 KB
Newer Older
1
<!--
Tinderbox User's avatar
Tinderbox User committed
2
 - Copyright (C) 2004-2007, 2009-2016 Internet Systems Consortium, Inc. ("ISC")
Mark Andrews's avatar
regen  
Mark Andrews committed
3
 - Copyright (C) 2000-2002 Internet Software Consortium.
Rob Austein's avatar
regen  
Rob Austein committed
4
 - 
Automatic Updater's avatar
regen  
Automatic Updater committed
5
 - Permission to use, copy, modify, and/or distribute this software for any
6 7
 - purpose with or without fee is hereby granted, provided that the above
 - copyright notice and this permission notice appear in all copies.
Rob Austein's avatar
regen  
Rob Austein committed
8
 - 
Mark Andrews's avatar
Mark Andrews committed
9 10
 - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
 - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
Rob Austein's avatar
regen  
Rob Austein committed
11
 - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
Mark Andrews's avatar
Mark Andrews committed
12 13 14 15
 - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
 - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
 - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
 - PERFORMANCE OF THIS SOFTWARE.
16
-->
Rob Austein's avatar
regen  
Rob Austein committed
17 18 19 20
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>named-checkzone</title>
Tinderbox User's avatar
Tinderbox User committed
21
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
Rob Austein's avatar
regen  
Rob Austein committed
22
</head>
Tinderbox User's avatar
Tinderbox User committed
23
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry">
Mark Andrews's avatar
gregen  
Mark Andrews committed
24
<a name="man.named-checkzone"></a><div class="titlepage"></div>
Tinderbox User's avatar
Tinderbox User committed
25
<div class="refnamediv">
Rob Austein's avatar
regen  
Rob Austein committed
26
<h2>Name</h2>
Tinderbox User's avatar
Tinderbox User committed
27
<p><span class="application">named-checkzone</span>, <span class="application">named-compilezone</span> &#8212; zone file validity checking or converting tool</p>
Rob Austein's avatar
regen  
Rob Austein committed
28
</div>
Tinderbox User's avatar
Tinderbox User committed
29
<div class="refsynopsisdiv">
Rob Austein's avatar
regen  
Rob Austein committed
30
<h2>Synopsis</h2>
Tinderbox User's avatar
Tinderbox User committed
31 32 33 34 35 36
<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">
<a name="id-1.7"></a><h2>DESCRIPTION</h2>
<p><span class="command"><strong>named-checkzone</strong></span>
Rob Austein's avatar
regen  
Rob Austein committed
37
      checks the syntax and integrity of a zone file.  It performs the
Tinderbox User's avatar
Tinderbox User committed
38 39
      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
Rob Austein's avatar
regen  
Rob Austein committed
40 41
      checking zone files before configuring them into a name server.
    </p>
Tinderbox User's avatar
Tinderbox User committed
42
<p>
Tinderbox User's avatar
Tinderbox User committed
43 44
        <span class="command"><strong>named-compilezone</strong></span> is similar to
	<span class="command"><strong>named-checkzone</strong></span>, but it always dumps the
45 46 47
        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
Tinderbox User's avatar
Tinderbox User committed
48
	loaded by <span class="command"><strong>named</strong></span>.
Mark Andrews's avatar
regen  
Mark Andrews committed
49
	When manually specified otherwise, the check levels must at
50
        least be as strict as those specified in the
Tinderbox User's avatar
Tinderbox User committed
51
	<span class="command"><strong>named</strong></span> configuration file.
52
     </p>
Tinderbox User's avatar
Tinderbox User committed
53 54 55 56
</div>
<div class="refsection">
<a name="id-1.8"></a><h2>OPTIONS</h2>
<div class="variablelist"><dl class="variablelist">
Rob Austein's avatar
regen  
Rob Austein committed
57
<dt><span class="term">-d</span></dt>
Tinderbox User's avatar
Tinderbox User committed
58
<dd><p>
Rob Austein's avatar
regen  
Rob Austein committed
59
            Enable debugging.
Tinderbox User's avatar
Tinderbox User committed
60
          </p></dd>
Mark Andrews's avatar
regen  
Mark Andrews committed
61
<dt><span class="term">-h</span></dt>
Tinderbox User's avatar
Tinderbox User committed
62
<dd><p>
Mark Andrews's avatar
regen  
Mark Andrews committed
63
            Print the usage summary and exit.
Tinderbox User's avatar
Tinderbox User committed
64
          </p></dd>
Rob Austein's avatar
regen  
Rob Austein committed
65
<dt><span class="term">-q</span></dt>
Tinderbox User's avatar
Tinderbox User committed
66
<dd><p>
Rob Austein's avatar
regen  
Rob Austein committed
67
            Quiet mode - exit code only.
Tinderbox User's avatar
Tinderbox User committed
68
          </p></dd>
Rob Austein's avatar
regen  
Rob Austein committed
69
<dt><span class="term">-v</span></dt>
Tinderbox User's avatar
Tinderbox User committed
70
<dd><p>
Tinderbox User's avatar
Tinderbox User committed
71
            Print the version of the <span class="command"><strong>named-checkzone</strong></span>
Rob Austein's avatar
regen  
Rob Austein committed
72
            program and exit.
Tinderbox User's avatar
Tinderbox User committed
73
          </p></dd>
Rob Austein's avatar
regen  
Rob Austein committed
74
<dt><span class="term">-j</span></dt>
Tinderbox User's avatar
Tinderbox User committed
75
<dd><p>
Tinderbox User's avatar
Tinderbox User committed
76 77 78
            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
Tinderbox User committed
79
          </p></dd>
Tinderbox User's avatar
Tinderbox User committed
80
<dt><span class="term">-J <em class="replaceable"><code>filename</code></em></span></dt>
Tinderbox User's avatar
Tinderbox User committed
81
<dd><p>
Tinderbox User's avatar
Tinderbox User committed
82 83
            When loading the zone file read the journal from the given
            file, if it exists. (Implies -j.)
Tinderbox User's avatar
Tinderbox User committed
84
          </p></dd>
Rob Austein's avatar
regen  
Rob Austein committed
85
<dt><span class="term">-c <em class="replaceable"><code>class</code></em></span></dt>
Tinderbox User's avatar
Tinderbox User committed
86
<dd><p>
Automatic Updater's avatar
regen  
Automatic Updater committed
87
            Specify the class of the zone.  If not specified, "IN" is assumed.
Tinderbox User's avatar
Tinderbox User committed
88
          </p></dd>
Mark Andrews's avatar
regen  
Mark Andrews committed
89 90
<dt><span class="term">-i <em class="replaceable"><code>mode</code></em></span></dt>
<dd>
Tinderbox User's avatar
Tinderbox User committed
91
<p>
Mark Andrews's avatar
regen  
Mark Andrews committed
92
	      Perform post-load zone integrity checks.  Possible modes are
Tinderbox User's avatar
Tinderbox User committed
93 94 95 96 97
	      <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>.
Mark Andrews's avatar
regen  
Mark Andrews committed
98
	  </p>
Tinderbox User's avatar
Tinderbox User committed
99
<p>
Tinderbox User's avatar
Tinderbox User committed
100
	      Mode <span class="command"><strong>"full"</strong></span> checks that MX records
Mark Andrews's avatar
regen  
Mark Andrews committed
101
	      refer to A or AAAA record (both in-zone and out-of-zone
Tinderbox User's avatar
Tinderbox User committed
102
	      hostnames).  Mode <span class="command"><strong>"local"</strong></span> only
Mark Andrews's avatar
regen  
Mark Andrews committed
103 104
	      checks MX records which refer to in-zone hostnames.
	  </p>
Tinderbox User's avatar
Tinderbox User committed
105
<p>
Tinderbox User's avatar
Tinderbox User committed
106
	      Mode <span class="command"><strong>"full"</strong></span> checks that SRV records
Mark Andrews's avatar
regen  
Mark Andrews committed
107
	      refer to A or AAAA record (both in-zone and out-of-zone
Tinderbox User's avatar
Tinderbox User committed
108
	      hostnames).  Mode <span class="command"><strong>"local"</strong></span> only
Mark Andrews's avatar
regen  
Mark Andrews committed
109 110
	      checks SRV records which refer to in-zone hostnames.
	  </p>
Tinderbox User's avatar
Tinderbox User committed
111
<p>
Tinderbox User's avatar
Tinderbox User committed
112
	      Mode <span class="command"><strong>"full"</strong></span> checks that delegation NS
Mark Andrews's avatar
regen  
Mark Andrews committed
113
	      records refer to A or AAAA record (both in-zone and out-of-zone
Mark Andrews's avatar
regen  
Mark Andrews committed
114
	      hostnames).  It also checks that glue address records
Mark Andrews's avatar
regen  
Mark Andrews committed
115
	      in the zone match those advertised by the child.
Tinderbox User's avatar
Tinderbox User committed
116
	      Mode <span class="command"><strong>"local"</strong></span> only checks NS records which
Mark Andrews's avatar
regen  
Mark Andrews committed
117 118 119
	      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
Tinderbox User committed
120
<p>
Tinderbox User's avatar
Tinderbox User committed
121 122 123 124
	      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.
Mark Andrews's avatar
regen  
Mark Andrews committed
125
	  </p>
Tinderbox User's avatar
Tinderbox User committed
126
<p>
Tinderbox User's avatar
Tinderbox User committed
127
	      Mode <span class="command"><strong>"none"</strong></span> disables the checks.
Mark Andrews's avatar
regen  
Mark Andrews committed
128
	  </p>
Tinderbox User's avatar
Tinderbox User committed
129
</dd>
130
<dt><span class="term">-f <em class="replaceable"><code>format</code></em></span></dt>
Tinderbox User's avatar
Tinderbox User committed
131
<dd><p>
132
	    Specify the format of the zone file.
Tinderbox User's avatar
Tinderbox User committed
133 134
	    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
Tinderbox User committed
135
	  </p></dd>
136
<dt><span class="term">-F <em class="replaceable"><code>format</code></em></span></dt>
Automatic Updater's avatar
Automatic Updater committed
137
<dd>
Tinderbox User's avatar
Tinderbox User committed
138
<p>
139
	    Specify the format of the output file specified.
Tinderbox User's avatar
Tinderbox User committed
140
	    For <span class="command"><strong>named-checkzone</strong></span>,
141 142
	    this does not cause any effects unless it dumps the zone
	    contents.
Automatic Updater's avatar
Automatic Updater committed
143
	  </p>
Tinderbox User's avatar
Tinderbox User committed
144
<p>
Tinderbox User's avatar
Tinderbox User committed
145
	    Possible formats are <span class="command"><strong>"text"</strong></span> (default),
Tinderbox User's avatar
Tinderbox User committed
146
	    which is the standard textual representation of the zone,
Tinderbox User's avatar
Tinderbox User committed
147 148 149 150
	    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
Tinderbox User's avatar
Tinderbox User committed
151
            the raw zone file: if N is 0, the raw file can be read by
Tinderbox User's avatar
Tinderbox User committed
152
            any version of <span class="command"><strong>named</strong></span>; if N is 1, the file
Tinderbox User's avatar
Tinderbox User committed
153
            can be read by release 9.9.0 or higher; the default is 1.
Automatic Updater's avatar
Automatic Updater committed
154
	  </p>
Tinderbox User's avatar
Tinderbox User committed
155
</dd>
Rob Austein's avatar
regen  
Rob Austein committed
156
<dt><span class="term">-k <em class="replaceable"><code>mode</code></em></span></dt>
Tinderbox User's avatar
Tinderbox User committed
157
<dd><p>
Tinderbox User's avatar
Tinderbox User committed
158
            Perform <span class="command"><strong>"check-names"</strong></span> checks with the
159
	    specified failure mode.
Tinderbox User's avatar
Tinderbox User committed
160 161 162 163 164
            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
Tinderbox User committed
165
          </p></dd>
Tinderbox User's avatar
Tinderbox User committed
166
<dt><span class="term">-l <em class="replaceable"><code>ttl</code></em></span></dt>
Tinderbox User's avatar
Tinderbox User committed
167
<dd><p>
Tinderbox User's avatar
Tinderbox User committed
168 169 170
            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
Tinderbox User's avatar
Tinderbox User committed
171
            <span class="command"><strong>max-zone-ttl</strong></span> option in
Tinderbox User's avatar
Tinderbox User committed
172
            <code class="filename">named.conf</code>.
Tinderbox User's avatar
Tinderbox User committed
173
          </p></dd>
Automatic Updater's avatar
Automatic Updater committed
174
<dt><span class="term">-L <em class="replaceable"><code>serial</code></em></span></dt>
Tinderbox User's avatar
Tinderbox User committed
175
<dd><p>
Tinderbox User's avatar
Tinderbox User committed
176
            When compiling a zone to "raw" or "map" format, set the
Tinderbox User's avatar
Tinderbox User committed
177 178 179
            "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
Tinderbox User committed
180
          </p></dd>
Mark Andrews's avatar
regen  
Mark Andrews committed
181
<dt><span class="term">-m <em class="replaceable"><code>mode</code></em></span></dt>
Tinderbox User's avatar
Tinderbox User committed
182
<dd><p>
Mark Andrews's avatar
regen  
Mark Andrews committed
183
            Specify whether MX records should be checked to see if they
Tinderbox User's avatar
Tinderbox User committed
184 185 186
            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
Tinderbox User committed
187
          </p></dd>
Mark Andrews's avatar
regen  
Mark Andrews committed
188
<dt><span class="term">-M <em class="replaceable"><code>mode</code></em></span></dt>
Tinderbox User's avatar
Tinderbox User committed
189
<dd><p>
Mark Andrews's avatar
regen  
Mark Andrews committed
190
	    Check if a MX record refers to a CNAME.
Tinderbox User's avatar
Tinderbox User committed
191 192 193
            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
Tinderbox User committed
194
	  </p></dd>
Rob Austein's avatar
regen  
Rob Austein committed
195
<dt><span class="term">-n <em class="replaceable"><code>mode</code></em></span></dt>
Tinderbox User's avatar
Tinderbox User committed
196
<dd><p>
Rob Austein's avatar
regen  
Rob Austein committed
197
            Specify whether NS records should be checked to see if they
198
            are addresses.
Tinderbox User's avatar
Tinderbox User committed
199 200 201 202 203
	    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
Tinderbox User committed
204
          </p></dd>
Rob Austein's avatar
regen  
Rob Austein committed
205
<dt><span class="term">-o <em class="replaceable"><code>filename</code></em></span></dt>
Tinderbox User's avatar
Tinderbox User committed
206
<dd><p>
Rob Austein's avatar
regen  
Rob Austein committed
207
            Write zone output to <code class="filename">filename</code>.
Mark Andrews's avatar
regen  
Mark Andrews committed
208 209
	    If <code class="filename">filename</code> is <code class="filename">-</code> then
	    write to standard out.
Tinderbox User's avatar
Tinderbox User committed
210
	    This is mandatory for <span class="command"><strong>named-compilezone</strong></span>.
Tinderbox User's avatar
Tinderbox User committed
211
          </p></dd>
Automatic Updater's avatar
regen  
Automatic Updater committed
212
<dt><span class="term">-r <em class="replaceable"><code>mode</code></em></span></dt>
Tinderbox User's avatar
Tinderbox User committed
213
<dd><p>
Automatic Updater's avatar
regen  
Automatic Updater committed
214
            Check for records that are treated as different by DNSSEC but
Tinderbox User's avatar
Tinderbox User committed
215
	    are semantically equal in plain DNS.
Tinderbox User's avatar
Tinderbox User committed
216 217 218
            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
Tinderbox User committed
219
	  </p></dd>
220
<dt><span class="term">-s <em class="replaceable"><code>style</code></em></span></dt>
Tinderbox User's avatar
Tinderbox User committed
221
<dd><p>
222
	    Specify the style of the dumped zone file.
Tinderbox User's avatar
Tinderbox User committed
223 224
	    Possible styles are <span class="command"><strong>"full"</strong></span> (default)
	    and <span class="command"><strong>"relative"</strong></span>.
225 226
	    The full format is most suitable for processing
	    automatically by a separate script.
Mark Andrews's avatar
regen  
Mark Andrews committed
227
	    On the other hand, the relative format is more
228
	    human-readable and is thus suitable for editing by hand.
Tinderbox User's avatar
Tinderbox User committed
229
	    For <span class="command"><strong>named-checkzone</strong></span>
230 231 232 233
	    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
Tinderbox User committed
234
	  </p></dd>
Mark Andrews's avatar
regen  
Mark Andrews committed
235
<dt><span class="term">-S <em class="replaceable"><code>mode</code></em></span></dt>
Tinderbox User's avatar
Tinderbox User committed
236
<dd><p>
Mark Andrews's avatar
regen  
Mark Andrews committed
237
	    Check if a SRV record refers to a CNAME.
Tinderbox User's avatar
Tinderbox User committed
238 239 240
            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
Tinderbox User committed
241
	  </p></dd>
Rob Austein's avatar
regen  
Rob Austein committed
242
<dt><span class="term">-t <em class="replaceable"><code>directory</code></em></span></dt>
Tinderbox User's avatar
Tinderbox User committed
243
<dd><p>
Mark Andrews's avatar
regen  
Mark Andrews committed
244
            Chroot to <code class="filename">directory</code> so that
Rob Austein's avatar
regen  
Rob Austein committed
245 246
            include
            directives in the configuration file are processed as if
Tinderbox User's avatar
Tinderbox User committed
247
            run by a similarly chrooted <span class="command"><strong>named</strong></span>.
Tinderbox User's avatar
Tinderbox User committed
248
          </p></dd>
Tinderbox User's avatar
Tinderbox User committed
249
<dt><span class="term">-T <em class="replaceable"><code>mode</code></em></span></dt>
Tinderbox User's avatar
Tinderbox User committed
250
<dd><p>
Tinderbox User's avatar
Tinderbox User committed
251 252
	    Check if Sender Policy Framework (SPF) records exist
	    and issues a warning if an SPF-formatted TXT record is
Tinderbox User's avatar
Tinderbox User committed
253 254
	    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
Tinderbox User committed
255
	  </p></dd>
Rob Austein's avatar
regen  
Rob Austein committed
256
<dt><span class="term">-w <em class="replaceable"><code>directory</code></em></span></dt>
Tinderbox User's avatar
Tinderbox User committed
257
<dd><p>
Rob Austein's avatar
regen  
Rob Austein committed
258 259 260 261 262
            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
Tinderbox User committed
263
          </p></dd>
Rob Austein's avatar
regen  
Rob Austein committed
264
<dt><span class="term">-D</span></dt>
Tinderbox User's avatar
Tinderbox User committed
265
<dd><p>
Rob Austein's avatar
regen  
Rob Austein committed
266
            Dump zone file in canonical format.
Tinderbox User's avatar
Tinderbox User committed
267
	    This is always enabled for <span class="command"><strong>named-compilezone</strong></span>.
Tinderbox User's avatar
Tinderbox User committed
268
          </p></dd>
Rob Austein's avatar
regen  
Rob Austein committed
269
<dt><span class="term">-W <em class="replaceable"><code>mode</code></em></span></dt>
Tinderbox User's avatar
Tinderbox User committed
270
<dd><p>
Rob Austein's avatar
regen  
Rob Austein committed
271 272 273
            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).
Tinderbox User's avatar
Tinderbox User committed
274
            Possible modes are <span class="command"><strong>"warn"</strong></span> (default)
Rob Austein's avatar
regen  
Rob Austein committed
275
            and
Tinderbox User's avatar
Tinderbox User committed
276
            <span class="command"><strong>"ignore"</strong></span>.
Tinderbox User's avatar
Tinderbox User committed
277
          </p></dd>
Rob Austein's avatar
regen  
Rob Austein committed
278
<dt><span class="term">zonename</span></dt>
Tinderbox User's avatar
Tinderbox User committed
279
<dd><p>
Rob Austein's avatar
regen  
Rob Austein committed
280
            The domain name of the zone being checked.
Tinderbox User's avatar
Tinderbox User committed
281
          </p></dd>
Rob Austein's avatar
regen  
Rob Austein committed
282
<dt><span class="term">filename</span></dt>
Tinderbox User's avatar
Tinderbox User committed
283
<dd><p>
Rob Austein's avatar
regen  
Rob Austein committed
284
            The name of the zone file.
Tinderbox User's avatar
Tinderbox User committed
285
          </p></dd>
Rob Austein's avatar
regen  
Rob Austein committed
286
</dl></div>
Tinderbox User's avatar
Tinderbox User committed
287 288 289 290
</div>
<div class="refsection">
<a name="id-1.9"></a><h2>RETURN VALUES</h2>
<p><span class="command"><strong>named-checkzone</strong></span>
Rob Austein's avatar
regen  
Rob Austein committed
291 292 293
      returns an exit status of 1 if
      errors were detected and 0 otherwise.
    </p>
Tinderbox User's avatar
Tinderbox User committed
294 295 296 297 298
</div>
<div class="refsection">
<a name="id-1.10"></a><h2>SEE ALSO</h2>
<p><span class="citerefentry"><span class="refentrytitle">named</span>(8)</span>,
      <span class="citerefentry"><span class="refentrytitle">named-checkconf</span>(8)</span>,
Rob Austein's avatar
regen  
Rob Austein committed
299 300 301
      <em class="citetitle">RFC 1035</em>,
      <em class="citetitle">BIND 9 Administrator Reference Manual</em>.
    </p>
Tinderbox User's avatar
Tinderbox User committed
302
</div>
Rob Austein's avatar
regen  
Rob Austein committed
303 304
</div></body>
</html>