From: Jim Jagielski <jim@apache.org>
Date: Fri, 21 Oct 2016 18:34:28 +0000 (+0000)
Subject: Merge r1766097 from trunk:
X-Git-Tag: 2.4.24~189
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=6f480fb6e8a27dd0c8c7c858ad9f7982e0cc2b1b;p=apache

Merge r1766097 from trunk:

Some caching info

Reviewed/backported by: jim


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1766098 13f79535-47bb-0310-9956-ffa450edef68
---

diff --git a/docs/manual/caching.xml b/docs/manual/caching.xml
index f08ed7a77f..feed7b5759 100644
--- a/docs/manual/caching.xml
+++ b/docs/manual/caching.xml
@@ -425,6 +425,28 @@ Vary: negotiate,accept-language,accept-charset
       to decide on which of many variants to return to the client.</p>
     </section>
 
+  </section>
+
+  <section id="examples">
+
+    <title>Cache Setup Examples</title>
+
+    <related>
+      <modulelist>
+        <module>mod_cache</module>
+        <module>mod_cache_disk</module>
+        <module>mod_cache_socache</module>
+        <module>mod_socache_memcache</module>
+      </modulelist>
+      <directivelist>
+        <directive module="mod_cache">CacheEnable</directive>
+        <directive module="mod_cache_disk">CacheRoot</directive>
+        <directive module="mod_cache_disk">CacheDirLevels</directive>
+        <directive module="mod_cache_disk">CacheDirLength</directive>
+        <directive module="mod_cache_socache">CacheSocache</directive>
+      </directivelist>
+    </related>
+
     <section id="disk">
       <title>Caching to Disk</title>
 
@@ -544,11 +566,44 @@ CacheDirLength 1
       leave enough "grow room" following a clean.</p>
     </section>
 
+    <section id="memcache">
+      <title>Caching to memcached</title>
+
+      <p>The <module>mod_cache_socache</module> and <module>mod_socache_memcache</module>
+      modules are used to specify that the backend storage mechanism to be used
+      to store and return cached data in the <code>memcached</code> server.</p>
+
+      <p>Typically the module will be configured as so;</p>
+
+      <highlight language="config">
+CacheEnable socache /
+CacheSocache memcache:memcd.example.com:11211
+      </highlight>
+
+      <p>Additional <code>memcached</code> servers can be specified by
+      appending them to the end of the <code>CacheSocache memcache:</code>
+      line seperated by commas.</p>
+
+      <p>This format is also used with the other various <module>mod_cache_socache</module>
+      providers. For example:</p>
+
+      <highlight language="config">
+CacheEnable socache /
+CacheSocache shmcb:/path/to/datafile(512000)
+      </highlight>
+
+      <highlight language="config">
+CacheEnable socache /
+CacheSocache dbm:/path/to/datafile
+      </highlight>
+
+    </section>
+
   </section>
 
   <section id="socache-caching">
 
-    <title>Two-state Key/Value Shared Object Caching</title>
+    <title>General Two-state Key/Value Shared Object Caching</title>
 
     <related>
       <modulelist>