]> git.ipfire.org Git - thirdparty/bind9.git/commitdiff
Fix Tools for Use With the Name Server Daemon in the ARM
authorSuzanne Goldlust <sgoldlust@isc.org>
Fri, 9 Jul 2021 20:32:59 +0000 (20:32 +0000)
committerPetr Špaček <pspacek@isc.org>
Thu, 10 Mar 2022 20:58:36 +0000 (21:58 +0100)
Remove outdated command references from ARM section
3.3.1. Tools for Use With the Name Server Daemon
and replace them with links to man pages.

Fixes: #2799
(cherry picked from commit 2d2d87a615103ce86961978e0dc1c2daa9593429)

doc/arm/configuration.rst

index 659312e4e90b6d5a909994eebd360b774a34aa3b..0b8d8ecf09381e2bfda0cb81569e97d67d226336 100644 (file)
@@ -160,25 +160,16 @@ output format.
    mode, which executes a query for each in a list of several query
    lines. All query options are accessible from the command line.
 
-   ``dig [@server] domain [query-type][query-class][+query-option][-dig-option][%comment]``
-
-   The usual simple use of ``dig`` takes the form
-
-   ``dig @server domain query-type query-class``
-
    For more information and a list of available commands and options,
-   see the ``dig`` man page.
+   see :ref:`man_dig`.
 
 ``host``
    The ``host`` utility emphasizes simplicity and ease of use. By
    default, it converts between host names and Internet addresses, but
    its functionality can be extended with the use of options.
 
-   ``host [-aCdlnrsTwv][-c class][-N ndots][-t type][-W timeout][-R retries]
-   [-m flag][-4][-6] hostname [server]``
-
    For more information and a list of available commands and options,
-   see the ``host`` man page.
+   see :ref:`man_host`.
 
 ``nslookup``
    ``nslookup`` has two modes: interactive and non-interactive.
@@ -187,17 +178,6 @@ output format.
    hosts in a domain. Non-interactive mode is used to print just the
    name and requested information for a host or domain.
 
-   ``nslookup [-option][ [host-to-find]|[-[server]] ]``
-
-   Interactive mode is entered when no arguments are given (the default
-   name server is used) or when the first argument is a hyphen
-   (``-``) and the second argument is the host name or Internet address of
-   a name server.
-
-   Non-interactive mode is used when the name or Internet address of the
-   host to be looked up is given as the first argument. The optional
-   second argument specifies the host name or address of a name server.
-
    Due to its arcane user interface and frequently inconsistent
    behavior, we do not recommend the use of ``nslookup``. Use ``dig``
    instead.
@@ -214,26 +194,26 @@ server.
    The ``named-checkconf`` program checks the syntax of a ``named.conf``
    file.
 
-   ``named-checkconf [-jvz][-t directory][filename]``
+   For more information and a list of available commands and options,
+   see :ref:`man_named-checkconf`.
 
 ``named-checkzone``
    The ``named-checkzone`` program checks a zone file for syntax and
    consistency.
 
-   ``named-checkzone [-djqvD][-c class][-o output][-t directory][-w directory]
-   [-k (ignore|warn|fail)][-n (ignore|warn|fail)][-W (ignore|warn)] zone [filename]``
+   For more information and a list of available commands and options,
+   see :ref:`man_named-checkzone`.
 
 ``named-compilezone``
-   This tool is similar to ``named-checkzone,`` but it always dumps the zone content
+   This tool is similar to ``named-checkzone`` but it always dumps the zone content
    to a specified file (typically in a different format).
 
+   For more information and a list of available commands and options,
+   see :ref:`man_named-compilezone`.
+
 ``rndc``
    The remote name daemon control (``rndc``) program allows the system
-   administrator to control the operation of a name server. If ``rndc`` is run
-   without any options, it displays a usage message as
-   follows:
-
-   ``rndc [-c config][-s server][-p port][-y key] command [command...]``
+   administrator to control the operation of a name server.
 
    See :ref:`man_rndc` for details of the available ``rndc``
    commands.