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.