mod_asis.xml revision 130852d0f5f810207a3a064d270c239ac52ae820
f78ba66d5075af3e07e2d93aa7fa7b884836c6e8slive<?xml version="1.0"?>
f78ba66d5075af3e07e2d93aa7fa7b884836c6e8slive<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">
f78ba66d5075af3e07e2d93aa7fa7b884836c6e8slive<?xml-stylesheet type="text/xsl" href="/style/manual.en.xsl"?>
f78ba66d5075af3e07e2d93aa7fa7b884836c6e8slive<modulesynopsis>
f78ba66d5075af3e07e2d93aa7fa7b884836c6e8slive
f78ba66d5075af3e07e2d93aa7fa7b884836c6e8slive<name>mod_asis</name>
5a58787efeb02a1c3f06569d019ad81fd2efa06end<description>Sends files that contain their own
5a58787efeb02a1c3f06569d019ad81fd2efa06endHTTP headers</description>
5a58787efeb02a1c3f06569d019ad81fd2efa06end<status>Base</status>
5a58787efeb02a1c3f06569d019ad81fd2efa06end<sourcefile>mod_asis.c</sourcefile>
5a58787efeb02a1c3f06569d019ad81fd2efa06end<identifier>asis_module</identifier>
5a58787efeb02a1c3f06569d019ad81fd2efa06end
00c2cccc28f249fb3b968ddf3e05508595290d40nd<summary>
5a58787efeb02a1c3f06569d019ad81fd2efa06end <p>This module provides the handler <code>send-as-is</code>
3f08db06526d6901aa08c110b5bc7dde6bc39905nd which causes Apache to send the document without adding most of
5a58787efeb02a1c3f06569d019ad81fd2efa06end the usual HTTP headers.</p>
5a58787efeb02a1c3f06569d019ad81fd2efa06end
5a58787efeb02a1c3f06569d019ad81fd2efa06end <p>This can be used to send any kind of data from the server,
3f08db06526d6901aa08c110b5bc7dde6bc39905nd including redirects and other special HTTP responses, without
3b3b7fc78d1f5bfc2769903375050048ff41ff26nd requiring a cgi-script or an nph script.</p>
a78048ccbdb6256da15e6b0e7e95355e480c2301nd
b05ab3ff5ab54aa22610b13d56eaba6ddfc3db60nd <p>For historical reasons, this module will also process any
e23d878014f00a27b043a25e59f809c7af497e5ctakashi file with the mime type <code>httpd/send-as-is</code>.</p>
d474d8ef01ec5c2a09341cd148851ed383c3287crbowen</summary>
d474d8ef01ec5c2a09341cd148851ed383c3287crbowen
3b3b7fc78d1f5bfc2769903375050048ff41ff26nd<seealso><module>mod_headers</module></seealso>
3b3b7fc78d1f5bfc2769903375050048ff41ff26nd<seealso><module>mod_cern_meta</module></seealso>
f78ba66d5075af3e07e2d93aa7fa7b884836c6e8slive
f78ba66d5075af3e07e2d93aa7fa7b884836c6e8slive<section><title>Usage</title>
5a58787efeb02a1c3f06569d019ad81fd2efa06end
5a58787efeb02a1c3f06569d019ad81fd2efa06end <p>In the server configuration file, associate files with the
5a58787efeb02a1c3f06569d019ad81fd2efa06end <code>send-as-is</code> handler <em>e.g.</em></p>
5a58787efeb02a1c3f06569d019ad81fd2efa06end
f78ba66d5075af3e07e2d93aa7fa7b884836c6e8slive<example>AddHandler send-as-is asis</example>
f78ba66d5075af3e07e2d93aa7fa7b884836c6e8slive
9bcfc3697a91b5215893a7d0206865b13fc72148nd <p>The contents of any file with a <code>.asis</code> extension
f78ba66d5075af3e07e2d93aa7fa7b884836c6e8slive will then be sent by Apache to the client with almost no
f78ba66d5075af3e07e2d93aa7fa7b884836c6e8slive changes. Clients will need HTTP headers to be attached, so do
f78ba66d5075af3e07e2d93aa7fa7b884836c6e8slive not forget them. A Status: header is also required; the data
9bcfc3697a91b5215893a7d0206865b13fc72148nd should be the 3-digit HTTP response code, followed by a textual
f78ba66d5075af3e07e2d93aa7fa7b884836c6e8slive message.</p>
f78ba66d5075af3e07e2d93aa7fa7b884836c6e8slive
f78ba66d5075af3e07e2d93aa7fa7b884836c6e8slive <p>Here's an example of a file whose contents are sent <em>as
9bcfc3697a91b5215893a7d0206865b13fc72148nd is</em> so as to tell the client that a file has
f78ba66d5075af3e07e2d93aa7fa7b884836c6e8slive redirected.</p>
f78ba66d5075af3e07e2d93aa7fa7b884836c6e8slive
f78ba66d5075af3e07e2d93aa7fa7b884836c6e8slive
9bcfc3697a91b5215893a7d0206865b13fc72148nd<example>Status: 301 Now where did I leave that URL<br />
f78ba66d5075af3e07e2d93aa7fa7b884836c6e8slive Location: http://xyz.abc.com/foo/bar.html<br />
f78ba66d5075af3e07e2d93aa7fa7b884836c6e8slive Content-type: text/html<br />
f78ba66d5075af3e07e2d93aa7fa7b884836c6e8slive <br />
9bcfc3697a91b5215893a7d0206865b13fc72148nd &lt;HTML&gt;<br />
9ed703ab1543b3300f4b60c0405fc1a212b601c8slive &lt;HEAD&gt;<br />
9ed703ab1543b3300f4b60c0405fc1a212b601c8slive &lt;TITLE&gt;Lame excuses'R'us&lt;/TITLE&gt;<br />
9ed703ab1543b3300f4b60c0405fc1a212b601c8slive &lt;/HEAD&gt;<br />
9bcfc3697a91b5215893a7d0206865b13fc72148nd &lt;BODY&gt;<br />
f78ba66d5075af3e07e2d93aa7fa7b884836c6e8slive &lt;H1&gt;Fred's exceptionally wonderful page has moved
f78ba66d5075af3e07e2d93aa7fa7b884836c6e8slive to<br />
f78ba66d5075af3e07e2d93aa7fa7b884836c6e8slive &lt;A
f78ba66d5075af3e07e2d93aa7fa7b884836c6e8slive HREF="http://xyz.abc.com/foo/bar.html"&gt;Joe's&lt;/A&gt;
1d980e5489836e977ba59b419e27b0ec875c4bd3takashi site.<br />
1d980e5489836e977ba59b419e27b0ec875c4bd3takashi &lt;/H1&gt;<br />
1d980e5489836e977ba59b419e27b0ec875c4bd3takashi &lt;/BODY&gt;<br />
1d980e5489836e977ba59b419e27b0ec875c4bd3takashi &lt;/HTML&gt;
343a568a3281a6a0a4c562407aef7b0dfc299b98minfrin</example>
343a568a3281a6a0a4c562407aef7b0dfc299b98minfrin
343a568a3281a6a0a4c562407aef7b0dfc299b98minfrin <p>Notes: the server always adds a Date: and Server: header to
343a568a3281a6a0a4c562407aef7b0dfc299b98minfrin the data returned to the client, so these should not be
9bcfc3697a91b5215893a7d0206865b13fc72148nd included in the file. The server does <em>not</em> add a
1d980e5489836e977ba59b419e27b0ec875c4bd3takashi Last-Modified header; it probably should. </p>
a8703cfb67133446eef7af1043640e71486e9ecand</section>
a8703cfb67133446eef7af1043640e71486e9ecand
9bcfc3697a91b5215893a7d0206865b13fc72148nd</modulesynopsis>
f78ba66d5075af3e07e2d93aa7fa7b884836c6e8slive