named-checkconf.docbook revision b5ad6dfea4cc3e7d1d322ac99f1e5a31096837c4
ad53c2449238379699243be05926645262e9581eChristian Maeder<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.0//EN"
306763c67bb99228487345b32ab8c5c6cd41f23cChristian Maeder "http://www.oasis-open.org/docbook/xml/4.0/docbookx.dtd"
ad53c2449238379699243be05926645262e9581eChristian Maeder [<!ENTITY mdash "&#8212;">]>
97018cf5fa25b494adffd7e9b4e87320dae6bf47Christian Maeder<!--
306763c67bb99228487345b32ab8c5c6cd41f23cChristian Maeder - Copyright (C) 2004, 2005 Internet Systems Consortium, Inc. ("ISC")
b4fbc96e05117839ca409f5f20f97b3ac872d1edTill Mossakowski - Copyright (C) 2000-2002 Internet Software Consortium.
306763c67bb99228487345b32ab8c5c6cd41f23cChristian Maeder -
306763c67bb99228487345b32ab8c5c6cd41f23cChristian Maeder - Permission to use, copy, modify, and distribute this software for any
95c3e5d11dcee331dc3876a9bf0c1d6daa38e2caChristian Maeder - purpose with or without fee is hereby granted, provided that the above
f3a94a197960e548ecd6520bb768cb0d547457bbChristian Maeder - copyright notice and this permission notice appear in all copies.
679d3f541f7a9ede4079e045f7758873bb901872Till Mossakowski -
306763c67bb99228487345b32ab8c5c6cd41f23cChristian Maeder - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
306763c67bb99228487345b32ab8c5c6cd41f23cChristian Maeder - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
306763c67bb99228487345b32ab8c5c6cd41f23cChristian Maeder - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
95c3e5d11dcee331dc3876a9bf0c1d6daa38e2caChristian Maeder - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
95c3e5d11dcee331dc3876a9bf0c1d6daa38e2caChristian Maeder - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
95c3e5d11dcee331dc3876a9bf0c1d6daa38e2caChristian Maeder - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
95c3e5d11dcee331dc3876a9bf0c1d6daa38e2caChristian Maeder - PERFORMANCE OF THIS SOFTWARE.
95c3e5d11dcee331dc3876a9bf0c1d6daa38e2caChristian Maeder-->
95c3e5d11dcee331dc3876a9bf0c1d6daa38e2caChristian Maeder
95c3e5d11dcee331dc3876a9bf0c1d6daa38e2caChristian Maeder<!-- $Id: named-checkconf.docbook,v 1.13 2005/07/19 04:55:19 marka Exp $ -->
95c3e5d11dcee331dc3876a9bf0c1d6daa38e2caChristian Maeder<refentry id="man.named-checkconf">
95c3e5d11dcee331dc3876a9bf0c1d6daa38e2caChristian Maeder <refentryinfo>
b09c4ce9ee62d8b62f6c7bb12956a3dea4defd95Till Mossakowski <date>June 14, 2000</date>
b09c4ce9ee62d8b62f6c7bb12956a3dea4defd95Till Mossakowski </refentryinfo>
95c3e5d11dcee331dc3876a9bf0c1d6daa38e2caChristian Maeder
95c3e5d11dcee331dc3876a9bf0c1d6daa38e2caChristian Maeder <refmeta>
95c3e5d11dcee331dc3876a9bf0c1d6daa38e2caChristian Maeder <refentrytitle><application>named-checkconf</application></refentrytitle>
95c3e5d11dcee331dc3876a9bf0c1d6daa38e2caChristian Maeder <manvolnum>8</manvolnum>
1549f3abf73c1122acff724f718b615c82fa3648Till Mossakowski <refmiscinfo>BIND9</refmiscinfo>
db44129e456bdfdb1044845dd0c64dbcb6c1f7d8Klaus Luettich </refmeta>
95c3e5d11dcee331dc3876a9bf0c1d6daa38e2caChristian Maeder
95c3e5d11dcee331dc3876a9bf0c1d6daa38e2caChristian Maeder <docinfo>
ba904a15082557e939db689fcfba0c68c9a4f740Christian Maeder <copyright>
95c3e5d11dcee331dc3876a9bf0c1d6daa38e2caChristian Maeder <year>2004</year>
ba904a15082557e939db689fcfba0c68c9a4f740Christian Maeder <year>2005</year>
ba904a15082557e939db689fcfba0c68c9a4f740Christian Maeder <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
e1abb0a8a17632e11db927958ab8cf58635bdf96Christian Maeder </copyright>
e220b2051a2342a9291721e6c7f408860bed01b7Jorina Freya Gerken <copyright>
7bf4436b6f9987b070033a323757b206c898c1beChristian Maeder <year>2000</year>
e1abb0a8a17632e11db927958ab8cf58635bdf96Christian Maeder <year>2001</year>
ba904a15082557e939db689fcfba0c68c9a4f740Christian Maeder <year>2002</year>
95c3e5d11dcee331dc3876a9bf0c1d6daa38e2caChristian Maeder <holder>Internet Software Consortium.</holder>
e1abb0a8a17632e11db927958ab8cf58635bdf96Christian Maeder </copyright>
0799b5dc3f06d2640e66e9ab54b8b217348fd719Christian Maeder </docinfo>
e1abb0a8a17632e11db927958ab8cf58635bdf96Christian Maeder
95932c57191afb21b59187129e4fed66250500ecMaciek Makowski <refnamediv>
9603ad7198b72e812688ad7970e4eac4b553837aKlaus Luettich <refname><application>named-checkconf</application></refname>
4ea99e115bbade1632815267d5e0dcb9931aac1eChristian Maeder <refpurpose>named configuration file syntax checking tool</refpurpose>
e1abb0a8a17632e11db927958ab8cf58635bdf96Christian Maeder </refnamediv>
e1abb0a8a17632e11db927958ab8cf58635bdf96Christian Maeder
e1abb0a8a17632e11db927958ab8cf58635bdf96Christian Maeder <refsynopsisdiv>
ba904a15082557e939db689fcfba0c68c9a4f740Christian Maeder <cmdsynopsis>
e1abb0a8a17632e11db927958ab8cf58635bdf96Christian Maeder <command>named-checkconf</command>
58b671de3fe578346fef9642ffa3c5a0a0edb3cbTill Mossakowski <arg><option>-v</option></arg>
e1abb0a8a17632e11db927958ab8cf58635bdf96Christian Maeder <arg><option>-j</option></arg>
95932c57191afb21b59187129e4fed66250500ecMaciek Makowski <arg><option>-t <replaceable class="parameter">directory</replaceable></option></arg>
e1abb0a8a17632e11db927958ab8cf58635bdf96Christian Maeder <arg choice="req">filename</arg>
4ea99e115bbade1632815267d5e0dcb9931aac1eChristian Maeder <arg><option>-z</option></arg>
e1abb0a8a17632e11db927958ab8cf58635bdf96Christian Maeder </cmdsynopsis>
e1abb0a8a17632e11db927958ab8cf58635bdf96Christian Maeder </refsynopsisdiv>
ea22277038f87c1e12539f8917d61248015e80d8Christian Maeder
95c3e5d11dcee331dc3876a9bf0c1d6daa38e2caChristian Maeder <refsect1>
0799b5dc3f06d2640e66e9ab54b8b217348fd719Christian Maeder <title>DESCRIPTION</title>
ad53c2449238379699243be05926645262e9581eChristian Maeder <para><command>named-checkconf</command>
0799b5dc3f06d2640e66e9ab54b8b217348fd719Christian Maeder checks the syntax, but not the semantics, of a named
ad53c2449238379699243be05926645262e9581eChristian Maeder configuration file.
9fa5b06733fe318e18d9b8e0ef58e5d1ec953f7cMaciek Makowski </para>
9fa5b06733fe318e18d9b8e0ef58e5d1ec953f7cMaciek Makowski </refsect1>
9fa5b06733fe318e18d9b8e0ef58e5d1ec953f7cMaciek Makowski
95c3e5d11dcee331dc3876a9bf0c1d6daa38e2caChristian Maeder <refsect1>
95c3e5d11dcee331dc3876a9bf0c1d6daa38e2caChristian Maeder <title>OPTIONS</title>
95c3e5d11dcee331dc3876a9bf0c1d6daa38e2caChristian Maeder
95c3e5d11dcee331dc3876a9bf0c1d6daa38e2caChristian Maeder <variablelist>
8c0c8034bdf3688904ed4f40e255c09ddba63a6bTill Mossakowski <varlistentry>
8c0c8034bdf3688904ed4f40e255c09ddba63a6bTill Mossakowski <term>-t <replaceable class="parameter">directory</replaceable></term>
8c0c8034bdf3688904ed4f40e255c09ddba63a6bTill Mossakowski <listitem>
db7143998eee23e3d781f1f1e97e953bb831df1fTill Mossakowski <para>
db7143998eee23e3d781f1f1e97e953bb831df1fTill Mossakowski chroot to <filename>directory</filename> so that
ad53c2449238379699243be05926645262e9581eChristian Maeder include
ad53c2449238379699243be05926645262e9581eChristian Maeder directives in the configuration file are processed as if
8c0c8034bdf3688904ed4f40e255c09ddba63a6bTill Mossakowski run by a similarly chrooted named.
8c0c8034bdf3688904ed4f40e255c09ddba63a6bTill Mossakowski </para>
8c0c8034bdf3688904ed4f40e255c09ddba63a6bTill Mossakowski </listitem>
8c0c8034bdf3688904ed4f40e255c09ddba63a6bTill Mossakowski </varlistentry>
ad53c2449238379699243be05926645262e9581eChristian Maeder
5d812ccb300d5ca8b6e9474d2a644b964faf2d28Jorina Freya Gerken <varlistentry>
5d812ccb300d5ca8b6e9474d2a644b964faf2d28Jorina Freya Gerken <term>-v</term>
5d812ccb300d5ca8b6e9474d2a644b964faf2d28Jorina Freya Gerken <listitem>
8c0c8034bdf3688904ed4f40e255c09ddba63a6bTill Mossakowski <para>
8c0c8034bdf3688904ed4f40e255c09ddba63a6bTill Mossakowski Print the version of the <command>named-checkconf</command>
aebf36d7483e5c012eff154d0b76de400d8fe3fcTill Mossakowski program and exit.
8c0c8034bdf3688904ed4f40e255c09ddba63a6bTill Mossakowski </para>
8c0c8034bdf3688904ed4f40e255c09ddba63a6bTill Mossakowski </listitem>
aebf36d7483e5c012eff154d0b76de400d8fe3fcTill Mossakowski </varlistentry>
8c0c8034bdf3688904ed4f40e255c09ddba63a6bTill Mossakowski
ad53c2449238379699243be05926645262e9581eChristian Maeder <varlistentry>
8c0c8034bdf3688904ed4f40e255c09ddba63a6bTill Mossakowski <term>-z</term>
8a8880f1b6a0681e636480991d45dfea11d62ff8Christian Maeder <listitem>
8a8880f1b6a0681e636480991d45dfea11d62ff8Christian Maeder <para>
8a8880f1b6a0681e636480991d45dfea11d62ff8Christian Maeder Perform a check load the master zonefiles found in
8a8880f1b6a0681e636480991d45dfea11d62ff8Christian Maeder <filename>named.conf</filename>.
95c3e5d11dcee331dc3876a9bf0c1d6daa38e2caChristian Maeder </para>
db7143998eee23e3d781f1f1e97e953bb831df1fTill Mossakowski </listitem>
5d812ccb300d5ca8b6e9474d2a644b964faf2d28Jorina Freya Gerken </varlistentry>
db7143998eee23e3d781f1f1e97e953bb831df1fTill Mossakowski
db7143998eee23e3d781f1f1e97e953bb831df1fTill Mossakowski <varlistentry>
3c6d4005240e070a2b9fe9aaf28631328a1b0884Till Mossakowski <term>-j</term>
3c6d4005240e070a2b9fe9aaf28631328a1b0884Till Mossakowski <listitem>
3c6d4005240e070a2b9fe9aaf28631328a1b0884Till Mossakowski <para>
3c6d4005240e070a2b9fe9aaf28631328a1b0884Till Mossakowski When loading a zonefile read the journal if it exists.
db7143998eee23e3d781f1f1e97e953bb831df1fTill Mossakowski </para>
db7143998eee23e3d781f1f1e97e953bb831df1fTill Mossakowski </listitem>
e509b6f97f98f96ef258c1c3f7968241da8bde5dTill Mossakowski </varlistentry>
db7143998eee23e3d781f1f1e97e953bb831df1fTill Mossakowski
e1abb0a8a17632e11db927958ab8cf58635bdf96Christian Maeder <varlistentry>
e1abb0a8a17632e11db927958ab8cf58635bdf96Christian Maeder <term>filename</term>
db7143998eee23e3d781f1f1e97e953bb831df1fTill Mossakowski <listitem>
db7143998eee23e3d781f1f1e97e953bb831df1fTill Mossakowski <para>
db7143998eee23e3d781f1f1e97e953bb831df1fTill Mossakowski The name of the configuration file to be checked. If not
db7143998eee23e3d781f1f1e97e953bb831df1fTill Mossakowski specified, it defaults to <filename>/etc/named.conf</filename>.
db7143998eee23e3d781f1f1e97e953bb831df1fTill Mossakowski </para>
db7143998eee23e3d781f1f1e97e953bb831df1fTill Mossakowski </listitem>
db7143998eee23e3d781f1f1e97e953bb831df1fTill Mossakowski </varlistentry>
db7143998eee23e3d781f1f1e97e953bb831df1fTill Mossakowski
db7143998eee23e3d781f1f1e97e953bb831df1fTill Mossakowski </variablelist>
db7143998eee23e3d781f1f1e97e953bb831df1fTill Mossakowski
db7143998eee23e3d781f1f1e97e953bb831df1fTill Mossakowski </refsect1>
db7143998eee23e3d781f1f1e97e953bb831df1fTill Mossakowski
db7143998eee23e3d781f1f1e97e953bb831df1fTill Mossakowski <refsect1>
db7143998eee23e3d781f1f1e97e953bb831df1fTill Mossakowski <title>RETURN VALUES</title>
db7143998eee23e3d781f1f1e97e953bb831df1fTill Mossakowski <para><command>named-checkconf</command>
e1abb0a8a17632e11db927958ab8cf58635bdf96Christian Maeder returns an exit status of 1 if
db7143998eee23e3d781f1f1e97e953bb831df1fTill Mossakowski errors were detected and 0 otherwise.
db7143998eee23e3d781f1f1e97e953bb831df1fTill Mossakowski </para>
db7143998eee23e3d781f1f1e97e953bb831df1fTill Mossakowski </refsect1>
db7143998eee23e3d781f1f1e97e953bb831df1fTill Mossakowski
db7143998eee23e3d781f1f1e97e953bb831df1fTill Mossakowski <refsect1>
db7143998eee23e3d781f1f1e97e953bb831df1fTill Mossakowski <title>SEE ALSO</title>
db7143998eee23e3d781f1f1e97e953bb831df1fTill Mossakowski <para><citerefentry>
db7143998eee23e3d781f1f1e97e953bb831df1fTill Mossakowski <refentrytitle>named</refentrytitle><manvolnum>8</manvolnum>
db7143998eee23e3d781f1f1e97e953bb831df1fTill Mossakowski </citerefentry>,
db7143998eee23e3d781f1f1e97e953bb831df1fTill Mossakowski <citetitle>BIND 9 Administrator Reference Manual</citetitle>.
db7143998eee23e3d781f1f1e97e953bb831df1fTill Mossakowski </para>
e73be37c05d01fc538553efbf77c1d330cf11542Till Mossakowski </refsect1>
5d812ccb300d5ca8b6e9474d2a644b964faf2d28Jorina Freya Gerken
aebf36d7483e5c012eff154d0b76de400d8fe3fcTill Mossakowski <refsect1>
95c3e5d11dcee331dc3876a9bf0c1d6daa38e2caChristian Maeder <title>AUTHOR</title>
e73be37c05d01fc538553efbf77c1d330cf11542Till Mossakowski <para><corpauthor>Internet Systems Consortium</corpauthor>
ad53c2449238379699243be05926645262e9581eChristian Maeder </para>
aebf36d7483e5c012eff154d0b76de400d8fe3fcTill Mossakowski </refsect1>
aebf36d7483e5c012eff154d0b76de400d8fe3fcTill Mossakowski
ad53c2449238379699243be05926645262e9581eChristian Maeder</refentry><!--
ad53c2449238379699243be05926645262e9581eChristian Maeder - Local variables:
8c0c8034bdf3688904ed4f40e255c09ddba63a6bTill Mossakowski - mode: sgml
ad53c2449238379699243be05926645262e9581eChristian Maeder - End:
e73be37c05d01fc538553efbf77c1d330cf11542Till Mossakowski-->
8c0c8034bdf3688904ed4f40e255c09ddba63a6bTill Mossakowski