/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. 

  2.  - Copyright (C) 2004-2012 Internet Systems Consortium, Inc. ("ISC")
    3. 

  3.  - Copyright (C) 2000-2003 Internet Software Consortium.
    4. 

  4.  - 
    5. 

  5.  - Permission to use, copy, modify, and/or distribute this software for any
    6. 

  6.  - purpose with or without fee is hereby granted, provided that the above
    7. 

  7.  - copyright notice and this permission notice appear in all copies.
    8. 

  8.  - 
    9. 

  9.  - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
    10. 

  10.  - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
    11. 

  11.  - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
    12. 

  12.  - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
    13. 

  13.  - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
    14. 

  14.  - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
    15. 

  15.  - PERFORMANCE OF THIS SOFTWARE.
    16. 

  16. -->
    17. 

  17. <!-- $Id$ -->
    18. 

  18. <html>
    19. 

  19. <head>
    20. 

  20. <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
    21. 

  21. <title>named-checkzone</title>
    22. 

  22. <meta name="generator" content="DocBook XSL Stylesheets V1.71.1">
    23. 

  23. <link rel="start" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual">
    24. 

  24. <link rel="up" href="Bv9ARM.ch10.html" title="Manual pages">
    25. 

  25. <link rel="prev" href="man.named-checkconf.html" title="named-checkconf">
    26. 

  26. <link rel="next" href="man.named.html" title="named">
    27. 

  27. </head>
    28. 

  28. <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
    29. 

  29. <div class="navheader">
    30. 

  30. <table width="100%" summary="Navigation header">
    31. 

  31. <tr><th colspan="3" align="center"><span class="application">named-checkzone</span></th></tr>
    32. 

  32. <tr>
    33. 

  33. <td width="20%" align="left">
    34. 

  34. <a accesskey="p" href="man.named-checkconf.html">Prev</a> </td>
    35. 

  35. <th width="60%" align="center">Manual pages</th>
    36. 

  36. <td width="20%" align="right"> <a accesskey="n" href="man.named.html">Next</a>
    37. 

  37. </td>
    38. 

  38. </tr>
    39. 

  39. </table>
    40. 

  40. <hr>
    41. 

  41. </div>
    42. 

  42. <div class="refentry" lang="en">
    43. 

  43. <a name="man.named-checkzone"></a><div class="titlepage"></div>
    44. 

  44. <div class="refnamediv">
    45. 

  45. <h2>Name</h2>
    46. 

  46. <p><span class="application">named-checkzone</span>, <span class="application">named-compilezone</span> &#8212; zone file validity checking or converting tool</p>
    47. 

  47. </div>
    48. 

  48. <div class="refsynopsisdiv">
    49. 

  49. <h2>Synopsis</h2>
    50. 

  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. 

  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. 

  52. </div>
    53. 

  53. <div class="refsect1" lang="en">
    54. 

  54. <a name="id2633185"></a><h2>DESCRIPTION</h2>
    55. 

  55. <p><span><strong class="command">named-checkzone</strong></span>
    56. 

  56.       checks the syntax and integrity of a zone file.  It performs the
    57. 

  57.       same checks as <span><strong class="command">named</strong></span> does when loading a
    58. 

  58.       zone.  This makes <span><strong class="command">named-checkzone</strong></span> useful for
    59. 

  59.       checking zone files before configuring them into a name server.
    60. 

  60.     </p>
    61. 

  61. <p>
    62. 

  62.         <span><strong class="command">named-compilezone</strong></span> is similar to
    63. 

  63. 	<span><strong class="command">named-checkzone</strong></span>, but it always dumps the
    64. 

  64.         zone contents to a specified file in a specified format.
    65. 

  65. 	Additionally, it applies stricter check levels by default,
    66. 

  66.         since the dump output will be used as an actual zone file
    67. 

  67. 	loaded by <span><strong class="command">named</strong></span>.
    68. 

  68. 	When manually specified otherwise, the check levels must at
    69. 

  69.         least be as strict as those specified in the
    70. 

  70. 	<span><strong class="command">named</strong></span> configuration file.
    71. 

  71.      </p>
    72. 

  72. </div>
    73. 

  73. <div class="refsect1" lang="en">
    74. 

  74. <a name="id2633235"></a><h2>OPTIONS</h2>
    75. 

  75. <div class="variablelist"><dl>
    76. 

  76. <dt><span class="term">-d</span></dt>
    77. 

  77. <dd><p>
    78. 

  78.             Enable debugging.
    79. 

  79.           </p></dd>
    80. 

  80. <dt><span class="term">-h</span></dt>
    81. 

  81. <dd><p>
    82. 

  82.             Print the usage summary and exit.
    83. 

  83.           </p></dd>
    84. 

  84. <dt><span class="term">-q</span></dt>
    85. 

  85. <dd><p>
    86. 

  86.             Quiet mode - exit code only.
    87. 

  87.           </p></dd>
    88. 

  88. <dt><span class="term">-v</span></dt>
    89. 

  89. <dd><p>
    90. 

  90.             Print the version of the <span><strong class="command">named-checkzone</strong></span>
    91. 

  91.             program and exit.
    92. 

  92.           </p></dd>
    93. 

  93. <dt><span class="term">-j</span></dt>
    94. 

  94. <dd><p>
    95. 

  95.             When loading the zone file read the journal if it exists.
    96. 

  96.           </p></dd>
    97. 

  97. <dt><span class="term">-c <em class="replaceable"><code>class</code></em></span></dt>
    98. 

  98. <dd><p>
    99. 

  99.             Specify the class of the zone.  If not specified, "IN" is assumed.
    100. 

  100.           </p></dd>
    101. 

  101. <dt><span class="term">-i <em class="replaceable"><code>mode</code></em></span></dt>
    102. 

  102. <dd>
    103. 

  103. <p>
    104. 

  104. 	      Perform post-load zone integrity checks.  Possible modes are
    105. 

  105. 	      <span><strong class="command">"full"</strong></span> (default),
    106. 

  106. 	      <span><strong class="command">"full-sibling"</strong></span>,
    107. 

  107. 	      <span><strong class="command">"local"</strong></span>,
    108. 

  108. 	      <span><strong class="command">"local-sibling"</strong></span> and
    109. 

  109. 	      <span><strong class="command">"none"</strong></span>.
    110. 

  110. 	  </p>
    111. 

  111. <p>
    112. 

  112. 	      Mode <span><strong class="command">"full"</strong></span> checks that MX records
    113. 

  113. 	      refer to A or AAAA record (both in-zone and out-of-zone
    114. 

  114. 	      hostnames).  Mode <span><strong class="command">"local"</strong></span> only
    115. 

  115. 	      checks MX records which refer to in-zone hostnames.
    116. 

  116. 	  </p>
    117. 

  117. <p>
    118. 

  118. 	      Mode <span><strong class="command">"full"</strong></span> checks that SRV records
    119. 

  119. 	      refer to A or AAAA record (both in-zone and out-of-zone
    120. 

  120. 	      hostnames).  Mode <span><strong class="command">"local"</strong></span> only
    121. 

  121. 	      checks SRV records which refer to in-zone hostnames.
    122. 

  122. 	  </p>
    123. 

  123. <p>
    124. 

  124. 	      Mode <span><strong class="command">"full"</strong></span> checks that delegation NS
    125. 

  125. 	      records refer to A or AAAA record (both in-zone and out-of-zone
    126. 

  126. 	      hostnames).  It also checks that glue address records
    127. 

  127. 	      in the zone match those advertised by the child.
    128. 

  128. 	      Mode <span><strong class="command">"local"</strong></span> only checks NS records which
    129. 

  129. 	      refer to in-zone hostnames or that some required glue exists,
    130. 

  130. 	      that is when the nameserver is in a child zone.
    131. 

  131. 	  </p>
    132. 

  132. <p>
    133. 

  133. 	      Mode <span><strong class="command">"full-sibling"</strong></span> and
    134. 

  134. 	      <span><strong class="command">"local-sibling"</strong></span> disable sibling glue
    135. 

  135. 	      checks but are otherwise the same as <span><strong class="command">"full"</strong></span>
    136. 

  136. 	      and <span><strong class="command">"local"</strong></span> respectively.
    137. 

  137. 	  </p>
    138. 

  138. <p>
    139. 

  139. 	      Mode <span><strong class="command">"none"</strong></span> disables the checks.
    140. 

  140. 	  </p>
    141. 

  141. </dd>
    142. 

  142. <dt><span class="term">-f <em class="replaceable"><code>format</code></em></span></dt>
    143. 

  143. <dd><p>
    144. 

  144. 	    Specify the format of the zone file.
    145. 

  145. 	    Possible formats are <span><strong class="command">"text"</strong></span> (default)
    146. 

  146. 	    and <span><strong class="command">"raw"</strong></span>.
    147. 

  147. 	  </p></dd>
    148. 

  148. <dt><span class="term">-F <em class="replaceable"><code>format</code></em></span></dt>
    149. 

  149. <dd><p>
    150. 

  150. 	    Specify the format of the output file specified.
    151. 

  151. 	    Possible formats are <span><strong class="command">"text"</strong></span> (default)
    152. 

  152. 	    and <span><strong class="command">"raw"</strong></span>.
    153. 

  153. 	    For <span><strong class="command">named-checkzone</strong></span>,
    154. 

  154. 	    this does not cause any effects unless it dumps the zone
    155. 

  155. 	    contents.
    156. 

  156. 	  </p></dd>
    157. 

  157. <dt><span class="term">-k <em class="replaceable"><code>mode</code></em></span></dt>
    158. 

  158. <dd><p>
    159. 

  159.             Perform <span><strong class="command">"check-names"</strong></span> checks with the
    160. 

  160. 	    specified failure mode.
    161. 

  161.             Possible modes are <span><strong class="command">"fail"</strong></span>
    162. 

  162. 	    (default for <span><strong class="command">named-compilezone</strong></span>),
    163. 

  163.             <span><strong class="command">"warn"</strong></span>
    164. 

  164. 	    (default for <span><strong class="command">named-checkzone</strong></span>) and
    165. 

  165.             <span><strong class="command">"ignore"</strong></span>.
    166. 

  166.           </p></dd>
    167. 

  167. <dt><span class="term">-m <em class="replaceable"><code>mode</code></em></span></dt>
    168. 

  168. <dd><p>
    169. 

  169.             Specify whether MX records should be checked to see if they
    170. 

  170.             are addresses.  Possible modes are <span><strong class="command">"fail"</strong></span>,
    171. 

  171.             <span><strong class="command">"warn"</strong></span> (default) and
    172. 

  172.             <span><strong class="command">"ignore"</strong></span>.
    173. 

  173.           </p></dd>
    174. 

  174. <dt><span class="term">-M <em class="replaceable"><code>mode</code></em></span></dt>
    175. 

  175. <dd><p>
    176. 

  176. 	    Check if a MX record refers to a CNAME.
    177. 

  177.             Possible modes are <span><strong class="command">"fail"</strong></span>,
    178. 

  178.             <span><strong class="command">"warn"</strong></span> (default) and
    179. 

  179.             <span><strong class="command">"ignore"</strong></span>.
    180. 

  180. 	  </p></dd>
    181. 

  181. <dt><span class="term">-n <em class="replaceable"><code>mode</code></em></span></dt>
    182. 

  182. <dd><p>
    183. 

  183.             Specify whether NS records should be checked to see if they
    184. 

  184.             are addresses.
    185. 

  185. 	    Possible modes are <span><strong class="command">"fail"</strong></span>
    186. 

  186. 	    (default for <span><strong class="command">named-compilezone</strong></span>),
    187. 

  187.             <span><strong class="command">"warn"</strong></span>
    188. 

  188. 	    (default for <span><strong class="command">named-checkzone</strong></span>) and
    189. 

  189.             <span><strong class="command">"ignore"</strong></span>.
    190. 

  190.           </p></dd>
    191. 

  191. <dt><span class="term">-o <em class="replaceable"><code>filename</code></em></span></dt>
    192. 

  192. <dd><p>
    193. 

  193.             Write zone output to <code class="filename">filename</code>.
    194. 

  194. 	    If <code class="filename">filename</code> is <code class="filename">-</code> then
    195. 

  195. 	    write to standard out.
    196. 

  196. 	    This is mandatory for <span><strong class="command">named-compilezone</strong></span>.
    197. 

  197.           </p></dd>
    198. 

  198. <dt><span class="term">-r <em class="replaceable"><code>mode</code></em></span></dt>
    199. 

  199. <dd><p>
    200. 

  200.             Check for records that are treated as different by DNSSEC but
    201. 

  201. 	    are semantically equal in plain DNS.  
    202. 

  202.             Possible modes are <span><strong class="command">"fail"</strong></span>,
    203. 

  203.             <span><strong class="command">"warn"</strong></span> (default) and
    204. 

  204.             <span><strong class="command">"ignore"</strong></span>.
    205. 

  205. 	  </p></dd>
    206. 

  206. <dt><span class="term">-s <em class="replaceable"><code>style</code></em></span></dt>
    207. 

  207. <dd><p>
    208. 

  208. 	    Specify the style of the dumped zone file.
    209. 

  209. 	    Possible styles are <span><strong class="command">"full"</strong></span> (default)
    210. 

  210. 	    and <span><strong class="command">"relative"</strong></span>.
    211. 

  211. 	    The full format is most suitable for processing
    212. 

  212. 	    automatically by a separate script.
    213. 

  213. 	    On the other hand, the relative format is more
    214. 

  214. 	    human-readable and is thus suitable for editing by hand.
    215. 

  215. 	    For <span><strong class="command">named-checkzone</strong></span>
    216. 

  216. 	    this does not cause any effects unless it dumps the zone
    217. 

  217. 	    contents.
    218. 

  218. 	    It also does not have any meaning if the output format
    219. 

  219. 	    is not text.
    220. 

  220. 	  </p></dd>
    221. 

  221. <dt><span class="term">-S <em class="replaceable"><code>mode</code></em></span></dt>
    222. 

  222. <dd><p>
    223. 

  223. 	    Check if a SRV record refers to a CNAME.
    224. 

  224.             Possible modes are <span><strong class="command">"fail"</strong></span>,
    225. 

  225.             <span><strong class="command">"warn"</strong></span> (default) and
    226. 

  226.             <span><strong class="command">"ignore"</strong></span>.
    227. 

  227. 	  </p></dd>
    228. 

  228. <dt><span class="term">-t <em class="replaceable"><code>directory</code></em></span></dt>
    229. 

  229. <dd><p>
    230. 

  230.             Chroot to <code class="filename">directory</code> so that
    231. 

  231.             include
    232. 

  232.             directives in the configuration file are processed as if
    233. 

  233.             run by a similarly chrooted named.
    234. 

  234.           </p></dd>
    235. 

  235. <dt><span class="term">-w <em class="replaceable"><code>directory</code></em></span></dt>
    236. 

  236. <dd><p>
    237. 

  237.             chdir to <code class="filename">directory</code> so that
    238. 

  238.             relative
    239. 

  239.             filenames in master file $INCLUDE directives work.  This
    240. 

  240.             is similar to the directory clause in
    241. 

  241.             <code class="filename">named.conf</code>.
    242. 

  242.           </p></dd>
    243. 

  243. <dt><span class="term">-D</span></dt>
    244. 

  244. <dd><p>
    245. 

  245.             Dump zone file in canonical format.
    246. 

  246. 	    This is always enabled for <span><strong class="command">named-compilezone</strong></span>.
    247. 

  247.           </p></dd>
    248. 

  248. <dt><span class="term">-W <em class="replaceable"><code>mode</code></em></span></dt>
    249. 

  249. <dd><p>
    250. 

  250.             Specify whether to check for non-terminal wildcards.
    251. 

  251.             Non-terminal wildcards are almost always the result of a
    252. 

  252.             failure to understand the wildcard matching algorithm (RFC 1034).
    253. 

  253.             Possible modes are <span><strong class="command">"warn"</strong></span> (default)
    254. 

  254.             and
    255. 

  255.             <span><strong class="command">"ignore"</strong></span>.
    256. 

  256.           </p></dd>
    257. 

  257. <dt><span class="term">zonename</span></dt>
    258. 

  258. <dd><p>
    259. 

  259.             The domain name of the zone being checked.
    260. 

  260.           </p></dd>
    261. 

  261. <dt><span class="term">filename</span></dt>
    262. 

  262. <dd><p>
    263. 

  263.             The name of the zone file.
    264. 

  264.           </p></dd>
    265. 

  265. </dl></div>
    266. 

  266. </div>
    267. 

  267. <div class="refsect1" lang="en">
    268. 

  268. <a name="id2673464"></a><h2>RETURN VALUES</h2>
    269. 

  269. <p><span><strong class="command">named-checkzone</strong></span>
    270. 

  270.       returns an exit status of 1 if
    271. 

  271.       errors were detected and 0 otherwise.
    272. 

  272.     </p>
    273. 

  273. </div>
    274. 

  274. <div class="refsect1" lang="en">
    275. 

  275. <a name="id2673478"></a><h2>SEE ALSO</h2>
    276. 

  276. <p><span class="citerefentry"><span class="refentrytitle">named</span>(8)</span>,
    277. 

  277.       <span class="citerefentry"><span class="refentrytitle">named-checkconf</span>(8)</span>,
    278. 

  278.       <em class="citetitle">RFC 1035</em>,
    279. 

  279.       <em class="citetitle">BIND 9 Administrator Reference Manual</em>.
    280. 

  280.     </p>
    281. 

  281. </div>
    282. 

  282. <div class="refsect1" lang="en">
    283. 

  283. <a name="id2673511"></a><h2>AUTHOR</h2>
    284. 

  284. <p><span class="corpauthor">Internet Systems Consortium</span>
    285. 

  285.     </p>
    286. 

  286. </div>
    287. 

  287. </div>
    288. 

  288. <div class="navfooter">
    289. 

  289. <hr>
    290. 

  290. <table width="100%" summary="Navigation footer">
    291. 

  291. <tr>
    292. 

  292. <td width="40%" align="left">
    293. 

  293. <a accesskey="p" href="man.named-checkconf.html">Prev</a> </td>
    294. 

  294. <td width="20%" align="center"><a accesskey="u" href="Bv9ARM.ch10.html">Up</a></td>
    295. 

  295. <td width="40%" align="right"> <a accesskey="n" href="man.named.html">Next</a>
    296. 

  296. </td>
    297. 

  297. </tr>
    298. 

  298. <tr>
    299. 

  299. <td width="40%" align="left" valign="top">
    300. 

  300. <span class="application">named-checkconf</span> </td>
    301. 

  301. <td width="20%" align="center"><a accesskey="h" href="Bv9ARM.html">Home</a></td>
    302. 

  302. <td width="40%" align="right" valign="top"> <span class="application">named</span>
    303. 

  303. </td>
    304. 

  304. </tr>
    305. 

  305. </table>
    306. 

  306. </div>
    307. 

  307. </body>
    308. 

  308. </html>
    309.