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