From: Nick Mathewson <nickm@torproject.org>
Date: Wed, 17 Oct 2012 15:29:37 +0000 (-0400)
Subject: Document lifespan of return values of the _remote_descr() funcs
X-Git-Tag: tor-0.2.4.4-alpha~9
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=cb9d1237641290dc92b11540b96db036748429be;p=thirdparty%2Ftor.git

Document lifespan of return values of the _remote_descr() funcs
---

diff --git a/src/or/channel.c b/src/or/channel.c
index 13aa007fc0..3acb509a14 100644
--- a/src/or/channel.c
+++ b/src/or/channel.c
@@ -3475,8 +3475,10 @@ channel_listener_dump_transport_statistics(channel_listener_t *chan_l,
  * This function return a test provided by the lower layer of the remote
  * endpoint for this channel; it should specify the actual address connected
  * to/from.
+ *
+ * Subsequent calls to channel_get_{actual,canonical}_remote_{address,descr}
+ * may invalidate the return value from this function.
  */
-
 const char *
 channel_get_actual_remote_descr(channel_t *chan)
 {
@@ -3487,7 +3489,12 @@ channel_get_actual_remote_descr(channel_t *chan)
   return chan->get_remote_descr(chan, GRD_FLAG_ORIGINAL);
 }
 
-/** DOCDOC */
+/**
+ * Return the text address of the remote endpoint.
+ *
+ * Subsequent calls to channel_get_{actual,canonical}_remote_{address,descr}
+ * may invalidate the return value from this function.
+ */
 const char *
 channel_get_actual_remote_address(channel_t *chan)
 {
@@ -3501,8 +3508,10 @@ channel_get_actual_remote_address(channel_t *chan)
  * This function return a test provided by the lower layer of the remote
  * endpoint for this channel; it should use the known canonical address for
  * this OR's identity digest if possible.
+ *
+ * Subsequent calls to channel_get_{actual,canonical}_remote_{address,descr}
+ * may invalidate the return value from this function.
  */
-
 const char *
 channel_get_canonical_remote_descr(channel_t *chan)
 {