named-checkzone.html revision 101c34c3f7fd2c86668d37bf7f921c5112204c07
11e9368a226272085c337e9e74b79808c16fbdbaTinderbox User - Copyright (C) 2004, 2005 Internet Systems Consortium, Inc. ("ISC")
75c0816e8295e180f4bc7f10db3d0d880383bc1cMark Andrews - Copyright (C) 2001, 2002 Internet Software Consortium.
4a14ce5ba00ab7bc55c99ffdcf59c7a4ab902721Automatic Updater - Permission to use, copy, modify, and distribute this software for any
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - purpose with or without fee is hereby granted, provided that the above
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - copyright notice and this permission notice appear in all copies.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - PERFORMANCE OF THIS SOFTWARE.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<!-- $Id: named-checkzone.html,v 1.17 2005/01/11 01:36:35 marka Exp $ -->
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein>named-checkzone</TITLE
cd32f419a8a5432fbb139f56ee73cbf68b9350ccTinderbox UserNAME="GENERATOR"
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob AusteinCONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob AusteinCLASS="REFENTRY"
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob AusteinBGCOLOR="#FFFFFF"
cd32f419a8a5432fbb139f56ee73cbf68b9350ccTinderbox UserTEXT="#000000"
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob AusteinLINK="#0000FF"
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob AusteinVLINK="#840084"
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob AusteinALINK="#0000FF"
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob AusteinCLASS="APPLICATION"
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein>named-checkzone</SPAN
cd32f419a8a5432fbb139f56ee73cbf68b9350ccTinderbox UserCLASS="REFNAMEDIV"
2fa992d017c027173a47c834db88bef10df453c0Tinderbox UserCLASS="APPLICATION"
2fa992d017c027173a47c834db88bef10df453c0Tinderbox User>named-checkzone</SPAN
2fa992d017c027173a47c834db88bef10df453c0Tinderbox User> -- zone file validity checking tool</DIV
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox UserCLASS="REFSYNOPSISDIV"
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein>Synopsis</H2
cd32f419a8a5432fbb139f56ee73cbf68b9350ccTinderbox UserCLASS="COMMAND"
2fa992d017c027173a47c834db88bef10df453c0Tinderbox User>named-checkzone</B
2fa992d017c027173a47c834db88bef10df453c0Tinderbox UserCLASS="OPTION"
2fa992d017c027173a47c834db88bef10df453c0Tinderbox UserCLASS="OPTION"
2fa992d017c027173a47c834db88bef10df453c0Tinderbox UserCLASS="OPTION"
2fa992d017c027173a47c834db88bef10df453c0Tinderbox UserCLASS="OPTION"
2fa992d017c027173a47c834db88bef10df453c0Tinderbox UserCLASS="OPTION"
2fa992d017c027173a47c834db88bef10df453c0Tinderbox UserCLASS="REPLACEABLE"
2fa992d017c027173a47c834db88bef10df453c0Tinderbox UserCLASS="OPTION"
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox UserCLASS="REPLACEABLE"
a17033f2c453688fde9719bced70b44553431759Tinderbox UserCLASS="OPTION"
a17033f2c453688fde9719bced70b44553431759Tinderbox UserCLASS="REPLACEABLE"
a17033f2c453688fde9719bced70b44553431759Tinderbox UserCLASS="OPTION"
a17033f2c453688fde9719bced70b44553431759Tinderbox UserCLASS="REPLACEABLE"
a17033f2c453688fde9719bced70b44553431759Tinderbox User>filename</VAR
a17033f2c453688fde9719bced70b44553431759Tinderbox UserCLASS="OPTION"
a17033f2c453688fde9719bced70b44553431759Tinderbox UserCLASS="REPLACEABLE"
a17033f2c453688fde9719bced70b44553431759Tinderbox User>directory</VAR
a17033f2c453688fde9719bced70b44553431759Tinderbox UserCLASS="OPTION"
a17033f2c453688fde9719bced70b44553431759Tinderbox UserCLASS="REPLACEABLE"
a17033f2c453688fde9719bced70b44553431759Tinderbox User>directory</VAR
a17033f2c453688fde9719bced70b44553431759Tinderbox UserCLASS="OPTION"
a17033f2c453688fde9719bced70b44553431759Tinderbox UserCLASS="OPTION"
a17033f2c453688fde9719bced70b44553431759Tinderbox UserCLASS="REPLACEABLE"
a17033f2c453688fde9719bced70b44553431759Tinderbox User>] {zonename} {filename}</P
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox UserCLASS="REFSECT1"
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox User>DESCRIPTION</H2
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox UserCLASS="COMMAND"
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox User>named-checkzone</B
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox User> checks the syntax and integrity of
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox User a zone file. It performs the same checks as <B
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox UserCLASS="COMMAND"
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox User does when loading a zone. This makes
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox UserCLASS="COMMAND"
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox User>named-checkzone</B
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox User> useful for checking zone
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox User files before configuring them into a name server.
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox UserCLASS="REFSECT1"
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox UserCLASS="VARIABLELIST"
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox User> Enable debugging.
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox User> Quiet mode - exit code only.
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox User> Print the version of the <B
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox UserCLASS="COMMAND"
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox User>named-checkzone</B
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox User program and exit.
def82e8de9ff45e29ab21e5aba9a39539138c1f4Tinderbox User> When loading the zone file read the journal if it exists.
a3ff24aaa545c45b8c581b2127d02d735aff8881Tinderbox UserCLASS="REPLACEABLE"
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox User> Specify the class of the zone. If not specified "IN" is assumed.
def82e8de9ff45e29ab21e5aba9a39539138c1f4Tinderbox UserCLASS="REPLACEABLE"
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox UserCLASS="COMMAND"
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox User>"check-name"</B
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox User> checks with the specified failure mode.
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox User Possible modes are <B
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox UserCLASS="COMMAND"
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox UserCLASS="COMMAND"
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox User> (default) and
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox UserCLASS="COMMAND"
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox UserCLASS="REPLACEABLE"
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox User> Specify whether NS records should be checked to see if they
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox User are addresses. Possible modes are <B
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox UserCLASS="COMMAND"
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox UserCLASS="COMMAND"
a3ff24aaa545c45b8c581b2127d02d735aff8881Tinderbox User> (default) and
a3ff24aaa545c45b8c581b2127d02d735aff8881Tinderbox UserCLASS="COMMAND"
d5ece58e3bb75eb2dff7802f5ce9904dc4dce05fTinderbox UserCLASS="REPLACEABLE"
d5ece58e3bb75eb2dff7802f5ce9904dc4dce05fTinderbox User>filename</VAR
d5ece58e3bb75eb2dff7802f5ce9904dc4dce05fTinderbox User> Write zone output to <TT
d5ece58e3bb75eb2dff7802f5ce9904dc4dce05fTinderbox UserCLASS="FILENAME"
d5ece58e3bb75eb2dff7802f5ce9904dc4dce05fTinderbox User>directory</TT
11e9368a226272085c337e9e74b79808c16fbdbaTinderbox UserCLASS="REPLACEABLE"
11e9368a226272085c337e9e74b79808c16fbdbaTinderbox User>directory</VAR
11e9368a226272085c337e9e74b79808c16fbdbaTinderbox User> chroot to <TT
11e9368a226272085c337e9e74b79808c16fbdbaTinderbox UserCLASS="FILENAME"
11e9368a226272085c337e9e74b79808c16fbdbaTinderbox User>directory</TT
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox User> so that include
2fa992d017c027173a47c834db88bef10df453c0Tinderbox User directives in the configuration file are processed as if
2fa992d017c027173a47c834db88bef10df453c0Tinderbox User run by a similarly chrooted named.
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox UserCLASS="REPLACEABLE"
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox User>directory</VAR
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox User> chdir to <TT
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox UserCLASS="FILENAME"
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox User>directory</TT
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox User> so that relative
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox User filenames in master file $INCLUDE directives work. This
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox User is similar to the directory clause in
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox UserCLASS="FILENAME"
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox User> Dump zone file in canonical format.
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox UserCLASS="REPLACEABLE"
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox User> Specify whether to check for non-terminal wildcards.
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox User Non-terminal wildcards are almost always the result of a
daf4204f82af39a71de8be039c2070aa605145a9Tinderbox User failure to understand the wildcard matching algorithm (RFC 1034).
daf4204f82af39a71de8be039c2070aa605145a9Tinderbox User Possible modes are <B
daf4204f82af39a71de8be039c2070aa605145a9Tinderbox UserCLASS="COMMAND"
369963ad26cef09c3839d76c74c2d856f91be27aTinderbox User> (default) and
369963ad26cef09c3839d76c74c2d856f91be27aTinderbox UserCLASS="COMMAND"
369963ad26cef09c3839d76c74c2d856f91be27aTinderbox User> The domain name of the zone being checked.
ebca35d493a0f74b0fb3371b7f19ef80f99f156cTinderbox User> The name of the zone file.
88a2182a1ad4fc7af07272af6b05b74db7f28e52Tinderbox UserCLASS="REFSECT1"
88a2182a1ad4fc7af07272af6b05b74db7f28e52Tinderbox User>RETURN VALUES</H2
25ae0fd27c7f65d235511e9b20f97f6ba92a14cfTinderbox UserCLASS="COMMAND"
25ae0fd27c7f65d235511e9b20f97f6ba92a14cfTinderbox User>named-checkzone</B
25ae0fd27c7f65d235511e9b20f97f6ba92a14cfTinderbox User> returns an exit status of 1 if
25ae0fd27c7f65d235511e9b20f97f6ba92a14cfTinderbox User errors were detected and 0 otherwise.
2fa992d017c027173a47c834db88bef10df453c0Tinderbox UserCLASS="REFSECT1"
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox UserCLASS="CITEREFENTRY"
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox UserCLASS="REFENTRYTITLE"
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox UserCLASS="CITETITLE"
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox UserCLASS="CITETITLE"
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox User>BIND 9 Administrator Reference Manual</I
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox UserCLASS="REFSECT1"
eaaf00efc02fdd4965f747afb51f881ac5a389d2Tinderbox User> Internet Systems Consortium