rec: Clarify a bit what an incomning UDP queries processing round is

diff --git a/pdns/pdns_recursor.cc b/pdns/pdns_recursor.cc
index 4cb9df415de1bd2d5b59cdf5d6118dfb5918dcb3..159680227308b0e6f1aae75874b861c449b96474 100644 (file)
--- a/pdns/pdns_recursor.cc
+++ b/pdns/pdns_recursor.cc
@@ -3646,7 +3646,7 @@ int main(int argc, char **argv)
     ::arg().set("max-qperq", "Maximum outgoing queries per query")="50";
     ::arg().set("max-total-msec", "Maximum total wall-clock time per query in milliseconds, 0 for unlimited")="7000";
     ::arg().set("max-recursion-depth", "Maximum number of internal recursion calls per query, 0 for unlimited")="40";
-    ::arg().set("max-udp-queries-per-round", "Maximum number of UDP queries processed per round, before returning back to normal processing")="10000";
+    ::arg().set("max-udp-queries-per-round", "Maximum number of UDP queries processed per recvmsg() round, before returning back to normal processing")="10000";
 
     ::arg().set("include-dir","Include *.conf files from this directory")="";
     ::arg().set("security-poll-suffix","Domain name from which to query security update notifications")="secpoll.powerdns.com.";

diff --git a/pdns/recursordist/docs/settings.rst b/pdns/recursordist/docs/settings.rst
index 8e2004e591aed352321dae700ef0b3354cd70d6b..9432d3b503fcff3e3c25a0d8ad80e9a3ef6ed17c 100644 (file)
--- a/pdns/recursordist/docs/settings.rst
+++ b/pdns/recursordist/docs/settings.rst
@@ -777,8 +777,11 @@ Total maximum number of milliseconds of wallclock time the server may use to ans
 -  Integer
 -  Default: 10000
 
-Maximum number of DNS queries processed in a single round after being woken up by the multiplexer, before
-returning back to normal processing to handle other events.
+Under heavy load the recursor might be busy processing incoming UDP queries for a long while before there is no more of these, and might therefore
+neglect scheduling new ``mthreads``, handling responses from authoritative servers or responding to :doc:`rec_control <manpages/rec_control.1>`
+requests.
+This setting caps the maximum number of incoming UDP DNS queries processed in a single round of looping on ``recvmsg()`` after being woken up by the multiplexer, before
+returning back to normal processing and handling other events.
 
 .. _setting-minimum-ttl-override: