From: Graham Leggett <minfrin@apache.org>
Date: Thu, 1 Dec 2011 14:02:31 +0000 (+0000)
Subject: Update transformation.
X-Git-Tag: 2.5.0-alpha~7762
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=09da58d56c52f689b7b6fb8529eb3cdf4189872b;p=apache

Update transformation.


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

diff --git a/docs/manual/developer/new_api_2_4.html.en b/docs/manual/developer/new_api_2_4.html.en
index d91b005f43..81eb9f9073 100644
--- a/docs/manual/developer/new_api_2_4.html.en
+++ b/docs/manual/developer/new_api_2_4.html.en
@@ -153,6 +153,9 @@
       <li>Modules that load other modules later than the EXEC_ON_READ config
           reading stage need to call ap_reserve_module_slots() or
           ap_reserve_module_slots_directive() in their pre_config hook.</li>
+      <li>The client IP address per request can now be specified independently
+          of the peer IP address of the connection for the benefit of load
+          balancers</li>
     </ul>
   
 
@@ -454,6 +457,26 @@
 
       <dt><code>unixd_config</code></dt>
       <dd>This has been renamed to ap_unixd_config.</dd>
+
+      <dt><code>conn_rec-&gt;remote_ip and conn_rec-&gt;remote_addr</code></dt>
+      <dd>In order to distinguish between the peer IP address of the
+      connection, and the client IP address of the request potentially
+      overridden by a load balancer or proxy, the above variables have
+      been renamed. If a module makes reference to either of the above
+      variables, they need to be replaced with one of the following two
+      options as appropriate for the module:
+      <ul>
+        <li>When you require the IP address of the client, which might
+        be connected directly to the server, or might optionally be
+        separated from the server by a transparent load balancer or
+        proxy, use request_rec-&gt;client_ip and
+        request_rec-&gt;client_addr.</li>
+        <li>When you require the IP address of the peer that is
+        connected directly to the server, which might be the client or
+        might be the load balancer or proxy itself, use
+        conn_rec-&gt;peer_ip and conn_rec-&gt;peer_addr.</li>
+      </ul>
+      </dd>
     </dl>