named-checkzone.docbook revision 339d2a4d4b3b2e0be9e43afec6e84fe468edfaee
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
11e9368a226272085c337e9e74b79808c16fbdbaTinderbox User "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
6a42ab64276ff832a47e009be1208f7c7d4da22dAutomatic Updater [<!ENTITY mdash "—">]>
4a14ce5ba00ab7bc55c99ffdcf59c7a4ab902721Automatic Updater - Copyright (C) 2004-2007, 2009-2011 Internet Systems Consortium, Inc. ("ISC")
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews - Copyright (C) 2000-2002 Internet Software Consortium.
6a42ab64276ff832a47e009be1208f7c7d4da22dAutomatic Updater - Permission to use, copy, modify, and/or distribute this software for any
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews - purpose with or without fee is hereby granted, provided that the above
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews - copyright notice and this permission notice appear in all copies.
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews - PERFORMANCE OF THIS SOFTWARE.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<!-- $Id: named-checkzone.docbook,v 1.43 2011/12/09 23:47:02 tbox Exp $ -->
cd32f419a8a5432fbb139f56ee73cbf68b9350ccTinderbox User <refentryinfo>
50066670817cdf9e86c832066d73715232b29680Tinderbox User </refentryinfo>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews <refentrytitle><application>named-checkzone</application></refentrytitle>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <refname><application>named-checkzone</application></refname>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <refname><application>named-compilezone</application></refname>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <refpurpose>zone file validity checking or converting tool</refpurpose>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews <refsynopsisdiv>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <cmdsynopsis>
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User <arg><option>-c <replaceable class="parameter">class</replaceable></option></arg>
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User <arg><option>-f <replaceable class="parameter">format</replaceable></option></arg>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews <arg><option>-F <replaceable class="parameter">format</replaceable></option></arg>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <arg><option>-i <replaceable class="parameter">mode</replaceable></option></arg>
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User <arg><option>-k <replaceable class="parameter">mode</replaceable></option></arg>
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User <arg><option>-m <replaceable class="parameter">mode</replaceable></option></arg>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews <arg><option>-M <replaceable class="parameter">mode</replaceable></option></arg>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <arg><option>-n <replaceable class="parameter">mode</replaceable></option></arg>
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User <arg><option>-o <replaceable class="parameter">filename</replaceable></option></arg>
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User <arg><option>-r <replaceable class="parameter">mode</replaceable></option></arg>
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User <arg><option>-s <replaceable class="parameter">style</replaceable></option></arg>
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User <arg><option>-S <replaceable class="parameter">mode</replaceable></option></arg>
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User <arg><option>-t <replaceable class="parameter">directory</replaceable></option></arg>
481870b95fee976541f4fe455c0ef2dbeab3ec7aTinderbox User <arg><option>-w <replaceable class="parameter">directory</replaceable></option></arg>
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User <arg><option>-W <replaceable class="parameter">mode</replaceable></option></arg>
e839bf134fb138920d4833cf05cb8b8906787a8dAutomatic Updater </cmdsynopsis>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <cmdsynopsis>
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User <arg><option>-c <replaceable class="parameter">class</replaceable></option></arg>
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User <arg><option>-C <replaceable class="parameter">mode</replaceable></option></arg>
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User <arg><option>-f <replaceable class="parameter">format</replaceable></option></arg>
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater <arg><option>-F <replaceable class="parameter">format</replaceable></option></arg>
795a316ec568b2470aab18b9481443966047652eAutomatic Updater <arg><option>-i <replaceable class="parameter">mode</replaceable></option></arg>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <arg><option>-k <replaceable class="parameter">mode</replaceable></option></arg>
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User <arg><option>-m <replaceable class="parameter">mode</replaceable></option></arg>
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User <arg><option>-n <replaceable class="parameter">mode</replaceable></option></arg>
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User <arg><option>-r <replaceable class="parameter">mode</replaceable></option></arg>
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User <arg><option>-s <replaceable class="parameter">style</replaceable></option></arg>
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User <arg><option>-t <replaceable class="parameter">directory</replaceable></option></arg>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <arg><option>-w <replaceable class="parameter">directory</replaceable></option></arg>
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User <arg><option>-W <replaceable class="parameter">mode</replaceable></option></arg>
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User <arg choice="req"><option>-o <replaceable class="parameter">filename</replaceable></option></arg>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User </cmdsynopsis>
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User </refsynopsisdiv>
6478b87fd23bcd3ab74c25b261021fe19a239c4fTinderbox User checks the syntax and integrity of a zone file. It performs the
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater same checks as <command>named</command> does when loading a
9d557856c2a19ec95ee73245f60a92f8675cf5baTinderbox User zone. This makes <command>named-checkzone</command> useful for
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User checking zone files before configuring them into a name server.
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User <command>named-compilezone</command> is similar to
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User <command>named-checkzone</command>, but it always dumps the
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User zone contents to a specified file in a specified format.
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User Additionally, it applies stricter check levels by default,
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User since the dump output will be used as an actual zone file
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User When manually specified otherwise, the check levels must at
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews least be as strict as those specified in the
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User <variablelist>
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User <varlistentry>
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User Enable debugging.
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User </varlistentry>
6f1205897504b8f50b1785975482c995888dd630Tinderbox User <varlistentry>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews Print the usage summary and exit.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User </varlistentry>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews <varlistentry>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User Quiet mode - exit code only.
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews </varlistentry>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <varlistentry>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User Print the version of the <command>named-checkzone</command>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User program and exit.
b27ce68bae92006e2ad7a9b75602c6385e529c3bAutomatic Updater </varlistentry>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews <varlistentry>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews When loading the zone file read the journal if it exists.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User </varlistentry>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <varlistentry>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews <term>-c <replaceable class="parameter">class</replaceable></term>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User Specify the class of the zone. If not specified, "IN" is assumed.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User </varlistentry>
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews <varlistentry>
163af735c2082a024167be111d27bd5b5ff4f462Automatic Updater <term>-i <replaceable class="parameter">mode</replaceable></term>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User Perform post-load zone integrity checks. Possible modes are
cd32f419a8a5432fbb139f56ee73cbf68b9350ccTinderbox User Mode <command>"full"</command> checks that MX records
50066670817cdf9e86c832066d73715232b29680Tinderbox User refer to A or AAAA record (both in-zone and out-of-zone
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews hostnames). Mode <command>"local"</command> only
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews checks MX records which refer to in-zone hostnames.
f9aef05653eeb454c489d5bd2bde6daab774ad4aTinderbox User Mode <command>"full"</command> checks that SRV records
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews refer to A or AAAA record (both in-zone and out-of-zone
50066670817cdf9e86c832066d73715232b29680Tinderbox User hostnames). Mode <command>"local"</command> only
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews checks SRV records which refer to in-zone hostnames.
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews Mode <command>"full"</command> checks that delegation NS
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt records refer to A or AAAA record (both in-zone and out-of-zone
582f8b9a8d170a80ef67475bddb8ad5cf7cd7cadMark Andrews hostnames). It also checks that glue address records
922312472e2e05ebc64993d465999c5351b83036Automatic Updater in the zone match those advertised by the child.