From 3a543e3f02f5ea9a7caaa411301e5d6f7c63add1 Mon Sep 17 00:00:00 2001
From: Graham Leggett <minfrin@apache.org>
Date: Thu, 1 Dec 2011 14:03:49 +0000
Subject: [PATCH] Changes to v2.4 APIs.

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

diff --git a/docs/manual/developer/new_api_2_4.xml b/docs/manual/developer/new_api_2_4.xml
index 1a19c1955e..53984834c7 100644
--- a/docs/manual/developer/new_api_2_4.xml
+++ b/docs/manual/developer/new_api_2_4.xml
@@ -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>
   </section>
 
@@ -454,6 +457,26 @@
 
       <dt><code>unixd_config</code></dt>
       <dd>This has been renamed to ap_unixd_config.</dd>
+
+      <dt><code>conn_rec->remote_ip and conn_rec->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->client_ip and
+        request_rec->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->peer_ip and conn_rec->peer_addr.</li>
+      </ul>
+      </dd>
     </dl>
   </section>
 
-- 
2.40.0