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