mod_isapi.xml.ko revision bc4b55ec8f31569d606d5680d50189a355bcd7a6
<?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: 395228:413220 (outdated) -->
<!--
Copyright 2004-2006 The Apache Software Foundation or its licensors,
as applicable.
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_isapi.xml.meta">
<name>mod_isapi</name>
<description>Windows�� ����ġ���� ISAPI Extension ���</description>
<status>Base</status>
<sourcefile>mod_isapi.c</sourcefile>
<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-handler</code> �ڵ鷯�� �����Ѵ�.
.dll ������ ISAPI extension���� ó���Ϸ��� httpd.conf ���Ͽ�
������ ���� �߰��Ѵ�.</p>
<example>
AddHandler isapi-handler .dll
</example>
<p>����ġ ������ ��û�� ����� �޸𸮿� ��� �� �� ���.
�׷��� httpd.conf���� ������ ���� �������� Ư�� ����� �̸�
�о���� ���� �ִ�.</p>
<example>
ISAPICacheFile c:/WebWork/Scripts/ISAPI/mytest.dll
</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>
<code>http://server/location</code>).</dd>
<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>