From: Alexei Kosut Date: Tue, 22 Jul 1997 20:47:40 +0000 (+0000) Subject: Add docs for mod_isapi X-Git-Tag: APACHE_1_3a1~3 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=a0fdad7bede074164d97370dda2be25ffe314dcd;p=thirdparty%2Fapache%2Fhttpd.git Add docs for mod_isapi git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@78742 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/mod/index.html b/docs/manual/mod/index.html index a0730ac6d54..4e582e41ff1 100644 --- a/docs/manual/mod/index.html +++ b/docs/manual/mod/index.html @@ -77,6 +77,8 @@ mod_usertrack
Server-parsed documents.
mod_info
Server configuration information +
mod_isapi +
Windows ISAPI Extension support
mod_log_agent
Logging of User Agents.
mod_log_common up to Apache 1.1.1 diff --git a/docs/manual/mod/mod_isapi.html b/docs/manual/mod/mod_isapi.html new file mode 100644 index 00000000000..5fde08c1a7d --- /dev/null +++ b/docs/manual/mod/mod_isapi.html @@ -0,0 +1,73 @@ + + + +Apache module mod_isapi + + + + + + +

Module mod_isapi

+ +

This module is contained in the mod_isapi.c file, and is + compiled in by default. It provides support for ISAPI Extensions when + running under Microsoft Windows. Any document with a handler of + isapi-isa will be processed by this module. + +

Purpose

+ +

This module implements the ISAPI + Extension API. It allows Internet Server Applications (i.e., ISAPI + Extensions) to be used with Apache for Windows. + +

Usage

+ +

In the server configuration file, add a handler called + isapi-isa, and map it to files with a .DLL + extension. In other words:

+
+    AddHandler isapi-isa dll
+
+

Now simply place the ISA DLLs into your document root, and they will + be loaded when their URLs are accessed.

+ +

ISAPI Extensions are governed by the same restrictions as CGI + scripts. That is, Options ExecCGI must be active in the + directory that contains the ISA.

+ +

Notes

+ +

Apache's ISAPI implementation conforms to all of the ISAPI 2.0 + specification, except for the "Microsoft-specific" extensions dealing + with ascynchronous I/O. Apache's I/O model does not allow asynchronous + reading and writing in a manner that the ISAPI could access. If an ISA + tries to access async I/O, a message will be place in the error log, + to help with debugging. + +

Some servers, like Microsoft IIS, load the ISA into the server, and + keep it loaded until memory usage is too high, and it is + unloaded. Apache currently loads and unloads the ISA for each + request. This is inefficient, but Apache's request model makes this + method the only method that currently works. A future release may use + a more effective loading method. + +

Apache 1.3a1 currently limits POST and PUT input to 48k per + request. This is to work around a problem with the ISAPI implementation + that could result in a denial of service attack. It is expected that + support for larger uploads will be added soon. + +

Also, remember that while Apache supports ISAPI Extensions, it does + not support ISAPI Filters. Support for filters may be added at a later + date, but no support is planned at this time.

+ + + + diff --git a/docs/manual/platform/windows.html b/docs/manual/platform/windows.html index 144ef04340f..be50916e211 100644 --- a/docs/manual/platform/windows.html +++ b/docs/manual/platform/windows.html @@ -153,7 +153,7 @@ together with details of mirror web and anonymous ftp sites.

Configuring Apache is nearly identical to the Unix version of Apache, so most of the standard Apache documentation is - applicable. A few things are, however, different:

+ applicable. A few things are, however, different, or new:

Once Apache is configured correctly, it is nearly ready to be