]> git.ipfire.org Git - thirdparty/bind9.git/commitdiff
document config option dependency for showzone
authorColin Vidal <colin@isc.org>
Tue, 21 Oct 2025 08:19:29 +0000 (10:19 +0200)
committerEvan Hunt <each@isc.org>
Thu, 23 Oct 2025 20:11:45 +0000 (20:11 +0000)
Indicates in `rndc showzone` documentation this command requires the
configuration option `allow-new-zones` to be `true`.

(cherry picked from commit 7c02b1df0717ef622f2956b113fb2b9082d2df33)

bin/rndc/rndc.rst

index f34975bacae37e6cd87ae032c64f8d1897c712a4..ab41c1b1ce4288fbaf9fc1c45f5ce288f4ecb158 100644 (file)
@@ -122,10 +122,10 @@ Currently supported commands are:
 
 .. option:: addzone zone [class [view]] configuration
 
-   This command adds a zone while the server is running. This command requires the
-   ``allow-new-zones`` option to be set to ``yes``. The configuration
-   string specified on the command line is the zone configuration text
-   that would ordinarily be placed in :iscman:`named.conf`.
+   This command adds a zone while the server is running. This command
+   requires the ``allow-new-zones`` option to be set to ``yes``. The
+   configuration string specified on the command line is the zone
+   configuration text that would ordinarily be placed in :iscman:`named.conf`.
 
    The configuration is saved in a file called ``viewname.nzf`` (or, if
    :iscman:`named` is compiled with liblmdb, an LMDB database file called
@@ -298,10 +298,10 @@ Currently supported commands are:
 
 .. option:: modzone zone [class [view]] configuration
 
-   This command modifies the configuration of a zone while the server is running. This
-   command requires the ``allow-new-zones`` option to be set to ``yes``.
-   As with ``addzone``, the configuration string specified on the
-   command line is the zone configuration text that would ordinarily be
+   This command modifies the configuration of a zone while the server is
+   running. This command requires the ``allow-new-zones`` option to be set
+   to ``yes``.  As with ``addzone``, the configuration string specified on
+   the command line is the zone configuration text that would ordinarily be
    placed in :iscman:`named.conf`.
 
    If the zone was originally added via :option:`rndc addzone`, the
@@ -480,9 +480,11 @@ Currently supported commands are:
 
 .. option:: showzone zone [class [view]]
 
-   This command prints the configuration of a running zone.
+   If the server is configured with ``allow-new-zones`` set to ``yes``,
+   then this command prints the configuration of a running zone.
 
-   See also :option:`rndc zonestatus`.
+   See also :option:`rndc addzone`, :option:`rndc modzone`.
+   and :option:`rndc delzone`.
 
 .. option:: sign zone [class [view]]