From 567b147f98a2e174ce609bfc3382ac7cb7eb2b84 Mon Sep 17 00:00:00 2001
From: Luca Toscano <elukey@apache.org>
Date: Sat, 18 Jun 2016 10:13:42 +0000
Subject: [PATCH] Follow up about DNS Resolution cache in mod-proxy after a
 users@ email thread ("mod_proxy and DNS resolving"). Review from devs would
 be really appreciated, I'd like to backport this info asap to 2.4.x.

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1748948 13f79535-47bb-0310-9956-ffa450edef68
---
 docs/manual/mod/mod_proxy.xml | 15 ++++++++-------
 1 file changed, 8 insertions(+), 7 deletions(-)

diff --git a/docs/manual/mod/mod_proxy.xml b/docs/manual/mod/mod_proxy.xml
index 5e3a90ef30..c557eccb60 100644
--- a/docs/manual/mod/mod_proxy.xml
+++ b/docs/manual/mod/mod_proxy.xml
@@ -304,13 +304,14 @@ ProxyPass "/examples" "http://backend.example.com/examples" timeout=10
       <directive module="mod_proxy">BalancerMember</directive>.</p>
 
       <note><title>DNS resolution for origin domains</title>
-      <p>The DNS domain resolution happens when the socket to
-        the origin server is created for the first time.
-        When connection pooling is used, the DNS resolution is performed
-        again only when the <code>ttl</code> of the connection expires
-        (please check <directive module="mod_proxy">ProxyPass</directive>
-        parameters).
-        This means that httpd does not perform any DNS resolution caching.
+      <p>DNS resolution happens when the socket to
+        the origin domain is created for the first time.
+        When connection pooling is used, each backend domain is resolved 
+        only once per child process, and reused for all further connections 
+        until the child is recycled. This information should to be considered 
+        while planning DNS maintenance tasks involving backend domains. 
+        Please also check <directive module="mod_proxy">ProxyPass</directive>
+        parameters for more details about connection reuse.
         </p>
       </note>
 
-- 
2.50.1