mod_asis.html revision 72d8c9a30f25171e5c85eeae21e0b87331bac2d9
9563e6542b7a8a13b13a0ef62ec68b0383b99293Timo Sirainen<html>
9563e6542b7a8a13b13a0ef62ec68b0383b99293Timo Sirainen<head>
1795e934ebcd58175d3b5bbdd811b13c7889efa3Timo Sirainen<META http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
1795e934ebcd58175d3b5bbdd811b13c7889efa3Timo Sirainen<!--
1795e934ebcd58175d3b5bbdd811b13c7889efa3Timo SirainenXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
677e22747b82bf15b339e31d1d0106d62bf806daTimo Sirainen This file is generated from xml source: DO NOT EDIT
1795e934ebcd58175d3b5bbdd811b13c7889efa3Timo SirainenXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
677e22747b82bf15b339e31d1d0106d62bf806daTimo Sirainen-->
677e22747b82bf15b339e31d1d0106d62bf806daTimo Sirainen<title>mod_asis - Apache HTTP Server</title>
9563e6542b7a8a13b13a0ef62ec68b0383b99293Timo Sirainen<link href="/style/manual.css" type="text/css" rel="stylesheet">
9563e6542b7a8a13b13a0ef62ec68b0383b99293Timo Sirainen</head>
1795e934ebcd58175d3b5bbdd811b13c7889efa3Timo Sirainen<body>
a966016e605eea27e02d73ff1412632cd684d770Timo Sirainen<blockquote>
bc10373fc050eb9dd23f6ed5ee8207d0e4d142eeTimo Sirainen<div align="center">
9d1526ac8bcec9aff3c3a32f092ee2f3da2760b7Timo Sirainen<img alt="[APACHE DOCUMENTATION]" src="/images/sub.gif"><h3>Apache HTTP Server Version 2.0</h3>
1795e934ebcd58175d3b5bbdd811b13c7889efa3Timo Sirainen</div>
1795e934ebcd58175d3b5bbdd811b13c7889efa3Timo Sirainen<h1 align="center">Apache Module mod_asis</h1>
9d1526ac8bcec9aff3c3a32f092ee2f3da2760b7Timo Sirainen<table cellspacing="1" cellpadding="0" bgcolor="#cccccc">
1795e934ebcd58175d3b5bbdd811b13c7889efa3Timo Sirainen<tr>
23ad3970cd22adb6c875caf95fa791548849f0d1Timo Sirainen<td>
1795e934ebcd58175d3b5bbdd811b13c7889efa3Timo Sirainen<table bgcolor="#ffffff">
62300a38f91227b9de043a9a8ec1d4f1978e1138Timo Sirainen<tr>
a35cbba04d0a2823da98e693bd09a051addffdb2Timo Sirainen<td><span class="help">Description:</span></td><td>
1795e934ebcd58175d3b5bbdd811b13c7889efa3Timo Sirainen<description>Sends files that contain their own
1795e934ebcd58175d3b5bbdd811b13c7889efa3Timo SirainenHTTP headers</description>
cb951d3282610a9a0960230865bc5f3e3347b203Timo Sirainen</td>
1795e934ebcd58175d3b5bbdd811b13c7889efa3Timo Sirainen</tr>
1795e934ebcd58175d3b5bbdd811b13c7889efa3Timo Sirainen<tr>
1795e934ebcd58175d3b5bbdd811b13c7889efa3Timo Sirainen<td><a href="module-dict.html#Status" class="help">Status:</a></td><td>Base</td>
e1b13a5c1507c2583fc6bd07e690037be8a802a7Timo Sirainen</tr>
e1b13a5c1507c2583fc6bd07e690037be8a802a7Timo Sirainen<tr>
f4526ec0e620af27bc027955f7a56cfe187c212fTimo Sirainen<td><a href="module-dict.html#ModuleIdentifier" class="help">Module&nbsp;Identifier:</a></td><td>asis_module</td>
9563e6542b7a8a13b13a0ef62ec68b0383b99293Timo Sirainen</tr>
9563e6542b7a8a13b13a0ef62ec68b0383b99293Timo Sirainen</table>
9563e6542b7a8a13b13a0ef62ec68b0383b99293Timo Sirainen</td>
9563e6542b7a8a13b13a0ef62ec68b0383b99293Timo Sirainen</tr>
9563e6542b7a8a13b13a0ef62ec68b0383b99293Timo Sirainen</table>
9563e6542b7a8a13b13a0ef62ec68b0383b99293Timo Sirainen<h2>Summary</h2>
23ad3970cd22adb6c875caf95fa791548849f0d1Timo Sirainen<summary>
23ad3970cd22adb6c875caf95fa791548849f0d1Timo Sirainen
4c7caf83adc56d54e2ecec0a803f5ca9b6d0498dTimo Sirainen<p>This module provides the handler <code>send-as-is</code>
667f09546abd3d3636b277fec9dba8622cb3d644Timo Sirainen which causes Apache to send the document without adding most of
23ad3970cd22adb6c875caf95fa791548849f0d1Timo Sirainen the usual HTTP headers.</p>
acbd82bd456316a32f61df67fc41bbff681119c7Timo Sirainen
acbd82bd456316a32f61df67fc41bbff681119c7Timo Sirainen
9fd7e883292dab58f3c209f0ec6a8cd11e52075cTimo Sirainen<p>This can be used to send any kind of data from the server,
d0cc826dab58ed8e30e1ccd7cb6ad2f44b391a00Timo Sirainen including redirects and other special HTTP responses, without
d0cc826dab58ed8e30e1ccd7cb6ad2f44b391a00Timo Sirainen requiring a cgi-script or an nph script.</p>
acbd82bd456316a32f61df67fc41bbff681119c7Timo Sirainen
fba3d682d6bad6a9530b254d6fd07dc5577be7feTimo Sirainen
d0cc826dab58ed8e30e1ccd7cb6ad2f44b391a00Timo Sirainen<p>For historical reasons, this module will also process any
a321662b406acc9c9e6fe52332236740d449f591Timo Sirainen file with the mime type <code>httpd/send-as-is</code>.</p>
a321662b406acc9c9e6fe52332236740d449f591Timo Sirainen
f740f218bbb1a98cea08dd82b601a8dd50f35093Timo Sirainen</summary>
23ad3970cd22adb6c875caf95fa791548849f0d1Timo Sirainen<h2>Directives</h2>
1707642460105a013eb08e902c9ffdb2cbd86a1eTimo Sirainen<p>This module provides no directives.</p>
23ad3970cd22adb6c875caf95fa791548849f0d1Timo Sirainen<h2>Usage</h2>
23ad3970cd22adb6c875caf95fa791548849f0d1Timo Sirainen
23ad3970cd22adb6c875caf95fa791548849f0d1Timo Sirainen
fdbcd3027578d35cb6e12b44c06a46905024e300Timo Sirainen<p>In the server configuration file, associate files with the
fdbcd3027578d35cb6e12b44c06a46905024e300Timo Sirainen <code>send-as-is</code> handler <em>e.g.</em>
797d20c35779d68f2542d3e287c1a869048c8f26Timo Sirainen</p>
797d20c35779d68f2542d3e287c1a869048c8f26Timo Sirainen
a35cbba04d0a2823da98e693bd09a051addffdb2Timo Sirainen
797d20c35779d68f2542d3e287c1a869048c8f26Timo Sirainen<blockquote>
797d20c35779d68f2542d3e287c1a869048c8f26Timo Sirainen<table cellpadding="10">
797d20c35779d68f2542d3e287c1a869048c8f26Timo Sirainen<tr>
88c580cdff2656df007fdfe5bd8ca8a465ee605aTimo Sirainen<td bgcolor="#eeeeee"><code>AddHandler send-as-is asis</code></td>
88c580cdff2656df007fdfe5bd8ca8a465ee605aTimo Sirainen</tr>
23ad3970cd22adb6c875caf95fa791548849f0d1Timo Sirainen</table>
acbd82bd456316a32f61df67fc41bbff681119c7Timo Sirainen</blockquote>
acbd82bd456316a32f61df67fc41bbff681119c7Timo Sirainen
acbd82bd456316a32f61df67fc41bbff681119c7Timo Sirainen
23ad3970cd22adb6c875caf95fa791548849f0d1Timo Sirainen<p>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>
<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.</p>
<blockquote>
<table cellpadding="10">
<tr>
<td bgcolor="#eeeeee"><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>
&lt;HTML&gt;<br>
&lt;HEAD&gt;<br>
&lt;TITLE&gt;Lame excuses'R'us&lt;/TITLE&gt;<br>
&lt;/HEAD&gt;<br>
&lt;BODY&gt;<br>
&lt;H1&gt;Fred's exceptionally wonderful page has moved
to<br>
&lt;A
HREF="http://xyz.abc.com/foo/bar.html"&gt;Joe's&lt;/A&gt;
site.<br>
&lt;/H1&gt;<br>
&lt;/BODY&gt;<br>
&lt;/HTML&gt;
</code></td>
</tr>
</table>
</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. </p>
<hr>
<h3 align="center">Apache HTTP Server Version 2.0</h3>
<a href="./"><img alt="Index" src="/images/index.gif"></a><a href="../"><img alt="Home" src="/images/home.gif"></a>
</blockquote>
</body>
</html>