mod_asis.html revision 240a5b8962329911d02566b600be6226e1f857ae
842ae4bd224140319ae7feec1872b93dfd491143fielding<html xmlns="http://www.w3.org/TR/xhtml1/strict"><head><!--
842ae4bd224140319ae7feec1872b93dfd491143fieldingXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
842ae4bd224140319ae7feec1872b93dfd491143fielding This file is generated from xml source: DO NOT EDIT
842ae4bd224140319ae7feec1872b93dfd491143fieldingXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
842ae4bd224140319ae7feec1872b93dfd491143fielding--><title>mod_asis - Apache HTTP Server</title><link rel="stylesheet" type="text/css" href="/style/manual.css"/></head><body><blockquote><div align="center"><img src="/images/sub.gif" alt="[APACHE DOCUMENTATION]"/><h3>Apache HTTP Server Version 2.0</h3></div><h1 align="center">Apache Module mod_asis</h1><table bgcolor="#cccccc" cellpadding="0" cellspacing="1"><tr><td><table bgcolor="#ffffff"><tr><td valign="top"><span class="help">Description:</span></td><td>Sends files that contain their own
842ae4bd224140319ae7feec1872b93dfd491143fieldingHTTP headers</td></tr><tr><td><a class="help" href="module-dict.html#Status">Status:</a></td><td>Base</td></tr><tr><td><a class="help" href="module-dict.html#ModuleIdentifier">Module Identifier:</a></td><td>asis_module</td></tr></table></td></tr></table><h2>Summary</h2>
3ff7ee7f86c67bbde54d99d4c21d7c7aeccb9474wrowe <p>This module provides the handler <code>send-as-is</code>
ce9621257ef9e54c1bbe5ad8a5f445a1f211c2dcnd which causes Apache to send the document without adding most of
3ff7ee7f86c67bbde54d99d4c21d7c7aeccb9474wrowe the usual HTTP headers.</p>
ce9621257ef9e54c1bbe5ad8a5f445a1f211c2dcnd <p>This can be used to send any kind of data from the server,
ce9621257ef9e54c1bbe5ad8a5f445a1f211c2dcnd including redirects and other special HTTP responses, without
ce9621257ef9e54c1bbe5ad8a5f445a1f211c2dcnd requiring a cgi-script or an nph script.</p>
3ff7ee7f86c67bbde54d99d4c21d7c7aeccb9474wrowe <p>For historical reasons, this module will also process any
3ff7ee7f86c67bbde54d99d4c21d7c7aeccb9474wrowe file with the mime type <code>httpd/send-as-is</code>.</p>
3ff7ee7f86c67bbde54d99d4c21d7c7aeccb9474wrowe<h2>Directives</h2><p>This module provides no directives.</p><h2>Usage</h2>
3ff7ee7f86c67bbde54d99d4c21d7c7aeccb9474wrowe <p>In the server configuration file, associate files with the
3ff7ee7f86c67bbde54d99d4c21d7c7aeccb9474wrowe<blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>AddHandler send-as-is asis</code></td></tr></table></blockquote>
3ff7ee7f86c67bbde54d99d4c21d7c7aeccb9474wrowe <p>The contents of any file with a <code>.asis</code> extension
3ff7ee7f86c67bbde54d99d4c21d7c7aeccb9474wrowe will then be sent by Apache to the client with almost no
65cb7f00eca6689c8a89dc809359991ade1285bcwrowe changes. Clients will need HTTP headers to be attached, so do
3ff7ee7f86c67bbde54d99d4c21d7c7aeccb9474wrowe not forget them. A Status: header is also required; the data
3ff7ee7f86c67bbde54d99d4c21d7c7aeccb9474wrowe should be the 3-digit HTTP response code, followed by a textual
3ff7ee7f86c67bbde54d99d4c21d7c7aeccb9474wrowe message.</p>
86c5bd98380178c2bc7675e84c6730289ad82282wrowe <p>Here's an example of a file whose contents are sent <em>as
86c5bd98380178c2bc7675e84c6730289ad82282wrowe is</em> so as to tell the client that a file has
3ff7ee7f86c67bbde54d99d4c21d7c7aeccb9474wrowe redirected.</p>
0204d0775c83736e81e9006da8912c51b092a739wrowe<blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>Status: 301 Now where did I leave that URL<br/>
3ff7ee7f86c67bbde54d99d4c21d7c7aeccb9474wrowe <HTML><br/>
f1dca7251fadc2750abfa00e19c154aa61cb6a53wrowe <HEAD><br/>
f1dca7251fadc2750abfa00e19c154aa61cb6a53wrowe <TITLE>Lame excuses'R'us</TITLE><br/>
3ff7ee7f86c67bbde54d99d4c21d7c7aeccb9474wrowe </HEAD><br/>
3ff7ee7f86c67bbde54d99d4c21d7c7aeccb9474wrowe <BODY><br/>
65cb7f00eca6689c8a89dc809359991ade1285bcwrowe <H1>Fred's exceptionally wonderful page has moved
3ff7ee7f86c67bbde54d99d4c21d7c7aeccb9474wrowe HREF="http://xyz.abc.com/foo/bar.html">Joe's</A>
65cb7f00eca6689c8a89dc809359991ade1285bcwrowe </H1><br/>
65cb7f00eca6689c8a89dc809359991ade1285bcwrowe </BODY><br/>
65cb7f00eca6689c8a89dc809359991ade1285bcwrowe </HTML>
3ff7ee7f86c67bbde54d99d4c21d7c7aeccb9474wrowe <p>Notes: the server always adds a Date: and Server: header to
213ebd772a4401a769aafcf4ee985b78cd5a0a26wrowe the data returned to the client, so these should not be
3ff7ee7f86c67bbde54d99d4c21d7c7aeccb9474wrowe included in the file. The server does <em>not</em> add a
e0c551ce76a6fe2f4e582cc1c3680a4d8d7bc8ddmturk Last-Modified header; it probably should. </p>
