named-checkconf.docbook revision c651f15b30f1dae5cc2f00878fb5da5b3a35a468
0b062f4990db5cc6db2fe3398926f71b92a67407Brian Wellington<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
8bbfb495a2c076642fb0b9327ae63e4f5c33d66aTinderbox User<!--
75c0816e8295e180f4bc7f10db3d0d880383bc1cMark Andrews - Copyright (C) 2004, 2005 Internet Systems Consortium, Inc. ("ISC")
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - Copyright (C) 2000-2002 Internet Software Consortium.
4a14ce5ba00ab7bc55c99ffdcf59c7a4ab902721Automatic Updater -
0b062f4990db5cc6db2fe3398926f71b92a67407Brian Wellington - Permission to use, copy, modify, and distribute this software for any
0b062f4990db5cc6db2fe3398926f71b92a67407Brian Wellington - purpose with or without fee is hereby granted, provided that the above
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - copyright notice and this permission notice appear in all copies.
8a66318e41ed14c5a88130e8c362610e8faa2121Mark Andrews -
8a66318e41ed14c5a88130e8c362610e8faa2121Mark Andrews - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
8a66318e41ed14c5a88130e8c362610e8faa2121Mark Andrews - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
8a66318e41ed14c5a88130e8c362610e8faa2121Mark Andrews - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
8a66318e41ed14c5a88130e8c362610e8faa2121Mark Andrews - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
8a66318e41ed14c5a88130e8c362610e8faa2121Mark Andrews - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
0b062f4990db5cc6db2fe3398926f71b92a67407Brian Wellington - PERFORMANCE OF THIS SOFTWARE.
ea94d370123a5892f6c47a97f21d1b28d44bb168Tinderbox User-->
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<!-- $Id: named-checkconf.docbook,v 1.10 2005/04/07 03:49:55 marka Exp $ -->
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<refentry>
e21a2904f02a03fa06b6db04d348f65fe9c67b2bMark Andrews <refentryinfo>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <date>June 14, 2000</date>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </refentryinfo>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <refmeta>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <refentrytitle><application>named-checkconf</application></refentrytitle>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <manvolnum>8</manvolnum>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <refmiscinfo>BIND9</refmiscinfo>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </refmeta>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
97e74139b19368e385a3564746d42db70879195eAutomatic Updater <refnamediv>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <refname><application>named-checkconf</application></refname>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <refpurpose>named configuration file syntax checking tool</refpurpose>
8bbfb495a2c076642fb0b9327ae63e4f5c33d66aTinderbox User </refnamediv>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <refsynopsisdiv>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <cmdsynopsis>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <command>named-checkconf</command>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <arg><option>-v</option></arg>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <arg><option>-j</option></arg>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <arg><option>-t <replaceable class="parameter">directory</replaceable></option></arg>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <arg choice="req">filename</arg>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <arg><option>-z</option></arg>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </cmdsynopsis>
8bbfb495a2c076642fb0b9327ae63e4f5c33d66aTinderbox User </refsynopsisdiv>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <refsect1>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <title>DESCRIPTION</title>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <command>named-checkconf</command> checks the syntax, but not
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein the semantics, of a named configuration file.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </refsect1>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater <refsect1>
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater <title>OPTIONS</title>
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater <variablelist>
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater <varlistentry>
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater <term>-t <replaceable class="parameter">directory</replaceable></term>
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater <listitem>
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater <para>
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater chroot to <filename>directory</filename> so that include
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater directives in the configuration file are processed as if
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater run by a similarly chrooted named.
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater </para>
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater </listitem>
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater </varlistentry>
be6c1c506161e6f45fcff5d0425f78801bc267c1Automatic Updater
be6c1c506161e6f45fcff5d0425f78801bc267c1Automatic Updater <varlistentry>
be6c1c506161e6f45fcff5d0425f78801bc267c1Automatic Updater <term>-v</term>
be6c1c506161e6f45fcff5d0425f78801bc267c1Automatic Updater <listitem>
be6c1c506161e6f45fcff5d0425f78801bc267c1Automatic Updater <para>
be6c1c506161e6f45fcff5d0425f78801bc267c1Automatic Updater Print the version of the <command>named-checkconf</command>
be6c1c506161e6f45fcff5d0425f78801bc267c1Automatic Updater program and exit.
be6c1c506161e6f45fcff5d0425f78801bc267c1Automatic Updater </para>
dba3c818ae00b10388d31703e86a28415db398acTinderbox User </listitem>
43b94483957d3168796a816ed86cf097518817dcTinderbox User </varlistentry>
be6c1c506161e6f45fcff5d0425f78801bc267c1Automatic Updater
8ec3c085233cedb22b05da36e2773c8f357a7e45Automatic Updater <varlistentry>
6ea2385360e9e2167e65f9286447da9eea189457Tinderbox User <term>-z</term>
6ea2385360e9e2167e65f9286447da9eea189457Tinderbox User <listitem>
6ea2385360e9e2167e65f9286447da9eea189457Tinderbox User <para>
6ea2385360e9e2167e65f9286447da9eea189457Tinderbox User Perform a check load the master zonefiles found in
6ea2385360e9e2167e65f9286447da9eea189457Tinderbox User <filename>named.conf</filename>.
6ea2385360e9e2167e65f9286447da9eea189457Tinderbox User </para>
6ea2385360e9e2167e65f9286447da9eea189457Tinderbox User </listitem>
6ea2385360e9e2167e65f9286447da9eea189457Tinderbox User </varlistentry>
6ea2385360e9e2167e65f9286447da9eea189457Tinderbox User
6ea2385360e9e2167e65f9286447da9eea189457Tinderbox User <varlistentry>
6ea2385360e9e2167e65f9286447da9eea189457Tinderbox User <term>-j</term>
6ea2385360e9e2167e65f9286447da9eea189457Tinderbox User <listitem>
6ea2385360e9e2167e65f9286447da9eea189457Tinderbox User <para>
6ea2385360e9e2167e65f9286447da9eea189457Tinderbox User When loading a zonefile read the journal if it exists.
6ea2385360e9e2167e65f9286447da9eea189457Tinderbox User </para>
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater </listitem>
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater </varlistentry>
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater <varlistentry>
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater <term>filename</term>
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater <listitem>
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater <para>
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater The name of the configuration file to be checked. If not
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater specified, it defaults to <filename>/etc/named.conf</filename>.
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater </para>
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater </listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </variablelist>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </refsect1>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <refsect1>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <title>RETURN VALUES</title>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <command>named-checkconf</command> returns an exit status of 1 if
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein errors were detected and 0 otherwise.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </refsect1>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <refsect1>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <title>SEE ALSO</title>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <citerefentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <refentrytitle>named</refentrytitle>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <manvolnum>8</manvolnum>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </citerefentry>,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <citetitle>BIND 9 Administrator Reference Manual</citetitle>.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </refsect1>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <refsect1>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <title>AUTHOR</title>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <corpauthor>Internet Systems Consortium</corpauthor>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </refsect1>
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater</refentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
60a900e83bab52c3f023be66654f3ab023172778Automatic Updater<!--
60a900e83bab52c3f023be66654f3ab023172778Automatic Updater - Local variables:
60a900e83bab52c3f023be66654f3ab023172778Automatic Updater - mode: sgml
60a900e83bab52c3f023be66654f3ab023172778Automatic Updater - End:
60a900e83bab52c3f023be66654f3ab023172778Automatic Updater-->
60a900e83bab52c3f023be66654f3ab023172778Automatic Updater
60a900e83bab52c3f023be66654f3ab023172778Automatic Updater