Commit 637dbea6 authored by Silvio Rhatto's avatar Silvio Rhatto
Browse files

Merge branch 'fix/docs' into 'main' 

Fix: docs: balance: hardmaps: effectiveness: minor updates

See merge request tpo/onion-services/onionspray!41
parents 773d543e ce7907c2

docs/guides/balance/hardmaps.md

+7 −6
Original line number Diff line number Diff line
@@ -25,10 +25,10 @@ as it depends on a random internal timer set to an interval between 60 and 
120 minutes to re-publish descriptors (or a irregular event that requires

republishing). [According to the specification][],



> Specifically, every time a hidden service publishes its descriptor, it also

> sets up a timer for a random time between 60 minutes and 120 minutes in the

> future. When the timer triggers, the hidden service needs to publish its

> descriptor again to the responsible HSDirs for that time period.

> every time a hidden service publishes its descriptor, it also sets up a timer

> for a random time between 60 minutes and 120 minutes in the future. When the

> timer triggers, the hidden service needs to publish its descriptor again to

> the responsible HSDirs for that time period.



Republishing happens mostly because descriptors expire in the Tor network after

around 3 hours, and so the service keeps updating it at a random time every
@@ -43,9 +43,9 @@ descriptor before that 60-120 minute timeframe[^descriptor-republishing]: 
3. Introduction point rotation (based on number of introduction or time that is

   random time between 18 to 24h).

4. Hashring changes. Basically, if the directory information changes and we

   noticed the hashring changes, there is a republish (with every new network

   noticed the hashring changed, there is a republish (with every new Tor network

   consensus).

5. SRV changes (consensus).

5. [SRV changes][] (consensus).



All these events and timers influences the republishing pattern, so that's

why it's so unpredictable.
@@ -61,6 +61,7 @@ hours), increasing the effectiveness of the `hardmap`-based load balancing. 


[between 105 and 120 minutes]: https://spec.torproject.org/hspow-spec/v1-equix.html#parameter-descriptor

[may trigger a republish every 5 minutes]: https://spec.torproject.org/hspow-spec/common-protocol.html#service-effort

[SRV changes]: https://spec.torproject.org/srv-spec/specification.html?highlight=shared%20random#SRVOTE



!!! tip "Use softmaps to have a more evenly distributed load balancing"