diff --git a/doc/arm/reference.rst b/doc/arm/reference.rst index 34e2490aeb..a777a268bb 100644 --- a/doc/arm/reference.rst +++ b/doc/arm/reference.rst @@ -3149,6 +3149,17 @@ for details on how to specify IP address lists. from or use to resolve a query. Queries from these addresses are not responded to. The default is ``none``. + When configuring this list, note that BIND evaluates Access Control Lists + sequentially (first match wins). A common misconception is that the directive + ``!address;`` blocks everything except that address. In reality, it only + explicitly exempts ``address`` from the blackhole; all other IP addresses + reach the end of the list without matching, meaning they are also not + blackholed. + + To successfully blackhole all traffic *except* specific addresses, you must + explicitly catch the remaining traffic with ``any;`` at the end of the list. + For example: ``!address; any;`` + .. namedconf:statement:: keep-response-order :tags: server :short: Defines an :any:`address_match_list` of addresses which do not accept reordered answers within a single TCP stream.