<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.de.xsl"?>
<modulesynopsis metafile="mod_mem_cache.xml.meta">
<name>mod_mem_cache</name>
<description>Content-Cache über URIs</description>
<status>Experimentell</status>
<sourcefile>mod_mem_cache.c</sourcefile>
<identifier>mem_cache_module</identifier>
<summary>
<note type="warning">
Dieses Modul befindet sich in einem experimentellen Stadium. Die
Dokumentation ist noch nicht abgeschlossen...
</note>
<p>Dieses Modul <em>benötigt</em> die Dienste des <module
>mod_cache</module>-Moduls. Es ergänzt dieses Modul und stellt einen
Manager für den interenen Speicher zur Verfügung.
<module>mod_mem_cache</module> kann für zwei Modi konfiguriert
werden: Für das Caching offner Dateideskriptoren oder für das
Caching
von Objekten im Heap-Speicher. Am sinnvollsten wird
<module>mod_mem_cache</module> für die Zwischenspeicherung lokal
erzeugter Inhalte oder der Inhalte von Backend-Servern für das Modul
<module>mod_proxy</module>, welches für <directive module="mod_proxy"
>ProxyPass</directive> konfiguriert wurde (auch bekannt unter der
Bezeichnung <dfn>reverse proxy</dfn>), benutzt.</p>
<p>Die Inhalte werden über URI-Schlüssel im Cache gespeichert und
aus
diesem wieder entnommen. Geschützte Inhalte werden nicht
zwischengespeichert.</p>
</summary>
<seealso><module>mod_cache</module></seealso>
<seealso><module>mod_disk_cache</module></seealso>
<directivesynopsis>
<name>MCacheSize</name>
<description>Der maximale Umfang, den die gespeicherten Daten im Speicher
einnehmen sollen (in KByte).</description>
<syntax>MCacheSize <var>kByte</var></syntax>
<default>MCacheSize 100</default>
<contextlist><context>server config</context></contextlist>
<usage>
<p>Die <directive>MCacheSize</directive>-Direktive gibt den maximalen
Speicherumfang für den Cache in KByte an (1.024-Byte-Einheiten).
Wird beim Einfügen eines neuen Objekts in den Zwischenspeicher
die angegebene Größe überschritten, werden Objekte aus dem
Speicher
entfernt, damit diese Grenze nicht überschritten wird. Die zu
entfernenden
Objekte werden mit einem Algorithmus ermittelt, der mit
<directive module="mod_mem_cache">MCacheRemovalAlgorithm</directive>
angegeben wird.</p>
<example><title>Beispiel</title>
MCacheSize 700000
</example>
<note><title>Hinweis</title>
<p>Der Wert für <directive>MCacheSize</directive> muss
größer als der Wert für
<directive module="mod_mem_cache">MCacheMaxObjectSize</directive>
sein.</p>
</note>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>MCacheMaxObjectCount</name>
<description>Die maximale Anzahl von Objekten im Cache</description>
<syntax>MCacheMaxObjectCount <var>Wert</var></syntax>
<default>MCacheMaxObjectCount 1009</default>
<contextlist><context>server config</context></contextlist>
<usage>
<p>Die <directive>MCacheMaxObjectCount</directive>-Direktive gibt
die maximale Anzahl im Cache zwischengespeicherter Objekte an. Mit
diesem Wert wird eine Hash-Tabelle erzeugt. Wird beim Einfügen eines
neuen Objekts in den Cache die maximale Anzahl der Objekte
überschritten,
wird ein anderes Objekt entfernt, um dem neuen Platz zu machen. Das zu
entfernende Objekt wird mit einem Algorithmus ausgewählt, der mit der
<directive module="mod_mem_cache">MCacheRemovalAlgorithm
</directive>-Anweisung angegeben wird.</p>
<example><title>Beispiel</title>
MCacheMaxObjectCount 13001
</example>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>MCacheMinObjectSize</name>
<description>Die Mindestgröße eines zwischengespeicherten
Dokuments (in Byte)</description>
<syntax>MCacheMinObjectSize <var>Byte</var></syntax>
<default>MCacheMinObjectSize 0</default>
<contextlist><context>server config</context></contextlist>
<usage>
<p>Die <directive>MCacheMinObjectSize</directive>-Direktive gibt die
Mindestgröße für zwischenzuspeichernde Dokumente in Byte
an.</p>
<example><title>Beispiel</title>
MCacheMinObjectSize 10000
</example>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>MCacheMaxObjectSize</name>
<description>Die maximale Größe eines Dokuments im Cache (in Byte)
</description>
<syntax>MCacheMaxObjectSize <var>Byte</var></syntax>
<default>MCacheMaxObjectSize 10000</default>
<contextlist><context>server config</context></contextlist>
<usage>
<p>Die <directive>MCacheMaxObjectSize</directive>-Direktive gibt die
maximal zulässige Größe für zwischenzuspeichernde
Dokumente in Byte an.</p>
<example><title>Beispiel</title>
MCacheMaxObjectSize 6400000
</example>
<note><title>Hinweis</title>
<p>Der Wert für <directive>MCacheMaxObjectSize</directive> muss
größer als der Wert für <directive
module="mod_mem_cache">MCacheMinObjectSize</directive> sein.</p>
</note>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>MCacheRemovalAlgorithm</name>
<description>Der Algorithmus für die Auswahl aus dem Cache zu
entfernender Objekte</description>
<syntax>MCacheRemovalAlgorithm LRU|GDSF</syntax>
<default>MCacheRemovalAlgorithm GDSF</default>
<contextlist><context>server config</context></contextlist>
<usage>
<p>Die <directive>MCacheRemovalAlgorithm</directive>-Direktive gibt
den Algorithmus für die Auswahl der aus dem Cache zu entfernenden
Dokumente an. Zwei Angaben sind möglich:</p>
<dl>
<dt><code>LRU</code> (Least Recently Used)</dt>
<dd><code>LRU</code> entfernt die Dokumente, auf die am längsten
nicht mehr zugegriffen wurde.</dd>
<dt><code>GDSF</code> (GreadyDual-Size)</dt>
<dd><code>GDSF</code> weist auf der Basis der Anzahl der Zugriffe
auf das Dokument, der Zeit des letzten Zugriffs und der Größe
dem
Dokument eine Priorität zu. Dokumente mit der niedrigsten
Priorität werden
zuerst entfernt.</dd>
</dl>
<example><title>Beispiel</title>
MCacheRemovalAlgorithm GDSF<br />
MCacheRemovalAlgorithm LRU
</example>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>MCacheMaxStreamingBuffer</name>
<description>Maximaler Umfang temporär gepufferter Antworten.
Umfangreichere Antworten werden nicht zwischengespeichert.</description>
<syntax>MCacheMaxStreamingBuffer <var>Größe_in_Byte</var></syntax>
<default>MCacheMaxStreamingBuffer kleiner 100000 oder
MCacheMaxObjectSize</default>
<contextlist><context>server config</context>
</contextlist>
<usage>
<p>Die <directive>MCacheMaxStreamingBuffer</directive>-Direktive
gibt die maximale Anzahl Bytes für temporär gepufferte Anworten
an.
Wird der Wert überschritten, erfolgt keine Zwischenspeicherung.
Bei gepufferten Antworten stehen der gesamte Inhalt und der
<code>Content-Length</code>-Header nicht umnittelbar zur Verfügung.
Das kann bei Antworten von Proxies und CGI-Skripten der Fall sein.
Standardmäßig wird eine temporär gepufferte Antwort
<em>nicht</em> zwischengespeichert, es sei denn, es liegt ein
<code>Content-Length</code>-Header vor. Dadurch soll vermieden werden,
dass zuviel Speicher für die Pufferung einer partiellen Antwort
benutzt wird,
die sich am Ende als zu groß für den Cache herausstellt. Mit der
<directive>MCacheMaxStreamingBuffer</directive>-Direktive können
Antworten gepuffert werden, deren Größe im geforderten Rahmen
liegt.
Wird die maximale Puffergröße erreicht, wird der Pufferinhalt
verworfen
und der Versuch der Zwischenspeicherung abgebrochen.</p>
<note><title>Hinweis:</title>
<p>Ein Wert für <directive>MCacheMaxStreamingBuffer</directive>,
der ungleich null ist, verzögert die Übertragung der Antwort an
den Client
nicht. Sobald <module>mod_mem_cache</module> einen Block in einen
Puffer kopiert, wird dieser Block an den nächsten Ausgabefilter
für die
Auslieferung an den Client gesendet.</p>
</note>
<example>
# Das Caching für temporär gepufferte <br />
# Antworten bis 64 kByte aktivieren:<br />
MCacheMaxStreamingBuffer 65536
</example>
</usage>
</directivesynopsis>
</modulesynopsis>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]