From a51bd977ca4672b1da979758f39f45a274140494 Mon Sep 17 00:00:00 2001 From: Andre Malo Date: Mon, 9 Dec 2002 23:52:44 +0000 Subject: [PATCH] - markup & reformatting - some rearranging of the content - fix conextlists. with the current code it doesn't make sense to put any directive into an virtual host (the config pointer is static...) (blame me, if I'm wrong) git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@97827 13f79535-47bb-0310-9956-ffa450edef68 --- docs/manual/mod/mod_mem_cache.xml | 163 +++++++++++++++--------------- 1 file changed, 84 insertions(+), 79 deletions(-) diff --git a/docs/manual/mod/mod_mem_cache.xml b/docs/manual/mod/mod_mem_cache.xml index 1025b75f14..03ddf71f2f 100644 --- a/docs/manual/mod/mod_mem_cache.xml +++ b/docs/manual/mod/mod_mem_cache.xml @@ -10,75 +10,75 @@ mem_cache_module + + This module is experimental. Documentation is still under + development... + - -This module is experimental. Documentation is still under development... - -

mod_mem_cache implements a memory based storage manager. - mod_mem_cache can be configured to operate in two modes: - caching open file descriptors or caching objects in heap storage. +

This module requires the service of mod_cache. It acts as a support module for mod_cache and provides a memory based storage manager. + mod_mem_cache can be configured to operate in two + modes: caching open file descriptors or caching objects in heap storage. mod_mem_cache is most useful when used to cache locally - generated content or to cache backend server content for - mod_proxy configured for - ProxyPass (aka reverse proxy)

- -

Content is stored in and retrieved from the cache using URI based keys. Content with - access protection is not cached.

+ generated content or to cache backend server content for mod_proxy configured for ProxyPass (aka reverse proxy).

- Note: -

mod_mem_cache requires the services of mod_cache.

- +

Content is stored in and retrieved from the cache using URI based + keys. Content with access protection is not cached.

 +mod_cache +mod_disk_cache MCacheSize -The maximum amount of memory used by the cache in KBytes +The maximum amount of memory used by the cache in +KBytes MCacheSize KBytes MCacheSize 100 -server configvirtual host - +server config -

The MCacheSize directive sets the maximum amount of memory - to be used by the cache, in KBytes (1024-byte units). If a new object needs to be - inserted in the cache and the size of the object is greater than the - remaining memory, objects will be removed until the new object can be cached. - The object to be removed is selected using the algorithm specified by - MCacheRemovalAlgorithm.

- - Note: - The MCacheSize value must be greater than the value - specified by the MCacheMaxObjectSize directive. - - - - MCacheSize 700000
+

The MCacheSize directive sets the maximum + amount of memory to be used by the cache, in KBytes (1024-byte units). + If a new object needs to be inserted in the cache and the size of the + object is greater than the remaining memory, objects will be removed + until the new object can be cached. The object to be removed is + selected using the algorithm specified by MCacheRemovalAlgorithm.

+ + Example + MCacheSize 700000 + + Note +

The MCacheSize value must be greater than + the value specified by the MCacheMaxObjectSize directive.

+ MCacheMaxObjectCount -The maximum number of objects allowed to be placed in the cache +The maximum number of objects allowed to be placed in the +cache MCacheMaxObjectCount value MCacheMaxObjectCount 1009 -server configvirtual host - +server config -

The MCacheMaxObjectCount directive sets the maximum - number of objects to be cached. If a new object needs to be inserted in the cache - and the maximum number of objects has been reached, an object will be removed - to allow the new object to be cached. The object to be removed is selected using - the algorithm specified by MCacheRemovalAlgorithm.

- - Note: - The value of MCacheMaxObjectCount is used to create - the open hash table. - - - - MCacheMaxObjectCount 13001
+

The MCacheMaxObjectCount directive sets the + maximum number of objects to be cached. The value is used to create the + open hash table. If a new object needs to be inserted in the cache and + the maximum number of objects has been reached, an object will be + removed to allow the new object to be cached. The object to be removed + is selected using the algorithm specified by MCacheRemovalAlgorithm.

+ + Example + MCacheMaxObjectCount 13001 @@ -89,15 +89,15 @@ This module is experimental. Documentation is still under development... cache MCacheMinObjectSize bytes MCacheMinObjectSize 0 -server configvirtual host - +server config -

The MCacheMinObjectSize directive sets the minimum - size in bytes of a document for it to be considered cacheable.

+

The MCacheMinObjectSize directive sets the + minimum size in bytes of a document for it to be considered + cacheable.

- - MCacheMinObjectSize 10000
+ Example + MCacheMinObjectSize 10000 @@ -108,22 +108,22 @@ cache cache MCacheMaxObjectSize bytes MCacheMaxObjectSize 10000 -server configvirtual host - +server config -

The MCacheMaxObjectSize directive sets the maximum - allowable size, in bytes, of a document for it to be considered cacheable.

+

The MCacheMaxObjectSize directive sets the + maximum allowable size, in bytes, of a document for it to be considered + cacheable.

- Note: - The value of MCacheMaxObjectSize must be greater - than the value specified by the MCacheMinObjectSize - directive. - - - - MCacheMaxObjectSize 6400000
+ Example + MCacheMaxObjectSize 6400000 + + Note +

The value of MCacheMaxObjectSize must be + greater than the value specified by the MCacheMinObjectSize directive.

+ @@ -131,24 +131,29 @@ cache MCacheRemovalAlgorithm The algorithm used to select documents for removal from the cache -MCacheRemovalAlgorithm LRU|GDSF +MCacheRemovalAlgorithm LRU|GDSF MCacheRemovalAlgorithm GDSF -server configvirtual host - +server config

The MCacheRemovalAlgorithm directive specifies the algorithm used to select documents for removal from the cache. - Two choices are available:
- LRU (Least Recently Used): LRU removes the - documents that have not been accessed for the longest time.
- GDSF (GreadyDual-Size): GDSF assigns a priority - to cached documents based on the cost of a cache miss and the size of - the document. Documents with the lowest priority are removed first.

- - - MCacheRemovalAlgorithm GDSF
- MCacheRemovalAlgorithm LRU
+ Two choices are available:

+ +
+
LRU (Least Recently Used)
+
LRU removes the documents that have not been accessed + for the longest time.
+ +
GDSF (GreadyDual-Size)
+
GDSF assigns a priority to cached documents based + on the cost of a cache miss and the size of the document. Documents + with the lowest priority are removed first.
+
+ + Example + MCacheRemovalAlgorithm GDSF
+ MCacheRemovalAlgorithm LRU -- 2.40.0