mod_isapi.xml.ko revision bc4b55ec8f31569d606d5680d50189a355bcd7a6
2N/A<?xml version="1.0" encoding="EUC-KR" ?>
2N/A<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">
2N/A<?xml-stylesheet type="text/xsl" href="/style/manual.ko.xsl"?>
2N/A<!-- English Revision: 395228:413220 (outdated) -->
2N/A
2N/A<!--
2N/A Copyright 2004-2006 The Apache Software Foundation or its licensors,
2N/A as applicable.
2N/A
2N/A Licensed under the Apache License, Version 2.0 (the "License");
2N/A you may not use this file except in compliance with the License.
2N/A You may obtain a copy of the License at
2N/A
2N/A http://www.apache.org/licenses/LICENSE-2.0
2N/A
2N/A Unless required by applicable law or agreed to in writing, software
2N/A distributed under the License is distributed on an "AS IS" BASIS,
2N/A WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
2N/A See the License for the specific language governing permissions and
2N/A limitations under the License.
2N/A-->
2N/A
2N/A<modulesynopsis metafile="mod_isapi.xml.meta">
2N/A
2N/A<name>mod_isapi</name>
2N/A<description>Windows�� ����ġ���� ISAPI Extension ���</description>
2N/A<status>Base</status>
2N/A<sourcefile>mod_isapi.c</sourcefile>
2N/A<identifier>isapi_module</identifier>
2N/A<compatibility>Win32 only</compatibility>
2N/A
2N/A<summary>
2N/A <p>�� ����� Internet Server extension API�� �����Ѵ�. �׷���
2N/A ������ ������ Windows�� ����ġ���� Internet Server extension��
2N/A (<em>��,</em> ISAPI .dll ���) ����� �� �ִ�.</p>
2N/A
2N/A <p>ISAPI extension ���(.dll ����)�� �����ڰ� �ۼ��Ѵ�.
2N/A Apache Group�� �̵� ����� ������ �ʾ�����, ���� ����
2N/A �ʴ´�. ISAPI extension ��뿡 ���� ������ ISAPI �����ڿ���
2N/A ���� �����ϱ� �ٶ���. <strong>���� �̷� ������ ����ġ
2N/A ���ϸ�����Ʈ�� ���׺��� �������� �ø��� <em>����</em>.</strong></p>
2N/A</summary>
2N/A
2N/A<section id="usage"><title>����</title>
2N/A
2N/A <p>�����������Ͽ��� <directive
2N/A 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>