aboutsummaryrefslogtreecommitdiff
path: root/spec/param-spec.md
diff options
context:
space:
mode:
Diffstat (limited to 'spec/param-spec.md')
-rw-r--r--spec/param-spec.md26
1 files changed, 21 insertions, 5 deletions
diff --git a/spec/param-spec.md b/spec/param-spec.md
index 088ee77..d2bfff8 100644
--- a/spec/param-spec.md
+++ b/spec/param-spec.md
@@ -305,22 +305,38 @@ introduction.
Min 1. Max 10. Default 2.
First-appeared: 0.3.3.0-alpha.
-"HiddenServiceEnableIntroDoSDefense" -- This parameter makes tor
-start using this defense if the introduction point supports it
-(for protover HSIntro=5).
+<a id="HiddenServiceEnableIntroDoSDefense"></a>
+"HiddenServiceEnableIntroDoSDefense" -- This parameter makes
+introduction points
+start using a rate-limiting defense if they support it.
+Introduction points use this value when no
+[`DOS_PARAMS` extension] is sent in the ESTABLISH_INTRO message.
Min: 0. Max: 1. Default: 0.
First appeared: 0.4.2.1-alpha.
-"HiddenServiceEnableIntroDoSBurstPerSec" -- Maximum burst to be used
+<a id="HiddenServiceEnableIntroDoSBurstPerSec"></a>
+"HiddenServiceEnableIntroDoSBurstPerSec" -- Default maximum burst
+rate to be used
for token bucket for the introduction point rate-limiting.
+Introduction points use this value when no
+[`DOS_PARAMS` extension] is sent in the ESTABLISH_INTRO message.
Min: 0. Max: INT32_MAX. Default: 200
First appeared: 0.4.2.1-alpha.
-"HiddenServiceEnableIntroDoSRatePerSec" -- Refill rate to be used
+> Note that the above parameter is slightly misnamed:
+> a burst is not meaningfully "per second".
+
+<a id="HiddenServiceEnableIntroDoSRatePerSec"></a>
+"HiddenServiceEnableIntroDoSRatePerSec" -- Default maximum rate per second
+to be used
for token bucket for the introduction point rate-limiting.
+Introduction points use this value when no
+[`DOS_PARAMS` extension] is sent.
Min: 0. Max: INT32_MAX. Default: 25
First appeared: 0.4.2.1-alpha.
+[`DOS_PARAMS` extension]: ./rend-spec/introduction-protocol.md#DOS_PARAMS
+
<a id="param-spec.txt-9"></a>
## Denial-of-service parameters {#dos}