]> git.ipfire.org Git - thirdparty/bind9.git/commitdiff
Document rndc dnssec -step
authorMatthijs Mekking <matthijs@isc.org>
Thu, 4 Sep 2025 07:45:11 +0000 (09:45 +0200)
committerPetr Špaček <pspacek@isc.org>
Thu, 4 Sep 2025 13:41:43 +0000 (15:41 +0200)
This documentation was missing from !10774.

bin/rndc/rndc.rst

index 9eb39e1254c6d1abd8a420cb2a4fa0e95e9c629c..aaaf33e426dc5bceb6e2fceea6bb038f6730d322 100644 (file)
@@ -180,7 +180,7 @@ Currently supported commands are:
 
    See also :option:`rndc addzone` and :option:`rndc modzone`.
 
-.. option:: dnssec (-status | -rollover -key id [-alg algorithm] [-when time] | -checkds [-key id [-alg algorithm]] [-when time]  published | withdrawn)) zone [class [view]]
+.. option:: dnssec (-status | -step | -rollover -key id [-alg algorithm] [-when time] | -checkds [-key id [-alg algorithm]] [-when time]  published | withdrawn)) zone [class [view]]
 
    This command allows you to interact with the "dnssec-policy" of a given
    zone.
@@ -188,6 +188,13 @@ Currently supported commands are:
    ``rndc dnssec -status`` show the DNSSEC signing state for the specified
    zone.
 
+   ``rndc dnssec -step`` sends a signal to an instance of :iscman:`named` for a
+   zone configured with ``dnssec-policy`` in manual mode, telling it to
+   continue with the operations that had previously been blocked but logged.
+   This gives the human operator a chance to review the log messages,
+   understand what will happen next and then, using ``rndc dnssec -step``, to
+   inform :iscman:`named` to proceed to the next stage.
+
    ``rndc dnssec -rollover`` allows you to schedule key rollover for a
    specific key (overriding the original key lifetime).