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