diff --git a/doc/arm/Bv9ARM-book.xml b/doc/arm/Bv9ARM-book.xml index 550e24249c..a09b8d340b 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 @@ -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). @@ -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 named.run + nonzero. It normally writes to a file called named.run in the server's working directory. @@ -4661,7 +4661,7 @@ digits" + "tkey-domain". In most cases, If not specified, the default is named.stats in the server's current directory. The format of the file is described - in + in . @@ -5289,7 +5289,7 @@ options { See the description of provide-ixfr in - + . @@ -5300,7 +5300,7 @@ options { See the description of request-ixfr in - + . @@ -5639,7 +5639,8 @@ options { 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 yes. @@ -5649,7 +5650,8 @@ options { When caching a negative response to a SOA query - set the TTL to zero. Default no. + set the TTL to zero. + The default is no. @@ -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 yes. @@ -6204,7 +6207,7 @@ query-source-v6 address * port *; only supported by relatively new slave servers, such as BIND 9, BIND 8.x and BIND 4.9.5 onwards. - The many-answers format also supported by + The many-answers format is also supported by recent Microsoft Windows nameservers. The default is many-answers. transfer-format 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 - size_spec in . + issize_spec in . @@ -6978,8 +6981,8 @@ query-source-v6 address * port *; max-cache-ttl - max-cache-ttl - 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 one week (7 days). @@ -6997,7 +7000,7 @@ query-source-v6 address * port *; - Not implemented in BIND9. + Not implemented in BIND 9. @@ -7083,7 +7086,7 @@ query-source-v6 address * port *; masterfile-format - masterfile-format specifies + Specifies the file format of zone files (see ). The default value is text, which is the @@ -7114,8 +7117,7 @@ query-source-v6 address * port *; clients-per-query max-clients-per-query - clients-per-query - and max-clients-per-query set the + These set the initial value (minimum) and maximum number of recursive simultanious clients for any given query (<qname,qtype,qclass>) that the server will accept @@ -7141,7 +7143,7 @@ query-source-v6 address * port *; If max-clients-per-query is set to zero then there is no upper bound other than imposed by - recurive-clients. + recursive-clients. @@ -7198,7 +7200,7 @@ query-source-v6 address * port *; 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 + 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; @@ -7219,7 +7221,7 @@ query-source-v6 address * port *; 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. @@ -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: + + disable-empty-zone "."; + If you are using the address ranges covered here you should @@ -7357,8 +7361,13 @@ query-source-v6 address * port *; 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 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 --- 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: @@ -8353,23 +8367,12 @@ zone zone_name class - - journal - - - Allow the default journal's file name to be overridden. - The default is the zone's file with ".jnl" appended. - This is applicable to master and slave zones. - - - - allow-notify See the description of - allow-notify in + allow-notify in . @@ -8379,7 +8382,7 @@ zone zone_name class See the description of - allow-query in + allow-query in . @@ -8626,6 +8629,17 @@ zone zone_name class + + journal + + + Allow the default journal's file name to be overridden. + The default is the zone's file with ".jnl" appended. + This is applicable to master and slave zones. + + + + max-transfer-time-in @@ -8718,7 +8732,7 @@ zone zone_name class See the description of - transfer-source in + transfer-source in . @@ -8728,7 +8742,7 @@ zone zone_name class See the description of - transfer-source-v6 in + transfer-source-v6 in . @@ -8738,7 +8752,7 @@ zone zone_name class See the description of - alt-transfer-source in + alt-transfer-source in . @@ -8748,7 +8762,7 @@ zone zone_name class See the description of - alt-transfer-source-v6 in + alt-transfer-source-v6 in . @@ -8758,7 +8772,7 @@ zone zone_name class See the description of - use-alt-transfer-source in + use-alt-transfer-source in . @@ -8769,7 +8783,7 @@ zone zone_name class See the description of - notify-source in + notify-source in . @@ -8811,7 +8825,7 @@ zone zone_name class See the description of - key-directory in + key-directory in . @@ -10400,10 +10414,10 @@ $GENERATE 1-127 $ CNAME $.0 { immediately following the $ as ${offset[,width[,base]]}. - e.g. ${-20,3,d} which + For example, ${-20,3,d} 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 (d), octal @@ -10417,7 +10431,7 @@ $GENERATE 1-127 $ CNAME $.0 For compatibility with earlier versions $$ is still - recognized a indicating a literal $ in the output. + recognized as indicating a literal $ in the output. @@ -10426,8 +10440,8 @@ $GENERATE 1-127 $ CNAME $.0 ttl - ttl - 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 normal ttl inheritance rules. @@ -10442,8 +10456,8 @@ $GENERATE 1-127 $ CNAME $.0 class - class - specifies the class of the generated records. + + Specifies the class of the generated records. This must match the zone class if it is specified. @@ -10470,7 +10484,7 @@ $GENERATE 1-127 $ CNAME $.0 - rhs is a domain name. It is processed + A domain name. It is processed similarly to lhs. @@ -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" { The <command>chroot</command> Environment - In order for a chroot() environment + In order for a chroot environment to work properly in a particular directory (for example, /var/named), @@ -10641,7 +10657,7 @@ zone "example.com" { to set up things like /dev/zero, /dev/random, - /dev/log, and/or + /dev/log, and /etc/localtime. @@ -10827,7 +10843,10 @@ zone "example.com" { under a grant from the US Defense Advanced Research Projects Administration - (DARPA). Versions of BIND through + (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 @@ -11059,13 +11078,13 @@ zone "example.com" { RFC2671 - Extension Mechanisms for DNS (EDNS0) P. Vixie + Extension Mechanisms for DNS (EDNS0) August 1997 @@ -12206,6 +12225,7 @@ zone "example.com" { +