SCOUT(1)

PROGRAM NAME
scout - surveys a webserver and prepares the urls.txt file for a siege.

INTRODUCTION

ALERT: if you are not familiar with siege, then read the man page siege(1) before you read this document. When siege is invoked for regression testing, it reads a list of URLs into memory and runs through them either sequentially (default) or randomly (siege -i/--internet). By default that file is called urls.txt and it is installed in PREFIX/etc. Scout provides a simple means of adding URLs to that file. It follows the links on a webserver and appends them to urls.txt. This process works completely independently of siege. It is not necessary to scout a server before laying siege. You may add URLs to urls.txt by any means possible. Scout is there to make life easier.

INVOCATION
The format for invoking scout is: scout options... Scout supports the following command line options:

-V, --version
    VERSION, prints the version number

-h, --help
    HELP, prints the help section which includes a summary of all the command line options.

-f FILE, --file=FILE
    FILE, the default URL file is PREFIX/etc/urls.txt. To write the links to a different file, use this option, i.e., scout -f myurls.txt That example creates a file in your current working directory called "myurls.txt" Scout will fill that file with links.

-n, --new
    NEW, this option creates a new urls.txt file. This option causes scout to overwrite an existing file with a new one. The -n/--new option can be used with the -f/--file option described above.

-p, --pictures
    PICS, include image files in the output file.

AUTHOR
Jeffrey Fulmer <jdfulmer@armstrong.com>

BUGS
Report bugs to jdfulmer@armstrong.com. Give a detailed description of the problem and report the version of scout that you are using.

COPYRIGHT
Copyright © 2000 2001 Jeffrey Fulmer

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 lat er 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 det ails. You should have received a copy of the GNU General Public License along with this program; if not, write to the Fr ee Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

AVAILABILITY
The most recent released version of scout is available in the siege distribution via anonymous ftp from ftp.armstrong.com in the directory pub/siege.

SEE ALSO
siege(1) layingsiege(1) urls_txt(1)