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