From: Mark Andrews Date: Wed, 17 May 2006 01:52:27 +0000 (+0000) Subject: grammer, spelling and clarity X-Git-Tag: v9.3.3b1~26 X-Git-Url: http://git.ipfire.org/gitweb/?a=commitdiff_plain;h=b51dbb3f9cbc67c278c8f0d97aa6e7daeecdfa45;p=thirdparty%2Fbind9.git grammer, spelling and clarity --- diff --git a/doc/arm/Bv9ARM-book.xml b/doc/arm/Bv9ARM-book.xml index c51297aa451..350f366da46 100644 --- a/doc/arm/Bv9ARM-book.xml +++ b/doc/arm/Bv9ARM-book.xml @@ -18,7 +18,7 @@ - PERFORMANCE OF THIS SOFTWARE. --> - + BIND 9 Administrator Reference Manual @@ -1418,7 +1418,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 authorised). + NOTAUTH (not authenticated). @@ -2580,7 +2580,7 @@ channel null { The default_debug channel has the special property that it only produces output when the server's debug level is -nonzero. It normally writes to a file named.run +nonzero. It normally writes to a file called named.run in the server's working directory. For security reasons, when the "" @@ -3006,7 +3006,7 @@ double quotes. to when instructed to do so using rndc stats. If not specified, the default is named.stats in the server's current directory. The format of the file is described -in +in . port @@ -3319,7 +3319,7 @@ in . See also See the description of provide-ixfr in - +. request-ixfr @@ -3327,7 +3327,7 @@ See the description of See the description of request-ixfr in - +. treat-cr-as-space @@ -3786,7 +3786,8 @@ resource record transferred. possible into a message. many-answers is more efficient, but is only supported by relatively new slave servers, such as BIND 9, BIND 8.x and patched -versions of BIND 4.9.5. The default is +versions of BIND 4.9.5. The many-answers +format is also supported by recent Microsoft Windows nameservers. The default is many-answers. transfer-format may be overridden on a per-server basis by using the server statement. @@ -3920,8 +3921,8 @@ example, 1G can be used instead of 1073741824 to specify a limit of one gigabyte. unlimited requests unlimited use, or the maximum available amount. default uses the limit -that was in force when the server was started. See the description of -size_spec in size_spec in . The following options set operating system resource limits for @@ -4272,7 +4273,7 @@ be silently truncated to 7 days if set to a greater value. max-cache-ttl -max-cache-ttl sets +Sets the maximum time for which the server will cache ordinary (positive) answers. The default is one week (7 days). @@ -4282,7 +4283,7 @@ answers. The default is one week (7 days). is required for a request for the root servers to be accepted. Default is 2. -Not implemented in BIND9. +Not implemented in BIND 9. sig-validity-interval @@ -4359,7 +4360,7 @@ disables processing of the queries. the name hostname.bind with type TXT, class CHAOS. This defaults to the hostname of the machine hosting the name server as -found by gethostname(). The primary purpose of such queries is to +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 hostname none; disables processing of the queries. @@ -4374,7 +4375,7 @@ identify which of a group of anycast servers is actually answering your queries. Specifying server-id none; disables processing of the queries. Specifying server-id hostname; will cause named to -use the hostname as found by gethostname(). +use the hostname as found by the gethostname() function. The default server-id is none. @@ -4390,16 +4391,25 @@ The default server-id is none. is similar, but not identical, to that generated by BIND 8. -The statistics dump begins with the line +++ Statistics Dump -+++ (973798949), where the number in parentheses is a standard +The statistics dump begins with a line, like: + + +++ Statistics Dump +++ (973798949) + + The numberr 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 value of the counter, optionally a zone name, and optionally a view name. The lines without view and zone listed are global statistics for 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 --- Statistics Dump --- (973798949), where the -number is identical to the number in the beginning line. +omitted for the default view). + + +The statistics dump ends with the line where the +number is identical to the number in the beginning line; for example: + + +--- Statistics Dump --- (973798949) + The following statistics counters are maintained: CHAOSallow-notify See the description of -allow-notify in +allow-notify in . allow-query See the description of -allow-query in +allow-query in . allow-transfer @@ -5099,31 +5109,31 @@ information for this zone, which can be dumped to the transfer-source See the description of -transfer-source in +transfer-source in . transfer-source-v6 See the description of -transfer-source-v6 in +transfer-source-v6 in . alt-transfer-source See the description of -alt-transfer-source in +alt-transfer-source in . alt-transfer-source-v6 See the description of -alt-transfer-source-v6 in +alt-transfer-source-v6 in . use-alt-transfer-source See the description of -use-alt-transfer-source in +use-alt-transfer-source in . @@ -5156,7 +5166,7 @@ See the description in . key-directory See the description of -key-directory in +key-directory in . multi-master @@ -5845,8 +5855,8 @@ e.g. \$. The $ may optionally be followed by modifiers which change the offset from the iterator, field width and base. Modifiers are introduced by a { immediately following the $ as ${offset[,width[,base]]}. -e.g. ${-20,3,d} which subtracts 20 from the current value, -prints the result as a decimal in a zero padded field of with 3. Available +For example, ${-20,3,d} which subtracts 20 from the current value, +prints the result as a decimal in a zero padded field of width 3. Available output forms are decimal (d), octal (o) and hexadecimal (x or X for uppercase). The default modifier is ${0,0,d}. @@ -5854,11 +5864,11 @@ If the lhs is not absolute, the current $ORIGIN is appended to the name. For compatibility with earlier versions $$ is still -recognized a indicating a literal $ in the output. +recognized as indicating a literal $ in the output. ttl - ttl specifies the + Specifies the ttl of the generated records. If not specified this will be inherited using the normal ttl inheritance rules. class and ttl can be @@ -5866,7 +5876,7 @@ recognized a indicating a literal $ in the output. class - class specifies the + Specifies the class of the generated records. This must match the zone class if it is specified. class and ttl can be @@ -5879,7 +5889,7 @@ PTR, CNAME, DNAME, A, AAAA and NS. rhs - rhs is a domain name. It is processed + A domain name. It is processed similarly to lhs. @@ -5909,6 +5919,7 @@ your server. // Set up an ACL named "bogusnets" that will block RFC1918 space, // which is commonly used in spoofing attacks. 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 { @@ -5920,6 +5931,7 @@ options { blackhole { bogusnets; }; ... }; + zone "example.com" { type master; file "m/example.com"; @@ -5947,7 +5959,7 @@ user 202: The <command>chroot</command> Environment -In order for a chroot() environment to +In order for a chroot environment to work properly in a particular directory (for example, /var/named), you will need to set up an environment that includes everything @@ -5965,7 +5977,7 @@ However, depending on your operating system, you may need to set up things like /dev/zero, /dev/random, -/dev/log, and/or +/dev/log, and /etc/localtime. @@ -6102,7 +6114,10 @@ Center (SRI-NIC). A DNS server for Unix machines, the Berkele Name Domain (BIND) package, was written soon after by a group of graduate students at the University of California at Berkeley under a grant from the US Defense Advanced Research Projects Administration -(DARPA). Versions of BIND through 4.8.3 were maintained by the Computer +(DARPA). + + +Versions of BIND 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 BIND project team. After that, additional work on the software package