From: Nick Mathewson <nickm@torproject.org>
Date: Sat, 6 Feb 2016 20:34:47 +0000 (-0500)
Subject: Document port_out argument to tor_addr_from_sockaddr
X-Git-Tag: tor-0.2.8.2-alpha~143
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=2d879bd39febfcce9ce39f13c897951fee7d8784;p=thirdparty%2Ftor.git

Document port_out argument to tor_addr_from_sockaddr
---

diff --git a/src/common/address.c b/src/common/address.c
index 86c32efdd9..70675c0a7a 100644
--- a/src/common/address.c
+++ b/src/common/address.c
@@ -148,7 +148,9 @@ tor_addr_make_af_unix(tor_addr_t *a)
 }
 
 /** Set the tor_addr_t in <b>a</b> to contain the socket address contained in
- * <b>sa</b>. Return 0 on success and -1 on failure. */
+ * <b>sa</b>.  IF <b>port_out</b> is non-NULL and <b>sa</b> contains a port,
+ * set *<b>port_out</b> to that port. Return 0 on success and -1 on
+ * failure. */
 int
 tor_addr_from_sockaddr(tor_addr_t *a, const struct sockaddr *sa,
                        uint16_t *port_out)