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