summaryrefslogtreecommitdiffstats
path: root/doc/config-answer-reordering.rst
diff options
context:
space:
mode:
Diffstat (limited to 'doc/config-answer-reordering.rst')
-rw-r--r--doc/config-answer-reordering.rst17
1 files changed, 17 insertions, 0 deletions
diff --git a/doc/config-answer-reordering.rst b/doc/config-answer-reordering.rst
new file mode 100644
index 0000000..624e7d4
--- /dev/null
+++ b/doc/config-answer-reordering.rst
@@ -0,0 +1,17 @@
+.. SPDX-License-Identifier: GPL-3.0-or-later
+
+Answer reordering
+=================
+Certain clients are "dumb" and always connect to first IP address or name found
+in a DNS answer received from resolver instead 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 enabled by default since 5.3.0.
+