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