named-checkconf.docbook revision f5d30e2864e048a42c4dc1134993ae7efdb5d6c3
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.0//EN"
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen "http://www.oasis-open.org/docbook/xml/4.0/docbookx.dtd"
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen [<!ENTITY mdash "&#8212;">]>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen<!--
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen - Copyright (C) 2004, 2005 Internet Systems Consortium, Inc. ("ISC")
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen - Copyright (C) 2000-2002 Internet Software Consortium.
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen -
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen - Permission to use, copy, modify, and distribute this software for any
1ef271d30011acf79e8e2a42b7b9baae8a2264d3Timo Sirainen - purpose with or without fee is hereby granted, provided that the above
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen - copyright notice and this permission notice appear in all copies.
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen -
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
63713f16bad8b55e74c479adb6b47965b519c29bTimo Sirainen - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
acfcf88e4dd529e4b2409f43bc9713cbc0169347Timo Sirainen - PERFORMANCE OF THIS SOFTWARE.
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen-->
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen<!-- $Id: named-checkconf.docbook,v 1.12 2005/05/13 01:35:38 marka Exp $ -->
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen<refentry>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen <refentryinfo>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen <date>June 14, 2000</date>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen </refentryinfo>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen <refmeta>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen <refentrytitle><application>named-checkconf</application></refentrytitle>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen <manvolnum>8</manvolnum>
1ef271d30011acf79e8e2a42b7b9baae8a2264d3Timo Sirainen <refmiscinfo>BIND9</refmiscinfo>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen </refmeta>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen <docinfo>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen <copyright>
1ef271d30011acf79e8e2a42b7b9baae8a2264d3Timo Sirainen <year>2004</year>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen <year>2005</year>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
1ef271d30011acf79e8e2a42b7b9baae8a2264d3Timo Sirainen </copyright>
1ef271d30011acf79e8e2a42b7b9baae8a2264d3Timo Sirainen <copyright>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen <year>2000</year>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen <year>2001</year>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen <year>2002</year>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen <holder>Internet Software Consortium.</holder>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen </copyright>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen </docinfo>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen <refnamediv>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen <refname><application>named-checkconf</application></refname>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen <refpurpose>named configuration file syntax checking tool</refpurpose>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen </refnamediv>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen <refsynopsisdiv>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen <cmdsynopsis>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen <command>named-checkconf</command>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen <arg><option>-v</option></arg>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen <arg><option>-j</option></arg>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen <arg><option>-t <replaceable class="parameter">directory</replaceable></option></arg>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen <arg choice="req">filename</arg>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen <arg><option>-z</option></arg>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen </cmdsynopsis>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen </refsynopsisdiv>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen <refsect1>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen <title>DESCRIPTION</title>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen <para><command>named-checkconf</command>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen checks the syntax, but not the semantics, of a named
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen configuration file.
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen </para>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen </refsect1>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen <refsect1>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen <title>OPTIONS</title>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen <variablelist>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen <varlistentry>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen <term>-t <replaceable class="parameter">directory</replaceable></term>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen <listitem>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen <para>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen chroot to <filename>directory</filename> so that
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen include
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen directives in the configuration file are processed as if
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen run by a similarly chrooted named.
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen </para>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen </listitem>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen </varlistentry>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen <varlistentry>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen <term>-v</term>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen <listitem>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen <para>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen Print the version of the <command>named-checkconf</command>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen program and exit.
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen </para>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen </listitem>
db090e2a48bcc5ce162af0c36eef04407421379dTeemu Huovila </varlistentry>
1d0f568e26ce5cbf18cd7bb335c6eea20a7e3770Teemu Huovila
1d0f568e26ce5cbf18cd7bb335c6eea20a7e3770Teemu Huovila <varlistentry>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen <term>-z</term>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen <listitem>
1d0f568e26ce5cbf18cd7bb335c6eea20a7e3770Teemu Huovila <para>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen Perform a check load the master zonefiles found in
1d0f568e26ce5cbf18cd7bb335c6eea20a7e3770Teemu Huovila <filename>named.conf</filename>.
1d0f568e26ce5cbf18cd7bb335c6eea20a7e3770Teemu Huovila </para>
1d0f568e26ce5cbf18cd7bb335c6eea20a7e3770Teemu Huovila </listitem>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen </varlistentry>
1d0f568e26ce5cbf18cd7bb335c6eea20a7e3770Teemu Huovila
6111370718708a3a966c60a1941ea303a4e0c759Timo Sirainen <varlistentry>
6111370718708a3a966c60a1941ea303a4e0c759Timo Sirainen <term>-j</term>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen <listitem>
6111370718708a3a966c60a1941ea303a4e0c759Timo Sirainen <para>
6111370718708a3a966c60a1941ea303a4e0c759Timo Sirainen When loading a zonefile read the journal if it exists.
b58ad1c4a4ef561b0081d6daa47c2dd7b223aeacTimo Sirainen </para>
b58ad1c4a4ef561b0081d6daa47c2dd7b223aeacTimo Sirainen </listitem>
db090e2a48bcc5ce162af0c36eef04407421379dTeemu Huovila </varlistentry>
c865b0e9c65fd77f7b2ab6f8616d3def5501ecb3Timo Sirainen
<varlistentry>
<term>filename</term>
<listitem>
<para>
The name of the configuration file to be checked. If not
specified, it defaults to <filename>/etc/named.conf</filename>.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1>
<title>RETURN VALUES</title>
<para><command>named-checkconf</command>
returns an exit status of 1 if
errors were detected and 0 otherwise.
</para>
</refsect1>
<refsect1>
<title>SEE ALSO</title>
<para><citerefentry>
<refentrytitle>named</refentrytitle><manvolnum>8</manvolnum>
</citerefentry>,
<citetitle>BIND 9 Administrator Reference Manual</citetitle>.
</para>
</refsect1>
<refsect1>
<title>AUTHOR</title>
<para><corpauthor>Internet Systems Consortium</corpauthor>
</para>
</refsect1>
</refentry><!--
- Local variables:
- mode: sgml
- End:
-->