summaryrefslogtreecommitdiff
path: root/src/core
diff options
context:
space:
mode:
authorMike Perry <mikeperry-git@torproject.org>2020-12-10 17:27:55 -0600
committerMike Perry <mikeperry-git@torproject.org>2021-02-18 11:21:25 -0600
commita0690f079d29e13ee6ccaf94e2dca06953a05460 (patch)
tree2383ed3cd955ed614935c3aeb286ee102511e362 /src/core
parent525195a7153d47295de430002f28b4c27192b5c1 (diff)
downloadtor-a0690f079d29e13ee6ccaf94e2dca06953a05460.tar.gz
tor-a0690f079d29e13ee6ccaf94e2dca06953a05460.zip
Update documentation for the number of modes for Xm estimator.
Diffstat (limited to 'src/core')
-rw-r--r--src/core/or/circuitstats.c8
1 files changed, 4 insertions, 4 deletions
diff --git a/src/core/or/circuitstats.c b/src/core/or/circuitstats.c
index 449c055973..066c275b2b 100644
--- a/src/core/or/circuitstats.c
+++ b/src/core/or/circuitstats.c
@@ -205,10 +205,10 @@ circuit_build_times_max_timeouts(void)
* Retrieve and bounds-check the cbtnummodes consensus parameter.
*
* Effect: This value governs how many modes to use in the weighted
- * average calculation of Pareto parameter Xm. A value of 3 introduces
- * some bias (2-5% of CDF) under ideal conditions, but allows for better
- * performance in the event that a client chooses guard nodes of radically
- * different performance characteristics.
+ * average calculation of Pareto parameter Xm. Analysis of pairs of
+ * geographically near, far, and mixed guaeds has shown that a value of
+ * 10 introduces some allows for the actual timeout rate to be within
+ * 2-7% of the cutoff quantile, for quantiles between 60-80%.
*/
static int32_t
circuit_build_times_default_num_xm_modes(void)