man: Missing OverloadStatistics option in tor.1

Closes #40504

Signed-off-by: David Goulet <dgoulet@torproject.org>

diff --git a/changes/ticket40504 b/changes/ticket40504
new file mode 100644 (file)
index 0000000..9095591
--- /dev/null
+++ b/changes/ticket40504
@@ -0,0 +1,3 @@
+  o Documentation (man, relay):
+    - Missing "OverloadStatistics" in tor.1 manpage. Fixes bug 40504; bugfix on
+      0.4.6.1-alpha.

diff --git a/doc/man/tor.1.txt b/doc/man/tor.1.txt
index 89afe5958202a3d9c6782640deba1058dc4a39fe..19693ce2dc50bc0ceb3a52967c3ba94af0f31c83 100644 (file)
--- a/doc/man/tor.1.txt
+++ b/doc/man/tor.1.txt
@@ -2765,6 +2765,26 @@ types of statistics that Tor relays collect and publish:
     is enabled, it will be published as part of the extra-info document.
     (Default: 1)
 
+[[OverloadStatistics]] **OverloadStatistics** *0**|**1**::
+    Relays and bridges only.
+    When this option is enabled, a Tor relay will write an overload general
+    line in the server descriptor if the relay is considered overloaded.
+    (Default: 1)
+     +
+    A relay is considered overloaded if at least one of these conditions is
+    met:
+        - Onionskins are starting to be dropped.
+        - The OOM was invoked.
+
+        - (Exit only) DNS timeout occurs X% of the time over Y seconds (values
+          controlled by consensus parameters, see param-spec.txt).
+     +
+    If ExtraInfoStatistics is enabled, it can also put two more specific
+    overload lines in the extra-info document if at least one of these
+    conditions is met:
+        - TCP Port exhaustion
+        - Connection rate limits have been reached (read and write side).
+
 [[PaddingStatistics]] **PaddingStatistics** **0**|**1**::
     Relays and bridges only.
     When this option is enabled, Tor collects statistics for padding cells