[tor-commits] [tor/master] Improve docs on rendezvous circ relaunch.

[nickm@xxxxxxxxxxxxxx]

commit 273638288d4e6516011c4d538e5c1447f4753958
Author: George Kadianakis <desnacked@xxxxxxxxxx>
Date:   Mon Aug 7 12:02:45 2017 +0300

    Improve docs on rendezvous circ relaunch.
---
 src/or/hs_circuit.c | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/src/or/hs_circuit.c b/src/or/hs_circuit.c
index faceb731c..43906619d 100644
--- a/src/or/hs_circuit.c
+++ b/src/or/hs_circuit.c
@@ -682,7 +682,18 @@ hs_circ_service_get_intro_circ(const hs_service_intro_point_t *ip)
 
 /* Called when we fail building a rendezvous circuit at some point other than
  * the last hop: launches a new circuit to the same rendezvous point. This
- * supports legacy service. */
+ * supports legacy service.
+ *
+ * We currently relaunch connections to rendezvous points if:
+ * - A rendezvous circuit timed out before connecting to RP.
+ * - The redenzvous circuit failed to connect to the RP.
+ *
+ * We avoid relaunching a connection to this rendezvous point if:
+ * - We have already tried MAX_REND_FAILURES times to connect to this RP.
+ * - We've been trying to connect to this RP for more than MAX_REND_TIMEOUT
+ *   seconds
+ * - We've already retried this specific rendezvous circuit.
+ */
 void
 hs_circ_retry_service_rendezvous_point(origin_circuit_t *circ)
 {



_______________________________________________
tor-commits mailing list
tor-commits@xxxxxxxxxxxxxxxxxxxx
https://lists.torproject.org/cgi-bin/mailman/listinfo/tor-commits