Document 'notify-cds' configuration option

Add text about the 'notify-cds' option in the ARM reference.
This commit is contained in:
Matthijs Mekking
2025-10-28 11:37:47 +01:00
parent 6554a5f9f7
commit dda2e99c36

View File

@@ -2097,9 +2097,9 @@ Boolean Options
.. namedconf:statement:: notify .. namedconf:statement:: notify
:tags: transfer :tags: transfer
:short: Controls whether ``NOTIFY`` messages are sent on zone changes. :short: Controls whether ``NOTIFY(SOA)`` messages are sent on zone changes.
If set to ``yes`` (the default), DNS NOTIFY messages are sent when a If set to ``yes`` (the default), DNS NOTIFY(SOA) messages are sent when a
zone the server is authoritative for changes; see :ref:`using notify<notify>`. zone the server is authoritative for changes; see :ref:`using notify<notify>`.
The messages are sent to the servers listed in the zone's NS records The messages are sent to the servers listed in the zone's NS records
(except the primary server identified in the SOA MNAME field), and to (except the primary server identified in the SOA MNAME field), and to
@@ -2115,6 +2115,22 @@ Boolean Options
statement. It would only be necessary to turn off this option if it statement. It would only be necessary to turn off this option if it
caused secondary zones to crash. caused secondary zones to crash.
.. namedconf:statement:: notify-cds
:tags: dnssec
:short: Controls whether ``NOTIFY(CDS)`` messages are sent on zone changes.
If set to ``yes``, DNS NOTIFY(CDS) messages are sent when the CDS or CDNSKEY
RRset changes. The messages are sent to the servers listed in the parent
zone's matching DSYNC records. A DSYNC record matches if the owner name under
`_dsync` subdomain of the parent zone corresponds to the given zone. For
example, the zone `child.example` should have a DSYNC record at
`child._dsync.example`. In addition, the RRtype field of the record must be
`CDS` and the Scheme field must be 1 (NOTIFY).
The default is ``no``. The :namedconf:ref:`notify-cds` option may also be
specified in the :any:`zone` statement, in which case it overrides the
``options notify-cds`` statement.
.. namedconf:statement:: notify-to-soa .. namedconf:statement:: notify-to-soa
:tags: transfer :tags: transfer
:short: Controls whether the name servers in the NS RRset are checked against the SOA MNAME. :short: Controls whether the name servers in the NS RRset are checked against the SOA MNAME.