man.named-checkconf.html revision 5002bd49e8716be88945d6779202f5b34e435413
ebbfa36a628b935891b2f8a2c5936aef48b87151Michael Sawyer - Copyright (C) 2004-2015 Internet Systems Consortium, Inc. ("ISC")
40f53fa8d9c6a4fc38c0014495e7a42b08f52481David Lawrence - Copyright (C) 2000-2003 Internet Software Consortium.
ebbfa36a628b935891b2f8a2c5936aef48b87151Michael Sawyer - Permission to use, copy, modify, and/or distribute this software for any
ebbfa36a628b935891b2f8a2c5936aef48b87151Michael Sawyer - purpose with or without fee is hereby granted, provided that the above
40f53fa8d9c6a4fc38c0014495e7a42b08f52481David Lawrence - copyright notice and this permission notice appear in all copies.
15a44745412679c30a6d022733925af70a38b715David Lawrence - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
15a44745412679c30a6d022733925af70a38b715David Lawrence - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
15a44745412679c30a6d022733925af70a38b715David Lawrence - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
15a44745412679c30a6d022733925af70a38b715David Lawrence - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
15a44745412679c30a6d022733925af70a38b715David Lawrence - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
15a44745412679c30a6d022733925af70a38b715David Lawrence - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
15a44745412679c30a6d022733925af70a38b715David Lawrence - PERFORMANCE OF THIS SOFTWARE.
f17b62a64bec4690f7ef0263efee1fa727b66fd5Michael Sawyer<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
f17b62a64bec4690f7ef0263efee1fa727b66fd5Michael Sawyer<meta name="generator" content="DocBook XSL Stylesheets V1.71.1">
f17b62a64bec4690f7ef0263efee1fa727b66fd5Michael Sawyer<link rel="start" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual">
f17b62a64bec4690f7ef0263efee1fa727b66fd5Michael Sawyer<link rel="up" href="Bv9ARM.ch13.html" title="Manual pages">
f17b62a64bec4690f7ef0263efee1fa727b66fd5Michael Sawyer<link rel="prev" href="man.dnssec-verify.html" title="dnssec-verify">
f17b62a64bec4690f7ef0263efee1fa727b66fd5Michael Sawyer<link rel="next" href="man.named-checkzone.html" title="named-checkzone">
f17b62a64bec4690f7ef0263efee1fa727b66fd5Michael Sawyer<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
ebbfa36a628b935891b2f8a2c5936aef48b87151Michael Sawyer<table width="100%" summary="Navigation header">
ebbfa36a628b935891b2f8a2c5936aef48b87151Michael Sawyer<tr><th colspan="3" align="center"><span class="application">named-checkconf</span></th></tr>
0819ae2ca51571d205df061b52d8468889f3a0dfMichael Sawyer<a accesskey="p" href="man.dnssec-verify.html">Prev</a>�</td>
38cf6e52ce4b33795713388824b69d78e430b115Michael Sawyer<th width="60%" align="center">Manual pages</th>
ebbfa36a628b935891b2f8a2c5936aef48b87151Michael Sawyer<td width="20%" align="right">�<a accesskey="n" href="man.named-checkzone.html">Next</a>
c9defbf4b968e8a61f391246431ac63d0d6a39abMichael Sawyer<a name="man.named-checkconf"></a><div class="titlepage"></div>
ebbfa36a628b935891b2f8a2c5936aef48b87151Michael Sawyer<p><span class="application">named-checkconf</span> — named configuration file syntax checking tool</p>
24139527f3d0d3fe743bd867329a2edd529728a6Andreas Gustafsson<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>
c9defbf4b968e8a61f391246431ac63d0d6a39abMichael Sawyer<p><span><strong class="command">named-checkconf</strong></span>
c9defbf4b968e8a61f391246431ac63d0d6a39abMichael Sawyer checks the syntax, but not the semantics, of a
6bc106bb7ed216ca3a86245181ea8e2b0b658a64Michael Sawyer <span><strong class="command">named</strong></span> configuration file. The file is parsed
c9defbf4b968e8a61f391246431ac63d0d6a39abMichael Sawyer and checked for syntax errors, along with all files included by it.
c9defbf4b968e8a61f391246431ac63d0d6a39abMichael Sawyer If no file is specified, <code class="filename">/etc/named.conf</code> is read
263408006365a7b4647d2eb645850b018edb47aaMichael Sawyer Note: files that <span><strong class="command">named</strong></span> reads in separate
ebbfa36a628b935891b2f8a2c5936aef48b87151Michael Sawyer parser contexts, such as <code class="filename">rndc.key</code> and
ebbfa36a628b935891b2f8a2c5936aef48b87151Michael Sawyer <code class="filename">bind.keys</code>, are not automatically read
ebbfa36a628b935891b2f8a2c5936aef48b87151Michael Sawyer by <span><strong class="command">named-checkconf</strong></span>. Configuration
e715e011788a529446b8013239c33599542ece32Michael Sawyer errors in these files may cause <span><strong class="command">named</strong></span> to
7949dbdae1db33e6263d754e5940daa1dfba59f9Michael Sawyer fail to run, even if <span><strong class="command">named-checkconf</strong></span> was
ebbfa36a628b935891b2f8a2c5936aef48b87151Michael Sawyer successful. <span><strong class="command">named-checkconf</strong></span> can be run
24139527f3d0d3fe743bd867329a2edd529728a6Andreas Gustafsson on these files explicitly, however.
f900be21902d02418c2c71ffed754fb3f9f54cffMichael Sawyer Print the usage summary and exit.
55bf97a1b4b7f78b669b1179df1422cb9789c484Michael Sawyer<dt><span class="term">-t <em class="replaceable"><code>directory</code></em></span></dt>
e69ccf6d54db6e749470341e2c84996ecc77e5ecMichael Sawyer Chroot to <code class="filename">directory</code> so that include
2386f92414d8bc4d49a605be2ffd8f8cb1941b0bMichael Sawyer directives in the configuration file are processed as if
6e49e91bd08778d7eae45a2229dcf41ed97cc636David Lawrence run by a similarly chrooted <span><strong class="command">named</strong></span>.
6e49e91bd08778d7eae45a2229dcf41ed97cc636David Lawrence Print the version of the <span><strong class="command">named-checkconf</strong></span>
4e0dc7b50c8d36a826dfd49c733479efa2feb6f9Michael Sawyer program and exit.
d2895dd9bba25beaa167cb1fe9282855bc002768Michael Sawyer Print out the <code class="filename">named.conf</code> and included files
0eb5cf735133924dc9baab388236bef470480dceMichael Sawyer in canonical form if no errors were detected.
24139527f3d0d3fe743bd867329a2edd529728a6Andreas Gustafsson When printing the configuration files in canonical
19c8df90f1f23c3df870c1771c89c1acdb15020eMichael Sawyer form, obscure shared secrets by replacing them with
19c8df90f1f23c3df870c1771c89c1acdb15020eMichael Sawyer strings of question marks ('?'). This allows the
19c8df90f1f23c3df870c1771c89c1acdb15020eMichael Sawyer contents of <code class="filename">named.conf</code> and related
19c8df90f1f23c3df870c1771c89c1acdb15020eMichael Sawyer files to be shared — for example, when submitting
19c8df90f1f23c3df870c1771c89c1acdb15020eMichael Sawyer bug reports — without compromising private data.
19c8df90f1f23c3df870c1771c89c1acdb15020eMichael Sawyer This option cannot be used without <code class="option">-p</code>.
19c8df90f1f23c3df870c1771c89c1acdb15020eMichael Sawyer Perform a test load of all master zones found in
a5ed46c9fd270775c39770bfd0250a52d374ebf2Michael Sawyer When loading a zonefile read the journal if it exists.
77365675e9db53de6ef728c98fc696ce86e88e63Michael Sawyer The name of the configuration file to be checked. If not
910df0c767ea973a59e866adb33bddf24b584f3dMichael Sawyer specified, it defaults to <code class="filename">/etc/named.conf</code>.
8bf0f722f83894b7808011dd700e3f8fce45e65dMichael Sawyer<a name="id2645056"></a><h2>RETURN VALUES</h2>
8cd54a7461ad183f9e839d96cedb7b7ad03fb244Michael Sawyer<p><span><strong class="command">named-checkconf</strong></span>
8cd54a7461ad183f9e839d96cedb7b7ad03fb244Michael Sawyer returns an exit status of 1 if
8cd54a7461ad183f9e839d96cedb7b7ad03fb244Michael Sawyer errors were detected and 0 otherwise.
8cd54a7461ad183f9e839d96cedb7b7ad03fb244Michael Sawyer<p><span class="citerefentry"><span class="refentrytitle">named</span>(8)</span>,
8cd54a7461ad183f9e839d96cedb7b7ad03fb244Michael Sawyer <span class="citerefentry"><span class="refentrytitle">named-checkzone</span>(8)</span>,
8cd54a7461ad183f9e839d96cedb7b7ad03fb244Michael Sawyer <em class="citetitle">BIND 9 Administrator Reference Manual</em>.
8cd54a7461ad183f9e839d96cedb7b7ad03fb244Michael Sawyer<p><span class="corpauthor">Internet Systems Consortium</span>
5e804988e97fad716f50b8471ba8a2faf90eea5fMichael Sawyer<table width="100%" summary="Navigation footer">
5e804988e97fad716f50b8471ba8a2faf90eea5fMichael Sawyer<a accesskey="p" href="man.dnssec-verify.html">Prev</a>�</td>
5e804988e97fad716f50b8471ba8a2faf90eea5fMichael Sawyer<td width="20%" align="center"><a accesskey="u" href="Bv9ARM.ch13.html">Up</a></td>
34fec86ca3a81a4d4490d144717b1e714d1fee07Mark Andrews<td width="40%" align="right">�<a accesskey="n" href="man.named-checkzone.html">Next</a>
e412ae947df6de858883564b8676a9650df70d9aMark Andrews<span class="application">dnssec-verify</span>�</td>
e412ae947df6de858883564b8676a9650df70d9aMark Andrews<td width="20%" align="center"><a accesskey="h" href="Bv9ARM.html">Home</a></td>
e412ae947df6de858883564b8676a9650df70d9aMark Andrews<td width="40%" align="right" valign="top">�<span class="application">named-checkzone</span>
7949dbdae1db33e6263d754e5940daa1dfba59f9Michael Sawyer<p style="text-align: center;">BIND 9.11.0pre-alpha</p>