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