named-checkconf.docbook revision 3bc4221346e5045c5679dd0d84f4f7d888a9da79
43b4c41fbb07705c9df321221ab9cb9832460407Christian Maeder<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
25cc5fbba63f84b47e389af749f55abbbde71c8cChristian Maeder "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
63f0e65a37b95621334db9ee4ba0cd9d826f5c0fChristian Maeder [<!ENTITY mdash "&#8212;">]>
25cc5fbba63f84b47e389af749f55abbbde71c8cChristian Maeder<!--
5191fa24c532d1f67e7a642e9aece65efb8a0975Christian Maeder - Copyright (C) 2004, 2005, 2007 Internet Systems Consortium, Inc. ("ISC")
43b4c41fbb07705c9df321221ab9cb9832460407Christian Maeder - Copyright (C) 2000-2002 Internet Software Consortium.
5191fa24c532d1f67e7a642e9aece65efb8a0975Christian Maeder -
5191fa24c532d1f67e7a642e9aece65efb8a0975Christian Maeder - Permission to use, copy, modify, and/or distribute this software for any
5191fa24c532d1f67e7a642e9aece65efb8a0975Christian Maeder - purpose with or without fee is hereby granted, provided that the above
43b4c41fbb07705c9df321221ab9cb9832460407Christian Maeder - copyright notice and this permission notice appear in all copies.
5191fa24c532d1f67e7a642e9aece65efb8a0975Christian Maeder -
f4a2a20e49f41b2afa657e5e64d9e349c7faa091Christian Maeder - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
f2f9df2e17e70674f0bf426ed1763c973ee4cde0Christian Maeder - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
5191fa24c532d1f67e7a642e9aece65efb8a0975Christian Maeder - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
5191fa24c532d1f67e7a642e9aece65efb8a0975Christian Maeder - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
5191fa24c532d1f67e7a642e9aece65efb8a0975Christian Maeder - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
68d10d143f29fcff3c637ba24f90e983995ceae6Christian Maeder - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
a53841f6d6e86ac751c12a33dc8aadf53f59d977Klaus Luettich - PERFORMANCE OF THIS SOFTWARE.
a53841f6d6e86ac751c12a33dc8aadf53f59d977Klaus Luettich-->
a53841f6d6e86ac751c12a33dc8aadf53f59d977Klaus Luettich
a53841f6d6e86ac751c12a33dc8aadf53f59d977Klaus Luettich<!-- $Id: named-checkconf.docbook,v 1.20 2009/07/13 06:57:21 marka Exp $ -->
a737caf82de97c1907027c03e4b4509eb492b4b8Christian Maeder<refentry id="man.named-checkconf">
68d10d143f29fcff3c637ba24f90e983995ceae6Christian Maeder <refentryinfo>
96646aed2ae087b942ae23f15bbe729a8f7c43d3Christian Maeder <date>June 14, 2000</date>
01e383014b555bbcf639c0ca60c5810b3eff83c0Christian Maeder </refentryinfo>
3b06e23643a9f65390cb8c1caabe83fa7e87a708Till Mossakowski
df29370ae8d8b41587957f6bcdcb43a3f1927e47Christian Maeder <refmeta>
f4a2a20e49f41b2afa657e5e64d9e349c7faa091Christian Maeder <refentrytitle><application>named-checkconf</application></refentrytitle>
ce8b15da31cd181b7e90593cbbca98f47eda29d6Till Mossakowski <manvolnum>8</manvolnum>
e7757995211bd395dc79d26fe017d99375f7d2a6Christian Maeder <refmiscinfo>BIND9</refmiscinfo>
e7757995211bd395dc79d26fe017d99375f7d2a6Christian Maeder </refmeta>
63f0e65a37b95621334db9ee4ba0cd9d826f5c0fChristian Maeder
63f0e65a37b95621334db9ee4ba0cd9d826f5c0fChristian Maeder <docinfo>
ac0bbbcb2774629bb87986e69cf53d3402c5f575Christian Maeder <copyright>
63f0e65a37b95621334db9ee4ba0cd9d826f5c0fChristian Maeder <year>2004</year>
2e2094a642e3775b0d76b890556407941d3a53b6Christian Maeder <year>2005</year>
2e2094a642e3775b0d76b890556407941d3a53b6Christian Maeder <year>2007</year>
6a79849bed67264c396dddb3e9c184bdfc1a1bc9Christian Maeder <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
e8db9a65830cf71504e33c6f441a67b4d184a3caChristian Maeder </copyright>
c0c2380bced8159ff0297ece14eba948bd236471Christian Maeder <copyright>
8410667510a76409aca9bb24ff0eda0420088274Christian Maeder <year>2000</year>
6a79849bed67264c396dddb3e9c184bdfc1a1bc9Christian Maeder <year>2001</year>
63f0e65a37b95621334db9ee4ba0cd9d826f5c0fChristian Maeder <year>2002</year>
8410667510a76409aca9bb24ff0eda0420088274Christian Maeder <holder>Internet Software Consortium.</holder>
404166b9366552e9ec5abb87a37c76ec8a815fb7Klaus Luettich </copyright>
b1f59a4ea7c96f4c03a4d7cfcb9c5e66871cfbbbChristian Maeder </docinfo>
ad270004874ce1d0697fb30d7309f180553bb315Christian Maeder
4d56f2fa72e4aec20eb827c11ed49c8cbb7014bdChristian Maeder <refnamediv>
4cb215739e9ab13447fa21162482ebe485b47455Christian Maeder <refname><application>named-checkconf</application></refname>
8ef75f1cc0437656bf622cec5ac9e8ea221da8f2Christian Maeder <refpurpose>named configuration file syntax checking tool</refpurpose>
404166b9366552e9ec5abb87a37c76ec8a815fb7Klaus Luettich </refnamediv>
63f0e65a37b95621334db9ee4ba0cd9d826f5c0fChristian Maeder
356fa49fe3e6a8398f92d13e9f920d0f093697ecChristian Maeder <refsynopsisdiv>
63f0e65a37b95621334db9ee4ba0cd9d826f5c0fChristian Maeder <cmdsynopsis>
55adfe57a4de1f36adc3e3bfc16f342e44a7d444Christian Maeder <command>named-checkconf</command>
d23b0cc79c0d204e6ec758dff8d0ba71c9f693f7Christian Maeder <arg><option>-h</option></arg>
8d97ef4f234681b11bb5924bd4d03adef858d2d2Christian Maeder <arg><option>-v</option></arg>
f4a2a20e49f41b2afa657e5e64d9e349c7faa091Christian Maeder <arg><option>-j</option></arg>
63f0e65a37b95621334db9ee4ba0cd9d826f5c0fChristian Maeder <arg><option>-t <replaceable class="parameter">directory</replaceable></option></arg>
e593b89bfd4952698dc37feced21cefe869d87a2Christian Maeder <arg choice="req">filename</arg>
63f0e65a37b95621334db9ee4ba0cd9d826f5c0fChristian Maeder <arg><option>-p</option></arg>
5191fa24c532d1f67e7a642e9aece65efb8a0975Christian Maeder <arg><option>-z</option></arg>
7cc09dd93962a2155c34d209d1d4cd7d7b838264Christian Maeder </cmdsynopsis>
1aee4aaddde105264c1faf394d88e302c05094ffChristian Maeder </refsynopsisdiv>
1aee4aaddde105264c1faf394d88e302c05094ffChristian Maeder
f041c9a6bda23de33a38490e35b831ae18d96b45Christian Maeder <refsect1>
7cc09dd93962a2155c34d209d1d4cd7d7b838264Christian Maeder <title>DESCRIPTION</title>
1aee4aaddde105264c1faf394d88e302c05094ffChristian Maeder <para><command>named-checkconf</command>
1aee4aaddde105264c1faf394d88e302c05094ffChristian Maeder checks the syntax, but not the semantics, of a named
c3053d57f642ca507cdf79512e604437c4546cb9Christian Maeder configuration file.
dcbd32289a7bdf1e6edd06c6ab0698c6a9dbf37aChristian Maeder </para>
f4a2a20e49f41b2afa657e5e64d9e349c7faa091Christian Maeder </refsect1>
f4a2a20e49f41b2afa657e5e64d9e349c7faa091Christian Maeder
dcbd32289a7bdf1e6edd06c6ab0698c6a9dbf37aChristian Maeder <refsect1>
b886e9e5db2098d0112cc4f70aeba232962939ddChristian Maeder <title>OPTIONS</title>
c2fcc35abb03cf0b4ca4b050efeb10827f38c322Christian Maeder
1aee4aaddde105264c1faf394d88e302c05094ffChristian Maeder <variablelist>
356fa49fe3e6a8398f92d13e9f920d0f093697ecChristian Maeder <varlistentry>
356fa49fe3e6a8398f92d13e9f920d0f093697ecChristian Maeder <term>-h</term>
4ed0007ac9caea5b468f202521352d153481423cChristian Maeder <listitem>
356fa49fe3e6a8398f92d13e9f920d0f093697ecChristian Maeder <para>
356fa49fe3e6a8398f92d13e9f920d0f093697ecChristian Maeder Print the usage summary and exit.
0206ab93ef846e4e0885996d052b9b73b9dc66b0Christian Maeder </para>
f13d1e86e58da53680e78043e8df182eed867efbChristian Maeder </listitem>
c2a4d8ae266aa37cc922eba97077520229a19902Christian Maeder </varlistentry>
03a6d8f77f588dc5d3dd6653797fa2362efa1751Christian Maeder
757e6c79ec40491d45dc72c82b5eb59a386634b0Jian Chun Wang <varlistentry>
ecf76bc89d9a2ecd7ac7310d30654b9a79d97d62Klaus Luettich <term>-t <replaceable class="parameter">directory</replaceable></term>
ecf76bc89d9a2ecd7ac7310d30654b9a79d97d62Klaus Luettich <listitem>
ecf76bc89d9a2ecd7ac7310d30654b9a79d97d62Klaus Luettich <para>
e7757995211bd395dc79d26fe017d99375f7d2a6Christian Maeder Chroot to <filename>directory</filename> so that include
c6fcd42c6d6d9dae8c7835c24fcb7ce8531a9050Christian Maeder directives in the configuration file are processed as if
31c49f2fa23d4ac089f35145d80a224deb6ea7e4Till Mossakowski run by a similarly chrooted named.
c55a0f77be7e88d3620b419ec8961f4379a586e3Klaus Luettich </para>
36f63902db2b3463faa9f59912ad106e2d5aaa24Klaus Luettich </listitem>
36f63902db2b3463faa9f59912ad106e2d5aaa24Klaus Luettich </varlistentry>
363939beade943a02b31004cea09dec34fa8a6d9Christian Maeder
5ad5dffe06818a13e1632b1119fbca7881085fc1Dominik Luecke <varlistentry>
8cacad2a09782249243b80985f28e9387019fe40Christian Maeder <term>-v</term>
363939beade943a02b31004cea09dec34fa8a6d9Christian Maeder <listitem>
a7c27282e71cf4505026645f96d4f5cb8a284e32Christian Maeder <para>
363939beade943a02b31004cea09dec34fa8a6d9Christian Maeder Print the version of the <command>named-checkconf</command>
8a28707e9155465c6f2236a06eac6580a65c7025Christian Maeder program and exit.
df35538fec1d9135602308d577255c0d466b6365Christian Maeder </para>
b886e9e5db2098d0112cc4f70aeba232962939ddChristian Maeder </listitem>
431d34c7007a787331c4e5ec997badb0f8190fc7Christian Maeder </varlistentry>
63f0e65a37b95621334db9ee4ba0cd9d826f5c0fChristian Maeder
d3ae0072823e2ef0d41d4431fcc768e66489c20eChristian Maeder <varlistentry>
9e748851c150e1022fb952bab3315e869aaf0214Christian Maeder <term>-p</term>
63f0e65a37b95621334db9ee4ba0cd9d826f5c0fChristian Maeder <listitem>
5191fa24c532d1f67e7a642e9aece65efb8a0975Christian Maeder <para>
9e748851c150e1022fb952bab3315e869aaf0214Christian Maeder Print out the <filename>named.conf</filename> and included files
9e748851c150e1022fb952bab3315e869aaf0214Christian Maeder in canonical form if no errors were detected.
6a79849bed67264c396dddb3e9c184bdfc1a1bc9Christian Maeder </para>
6a79849bed67264c396dddb3e9c184bdfc1a1bc9Christian Maeder </listitem>
6a79849bed67264c396dddb3e9c184bdfc1a1bc9Christian Maeder </varlistentry>
6a79849bed67264c396dddb3e9c184bdfc1a1bc9Christian Maeder
6a79849bed67264c396dddb3e9c184bdfc1a1bc9Christian Maeder <varlistentry>
b886e9e5db2098d0112cc4f70aeba232962939ddChristian Maeder <term>-z</term>
b886e9e5db2098d0112cc4f70aeba232962939ddChristian Maeder <listitem>
9e748851c150e1022fb952bab3315e869aaf0214Christian Maeder <para>
9e748851c150e1022fb952bab3315e869aaf0214Christian Maeder Perform a test load of all master zones found in
f1541d4a151dbd08002dbd14e7eb1d5dde253689Christian Maeder <filename>named.conf</filename>.
776a1a086df734581431e6edb4343ed4c8d34d55Christian Maeder </para>
f1541d4a151dbd08002dbd14e7eb1d5dde253689Christian Maeder </listitem>
6dc9bc98d0854fe2e3dd3bfc4275096a0c28ee1cChristian Maeder </varlistentry>
6dc9bc98d0854fe2e3dd3bfc4275096a0c28ee1cChristian Maeder
6dc9bc98d0854fe2e3dd3bfc4275096a0c28ee1cChristian Maeder <varlistentry>
63f0e65a37b95621334db9ee4ba0cd9d826f5c0fChristian Maeder <term>-j</term>
61fa0ac06ede811c7aad54ec4c4202346727368eChristian Maeder <listitem>
c0c2380bced8159ff0297ece14eba948bd236471Christian Maeder <para>
63f0e65a37b95621334db9ee4ba0cd9d826f5c0fChristian Maeder When loading a zonefile read the journal if it exists.
63f0e65a37b95621334db9ee4ba0cd9d826f5c0fChristian Maeder </para>
63f0e65a37b95621334db9ee4ba0cd9d826f5c0fChristian Maeder </listitem>
63f0e65a37b95621334db9ee4ba0cd9d826f5c0fChristian Maeder </varlistentry>
63f0e65a37b95621334db9ee4ba0cd9d826f5c0fChristian Maeder
9e748851c150e1022fb952bab3315e869aaf0214Christian Maeder <varlistentry>
6a79849bed67264c396dddb3e9c184bdfc1a1bc9Christian Maeder <term>filename</term>
6a79849bed67264c396dddb3e9c184bdfc1a1bc9Christian Maeder <listitem>
6a79849bed67264c396dddb3e9c184bdfc1a1bc9Christian Maeder <para>
03a6d8f77f588dc5d3dd6653797fa2362efa1751Christian Maeder The name of the configuration file to be checked. If not
63f0e65a37b95621334db9ee4ba0cd9d826f5c0fChristian Maeder specified, it defaults to <filename>/etc/named.conf</filename>.
ca074a78b8dcccbb8c419586787882f98d0c6163Christian Maeder </para>
63f0e65a37b95621334db9ee4ba0cd9d826f5c0fChristian Maeder </listitem>
6a79849bed67264c396dddb3e9c184bdfc1a1bc9Christian Maeder </varlistentry>
a5e5b8c3e5c11177e5034ef2423813a5d28979edChristian Maeder
bc8cbf12aa172bf5673b92a9e7a0151d4aa4c315Christian Maeder </variablelist>
2d130d212db7208777ca896a7ecad619a8944971Christian Maeder
2d130d212db7208777ca896a7ecad619a8944971Christian Maeder </refsect1>
a5e5b8c3e5c11177e5034ef2423813a5d28979edChristian Maeder
a5e5b8c3e5c11177e5034ef2423813a5d28979edChristian Maeder <refsect1>
2d130d212db7208777ca896a7ecad619a8944971Christian Maeder <title>RETURN VALUES</title>
bc8cbf12aa172bf5673b92a9e7a0151d4aa4c315Christian Maeder <para><command>named-checkconf</command>
2d130d212db7208777ca896a7ecad619a8944971Christian Maeder returns an exit status of 1 if
f4a2a20e49f41b2afa657e5e64d9e349c7faa091Christian Maeder errors were detected and 0 otherwise.
2d130d212db7208777ca896a7ecad619a8944971Christian Maeder </para>
2d130d212db7208777ca896a7ecad619a8944971Christian Maeder </refsect1>
6a79849bed67264c396dddb3e9c184bdfc1a1bc9Christian Maeder
6ff7a91875597d6e4dfaa68c79187d01473e8341Christian Maeder <refsect1>
6ff7a91875597d6e4dfaa68c79187d01473e8341Christian Maeder <title>SEE ALSO</title>
6a79849bed67264c396dddb3e9c184bdfc1a1bc9Christian Maeder <para><citerefentry>
6a79849bed67264c396dddb3e9c184bdfc1a1bc9Christian Maeder <refentrytitle>named</refentrytitle><manvolnum>8</manvolnum>
4017ebc0f692820736d796af3110c3b3018c108aChristian Maeder </citerefentry>,
a9b59eb2ce961014974276cdae0e9df4419bd212Christian Maeder <citerefentry>
6a79849bed67264c396dddb3e9c184bdfc1a1bc9Christian Maeder <refentrytitle>named-checkzone</refentrytitle><manvolnum>8</manvolnum>
6a79849bed67264c396dddb3e9c184bdfc1a1bc9Christian Maeder </citerefentry>,
6a79849bed67264c396dddb3e9c184bdfc1a1bc9Christian Maeder <citetitle>BIND 9 Administrator Reference Manual</citetitle>.
6a79849bed67264c396dddb3e9c184bdfc1a1bc9Christian Maeder </para>
88318aafc287e92931dceffbb943d58a9310001dChristian Maeder </refsect1>
6a79849bed67264c396dddb3e9c184bdfc1a1bc9Christian Maeder
a3c6d8e0670bf2aa71bc8e2a3b1f45d56dd65e4cChristian Maeder <refsect1>
63f0e65a37b95621334db9ee4ba0cd9d826f5c0fChristian Maeder <title>AUTHOR</title>
63f0e65a37b95621334db9ee4ba0cd9d826f5c0fChristian Maeder <para><corpauthor>Internet Systems Consortium</corpauthor>
63f0e65a37b95621334db9ee4ba0cd9d826f5c0fChristian Maeder </para>
363939beade943a02b31004cea09dec34fa8a6d9Christian Maeder </refsect1>
363939beade943a02b31004cea09dec34fa8a6d9Christian Maeder
363939beade943a02b31004cea09dec34fa8a6d9Christian Maeder</refentry><!--
ca074a78b8dcccbb8c419586787882f98d0c6163Christian Maeder - Local variables:
63f0e65a37b95621334db9ee4ba0cd9d826f5c0fChristian Maeder - mode: sgml
ca074a78b8dcccbb8c419586787882f98d0c6163Christian Maeder - End:
ca074a78b8dcccbb8c419586787882f98d0c6163Christian Maeder-->
ca074a78b8dcccbb8c419586787882f98d0c6163Christian Maeder