named-checkconf.html revision ea640e04eae220b5e569f188563eb1f204c7c77e
b886b04d8d2b085cbf3e1bf4442dee87f43ba5e4Tinderbox User<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
c7ef13f6c9ef4436bc804b150e0a93307b11fa27Tinderbox User - Copyright (C) 2000-2002, 2004, 2005, 2007, 2009, 2014-2016 Internet Systems Consortium, Inc. ("ISC")
1167fc7904c5f0a472f8df207ac46dd52c7f1ec8Automatic Updater - This Source Code Form is subject to the terms of the Mozilla Public
0c39b3ed9409ecb277d5e32fa763a4e4d6598df8Automatic Updater - License, v. 2.0. If a copy of the MPL was not distributed with this
46da3117812814a29432a8d9a9ccf8acdbfdadceAutomatic Updater - file, You can obtain one at http://mozilla.org/MPL/2.0/.
3349f0044fda807e1fd6681c833d3593a22dad86Tinderbox User<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
b253dcf9668f95e141bce9556dc88e30d3305a1dTinderbox User<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox User<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry">
1ac49378a458420bc685293d12e567d7222d17b6Tinderbox User<a name="man.named-checkconf"></a><div class="titlepage"></div>
6c910bd5e4a85a56e3a61fdf7b237a45bb2553eeTinderbox User<p><span class="application">named-checkconf</span> — named configuration file syntax checking tool</p>
a01aa536188bb3535dfc1107a623e6355a8e6b7cMark Andrews<div class="cmdsynopsis"><p><code class="command">named-checkconf</code> [<code class="option">-hjvz</code>] [<code class="option">-p</code>
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews ]] [<code class="option">-t <em class="replaceable"><code>directory</code></em></code>] {filename}</p></div>
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson<p><span class="command"><strong>named-checkconf</strong></span>
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updater checks the syntax, but not the semantics, of a
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updater <span class="command"><strong>named</strong></span> configuration file. The file is parsed
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson and checked for syntax errors, along with all files included by it.
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updater If no file is specified, <code class="filename">/etc/named.conf</code> is read
e130ab53e992670e2a2ecf043976ac09f21358d1Automatic Updater Note: files that <span class="command"><strong>named</strong></span> reads in separate
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updater parser contexts, such as <code class="filename">rndc.key</code> and
aa9c561961e9d877946ebaa8795fa2be054ab7bfEvan Hunt <code class="filename">bind.keys</code>, are not automatically read
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updater by <span class="command"><strong>named-checkconf</strong></span>. Configuration
e6fc17ec5ad5ba1c4bf5730b2b97c82d1f2b8f3cMark Andrews errors in these files may cause <span class="command"><strong>named</strong></span> to
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updater fail to run, even if <span class="command"><strong>named-checkconf</strong></span> was
aa9c561961e9d877946ebaa8795fa2be054ab7bfEvan Hunt successful. <span class="command"><strong>named-checkconf</strong></span> can be run
e130ab53e992670e2a2ecf043976ac09f21358d1Automatic Updater on these files explicitly, however.
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updater<div class="variablelist"><dl class="variablelist">
cdfc81e048bd34c1d628380247bda6b80a89e20eAutomatic Updater Print the usage summary and exit.
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updater When loading a zonefile read the journal if it exists.
b886b04d8d2b085cbf3e1bf4442dee87f43ba5e4Tinderbox User Print out the <code class="filename">named.conf</code> and included files
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox User in canonical form if no errors were detected.
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews See also the <code class="option">-x</code> option.
8e9f3b69914ee02a80b87c97b1f8093edb3e9ae0Automatic Updater<dt><span class="term">-t <em class="replaceable"><code>directory</code></em></span></dt>
a80993946f29ff39df38818ee9b2e58a4e46cb7eTinderbox User Chroot to <code class="filename">directory</code> so that include
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews directives in the configuration file are processed as if
c59750de3ea3c7d5890000fb4606e8f5835a52aaTinderbox User run by a similarly chrooted <span class="command"><strong>named</strong></span>.
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews Print the version of the <span class="command"><strong>named-checkconf</strong></span>
114f7780384371121918624ae2c80ecfce545683Tinderbox User program and exit.
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson When printing the configuration files in canonical
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updater form, obscure shared secrets by replacing them with
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updater strings of question marks ('?'). This allows the
efb0e886f18894a1d2489f1ad74ad14b579e11c7Mark Andrews contents of <code class="filename">named.conf</code> and related
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updater files to be shared — for example, when submitting
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson bug reports — without compromising private data.
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updater This option cannot be used without <code class="option">-p</code>.
b886b04d8d2b085cbf3e1bf4442dee87f43ba5e4Tinderbox User Perform a test load of all master zones found in
78f3ed4bc2fcd3d270bfd599804f3b27a1db4d91Mark Andrews The name of the configuration file to be checked. If not
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont specified, it defaults to <code class="filename">/etc/named.conf</code>.
3349f0044fda807e1fd6681c833d3593a22dad86Tinderbox User<p><span class="command"><strong>named-checkconf</strong></span>
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews returns an exit status of 1 if
78f3ed4bc2fcd3d270bfd599804f3b27a1db4d91Mark Andrews errors were detected and 0 otherwise.
7500521cecdff3c00e594ec41d3a17292332ffbcTinderbox User<p><span class="citerefentry"><span class="refentrytitle">named</span>(8)</span>,
a308b69ac66fadf66863484f301314d6e6a3f1d2Automatic Updater <span class="citerefentry"><span class="refentrytitle">named-checkzone</span>(8)</span>,
78f3ed4bc2fcd3d270bfd599804f3b27a1db4d91Mark Andrews <em class="citetitle">BIND 9 Administrator Reference Manual</em>.