<html>
<head>
<title>
Snert . Com - Software - mod_loopback/2.1 for Apache 2.0
</title>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<meta name="keywords" content="Apache 2.0 module mod_loopback echo request loopback loop back TRACE method">
<meta name="description" content="An Apache module that serves as a web client
debugging tool and simply sends back plain text output of everything received
conerning a request.">
<script language="JavaScript" type="text/javascript" src="./mailto.js"></script>
<link rel="stylesheet" type="text/css" href="./style.css">
</head>
<body background="Img/bg.gif">
<!-- MARGINS -->
<table cellpadding="0" cellspacing="0" border="0" width="100%">
<tr>
<td rowspan="2" width="120"> </td>
<td width="250"><img alt="Snert . Com" src="Img/sun.gif" width="105" height="103"></td>
<td align="left">
<span class="title">mod_loopback/2.1</span>
<br>
<span class="plain">from</span>
<span class="snert">Snert . Com</span>
</td>
<td rowspan="2" valign="top" align="right" width="60"> </td>
</tr><tr>
<td colspan="2">
<!-- PAGE BODY -->
<h2 align="center">When there is no TRACE.</h2>
<p align="center">
<a href="/loop-back">
GET Loopback Example</a>
</p>
<center>
<form method="POST" action="/loop-back">
<input type="submit" name="example" value="POST Loopback Example">
<input type="hidden" name="garibaldi" value="peek-a-boo">
</form>
</center>
<p align="center">
- <a href="http://www.snert.com/">Welcome</a>
- <a href="http://www.snert.com/Software/index.html">Software</a>
-
</p>
<a name="Description"></a>
<h3>Description</h3>
<p align="justify">
This module serves as a web client debugging tool and simply sends back
plain text output of everything received conerning a request: the request
line, headers, any content received from a POST or PUT, and if installed,
any data passed from mod_watch.
</p>
<a name="Configuration"></a>
<h3>Configuration</h3>
<p>
The commands below can be added to the general Apache configuration file,
<code>httpd.conf</code>.
</p>
<dl>
<a name="LoopbackLog"></a>
<dt><span class="syntax">LoopbackLog <span class="param">boolean</span></span></dt>
<dd><span class="normal">Context: server</span>
<p>
When true, save the contents of all requests into the log file specified
by LoopbackLogFile. Default is false.
</p>
</dd>
<a name="LoopbackLogFile"></a>
<dt><span class="syntax">LoopbackLogFile <span class="param">file</span></span></dt>
<dd><span class="normal">Context: server</span>
<p align="justify">
An absolute or server-root relative filename used to log loop-back requests.
The default is "logs/loopback.log".
</p>
</dd>
</dl>
<a name="Installation"></a>
<h3>Installation</h3>
<ol>
<li><p>
Download either:
</p>
<ul>
<li><a href="CHANGES.TXT">Change Log.</a></li>
<li><a href="LICENSE.TXT">License, Disclaimer, and Support</a></li>
<li><a href="http://www.snert.com/Software/download/mod_loopback104.tgz">mod_loopback104.tgz</a> for <b>Apache 1.3</b></li>
<li><a href="http://www.snert.com/Software/download/mod_loopback201.tgz">mod_loopback201.tgz</a> for <b>Apache 2.0</b></li>
</ul>
<p>
and unpack.
</p></li>
<li><p align="justify">
Next, to build this module as DSO library for <b>Apache 2.0</b>, just type:
<blockquote>
<pre>
cd (path to)/mod_loopback-2.1
make -f Makefile.dso install
</pre>
</blockquote>
</p>
<p>
To build as a static module into <b>Apache 2.0</b>:
</p>
<blockquote>
<pre>
cd (path to)/apache_2.0.43
mkdir -p modules/com/snert
mv (path to)/mod_loopback-2.1 modules/com/snert/loopback
./buildconf
./configure \
--enable-loopback=static \
... (your other configuration options) ...
make install
</pre>
</blockquote>
<p>
To build as a static module into <b>Apache 1.3</b>:
</p>
<blockquote>
<pre>
cd (path to)/apache_1.3.27
./configure \
--add-module=(absoulte path to)/mod_loopback-1.4/mod_loopback.c \
--disable-shared=loopback \
... (your other configuration options) ...
make install
</pre>
</blockquote>
<a name="HttpdConf"></a>
<li><p align="justify">
The following must be added to the top-level server configuration
within <code>httpd.conf</code> in order for mod_loopback to function:
<blockquote>
<pre><IfModule mod_loopback.c>
# Allows URLs used to perform a request loop-back:
#
# http://www.snert.com/loop-back
# http://www.snert.com/Software/loop-back
# http://www.snert.com/Software/mod_loopback/loop-back
#
<LocationMatch ".*/loop-back">
SetHandler loop-back
</LocationMatch>
</IfModule>
</pre>
</blockquote>
</li>
<li><p>
Restart the web server:
</p>
<blockquote>
<pre>
apachectl restart
</pre>
</blockquote>
</li>
</ol>
<a name="License"></a>
<h3>License</h3>
<p align="justify">
This source distribution is made freely available and there is no charge
for its use, provided you retain this notice, disclaimers, author's
copyright, and credits.
</p>
<a name="Disclaimer"></a>
<h3>Disclaimer</h3>
<p align="justify">
THIS SOFTWARE IS PROVIDE "AS IS" AND ANY EXPRESSED OR IMPLIED WARRANTIES,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO WAY SHALL THE
AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY,
OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
OF THE POSSIBILITY OF SUCH DAMAGE.
</p>
<h3>Support</h3>
<p>
Support is only provided for the author's original source distribution
found at <a href='http://www.snert.com/'>Snert . Com</a>.
Free support is limited, based on the
author's availability, though enhancements requests and problem reports
are welcome.
</p>
<p>
Monetary donation and/or <a href="http://www.amazon.com/">Amazon US</a>
wishlist gifts to the author are welcomed, but not required, for the continued
encouragment, moral support, and ego pumping needed to work in foriegn non-english
speaking lands.
</p>
<p>
There is now a mailing list for announcements, discussion, and community
support of my Apache modules:
</p>
<ul>
<li>
<a href="http://www.snert.com/Software/ecartis/index.php?go=/modules">The [modules] Archive</a>
</li>
<br>
<li>
If you want to <a href="javascript:modulesRequest('join')">join</a> the [modules] mailing list,
or be <a href="javascript:modulesRequest('remove')">removed</a>, or get the
<a href="javascript:modulesRequest('help')">help</a> file, then either click the
links above or send an email with one of the above mentioned words as either the subject
or body of the message to <nobr><modules-request at snert dot com></nobr>
</li>
<br>
<li>
To <a href="javascript:modules()">submit</a> a message to the mailing list,
just send an email to <nobr><modules at snert dot com></nobr>
</li>
</ul>
<br>
<p align="center">
- <a href="http://www.snert.com/">Welcome</a>
- <a href="http://www.snert.com/Software/index.html">Software</a>
-
</p>
<!-- copyright -->
<p class="copyright" style="text-align: center;">
<nobr>Copyright 2001, 2003 by
<a href="javascript:achowe()">
Anthony C Howe</a></nobr>
<nobr>All rights reserved.</nobr>
</p>
<!--end copyright-->
<p class="small" align="center">
<!--#include virtual="/WIL/counter.pl/Software/mod_loopback/version1.cnt" -->
grains of sand since 8 April 2001</font>
</p>
<!-- END PAGE BODY -->
</td>
</tr>
</table>
<!-- END MARGINS -->
</body>
</html>
