named-checkconf.html revision d856585f5fe37cc2ea82115c10339578d2b517b1
7e5b2100ea65658a7ec3795919b4ecd29a6f118aMark Andrews - Copyright (C) 2004, 2005, 2007, 2009 Internet Systems Consortium, Inc. ("ISC")
7e5b2100ea65658a7ec3795919b4ecd29a6f118aMark Andrews - Copyright (C) 2000-2002 Internet Software Consortium.
eae67738cba5ca069e9d1d4e7b836a2f7b00a374Mark Andrews - Permission to use, copy, modify, and/or distribute this software for any
821d2613356f81e5bb5c107288d6d5cf35c2a1e8Mark Andrews - purpose with or without fee is hereby granted, provided that the above
46e873c835bf7d9ec3e1097e0aceb8db5b1ae93aMark Andrews - copyright notice and this permission notice appear in all copies.
a9789e288ee11ae4315e27235c33bae5405bd7c4Mark Andrews - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
01bf5871f8861eb805dd8ca79bdb9b0b9e4e6a5eMark Andrews - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
c718d15a9a95054ee3c71540c02335426071fc6dMark Andrews - PERFORMANCE OF THIS SOFTWARE.
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews<!-- $Id: named-checkconf.html,v 1.33 2009/12/29 01:14:03 tbox Exp $ -->
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
c718d15a9a95054ee3c71540c02335426071fc6dMark Andrews<meta name="generator" content="DocBook XSL Stylesheets V1.71.1">
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en">
821d2613356f81e5bb5c107288d6d5cf35c2a1e8Mark Andrews<a name="man.named-checkconf"></a><div class="titlepage"></div>
821d2613356f81e5bb5c107288d6d5cf35c2a1e8Mark Andrews<p><span class="application">named-checkconf</span> — named configuration file syntax checking tool</p>
a3b428812703d22a605a9f882e71ed65f0ffdc65Mark Andrews<div class="cmdsynopsis"><p><code class="command">named-checkconf</code> [<code class="option">-h</code>] [<code class="option">-v</code>] [<code class="option">-j</code>] [<code class="option">-t <em class="replaceable"><code>directory</code></em></code>] {filename} [<code class="option">-p</code>] [<code class="option">-z</code>]</p></div>
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews<p><span><strong class="command">named-checkconf</strong></span>
c718d15a9a95054ee3c71540c02335426071fc6dMark Andrews checks the syntax, but not the semantics, of a
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews <span><strong class="command">named</strong></span> configuration file. The file is parsed
c069a20053d41ae299eb9457e50ea44ae9f73ed2Mark Andrews and checked for syntax errors, along with all files included by it.
ed178efa9ab8f813538fce4ff603b81ded9f1799Mark Andrews If no file is specified, <code class="filename">/etc/named.conf</code> is read
ede29aeb412c5448ab9a2028763ae08e7887ca74Mark Andrews Note: files that <span><strong class="command">named</strong></span> reads in separate
1eb1e1e838d2ea00b166c918bf50764a95826be8Mark Andrews parser contexts, such as <code class="filename">rndc.key</code> and
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews <code class="filename">bind.keys</code>, are not automatically read
821d2613356f81e5bb5c107288d6d5cf35c2a1e8Mark Andrews by <span><strong class="command">named-checkconf</strong></span>. Configuration
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson errors in these files may cause <span><strong class="command">named</strong></span> to
821d2613356f81e5bb5c107288d6d5cf35c2a1e8Mark Andrews fail to run, even if <span><strong class="command">named-checkconf</strong></span> was
821d2613356f81e5bb5c107288d6d5cf35c2a1e8Mark Andrews successful. <span><strong class="command">named-checkconf</strong></span> can be run
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson on these files explicitly, however.
7e5b2100ea65658a7ec3795919b4ecd29a6f118aMark Andrews Print the usage summary and exit.
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews<dt><span class="term">-t <em class="replaceable"><code>directory</code></em></span></dt>
62ee2c9f460d2e2e45dcf1abc8b4b4a4a43f5618Mark Andrews Chroot to <code class="filename">directory</code> so that include
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews directives in the configuration file are processed as if
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews run by a similarly chrooted named.
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson Print the version of the <span><strong class="command">named-checkconf</strong></span>
821d2613356f81e5bb5c107288d6d5cf35c2a1e8Mark Andrews program and exit.
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson Print out the <code class="filename">named.conf</code> and included files
821d2613356f81e5bb5c107288d6d5cf35c2a1e8Mark Andrews in canonical form if no errors were detected.
46e873c835bf7d9ec3e1097e0aceb8db5b1ae93aMark Andrews Perform a test load of all master zones found in
413988c8166976498250c0ebb2e3a645d0366bd3Mark Andrews When loading a zonefile read the journal if it exists.
413988c8166976498250c0ebb2e3a645d0366bd3Mark Andrews The name of the configuration file to be checked. If not
a9789e288ee11ae4315e27235c33bae5405bd7c4Mark Andrews specified, it defaults to <code class="filename">/etc/named.conf</code>.
a9789e288ee11ae4315e27235c33bae5405bd7c4Mark Andrews<p><span><strong class="command">named-checkconf</strong></span>
a9789e288ee11ae4315e27235c33bae5405bd7c4Mark Andrews returns an exit status of 1 if
a9789e288ee11ae4315e27235c33bae5405bd7c4Mark Andrews errors were detected and 0 otherwise.
6b5c57e52ac8c3e0af1547be3140ebbfb41a85b3Mark Andrews<p><span class="citerefentry"><span class="refentrytitle">named</span>(8)</span>,
6b5c57e52ac8c3e0af1547be3140ebbfb41a85b3Mark Andrews <span class="citerefentry"><span class="refentrytitle">named-checkzone</span>(8)</span>,
a9789e288ee11ae4315e27235c33bae5405bd7c4Mark Andrews <em class="citetitle">BIND 9 Administrator Reference Manual</em>.
a9789e288ee11ae4315e27235c33bae5405bd7c4Mark Andrews<p><span class="corpauthor">Internet Systems Consortium</span>