[tor-commits] [tor/master] Correct documentation comments for fields formerly named accepted_intros

[nickm at torproject.org]

commit a2791f43f595d06dbaeff7c4ea0bcecc5c04e2de
Author: Robert Ransom <rransom.8774 at gmail.com>
Date:   Sun Nov 27 09:30:16 2011 -0800

    Correct documentation comments for fields formerly named accepted_intros
---
 src/or/or.h          |    4 ++--
 src/or/rendservice.c |    8 ++++++--
 2 files changed, 8 insertions(+), 4 deletions(-)

diff --git a/src/or/or.h b/src/or/or.h
index dcaea39..3510ab0 100644
--- a/src/or/or.h
+++ b/src/or/or.h
@@ -3508,8 +3508,8 @@ typedef struct rend_intro_point_t {
   /** (Service side only) A digestmap recording the INTRODUCE2 cells
    * this intro point's circuit has received.  Each key is the digest
    * of the RSA-encrypted part of a received INTRODUCE2 cell; each
-   * value is a pointer to the time_t at which the cell was
-   * received. */
+   * value is a pointer to the time_t at which the cell was received.
+   * This digestmap is used to prevent replay attacks. */
   digestmap_t *accepted_intro_rsa_parts;
 
   /** (Service side only) The time at which this intro point was first
diff --git a/src/or/rendservice.c b/src/or/rendservice.c
index 2aa02f9..2c54f30 100644
--- a/src/or/rendservice.c
+++ b/src/or/rendservice.c
@@ -89,8 +89,12 @@ typedef struct rend_service_t {
                          * up-to-date. */
   time_t next_upload_time; /**< Scheduled next hidden service descriptor
                             * upload time. */
-  /** Map from digests of Diffie-Hellman values INTRODUCE2 to time_t of when
-   * they were received; used to prevent replays. */
+  /** Map from digests of Diffie-Hellman values INTRODUCE2 to time_t
+   * of when they were received.  Clients may send INTRODUCE1 cells
+   * for the same rendezvous point through two or more different
+   * introduction points; when they do, this digestmap keeps us from
+   * launching multiple simultaneous attempts to connect to the same
+   * rend point. */
   digestmap_t *accepted_intro_dh_parts;
   /** Time at which we last removed expired values from
    * accepted_intro_dh_parts. */