commit 0b03960f205439945cce6741ce534662c2e6d226 Author: Nick Mathewson nickm@torproject.org Date: Mon Sep 28 09:59:12 2020 -0400
param-spec: add a bunch of miscellaneous documentation. --- param-spec.txt | 70 +++++++++++++++++++++++++++++++++++++++++----------------- 1 file changed, 50 insertions(+), 20 deletions(-)
diff --git a/param-spec.txt b/param-spec.txt index bc28044..1eeba4c 100644 --- a/param-spec.txt +++ b/param-spec.txt @@ -32,14 +32,23 @@ line of a directory consensus. Min: 0, Max: 1. Default: 1. First-appeared: 0.2.4.23, 0.2.5.2-alpha
- "min_paths_for_circs_pct" -- DOCDOC + "min_paths_for_circs_pct" -- A percentage threshold that determines + whether clients believe they have enough directory information to + build circuits. This value applies to the total fraction of + bandwidth-weighted paths that the client could build; see + path-spec.txt for more information. + Min: 25, Max: 95, Default: 60 + First-appeared: 0.2.4
"AllowNonearlyExtend" -- If true, permit EXTEND cells that are not inside RELAY_EARLY cells. Min: 0. Max: 1. Default: 0. First-appeared: 0.2.3.11-alpha
- "ExtendByEd25519ID" -- DOCDOC + "ExtendByEd25519ID" -- If true, clients should include Ed25519 + identities for relays when generating EXTEND2 cells. + Min: 0. Max: 1. Default: 0. + First-appeared: 0.3.0
2. Performance-tuning parameters @@ -74,19 +83,20 @@ line of a directory consensus. Min 1000. Max 4294967295. Default 50000. First-appeared: 0.3.3.6-rc.
- "sendme_emit_min_version" -- Minimum SENDME version that can be sent. - Min: 0. Max: 255. Default 0. First - appeared: 0.4.1.1-alpha. + Min: 0. Max: 255. Default 0. + First appeared: 0.4.1.1-alpha.
"sendme_accept_min_version" -- Minimum SENDME version that is accepted. - Min: 0. Max: 255. Default 0. First - appeared: 0.4.1.1-alpha. - - "KISTSchedRunInterval" -- DOCDOC - - "UseGuardFraction" -- DOCDOC + Min: 0. Max: 255. Default 0. + First appeared: 0.4.1.1-alpha.
+ "KISTSchedRunInterval" -- How frequently should the "KIST" scheduler + run in order to decide which data to write to the network? Value in + units of milliseconds. If 0, then the KIST scheduler should be + disabled. + Min: 0. Max: 100. Default: 10. + First appeared: 0.3.2
3. Voting-related parameters
@@ -185,17 +195,25 @@ line of a directory consensus.
"hs_service_max_rdv_failures" -- This parameter determines the maximum number of rendezvous attempt an HS service can make per - introduction. Min 1. Max 10. Default 2. First-appeared: - 0.3.3.0-alpha. + introduction. + Min 1. Max 10. Default 2. + First-appeared: 0.3.3.0-alpha.
"HiddenServiceEnableIntroDoSDefense" -- This parameter makes tor - start using this new proposed extension if available by the - introduction point (for protover HSIntro=5). Min: 0. Max: - 1. Default: 0. First appeared: 0.4.2.1-alpha. + start using this defense if the introduction point supports it + (for protover HSIntro=5). + Min: 0. Max: 1. Default: 0. + First appeared: 0.4.2.1-alpha.
- "HiddenServiceEnableIntroDoSBurstPerSec" -- DOCDOC + "HiddenServiceEnableIntroDoSBurstPerSec" -- Maximum burst to be used + for token bucket for the introduction point rate-limiting. + Min: 0. Max: INT32_MAX. Default: 200 + First appeared: 0.4.2.1-alpha.
- "HiddenServiceEnableIntroDoSRatePerSec" -- DOCDOC + "HiddenServiceEnableIntroDoSRatePerSec" -- Refill rate to be used + for token bucket for the introduction point rate-limiting. + Min: 0. Max: INT32_MAX. Default: 25 + First appeared: 0.4.2.1-alpha.
9. Denial-of-service parameters
@@ -273,6 +291,11 @@ line of a directory consensus.
11. Guard-related parameters
+ "UseGuardFraction" -- If true, clients use `GuardFraction` + information from the consensus in order to decide how to weight + guards when picking them. + Min: 0. Max: 1. Default: 0. + First appeared: 0.2.6
"guard-confirmed-min-lifetime-days" -- DOCDOC
@@ -304,9 +327,16 @@ line of a directory consensus.
12. Relay behavior
- "assume-reachable" -- DOCDOC + "assume-reachable" -- If true, relays should publish descriptors + even when they cannot make a connection to their IPv4 ORPort. + Min: 0. Max: 1. Default: 0. + First appeared: 0.4.5.1-alpha.
- "assume-reachable-ipv6" -- DOCDOC + "assume-reachable-ipv6" -- If true, relays should publish + descriptors even when they cannot make a connection to their IPv6 + ORPort. + Min: 0. Max: 1. Default: 0. + First appeared: 0.4.5.1-alpha.
X. Obsolete parameters