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