"primaries" block documentation issues
I'm finding the documentation of the "primaries" block confusing.
The ARM claims a primaries
zone setting is only permissible within mirror, redirect, secondary and stub zones. However I've been using them at least a couple of years within the also-notify
section of primary zones.
There's no direct mention of primaries
in the grammar of an also-notify
block. I suspect that it's covered by <remote-servers>
but the only link between primaries
and remote-servers
is this text in the glossary:
remote-servers: A named list of one or more ip_addresses with optional tls_id, server_key, and/or port. A remote-servers list may include other remote-servers lists. See primaries block.
If in fact a <remote-servers>
reference is a (named) primaries
list, then that ought to be spelled out more explicitly, and the documentation updated to reflect that this can be used in any allow-notify
block in any applicable zone type.
I'd also suggest that the top level grammar ought to actually be called xfer-servers
instead of masters
and then that term used in place of remote-servers
in the ARM. In the NOTIFY case the listed servers are secondaries, not primaries, and it makes no sense to call them primaries.
[remote-servers
also causes confusion with server <prefix> { }
used to specify per-server EDNS overrides, etc]