- Document the suggestion for a higher value for 'outgoing-range';

  helps when the request list is full.

diff --git a/doc/Changelog b/doc/Changelog
index 7a44ffb90b6dc0279354550436c998df9e8821fa..eaa8e6f83770ea0c624859f0a1143240530135c2 100644 (file)
--- a/doc/Changelog
+++ b/doc/Changelog
@@ -1,6 +1,10 @@
 6 March 2026: Wouter
        - Merge #1415: Add lock unlock for view in memory error handling.
 
+6 March 2026: Yorgos
+       - Document the suggestion for a higher value for 'outgoing-range';
+         helps when the request list is full.
+
 5 March 2026: Wouter
        - Fix for DNS Rebinding Bypass via SVCB/HTTPS Records in Unbound.
          Thanks to Kunta Chu, School of Software, Tsinghua University,

diff --git a/doc/unbound.conf.5.in b/doc/unbound.conf.5.in
index b8c601c79a0798391840435b79c3b4c9231fbf5f..593a76189f768e0f98d903712db8f0b2946bd28c 100644 (file)
--- a/doc/unbound.conf.5.in
+++ b/doc/unbound.conf.5.in
@@ -382,6 +382,10 @@ Default depends on compile options.
 Larger numbers need extra resources from the operating system.
 For performance a very large value is best, use libevent to make this
 possible.
+Should be higher (preferably double) than the value of
+\fI\%num\-queries\-per\-thread\fP to
+account for cases where the request list is full and avoid file descriptor
+starvation.
 .sp
 Default: 4096 (libevent) / 960 (minievent) / 48 (windows)
 .UNINDENT

diff --git a/doc/unbound.conf.rst b/doc/unbound.conf.rst
index fd4a7969cde6bde0d7415493b9c061034c52ab9b..f02087598b155fc883a60b60ff1f5eddb2484d72 100644 (file)
--- a/doc/unbound.conf.rst
+++ b/doc/unbound.conf.rst
@@ -366,6 +366,10 @@ These options are part of the ``server:`` section.
     Larger numbers need extra resources from the operating system.
     For performance a very large value is best, use libevent to make this
     possible.
+    Should be higher (preferably double) than the value of
+    :ref:`num-queries-per-thread<unbound.conf.num-queries-per-thread>` to
+    account for cases where the request list is full and avoid file descriptor
+    starvation.
 
     Default: 4096 (libevent) / 960 (minievent) / 48 (windows)