Add link anchors into Configuration Reference section of the ARM

This commit is contained in:
Ron Aitchison
2022-04-02 01:06:19 +00:00
committed by Petr Špaček
parent 1322372a0c
commit dc7efb8e60

View File

@@ -9,10 +9,10 @@
.. See the COPYRIGHT file distributed with this work for additional .. See the COPYRIGHT file distributed with this work for additional
.. information regarding copyright ownership. .. information regarding copyright ownership.
.. Reference: .. _reference:
BIND 9 Configuration Reference Configuration Reference
============================== =======================
.. _configuration_file_elements: .. _configuration_file_elements:
@@ -245,7 +245,7 @@ line, as in C++ comments. For example:
in a zone file. The semicolon indicates the end of a in a zone file. The semicolon indicates the end of a
configuration statement. configuration statement.
.. _Configuration_File_Grammar: .. _configuration_file_grammar:
Configuration File Grammar Configuration File Grammar
-------------------------- --------------------------
@@ -284,6 +284,8 @@ The following statements are supported:
``parental-agents`` ``parental-agents``
Defines a named list of servers for inclusion in primary and secondary zones' ``parental-agents`` lists. Defines a named list of servers for inclusion in primary and secondary zones' ``parental-agents`` lists.
.. _primaries:
``primaries`` ``primaries``
Defines a named list of servers for inclusion in stub and secondary zones' ``primaries`` or ``also-notify`` lists. (Note: this is a synonym for the original keyword ``masters``, which can still be used, but is no longer the preferred terminology.) Defines a named list of servers for inclusion in stub and secondary zones' ``primaries`` or ``also-notify`` lists. (Note: this is a synonym for the original keyword ``masters``, which can still be used, but is no longer the preferred terminology.)
@@ -311,6 +313,8 @@ The following statements are supported:
``view`` ``view``
Defines a view. Defines a view.
.. _zone_clause:
``zone`` ``zone``
Defines a zone. Defines a zone.
@@ -586,6 +590,8 @@ handles messages sent to this facility is described in the
version of ``syslog``, which only uses two arguments to the ``openlog()`` version of ``syslog``, which only uses two arguments to the ``openlog()``
function, this clause is silently ignored. function, this clause is silently ignored.
.. _severity:
The ``severity`` clause works like ``syslog``'s "priorities," except The ``severity`` clause works like ``syslog``'s "priorities," except
that they can also be used when writing straight to a file rather that they can also be used when writing straight to a file rather
than using ``syslog``. Messages which are not at least of the severity than using ``syslog``. Messages which are not at least of the severity
@@ -982,6 +988,8 @@ default is used.
administrator's responsibility to ensure that configuration differences in administrator's responsibility to ensure that configuration differences in
different views do not cause disruption with a shared cache. different views do not cause disruption with a shared cache.
.. _directory:
``directory`` ``directory``
This sets the working directory of the server. Any non-absolute pathnames in This sets the working directory of the server. Any non-absolute pathnames in
the configuration file are taken as relative to this directory. the configuration file are taken as relative to this directory.
@@ -1819,9 +1827,11 @@ Boolean Options
unnecessary records are added to the authority or additional unnecessary records are added to the authority or additional
sections. The default is ``no``. sections. The default is ``no``.
.. _notify_st:
``notify`` ``notify``
If set to ``yes`` (the default), DNS NOTIFY messages are sent when a If set to ``yes`` (the default), DNS NOTIFY messages are sent when a
zone the server is authoritative for changes; see :ref:`notify`. zone the server is authoritative for changes; see :ref:`using notify<notify>`.
The messages are sent to the servers listed in the zone's NS records The messages are sent to the servers listed in the zone's NS records
(except the primary server identified in the SOA MNAME field), and to (except the primary server identified in the SOA MNAME field), and to
any servers listed in the ``also-notify`` option. any servers listed in the ``also-notify`` option.
@@ -1845,6 +1855,8 @@ Boolean Options
ultimate primary should be set to still send NOTIFY messages to all the name servers ultimate primary should be set to still send NOTIFY messages to all the name servers
listed in the NS RRset. listed in the NS RRset.
.. _recursion:
``recursion`` ``recursion``
If ``yes``, and a DNS query requests recursion, then the server If ``yes``, and a DNS query requests recursion, then the server
attempts to do all the work required to answer the query. If recursion attempts to do all the work required to answer the query. If recursion
@@ -2310,6 +2322,8 @@ access to the Internet, but wish to look up exterior names anyway.
Forwarding occurs only on those queries for which the server is not Forwarding occurs only on those queries for which the server is not
authoritative and does not have the answer in its cache. authoritative and does not have the answer in its cache.
.. _forward:
``forward`` ``forward``
This option is only meaningful if the forwarders list is not empty. A This option is only meaningful if the forwarders list is not empty. A
value of ``first`` is the default and causes the server to query the value of ``first`` is the default and causes the server to query the
@@ -2317,6 +2331,8 @@ authoritative and does not have the answer in its cache.
server then looks for the answer itself. If ``only`` is server then looks for the answer itself. If ``only`` is
specified, the server only queries the forwarders. specified, the server only queries the forwarders.
.. _forwarders:
``forwarders`` ``forwarders``
This specifies a list of IP addresses to which queries are forwarded. The This specifies a list of IP addresses to which queries are forwarded. The
default is the empty list (no forwarding). Each address in the list can be default is the empty list (no forwarding). Each address in the list can be
@@ -2394,6 +2410,8 @@ for details on how to specify IP address lists.
.. note:: ``allow-query-cache`` is used to specify access to the cache. .. note:: ``allow-query-cache`` is used to specify access to the cache.
.. _allow-query-cache:
``allow-query-cache`` ``allow-query-cache``
This specifies which hosts are allowed to get answers from the cache. If This specifies which hosts are allowed to get answers from the cache. If
``allow-recursion`` is not set, BIND checks to see if the following parameters ``allow-recursion`` is not set, BIND checks to see if the following parameters
@@ -2461,6 +2479,8 @@ for details on how to specify IP address lists.
.. _allow-transfer-access: .. _allow-transfer-access:
.. _allow-transfer:
``allow-transfer`` ``allow-transfer``
This specifies which hosts are allowed to receive zone transfers from the This specifies which hosts are allowed to receive zone transfers from the
server. ``allow-transfer`` may also be specified in the ``zone`` server. ``allow-transfer`` may also be specified in the ``zone``
@@ -2714,6 +2734,8 @@ BIND has mechanisms in place to facilitate zone transfers and set limits
on the amount of load that transfers place on the system. The following on the amount of load that transfers place on the system. The following
options apply to zone transfers. options apply to zone transfers.
.. _also-notify:
``also-notify`` ``also-notify``
This option defines a global list of IP addresses of name servers that are also This option defines a global list of IP addresses of name servers that are also
sent NOTIFY messages whenever a fresh copy of the zone is loaded, in sent NOTIFY messages whenever a fresh copy of the zone is loaded, in
@@ -3114,6 +3136,8 @@ system.
``reserved-sockets`` ``reserved-sockets``
This option is deprecated and no longer has any effect. This option is deprecated and no longer has any effect.
.. _max-cache-size:
``max-cache-size`` ``max-cache-size``
This sets the maximum amount of memory to use for an individual cache This sets the maximum amount of memory to use for an individual cache
database and its associated metadata, in bytes or percentage of total database and its associated metadata, in bytes or percentage of total
@@ -3942,9 +3966,13 @@ away from the infrastructure servers.
This specifies the contact name that appears in the returned SOA record for This specifies the contact name that appears in the returned SOA record for
empty zones. If none is specified, "." is used. empty zones. If none is specified, "." is used.
.. _empty-zones-enable:
``empty-zones-enable`` ``empty-zones-enable``
This enables or disables all empty zones. By default, they are enabled. This enables or disables all empty zones. By default, they are enabled.
.. _disable-empty-zone:
``disable-empty-zone`` ``disable-empty-zone``
This disables individual empty zones. By default, none are disabled. This This disables individual empty zones. By default, none are disabled. This
option can be specified multiple times. option can be specified multiple times.
@@ -5575,6 +5603,8 @@ Here is an example of a typical split DNS setup implemented using
.. _zone_types: .. _zone_types:
.. _type:
Zone Types Zone Types
^^^^^^^^^^ ^^^^^^^^^^
@@ -5828,6 +5858,8 @@ Zone Options
``allow-notify`` ``allow-notify``
See the description of ``allow-notify`` in :ref:`access_control`. See the description of ``allow-notify`` in :ref:`access_control`.
.. _allow-query:
``allow-query`` ``allow-query``
See the description of ``allow-query`` in :ref:`access_control`. See the description of ``allow-query`` in :ref:`access_control`.
@@ -5924,6 +5956,8 @@ Zone Options
.. _file-option: .. _file-option:
.. _file:
``file`` ``file``
This sets the zone's filename. In ``primary``, ``hint``, and ``redirect`` This sets the zone's filename. In ``primary``, ``hint``, and ``redirect``
zones which do not have ``primaries`` defined, zone data is loaded from zones which do not have ``primaries`` defined, zone data is loaded from