URLS.TXT(5)							File Formats Manual						       URLS.TXT(5)

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, sequen-
       tially or randomly. The default run is sequential from start to finish and back again until the --reps or the --time option has been satis-
       fied.   With the -i/--internet option selected, siege runs through the file randomly simulating the stress applied by a community of inter-
       net 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 (C) 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 MER-
       CHANTABILITY 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)

Siege v2.70							   April-17-2012						       URLS.TXT(5)