
. Examples
 
	Following are some example uses of Warscan. They are not meant to 
indicate, imply, or suggest a user's behaviour; they are simply meant to 
demonstrate the various switches and functions Warscan has to offer.


Example 1: 

% warscan -d scan-1.2.3 -o servers-1.2.3 1.2.3

  . -d scan-1.2.3
	Tells Warscan to change to and run in the directory 'scan-1.2.3'.
	Warscan will attempt to make the directory if it does not exist.

  . -o servers-1.2.3 
	When done with the Verify phase, dump the verified hosts, one per
	line, to the file 'servers-1.2.3'. 

  . 1.2.3
	Generate a list of IPs for the Class C subnet 1.2.3. Warscan will see
	this as '1.2.3.%'. The '%' is a metacharacter that will be treated as
	a range from 1 to $IPLimit (set by the '-L' option).

  Effect: Warscan will run the script 'scan' (default) on the '1.2.3' subnet.


Example 2:

% warscan -p 1.2.3

  . -p
	Tells Warscan to do a Ping Scan only. This will parallel ping the
	hosts in the 1.2.3 subnet and tell you which ones are up (those that
	respond to ICMP_Echo packets).

  Effect: Find what hosts are up on a subnet.


Example 3:

% warscan -s air -A 139 -P 25 1.2.3

  . -s air
	Tells Warscan to use the script 'air'. The envariable '$PATH'
	will be searched, then the current directory.

  . -A 139 
	When dispatching the script, append '139' to the list of arguments to
	be passed to the script.

  . -P 25
	This assumes you have good, fast bandwidth. Parallel ping hosts 25 at a 
	time. More is generally better, but not always. If you don't have good
	bandwidth but want to increase the number of pings, it is recommended
	that '-t' be used to increase the ping timeout.

  Effect: Dispatch 'air $host 139' over the 1.2.3 subnet.


Example 4:

% warscan -s cry -B 1.2.3.4 -P 25 -t 3 -S 50 -f server.list 

  . -s cry
	Run the script called 'cry'.

  . -B 1.2.3.4
	Prepend '1.2.3.4' to the list of arguments to be passed to the script.

  . -P 25
	Again, assumes you have good, fast bandwidth. Ping hosts 25 at a time.

  . -t 3
	Raise the Ping Timeout to 3 seconds (from 2, the default). The higher 
	you go with '-P', the higher you should go with -t. The better your 
	bandwidth, the less you have to worry about this.

  . -S 50 
	Assumes you have a fast computer, so run 50 scans at a time (instead of
	25, the default). This is a dangerous thing to play with on relatively
	slow computers; you could potentially add 10.0-15.0 to your load if you
	go too high. 

  . -f server.list
	Read in server list from 'server.list'.

  Effect: Run 'cry 1.2.3.4 $host' 50 at a time, verifying 25 at a time, 
          across the list of servers contained in 'server.list'. 


Example 5:

% warscan -s burn -L 500 dial%.some-isp.com

  . -s burn
	Run the script 'burn'.

  . -L 500
	Set the IP upper limit to '500'.

  . 'dial%.some-isp.com'
	Generate hostnames 'dial1.some-isp.com' to 'dial500.some-isp.com'.

  Effect: Run 'burn $host' on the first 500 dynamic IPs.
