From 97f1ffb6b07743125e3accb7d8df2851eadbc63d Mon Sep 17 00:00:00 2001 From: Nick Mathewson Date: Mon, 9 Jan 2023 12:46:17 -0500 Subject: Clarify parameters related to hsv3 protocol. In param-spec, not all of the parameters for onion services had their ranges and defaults listed; I've added those from the code. Also I clarified the units for hsdir_interval, which were not intuitively obvious. --- param-spec.txt | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) (limited to 'param-spec.txt') diff --git a/param-spec.txt b/param-spec.txt index 67c809d..a63ad3b 100644 --- a/param-spec.txt +++ b/param-spec.txt @@ -252,26 +252,34 @@ Table of Contents Minimum/maximum amount of INTRODUCE2 cells allowed per circuits before rotation (actual amount picked at random between these two values). + Min: 0. Max: INT32_MAX. Defaults: 16384, 32768. "hs_intro_min_lifetime", "hs_intro_max_lifetime" -- Minimum/maximum lifetime in seconds that a service should keep an intro point for (actual lifetime picked at random between these two values). + Min: 0. Max: INT32_MAX. Defaults: 18 hours, 24 hours. "hs_intro_num_extra" -- Number of extra intro points a service is allowed to open. This concept comes from proposal #155. + Min: 0. Max: 128. Default: 2. - "hsdir_interval" -- The length of a time period. See + "hsdir_interval" -- The length of a time period, _in minutes_. See rend-spec-v3.txt section [TIME-PERIODS]. + Min: 30. Max: 14400. Default: 1440. "hsdir_n_replicas" -- Number of HS descriptor replicas. + Min: 1. Max: 16. Default: 2. "hsdir_spread_fetch" -- Total number of HSDirs per replica a tor client should select to try to fetch a descriptor. + Min: 1. Max: 128. Default: 3. "hsdir_spread_store" -- Total number of HSDirs per replica a service will upload its descriptor to. + Min: 1. Max: 128. Default: 4 "HSV3MaxDescriptorSize" -- Maximum descriptor size (in bytes). + Min: 1. Max: INT32_MAX. Default: 50000 "hs_service_max_rdv_failures" -- This parameter determines the maximum number of rendezvous attempt an HS service can make per -- cgit v1.2.3-54-g00ecf