From: Stefan Fritsch <sf@apache.org>
Date: Thu, 26 Apr 2012 21:51:09 +0000 (+0000)
Subject: Try to clarify what client_ip/client_addr means and point to useragent_ip
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=dc1ee571946759215e56f020fb2afc45971b3ab6;p=thirdparty%2Fapache%2Fhttpd.git

Try to clarify what client_ip/client_addr means and point to useragent_ip


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1331115 13f79535-47bb-0310-9956-ffa450edef68
---

diff --git a/include/httpd.h b/include/httpd.h
index ef5f26227ad..c63747b889b 100644
--- a/include/httpd.h
+++ b/include/httpd.h
@@ -1019,6 +1019,7 @@ struct request_rec {
 
     /** remote address information from conn_rec, can be overridden if
      * necessary by a module.
+     * This is the address that originated the request.
      */
     apr_sockaddr_t *useragent_addr;
     char *useragent_ip;
@@ -1064,10 +1065,14 @@ struct conn_rec {
     /* Information about the connection itself */
     /** local address */
     apr_sockaddr_t *local_addr;
-    /** remote address */
+    /** remote address; this is the end-point of the next hop, for the address
+     *  of the request creator, see useragent_addr in request_rec
+     */
     apr_sockaddr_t *client_addr;
 
-    /** Client's IP address */
+    /** Client's IP address; this is the end-point of the next hop, for the
+     *  IP of the request creator, see useragent_ip in request_rec
+     */
     char *client_ip;
     /** Client's DNS name, if known.  NULL if DNS hasn't been checked,
      *  "" if it has and no address was found.  N.B. Only access this though