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