man.named-checkconf.html revision 990d0e893f5b70e735cdf990af66e9ec6e91fa78
990d0e893f5b70e735cdf990af66e9ec6e91fa78Tinderbox User - Copyright (C) 2004-2014 Internet Systems Consortium, Inc. ("ISC")
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews - Copyright (C) 2000-2003 Internet Software Consortium.
4a14ce5ba00ab7bc55c99ffdcf59c7a4ab902721Automatic Updater - 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.
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">
c3dc968140ab7f04795acc7835e4e89ccb0c0a27Tinderbox User<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>
c3dc968140ab7f04795acc7835e4e89ccb0c0a27Tinderbox User<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>
990d0e893f5b70e735cdf990af66e9ec6e91fa78Tinderbox User<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>
d856585f5fe37cc2ea82115c10339578d2b517b1Automatic Updater checks the syntax, but not the semantics, of a
d856585f5fe37cc2ea82115c10339578d2b517b1Automatic Updater <span><strong class="command">named</strong></span> configuration file. The file is parsed
d856585f5fe37cc2ea82115c10339578d2b517b1Automatic Updater and checked for syntax errors, along with all files included by it.
d856585f5fe37cc2ea82115c10339578d2b517b1Automatic Updater If no file is specified, <code class="filename">/etc/named.conf</code> is read
d856585f5fe37cc2ea82115c10339578d2b517b1Automatic Updater Note: files that <span><strong class="command">named</strong></span> reads in separate
d856585f5fe37cc2ea82115c10339578d2b517b1Automatic Updater parser contexts, such as <code class="filename">rndc.key</code> and
d856585f5fe37cc2ea82115c10339578d2b517b1Automatic Updater <code class="filename">bind.keys</code>, are not automatically read
d856585f5fe37cc2ea82115c10339578d2b517b1Automatic Updater by <span><strong class="command">named-checkconf</strong></span>. Configuration
d856585f5fe37cc2ea82115c10339578d2b517b1Automatic Updater errors in these files may cause <span><strong class="command">named</strong></span> to
d856585f5fe37cc2ea82115c10339578d2b517b1Automatic Updater fail to run, even if <span><strong class="command">named-checkconf</strong></span> was
d856585f5fe37cc2ea82115c10339578d2b517b1Automatic Updater successful. <span><strong class="command">named-checkconf</strong></span> can be run
d856585f5fe37cc2ea82115c10339578d2b517b1Automatic Updater on these files explicitly, however.
f7b41fd9291b8f4dba27e2b57e1d93f0913a4f1dMark Andrews Print the usage summary and exit.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<dt><span class="term">-t <em class="replaceable"><code>directory</code></em></span></dt>
d85c83c4144116fbc2734a6a623a888fea1a307fAutomatic Updater Chroot to <code class="filename">directory</code> so that include
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark 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.
d85c83c4144116fbc2734a6a623a888fea1a307fAutomatic Updater Print out the <code class="filename">named.conf</code> and included files
d85c83c4144116fbc2734a6a623a888fea1a307fAutomatic Updater in canonical form if no errors were detected.
990d0e893f5b70e735cdf990af66e9ec6e91fa78Tinderbox User When printing the configuration files in canonical
990d0e893f5b70e735cdf990af66e9ec6e91fa78Tinderbox User form, obscure shared secrets by replacing them with
990d0e893f5b70e735cdf990af66e9ec6e91fa78Tinderbox User strings of question marks ('?'). This allows the
990d0e893f5b70e735cdf990af66e9ec6e91fa78Tinderbox User contents of <code class="filename">named.conf</code> and related
990d0e893f5b70e735cdf990af66e9ec6e91fa78Tinderbox User files to be shared — for example, when submitting
990d0e893f5b70e735cdf990af66e9ec6e91fa78Tinderbox User bug reports — without compromising private data.
990d0e893f5b70e735cdf990af66e9ec6e91fa78Tinderbox User This option cannot be used without <code class="option">-p</code>.
d71e2e0c61df16ff37c9934c371a4a60c08974f7Mark 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>.
990d0e893f5b70e735cdf990af66e9ec6e91fa78Tinderbox User<a name="id2641961"></a><h2>RETURN VALUES</h2>
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>,
1224c3b69b3d18f7127aa042644936af25a2d679Mark 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">
c3dc968140ab7f04795acc7835e4e89ccb0c0a27Tinderbox User<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>
c3dc968140ab7f04795acc7835e4e89ccb0c0a27Tinderbox User<span class="application">dnssec-verify</span>�</td>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<td width="20%" align="center"><a accesskey="h" href="Bv9ARM.html">Home</a></td>
4abdfc917e6635a7c81d1f931a0c79227e72d025Mark Andrews<td width="40%" align="right" valign="top">�<span class="application">named-checkzone</span>