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