[tor-commits] [tor/master] Document the new exit_source_out argument to addressmap_rewrite

[nickm at torproject.org]

commit b2be6c7f9716ec18c0fb57f10d2bfdf8c1569d3e
Author: Nick Mathewson <nickm at torproject.org>
Date:   Mon Jun 4 17:15:21 2012 -0400

    Document the new exit_source_out argument to addressmap_rewrite
---
 src/or/connection_edge.c |    7 ++++++-
 1 files changed, 6 insertions(+), 1 deletions(-)

diff --git a/src/or/connection_edge.c b/src/or/connection_edge.c
index b15e135..12f9d6b 100644
--- a/src/or/connection_edge.c
+++ b/src/or/connection_edge.c
@@ -1096,7 +1096,12 @@ addressmap_match_superdomains(char *address)
  * expiry time of the result, or to <b>time_max</b> if the result does
  * not expire.
  *
- * DOCDOC exit_source_out;
+ * If <b>exit_source_out</b> is non-null, we set it as follows.  If we the
+ * address starts out as a non-exit address, and we remap it to an .exit
+ * address at any point, then set *<b>exit_source_out</b> to the
+ * address_entry_source_t of the first such rule.  Set *<b>exit_source_out</b>
+ * to ADDRMAPSRC_NONE if there is no such rewrite.
+ *
  */
 int
 addressmap_rewrite(char *address, size_t maxlen, time_t *expires_out,