]> 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:10:49 +0000 (20:10 +0000)
Indicates in `rndc showzone` documentation this command requires the
configuration option `allow-new-zones` to be `true`.

bin/rndc/rndc.rst

index 6ffd32fe49ea961e2d1cdf988a7944bf9a22c46d..eb08f94da42ced0136660317b0552e02090a1338 100644 (file)
@@ -128,10 +128,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
@@ -335,10 +335,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
@@ -537,9 +537,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]]