NAME¶
urls.txt - URL database for regression testing
INTRODUCTION¶
The urls.txt file is installed by default in /etc/siege/urls.txt. When siege is
invoked without a command line reference to a URL, 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 free retyping a url with every invocation. And two, it
allows you to conduct 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. You may also instruct siege to use a different file with the
"file" directive in .siegerc, i.e., "file =
/usr/local/etc/urls.txt"
You may set and reference variables inside the urls.txt file. All variables must
be declared BEFORE they are referenced. Variables are declared with the
"=" operator, VARIABLE = VALUE. They are then referenced inside $()
or ${}, example: $(HOST), ${HOST}
HOST=joey.joedog.org
http://${HOST}/browse.jsp?size=5
http://${HOST}/admin.jsp?name=ralph
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 <jeff@joedog.org>, et al.
BUGS¶
Report bugs to jeff@joedog.org. Give a detailed description of the problem and
report the version of siege that you are using.
COPYRIGHT¶
Copyright © 2007 Jeffrey Fulmer, et al.
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 later
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 details.
You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc., 675 Mass
Ave, Cambridge, MA 02139, USA.
AVAILABILITY¶
The most recent released version of siege is available by anonymous FTP from
ftp.joedog.org in the directory pub/siege.
SEE ALSO¶
siege(1) siege.config(1) layingsiege(7)