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