man.named-checkconf.html revision 975ff35d8501bd2ef5f9541c4dac1157efc1609d
a747113422afaa29ce72d2c5ba7f0b7ea9ec2054Evan Hunt<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt - Copyright (C) 2000-2016 Internet Systems Consortium, Inc. ("ISC")
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt - This Source Code Form is subject to the terms of the Mozilla Public
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt - License, v. 2.0. If a copy of the MPL was not distributed with this
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt - file, You can obtain one at http://mozilla.org/MPL/2.0/.
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt<link rel="home" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual">
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt<link rel="up" href="Bv9ARM.ch13.html" title="Manual pages">
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt<link rel="prev" href="man.named.conf.html" title="named.conf">
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt<link rel="next" href="man.named-checkzone.html" title="named-checkzone">
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt<tr><th colspan="3" align="center"><span class="application">named-checkconf</span></th></tr>
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt<a accesskey="p" href="man.named.conf.html">Prev</a>�</td>
4a53e3c2b83c476a93148eaee0272649beb221caMark Andrews<th width="60%" align="center">Manual pages</th>
4a53e3c2b83c476a93148eaee0272649beb221caMark Andrews<td width="20%" align="right">�<a accesskey="n" href="man.named-checkzone.html">Next</a>
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt<a name="man.named-checkconf"></a><div class="titlepage"></div>
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt — named configuration file syntax checking tool
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt [<code class="option">-t <em class="replaceable"><code>directory</code></em></code>]
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt <p><span class="command"><strong>named-checkconf</strong></span>
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt checks the syntax, but not the semantics, of a
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt <span class="command"><strong>named</strong></span> configuration file. The file is parsed
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt and checked for syntax errors, along with all files included by it.
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt If no file is specified, <code class="filename">/etc/named.conf</code> is read
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt Note: files that <span class="command"><strong>named</strong></span> reads in separate
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt parser contexts, such as <code class="filename">rndc.key</code> and
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt <code class="filename">bind.keys</code>, are not automatically read
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt by <span class="command"><strong>named-checkconf</strong></span>. Configuration
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt errors in these files may cause <span class="command"><strong>named</strong></span> to
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt fail to run, even if <span class="command"><strong>named-checkconf</strong></span> was
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt successful. <span class="command"><strong>named-checkconf</strong></span> can be run
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt on these files explicitly, however.
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt <div class="variablelist"><dl class="variablelist">
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt Print the usage summary and exit.
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt When loading a zonefile read the journal if it exists.
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt Print out the <code class="filename">named.conf</code> and included files
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt in canonical form if no errors were detected.
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt See also the <code class="option">-x</code> option.
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt<dt><span class="term">-t <em class="replaceable"><code>directory</code></em></span></dt>
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt Chroot to <code class="filename">directory</code> so that include
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt directives in the configuration file are processed as if
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt run by a similarly chrooted <span class="command"><strong>named</strong></span>.
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt Print the version of the <span class="command"><strong>named-checkconf</strong></span>
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt program and exit.
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt When printing the configuration files in canonical
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt form, obscure shared secrets by replacing them with
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt strings of question marks ('?'). This allows the
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt contents of <code class="filename">named.conf</code> and related
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt files to be shared — for example, when submitting
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt bug reports — without compromising private data.
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt This option cannot be used without <code class="option">-p</code>.
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt Perform a test load of all master zones found in
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt The name of the configuration file to be checked. If not
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt specified, it defaults to <code class="filename">/etc/named.conf</code>.
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt <p><span class="command"><strong>named-checkconf</strong></span>
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt returns an exit status of 1 if
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt errors were detected and 0 otherwise.
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt <span class="refentrytitle">named-checkzone</span>(8)
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt <em class="citetitle">BIND 9 Administrator Reference Manual</em>.
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt<a accesskey="p" href="man.named.conf.html">Prev</a>�</td>
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt<td width="20%" align="center"><a accesskey="u" href="Bv9ARM.ch13.html">Up</a></td>
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt<td width="40%" align="right">�<a accesskey="n" href="man.named-checkzone.html">Next</a>
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt<td width="20%" align="center"><a accesskey="h" href="Bv9ARM.html">Home</a></td>
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt<td width="40%" align="right" valign="top">�<span class="application">named-checkzone</span>
ef421f66f47224a42073deaf087378c5d0c9952eEvan Hunt<p xmlns:db="http://docbook.org/ns/docbook" style="text-align: center;">BIND 9.11.1rc3</p>