man.named-checkconf.html revision 11e9368a226272085c337e9e74b79808c16fbdba
4610465ed9408cbe434dbfb8be8ea53f48969c91Bob Halley - Copyright (C) 2004-2015 Internet Systems Consortium, Inc. ("ISC")
5347c0fcb04eaea19d9f39795646239f487c6207Tinderbox 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
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - 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
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User - PERFORMANCE OF THIS SOFTWARE.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<meta name="generator" content="DocBook XSL Stylesheets V1.71.1">
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<link rel="start" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual">
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<link rel="up" href="Bv9ARM.ch10.html" title="Manual pages">
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<link rel="prev" href="man.dnssec-verify.html" title="dnssec-verify">
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<link rel="next" href="man.named-checkzone.html" title="named-checkzone">
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User<tr><th colspan="3" align="center"><span class="application">named-checkconf</span></th></tr>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<a accesskey="p" href="man.dnssec-verify.html">Prev</a>�</td>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<td width="20%" align="right">�<a accesskey="n" href="man.named-checkzone.html">Next</a>
b2f07642fd712c8fda81a116bcdde229ab291f33Tinderbox User<a name="man.named-checkconf"></a><div class="titlepage"></div>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<p><span class="application">named-checkconf</span> — named configuration file syntax checking tool</p>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox 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>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<p><span><strong class="command">named-checkconf</strong></span>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User checks the syntax, but not the semantics, of a
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <span><strong class="command">named</strong></span> configuration file. The file is parsed
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User and checked for syntax errors, along with all files included by it.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User If no file is specified, <code class="filename">/etc/named.conf</code> is read
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User Note: files that <span><strong class="command">named</strong></span> reads in separate
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User parser contexts, such as <code class="filename">rndc.key</code> and
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User <code class="filename">bind.keys</code>, are not automatically read
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User by <span><strong class="command">named-checkconf</strong></span>. Configuration
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein errors in these files may cause <span><strong class="command">named</strong></span> to
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User fail to run, even if <span><strong class="command">named-checkconf</strong></span> was
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User successful. <span><strong class="command">named-checkconf</strong></span> can be run
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User on these files explicitly, however.
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User Print the usage summary and exit.
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User<dt><span class="term">-t <em class="replaceable"><code>directory</code></em></span></dt>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User Chroot to <code class="filename">directory</code> so that include
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein directives in the configuration file are processed as if
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User run by a similarly chrooted named.
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User Print the version of the <span><strong class="command">named-checkconf</strong></span>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User program and exit.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User Print out the <code class="filename">named.conf</code> and included files
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User in canonical form if no errors were detected.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User When printing the configuration files in canonical
d3ddafd7469d1f3430ccd1b0fe0d13ccbbaf5debTinderbox User form, obscure shared secrets by replacing them with
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User strings of question marks ('?'). This allows the
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User contents of <code class="filename">named.conf</code> and related
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User files to be shared — for example, when submitting
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User bug reports — without compromising private data.
6d45011a65dfc43f476ca15c3fd9ee5227eb968fTinderbox User This option cannot be used without <code class="option">-p</code>.
6d45011a65dfc43f476ca15c3fd9ee5227eb968fTinderbox User Perform a test load of all master zones found in
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User When loading a zonefile read the journal if it exists.
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User The name of the configuration file to be checked. If not
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User specified, it defaults to <code class="filename">/etc/named.conf</code>.
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User<a name="id2645865"></a><h2>RETURN VALUES</h2>
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User<p><span><strong class="command">named-checkconf</strong></span>
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User returns an exit status of 1 if
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User errors were detected and 0 otherwise.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<p><span class="citerefentry"><span class="refentrytitle">named</span>(8)</span>,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <span class="citerefentry"><span class="refentrytitle">named-checkzone</span>(8)</span>,
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <em class="citetitle">BIND 9 Administrator Reference Manual</em>.
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User<p><span class="corpauthor">Internet Systems Consortium</span>
395c95214142142854509945adf3293c0270e1c5Tinderbox User<table width="100%" summary="Navigation footer">
395c95214142142854509945adf3293c0270e1c5Tinderbox User<a accesskey="p" href="man.dnssec-verify.html">Prev</a>�</td>
395c95214142142854509945adf3293c0270e1c5Tinderbox User<td width="20%" align="center"><a accesskey="u" href="Bv9ARM.ch10.html">Up</a></td>
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User<td width="40%" align="right">�<a accesskey="n" href="man.named-checkzone.html">Next</a>
395c95214142142854509945adf3293c0270e1c5Tinderbox User<span class="application">dnssec-verify</span>�</td>
395c95214142142854509945adf3293c0270e1c5Tinderbox User<td width="20%" align="center"><a accesskey="h" href="Bv9ARM.html">Home</a></td>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<td width="40%" align="right" valign="top">�<span class="application">named-checkzone</span>
395c95214142142854509945adf3293c0270e1c5Tinderbox User<p style="text-align: center;">BIND 9.11.0pre-alpha</p>