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