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>
...@@ -61,7 +75,8 @@ ...@@ -61,7 +75,8 @@
<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
include
directives in the configuration file are processed as if directives in the configuration file are processed as if
run by a similarly chrooted named. run by a similarly chrooted named.
</para> </para>
...@@ -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>
...@@ -104,6 +117,7 @@ ...@@ -104,6 +117,7 @@
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>
...@@ -118,7 +132,8 @@ ...@@ -118,7 +132,8 @@
<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
the specified failure mode.
Possible modes are <command>"fail"</command>, Possible modes are <command>"fail"</command>,
<command>"warn"</command> (default) and <command>"warn"</command> (default) and
<command>"ignore"</command>. <command>"ignore"</command>.
...@@ -151,7 +166,8 @@ ...@@ -151,7 +166,8 @@
<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
include
directives in the configuration file are processed as if directives in the configuration file are processed as if
run by a similarly chrooted named. run by a similarly chrooted named.
</para> </para>
...@@ -162,7 +178,8 @@ ...@@ -162,7 +178,8 @@
<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
relative
filenames in master file $INCLUDE directives work. This filenames in master file $INCLUDE directives work. This
is similar to the directory clause in is similar to the directory clause in
<filename>named.conf</filename>. <filename>named.conf</filename>.
...@@ -186,7 +203,8 @@ ...@@ -186,7 +203,8 @@
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)
and
<command>"ignore"</command>. <command>"ignore"</command>.
</para> </para>
</listitem> </listitem>
...@@ -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,28 +17,39 @@ ...@@ -15,28 +17,39 @@
- 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>
</refmeta> </refmeta>
<refnamediv> <refnamediv>
<refname>host</refname> <refname>host</refname>
<refpurpose>DNS lookup utility</refpurpose> <refpurpose>DNS lookup utility</refpurpose>
</refnamediv> </refnamediv>
<refsynopsisdiv> <docinfo>
<cmdsynopsis> <copyright>
<year>2004</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>
<refsynopsisdiv>
<cmdsynopsis>
<command>host</command> <command>host</command>
<arg><option>-aCdlnrTwv</option></arg> <arg><option>-aCdlnrTwv</option></arg>
<arg><option>-c <replaceable class="parameter">class</replaceable></option></arg> <arg><option>-c <replaceable class="parameter">class</replaceable></option></arg>
...@@ -47,172 +60,193 @@ ...@@ -47,172 +60,193 @@
<arg><option>-m <replaceable class="parameter">flag</replaceable></option></arg> <arg><option>-m <replaceable class="parameter">flag</replaceable></option></arg>
<arg><option>-4</option></arg> <arg><option>-4</option></arg>
<arg><option>-6</option></arg> <arg><option>-6</option></arg>
<arg choice=req>name</arg> <arg choice="req">name</arg>
<arg choice=opt>server</arg> <arg choice="opt">server</arg>
</cmdsynopsis> </cmdsynopsis>
</refsynopsisdiv> </refsynopsisdiv>
<refsect1> <refsect1>
<title>DESCRIPTION</title> <title>DESCRIPTION</title>
<para>
<command>host</command> <para><command>host</command>
is a simple utility for performing DNS lookups. is a simple utility for performing DNS lookups.
It is normally used to convert names to IP addresses and vice versa. It is normally used to convert names to IP addresses and vice versa.
When no arguments or options are given, When no arguments or options are given,
<command>host</command> <command>host</command>
prints a short summary of its command line arguments and options. prints a short summary of its command line arguments and options.
</para> </para>
<para> <para><parameter>name</parameter> is the domain name that is to be
<parameter>name</parameter> is the domain name that is to be looked looked
up. It can also be a dotted-decimal IPv4 address or a colon-delimited up. It can also be a dotted-decimal IPv4 address or a colon-delimited
IPv6 address, in which case <command>host</command> will by default IPv6 address, in which case <command>host</command> will by
perform a reverse lookup for that address. default
<parameter>server</parameter> is an optional argument which is either perform a reverse lookup for that address.
the name or IP address of the name server that <command>host</command> <parameter>server</parameter> is an optional argument which
should query instead of the server or servers listed in is either
<filename>/etc/resolv.conf</filename>. the name or IP address of the name server that <command>host</command>
</para> should query instead of the server or servers listed in
<filename>/etc/resolv.conf</filename>.
<para> </para>
The <option>-a</option> (all) option is equivalent to setting the
<option>-v</option> option and asking <command>host</command> to make <para>
a query of type ANY. The <option>-a</option> (all) option is equivalent to setting the
</para> <option>-v</option> option and asking <command>host</command> to make
a query of type ANY.
<para> </para>
When the <option>-C</option> option is used, <command>host</command>
will attempt to display the SOA records for zone <para>
<parameter>name</parameter> from all the listed authoritative name When the <option>-C</option> option is used, <command>host</command>
servers for that zone. The list of name servers is defined by the NS will attempt to display the SOA records for zone
records that are found for the zone. <parameter>name</parameter> from all the listed
</para> authoritative name
servers for that zone. The list of name servers is defined by the NS
<para> records that are found for the zone.
The <option>-c</option> option instructs to make a DNS query of class </para>
<parameter>class</parameter>. This can be used to lookup Hesiod or
Chaosnet class resource records. The default class is IN (Internet). <para>
</para> The <option>-c</option> option instructs to make a DNS query of class
<parameter>class</parameter>. This can be used to lookup
<para> Hesiod or
Verbose output is generated by <command>host</command> when the Chaosnet class resource records. The default class is IN (Internet).
<option>-d</option> or <option>-v</option> option is used. The two </para>
options are equivalent. They have been provided for backwards
compatibility. In previous versions, the <option>-d</option> option <para>
switched on debugging traces and <option>-v</option> enabled verbose Verbose output is generated by <command>host</command> when
output. the
</para> <option>-d</option> or <option>-v</option> option is used. The two
options are equivalent. They have been provided for backwards
<para> compatibility. In previous versions, the <option>-d</option> option
List mode is selected by the <option>-l</option> option. This makes switched on debugging traces and <option>-v</option> enabled verbose
<command>host</command> perform a zone transfer for zone output.
<parameter>name</parameter>. Transfer the zone printing out the NS, PTR </para>
and address records (A/AAAA). If combined with <option>-a</option>
all records will be printed. <para>
</para> List mode is selected by the <option>-l</option> option. This makes
<command>host</command> perform a zone transfer for zone
<para> <parameter>name</parameter>. Transfer the zone printing out
The <option>-i</option> the NS, PTR
option specifies that reverse lookups of IPv6 addresses should and address records (A/AAAA). If combined with <option>-a</option>
use the IP6.INT domain as defined in RFC1886. all records will be printed.
The default is to use IP6.ARPA. </para>
</para>
<para>
<para> The <option>-i</option>
The <option>-N</option> option sets the number of dots that have to be option specifies that reverse lookups of IPv6 addresses should
in <parameter>name</parameter> for it to be considered absolute. The use the IP6.INT domain as defined in RFC1886.
default value is that defined using the ndots statement in The default is to use IP6.ARPA.
<filename>/etc/resolv.conf</filename>, or 1 if no ndots statement is </para>
present. Names with fewer dots are interpreted as relative names and
will be searched for in the domains listed in the <type>search</type> <para>
or <type>domain</type> directive in The <option>-N</option> option sets the number of dots that have to be
<filename>/etc/resolv.conf</filename>. in <parameter>name</parameter> for it to be considered
</para> absolute. The
default value is that defined using the ndots statement in
<para> <filename>/etc/resolv.conf</filename>, or 1 if no ndots
The number of UDP retries for a lookup can be changed with the statement is
<option>-R</option> option. <parameter>number</parameter> indicates present. Names with fewer dots are interpreted as relative names and
how many times <command>host</command> will repeat a query that does will be searched for in the domains listed in the <type>search</type>
not get answered. The default number of retries is 1. If or <type>domain</type> directive in
<parameter>number</parameter> is negative or zero, the number of <filename>/etc/resolv.conf</filename>.
retries will default to 1. </para>
</para>
<para>
<para> The number of UDP retries for a lookup can be changed with the
Non-recursive queries can be made via the <option>-r</option> option. <option>-R</option> option. <parameter>number</parameter>
Setting this option clears the <type>RD</type> &mdash; recursion indicates
desired &mdash; bit in the query which <command>host</command> makes. how many times <command>host</command> will repeat a query
This should mean that the name server receiving the query will not that does
attempt to resolve <parameter>name</parameter>. The not get answered. The default number of retries is 1. If
<option>-r</option> option enables <command>host</command> to mimic <parameter>number</parameter> is negative or zero, the
the behaviour of a name server by making non-recursive queries and number of
expecting to receive answers to those queries that are usually retries will default to 1.
referrals to other name servers. </para>
</para>
<para>
<para> Non-recursive queries can be made via the <option>-r</option> option.
By default <command>host</command> uses UDP when making queries. The Setting this option clears the <type>RD</type> &mdash; recursion
<option>-T</option> option makes it use a TCP connection when querying desired &mdash; bit in the query which <command>host</command> makes.
the name server. TCP will be automatically selected for queries that This should mean that the name server receiving the query will not
require it, such as zone transfer (AXFR) requests. attempt to resolve <parameter>name</parameter>. The
</para> <option>-r</option> option enables <command>host</command>
to mimic
<para> the behaviour of a name server by making non-recursive queries and
The <option>-4</option> option forces <command>host</command> to only expecting to receive answers to those queries that are usually
use IPv4 query transport. The <option>-6</option> option forces referrals to other name servers.
<command>host</command> to only use IPv6 query transport. </para>
</para>
<para>
<para> By default <command>host</command> uses UDP when making
The <option>-t</option> option is used to