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