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