A SIEGE-FRIENDLY URL COLLECTOR

• Introduction
• Invocation
• Resource File and Configuration Settings
• Problems and Known Issues
• Platforms

Introduction 

Sproxy is an HTTP proxy server that collects URLs including GET and POST information in a “siege-friendly” manner. It was designed to ease the burden associated with the creation of a siege urls.txt file. To collect URLs for a siege, configure your browser to use the sproxy and surf the site. Every resource your browser requests will be saved as a “siege-friendly” URL. Sproxy is licensed under the GNU Public License.

Invocation 

The format for invoking sproxy is:
sproxy [options] [hostname]
(If a hostname is not specified, then sproxy will bind to localhost [127.0.0.1])

The program does support the following command line options:

‘ -V ‘
Print version information to the screen.

‘ -h ‘
Print the help section. This presents a summary of the options discussed in this section of the manual.

‘ -t NUM ‘
Timeout, set the sproxy connection timeout to NUMM (default 120)

‘ -p NUM ‘
Port, specify the port on which sproxy will listen for incoming connections (default 9001)

‘ -f FILE ‘
File, specify an alternative configuration file. (default $prefix/etc/sproxy.conf)

‘ -o FILE ‘
Output file, specify an alternative file to write URLs. (default $HOME/urls.txt)

Resource File and Configuration Settings 

Sproxy relies on both command line options and a configuration file for its run time configuration. Command line options take precedent over the configuration file. The default configuration file is $prefix/etc/sproxy.conf. As noted above, you can override this option with -f /path/to/file. Here is a sample configuration file:

#
# sproxy v1.02 configuration file
# DATE: January-03-2004
# for more information about this program, visit:
# http://www.joedog.org/

#
# this directive tells sproxy to bind to this
# host address. If no host directive is given, then
# sproxy will bind to localhost (127.0.0.1).
# To use sproxy, configure your browser to use
# this HTTP proxy address.
# example: host = ben
host = ben.joedog.org

#
# this directive tells sproxy to listen on this
# port number. The default is 9001. To use sproxy,
# configure your browser to use this HTTP proxy port.
# example: port = 8080
port = 1025

#
# this directive tells sproxy to write all its
# URLs to this alternative output file. The default
# file is $HOME/urls.txt You may also specify an
# alternative output file with the -o option on the
# command line.
# example: output = /home/jeff/haha.txt
output = /usr/local/src/urls.txt

#
# this directive tells sproxy to run in verbose
# mode in which all collected URLs are printed to
# screen. sproxy still writes all URLs to its
# output file. You may set this directive to true on
# the command line with the -v option. (default: false)
# example: verbose = true
#
verbose = true

#
# this directive sets the sproxy connection timeout
# in seconds. The default timeout is 120 seconds. You may
# also set this on the command line with the -t option.
# example: timeout = 30
# timeout = 90
timeout = 30

Problems and Known Issues 

This section of the manual has been deprecated, see the file KNOWNBUGS in your sproxy distribution OR read the FAQ, on this website.

Platforms 

Sproxy was written in perl and should run on any platform that supports perl 5. Required modules are included with the distribution. They are installed as needed.