named-checkconf.html revision 010a51c427bfb6ab658fc0056955a1a5b69810be
0N/A<!--
0N/A - Copyright (C) 2004, 2005, 2007, 2009, 2014, 2015 Internet Systems Consortium, Inc. ("ISC")
0N/A - Copyright (C) 2000-2002 Internet Software Consortium.
426N/A -
0N/A - Permission to use, copy, modify, and/or distribute this software for any
0N/A - purpose with or without fee is hereby granted, provided that the above
0N/A - copyright notice and this permission notice appear in all copies.
0N/A -
0N/A - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
0N/A - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
0N/A - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
0N/A - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
0N/A - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
0N/A - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
0N/A - PERFORMANCE OF THIS SOFTWARE.
0N/A-->
0N/A<html>
0N/A<head>
0N/A<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
0N/A<title>named-checkconf</title>
0N/A<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
0N/A</head>
0N/A<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="named-checkconf">
0N/A<a name="man.named-checkconf"></a><div class="titlepage"></div>
0N/A
0N/A
0N/A
426N/A
426N/A
426N/A
0N/A
0N/A <div class="refnamediv">
426N/A<h2>Name</h2>
426N/A<p>
426N/A <span class="application">named-checkconf</span>
426N/A &#8212; named configuration file syntax checking tool
426N/A </p>
426N/A</div>
426N/A
426N/A <div class="refsynopsisdiv" title="Synopsis">
426N/A<h2>Synopsis</h2>
426N/A <div class="cmdsynopsis"><p>
0N/A <code class="command">named-checkconf</code>
0N/A [<code class="option">-h</code>]
0N/A [<code class="option">-v</code>]
0N/A [<code class="option">-j</code>]
0N/A [<code class="option">-t <em class="replaceable"><code>directory</code></em></code>]
0N/A {filename}
0N/A [<code class="option">-p</code>]
0N/A [<code class="option">-x</code>]
0N/A [<code class="option">-z</code>]
0N/A </p></div>
0N/A </div>
0N/A
426N/A <div class="refsection" title="DESCRIPTION">
0N/A<a name="idp60838992"></a><h2>DESCRIPTION</h2>
0N/A
0N/A <p><span class="command"><strong>named-checkconf</strong></span>
0N/A checks the syntax, but not the semantics, of a
0N/A <span class="command"><strong>named</strong></span> configuration file. The file is parsed
0N/A and checked for syntax errors, along with all files included by it.
0N/A If no file is specified, <code class="filename">/etc/named.conf</code> is read
0N/A by default.
0N/A </p>
0N/A <p>
0N/A Note: files that <span class="command"><strong>named</strong></span> reads in separate
0N/A parser contexts, such as <code class="filename">rndc.key</code> and
0N/A <code class="filename">bind.keys</code>, are not automatically read
0N/A by <span class="command"><strong>named-checkconf</strong></span>. Configuration
426N/A errors in these files may cause <span class="command"><strong>named</strong></span> to
0N/A fail to run, even if <span class="command"><strong>named-checkconf</strong></span> was
0N/A successful. <span class="command"><strong>named-checkconf</strong></span> can be run
0N/A on these files explicitly, however.
0N/A </p>
0N/A </div>
0N/A
0N/A <div class="refsection" title="OPTIONS">
0N/A<a name="idp60844496"></a><h2>OPTIONS</h2>
0N/A
0N/A
0N/A <div class="variablelist"><dl>
0N/A<dt><span class="term">-h</span></dt>
0N/A<dd>
0N/A <p>
0N/A Print the usage summary and exit.
426N/A </p>
0N/A </dd>
0N/A<dt><span class="term">-t <em class="replaceable"><code>directory</code></em></span></dt>
0N/A<dd>
0N/A <p>
0N/A Chroot to <code class="filename">directory</code> so that include
0N/A directives in the configuration file are processed as if
0N/A run by a similarly chrooted <span class="command"><strong>named</strong></span>.
0N/A </p>
0N/A </dd>
0N/A<dt><span class="term">-v</span></dt>
0N/A<dd>
0N/A <p>
0N/A Print the version of the <span class="command"><strong>named-checkconf</strong></span>
0N/A program and exit.
426N/A </p>
0N/A </dd>
0N/A<dt><span class="term">-p</span></dt>
0N/A<dd>
426N/A <p>
426N/A Print out the <code class="filename">named.conf</code> and included files
426N/A in canonical form if no errors were detected.
426N/A </p>
426N/A </dd>
426N/A<dt><span class="term">-x</span></dt>
426N/A<dd>
426N/A <p>
426N/A When printing the configuration files in canonical
0N/A form, obscure shared secrets by replacing them with
426N/A strings of question marks ('?'). This allows the
0N/A contents of <code class="filename">named.conf</code> and related
0N/A files to be shared &#8212; for example, when submitting
0N/A bug reports &#8212; without compromising private data.
0N/A This option cannot be used without <code class="option">-p</code>.
0N/A </p>
0N/A </dd>
0N/A<dt><span class="term">-z</span></dt>
0N/A<dd>
0N/A <p>
0N/A Perform a test load of all master zones found in
0N/A <code class="filename">named.conf</code>.
0N/A </p>
426N/A </dd>
0N/A<dt><span class="term">-j</span></dt>
0N/A<dd>
0N/A <p>
0N/A When loading a zonefile read the journal if it exists.
0N/A </p>
0N/A </dd>
0N/A<dt><span class="term">filename</span></dt>
0N/A<dd>
0N/A <p>
0N/A The name of the configuration file to be checked. If not
426N/A specified, it defaults to <code class="filename">/etc/named.conf</code>.
426N/A </p>
0N/A </dd>
0N/A</dl></div>
0N/A
0N/A </div>
0N/A
0N/A <div class="refsection" title="RETURN VALUES">
0N/A<a name="idp60866128"></a><h2>RETURN VALUES</h2>
0N/A
0N/A <p><span class="command"><strong>named-checkconf</strong></span>
0N/A returns an exit status of 1 if
0N/A errors were detected and 0 otherwise.
0N/A </p>
0N/A </div>
0N/A
0N/A <div class="refsection" title="SEE ALSO">
0N/A<a name="idp60867920"></a><h2>SEE ALSO</h2>
426N/A
0N/A <p><span class="citerefentry">
0N/A <span class="refentrytitle">named</span>(8)
0N/A </span>,
0N/A <span class="citerefentry">
0N/A <span class="refentrytitle">named-checkzone</span>(8)
0N/A </span>,
0N/A <em class="citetitle">BIND 9 Administrator Reference Manual</em>.
0N/A </p>
0N/A </div>
0N/A</div></body>
0N/A</html>
426N/A