Ubuntu Manpage: urls.txt - URL database for regression testing

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.