1 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
2 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
3 [<!ENTITY mdash "—">]>
5 - Copyright (C) 2004, 2005, 2007, 2009 Internet Systems Consortium, Inc. ("ISC")
6 - Copyright (C) 2000-2002 Internet Software Consortium.
8 - Permission to use, copy, modify, and/or distribute this software for any
9 - purpose with or without fee is hereby granted, provided that the above
10 - copyright notice and this permission notice appear in all copies.
12 - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
13 - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
14 - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
15 - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
16 - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
17 - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
18 - PERFORMANCE OF THIS SOFTWARE.
21 <!-- $Id: named-checkconf.docbook,v 1.22 2009/12/28 23:21:16 each Exp $ -->
22 <refentry id="man.named-checkconf">
24 <date>June 14, 2000</date>
28 <refentrytitle><application>named-checkconf</application></refentrytitle>
29 <manvolnum>8</manvolnum>
30 <refmiscinfo>BIND9</refmiscinfo>
39 <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
45 <holder>Internet Software Consortium.</holder>
50 <refname><application>named-checkconf</application></refname>
51 <refpurpose>named configuration file syntax checking tool</refpurpose>
56 <command>named-checkconf</command>
57 <arg><option>-h</option></arg>
58 <arg><option>-v</option></arg>
59 <arg><option>-j</option></arg>
60 <arg><option>-t <replaceable class="parameter">directory</replaceable></option></arg>
61 <arg choice="req">filename</arg>
62 <arg><option>-p</option></arg>
63 <arg><option>-z</option></arg>
68 <title>DESCRIPTION</title>
69 <para><command>named-checkconf</command>
70 checks the syntax, but not the semantics, of a
71 <command>named</command> configuration file. The file is parsed
72 and checked for syntax errors, along with all files included by it.
73 If no file is specified, <filename>/etc/named.conf</filename> is read
77 Note: files that <command>named</command> reads in separate
78 parser contexts, such as <filename>rndc.key</filename> and
79 <filename>bind.keys</filename>, are not automatically read
80 by <command>named-checkconf</command>. Configuration
81 errors in these files may cause <command>named</command> to
82 fail to run, even if <command>named-checkconf</command> was
83 successful. <command>named-checkconf</command> can be run
84 on these files explicitly, however.
89 <title>OPTIONS</title>
96 Print the usage summary and exit.
102 <term>-t <replaceable class="parameter">directory</replaceable></term>
105 Chroot to <filename>directory</filename> so that include
106 directives in the configuration file are processed as if
107 run by a similarly chrooted named.
116 Print the version of the <command>named-checkconf</command>
126 Print out the <filename>named.conf</filename> and included files
127 in canonical form if no errors were detected.
136 Perform a test load of all master zones found in
137 <filename>named.conf</filename>.
146 When loading a zonefile read the journal if it exists.
152 <term>filename</term>
155 The name of the configuration file to be checked. If not
156 specified, it defaults to <filename>/etc/named.conf</filename>.
166 <title>RETURN VALUES</title>
167 <para><command>named-checkconf</command>
168 returns an exit status of 1 if
169 errors were detected and 0 otherwise.
174 <title>SEE ALSO</title>
176 <refentrytitle>named</refentrytitle><manvolnum>8</manvolnum>
179 <refentrytitle>named-checkzone</refentrytitle><manvolnum>8</manvolnum>
181 <citetitle>BIND 9 Administrator Reference Manual</citetitle>.
186 <title>AUTHOR</title>
187 <para><corpauthor>Internet Systems Consortium</corpauthor>