named-checkconf.docbook revision 17cb8353e999e3294e6619613f401af3f7b1540c
ad127d839d2e7aa542939a8a336691407e23397eMark Andrews<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
9b20c5d7ff43224f60c4f8049fa2e4fef9d374f0Tinderbox User - Copyright (C) 2004 Internet Systems Consortium, Inc. ("ISC")
ad127d839d2e7aa542939a8a336691407e23397eMark Andrews - Copyright (C) 2001, 2002 Internet Software Consortium.
ad127d839d2e7aa542939a8a336691407e23397eMark Andrews - Permission to use, copy, modify, and distribute this software for any
9b20c5d7ff43224f60c4f8049fa2e4fef9d374f0Tinderbox User - purpose with or without fee is hereby granted, provided that the above
ad127d839d2e7aa542939a8a336691407e23397eMark Andrews - copyright notice and this permission notice appear in all copies.
9b20c5d7ff43224f60c4f8049fa2e4fef9d374f0Tinderbox User - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
ad127d839d2e7aa542939a8a336691407e23397eMark Andrews - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
ad127d839d2e7aa542939a8a336691407e23397eMark Andrews - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
ad127d839d2e7aa542939a8a336691407e23397eMark Andrews - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
ad127d839d2e7aa542939a8a336691407e23397eMark Andrews - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
ad127d839d2e7aa542939a8a336691407e23397eMark Andrews - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
ad127d839d2e7aa542939a8a336691407e23397eMark Andrews - PERFORMANCE OF THIS SOFTWARE.
ad127d839d2e7aa542939a8a336691407e23397eMark Andrews<!-- $Id: named-checkconf.docbook,v 1.9 2004/06/03 02:22:34 marka Exp $ -->
ad127d839d2e7aa542939a8a336691407e23397eMark Andrews <refentryinfo>
ad127d839d2e7aa542939a8a336691407e23397eMark Andrews </refentryinfo>
ad127d839d2e7aa542939a8a336691407e23397eMark Andrews <refentrytitle><application>named-checkconf</application></refentrytitle>
ad127d839d2e7aa542939a8a336691407e23397eMark Andrews <refnamediv>
ad127d839d2e7aa542939a8a336691407e23397eMark Andrews <refname><application>named-checkconf</application></refname>
6f1205897504b8f50b1785975482c995888dd630Tinderbox User <refpurpose>named configuration file syntax checking tool</refpurpose>
ad127d839d2e7aa542939a8a336691407e23397eMark Andrews </refnamediv>
ad127d839d2e7aa542939a8a336691407e23397eMark Andrews <refsynopsisdiv>
ad127d839d2e7aa542939a8a336691407e23397eMark Andrews <cmdsynopsis>
6f1205897504b8f50b1785975482c995888dd630Tinderbox User <arg><option>-t <replaceable class="parameter">directory</replaceable></option></arg>
ad127d839d2e7aa542939a8a336691407e23397eMark Andrews </cmdsynopsis>
ad127d839d2e7aa542939a8a336691407e23397eMark Andrews </refsynopsisdiv>
6ea2385360e9e2167e65f9286447da9eea189457Tinderbox User <command>named-checkconf</command> checks the syntax, but not
6ea2385360e9e2167e65f9286447da9eea189457Tinderbox User the semantics, of a named configuration file.
6ea2385360e9e2167e65f9286447da9eea189457Tinderbox User <variablelist>
6ea2385360e9e2167e65f9286447da9eea189457Tinderbox User <varlistentry>
6ea2385360e9e2167e65f9286447da9eea189457Tinderbox User <term>-t <replaceable class="parameter">directory</replaceable></term>
ad127d839d2e7aa542939a8a336691407e23397eMark Andrews chroot to <filename>directory</filename> so that include
ad127d839d2e7aa542939a8a336691407e23397eMark Andrews directives in the configuration file are processed as if
ad127d839d2e7aa542939a8a336691407e23397eMark Andrews run by a similarly chrooted named.
ad127d839d2e7aa542939a8a336691407e23397eMark Andrews </varlistentry>
ad127d839d2e7aa542939a8a336691407e23397eMark Andrews <varlistentry>
ad127d839d2e7aa542939a8a336691407e23397eMark Andrews Print the version of the <command>named-checkconf</command>
ad127d839d2e7aa542939a8a336691407e23397eMark Andrews program and exit.
ad127d839d2e7aa542939a8a336691407e23397eMark Andrews </varlistentry>
ad127d839d2e7aa542939a8a336691407e23397eMark Andrews <varlistentry>
6f1205897504b8f50b1785975482c995888dd630Tinderbox User Perform a check load the master zonefiles found in
ad127d839d2e7aa542939a8a336691407e23397eMark Andrews </varlistentry>
ad127d839d2e7aa542939a8a336691407e23397eMark Andrews <varlistentry>
ad127d839d2e7aa542939a8a336691407e23397eMark Andrews When loading a zonefile read the journal if it exists.
ad127d839d2e7aa542939a8a336691407e23397eMark Andrews </varlistentry>
ad127d839d2e7aa542939a8a336691407e23397eMark Andrews <varlistentry>
ad127d839d2e7aa542939a8a336691407e23397eMark Andrews The name of the configuration file to be checked. If not
ad127d839d2e7aa542939a8a336691407e23397eMark Andrews specified, it defaults to <filename>/etc/named.conf</filename>.
ad127d839d2e7aa542939a8a336691407e23397eMark Andrews </varlistentry>
ad127d839d2e7aa542939a8a336691407e23397eMark Andrews </variablelist>
ad127d839d2e7aa542939a8a336691407e23397eMark Andrews <command>named-checkconf</command> returns an exit status of 1 if
ad127d839d2e7aa542939a8a336691407e23397eMark Andrews errors were detected and 0 otherwise.
ad127d839d2e7aa542939a8a336691407e23397eMark Andrews <citerefentry>
ad127d839d2e7aa542939a8a336691407e23397eMark Andrews </citerefentry>,
ad127d839d2e7aa542939a8a336691407e23397eMark Andrews <citetitle>BIND 9 Administrator Reference Manual</citetitle>.
ad127d839d2e7aa542939a8a336691407e23397eMark Andrews <corpauthor>Internet Systems Consortium</corpauthor>