Provided by: siege_2.70-1build1_amd64 bug

NAME

       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 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)