man.named-checkconf.html revision 1e126d80e1b8a0dd541a733283907656424634dc
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd - Copyright (C) 2004-2015 Internet Systems Consortium, Inc. ("ISC")
fd9abdda70912b99b24e3bf1a38f26fde908a74cnd - Copyright (C) 2000-2003 Internet Software Consortium.
fd9abdda70912b99b24e3bf1a38f26fde908a74cnd - Permission to use, copy, modify, and/or distribute this software for any
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd - purpose with or without fee is hereby granted, provided that the above
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd - copyright notice and this permission notice appear in all copies.
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
96ad5d81ee4a2cc66a4ae19893efc8aa6d06fae7jailletc - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
d29d9ab4614ff992b0e8de6e2b88d52b6f1f153erbowen - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
2e545ce2450a9953665f701bb05350f0d3f26275nd - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
d29d9ab4614ff992b0e8de6e2b88d52b6f1f153erbowen - PERFORMANCE OF THIS SOFTWARE.
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
3f08db06526d6901aa08c110b5bc7dde6bc39905nd<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd<link rel="home" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual">
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd<link rel="up" href="Bv9ARM.ch13.html" title="Manual pages">
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd<link rel="prev" href="man.named.conf.html" title="named.conf">
3f08db06526d6901aa08c110b5bc7dde6bc39905nd<link rel="next" href="man.named-checkzone.html" title="named-checkzone">
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
11495c9f0bd33e51a25b4d532beadfbcf9b944a3nilgun<tr><th colspan="3" align="center"><span class="application">named-checkconf</span></th></tr>
f086b4b402fa9a2fefc7dda85de2a3cc1cd0a654rjung<a accesskey="p" href="man.named.conf.html">Prev</a>�</td>
4b575a6b6704b516f22d65a3ad35696d7b9ba372rpluem<td width="20%" align="right">�<a accesskey="n" href="man.named-checkzone.html">Next</a>
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd<a name="man.named-checkconf"></a><div class="titlepage"></div>
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd<p><span class="application">named-checkconf</span> — named configuration file syntax checking tool</p>
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd<div class="cmdsynopsis"><p><code class="command">named-checkconf</code> [<code class="option">-h</code>] [<code class="option">-v</code>] [<code class="option">-j</code>] [<code class="option">-t <em class="replaceable"><code>directory</code></em></code>] {filename} [<code class="option">-p</code>] [<code class="option">-x</code>] [<code class="option">-z</code>]</p></div>
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd<p><span class="command"><strong>named-checkconf</strong></span>
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd checks the syntax, but not the semantics, of a
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd <span class="command"><strong>named</strong></span> configuration file. The file is parsed
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd and checked for syntax errors, along with all files included by it.
30471a4650391f57975f60bbb6e4a90be7b284bfhumbedooh If no file is specified, <code class="filename">/etc/named.conf</code> is read
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar by default.
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd Note: files that <span class="command"><strong>named</strong></span> reads in separate
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd parser contexts, such as <code class="filename">rndc.key</code> and
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd <code class="filename">bind.keys</code>, are not automatically read
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd by <span class="command"><strong>named-checkconf</strong></span>. Configuration
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd errors in these files may cause <span class="command"><strong>named</strong></span> to
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd fail to run, even if <span class="command"><strong>named-checkconf</strong></span> was
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd successful. <span class="command"><strong>named-checkconf</strong></span> can be run
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd on these files explicitly, however.
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd Print the usage summary and exit.
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd<dt><span class="term">-t <em class="replaceable"><code>directory</code></em></span></dt>
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd Chroot to <code class="filename">directory</code> so that include
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd directives in the configuration file are processed as if
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd run by a similarly chrooted <span class="command"><strong>named</strong></span>.
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd Print the version of the <span class="command"><strong>named-checkconf</strong></span>
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd program and exit.
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd Print out the <code class="filename">named.conf</code> and included files
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd in canonical form if no errors were detected.
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd When printing the configuration files in canonical
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd form, obscure shared secrets by replacing them with
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd strings of question marks ('?'). This allows the
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd contents of <code class="filename">named.conf</code> and related
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd files to be shared — for example, when submitting
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd bug reports — without compromising private data.
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd This option cannot be used without <code class="option">-p</code>.
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd Perform a test load of all master zones found in
8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6bnd When loading a zonefile read the journal if it exists.
ad74a0524a06bfe11b7de9e3b4ce7233ab3bd3f7nd The name of the configuration file to be checked. If not
11495c9f0bd33e51a25b4d532beadfbcf9b944a3nilgun specified, it defaults to <code class="filename">/etc/named.conf</code>.
727872d18412fc021f03969b8641810d8896820bhumbedooh<p><span class="command"><strong>named-checkconf</strong></span>
cc7e1025de9ac63bd4db6fe7f71c158b2cf09fe4humbedooh returns an exit status of 1 if
0d0ba3a410038e179b695446bb149cce6264e0abnd errors were detected and 0 otherwise.
0d0ba3a410038e179b695446bb149cce6264e0abnd<p><span class="citerefentry"><span class="refentrytitle">named</span>(8)</span>,
ac082aefa89416cbdc9a1836eaf3bed9698201c8humbedooh <span class="citerefentry"><span class="refentrytitle">named-checkzone</span>(8)</span>,
0d0ba3a410038e179b695446bb149cce6264e0abnd <em class="citetitle">BIND 9 Administrator Reference Manual</em>.
0d0ba3a410038e179b695446bb149cce6264e0abnd<a accesskey="p" href="man.named.conf.html">Prev</a>�</td>
7fec19672a491661b2fe4b29f685bc7f4efa64d4nd<td width="20%" align="center"><a accesskey="u" href="Bv9ARM.ch13.html">Up</a></td>
7fec19672a491661b2fe4b29f685bc7f4efa64d4nd<td width="40%" align="right">�<a accesskey="n" href="man.named-checkzone.html">Next</a>