upstream/bind9
1
0
Fork 0
mirror of https://github.com/isc-projects/bind9.git synced 2026-05-28 04:34:54 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions

Describe rndc server block using .. rndcconf syntax

Browse source 
We need to split the description to silence warnings about undescribed
statements.
This commit is contained in:
Petr Špaček 2022-06-30 14:09:36 +02:00
parent 10f88bffe5
commit 82e2f0b37e
No known key found for this signature in database
GPG key ID: ABD587CDF06581AE
2 changed files with 23 additions and 8 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

27
doc/arm/dns-ops.inc.rst
View file

@ -165,12 +165,27 @@ server.
.. rndcconf:statement:: server
The ``server`` statement associates a key defined using the ``key``
statement with a server. The keyword ``server`` is followed by a host
name or address. The ``server`` statement has two clauses: ``key``
and ``port``. The ``key`` clause specifies the name of the key to be
used when communicating with this server, and the ``port`` clause can
be used to specify the port :iscman:`rndc` should connect to on the server.
The ``server`` statement specifies connection parameters for a given server.
The server can be specified as a host name or address.
.. rndcconf:statement:: addresses
Specifies one or more addresses to use when communicating with this
server.
:rndcconf:ref:`key`
Associates a key defined using the :rndcconf:ref:`key` statement with a
server.
.. rndcconf:statement:: port
Specifes the port :iscman:`rndc` should connect to on the server.
.. rndcconf:statement:: source-address
.. rndcconf:statement:: source-address-v6
Overrides :rndcconf:ref:`default-source-address` and
:rndcconf:ref:`default-source-address-v6` for this specific server.
A sample minimal configuration file is as follows:

4
doc/arm/reference.rst
View file

@ -44,8 +44,8 @@ The file :file:`named.conf` may contain three types of entities:
- Statements define and control specific BIND behaviors.
- Statements may have a single parameter (a **Value**) or multiple parameters
(**Argument/Value** pairs). For example, the :any:`recursion` statement takes a
single value parameter which, in this case, is the string ``yes`` or ``no``
(``recursion yes;``) whereas the :any:`port` statement takes a numeric value
single value parameter - in this case, the string ``yes`` or ``no``
(``recursion yes;``) - while the :namedconf:ref:`port` statement takes a numeric value
defining the DNS port number (``port 53;``). More complex statements take one or
more argument/value pairs. The :any:`also-notify` statement may take a number
of such argument/value pairs, such as ``also-notify port 5353;``,