Commit ebca8106 authored by Takashi Sato's avatar Takashi Sato
Browse files

Remove mod_mem_cache from documents

(Sync with r711470)

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@711521 13f79535-47bb-0310-9956-ffa450edef68
parent afb27091
Loading
Loading
Loading
Loading
+7 −52
Original line number Diff line number Diff line
@@ -26,8 +26,7 @@

  <summary>
    <p>This document supplements the <module>mod_cache</module>,
    <module>mod_disk_cache</module>, <module>mod_mem_cache</module>,
    <module>mod_file_cache</module> and <a 
    <module>mod_disk_cache</module>, <module>mod_file_cache</module> and <a 
    href="programs/htcacheclean.html">htcacheclean</a> reference documentation.
    It describes how to use Apache's caching features to accelerate web and 
    proxy serving, while avoiding common problems and misconfigurations.</p>
@@ -43,7 +42,7 @@
    handling, both as an origin webserver and as a proxy.</p>

    <p><module>mod_cache</module> and its provider modules 
    <module>mod_mem_cache</module> and <module>mod_disk_cache</module> 
    <module>mod_disk_cache</module> 
    provide intelligent, HTTP-aware caching. The content itself is stored
    in the cache, and mod_cache aims to honour all of the various HTTP
    headers and options that control the cachability of content. It can
@@ -83,7 +82,6 @@
    <related>
      <modulelist>
        <module>mod_cache</module>
        <module>mod_mem_cache</module>
        <module>mod_disk_cache</module>
        <module>mod_file_cache</module>
      </modulelist>
