3446N/A - Copyright (C) 2000-2017 Internet Systems Consortium, Inc. ("ISC") 3446N/A - This Source Code Form is subject to the terms of the Mozilla Public 3446N/A - License, v. 2.0. If a copy of the MPL was not distributed with this 3446N/A<
meta http-
equiv="Content-Type" content="text/html; charset=ISO-8859-1">
3446N/A<
title>named-checkconf</
title>
3446N/A<
meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
3446N/A<
body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
3446N/A<
table width="100%" summary="Navigation header">
3446N/A<
tr><
th colspan="3" align="center"><
span class="application">named-checkconf</
span></
th></
tr>
3446N/A<
td width="20%" align="left">
3446N/A<
th width="60%" align="center">Manual pages</
th>
3446N/A <
span class="application">named-checkconf</
span>
3446N/A — named configuration file syntax checking tool
3446N/A <
div class="refsynopsisdiv">
3446N/A <
div class="cmdsynopsis"><
p>
3446N/A <
code class="command">named-checkconf</
code>
3446N/A [<
code class="option">-hjvz</
code>]
3446N/A [<
code class="option">-p</
code>
3446N/A [<
code class="option">-x</
code>
3446N/A [<
code class="option">-t <
em class="replaceable"><
code>directory</
code></
em></
code>]
3446N/A<
a name="id-1.14.21.7"></
a><
h2>DESCRIPTION</
h2>
3446N/A <
p><
span class="command"><
strong>named-checkconf</
strong></
span>
3446N/A checks the syntax, but not the semantics, of a
3446N/A <
span class="command"><
strong>named</
strong></
span> configuration file. The file is parsed
3446N/A and checked for syntax errors, along with all files included by it.
3446N/A Note: files that <
span class="command"><
strong>named</
strong></
span> reads in separate
3446N/A parser contexts, such as <
code class="filename">
rndc.key</
code> and
3446N/A by <
span class="command"><
strong>named-checkconf</
strong></
span>. Configuration
3446N/A errors in these files may cause <
span class="command"><
strong>named</
strong></
span> to
3446N/A fail to run, even if <
span class="command"><
strong>named-checkconf</
strong></
span> was
3446N/A successful. <
span class="command"><
strong>named-checkconf</
strong></
span> can be run
3446N/A on these files explicitly, however.
3446N/A<
a name="id-1.14.21.8"></
a><
h2>OPTIONS</
h2>
3446N/A <
div class="variablelist"><
dl class="variablelist">
3446N/A<
dt><
span class="term">-h</
span></
dt>
3446N/A Print the usage summary and exit.
3446N/A<
dt><
span class="term">-j</
span></
dt>
3446N/A When loading a zonefile read the journal if it exists.
3446N/A<
dt><
span class="term">-p</
span></
dt>
3446N/A in canonical form if no errors were detected.
3446N/A See also the <
code class="option">-x</
code> option.
3446N/A<
dt><
span class="term">-t <
em class="replaceable"><
code>directory</
code></
em></
span></
dt>
3446N/A Chroot to <
code class="filename">directory</
code> so that include
3446N/A directives in the configuration file are processed as if
3446N/A run by a similarly chrooted <
span class="command"><
strong>named</
strong></
span>.
3446N/A<
dt><
span class="term">-v</
span></
dt>
3446N/A Print the version of the <
span class="command"><
strong>named-checkconf</
strong></
span>
3446N/A<
dt><
span class="term">-x</
span></
dt>
3446N/A When printing the configuration files in canonical
3446N/A form, obscure shared secrets by replacing them with
3446N/A strings of question marks ('?'). This allows the
3446N/A files to be shared — for example, when submitting
3446N/A bug reports — without compromising private data.
3446N/A This option cannot be used without <
code class="option">-p</
code>.
3446N/A<
dt><
span class="term">-z</
span></
dt>
3446N/A Perform a test load of all master zones found in
3446N/A<
dt><
span class="term">filename</
span></
dt>
3446N/A The name of the configuration file to be checked. If not
3446N/A<
a name="id-1.14.21.9"></
a><
h2>RETURN VALUES</
h2>
3446N/A <
p><
span class="command"><
strong>named-checkconf</
strong></
span>
3446N/A returns an exit status of 1 if
3446N/A errors were detected and 0 otherwise.
3446N/A<
a name="id-1.14.21.10"></
a><
h2>SEE ALSO</
h2>
3446N/A <
p><
span class="citerefentry">
3446N/A <
span class="refentrytitle">named</
span>(8)
3446N/A <
span class="citerefentry">
3446N/A <
span class="refentrytitle">named-checkzone</
span>(8)
3446N/A <
em class="citetitle">BIND 9 Administrator Reference Manual</
em>.
3446N/A<
table width="100%" summary="Navigation footer">
3446N/A<
td width="40%" align="left">
3446N/A<
td width="40%" align="left" valign="top">
3446N/A<
td width="40%" align="right" valign="top">�<
span class="application">named-checkzone</
span>