mod_isapi.xml.ko revision d378be2a904a6e56925589d8278bf6136032e0a4
<?xml version="1.0" encoding="EUC-KR" ?>
<!-- English Revision: 103423 -->
<!--
Copyright 2002-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
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_isapi.xml.meta">
<name>mod_isapi</name>
<description>Windows�� ����ġ���� ISAPI Extension ���</description>
<status>Base</status>
<identifier>isapi_module</identifier>
<compatibility>Win32 only</compatibility>
<summary>
<p>�� ����� Internet Server extension API�� �����Ѵ�. ����
������ ������ Windows�� ����ġ���� Internet Server extension��
(<em>��,</em> ISAPI .dll ���) ����� �� �ִ�.</p>
<p>ISAPI extension ���(.dll ����)�� �����ڰ� �ۼ��Ѵ�.
Apache Group�� �̵� ����� ������ �ʾ�����, ���� ����
�ʴ´�. ISAPI extension ��뿡 ���� ������ ISAPI �����ڿ���
���� �����ϱ� �ٶ���. <strong>���� �̷� ������ ����ġ
���ϸ�����Ʈ�� ������ �������� �ø��� <em>����</em>.</strong></p>
</summary>
<section id="usage"><title>����</title>
<p>�����������Ͽ��� <directive
module="mod_mime">AddHandler</directive> ���þ ����Ͽ�
ISAPI ���� Ȯ���ڿ� <code>isapi-isa</code> �ڵ鷯�� �����Ѵ�.
.dll ������ ISAPI extension���� ó���Ϸ��� httpd.conf ���Ͽ�
������ ���� �߰��Ѵ�.</p>
<example>
AddHandler isapi-isa .dll
</example>
<p>����ġ ������ ��û�� ����� �� ��� �� �� ���.
���� httpd.conf���� ������ ���� �������� Ư�� ����� �̸�
�о���� ���� �ִ�.</p>
<example>
</example>
<p>ISAPI extension�� �̸� �о���̴��� �̸� �о������ �ʴ���
������ ISAPI extension�� CGI ��ũ��Ʈ�� ������ ���Ѱ�
������ ���. ��, ISAPI .dll ������ �ִ� ���丮�� <directive
module="core">Options</directive> <code>ExecCGI</code>��
�ʿ��ϴ�.</p>
<p><module>mod_isapi</module>�� ISAPI ���� ���� �ڼ���
����� ������ <a href="#notes">�߰� ����</a>�� <a
href="#journal">������ ����</a>�� ����϶�.</p>
</section>
<section id="notes"><title>�߰� ����</title>
<p>����ġ ISAPI ������ �� ����¿� ���� "����ũ�μ���Ʈ
Ư����" Ȯ������ ������ ISAPI 2.0 �Ծ��� ��� �����Ѵ�.
����ġ�� ����� �����δ� ISAPI�� ����� �� �ִ� �������
�� ������� �� �� ���. ISA�� �� ����°� ���� ��������
�ʴ� ����� ����Ϸ� �Ѵٸ�, ����뿡 ������ �ֱ����� ����
�α� ����� �����. �αװ� �ſ� Ŀ�� �� �ֱ����
<code>ISAPILogNotSupported Off</code> ���þ ����ϸ�
�α� ������� �ʴ´�.</p>
<p>Microsoft IIS�� ���� ������ ISAPI extension�� ��
�о�鿩�� �� ��뷮�� �ſ� ���� �ʰų� Ư���� ��������
�ʴ��� �״�� �� �д�. ����ġ�� ���� <directive
module="mod_isapi">ISAPICacheFile</directive> ���þ �������
�ʴ´ٸ� ��û�� ���������� ISAPI extension�� �� �о���̰�
������. ��ȿ����������, ����ġ�� �� ������ �̰��� ����
ȿ������ ����̴�. ���� ISAPI ����� ����ġ ������ �ణ
ȣȯ�� �ȸ±���� ������ �������� ���� ����� ����
������.</p>
<p>��, ����ġ�� ISAPI Extension�� ����������, <strong>ISAPI
Filter�� �������� ������</strong> ����϶�. ���߿� ����
������ �� ������, ����� ��ȹ�� ���.</p>
</section>
<section id="journal"><title>������ ����</title>
<p>����ġ 2.0 <module>mod_isapi</module> ����� ���α����Ѵٸ�,
<code>ServerSupportFunction</code> ȣ���� ���� ���þ��
�����ؾ� �Ѵ�.</p>
<dl>
<dt><code>HSE_REQ_SEND_URL_REDIRECT_RESP</code></dt>
<dd>����ڸ� �ٸ� ��ġ�� �����̷����Ѵ�.<br />
������ URL�� ����ؾ� �Ѵ� (<em>���� ���,</em>
<dt><code>HSE_REQ_SEND_URL</code></dt>
<dd>����ڸ� �ٸ� ��ġ�� �����̷����Ѵ�.<br />
������ URL�� �ƴϸ�, �������ݰ� �������� �ѱ� �� ���
(<em>���� ���,</em> <code>/location</code>���� �� ����).<br />
������ �ƴ϶� ������ �����̷����� ó���Ѵ�.<br />
<note type="warning"><title>���</title>
<p>�ֱ� ������ ���� Microsoft�� �� <code>HSE_REQ_SEND_URL</code>
��ɰ��� ���̸� ��� ��ó�� ���δ�. ����ġ�� ��� ��
���� �ƱԸ�Ʈ ���ǰ� �ൿ�� �ٸ��� ó���� ���̴�.</p>
</note></dd>
<dt><code>HSE_REQ_SEND_RESPONSE_HEADER</code></dt>
<dd>headers ���ڿ� �ƱԸ�Ʈ�� ������ (�ٹٲ��ڰ� �ι�
����) �ִٸ� ����ġ�� ��� ���� ������ ���� �������� ����Ѵ�.
headers �ƱԸ�Ʈ�� NULL�� ���������, ���� ���뿡 NULL��
����� �� ���.</dd>
<dt><code>HSE_REQ_DONE_WITH_SESSION</code></dt>
<dd>ISAPI�� ó���� ��ġ�� ������ ��������� ����ġ��
�ƹ� �ϵ� ���� �ʴ´�.</dd>
<dt><code>HSE_REQ_MAP_URL_TO_PATH</code></dt>
<dd>����ġ�� ���� �̸��� ������(����) �̸����� ��ȯ�Ѵ�.</dd>
<dt><code>HSE_APPEND_LOG_PARAMETER</code></dt>
<dd>
������ �Ʒ� �α��� �Ѱ��� �����.
<ul>
<li><directive module="mod_log_config">CustomLog</directive>
���þ��� <code>\"%{isapi-parameter}n\"</code> ��</li>
<li><directive module="mod_isapi">ISAPIAppendLogToQuery</directive>
<code>On</code> ���þ ����Ͽ� <code>%q</code>
�α� ��</li>
<li><directive
module="mod_isapi">ISAPIAppendLogToErrors</directive>
<code>On</code> ���þ ����Ͽ� ���� �α�</li>
</ul>
<p>ù��°�� ���� <code>%{isapi-parameter}n</code> ����
������ ����� �� ������ �����Ѵ�.</p>
</dd>
<dt><code>HSE_REQ_IS_KEEP_CONN</code></dt>
<dd>���� Keep-Alive ���¸� ��ȯ�Ѵ�.</dd>
<dt><code>HSE_REQ_SEND_RESPONSE_HEADER_EX</code></dt>
<dd><code>fKeepConn</code> �ɼ��� �����ϴ� ���� �����ϰ��
������ ���µ��� �����Ѵ�.</dd>
<dt><code>HSE_REQ_IS_CONNECTED</code></dt>
<dd>��û�� �߰��� �������ٸ� false�� ��ȯ�Ѵ�.</dd>
</dl>
<p>�������� �ʴ� <code>ServerSupportFunction</code> ȣ����
�ϸ� ����ġ�� <code>FALSE</code>�� ��ȯ�ϰ�
<code>GetLastError</code> ����
<code>ERROR_INVALID_PARAMETER</code>�� �����Ѵ�.</p>
<p><code>ReadClient</code>�� (<directive
module="mod_isapi">ISAPIReadAheadBuffer</directive>�� ������)
�ʱ����ũ�⸦ �Ѿ ��û ������ �����´�.
<directive>ISAPIReadAheadBuffer</directive> ���� (ISAPI
�ڵ鷯�� �θ����� ������ ����Ʈ��) ���� ª�� ��û�� extension��
�θ��� ��� ��ȴ�. ��û�� ���, ISAPI extension��
<code>ReadClient</code>�� ������ ��û ������ �����;� �Ѵ�.</p>
<p><code>WriteClient</code>�� ����������,
<code>HSE_IO_SYNC</code> �ɼǸ� ����ϰų� (<code>0</code>
��) �ƹ� �ɼǵ� ������� �ʾƾ� �Ѵ�. �ٸ�
<code>WriteClient</code> ��û�� <code>FALSE</code>�� ��ȯ�ϸ�
�����ϰ�, <code>GetLastError</code> ����
<code>ERROR_INVALID_PARAMETER</code>�� �ȴ�.</p>
<p><code>GetServerVariable</code>�� ����������, (�ٸ� ��������
�����ϴ�) Ȯ�� ���������� ���.
<code>GetServerVariable</code>���� ��� �Ϲ����� ����ġ
CGI ȯ�溯���� <code>ALL_HTTP</code>, <code>ALL_RAW</code>
���� ����� �� �ִ�.</p>
<p>����ġ 2.0 <module>mod_isapi</module>�� ���� ISAPI �Ծ
���� �߰� ����� �����ϰ�, �� ����°�
<code>TransmitFile</code> ����� ���� �䳻����. ��, ISAPI
.dll�� �̸� �о�鿩�� ������ ���̴� ����ġ 1.3
<code>mod_isapi</code>���� ��� ����� �����Ѵ�.</p>
</section>
<directivesynopsis>
<name>ISAPICacheFile</name>
<description>������ �����Ҷ� �� �о���� ISAPI .dll ���ϵ�</description>
<syntax>ISAPICacheFile <var>file-path</var> [<var>file-path</var>]
...</syntax>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<usage>
<p>����ġ ������ �����Ҷ� �� �о�鿩�� ������ �����Ҷ�����
�� �������� ���ϸ��� ������� �����Ͽ� �����Ѵ�. ��
���þ�� ISAPI .dll ���Ϻ��� ������ ����� �� �ִ�. ������
��ü ��θ� ��´�. ��� ��ΰ� �ƴϸ� <directive
module="core">ServerRoot</directive>�� ��� ��η� �Ƶ��δ�.</p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>ISAPIReadAheadBuffer</name>
<description>ISAPI extension�� �̸��б����(read ahead buffer)
ũ��</description>
<syntax>ISAPIReadAheadBuffer <var>size</var></syntax>
<default>ISAPIReadAheadBuffer 49152</default>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context></contextlist>
<override>FileInfo</override>
<usage>
<p>ISAPI extension�� ó�� ȣ���Ҷ� �̸��б������ �ִ� ũ�⸦
�����Ѵ�. (�� ũ�⺸�� ū) ������ �ڷ�� <code>ReadClient</code>
�ݹ��� ����Ͽ� �о�� �Ѵ�. � ISAPI extension��
<code>ReadClient</code> ����� �������� �ʴ´�. �� ���
ISAPI extension �����ڿ��� �����϶�.</p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>ISAPILogNotSupported</name>
<description>ISAPI extension�� �������� �ʴ� ����� ��û�ϸ�
�α� ����Ѵ�</description>
<syntax>ISAPILogNotSupported on|off</syntax>
<default>ISAPILogNotSupported off</default>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context></contextlist>
<override>FileInfo</override>
<usage>
<p>ISAPI extension�� �������� �ʴ� ����� ��û�ϸ� ����
���� �α� ����Ѵ�. ���߿� ���ڰ� ������ �����ϴµ�
������ �ȴ�. ���ϴ� ��� ISAPI ����� ���������� �����ϸ�
�ٽ� off�� �ǵ����� �Ѵ�.</p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>ISAPIAppendLogToErrors</name>
<description>ISAPI exntension�� <code>HSE_APPEND_LOG_PARAMETER</code>
��û�� ���� �α� ����Ѵ�</description>
<syntax>ISAPIAppendLogToErrors on|off</syntax>
<default>ISAPIAppendLogToErrors off</default>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context></contextlist>
<override>FileInfo</override>
<usage>
<p>ISAPI exntension�� <code>HSE_APPEND_LOG_PARAMETER</code>
��û�� ���� �α� ����Ѵ�.</p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>ISAPIAppendLogToQuery</name>
<description>ISAPI exntension�� <code>HSE_APPEND_LOG_PARAMETER</code>
��û�� ���ǹ��ڿ��� ����Ѵ�</description>
<syntax>ISAPIAppendLogToQuery on|off</syntax>
<default>ISAPIAppendLogToQuery on</default>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context></contextlist>
<override>FileInfo</override>
<usage>
<p>ISAPI exntension�� <code>HSE_APPEND_LOG_PARAMETER</code>
��û�� ���ǹ��ڿ��� ����Ѵ� (<directive
module="mod_log_config">CustomLog</directive> <code>%q</code>
�� �����δ�).</p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>ISAPIFakeAsync</name>
<description>�� ISAPI �ݹ��� �����ϴ� ô�Ѵ�</description>
<syntax>ISAPIFakeAsync on|off</syntax>
<default>ISAPIFakeAsync off</default>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context></contextlist>
<override>FileInfo</override>
<usage>
<p>on���� �����ϸ� �� ISAPI �ݹ� ������ �䳻����.</p>
</usage>
</directivesynopsis>
</modulesynopsis>