mod_cache.xml.ko revision 6aadbc6fd703e73d1d419e9f06b84a4338c898f1
<?xml version="1.0" encoding="EUC-KR" ?>
<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="/style/manual.ko.xsl"?>
<!-- English Revision: 1.17 -->
<!--
Copyright 2003-2004 The Apache Software Foundation
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<modulesynopsis metafile="mod_cache.xml.meta">
<name>mod_cache</name>
<description>URI�� Ű�� ����Ͽ� ������ ij���Ѵ�.</description>
<status>Experimental</status>
<sourcefile>mod_cache.c</sourcefile>
<identifier>cache_module</identifier>
<summary>
<note type="warning">
�� ����� �������� �����̴�. ������ ���� �۾����̴�...
</note>
<p><module>mod_cache</module>�� ���� ��ǻ�Ϳ� �ִ� �����̳�
���Ͻõ� ������ ij���� �� �ִ� <a
href="http://www.ietf.org/rfc/rfc2616.txt">RFC 2616</a>
ȣȯ HTTP ����ij���� �����Ѵ�. <module>mod_cache</module>��
����Ϸ��� �������(storage management module)�� �ʿ��ϴ�.
�⺻ ����ġ ���������� �ΰ��� ��������� �ִ�:</p>
<dl>
<dt><module>mod_disk_cache</module></dt>
<dd>�� ��ũ��� ������ڸ� �����Ѵ�.</dd>
<dt><module>mod_mem_cache</module></dt>
<dd>�� �޸𸮱�� ������ڸ� �����Ѵ�.
<module>mod_mem_cache</module>�� ���ϱ���ڸ� ij���ϰų�
��(heap) �� ��ü�� ij���ϴ� �ΰ��� ����� �Ѱ��� �������
�����ϵ��� ������ �� �ִ�. <module>mod_mem_cache</module>��
�ڽ��� ���� ������ ij���ϰų�, (<dfn>�����Ͻ�(reverse proxy)</dfn>��
�˷���) <directive module="mod_proxy">ProxyPass</directive>��
����Ͽ� <module>mod_proxy</module>�� ���� �޴� ����������
ij���� �� �ִ�.</dd>
</dl>
<p>������ URI�� ���� ���� Ű�� ij���� �����ϰ� �����´�.
���ٺ�ȣ�� �� ������ ij�������ʴ´�.</p>
</summary>
<section id="related"><title>��õ� ���� ���þ�</title>
<related>
<modulelist>
<module>mod_disk_cache</module>
<module>mod_mem_cache</module>
</modulelist>
<directivelist>
<directive module="mod_disk_cache">CacheRoot</directive>
<directive module="mod_disk_cache">CacheSize</directive>
<directive module="mod_disk_cache">CacheGcInterval</directive>
<directive module="mod_disk_cache">CacheDirLevels</directive>
<directive module="mod_disk_cache">CacheDirLength</directive>
<directive module="mod_disk_cache">CacheExpiryCheck</directive>
<directive module="mod_disk_cache">CacheMinFileSize</directive>
<directive module="mod_disk_cache">CacheMaxFileSize</directive>
<directive module="mod_disk_cache">CacheTimeMargin</directive>
<directive module="mod_disk_cache">CacheGcDaily</directive>
<directive module="mod_disk_cache">CacheGcUnused</directive>
<directive module="mod_disk_cache">CacheGcClean</directive>
<directive module="mod_disk_cache">CacheGcMemUsage</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>
<section id="sampleconf"><title>������</title>
<example><title>Sample httpd.conf</title>
#<br />
# ���� ij�� ����<br />
#<br />
LoadModule cache_module modules/mod_cache.so<br />
<br />
&lt;IfModule mod_cache.c&gt;<br />
<indent>
#LoadModule disk_cache_module modules/mod_disk_cache.so<br />
&lt;IfModule mod_disk_cache.c&gt;<br />
<indent>
CacheRoot c:/cacheroot<br />
CacheSize 256<br />
CacheEnable disk /<br />
CacheDirLevels 5<br />
CacheDirLength 3<br />
</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 />
</indent>
&lt;/IfModule&gt;
</example>
</section>
<directivesynopsis>
<name>CacheEnable</name>
<description>������ ������ڸ� ����Ͽ� ������ URL�� ij���Ѵ�</description>
<syntax>CacheEnable <var>cache_type</var> <var>url-string</var></syntax>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<usage>
<p><directive>CacheEnable</directive> ���þ ����ϸ�
<module>mod_cache</module>�� <var>url-string</var> ����
url���� ij���Ѵ�. ij�� ������ڴ� <var>cache_type</var>
�ƱԸ�Ʈ�� �����Ѵ�. <var>cache_type</var> <code>mem</code>��
<module>mod_mem_cache</module>�� �����ϴ� �޸𸮱��
������ڸ� ����Ѵ�. <var>cache_type</var> <code>disk</code>��
<module>mod_disk_cache</module>�� �����ϴ� ��ũ���
������ڸ� ����Ѵ�. <var>cache_type</var> <code>fd</code>��
<module>mod_mem_cache</module>�� �����ϴ� ���ϱ���� ij����
����Ѵ�.</p>
<p>(�Ʒ� ���� ����) URL ���� �ٸ�
<directive>CacheEnable</directive> ���þ�� ��ġ�� ������
�� ������ڰ� ��û�� ó���Ҷ����� �� ������ڸ� ���
�����Ѵ�. �������Ͽ��� <directive>CacheEnable</directive>
���þ��� ���� ������ڰ� ����ȴ�.</p>
<example>
CacheEnable mem /manual<br />
CacheEnable fd /images<br />
CacheEnable disk /<br />
</example>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>CacheDisable</name>
<description>Ư�� URL�� ij������ �ʴ´�</description>
<syntax>CacheDisable <var> url-string</var></syntax>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<usage>
<p><directive>CacheDisable</directive> ���þ ����ϸ�
<module>mod_cache</module>�� <var>url-string</var> ������
url���� ij������ <em>�ʴ´�</em>.</p>
<example><title>����</title>
CacheDisable /local_files
</example>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>CacheMaxExpire</name>
<description>������ ij���ϴ� �ʴ��� �ִ�ð�</description>
<syntax>CacheMaxExpire <var>seconds</var></syntax>
<default>CacheMaxExpire 86400 (�Ϸ�)</default>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<usage>
<p><directive>CacheMaxExpire</directive> ���þ�� ���� ������
�˻������ʰ� ij�������� HTTP ������ ������ �� �ִ� �ʴ���
�ִ�ð��� �����Ѵ�. ��, ������ �ִ��� �� ��������ŭ �����Ǿ��.
������ ����ð��� �����Ͽ��� �� �ִ밪�� ��Ų��.</p>
<example>
CacheMaxExpire 604800
</example>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>CacheDefaultExpire</name>
<description>����ð��� ������������ ������ ij���� �⺻ �Ⱓ.</description>
<syntax>CacheDefaultExpire <var>seconds</var></syntax>
<default>CacheDefaultExpire 3600 (one hour)</default>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<usage>
<p><directive>CacheDefaultExpire</directive> ���þ�� ������
����ð��� �ֱټ����ð��� ��� ��� ������ ij���� �ʴ���
�⺻ �ð��� �����Ѵ�. <directive>CacheMaxExpire</directive>��
������ ���� �� ������ �������� <em>�ʴ´�</em>.</p>
<example>
CacheDefaultExpire 86400
</example>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>CacheIgnoreNoLastMod</name>
<description>���信 Last Modified ����� ��ٴ� ����� �����Ѵ�.</description>
<syntax>CacheIgnoreNoLastMod On|Off</syntax>
<default>CacheIgnoreNoLastMod Off</default>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<usage>
<p>���� �ֱټ������� ��� ������ ij������ �ʴ´�. � ���
�ֱټ������� (���� ��� <module>mod_include</module> ó���߿�)
���ų� ó������ ����� ���� �ִ�.
<directive>CacheIgnoreNoLastMod</directive> ���þ�� �ֱټ�������
��� ������ �ݵ�� ij���ϵ��� �����. ������ �ֱټ����ϰ�
����� ��� ��� <directive>CacheDefaultExpire</directive>
���þ�� ������ ���� ����ð����� ����Ѵ�.</p>
<example>
CacheIgnoreNoLastMod On
</example>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>CacheIgnoreCacheControl</name>
<description>Ŭ���̾�Ʈ�� ij�������ʴ� ������ ��û���� �����Ѵ�.</description>
<syntax>CacheIgnoreCacheControl On|Off</syntax>
<default>CacheIgnoreCacheControl Off</default>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<usage>
<p>���� no-cache�� no-store ������� ���� ������ ij����
���������ʴ´�. <directive>CacheIgnoreCacheControl</directive>
���þ�� �̷� �ൿ�� �����Ѵ�.
<directive>CacheIgnoreCacheControl</directive> On�� ����ϸ�
������ ������ no-cache�� no-store ������� �־ ������
ij���Ѵ�. ������ �ʿ��� ������ <em>����</em> ij������
�ʴ´�.</p>
<example>
CacheIgnoreCacheControl On
</example>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>CacheLastModifiedFactor</name>
<description>LastModified �ð����� ����ð��� ����ϴµ� ����ϴ�
���.</description>
<syntax>CacheLastModifiedFactor <var>float</var></syntax>
<default>CacheLastModifiedFactor 0.1</default>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<usage>
<p>������ ����ð��� ������ �ֱټ������� �ִ� ��� �ֱټ�����
���� ���� �ð����� ����ð��� ����Ѵ�.
<directive>CacheLastModifiedFactor</directive> ���þ��
����ð��� ����ϴ� ���� ��Ŀ��� ����� <var>factor</var>��
�����Ѵ�:
<code>expiry-period = time-since-last-modified-date * <var>factor</var>
expiry-date = current-date + expiry-period</code>
���� ���, ������ 10 �ð� �� ���������� �����Ǿ�� <var>factor</var>��
0.1�̶�� ����Ⱓ�� 10*01 = 1 �ð��� �ȴ�. ���� �ð���
3:00pm�̶�� ����ð��� 3:00pm + 1�ð� = 4:00pm�̴�.
����Ⱓ�� <directive>CacheMaxExpire</directive> ���� ��ٸ�
<directive>CacheMaxExpire</directive>�� ����Ѵ�.</p>
<example>
CacheLastModifiedFactor 0.5
</example>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>CacheForceCompletion</name>
<description>��û�� ��ҵǴ��� ������ ������ ��� ij���ϱ�����
�ʿ��� ������ ���񽺷�.</description>
<syntax>CacheForceCompletion <var>Percentage</var></syntax>
<default>CacheForceCompletion 60</default>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<usage>
<p>���� ������ ij���ϰ� Ŭ���̾�Ʈ�� ������ ���߿� ��û��
��ҵǸ� ���� ó���� �ߴܵǰ� ij�� �׸��� �����.
<directive>CacheForceCompletion</directive> ���þ�� ��û��
��ҵǴ��� ������ ��� ij���� ������ �����Ѵ�.</p>
<p>������ ������� ��Ÿ���� <code>1</code>�� <code>100</code>
������ ���̴�. <code>0</code> ���� �����ϸ� �⺻���� ����Ѵ�.
<code>100</code>�� ������ ��� ������ �������� ij���Ѵ�.
60�� 90 ������ ���� ��õ�Ѵ�.</p>
<example>
CacheForceCompletion 80
</example>
<note type="warning"><title>����:</title>
�� ����� ���� �������� <em>�ʾҴ�</em>.
</note>
</usage>
</directivesynopsis>
</modulesynopsis>