[tor-commits] [torspec/main] param-spec: Add the DNS timeout overload parameters

[dgoulet at torproject.org]

commit 588cb27710165ad1b72ac41b491070b431d6653b
Author: David Goulet <dgoulet at torproject.org>
Date:   Mon Nov 1 15:03:09 2021 -0400

    param-spec: Add the DNS timeout overload parameters
    
    Signed-off-by: David Goulet <dgoulet at torproject.org>
---
 param-spec.txt | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/param-spec.txt b/param-spec.txt
index f420944..429ec13 100644
--- a/param-spec.txt
+++ b/param-spec.txt
@@ -191,6 +191,21 @@ Table of Contents
     Min: 0. Max: 1. Default: 0.
     First-appeared: 0.2.3.11-alpha
 
+    "overload_dns_timeout_scale_percent" -- This value is a percentage of how
+    many DNS timeout over N seconds we accept before reporting the overload
+    general state. It is scaled by a factor of 1000 in order to be able to
+    represent decimal point. As an example, a value of 1000 means 1%.
+    Min: 0. Max: 100000. Default: 1000.
+    First-appeared: 0.4.6.8
+
+    "overload_dns_timeout_period_secs" -- This value is the period in seconds
+    of the DNS timeout measurements (the N in the
+    "overload_dns_timeout_scale_percent" parameter). For this amount of
+    seconds, we will gather DNS statistics and at the end, we'll do an
+    assessment on the overload general signal with regards to DNS timeouts.
+    Min: 0. Max: 2147483647. Default: 600
+    First-appeared: 0.4.6.8
+
 8. V3 onion service parameters
 
     "hs_intro_min_introduce2", "hs_intro_max_introduce2" --