Beware of the Dog | Sproxy / ReadMe

SPROXY README
by Jeffrey Fulmer
May 2006

What Is It?
Why Do I Need It?
Where Is It?
Installation
License Information

Sproxy is the [S]iege[proxy], a tool designed to harvest URLs to a urls.txt for the Siege http/https regression tester. Sproxy is designed to work like a regular http proxy. It listens for http requests on port 9001 (default) and it returns requested content to the web browser while it writes the URL along with any GET requests and/or POST data to a file for Siege.

Why Do I Need It?

For starters, if you don't use Siege, then you probably don't need this application. But if you want to construct a file of URLs associated with a particular website, or if you want to build 'urls.txt' files for Siege, then Sproxy is for you. It will collect all URLs requested by a browser and write them to an ASCII text file along with associated POST data and GET requests. URLs with POST data are constructed in a Siege 'friendly' format.

Where Is It?

The latest version of sproxy can be obtained via anonymous FTP:
ftp://sid.joedog.org/pub/sproxy/sproxy-latest.tar.gz And the latest beta version is available here:
ftp://sid.joedog.org/pub/sproxy/beta/sproxy-beta.tar.gz

If a beta version is not available, then the latter file will be linked to the former.

Installation

Although sproxy is written in perl, it is configured, built and installed with GNU/autotools. All necessary perl modules are included in the distribution. The configure script will determine which ones need to be installed. Joe Dog feels that software should be finished. The user should not be asked to chase down components in order to run an application. To build sproxy:
./configure --prefix=/home/jeff
make
make install

License Information

Consult the file COPYING for complete license information.

Permission is granted to anyone to make or distribute verbatim copies of this document as received, in any medium, provided that the copyright notice and this permission notice are preserved, thus giving the recipient permission to redistribute in turn. Permission is granted to distribute modified versions of this document, or of portions of it, under the above conditions, provided also that they carry prominent notices stating who last changed them.