named-checkzone.docbook revision d0aebc5a55b6145297d94f8aee939852357c59fc
803b50652fd6ad81d04d18fc04332c8a94f8fe9aAndreas Gustafsson<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
75c0816e8295e180f4bc7f10db3d0d880383bc1cMark Andrews - Copyright (C) 2001 Internet Software Consortium.
803b50652fd6ad81d04d18fc04332c8a94f8fe9aAndreas Gustafsson - Permission to use, copy, modify, and distribute this software for any
803b50652fd6ad81d04d18fc04332c8a94f8fe9aAndreas Gustafsson - purpose with or without fee is hereby granted, provided that the above
803b50652fd6ad81d04d18fc04332c8a94f8fe9aAndreas Gustafsson - copyright notice and this permission notice appear in all copies.
8a66318e41ed14c5a88130e8c362610e8faa2121Mark Andrews - THE SOFTWARE IS PROVIDED "AS IS" AND INTERNET SOFTWARE CONSORTIUM
8a66318e41ed14c5a88130e8c362610e8faa2121Mark Andrews - DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL
8a66318e41ed14c5a88130e8c362610e8faa2121Mark Andrews - INTERNET SOFTWARE CONSORTIUM BE LIABLE FOR ANY SPECIAL, DIRECT,
8a66318e41ed14c5a88130e8c362610e8faa2121Mark Andrews - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING
8a66318e41ed14c5a88130e8c362610e8faa2121Mark Andrews - FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
8a66318e41ed14c5a88130e8c362610e8faa2121Mark Andrews - NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION
803b50652fd6ad81d04d18fc04332c8a94f8fe9aAndreas Gustafsson - WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<!-- $Id: named-checkzone.docbook,v 1.9 2004/01/07 05:27:17 marka Exp $ -->
e21a2904f02a03fa06b6db04d348f65fe9c67b2bMark Andrews <refentryinfo>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </refentryinfo>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <refentrytitle><application>named-checkzone</application></refentrytitle>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <refname><application>named-checkzone</application></refname>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <refpurpose>zone file validity checking tool</refpurpose>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <refsynopsisdiv>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <cmdsynopsis>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <arg><option>-c <replaceable class="parameter">class</replaceable></option></arg>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <arg><option>-n <replaceable class="parameter">mode</replaceable></option></arg>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <arg><option>-o <replaceable class="parameter">filename</replaceable></option></arg>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <arg><option>-t <replaceable class="parameter">directory</replaceable></option></arg>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <arg><option>-w <replaceable class="parameter">directory</replaceable></option></arg>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </cmdsynopsis>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </refsynopsisdiv>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <command>named-checkzone</command> checks the syntax and integrity of
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein a zone file. It performs the same checks as <command>named</command>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein does when loading a zone. This makes
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <command>named-checkzone</command> useful for checking zone
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein files before configuring them into a name server.
731cc132f22dbc9e0ecd7035dce314a61076d31bAutomatic Updater <variablelist>
731cc132f22dbc9e0ecd7035dce314a61076d31bAutomatic Updater <varlistentry>
ed4475f3f583f6137b4ff7fea775c5363a4fdb29Automatic Updater Enable debugging.
ed4475f3f583f6137b4ff7fea775c5363a4fdb29Automatic Updater </varlistentry>
ed4475f3f583f6137b4ff7fea775c5363a4fdb29Automatic Updater <varlistentry>
ed4475f3f583f6137b4ff7fea775c5363a4fdb29Automatic Updater Quiet mode - exit code only.
ed4475f3f583f6137b4ff7fea775c5363a4fdb29Automatic Updater </varlistentry>
ed4475f3f583f6137b4ff7fea775c5363a4fdb29Automatic Updater <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Print the version of the <command>named-checkzone</command>
ed4475f3f583f6137b4ff7fea775c5363a4fdb29Automatic Updater program and exit.
7329012471d165cd3dc4180ad2a0a43de91e7f01Mark Andrews </varlistentry>
7329012471d165cd3dc4180ad2a0a43de91e7f01Mark Andrews <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein When loading the zone file read the journal if it exists.
7329012471d165cd3dc4180ad2a0a43de91e7f01Mark Andrews <varlistentry>
7329012471d165cd3dc4180ad2a0a43de91e7f01Mark Andrews <term>-c <replaceable class="parameter">class</replaceable></term>
7329012471d165cd3dc4180ad2a0a43de91e7f01Mark Andrews Specify the class of the zone. If not specified "IN" is assumed.
7329012471d165cd3dc4180ad2a0a43de91e7f01Mark Andrews </varlistentry>
7329012471d165cd3dc4180ad2a0a43de91e7f01Mark Andrews <varlistentry>
7329012471d165cd3dc4180ad2a0a43de91e7f01Mark Andrews <term>-n <replaceable class="parameter">mode</replaceable></term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Specify whether NS records should be checked to see if they
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein are addresses. Possible modes are <command>"fail"</command>,
ed4475f3f583f6137b4ff7fea775c5363a4fdb29Automatic Updater </varlistentry>
ed4475f3f583f6137b4ff7fea775c5363a4fdb29Automatic Updater <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <term>-o <replaceable class="parameter">filename</replaceable></term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Write zone output to <filename>directory</filename>.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <term>-t <replaceable class="parameter">directory</replaceable></term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein chroot to <filename>directory</filename> so that include
d71e2e0c61df16ff37c9934c371a4a60c08974f7Mark Andrews directives in the configuration file are processed as if
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein run by a similarly chrooted named.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <term>-w <replaceable class="parameter">directory</replaceable></term>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein chdir to <filename>directory</filename> so that relative
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein filenames in master file $INCLUDE directives work. This
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein is similar to the directory clause in
d71e2e0c61df16ff37c9934c371a4a60c08974f7Mark Andrews </varlistentry>
f02216f5b390ff0a589fa080f29350fd7794bf5cMark Andrews <varlistentry>
f02216f5b390ff0a589fa080f29350fd7794bf5cMark Andrews Dump zone file in canonical format.
f02216f5b390ff0a589fa080f29350fd7794bf5cMark Andrews </varlistentry>
f02216f5b390ff0a589fa080f29350fd7794bf5cMark Andrews <varlistentry>
ed4475f3f583f6137b4ff7fea775c5363a4fdb29Automatic Updater The domain name of the zone being checked.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein The name of the zone file.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </variablelist>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <command>named-checkzone</command> returns an exit status of 1 if
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein errors were detected and 0 otherwise.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <citerefentry>
69f175fc57a578dd85c1548ed3f34284321f9d3aMark Andrews </citerefentry>,
69f175fc57a578dd85c1548ed3f34284321f9d3aMark Andrews <citetitle>BIND 9 Administrator Reference Manual</citetitle>.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <corpauthor>Internet Software Consortium</corpauthor>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - Local variables:
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - mode: sgml