Readme.txt for userhunt.pl

Author: Wiseman (wiseman@spray.se)
Filename: userhunt.pl
Current Version: 1.01
Created: 24th of November 2000
Last Changed: 5th of April 2001
-------------------------------------------------------------------------
Description:
------------------------------------------------------------------------
userhunt.pl scans a IP-range and displays IP-address, machine names
and logged in users. Optionally userhunt can search for a specific user
and show on which machine the user is logged in.

------------------------------------------------------------------------
Syntax:
------------------------------------------------------------------------

userhunt.pl -i <IP-range> [-p <Pattern to search for> -all <match both host and username with pattern>]

Mandatory switches:
-------------------
 -i <IP-range of target subnets>

Example: -i 10.10.1-3.0

This would scan the subnets
10.10.1.0, 10.10.2.0 and 10.10.3.0

Optional switches:
------------------
- p <Pattern to search for>

Example: -p admin

This would locate all users logged in as
Admin, Administrator etc.

-all <match both host and username with pattern>

------------------------------------------------------------------------
Change History
------------------------------------------------------------------------
1.01: Minor bug fixed
Found a minor bug that generated a uninitizlied value error.
This is now fixed.

1.0: Code cleanup and minor bug fixed
Found a minor bug that caused the -all switch not to work as intended
This is now fixed.

0.9: Changed from FSCAN and NBTSTAT to NBTSCAN
Changed the script from using Foundstones FSCAN and NBTSTAT to use the
much faster NBTSCAN.
NBTSCAN does not support multiple subnets and searching for specific
users but this script does. (That's why I wrote it in the first place :-))

0.5: Original version
Original version depended on Foundstones FSCAN and NBTSTAT which made
it quite slow but I didn't have to worry about IP-ranges.
I do now...

 ------------------------------------------------------------------------
 The Usual Disclaimer:
 ------------------------------------------------------------------------
 This script is written AS-IS and will not be supported
 Wiseman is not responsible for the script's misuse and is not responsible
 for any damage resulting from running this script.
 It is *not* my fault so stop complaining

 ------------------------------------------------------------------------
 Feedback:
 ------------------------------------------------------------------------
 Send all feedback to wiseman@spray.se
 All nasty letters will be sent to /dev/null and if I can track you down
 I may come over with my bouncer friends and a baseball bat. You have been
 warned... :-)




