named-checkconf.docbook revision e9359db5e958bf05f9b9c5fe3c27d533f0f05550
7c74e180c206e6ed99e8beb820da5f399d845c3eDavid Lawrence<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
40f53fa8d9c6a4fc38c0014495e7a42b08f52481David Lawrence<!--
7c74e180c206e6ed99e8beb820da5f399d845c3eDavid Lawrence - Copyright (C) 2001 Internet Software Consortium.
7c74e180c206e6ed99e8beb820da5f399d845c3eDavid Lawrence -
7c74e180c206e6ed99e8beb820da5f399d845c3eDavid Lawrence - Permission to use, copy, modify, and distribute this software for any
40f53fa8d9c6a4fc38c0014495e7a42b08f52481David Lawrence - purpose with or without fee is hereby granted, provided that the above
15a44745412679c30a6d022733925af70a38b715David Lawrence - copyright notice and this permission notice appear in all copies.
15a44745412679c30a6d022733925af70a38b715David Lawrence -
15a44745412679c30a6d022733925af70a38b715David Lawrence - THE SOFTWARE IS PROVIDED "AS IS" AND INTERNET SOFTWARE CONSORTIUM
15a44745412679c30a6d022733925af70a38b715David Lawrence - DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL
15a44745412679c30a6d022733925af70a38b715David Lawrence - IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL
15a44745412679c30a6d022733925af70a38b715David Lawrence - INTERNET SOFTWARE CONSORTIUM BE LIABLE FOR ANY SPECIAL, DIRECT,
15a44745412679c30a6d022733925af70a38b715David Lawrence - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING
15a44745412679c30a6d022733925af70a38b715David Lawrence - FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
9c3531d72aeaad6c5f01efe6a1c82023e1379e4dDavid Lawrence - NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION
866d106459313499d0ca7bfccb4b2d23d5e4377cDavid Lawrence - WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
866d106459313499d0ca7bfccb4b2d23d5e4377cDavid Lawrence-->
866d106459313499d0ca7bfccb4b2d23d5e4377cDavid Lawrence
866d106459313499d0ca7bfccb4b2d23d5e4377cDavid Lawrence<!-- $Id: named-checkconf.docbook,v 1.6 2002/07/11 04:49:25 marka Exp $ -->
7c74e180c206e6ed99e8beb820da5f399d845c3eDavid Lawrence
9ceaa92a8ca8a0270ba296d44599e94d95033759Andreas Gustafsson<refentry>
ea31416b4fcdf23732355a8002f93f29e3b3d2dbAndreas Gustafsson <refentryinfo>
866d106459313499d0ca7bfccb4b2d23d5e4377cDavid Lawrence <date>June 14, 2000</date>
64e41159a919b0711321fe688ca5da4f4d1b7d80Bob Halley </refentryinfo>
a5d43b72413db3edd6b36a58f9bdf2cf6ff692f2Bob Halley
a5d43b72413db3edd6b36a58f9bdf2cf6ff692f2Bob Halley <refmeta>
a5d43b72413db3edd6b36a58f9bdf2cf6ff692f2Bob Halley <refentrytitle><application>named-checkconf</application></refentrytitle>
a5d43b72413db3edd6b36a58f9bdf2cf6ff692f2Bob Halley <manvolnum>8</manvolnum>
a5d43b72413db3edd6b36a58f9bdf2cf6ff692f2Bob Halley <refmiscinfo>BIND9</refmiscinfo>
ccdac53c027e8964753b36c4d8c7b0e98af501c2Michael Graff </refmeta>
ccdac53c027e8964753b36c4d8c7b0e98af501c2Michael Graff
ccdac53c027e8964753b36c4d8c7b0e98af501c2Michael Graff <refnamediv>
ccdac53c027e8964753b36c4d8c7b0e98af501c2Michael Graff <refname><application>named-checkconf</application></refname>
ccdac53c027e8964753b36c4d8c7b0e98af501c2Michael Graff <refpurpose>named configuration file syntax checking tool</refpurpose>
ccdac53c027e8964753b36c4d8c7b0e98af501c2Michael Graff </refnamediv>
ccdac53c027e8964753b36c4d8c7b0e98af501c2Michael Graff
3d776d762914d1b675b4fd49728ce353ccf6f77eBrian Wellington <refsynopsisdiv>
ccdac53c027e8964753b36c4d8c7b0e98af501c2Michael Graff <cmdsynopsis>
75a4dd0d377dca2f85cea44e28bf110314c1fe8cDavid Lawrence <command>named-checkconf</command>
75a4dd0d377dca2f85cea44e28bf110314c1fe8cDavid Lawrence <arg><option>-v</option></arg>
75a4dd0d377dca2f85cea44e28bf110314c1fe8cDavid Lawrence <arg><option>-m</option></arg>
75a4dd0d377dca2f85cea44e28bf110314c1fe8cDavid Lawrence <arg><option>-t <replaceable class="parameter">directory</replaceable></option></arg>
75a4dd0d377dca2f85cea44e28bf110314c1fe8cDavid Lawrence <arg choice="req">filename</arg>
91306d962f9d147d94b82fb14edb28f8d907cae7Andreas Gustafsson <arg><option>-z</option></arg>
91306d962f9d147d94b82fb14edb28f8d907cae7Andreas Gustafsson </cmdsynopsis>
91306d962f9d147d94b82fb14edb28f8d907cae7Andreas Gustafsson </refsynopsisdiv>
91306d962f9d147d94b82fb14edb28f8d907cae7Andreas Gustafsson
91306d962f9d147d94b82fb14edb28f8d907cae7Andreas Gustafsson <refsect1>
e893dce91279d7313a579f72caae3941f6dc5a27David Lawrence <title>DESCRIPTION</title>
e893dce91279d7313a579f72caae3941f6dc5a27David Lawrence <para>
e893dce91279d7313a579f72caae3941f6dc5a27David Lawrence <command>named-checkconf</command> checks the syntax, but not
e893dce91279d7313a579f72caae3941f6dc5a27David Lawrence the semantics, of a named configuration file.
e893dce91279d7313a579f72caae3941f6dc5a27David Lawrence </para>
e893dce91279d7313a579f72caae3941f6dc5a27David Lawrence </refsect1>
e893dce91279d7313a579f72caae3941f6dc5a27David Lawrence
e893dce91279d7313a579f72caae3941f6dc5a27David Lawrence <refsect1>
e893dce91279d7313a579f72caae3941f6dc5a27David Lawrence <title>OPTIONS</title>
e893dce91279d7313a579f72caae3941f6dc5a27David Lawrence
8e06cea14c857429ab7e7299af2dce5eeeaa5ff0Michael Graff <variablelist>
8e06cea14c857429ab7e7299af2dce5eeeaa5ff0Michael Graff <varlistentry>
8e06cea14c857429ab7e7299af2dce5eeeaa5ff0Michael Graff <term>-t <replaceable class="parameter">directory</replaceable></term>
3ecf3394e37dc2848a09ffc643565d454e9e6974Andreas Gustafsson <listitem>
3ecf3394e37dc2848a09ffc643565d454e9e6974Andreas Gustafsson <para>
3ecf3394e37dc2848a09ffc643565d454e9e6974Andreas Gustafsson chroot to <filename>directory</filename> so that include
3ecf3394e37dc2848a09ffc643565d454e9e6974Andreas Gustafsson directives in the configuration file are processed as if
3ecf3394e37dc2848a09ffc643565d454e9e6974Andreas Gustafsson run by a similarly chrooted named.
3ecf3394e37dc2848a09ffc643565d454e9e6974Andreas Gustafsson </para>
df3c4c7988b9bae7d121a8ac9ed17a23366a948dDavid Lawrence </listitem>
df3c4c7988b9bae7d121a8ac9ed17a23366a948dDavid Lawrence </varlistentry>
df3c4c7988b9bae7d121a8ac9ed17a23366a948dDavid Lawrence
df3c4c7988b9bae7d121a8ac9ed17a23366a948dDavid Lawrence <varlistentry>
df3c4c7988b9bae7d121a8ac9ed17a23366a948dDavid Lawrence <term>-v</term>
df3c4c7988b9bae7d121a8ac9ed17a23366a948dDavid Lawrence <listitem>
df3c4c7988b9bae7d121a8ac9ed17a23366a948dDavid Lawrence <para>
df3c4c7988b9bae7d121a8ac9ed17a23366a948dDavid Lawrence Print the version of the <command>named-checkconf</command>
df3c4c7988b9bae7d121a8ac9ed17a23366a948dDavid Lawrence program and exit.
df3c4c7988b9bae7d121a8ac9ed17a23366a948dDavid Lawrence </para>
df3c4c7988b9bae7d121a8ac9ed17a23366a948dDavid Lawrence </listitem>
df3c4c7988b9bae7d121a8ac9ed17a23366a948dDavid Lawrence </varlistentry>
df3c4c7988b9bae7d121a8ac9ed17a23366a948dDavid Lawrence
df3c4c7988b9bae7d121a8ac9ed17a23366a948dDavid Lawrence <varlistentry>
df3c4c7988b9bae7d121a8ac9ed17a23366a948dDavid Lawrence <term>-z</term>
df3c4c7988b9bae7d121a8ac9ed17a23366a948dDavid Lawrence <listitem>
df3c4c7988b9bae7d121a8ac9ed17a23366a948dDavid Lawrence <para>
df3c4c7988b9bae7d121a8ac9ed17a23366a948dDavid Lawrence Perform a check load the master zonefiles found in
df3c4c7988b9bae7d121a8ac9ed17a23366a948dDavid Lawrence <filename>named.conf</filename>.
df3c4c7988b9bae7d121a8ac9ed17a23366a948dDavid Lawrence </para>
ae4cbb69eef32ced103fe4561e8d2031ee4c3497David Lawrence </listitem>
ae4cbb69eef32ced103fe4561e8d2031ee4c3497David Lawrence </varlistentry>
ae4cbb69eef32ced103fe4561e8d2031ee4c3497David Lawrence
ae4cbb69eef32ced103fe4561e8d2031ee4c3497David Lawrence <varlistentry>
ae4cbb69eef32ced103fe4561e8d2031ee4c3497David Lawrence <term>-j</term>
ae4cbb69eef32ced103fe4561e8d2031ee4c3497David Lawrence <listitem>
ae4cbb69eef32ced103fe4561e8d2031ee4c3497David Lawrence <para>
ae4cbb69eef32ced103fe4561e8d2031ee4c3497David Lawrence When loading a zonefile read the journal if it exists.
ae4cbb69eef32ced103fe4561e8d2031ee4c3497David Lawrence </para>
ae4cbb69eef32ced103fe4561e8d2031ee4c3497David Lawrence </listitem>
ae4cbb69eef32ced103fe4561e8d2031ee4c3497David Lawrence </varlistentry>
ae4cbb69eef32ced103fe4561e8d2031ee4c3497David Lawrence
ae4cbb69eef32ced103fe4561e8d2031ee4c3497David Lawrence <varlistentry>
ae4cbb69eef32ced103fe4561e8d2031ee4c3497David Lawrence <term>filename</term>
ae4cbb69eef32ced103fe4561e8d2031ee4c3497David Lawrence <listitem>
df3c4c7988b9bae7d121a8ac9ed17a23366a948dDavid Lawrence <para>
df3c4c7988b9bae7d121a8ac9ed17a23366a948dDavid Lawrence The name of the configuration file to be checked. If not
df3c4c7988b9bae7d121a8ac9ed17a23366a948dDavid Lawrence specified, it defaults to <filename>/etc/named.conf</filename>.
df3c4c7988b9bae7d121a8ac9ed17a23366a948dDavid Lawrence </para>
df3c4c7988b9bae7d121a8ac9ed17a23366a948dDavid Lawrence </listitem>
df3c4c7988b9bae7d121a8ac9ed17a23366a948dDavid Lawrence </varlistentry>
df3c4c7988b9bae7d121a8ac9ed17a23366a948dDavid Lawrence
df3c4c7988b9bae7d121a8ac9ed17a23366a948dDavid Lawrence </variablelist>
0293ad13207aa29bd5844cdc87d085ffc009d749David Lawrence
0293ad13207aa29bd5844cdc87d085ffc009d749David Lawrence </refsect1>
0293ad13207aa29bd5844cdc87d085ffc009d749David Lawrence
0293ad13207aa29bd5844cdc87d085ffc009d749David Lawrence <refsect1>
df3c4c7988b9bae7d121a8ac9ed17a23366a948dDavid Lawrence <title>RETURN VALUES</title>
df3c4c7988b9bae7d121a8ac9ed17a23366a948dDavid Lawrence <para>
df3c4c7988b9bae7d121a8ac9ed17a23366a948dDavid Lawrence <command>named-checkconf</command> returns an exit status of 1 if
0293ad13207aa29bd5844cdc87d085ffc009d749David Lawrence errors were detected and 0 otherwise.
0293ad13207aa29bd5844cdc87d085ffc009d749David Lawrence </refsect1>
0293ad13207aa29bd5844cdc87d085ffc009d749David Lawrence
0293ad13207aa29bd5844cdc87d085ffc009d749David Lawrence <refsect1>
0293ad13207aa29bd5844cdc87d085ffc009d749David Lawrence <title>SEE ALSO</title>
0293ad13207aa29bd5844cdc87d085ffc009d749David Lawrence <para>
0293ad13207aa29bd5844cdc87d085ffc009d749David Lawrence <citerefentry>
0293ad13207aa29bd5844cdc87d085ffc009d749David Lawrence <refentrytitle>named</refentrytitle>
0293ad13207aa29bd5844cdc87d085ffc009d749David Lawrence <manvolnum>8</manvolnum>
0293ad13207aa29bd5844cdc87d085ffc009d749David Lawrence </citerefentry>,
0293ad13207aa29bd5844cdc87d085ffc009d749David Lawrence <citetitle>BIND 9 Administrator Reference Manual</citetitle>.
892abf317831dc328e3b878edce3adf7c92d2283Andreas Gustafsson </para>
892abf317831dc328e3b878edce3adf7c92d2283Andreas Gustafsson </refsect1>
892abf317831dc328e3b878edce3adf7c92d2283Andreas Gustafsson
892abf317831dc328e3b878edce3adf7c92d2283Andreas Gustafsson <refsect1>
892abf317831dc328e3b878edce3adf7c92d2283Andreas Gustafsson <title>AUTHOR</title>
892abf317831dc328e3b878edce3adf7c92d2283Andreas Gustafsson <para>
892abf317831dc328e3b878edce3adf7c92d2283Andreas Gustafsson <corpauthor>Internet Software Consortium</corpauthor>
9ceaa92a8ca8a0270ba296d44599e94d95033759Andreas Gustafsson </para>
892abf317831dc328e3b878edce3adf7c92d2283Andreas Gustafsson </refsect1>
892abf317831dc328e3b878edce3adf7c92d2283Andreas Gustafsson
892abf317831dc328e3b878edce3adf7c92d2283Andreas Gustafsson</refentry>
892abf317831dc328e3b878edce3adf7c92d2283Andreas Gustafsson
892abf317831dc328e3b878edce3adf7c92d2283Andreas Gustafsson<!--
892abf317831dc328e3b878edce3adf7c92d2283Andreas Gustafsson - Local variables:
9ceaa92a8ca8a0270ba296d44599e94d95033759Andreas Gustafsson - mode: sgml
892abf317831dc328e3b878edce3adf7c92d2283Andreas Gustafsson - End:
892abf317831dc328e3b878edce3adf7c92d2283Andreas Gustafsson-->
892abf317831dc328e3b878edce3adf7c92d2283Andreas Gustafsson
df3c4c7988b9bae7d121a8ac9ed17a23366a948dDavid Lawrence