d6fa26d0adaec6c910115be34fe7a5a5f402c14fMark Andrews<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
5347c0fcb04eaea19d9f39795646239f487c6207Tinderbox User - Copyright (C) 2000-2002, 2004, 2005, 2007, 2009, 2014-2016 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
5347c0fcb04eaea19d9f39795646239f487c6207Tinderbox User - file, You can obtain one at http://mozilla.org/MPL/2.0/.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry">
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<a name="man.named-checkconf"></a><div class="titlepage"></div>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <span class="application">named-checkconf</span>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User — named configuration file syntax checking tool
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User [<code class="option">-t <em class="replaceable"><code>directory</code></em></code>]
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <p><span class="command"><strong>named-checkconf</strong></span>
d856585f5fe37cc2ea82115c10339578d2b517b1Automatic Updater checks the syntax, but not the semantics, of a
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User <span class="command"><strong>named</strong></span> configuration file. The file is parsed
d856585f5fe37cc2ea82115c10339578d2b517b1Automatic Updater and checked for syntax errors, along with all files included by it.
d856585f5fe37cc2ea82115c10339578d2b517b1Automatic Updater If no file is specified, <code class="filename">/etc/named.conf</code> is read
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User Note: files that <span class="command"><strong>named</strong></span> reads in separate
d856585f5fe37cc2ea82115c10339578d2b517b1Automatic Updater parser contexts, such as <code class="filename">rndc.key</code> and
d856585f5fe37cc2ea82115c10339578d2b517b1Automatic Updater <code class="filename">bind.keys</code>, are not automatically read
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User by <span class="command"><strong>named-checkconf</strong></span>. Configuration
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User errors in these files may cause <span class="command"><strong>named</strong></span> to
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User fail to run, even if <span class="command"><strong>named-checkconf</strong></span> was
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User successful. <span class="command"><strong>named-checkconf</strong></span> can be run
d856585f5fe37cc2ea82115c10339578d2b517b1Automatic Updater on these files explicitly, however.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <div class="variablelist"><dl class="variablelist">
f7b41fd9291b8f4dba27e2b57e1d93f0913a4f1dMark Andrews Print the usage summary and exit.
ea640e04eae220b5e569f188563eb1f204c7c77eTinderbox User When loading a zonefile read the journal if it exists.
ea640e04eae220b5e569f188563eb1f204c7c77eTinderbox User Print out the <code class="filename">named.conf</code> and included files
ea640e04eae220b5e569f188563eb1f204c7c77eTinderbox User in canonical form if no errors were detected.
ea640e04eae220b5e569f188563eb1f204c7c77eTinderbox User See also the <code class="option">-x</code> option.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term">-t <em class="replaceable"><code>directory</code></em></span></dt>
d85c83c4144116fbc2734a6a623a888fea1a307fAutomatic Updater Chroot to <code class="filename">directory</code> so that include
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein directives in the configuration file are processed as if
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User run by a similarly chrooted <span class="command"><strong>named</strong></span>.
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User Print the version of the <span class="command"><strong>named-checkconf</strong></span>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein program and exit.
990d0e893f5b70e735cdf990af66e9ec6e91fa78Tinderbox User When printing the configuration files in canonical
990d0e893f5b70e735cdf990af66e9ec6e91fa78Tinderbox User form, obscure shared secrets by replacing them with
990d0e893f5b70e735cdf990af66e9ec6e91fa78Tinderbox User strings of question marks ('?'). This allows the
990d0e893f5b70e735cdf990af66e9ec6e91fa78Tinderbox User contents of <code class="filename">named.conf</code> and related
990d0e893f5b70e735cdf990af66e9ec6e91fa78Tinderbox User files to be shared — for example, when submitting
990d0e893f5b70e735cdf990af66e9ec6e91fa78Tinderbox User bug reports — without compromising private data.
990d0e893f5b70e735cdf990af66e9ec6e91fa78Tinderbox User This option cannot be used without <code class="option">-p</code>.
d71e2e0c61df16ff37c9934c371a4a60c08974f7Mark Andrews Perform a test load of all master zones found in
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein The name of the configuration file to be checked. If not
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein specified, it defaults to <code class="filename">/etc/named.conf</code>.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <p><span class="command"><strong>named-checkconf</strong></span>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein returns an exit status of 1 if
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein errors were detected and 0 otherwise.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <span class="refentrytitle">named-checkzone</span>(8)
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <em class="citetitle">BIND 9 Administrator Reference Manual</em>.