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