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