named-checkzone.docbook revision bca7f81db58d4803fb6d8d352132445cf61eb1ac
ac4e70ff8955669341f435bc0a734a17c01af124Mark Andrews<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
6fe48fb46e53ffc37542853a1edb74cb481b7d94Automatic Updater<!--
229ea4644b3a7d9c7fdaa43888e7f55ba01e2ee3Automatic Updater - Copyright (C) 2001 Internet Software Consortium.
229ea4644b3a7d9c7fdaa43888e7f55ba01e2ee3Automatic Updater -
1167fc7904c5f0a472f8df207ac46dd52c7f1ec8Automatic Updater - Permission to use, copy, modify, and distribute this software for any
0c39b3ed9409ecb277d5e32fa763a4e4d6598df8Automatic Updater - purpose with or without fee is hereby granted, provided that the above
46da3117812814a29432a8d9a9ccf8acdbfdadceAutomatic Updater - copyright notice and this permission notice appear in all copies.
6fe48fb46e53ffc37542853a1edb74cb481b7d94Automatic Updater -
cd0aa2d941d1438fabb5337f1f38c49478edf71dAutomatic Updater - THE SOFTWARE IS PROVIDED "AS IS" AND INTERNET SOFTWARE CONSORTIUM
90ff38a0d8deaf5f9c2aa5916d99b2e572d28738Automatic Updater - DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington - IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL
ac4e70ff8955669341f435bc0a734a17c01af124Mark Andrews - INTERNET SOFTWARE CONSORTIUM BE LIABLE FOR ANY SPECIAL, DIRECT,
6c6a121295b30772cbf3dd75a51fb9d883051a0eAutomatic Updater - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington - FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
9cd5eb6fe0f26d65724b99216cb31dcdd12e4afdAutomatic Updater - NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION
e171a4137c6ba348957e61b7c4c3541493c0da02Automatic Updater - WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
e171a4137c6ba348957e61b7c4c3541493c0da02Automatic Updater-->
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews
e130ab53e992670e2a2ecf043976ac09f21358d1Automatic Updater<!-- $Id: named-checkzone.docbook,v 1.7 2002/07/11 05:36:12 marka Exp $ -->
3cc98b8ecedcbc8465f1cf2740b966b315662430Automatic Updater
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews<refentry>
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews <refentryinfo>
e171a4137c6ba348957e61b7c4c3541493c0da02Automatic Updater <date>June 13, 2000</date>
831f79c4310a7d38fc3475ccfff531b2b2535641Automatic Updater </refentryinfo>
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updater <refmeta>
efb0e886f18894a1d2489f1ad74ad14b579e11c7Mark Andrews <refentrytitle><application>named-checkzone</application></refentrytitle>
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updater <manvolnum>8</manvolnum>
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson <refmiscinfo>BIND9</refmiscinfo>
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updater </refmeta>
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updater
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson <refnamediv>
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updater <refname><application>named-checkzone</application></refname>
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updater <refpurpose>zone file validity checking tool</refpurpose>
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updater </refnamediv>
aa9c561961e9d877946ebaa8795fa2be054ab7bfEvan Hunt
e130ab53e992670e2a2ecf043976ac09f21358d1Automatic Updater <refsynopsisdiv>
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updater <cmdsynopsis>
aa9c561961e9d877946ebaa8795fa2be054ab7bfEvan Hunt <command>named-checkzone</command>
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updater <arg><option>-d</option></arg>
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updater <arg><option>-j</option></arg>
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updater <arg><option>-q</option></arg>
aa9c561961e9d877946ebaa8795fa2be054ab7bfEvan Hunt <arg><option>-v</option></arg>
e130ab53e992670e2a2ecf043976ac09f21358d1Automatic Updater <arg><option>-c <replaceable class="parameter">class</replaceable></option></arg>
2d2dc37599979c83495510f8af8d1756753aa2c5Automatic Updater <arg><option>-t <replaceable class="parameter">directory</replaceable></option></arg>
aa9c561961e9d877946ebaa8795fa2be054ab7bfEvan Hunt <arg><option>-w <replaceable class="parameter">directory</replaceable></option></arg>
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updater <arg choice="req">zonename</arg>
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updater <arg choice="req">filename</arg>
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updater </cmdsynopsis>
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updater </refsynopsisdiv>
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updater
cdfc81e048bd34c1d628380247bda6b80a89e20eAutomatic Updater <refsect1>
cdfc81e048bd34c1d628380247bda6b80a89e20eAutomatic Updater <title>DESCRIPTION</title>
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updater <para>
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updater <command>named-checkzone</command> checks the syntax and integrity of
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updater a zone file. It performs the same checks as <command>named</command>
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updater does when loading a zone. This makes
eabc9c3c07cd956d3c436bd7614cb162dabdda76Mark Andrews <command>named-checkzone</command> useful for checking zone
eabc9c3c07cd956d3c436bd7614cb162dabdda76Mark Andrews files before configuring them into a name server.
eabc9c3c07cd956d3c436bd7614cb162dabdda76Mark Andrews </para>
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington </refsect1>
9cd5eb6fe0f26d65724b99216cb31dcdd12e4afdAutomatic Updater
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews <refsect1>
6fe48fb46e53ffc37542853a1edb74cb481b7d94Automatic Updater <title>OPTIONS</title>
8e9f3b69914ee02a80b87c97b1f8093edb3e9ae0Automatic Updater
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews <variablelist>
930f6069e5aa157cf6987cdafd412f5757a5a558Automatic Updater <varlistentry>
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews <term>-d</term>
930f6069e5aa157cf6987cdafd412f5757a5a558Automatic Updater <listitem>
80faf1588895fd26490f82f95a7a1b771df1c324Automatic Updater <para>
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews Enable debugging.
6fe48fb46e53ffc37542853a1edb74cb481b7d94Automatic Updater </para>
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews </listitem>
930f6069e5aa157cf6987cdafd412f5757a5a558Automatic Updater </varlistentry>
693c4232dfdffaff672197d4b9fea944c64cf80aAutomatic Updater
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews <varlistentry>
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updater <term>-q</term>
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson <listitem>
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updater <para>
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updater Quiet mode - exit code only.
efb0e886f18894a1d2489f1ad74ad14b579e11c7Mark Andrews </para>
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updater </listitem>
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson </varlistentry>
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updater
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updater <varlistentry>
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson <term>-v</term>
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updater <listitem>
dd65eb1efb40b1c47d57963192bfc54873b219beAutomatic Updater <para>
dd65eb1efb40b1c47d57963192bfc54873b219beAutomatic Updater Print the version of the <command>named-checkzone</command>
78f3ed4bc2fcd3d270bfd599804f3b27a1db4d91Mark Andrews program and exit.
11af78f7dc35741bdab68dbab11b03daab005b28Automatic Updater </para>
11af78f7dc35741bdab68dbab11b03daab005b28Automatic Updater </listitem>
78f3ed4bc2fcd3d270bfd599804f3b27a1db4d91Mark Andrews </varlistentry>
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont
e130ab53e992670e2a2ecf043976ac09f21358d1Automatic Updater <varlistentry>
8ccd7da886e93cd490fcb6f4c4e98a6514f35820Automatic Updater <term>-j</term>
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont <listitem>
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews <para>
e130ab53e992670e2a2ecf043976ac09f21358d1Automatic Updater When loading the zone file read the journal if it exists.
a308b69ac66fadf66863484f301314d6e6a3f1d2Automatic Updater </para>
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews </listitem>
78f3ed4bc2fcd3d270bfd599804f3b27a1db4d91Mark Andrews
08e3b6797706a13054bad749dea04e94b514b8e7Automatic Updater <varlistentry>
dd65eb1efb40b1c47d57963192bfc54873b219beAutomatic Updater <term>-c <replaceable class="parameter">class</replaceable></term>
78f3ed4bc2fcd3d270bfd599804f3b27a1db4d91Mark Andrews <listitem>
78f3ed4bc2fcd3d270bfd599804f3b27a1db4d91Mark Andrews <para>
a308b69ac66fadf66863484f301314d6e6a3f1d2Automatic Updater Specify the class of the zone. If not specified "IN" is assumed.
a308b69ac66fadf66863484f301314d6e6a3f1d2Automatic Updater </para>
78f3ed4bc2fcd3d270bfd599804f3b27a1db4d91Mark Andrews </listitem>
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews </varlistentry>
6fe48fb46e53ffc37542853a1edb74cb481b7d94Automatic Updater
82447d835d3ff5c658749b4e9b4f66166407b3eaAutomatic Updater <varlistentry>
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews <term>-t <replaceable class="parameter">directory</replaceable></term>
0c39b3ed9409ecb277d5e32fa763a4e4d6598df8Automatic Updater <listitem>
0c39b3ed9409ecb277d5e32fa763a4e4d6598df8Automatic Updater <para>
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updater chroot to <filename>directory</filename> so that include
cdfc81e048bd34c1d628380247bda6b80a89e20eAutomatic Updater directives in the configuration file are processed as if
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updater run by a similarly chrooted named.
fe80a4909bf62b602feaf246866e9d29f7654194Automatic Updater </para>
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updater </listitem>
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updater </varlistentry>
fe80a4909bf62b602feaf246866e9d29f7654194Automatic Updater
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updater <varlistentry>
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updater <term>-w <replaceable class="parameter">directory</replaceable></term>
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson <listitem>
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updater <para>
aa1d397c4736cd86540555193d71e55fa3b37b2aMark Andrews chdir to <filename>directory</filename> so that relative
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson filenames in master file $INCLUDE directives work. This
dd65eb1efb40b1c47d57963192bfc54873b219beAutomatic Updater is similar to the directory clause in
dd65eb1efb40b1c47d57963192bfc54873b219beAutomatic Updater <filename>named.conf</filename>.
dd65eb1efb40b1c47d57963192bfc54873b219beAutomatic Updater </para>
133e6d43fa82e80d3798be4de00f4540f485ec6cAutomatic Updater </listitem>
133e6d43fa82e80d3798be4de00f4540f485ec6cAutomatic Updater </varlistentry>
133e6d43fa82e80d3798be4de00f4540f485ec6cAutomatic Updater
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updater <varlistentry>
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson <term>zonename</term>
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updater <listitem>
4104e236f71eb5108fcfda6711878a97f6f4a8e7Automatic Updater <para>
8711e5c73ca872d59810760af0332194cbdd619bAutomatic Updater The domain name of the zone being checked.
229ea4644b3a7d9c7fdaa43888e7f55ba01e2ee3Automatic Updater </para>
0ce87e5749aabb8eef1e0a37e4bd6e6ffa1d7196Automatic Updater </listitem>
6fe48fb46e53ffc37542853a1edb74cb481b7d94Automatic Updater </varlistentry>
229ea4644b3a7d9c7fdaa43888e7f55ba01e2ee3Automatic Updater
765c97d56ccddc9d7904c7d9ff2e2d825d9687e4Automatic Updater <varlistentry>
3e5340279d8875d136a4dd815cccad0044aa2644Automatic Updater <term>filename</term>
8ccd7da886e93cd490fcb6f4c4e98a6514f35820Automatic Updater <listitem>
da82e232161d67b77df2d67898bdac693f647be1Automatic Updater <para>
e130ab53e992670e2a2ecf043976ac09f21358d1Automatic Updater The name of the zone file.
d145b64cacc8d9cda51f9924ec70cd4661c3e2cfAutomatic Updater </para>
8711e5c73ca872d59810760af0332194cbdd619bAutomatic Updater </listitem>
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater </varlistentry>
59528addd704f8d5757b54e540520f74e588a7c7Automatic Updater
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updater </variablelist>
da82e232161d67b77df2d67898bdac693f647be1Automatic Updater
e628576d3b3d91c8954679077f4c208f1e43b433Automatic Updater </refsect1>
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater <refsect1>
bc0a53583d92309bebcf93c408e2f3247ebd3d3cAutomatic Updater <title>RETURN VALUES</title>
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater <para>
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater <command>named-checkzone</command> returns an exit status of 1 if
59528addd704f8d5757b54e540520f74e588a7c7Automatic Updater errors were detected and 0 otherwise.
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater </refsect1>
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater
7f79131f9a8e804b93c57f3c679065cce878b726Automatic Updater <refsect1>
59528addd704f8d5757b54e540520f74e588a7c7Automatic Updater <title>SEE ALSO</title>
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater <para>
3f616e6f846be57b1717c6beaba0f74de9d5a7c6Automatic Updater <citerefentry>
da82e232161d67b77df2d67898bdac693f647be1Automatic Updater <refentrytitle>named</refentrytitle>
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater <manvolnum>8</manvolnum>
19b3dc94bce93fa76bd7e066f9298630dbc9dcb4Automatic Updater </citerefentry>,
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater <citetitle>RFC 1035</citetitle>,
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updater <citetitle>BIND 9 Administrator Reference Manual</citetitle>.
7f94d9a8162c9a96b56e66176702b66e79d8e1a2Automatic Updater </para>
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater </refsect1>
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater
f7a71eef29bcbf892270460269c79664f600cffdAutomatic Updater <refsect1>
e130ab53e992670e2a2ecf043976ac09f21358d1Automatic Updater <title>AUTHOR</title>
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater <para>
71bd43eebd9d6e42dbcae62b730f5b6508d5acd8Automatic Updater <corpauthor>Internet Software Consortium</corpauthor>
82447d835d3ff5c658749b4e9b4f66166407b3eaAutomatic Updater </para>
7262eb86f2b465822206122921e2f357218f0cfdAutomatic Updater </refsect1>
96ea71632887c58a9d00f47eb318bf76b35903c3Mark Andrews
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater</refentry>
9cd5eb6fe0f26d65724b99216cb31dcdd12e4afdAutomatic Updater
bbb069be941f649228760edcc241122933c066d2Automatic Updater<!--
9cd5eb6fe0f26d65724b99216cb31dcdd12e4afdAutomatic Updater - Local variables:
4cda4fd158d6ded5586bacea8c388445d99611eaAutomatic Updater - mode: sgml
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews - End:
9cd5eb6fe0f26d65724b99216cb31dcdd12e4afdAutomatic Updater-->
80faf1588895fd26490f82f95a7a1b771df1c324Automatic Updater
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews