[tor-commits] [torspec] branch main updated: Clarify parameters related to hsv3 protocol.

[gitolite role]

This is an automated email from the git hooks/post-receive script.

dgoulet pushed a commit to branch main
in repository torspec.

The following commit(s) were added to refs/heads/main by this push:
     new 97f1ffb  Clarify parameters related to hsv3 protocol.
97f1ffb is described below

commit 97f1ffb6b07743125e3accb7d8df2851eadbc63d
Author: Nick Mathewson <nickm at torproject.org>
AuthorDate: Mon Jan 9 12:46:17 2023 -0500

    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(-)

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

-- 
To stop receiving notification emails like this one, please contact
the administrator of this repository.