mod_isapi.xml.ko revision ac08ae3142a205d1af6b8eb9b1810af58d904c00
<?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.9 -->
<!--
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
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-isa</code> �ڵ鷯�� �����Ѵ�.
.dll ������ ISAPI extension���� ó���Ϸ��� httpd.conf ���Ͽ�
������ ���� �߰��Ѵ�.</p>
<example>
AddHandler isapi-isa .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>