From: Petr Špaček <petr.spacek@nic.cz>
Date: Mon, 6 Jan 2020 15:32:52 +0000 (+0100)
Subject: doc: move reorder_RR() into policy/acl/data manipulation section
X-Git-Tag: v5.0.0~8^2~28
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=1543855b491692d817549d557ac96bbbb2fb8dfd;p=thirdparty%2Fknot-resolver.git

doc: move reorder_RR() into policy/acl/data manipulation section
---

diff --git a/daemon/README.rst b/daemon/README.rst
index 6194e0692..59f76755e 100644
--- a/daemon/README.rst
+++ b/daemon/README.rst
@@ -34,15 +34,6 @@ TODO: Basics
       Operation not permitted
 
 
-.. function:: reorder_RR([true | false])
-
-   :param boolean value: New value for the option *(optional)*
-   :return: The (new) value of the option
-
-   If set, resolver will vary the order of resource records within RR-sets.
-   It is disabled by default.
-
-
 .. _`JSON-encoded`: http://json.org/example
 .. _`Learn Lua in 15 minutes`: http://tylerneylon.com/a/learn-lua/
 .. _`PowerDNS Recursor`: https://doc.powerdns.com/md/recursor/scripting/
diff --git a/doc/config.rst b/doc/config.rst
index 2bb771e3b..399f28c0e 100644
--- a/doc/config.rst
+++ b/doc/config.rst
@@ -201,6 +201,12 @@ More fine-grained tools are available in following modules:
 
 Policy, access control, data manipulation
 =========================================
+Features in this section allow to configure what clients can get access to what DNS data, i.e. DNS data filtering and manipulation.
+
+.. contents::
+   :depth: 1
+   :local:
+
 .. include:: ../modules/hints/README.rst
 .. include:: ../modules/stats/README.rst
 .. include:: ../modules/policy/README.rst
@@ -210,6 +216,22 @@ Policy, access control, data manipulation
 .. include:: ../modules/dns64/README.rst
 .. include:: ../modules/renumber/README.rst
 
+Answer reordering
+-----------------
+Certain clients are "dumb" and always connect to first IP address or name found
+in a DNS answer received from resolver intead of picking randomly.
+As a workaround for such broken clients it is possible to randomize
+order of records in DNS answers sent by resolver:
+
+.. function:: reorder_RR([true | false])
+
+   :param boolean new_value: ``true`` to enable or ``false`` to disable randomization *(optional)*
+   :return: The (new) value of the option
+
+   If set, resolver will vary the order of resource records within RR sets.
+   It is disabled by default.
+
+
 
 Performance and resiliency
 ==========================