| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> |
| <HTML> |
| <HEAD> |
| <TITLE>Apache module mod_asis</TITLE> |
| </HEAD> |
| |
| <!-- Background white, links blue (unvisited), navy (visited), red (active) --> |
| <BODY |
| BGCOLOR="#FFFFFF" |
| TEXT="#000000" |
| LINK="#0000FF" |
| VLINK="#000080" |
| ALINK="#FF0000" |
| > |
| <!--#include virtual="header.html" --> |
| |
| <H1 ALIGN="CENTER">Module mod_asis</H1> |
| |
| <P>This module provides for sending files which contain their own |
| HTTP headers. |
| |
| <P><A |
| HREF="module-dict.html#Status" |
| REL="Help" |
| ><STRONG>Status:</STRONG></A> Base |
| <BR> |
| <A |
| HREF="module-dict.html#SourceFile" |
| REL="Help" |
| ><STRONG>Source File:</STRONG></A> mod_asis.c |
| <BR> |
| <A |
| HREF="module-dict.html#ModuleIdentifier" |
| REL="Help" |
| ><STRONG>Module Identifier:</STRONG></A> asis_module |
| </P> |
| |
| <H2>Summary</H2> |
| |
| <p>This module provides the handler <code>send-as-is</code> wich |
| causes Apache to send the document without adding most of the usual |
| HTTP headers.</p> |
| |
| <P>This can be used to send any kind of data from the server, |
| including redirects and other special HTTP responses, without |
| requiring a cgi-script or an nph script. |
| |
| <p>For historical reasons, this module will also process any file with |
| the mime type <code>httpd/send-as-is</code>. |
| |
| <H2>Directives</H2> |
| |
| <P>This module provides no directives. |
| |
| <H2>Usage</H2> |
| |
| <P>In the server configuration file, associate files with the |
| <code>send-as-is</code> handler <EM>e.g.</EM> |
| <BLOCKQUOTE><CODE>AddHandler send-as-is asis</CODE></BLOCKQUOTE> |
| The contents of any file with a <CODE>.asis</CODE> extension will then |
| be sent by Apache to the client with almost no changes. Clients will |
| need HTTP headers to be attached, so do not forget them. A Status: |
| header is also required; the data should be the 3-digit HTTP response |
| code, followed by a textual message. |
| |
| <P>Here's an example of a file whose contents are sent <EM>as is</EM> |
| so as to tell the client that a file has redirected. |
| <BLOCKQUOTE><CODE> Status: 301 Now where did I leave that URL <BR> |
| Location: http://xyz.abc.com/foo/bar.html <BR> |
| Content-type: text/html |
| <BR> |
| <BR> |
| <HTML> <BR> |
| <HEAD> <BR> |
| <TITLE>Lame excuses'R'us</TITLE> <BR> |
| </HEAD> <BR> |
| <BODY> <BR> |
| <H1>Fred's exceptionally wonderful page has moved to <BR> |
| <A HREF="http://xyz.abc.com/foo/bar.html">Joe's</A> site. <BR> |
| </H1> <BR> |
| </BODY> <BR> |
| </HTML> |
| </CODE></BLOCKQUOTE> |
| |
| <P>Notes: the server always adds a Date: and Server: header to the data returned |
| to the client, so these should not be included in the file. |
| The server does <EM>not</EM> add a Last-Modified header; it probably should. |
| |
| <!--#include virtual="footer.html" --> |
| </BODY> |
| </HTML> |