URLS.TXT(1)

CONFIGURATION FILE
urls.txt - URL database for regression testing

INTRODUCTION

The urls.txt file is installed by default in SIEGE_HOME/etc/urls.txt. When siege is invoked without the -u/--url option, then by default it looks for urls in that file. The advantage of using the urls.txt file is two-fold: One, it frees you of the process of retyping a url with every invocation. Two, it allows you to perform full site regression testing. When the urls.txt file is used, siege reads all the urls in that file into memory and runs through the list in one of two ways, sequentially or randomly. The default run is sequential from start to finish and back again until the --reps or the --time option has been satisfied. With the -i/--internet option selected, siege runs through the file randomly simulating the stress applied by a community of internet users.
The -f/--file option allows you to select a file other then the default urls.txt file.

EXAMPLE FILE
This is an exmple urls.txt file. Lines beginning with a hash (#) are comments and ignored by siege.
#
# Example urls.txt file
# URLs database for siege
#
http://www.haha.com/index.html
http://www.haha.com/howto/index.html
http://www.haha.com/cgi-bin/howto/display.cgi?1013
www.haha.com/cgi-bin/fm.cgi?first=j.&last=fulmer
https://www.haha.com/index.shtml
https://www.whoohoo.com/my_whoohoo.jsp
# POST data requires a POST directive
www.haha.com/cgi-bin/foo.cgi POST first=bart&last=simpson
www.haha.com/hoho.jsp POST name=jeff&pass=secret
# POST the contents of a file using the
# line input character "<"
http://www.haha.com/my.jsp POST </home/jeff/data.txt

AUTHOR
Jeffrey Fulmer <jdfulmer@armstrong.com>

BUGS
Report bugs to jdfulmer@armstrong.com. Give a detailed description of the problem and report the version of siege that you are using.

COPYRIGHT
Copyright © 2000 2001 Jeffrey Fulmer

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any lat er version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied
 warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more det ails. You should have received a copy of the GNU General Public License along with this program; if not, write to the Fr ee Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

AVAILABILITY
The most recent released version of siege is available by anonymous FTP from sid.joedog.org in the directory pub/siege.

SEE ALSO
siege(1) siege.config(1) layingsiege(1)