mir/bind
2
0
Fork 0
mirror of https://gitlab.isc.org/isc-projects/bind9 synced 2025-08-30 14:07:59 +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.
-->
<!-- 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">
<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
will be adjusted so that the response can be successfully
verified. In any of these cases, the message's rcode is set to
NOTAUTH (not authoritative).
NOTAUTH (not authenticated).
</para>
</sect2>
@@ -3954,7 +3954,7 @@ channel null {
special
property that it only produces output when the server's debug
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.
</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
server's current directory. The format of the file is
described
in <xref linkend="statsfile"/>
in <xref linkend="statsfile"/>.
</para>
</listitem>
</varlistentry>
@@ -5289,7 +5289,7 @@ options {
<para>
See the description of
<command>provide-ixfr</command> in
<xref linkend="server_statement_definition_and_usage"/>
<xref linkend="server_statement_definition_and_usage"/>.
</para>
</listitem>
</varlistentry>
@@ -5300,7 +5300,7 @@ options {
<para>
See the description of
<command>request-ixfr</command> in
<xref linkend="server_statement_definition_and_usage"/>
<xref linkend="server_statement_definition_and_usage"/>.
</para>
</listitem>
</varlistentry>
@@ -5639,7 +5639,8 @@ options {
<para>
When returning authoritative negative responses to
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>
</listitem>
</varlistentry>
@@ -5649,7 +5650,8 @@ options {
<listitem>
<para>
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>
</listitem>
</varlistentry>
@@ -5663,7 +5665,8 @@ options {
the DNSKEY RR to determine if this key should be
used to generate the RRSIG. This flag is ignored
if there are not DNSKEY RRs both with and without
a KSK. Default yes.
a KSK.
The default is <command>yes</command>.
</para>
</listitem>
</varlistentry>
@@ -6204,7 +6207,7 @@ query-source-v6 address * port *;
only supported by relatively new slave servers,
such as <acronym>BIND</acronym> 9, <acronym>BIND</acronym>
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.
The default is <command>many-answers</command>.
<command>transfer-format</command> may be overridden on a
@@ -6417,7 +6420,7 @@ query-source-v6 address * port *;
uses the limit
that was in force when the server was started. See the description
of
<command>size_spec</command> in <xref linkend="configuration_file_elements"/>.
<command> issize_spec</command> in <xref linkend="configuration_file_elements"/>.
</para>
<para>
@@ -6978,8 +6981,8 @@ query-source-v6 address * port *;
<varlistentry>
<term><command>max-cache-ttl</command></term>
<listitem>
<para><command>max-cache-ttl</command>
sets the maximum time for which the server will
<para>
Sets the maximum time for which the server will
cache ordinary (positive) answers. The default is
one week (7 days).
</para>
@@ -6997,7 +7000,7 @@ query-source-v6 address * port *;
</para>
<note>
<simpara>
Not implemented in <acronym>BIND</acronym>9.
Not implemented in <acronym>BIND</acronym> 9.
</simpara>
</note>
</listitem>
@@ -7083,7 +7086,7 @@ query-source-v6 address * port *;
<varlistentry>
<term><command>masterfile-format</command></term>
<listitem>
<para><command>masterfile-format</command> specifies
<para>Specifies
the file format of zone files (see
<xref linkend="zonefile_format"/>).
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>max-clients-per-query</command></term>
<listitem>
<para><command>clients-per-query</command>
and <command>max-clients-per-query</command> set the
<para>These set the
initial value (minimum) and maximum number of recursive
simultanious clients for any given query
(&lt;qname,qtype,qclass&gt;) that the server will accept
@@ -7141,7 +7143,7 @@ query-source-v6 address * port *;
<para>
If <command>max-clients-per-query</command> is set to zero
then there is no upper bound other than imposed by
<command>recurive-clients</command>.
<command>recursive-clients</command>.
</para>
</listitem>
</varlistentry>
@@ -7198,7 +7200,7 @@ query-source-v6 address * port *;
with type <command>TXT</command>, class <command>CHAOS</command>.
This defaults to the hostname of the machine hosting the
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
identify which of a group of anycast servers is actually
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>
disables processing of the queries.
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>.
</para>
</listitem>
@@ -7285,8 +7287,10 @@ query-source-v6 address * port *;
views of class IN. Disabled empty zones are only inherited
from options if there are no disabled empty zones specified
at the view level. To override the options list of disabled
zones you can disable the root zone at the view level
(disable-empty-zone ".";).
zones you can disable the root zone at the view level, for example:
<programlisting>
disable-empty-zone ".";
</programlisting>
</para>
<para>
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.
</para>
<para>
The statistics dump begins with the line <command>+++ Statistics Dump
+++ (973798949)</command>, where the number in parentheses is a standard
The statistics dump begins with a line, like:
</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.
Following
that line are a series of lines containing a counter type, the
@@ -7368,9 +7377,14 @@ query-source-v6 address * port *;
the entire server.
Lines with a zone and view name for the given view and zone (the
view name is
omitted for the default view). The statistics dump ends
with the line <command>--- Statistics Dump --- (973798949)</command>, where the
number is identical to the number in the beginning line.
omitted for the default view).
</para>
<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>
The following statistics counters are maintained:
@@ -8353,23 +8367,12 @@ zone <replaceable>zone_name</replaceable> <optional><replaceable>class</replacea
<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>
<term><command>allow-notify</command></term>
<listitem>
<para>
See the description of
<command>allow-notify</command> in <xref linkend="access_control"/>
<command>allow-notify</command> in <xref linkend="access_control"/>.
</para>
</listitem>
</varlistentry>
@@ -8379,7 +8382,7 @@ zone <replaceable>zone_name</replaceable> <optional><replaceable>class</replacea
<listitem>
<para>
See the description of
<command>allow-query</command> in <xref linkend="access_control"/>
<command>allow-query</command> in <xref linkend="access_control"/>.
</para>
</listitem>
</varlistentry>
@@ -8626,6 +8629,17 @@ zone <replaceable>zone_name</replaceable> <optional><replaceable>class</replacea
</listitem>
</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>
<term><command>max-transfer-time-in</command></term>
<listitem>
@@ -8718,7 +8732,7 @@ zone <replaceable>zone_name</replaceable> <optional><replaceable>class</replacea
<listitem>
<para>
See the description of
<command>transfer-source</command> in <xref linkend="zone_transfers"/>
<command>transfer-source</command> in <xref linkend="zone_transfers"/>.
</para>
</listitem>
</varlistentry>
@@ -8728,7 +8742,7 @@ zone <replaceable>zone_name</replaceable> <optional><replaceable>class</replacea
<listitem>
<para>
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>
</listitem>
</varlistentry>
@@ -8738,7 +8752,7 @@ zone <replaceable>zone_name</replaceable> <optional><replaceable>class</replacea
<listitem>
<para>
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>
</listitem>
</varlistentry>
@@ -8748,7 +8762,7 @@ zone <replaceable>zone_name</replaceable> <optional><replaceable>class</replacea
<listitem>
<para>
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>
</listitem>
</varlistentry>
@@ -8758,7 +8772,7 @@ zone <replaceable>zone_name</replaceable> <optional><replaceable>class</replacea
<listitem>
<para>
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>
</listitem>
</varlistentry>
@@ -8769,7 +8783,7 @@ zone <replaceable>zone_name</replaceable> <optional><replaceable>class</replacea
<listitem>
<para>
See the description of
<command>notify-source</command> in <xref linkend="zone_transfers"/>
<command>notify-source</command> in <xref linkend="zone_transfers"/>.
</para>
</listitem>
</varlistentry>
@@ -8811,7 +8825,7 @@ zone <replaceable>zone_name</replaceable> <optional><replaceable>class</replacea
<listitem>
<para>
See the description of
<command>key-directory</command> in <xref linkend="options"/>
<command>key-directory</command> in <xref linkend="options"/>.
</para>
</listitem>
</varlistentry>
@@ -10400,10 +10414,10 @@ $GENERATE 1-127 $ CNAME $.0</programlisting>
<command>{</command> immediately following the
<command>$</command> as
<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
result as a decimal in a zero padded field of
with 3.
width 3.
Available output forms are decimal
(<command>d</command>), octal
@@ -10417,7 +10431,7 @@ $GENERATE 1-127 $ CNAME $.0</programlisting>
</para>
<para>
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>
</entry>
</row>
@@ -10426,8 +10440,8 @@ $GENERATE 1-127 $ CNAME $.0</programlisting>
<para><command>ttl</command></para>
</entry>
<entry colname="2">
<para><command>ttl</command>
specifies the ttl of the generated records. If
<para>
Specifies the time-to-live of the generated records. If
not specified this will be inherited using the
normal ttl inheritance rules.
</para>
@@ -10442,8 +10456,8 @@ $GENERATE 1-127 $ CNAME $.0</programlisting>
<para><command>class</command></para>
</entry>
<entry colname="2">
<para><command>class</command>
specifies the class of the generated records.
<para>
Specifies the class of the generated records.
This must match the zone class if it is
specified.
</para>
@@ -10470,7 +10484,7 @@ $GENERATE 1-127 $ CNAME $.0</programlisting>
</entry>
<entry colname="2">
<para>
rhs is a domain name. It is processed
A domain name. It is processed
similarly to lhs.
</para>
</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;
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.
acl our-nets { x.x.x.x/24; x.x.x.x/21; };
options {
@@ -10574,6 +10589,7 @@ options {
blackhole { bogusnets; };
...
};
zone "example.com" {
type master;
file "m/example.com";
@@ -10621,7 +10637,7 @@ zone "example.com" {
<title>The <command>chroot</command> Environment</title>
<para>
In order for a <command>chroot()</command> environment
In order for a <command>chroot</command> environment
to
work properly in a particular directory
(for example, <filename>/var/named</filename>),
@@ -10641,7 +10657,7 @@ zone "example.com" {
to set up things like
<filename>/dev/zero</filename>,
<filename>/dev/random</filename>,
<filename>/dev/log</filename>, and/or
<filename>/dev/log</filename>, and
<filename>/etc/localtime</filename>.
</para>
</sect2>
@@ -10827,7 +10843,10 @@ zone "example.com" {
under
a grant from the US Defense Advanced Research Projects
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
Systems Research Group (CSRG) at UC Berkeley. Douglas Terry, Mark
Painter, David Riggle and Songnian Zhou made up the initial <acronym>BIND</acronym>
@@ -11059,13 +11078,13 @@ zone "example.com" {
</biblioentry>
<biblioentry>
<abbrev>RFC2671</abbrev>
<title>Extension Mechanisms for DNS (EDNS0)</title>
<authorgroup>
<author>
<firstname>P.</firstname>
<surname>Vixie</surname>
</author>
</authorgroup>
<title>Extension Mechanisms for DNS (EDNS0)</title>
<pubdate>August 1997</pubdate>
</biblioentry>
<biblioentry>
@@ -12206,6 +12225,7 @@ zone "example.com" {
<xi:include href="../../bin/check/named-checkconf.docbook"/>
<xi:include href="../../bin/check/named-checkzone.docbook"/>
<xi:include href="../../bin/named/named.docbook"/>
<!-- named.conf.docbook and others? -->
<!-- nsupdate gives db2latex indigestion, markup problems? -->
<xi:include href="../../bin/rndc/rndc.docbook"/>
<xi:include href="../../bin/rndc/rndc.conf.docbook"/>