@@ -215,7 +213,8 @@
      changed in size or modification time. As such, even if Apache is
      caching local content, even expired content may still be served faster
      from the cache if it has not changed. As long as reading from the cache
      store is faster than reading from the backend (e.g. an in-memory cache 
      store is faster than reading from the backend (e.g. <module
      >mod_disk_cache</module> with memory disk
      compared to reading from disk).</p> 
    </section>

@@ -396,19 +395,16 @@ Vary: negotiate,accept-language,accept-charset
    <related>
      <modulelist>
        <module>mod_file_cache</module>
        <module>mod_mem_cache</module>
      </modulelist>
      <directivelist>
        <directive module="mod_file_cache">CacheFile</directive>
        <directive module="mod_cache">CacheEnable</directive>
        <directive module="mod_cache">CacheDisable</directive>
      </directivelist>
    </related>

    <p>The act of opening a file can itself be a source of delay, particularly 
    on network filesystems. By maintaining a cache of open file descriptors
    for commonly served files, Apache can avoid this delay. Currently Apache
    provides two different implementations of File-Handle Caching.</p> 
    provides one implementation of File-Handle Caching.</p> 

    <section>
      <title>CacheFile</title>
@@ -447,21 +443,6 @@ Vary: negotiate,accept-language,accept-charset
      descriptor closed.</p>
    </section>

    <section>
      <title>CacheEnable fd</title>

      <p><module>mod_mem_cache</module> also provides its own file-handle 
      caching scheme, which can be enabled via the 
      <directive module="mod_cache">CacheEnable</directive> directive.</p>

      <example>
      <pre>CacheEnable fd /</pre>
      </example>

      <p>As with all of <module>mod_cache</module> this type of file-handle
      caching is intelligent, and handles will not be maintained beyond
      the expiry time of the cached content.</p>
    </section>
  </section>
  
  <section id="inmemory">
@@ -469,7 +450,6 @@ Vary: negotiate,accept-language,accept-charset

     <related>
      <modulelist>
        <module>mod_mem_cache</module>
        <module>mod_file_cache</module>
      </modulelist>
      <directivelist>
@@ -535,11 +515,6 @@ sys 0m0.000s</pre>
    caching there are some circumstances in which in-memory caching may be 
    better performed by Apache.</p>

    <p>Firstly, an operating system can only cache files it knows about. If 
    you are running Apache as a proxy server, the files you are caching are
    not locally stored but remotely served. If you still want the unbeatable
    speed of in-memory caching, Apache's own memory caching is needed.</p>

    <section>
      <title>MMapStatic Caching</title>

@@ -565,25 +540,6 @@ sys 0m0.000s</pre>
      to ensure that the files mapped are not so large as to cause the
      system to swap memory.</p>
    </section>

    <section>
      <title>mod_mem_cache Caching</title>

      <p><module>mod_mem_cache</module> provides a HTTP-aware intelligent
      in-memory cache. It also uses heap memory directly, which means that
      even if <var>MMap</var> is not supported on your system, 
      <module>mod_mem_cache</module> may still be able to perform caching.</p>

      <p>Caching of this type is enabled via;</p>

      <example><pre>
# Enable memory caching
CacheEnable mem /

# Limit the size of the cache to 1 Megabyte
MCacheSize 1024</pre>
      </example>
    </section>
  </section>
             
  <section id="disk">
@@ -600,9 +556,8 @@ MCacheSize 1024</pre>
    </related>
       
    <p><module>mod_disk_cache</module> provides a disk-based caching mechanism 
    for <module>mod_cache</module>. As with <module>mod_mem_cache</module>
    this cache is intelligent and content will be served from the cache only
    as long as it is considered valid.</p>
    for <module>mod_cache</module>. This cache is intelligent and content will
    be served from the cache only as long as it is considered valid.</p>

    <p>Typically the module will be configured as so;</p>

+4 −44
Original line number Diff line number Diff line
@@ -41,20 +41,11 @@
    href="http://www.ietf.org/rfc/rfc2616.txt">RFC 2616</a> compliant HTTP
    content cache that can be used to cache either local or proxied content.
    <module>mod_cache</module> requires the services of one or more storage
    management modules. Two storage management modules are included in
    management modules. One storage management module is included in
    the base Apache distribution:</p>
    <dl>
    <dt><module>mod_disk_cache</module></dt>
    <dd>implements a disk based storage manager.</dd>

    <dt><module>mod_mem_cache</module></dt>
    <dd>implements a memory based storage manager. 
    <module>mod_mem_cache</module> can be configured to operate in two
    modes: caching open file descriptors or caching objects in heap storage.
    <module>mod_mem_cache</module> can be used to cache locally generated content
    or to cache backend server content for <module>mod_proxy</module> when
    configured using <directive module="mod_proxy">ProxyPass</directive>
    (aka <dfn>reverse proxy</dfn>)</dd>
    </dl>

    <p>Content is stored in and retrieved from the cache using URI based keys. Content with
@@ -68,7 +59,6 @@
    <related>
      <modulelist>
        <module>mod_disk_cache</module>
        <module>mod_mem_cache</module>
      </modulelist>
      <directivelist>
        <directive module="mod_disk_cache">CacheRoot</directive>
@@ -76,12 +66,6 @@
        <directive module="mod_disk_cache">CacheDirLength</directive>
        <directive module="mod_disk_cache">CacheMinFileSize</directive>
        <directive module="mod_disk_cache">CacheMaxFileSize</directive>
        <directive module="mod_mem_cache">MCacheSize</directive>
        <directive module="mod_mem_cache">MCacheMaxObjectCount</directive>
        <directive module="mod_mem_cache">MCacheMinObjectSize</directive>
        <directive module="mod_mem_cache">MCacheMaxObjectSize</directive>
        <directive module="mod_mem_cache">MCacheRemovalAlgorithm</directive>
        <directive module="mod_mem_cache">MCacheMaxStreamingBuffer</directive>
      </directivelist>
    </related>
</section>
@@ -95,9 +79,7 @@
      <br />
      &lt;IfModule mod_cache.c&gt;<br />
      <indent>
        #LoadModule disk_cache_module modules/mod_disk_cache.so<br />
        # If you want to use mod_disk_cache instead of mod_mem_cache,<br />
        # uncomment the line above and comment out the LoadModule line below.<br />
        LoadModule disk_cache_module modules/mod_disk_cache.so<br />
        &lt;IfModule mod_disk_cache.c&gt;<br />
        <indent>
          CacheRoot c:/cacheroot<br />
@@ -107,17 +89,6 @@
        </indent>
        &lt;/IfModule&gt; <br />
        <br />
        LoadModule mem_cache_module modules/mod_mem_cache.so<br />
        &lt;IfModule mod_mem_cache.c&gt;<br />
        <indent>
          CacheEnable mem  /<br />
          MCacheSize 4096<br />
          MCacheMaxObjectCount 100<br />
          MCacheMinObjectSize 1<br />
          MCacheMaxObjectSize 2048<br />
        </indent>
        &lt;/IfModule&gt;<br />
        <br />
        # When acting as a proxy, don't cache the list of security updates<br />
        CacheDisable http://security.update.server/update-list/<br />
      </indent>
@@ -137,15 +108,10 @@ manager</description>
    <p>The <directive>CacheEnable</directive> directive instructs
    <module>mod_cache</module> to cache urls at or below
    <var>url-string</var>. The cache storage manager is specified with the
    <var>cache_type</var> argument. <var>cache_type</var> <code> mem</code>
    instructs <module>mod_cache</module> to use the memory based storage
    manager implemented by <module>mod_mem_cache</module>. 
    <var>cache_type</var> argument. 
    <var>cache_type</var> <code>disk</code> instructs
    <module>mod_cache</module> to use the disk based storage manager
    implemented by <module>mod_disk_cache</module>.
    <var>cache_type</var> <code>fd</code> instructs
    <module>mod_cache</module> to use the file descriptor cache implemented
    by <module>mod_mem_cache</module>.</p>
    implemented by <module>mod_disk_cache</module>.</p>
    <p>In the event that the URL space overlaps between different
    <directive>CacheEnable</directive> directives (as in the example below),
    each possible storage manager will be run until the first one that
@@ -153,12 +119,6 @@ manager</description>
    run is determined by the order of the <directive>CacheEnable</directive>
    directives in the configuration file.</p>

    <example>
      CacheEnable  mem   /manual<br />
      CacheEnable  fd    /images<br />
      CacheEnable  disk  /<br />
    </example>

    <p>When acting as a forward proxy server, <var>url-string</var> can
    also be used to specify remote sites and proxy protocols which 
    caching should be enabled for.</p>
+0 −13
Original line number Diff line number Diff line
# GENERATED FROM XML -- DO NOT EDIT

URI: mod_mem_cache.html.en
Content-Language: en
Content-type: text/html; charset=ISO-8859-1

URI: mod_mem_cache.html.ja.utf8
Content-Language: ja
Content-type: text/html; charset=UTF-8

URI: mod_mem_cache.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
+0 −240

File deleted.

Preview size limit exceeded, changes collapsed.

+0 −239

File deleted.

Preview size limit exceeded, changes collapsed.

Loading