diff --git a/doc/arm/Bv9ARM-book.xml b/doc/arm/Bv9ARM-book.xml index d3099eb4ec..218abcfc36 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 @@ -9414,15 +9414,20 @@ deny-answer-aliases { "example.net"; }; Among applicable zones, use the RPZ that appears first in the response-policy option. + Prefer QNAME to IP to NSDNAME to NSIP policy records in a single RPZ + Among applicable NSDNAME policy records, prefer the policy record that matches the lexically smallest name + Among IP or NSIP policy records, prefer the record with the longest prefix. + Among records with the same prefex length, prefer the IP or NSIP policy record that matches the smallest IP address. + @@ -9459,19 +9464,23 @@ deny-answer-aliases { "example.net"; }; A CNAME whose target is the root domain (.) specifies the NXDOMAIN policy, which generates an NXDOMAIN response. + A CNAME whose target is the wildcard top-level domain (*.) specifies the NODATA policy, which rewrites the response to NODATA or ANCOUNT=1. + A CNAME whose target is a wildcard hostname such as *.example.com is used normally after the astrisk (*) has been replaced with the query name. These records are usually resolved with ordinary CNAMEs outside the policy zones. They can be useful for logging. + The PASSTHRU policy is specified by a CNAME whose target is the variable part of its own owner name. It causes the response to not be rewritten and is most often used to "poke holes" in policies for CIDR blocks. + @@ -9483,6 +9492,7 @@ deny-answer-aliases { "example.net"; }; use this mechanism to redirect domains to its own walled garden. GIVEN says "do not override." + DISABLED causes policy records to do nothing but log what they might have done. The response to the DNS query will be written according to @@ -9490,16 +9500,21 @@ deny-answer-aliases { "example.net"; }; Policy zones overridden with DISABLED should appear first, because they will often not be logged if a higher precedence policy is found first. + PASSTHRU causes all policy records to act as if they were CNAME records with targets the variable part of their owner name. They protect the response from being changed. + NXDOMAIN causes all RPZ records to specify NXDOMAIN policies. + NODATA overrides with the NODATA policy + CNAME domain causes all RPZ policy records to act as if they were "cname domain" records. +