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