[tor-commits] [tor/master] Update documentation for the number of modes for Xm estimator.

asn at torproject.org asn at torproject.org
Fri Feb 19 11:21:15 UTC 2021


commit a0690f079d29e13ee6ccaf94e2dca06953a05460
Author: Mike Perry <mikeperry-git at torproject.org>
Date:   Thu Dec 10 17:27:55 2020 -0600

    Update documentation for the number of modes for Xm estimator.
---
 src/core/or/circuitstats.c | 8 ++++----
 1 file 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)





More information about the tor-commits mailing list