1104N/A - Copyright (C) 2000-2017 Internet Systems Consortium, Inc. ("ISC") 70N/A - This Source Code Form is subject to the terms of the Mozilla Public 919N/A - License, v. 2.0. If a copy of the MPL was not distributed with this 919N/A<
meta http-
equiv="Content-Type" content="text/html; charset=ISO-8859-1">
919N/A<
title>named-checkconf</
title>
919N/A<
meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
919N/A<
link rel="home" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual">
919N/A<
body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
919N/A<
table width="100%" summary="Navigation header">
919N/A<
tr><
th colspan="3" align="center"><
span class="application">named-checkconf</
span></
th></
tr>
70N/A<
td width="20%" align="left">
70N/A<
th width="60%" align="center">Manual pages</
th>
425N/A <
div class="refnamediv">
493N/A <
span class="application">named-checkconf</
span>
536N/A — named configuration file syntax checking tool
501N/A <
div class="refsynopsisdiv">
550N/A <
div class="cmdsynopsis"><
p>
347N/A <
code class="command">named-checkconf</
code>
532N/A [<
code class="option">-hjvz</
code>]
463N/A [<
code class="option">-p</
code>
493N/A [<
code class="option">-x</
code>
493N/A [<
code class="option">-t <
em class="replaceable"><
code>directory</
code></
em></
code>]
310N/A <
div class="refsection">
316N/A<
a name="id-1.14.21.7"></
a><
h2>DESCRIPTION</
h2>
290N/A <
p><
span class="command"><
strong>named-checkconf</
strong></
span>
332N/A checks the syntax, but not the semantics, of a
464N/A <
span class="command"><
strong>named</
strong></
span> configuration file. The file is parsed
332N/A and checked for syntax errors, along with all files included by it.
210N/A Note: files that <
span class="command"><
strong>named</
strong></
span> reads in separate
493N/A parser contexts, such as <
code class="filename">
rndc.key</
code> and
128N/A by <
span class="command"><
strong>named-checkconf</
strong></
span>. Configuration
414N/A errors in these files may cause <
span class="command"><
strong>named</
strong></
span> to
484N/A fail to run, even if <
span class="command"><
strong>named-checkconf</
strong></
span> was
326N/A successful. <
span class="command"><
strong>named-checkconf</
strong></
span> can be run
493N/A on these files explicitly, however.
729N/A <
div class="refsection">
425N/A<
a name="id-1.14.21.8"></
a><
h2>OPTIONS</
h2>
70N/A <
div class="variablelist"><
dl class="variablelist">
400N/A<
dt><
span class="term">-h</
span></
dt>
800N/A Print the usage summary and exit.
505N/A<
dt><
span class="term">-j</
span></
dt>
546N/A When loading a zonefile read the journal if it exists.
326N/A<
dt><
span class="term">-p</
span></
dt>
469N/A Print out the <
code class="filename">
named.conf</
code> and included files
290N/A in canonical form if no errors were detected.
542N/A See also the <
code class="option">-x</
code> option.
90N/A<
dt><
span class="term">-t <
em class="replaceable"><
code>directory</
code></
em></
span></
dt>
70N/A Chroot to <
code class="filename">directory</
code> so that include
299N/A directives in the configuration file are processed as if
262N/A run by a similarly chrooted <
span class="command"><
strong>named</
strong></
span>.
332N/A<
dt><
span class="term">-v</
span></
dt>
70N/A Print the version of the <
span class="command"><
strong>named-checkconf</
strong></
span>
319N/A<
dt><
span class="term">-x</
span></
dt>
1117N/A When printing the configuration files in canonical
98N/A form, obscure shared secrets by replacing them with
414N/A strings of question marks ('?'). This allows the
744N/A files to be shared — for example, when submitting
1104N/A bug reports — without compromising private data.
744N/A This option cannot be used without <
code class="option">-p</
code>.
763N/A<
dt><
span class="term">-z</
span></
dt>
493N/A Perform a test load of all master zones found in
493N/A<
dt><
span class="term">filename</
span></
dt>
The name of the configuration file to be checked. If not
specified, it defaults to <
code class="filename">/
etc/
named.conf</
code>.
<
a name="id-1.14.21.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.
<
a name="id-1.14.21.10"></
a><
h2>SEE ALSO</
h2>
<
p><
span class="citerefentry">
<
span class="refentrytitle">named</
span>(8)
<
span class="citerefentry">
<
span class="refentrytitle">named-checkzone</
span>(8)
<
em class="citetitle">BIND 9 Administrator Reference Manual</
em>.
<
table width="100%" summary="Navigation footer">
<
td width="40%" align="left">
<
td width="20%" align="center"><
a accesskey="u" href="Bv9ARM.ch13.html">Up</
a></
td>
<
td width="40%" align="left" valign="top">
<
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>