2 - Copyright (C) 2004-2015 Internet Systems Consortium, Inc. ("ISC")
3 - Copyright (C) 2000-2003 Internet Software Consortium.
5 - Permission to use, copy, modify, and/or distribute this software for any
6 - purpose with or without fee is hereby granted, provided that the above
7 - copyright notice and this permission notice appear in all copies.
9 - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
10 - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
11 - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
12 - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
13 - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
14 - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
15 - PERFORMANCE OF THIS SOFTWARE.
17 <!-- $Id: man.named-checkconf.html,v 1.5 2015/09/03 07:33:34 christos Exp $ -->
20 <meta http-equiv=
"Content-Type" content=
"text/html; charset=ISO-8859-1">
21 <title>named-checkconf
</title>
22 <meta name=
"generator" content=
"DocBook XSL Stylesheets V1.71.1">
23 <link rel=
"start" href=
"Bv9ARM.html" title=
"BIND 9 Administrator Reference Manual">
24 <link rel=
"up" href=
"Bv9ARM.ch13.html" title=
"Manual pages">
25 <link rel=
"prev" href=
"man.dnssec-verify.html" title=
"dnssec-verify">
26 <link rel=
"next" href=
"man.named-checkzone.html" title=
"named-checkzone">
28 <body bgcolor=
"white" text=
"black" link=
"#0000FF" vlink=
"#840084" alink=
"#0000FF">
29 <div class=
"navheader">
30 <table width=
"100%" summary=
"Navigation header">
31 <tr><th colspan=
"3" align=
"center"><span class=
"application">named-checkconf
</span></th></tr>
33 <td width=
"20%" align=
"left">
34 <a accesskey=
"p" href=
"man.dnssec-verify.html">Prev
</a> </td>
35 <th width=
"60%" align=
"center">Manual pages
</th>
36 <td width=
"20%" align=
"right"> <a accesskey=
"n" href=
"man.named-checkzone.html">Next
</a>
42 <div class=
"refentry" lang=
"en">
43 <a name=
"man.named-checkconf"></a><div class=
"titlepage"></div>
44 <div class=
"refnamediv">
46 <p><span class=
"application">named-checkconf
</span> — named configuration file syntax checking tool
</p>
48 <div class=
"refsynopsisdiv">
50 <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">-x
</code>] [
<code class=
"option">-z
</code>]
</p></div>
52 <div class=
"refsect1" lang=
"en">
53 <a name=
"id2643746"></a><h2>DESCRIPTION
</h2>
54 <p><span><strong class=
"command">named-checkconf
</strong></span>
55 checks the syntax, but not the semantics, of a
56 <span><strong class=
"command">named
</strong></span> configuration file. The file is parsed
57 and checked for syntax errors, along with all files included by it.
58 If no file is specified,
<code class=
"filename">/etc/named.conf
</code> is read
62 Note: files that
<span><strong class=
"command">named
</strong></span> reads in separate
63 parser contexts, such as
<code class=
"filename">rndc.key
</code> and
64 <code class=
"filename">bind.keys
</code>, are not automatically read
65 by
<span><strong class=
"command">named-checkconf
</strong></span>. Configuration
66 errors in these files may cause
<span><strong class=
"command">named
</strong></span> to
67 fail to run, even if
<span><strong class=
"command">named-checkconf
</strong></span> was
68 successful.
<span><strong class=
"command">named-checkconf
</strong></span> can be run
69 on these files explicitly, however.
72 <div class=
"refsect1" lang=
"en">
73 <a name=
"id2643816"></a><h2>OPTIONS
</h2>
74 <div class=
"variablelist"><dl>
75 <dt><span class=
"term">-h
</span></dt>
77 Print the usage summary and exit.
79 <dt><span class=
"term">-t
<em class=
"replaceable"><code>directory
</code></em></span></dt>
81 Chroot to
<code class=
"filename">directory
</code> so that include
82 directives in the configuration file are processed as if
83 run by a similarly chrooted named.
85 <dt><span class=
"term">-v
</span></dt>
87 Print the version of the
<span><strong class=
"command">named-checkconf
</strong></span>
90 <dt><span class=
"term">-p
</span></dt>
92 Print out the
<code class=
"filename">named.conf
</code> and included files
93 in canonical form if no errors were detected.
95 <dt><span class=
"term">-x
</span></dt>
97 When printing the configuration files in canonical
98 form, obscure shared secrets by replacing them with
99 strings of question marks ('?'). This allows the
100 contents of
<code class=
"filename">named.conf
</code> and related
101 files to be shared
— for example, when submitting
102 bug reports
— without compromising private data.
103 This option cannot be used without
<code class=
"option">-p
</code>.
105 <dt><span class=
"term">-z
</span></dt>
107 Perform a test load of all master zones found in
108 <code class=
"filename">named.conf
</code>.
110 <dt><span class=
"term">-j
</span></dt>
112 When loading a zonefile read the journal if it exists.
114 <dt><span class=
"term">filename
</span></dt>
116 The name of the configuration file to be checked. If not
117 specified, it defaults to
<code class=
"filename">/etc/named.conf
</code>.
121 <div class=
"refsect1" lang=
"en">
122 <a name=
"id2644177"></a><h2>RETURN VALUES
</h2>
123 <p><span><strong class=
"command">named-checkconf
</strong></span>
124 returns an exit status of
1 if
125 errors were detected and
0 otherwise.
128 <div class=
"refsect1" lang=
"en">
129 <a name=
"id2644190"></a><h2>SEE ALSO
</h2>
130 <p><span class=
"citerefentry"><span class=
"refentrytitle">named
</span>(
8)
</span>,
131 <span class=
"citerefentry"><span class=
"refentrytitle">named-checkzone
</span>(
8)
</span>,
132 <em class=
"citetitle">BIND
9 Administrator Reference Manual
</em>.
135 <div class=
"refsect1" lang=
"en">
136 <a name=
"id2644220"></a><h2>AUTHOR
</h2>
137 <p><span class=
"corpauthor">Internet Systems Consortium
</span>
141 <div class=
"navfooter">
143 <table width=
"100%" summary=
"Navigation footer">
145 <td width=
"40%" align=
"left">
146 <a accesskey=
"p" href=
"man.dnssec-verify.html">Prev
</a> </td>
147 <td width=
"20%" align=
"center"><a accesskey=
"u" href=
"Bv9ARM.ch13.html">Up
</a></td>
148 <td width=
"40%" align=
"right"> <a accesskey=
"n" href=
"man.named-checkzone.html">Next
</a>
152 <td width=
"40%" align=
"left" valign=
"top">
153 <span class=
"application">dnssec-verify
</span> </td>
154 <td width=
"20%" align=
"center"><a accesskey=
"h" href=
"Bv9ARM.html">Home
</a></td>
155 <td width=
"40%" align=
"right" valign=
"top"> <span class=
"application">named-checkzone
</span>
160 <p style=
"text-align: center;">BIND
9.10.2-P4
</p>