Commit 268a4475 authored by Rob Austein's avatar Rob Austein

1856. [doc] Switch Docbook toolchain from DSSSL to XSL.

parent 29418246
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN"> <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.0//EN"
"http://www.oasis-open.org/docbook/xml/4.0/docbookx.dtd"
[<!ENTITY mdash "&#8212;">]>
<!-- <!--
- Copyright (C) 2004, 2005 Internet Systems Consortium, Inc. ("ISC") - Copyright (C) 2004, 2005 Internet Systems Consortium, Inc. ("ISC")
- Copyright (C) 2000-2002 Internet Software Consortium. - Copyright (C) 2000-2002 Internet Software Consortium.
...@@ -15,9 +17,7 @@ ...@@ -15,9 +17,7 @@
- OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
- PERFORMANCE OF THIS SOFTWARE. - PERFORMANCE OF THIS SOFTWARE.
--> -->
<!-- $Id: named-checkconf.docbook,v 1.11 2005/05/11 05:55:35 sra Exp $ -->
<!-- $Id: named-checkconf.docbook,v 1.10 2005/04/07 03:49:55 marka Exp $ -->
<refentry> <refentry>
<refentryinfo> <refentryinfo>
<date>June 14, 2000</date> <date>June 14, 2000</date>
...@@ -29,6 +29,20 @@ ...@@ -29,6 +29,20 @@
<refmiscinfo>BIND9</refmiscinfo> <refmiscinfo>BIND9</refmiscinfo>
</refmeta> </refmeta>
<docinfo>
<copyright>
<year>2004</year>
<year>2005</year>
<holder>Internet Systems Consortium, Inc. ("ISC")</holder>
</copyright>
<copyright>
<year>2000</year>
<year>2001</year>
<year>2002</year>
<holder>Internet Software Consortium</holder>
</copyright>
</docinfo>
<refnamediv> <refnamediv>
<refname><application>named-checkconf</application></refname> <refname><application>named-checkconf</application></refname>
<refpurpose>named configuration file syntax checking tool</refpurpose> <refpurpose>named configuration file syntax checking tool</refpurpose>
...@@ -47,9 +61,9 @@ ...@@ -47,9 +61,9 @@
<refsect1> <refsect1>
<title>DESCRIPTION</title> <title>DESCRIPTION</title>
<para> <para><command>named-checkconf</command>
<command>named-checkconf</command> checks the syntax, but not checks the syntax, but not the semantics, of a named
the semantics, of a named configuration file. configuration file.
</para> </para>
</refsect1> </refsect1>
...@@ -59,52 +73,53 @@ ...@@ -59,52 +73,53 @@
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term>-t <replaceable class="parameter">directory</replaceable></term> <term>-t <replaceable class="parameter">directory</replaceable></term>
<listitem> <listitem>
<para> <para>
chroot to <filename>directory</filename> so that include chroot to <filename>directory</filename> so that
directives in the configuration file are processed as if include
run by a similarly chrooted named. directives in the configuration file are processed as if
</para> run by a similarly chrooted named.
</listitem> </para>
</listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-v</term> <term>-v</term>
<listitem> <listitem>
<para> <para>
Print the version of the <command>named-checkconf</command> Print the version of the <command>named-checkconf</command>
program and exit. program and exit.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-z</term> <term>-z</term>
<listitem> <listitem>
<para> <para>
Perform a check load the master zonefiles found in Perform a check load the master zonefiles found in
<filename>named.conf</filename>. <filename>named.conf</filename>.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-j</term> <term>-j</term>
<listitem> <listitem>
<para> <para>
When loading a zonefile read the journal if it exists. When loading a zonefile read the journal if it exists.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>filename</term> <term>filename</term>
<listitem> <listitem>
<para> <para>
The name of the configuration file to be checked. If not The name of the configuration file to be checked. If not
specified, it defaults to <filename>/etc/named.conf</filename>. specified, it defaults to <filename>/etc/named.conf</filename>.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
...@@ -113,17 +128,16 @@ ...@@ -113,17 +128,16 @@
<refsect1> <refsect1>
<title>RETURN VALUES</title> <title>RETURN VALUES</title>
<para> <para><command>named-checkconf</command>
<command>named-checkconf</command> returns an exit status of 1 if returns an exit status of 1 if
errors were detected and 0 otherwise. errors were detected and 0 otherwise.
</para>
</refsect1> </refsect1>
<refsect1> <refsect1>
<title>SEE ALSO</title> <title>SEE ALSO</title>
<para> <para><citerefentry>
<citerefentry> <refentrytitle>named</refentrytitle><manvolnum>8</manvolnum>
<refentrytitle>named</refentrytitle>
<manvolnum>8</manvolnum>
</citerefentry>, </citerefentry>,
<citetitle>BIND 9 Administrator Reference Manual</citetitle>. <citetitle>BIND 9 Administrator Reference Manual</citetitle>.
</para> </para>
...@@ -131,16 +145,12 @@ ...@@ -131,16 +145,12 @@
<refsect1> <refsect1>
<title>AUTHOR</title> <title>AUTHOR</title>
<para> <para><corpauthor>Internet Systems Consortium</corpauthor>
<corpauthor>Internet Systems Consortium</corpauthor>
</para> </para>
</refsect1> </refsect1>
</refentry> </refentry><!--
<!--
- Local variables: - Local variables:
- mode: sgml - mode: sgml
- End: - End:
--> -->
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN"> <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.0//EN"
"http://www.oasis-open.org/docbook/xml/4.0/docbookx.dtd"
[<!ENTITY mdash "&#8212;">]>
<!-- <!--
- Copyright (C) 2004, 2005 Internet Systems Consortium, Inc. ("ISC") - Copyright (C) 2004, 2005 Internet Systems Consortium, Inc. ("ISC")
- Copyright (C) 2000-2002 Internet Software Consortium. - Copyright (C) 2000-2002 Internet Software Consortium.
...@@ -15,9 +17,7 @@ ...@@ -15,9 +17,7 @@
- OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
- PERFORMANCE OF THIS SOFTWARE. - PERFORMANCE OF THIS SOFTWARE.
--> -->
<!-- $Id: named-checkzone.docbook,v 1.17 2005/05/11 05:55:35 sra Exp $ -->
<!-- $Id: named-checkzone.docbook,v 1.16 2005/04/07 03:49:55 marka Exp $ -->
<refentry> <refentry>
<refentryinfo> <refentryinfo>
<date>June 13, 2000</date> <date>June 13, 2000</date>
...@@ -29,6 +29,20 @@ ...@@ -29,6 +29,20 @@
<refmiscinfo>BIND9</refmiscinfo> <refmiscinfo>BIND9</refmiscinfo>
</refmeta> </refmeta>
<docinfo>
<copyright>
<year>2004</year>
<year>2005</year>
<holder>Internet Systems Consortium, Inc. ("ISC")</holder>
</copyright>
<copyright>
<year>2000</year>
<year>2001</year>
<year>2002</year>
<holder>Internet Software Consortium</holder>
</copyright>
</docinfo>
<refnamediv> <refnamediv>
<refname><application>named-checkzone</application></refname> <refname><application>named-checkzone</application></refname>
<refpurpose>zone file validity checking tool</refpurpose> <refpurpose>zone file validity checking tool</refpurpose>
...@@ -56,12 +70,11 @@ ...@@ -56,12 +70,11 @@
<refsect1> <refsect1>
<title>DESCRIPTION</title> <title>DESCRIPTION</title>
<para> <para><command>named-checkzone</command>
<command>named-checkzone</command> checks the syntax and integrity of checks the syntax and integrity of a zone file. It performs the
a zone file. It performs the same checks as <command>named</command> same checks as <command>named</command> does when loading a
does when loading a zone. This makes zone. This makes <command>named-checkzone</command> useful for
<command>named-checkzone</command> useful for checking zone checking zone files before configuring them into a name server.
files before configuring them into a name server.
</para> </para>
</refsect1> </refsect1>
...@@ -71,78 +84,80 @@ ...@@ -71,78 +84,80 @@
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term>-d</term> <term>-d</term>
<listitem> <listitem>
<para> <para>
Enable debugging. Enable debugging.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-q</term> <term>-q</term>
<listitem> <listitem>
<para> <para>
Quiet mode - exit code only. Quiet mode - exit code only.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-v</term> <term>-v</term>
<listitem> <listitem>
<para> <para>
Print the version of the <command>named-checkzone</command> Print the version of the <command>named-checkzone</command>
program and exit. program and exit.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-j</term> <term>-j</term>
<listitem> <listitem>
<para> <para>
When loading the zone file read the journal if it exists. When loading the zone file read the journal if it exists.
</para> </para>
</listitem> </listitem>
</varlistentry>
<varlistentry> <varlistentry>
<term>-c <replaceable class="parameter">class</replaceable></term> <term>-c <replaceable class="parameter">class</replaceable></term>
<listitem> <listitem>
<para> <para>
Specify the class of the zone. If not specified "IN" is assumed. Specify the class of the zone. If not specified "IN" is assumed.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-k <replaceable class="parameter">mode</replaceable></term> <term>-k <replaceable class="parameter">mode</replaceable></term>
<listitem> <listitem>
<para> <para>
Perform <command>"check-name"</command> checks with the specified failure mode. Perform <command>"check-name"</command> checks with
Possible modes are <command>"fail"</command>, the specified failure mode.
<command>"warn"</command> (default) and Possible modes are <command>"fail"</command>,
<command>"ignore"</command>. <command>"warn"</command> (default) and
</para> <command>"ignore"</command>.
</listitem> </para>
</listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-n <replaceable class="parameter">mode</replaceable></term> <term>-n <replaceable class="parameter">mode</replaceable></term>
<listitem> <listitem>
<para> <para>
Specify whether NS records should be checked to see if they Specify whether NS records should be checked to see if they
are addresses. Possible modes are <command>"fail"</command>, are addresses. Possible modes are <command>"fail"</command>,
<command>"warn"</command> (default) and <command>"warn"</command> (default) and
<command>"ignore"</command>. <command>"ignore"</command>.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-o <replaceable class="parameter">filename</replaceable></term> <term>-o <replaceable class="parameter">filename</replaceable></term>
<listitem> <listitem>
<para> <para>
Write zone output to <filename>filename</filename>. Write zone output to <filename>filename</filename>.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
...@@ -151,9 +166,10 @@ ...@@ -151,9 +166,10 @@
<term>-t <replaceable class="parameter">directory</replaceable></term> <term>-t <replaceable class="parameter">directory</replaceable></term>
<listitem> <listitem>
<para> <para>
chroot to <filename>directory</filename> so that include chroot to <filename>directory</filename> so that
directives in the configuration file are processed as if include
run by a similarly chrooted named. directives in the configuration file are processed as if
run by a similarly chrooted named.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
...@@ -162,52 +178,54 @@ ...@@ -162,52 +178,54 @@
<term>-w <replaceable class="parameter">directory</replaceable></term> <term>-w <replaceable class="parameter">directory</replaceable></term>
<listitem> <listitem>
<para> <para>
chdir to <filename>directory</filename> so that relative chdir to <filename>directory</filename> so that
filenames in master file $INCLUDE directives work. This relative
is similar to the directory clause in filenames in master file $INCLUDE directives work. This
<filename>named.conf</filename>. is similar to the directory clause in
<filename>named.conf</filename>.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-D</term> <term>-D</term>
<listitem> <listitem>
<para> <para>
Dump zone file in canonical format. Dump zone file in canonical format.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-W <replaceable class="parameter">mode</replaceable></term> <term>-W <replaceable class="parameter">mode</replaceable></term>
<listitem> <listitem>
<para> <para>
Specify whether to check for non-terminal wildcards. Specify whether to check for non-terminal wildcards.
Non-terminal wildcards are almost always the result of a Non-terminal wildcards are almost always the result of a
failure to understand the wildcard matching algorithm (RFC 1034). failure to understand the wildcard matching algorithm (RFC 1034).
Possible modes are <command>"warn"</command> (default) and Possible modes are <command>"warn"</command> (default)
<command>"ignore"</command>. and
</para> <command>"ignore"</command>.
</listitem> </para>
</listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>zonename</term> <term>zonename</term>
<listitem> <listitem>
<para> <para>
The domain name of the zone being checked. The domain name of the zone being checked.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>filename</term> <term>filename</term>
<listitem> <listitem>
<para> <para>
The name of the zone file. The name of the zone file.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
...@@ -216,17 +234,16 @@ ...@@ -216,17 +234,16 @@
<refsect1> <refsect1>
<title>RETURN VALUES</title> <title>RETURN VALUES</title>
<para> <para><command>named-checkzone</command>
<command>named-checkzone</command> returns an exit status of 1 if returns an exit status of 1 if
errors were detected and 0 otherwise. errors were detected and 0 otherwise.
</para>
</refsect1> </refsect1>
<refsect1> <refsect1>
<title>SEE ALSO</title> <title>SEE ALSO</title>
<para> <para><citerefentry>
<citerefentry> <refentrytitle>named</refentrytitle><manvolnum>8</manvolnum>
<refentrytitle>named</refentrytitle>
<manvolnum>8</manvolnum>
</citerefentry>, </citerefentry>,
<citetitle>RFC 1035</citetitle>, <citetitle>RFC 1035</citetitle>,
<citetitle>BIND 9 Administrator Reference Manual</citetitle>. <citetitle>BIND 9 Administrator Reference Manual</citetitle>.
...@@ -235,16 +252,12 @@ ...@@ -235,16 +252,12 @@
<refsect1> <refsect1>
<title>AUTHOR</title> <title>AUTHOR</title>
<para> <para><corpauthor>Internet Systems Consortium</corpauthor>
<corpauthor>Internet Systems Consortium</corpauthor>
</para> </para>
</refsect1> </refsect1>
</refentry> </refentry><!--
<!--
- Local variables: - Local variables:
- mode: sgml - mode: sgml
- End: - End:
--> -->
This diff is collapsed.
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN"> <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.0//EN"
"http://www.oasis-open.org/docbook/xml/4.0/docbookx.dtd"
[<!ENTITY mdash "&#8212;">]>
<!-- <!--
- Copyright (C) 2004 Internet Systems Consortium, Inc. ("ISC") - Copyright (C) 2004 Internet Systems Consortium, Inc. ("ISC")
- Copyright (C) 2000-2002 Internet Software Consortium. - Copyright (C) 2000-2002 Internet Software Consortium.
...@@ -15,204 +17,236 @@ ...@@ -15,204 +17,236 @@
- OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
- PERFORMANCE OF THIS SOFTWARE. - PERFORMANCE OF THIS SOFTWARE.
--> -->
<!-- $Id: host.docbook,v 1.8 2005/05/11 05:55:36 sra Exp $ -->
<!-- $Id: host.docbook,v 1.7 2004/11/10 22:04:25 marka Exp $ -->
<refentry> <refentry>
<refentryinfo> <refentryinfo>
<date>Jun 30, 2000</date> <date>Jun 30, 2000</date>
</refentryinfo> </refentryinfo>
<refmeta> <refmeta>
<refentrytitle>host</refentrytitle> <refentrytitle>host</refentrytitle>
<manvolnum>1</manvolnum> <manvolnum>1</manvolnum>
<refmiscinfo>BIND9</refmiscinfo> <refmiscinfo>BIND9</refmiscinfo>