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