From f92e5b620a34a674f364b25c46f37fa7c7ec9760 Mon Sep 17 00:00:00 2001
From: Graham Leggett <minfrin@apache.org>
Date: Thu, 1 Dec 2011 14:04:30 +0000
Subject: [PATCH] Update transformations.

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1209090 13f79535-47bb-0310-9956-ffa450edef68
---
 docs/manual/developer/new_api_2_4.html.en | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/docs/manual/developer/new_api_2_4.html.en b/docs/manual/developer/new_api_2_4.html.en
index 0442b662b1..4f16fc0979 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>
   
 
-- 
2.40.0