mir/bind
2
0
Fork 0
mirror of https://gitlab.isc.org/isc-projects/bind9 synced 2025-08-31 14:35:26 +00:00
Code Issues Releases Wiki Activity

grammer, spelling and clarity

Browse Source
This commit is contained in:
Mark Andrews
2006-05-17 01:31:50 +00:00
parent e1356e58e6
commit 1d49f4d5ec
1 changed files with 79 additions and 59 deletions
Download Patch File Download Diff File Expand all files Collapse all files

138
doc/arm/Bv9ARM-book.xml
View File

@@ -18,7 +18,7 @@
- PERFORMANCE OF THIS SOFTWARE. - PERFORMANCE OF THIS SOFTWARE.
--> -->
<!-- File: $Id: Bv9ARM-book.xml,v 1.301 2006/05/16 06:42:09 marka Exp $ --> <!-- File: $Id: Bv9ARM-book.xml,v 1.302 2006/05/17 01:31:50 marka Exp $ -->
<book xmlns:xi="http://www.w3.org/2001/XInclude"> <book xmlns:xi="http://www.w3.org/2001/XInclude">
<title>BIND 9 Administrator Reference Manual</title> <title>BIND 9 Administrator Reference Manual</title>
@@ -2187,7 +2187,7 @@ allow-update { key host1-host2. ;};
the TSIG extended error code set to BADTIME, and the time values the TSIG extended error code set to BADTIME, and the time values
will be adjusted so that the response can be successfully will be adjusted so that the response can be successfully
verified. In any of these cases, the message's rcode is set to verified. In any of these cases, the message's rcode is set to
NOTAUTH (not authoritative). NOTAUTH (not authenticated).
</para> </para>
</sect2> </sect2>
@@ -3954,7 +3954,7 @@ channel null {
special special
property that it only produces output when the server's debug property that it only produces output when the server's debug
level is level is
nonzero. It normally writes to a file <filename>named.run</filename> nonzero. It normally writes to a file called <filename>named.run</filename>
in the server's working directory. in the server's working directory.
</para> </para>
@@ -4661,7 +4661,7 @@ digits</varname>" + "<varname>tkey-domain</varname>". In most cases,
If not specified, the default is <filename>named.stats</filename> in the If not specified, the default is <filename>named.stats</filename> in the
server's current directory. The format of the file is server's current directory. The format of the file is
described described
in <xref linkend="statsfile"/> in <xref linkend="statsfile"/>.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@@ -5289,7 +5289,7 @@ options {
<para> <para>
See the description of See the description of
<command>provide-ixfr</command> in <command>provide-ixfr</command> in
<xref linkend="server_statement_definition_and_usage"/> <xref linkend="server_statement_definition_and_usage"/>.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@@ -5300,7 +5300,7 @@ options {
<para> <para>
See the description of See the description of
<command>request-ixfr</command> in <command>request-ixfr</command> in
<xref linkend="server_statement_definition_and_usage"/> <xref linkend="server_statement_definition_and_usage"/>.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@@ -5639,7 +5639,8 @@ options {
<para> <para>
When returning authoritative negative responses to When returning authoritative negative responses to
SOA queries set the TTL of the SOA recored returned in SOA queries set the TTL of the SOA recored returned in
the authority section to zero. Default yes. the authority section to zero.
The default is <command>yes</command>.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@@ -5649,7 +5650,8 @@ options {
<listitem> <listitem>
<para> <para>
When caching a negative response to a SOA query When caching a negative response to a SOA query
set the TTL to zero. Default no. set the TTL to zero.
The default is <command>no</command>.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@@ -5663,7 +5665,8 @@ options {
the DNSKEY RR to determine if this key should be the DNSKEY RR to determine if this key should be
used to generate the RRSIG. This flag is ignored used to generate the RRSIG. This flag is ignored
if there are not DNSKEY RRs both with and without if there are not DNSKEY RRs both with and without
a KSK. Default yes. a KSK.
The default is <command>yes</command>.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@@ -6204,7 +6207,7 @@ query-source-v6 address * port *;
only supported by relatively new slave servers, only supported by relatively new slave servers,
such as <acronym>BIND</acronym> 9, <acronym>BIND</acronym> such as <acronym>BIND</acronym> 9, <acronym>BIND</acronym>
8.x and <acronym>BIND</acronym> 4.9.5 onwards. 8.x and <acronym>BIND</acronym> 4.9.5 onwards.
The <command>many-answers</command> format also supported by The <command>many-answers</command> format is also supported by
recent Microsoft Windows nameservers. recent Microsoft Windows nameservers.
The default is <command>many-answers</command>. The default is <command>many-answers</command>.
<command>transfer-format</command> may be overridden on a <command>transfer-format</command> may be overridden on a
@@ -6417,7 +6420,7 @@ query-source-v6 address * port *;
uses the limit uses the limit
that was in force when the server was started. See the description that was in force when the server was started. See the description
of of
<command>size_spec</command> in <xref linkend="configuration_file_elements"/>. <command> issize_spec</command> in <xref linkend="configuration_file_elements"/>.
</para> </para>
<para> <para>
@@ -6978,8 +6981,8 @@ query-source-v6 address * port *;
<varlistentry> <varlistentry>
<term><command>max-cache-ttl</command></term> <term><command>max-cache-ttl</command></term>
<listitem> <listitem>
<para><command>max-cache-ttl</command> <para>
sets the maximum time for which the server will Sets the maximum time for which the server will
cache ordinary (positive) answers. The default is cache ordinary (positive) answers. The default is
one week (7 days). one week (7 days).
</para> </para>
@@ -6997,7 +7000,7 @@ query-source-v6 address * port *;
</para> </para>
<note> <note>
<simpara> <simpara>
Not implemented in <acronym>BIND</acronym>9. Not implemented in <acronym>BIND</acronym> 9.
</simpara> </simpara>
</note> </note>
</listitem> </listitem>
@@ -7083,7 +7086,7 @@ query-source-v6 address * port *;
<varlistentry> <varlistentry>
<term><command>masterfile-format</command></term> <term><command>masterfile-format</command></term>
<listitem> <listitem>
<para><command>masterfile-format</command> specifies <para>Specifies
the file format of zone files (see the file format of zone files (see
<xref linkend="zonefile_format"/>). <xref linkend="zonefile_format"/>).
The default value is <constant>text</constant>, which is the The default value is <constant>text</constant>, which is the
@@ -7114,8 +7117,7 @@ query-source-v6 address * port *;
<term><command>clients-per-query</command></term> <term><command>clients-per-query</command></term>
<term><command>max-clients-per-query</command></term> <term><command>max-clients-per-query</command></term>
<listitem> <listitem>
<para><command>clients-per-query</command> <para>These set the
and <command>max-clients-per-query</command> set the
initial value (minimum) and maximum number of recursive initial value (minimum) and maximum number of recursive
simultanious clients for any given query simultanious clients for any given query
(&lt;qname,qtype,qclass&gt;) that the server will accept (&lt;qname,qtype,qclass&gt;) that the server will accept
@@ -7141,7 +7143,7 @@ query-source-v6 address * port *;
<para> <para>
If <command>max-clients-per-query</command> is set to zero If <command>max-clients-per-query</command> is set to zero
then there is no upper bound other than imposed by then there is no upper bound other than imposed by
<command>recurive-clients</command>. <command>recursive-clients</command>.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@@ -7198,7 +7200,7 @@ query-source-v6 address * port *;
with type <command>TXT</command>, class <command>CHAOS</command>. with type <command>TXT</command>, class <command>CHAOS</command>.
This defaults to the hostname of the machine hosting the This defaults to the hostname of the machine hosting the
name server as name server as
found by gethostname(). The primary purpose of such queries found by the gethostname() function. The primary purpose of such queries
is to is to
identify which of a group of anycast servers is actually identify which of a group of anycast servers is actually
answering your queries. Specifying <command>hostname none;</command> answering your queries. Specifying <command>hostname none;</command>
@@ -7219,7 +7221,7 @@ query-source-v6 address * port *;
answering your queries. Specifying <command>server-id none;</command> answering your queries. Specifying <command>server-id none;</command>
disables processing of the queries. disables processing of the queries.
Specifying <command>server-id hostname;</command> will cause named to Specifying <command>server-id hostname;</command> will cause named to
use the hostname as found by gethostname(). use the hostname as found by the gethostname() function.
The default <command>server-id</command> is <command>none</command>. The default <command>server-id</command> is <command>none</command>.
</para> </para>
</listitem> </listitem>
@@ -7285,8 +7287,10 @@ query-source-v6 address * port *;
views of class IN. Disabled empty zones are only inherited views of class IN. Disabled empty zones are only inherited
from options if there are no disabled empty zones specified from options if there are no disabled empty zones specified
at the view level. To override the options list of disabled at the view level. To override the options list of disabled
zones you can disable the root zone at the view level zones you can disable the root zone at the view level, for example:
(disable-empty-zone ".";). <programlisting>
disable-empty-zone ".";
</programlisting>
</para> </para>
<para> <para>
If you are using the address ranges covered here you should If you are using the address ranges covered here you should
@@ -7357,8 +7361,13 @@ query-source-v6 address * port *;
generated by <acronym>BIND</acronym> 8. generated by <acronym>BIND</acronym> 8.
</para> </para>
<para> <para>
The statistics dump begins with the line <command>+++ Statistics Dump The statistics dump begins with a line, like:
+++ (973798949)</command>, where the number in parentheses is a standard </para>
<para>
<command>+++ Statistics Dump +++ (973798949)</command>
</para>
<para>
The number in parentheses is a standard
Unix-style timestamp, measured as seconds since January 1, 1970. Unix-style timestamp, measured as seconds since January 1, 1970.
Following Following
that line are a series of lines containing a counter type, the that line are a series of lines containing a counter type, the
@@ -7368,9 +7377,14 @@ query-source-v6 address * port *;
the entire server. the entire server.
Lines with a zone and view name for the given view and zone (the Lines with a zone and view name for the given view and zone (the
view name is view name is
omitted for the default view). The statistics dump ends omitted for the default view).
with the line <command>--- Statistics Dump --- (973798949)</command>, where the </para>
number is identical to the number in the beginning line. <para>
The statistics dump ends with the line where the
number is identical to the number in the beginning line; for example:
</para>
<para>
<command>--- Statistics Dump --- (973798949)</command>
</para> </para>
<para> <para>
The following statistics counters are maintained: The following statistics counters are maintained:
@@ -8353,23 +8367,12 @@ zone <replaceable>zone_name</replaceable> <optional><replaceable>class</replacea
<variablelist> <variablelist>
<varlistentry>
<term><command>journal</command></term>
<listitem>
<para>
Allow the default journal's file name to be overridden.
The default is the zone's file with "<filename>.jnl</filename>" appended.
This is applicable to <command>master</command> and <command>slave</command> zones.
</para>
</listitem>
</varlistentry>
<varlistentry> <varlistentry>
<term><command>allow-notify</command></term> <term><command>allow-notify</command></term>
<listitem> <listitem>
<para> <para>
See the description of See the description of
<command>allow-notify</command> in <xref linkend="access_control"/> <command>allow-notify</command> in <xref linkend="access_control"/>.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@@ -8379,7 +8382,7 @@ zone <replaceable>zone_name</replaceable> <optional><replaceable>class</replacea
<listitem> <listitem>
<para> <para>
See the description of See the description of
<command>allow-query</command> in <xref linkend="access_control"/> <command>allow-query</command> in <xref linkend="access_control"/>.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@@ -8626,6 +8629,17 @@ zone <replaceable>zone_name</replaceable> <optional><replaceable>class</replacea
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry>
<term><command>journal</command></term>
<listitem>
<para>
Allow the default journal's file name to be overridden.
The default is the zone's file with "<filename>.jnl</filename>" appended.
This is applicable to <command>master</command> and <command>slave</command> zones.
</para>
</listitem>
</varlistentry>
<varlistentry> <varlistentry>
<term><command>max-transfer-time-in</command></term> <term><command>max-transfer-time-in</command></term>
<listitem> <listitem>
@@ -8718,7 +8732,7 @@ zone <replaceable>zone_name</replaceable> <optional><replaceable>class</replacea
<listitem> <listitem>
<para> <para>
See the description of See the description of
<command>transfer-source</command> in <xref linkend="zone_transfers"/> <command>transfer-source</command> in <xref linkend="zone_transfers"/>.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@@ -8728,7 +8742,7 @@ zone <replaceable>zone_name</replaceable> <optional><replaceable>class</replacea
<listitem> <listitem>
<para> <para>
See the description of See the description of
<command>transfer-source-v6</command> in <xref linkend="zone_transfers"/> <command>transfer-source-v6</command> in <xref linkend="zone_transfers"/>.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@@ -8738,7 +8752,7 @@ zone <replaceable>zone_name</replaceable> <optional><replaceable>class</replacea
<listitem> <listitem>
<para> <para>
See the description of See the description of
<command>alt-transfer-source</command> in <xref linkend="zone_transfers"/> <command>alt-transfer-source</command> in <xref linkend="zone_transfers"/>.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@@ -8748,7 +8762,7 @@ zone <replaceable>zone_name</replaceable> <optional><replaceable>class</replacea
<listitem> <listitem>
<para> <para>
See the description of See the description of
<command>alt-transfer-source-v6</command> in <xref linkend="zone_transfers"/> <command>alt-transfer-source-v6</command> in <xref linkend="zone_transfers"/>.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@@ -8758,7 +8772,7 @@ zone <replaceable>zone_name</replaceable> <optional><replaceable>class</replacea
<listitem> <listitem>
<para> <para>
See the description of See the description of
<command>use-alt-transfer-source</command> in <xref linkend="zone_transfers"/> <command>use-alt-transfer-source</command> in <xref linkend="zone_transfers"/>.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@@ -8769,7 +8783,7 @@ zone <replaceable>zone_name</replaceable> <optional><replaceable>class</replacea
<listitem> <listitem>
<para> <para>
See the description of See the description of
<command>notify-source</command> in <xref linkend="zone_transfers"/> <command>notify-source</command> in <xref linkend="zone_transfers"/>.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@@ -8811,7 +8825,7 @@ zone <replaceable>zone_name</replaceable> <optional><replaceable>class</replacea
<listitem> <listitem>
<para> <para>
See the description of See the description of
<command>key-directory</command> in <xref linkend="options"/> <command>key-directory</command> in <xref linkend="options"/>.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@@ -10400,10 +10414,10 @@ $GENERATE 1-127 $ CNAME $.0</programlisting>
<command>{</command> immediately following the <command>{</command> immediately following the
<command>$</command> as <command>$</command> as
<command>${offset[,width[,base]]}</command>. <command>${offset[,width[,base]]}</command>.
e.g. <command>${-20,3,d}</command> which For example, <command>${-20,3,d}</command>
subtracts 20 from the current value, prints the subtracts 20 from the current value, prints the
result as a decimal in a zero padded field of result as a decimal in a zero padded field of
with 3. width 3.
Available output forms are decimal Available output forms are decimal
(<command>d</command>), octal (<command>d</command>), octal
@@ -10417,7 +10431,7 @@ $GENERATE 1-127 $ CNAME $.0</programlisting>
</para> </para>
<para> <para>
For compatibility with earlier versions <command>$$</command> is still For compatibility with earlier versions <command>$$</command> is still
recognized a indicating a literal $ in the output. recognized as indicating a literal $ in the output.
</para> </para>
</entry> </entry>
</row> </row>
@@ -10426,8 +10440,8 @@ $GENERATE 1-127 $ CNAME $.0</programlisting>
<para><command>ttl</command></para> <para><command>ttl</command></para>
</entry> </entry>
<entry colname="2"> <entry colname="2">
<para><command>ttl</command> <para>
specifies the ttl of the generated records. If Specifies the time-to-live of the generated records. If
not specified this will be inherited using the not specified this will be inherited using the
normal ttl inheritance rules. normal ttl inheritance rules.
</para> </para>
@@ -10442,8 +10456,8 @@ $GENERATE 1-127 $ CNAME $.0</programlisting>
<para><command>class</command></para> <para><command>class</command></para>
</entry> </entry>
<entry colname="2"> <entry colname="2">
<para><command>class</command> <para>
specifies the class of the generated records. Specifies the class of the generated records.
This must match the zone class if it is This must match the zone class if it is
specified. specified.
</para> </para>
@@ -10470,7 +10484,7 @@ $GENERATE 1-127 $ CNAME $.0</programlisting>
</entry> </entry>
<entry colname="2"> <entry colname="2">
<para> <para>
rhs is a domain name. It is processed A domain name. It is processed
similarly to lhs. similarly to lhs.
</para> </para>
</entry> </entry>
@@ -10563,6 +10577,7 @@ acl bogusnets {
0.0.0.0/8; 1.0.0.0/8; 2.0.0.0/8; 192.0.2.0/24; 224.0.0.0/3; 0.0.0.0/8; 1.0.0.0/8; 2.0.0.0/8; 192.0.2.0/24; 224.0.0.0/3;
10.0.0.0/8; 172.16.0.0/12; 192.168.0.0/16; 10.0.0.0/8; 172.16.0.0/12; 192.168.0.0/16;
}; };
// Set up an ACL called our-nets. Replace this with the real IP numbers. // Set up an ACL called our-nets. Replace this with the real IP numbers.
acl our-nets { x.x.x.x/24; x.x.x.x/21; }; acl our-nets { x.x.x.x/24; x.x.x.x/21; };
options { options {
@@ -10574,6 +10589,7 @@ options {
blackhole { bogusnets; }; blackhole { bogusnets; };
... ...
}; };
zone "example.com" { zone "example.com" {
type master; type master;
file "m/example.com"; file "m/example.com";
@@ -10621,7 +10637,7 @@ zone "example.com" {
<title>The <command>chroot</command> Environment</title> <title>The <command>chroot</command> Environment</title>
<para> <para>
In order for a <command>chroot()</command> environment In order for a <command>chroot</command> environment
to to
work properly in a particular directory work properly in a particular directory
(for example, <filename>/var/named</filename>), (for example, <filename>/var/named</filename>),
@@ -10641,7 +10657,7 @@ zone "example.com" {
to set up things like to set up things like
<filename>/dev/zero</filename>, <filename>/dev/zero</filename>,
<filename>/dev/random</filename>, <filename>/dev/random</filename>,
<filename>/dev/log</filename>, and/or <filename>/dev/log</filename>, and
<filename>/etc/localtime</filename>. <filename>/etc/localtime</filename>.
</para> </para>
</sect2> </sect2>
@@ -10827,7 +10843,10 @@ zone "example.com" {
under under
a grant from the US Defense Advanced Research Projects a grant from the US Defense Advanced Research Projects
Administration Administration
(DARPA). Versions of <acronym>BIND</acronym> through (DARPA).
</para>
<para>
Versions of <acronym>BIND</acronym> through
4.8.3 were maintained by the Computer 4.8.3 were maintained by the Computer
Systems Research Group (CSRG) at UC Berkeley. Douglas Terry, Mark Systems Research Group (CSRG) at UC Berkeley. Douglas Terry, Mark
Painter, David Riggle and Songnian Zhou made up the initial <acronym>BIND</acronym> Painter, David Riggle and Songnian Zhou made up the initial <acronym>BIND</acronym>
@@ -11059,13 +11078,13 @@ zone "example.com" {
</biblioentry> </biblioentry>
<biblioentry> <biblioentry>
<abbrev>RFC2671</abbrev> <abbrev>RFC2671</abbrev>
<title>Extension Mechanisms for DNS (EDNS0)</title>
<authorgroup> <authorgroup>
<author> <author>
<firstname>P.</firstname> <firstname>P.</firstname>
<surname>Vixie</surname> <surname>Vixie</surname>
</author> </author>
</authorgroup> </authorgroup>
<title>Extension Mechanisms for DNS (EDNS0)</title>
<pubdate>August 1997</pubdate> <pubdate>August 1997</pubdate>
</biblioentry> </biblioentry>
<biblioentry> <biblioentry>
@@ -12206,6 +12225,7 @@ zone "example.com" {
<xi:include href="../../bin/check/named-checkconf.docbook"/> <xi:include href="../../bin/check/named-checkconf.docbook"/>
<xi:include href="../../bin/check/named-checkzone.docbook"/> <xi:include href="../../bin/check/named-checkzone.docbook"/>
<xi:include href="../../bin/named/named.docbook"/> <xi:include href="../../bin/named/named.docbook"/>
<!-- named.conf.docbook and others? -->
<!-- nsupdate gives db2latex indigestion, markup problems? --> <!-- nsupdate gives db2latex indigestion, markup problems? -->
<xi:include href="../../bin/rndc/rndc.docbook"/> <xi:include href="../../bin/rndc/rndc.docbook"/>
<xi:include href="../../bin/rndc/rndc.conf.docbook"/> <xi:include href="../../bin/rndc/rndc.conf.docbook"/>