mod_asis.html revision 72d8c9a30f25171e5c85eeae21e0b87331bac2d9
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe<META http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard LoweXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe This file is generated from xml source: DO NOT EDIT
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard LoweXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe<link href="/style/manual.css" type="text/css" rel="stylesheet">
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe<img alt="[APACHE DOCUMENTATION]" src="/images/sub.gif"><h3>Apache HTTP Server Version 2.0</h3>
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe<table cellspacing="1" cellpadding="0" bgcolor="#cccccc">
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe<td><span class="help">Description:</span></td><td>
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe<description>Sends files that contain their own
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard LoweHTTP headers</description>
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe<td><a href="module-dict.html#Status" class="help">Status:</a></td><td>Base</td>
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe<td><a href="module-dict.html#ModuleIdentifier" class="help">Module Identifier:</a></td><td>asis_module</td>
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe<p>This module provides the handler <code>send-as-is</code>
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe which causes Apache to send the document without adding most of
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe the usual HTTP headers.</p>
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe<p>This can be used to send any kind of data from the server,
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe including redirects and other special HTTP responses, without
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe requiring a cgi-script or an nph script.</p>
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe<p>For historical reasons, this module will also process any
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe file with the mime type <code>httpd/send-as-is</code>.</p>
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe<p>In the server configuration file, associate files with the
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe<td bgcolor="#eeeeee"><code>AddHandler send-as-is asis</code></td>
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe</blockquote>
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe<p>The contents of any file with a <code>.asis</code> extension
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe will then be sent by Apache to the client with almost no
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe changes. Clients will need HTTP headers to be attached, so do
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe not forget them. A Status: header is also required; the data
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe should be the 3-digit HTTP response code, followed by a textual
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe message.</p>
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe<p>Here's an example of a file whose contents are sent <em>as
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe is</em> so as to tell the client that a file has
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe redirected.</p>
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe<td bgcolor="#eeeeee"><code>Status: 301 Now where did I leave that URL<br>
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe <HTML><br>
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe <HEAD><br>
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe <TITLE>Lame excuses'R'us</TITLE><br>
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe </HEAD><br>
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe <BODY><br>
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe <H1>Fred's exceptionally wonderful page has moved
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe HREF="http://xyz.abc.com/foo/bar.html">Joe's</A>
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe </H1><br>
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe </BODY><br>
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe </HTML>
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe</blockquote>
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe<p>Notes: the server always adds a Date: and Server: header to
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe the data returned to the client, so these should not be
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe included in the file. The server does <em>not</em> add a
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe Last-Modified header; it probably should. </p>
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe<h3 align="center">Apache HTTP Server Version 2.0</h3>
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe<a href="./"><img alt="Index" src="/images/index.gif"></a><a href="../"><img alt="Home" src="/images/home.gif"></a>
10d63b7db37a83b39c7f511cf9426c9d03ea0760Richard Lowe</blockquote>