NetStumbler::Stumbler For Linux

NetStumbler::Stumbler is a Perl module to parse netstumbler data.

use NetStumbler::Stumbler;  my $lin = NetStumbler::Stumbler->new();  $lin->isSummary($file);  $lin->isNS1($file);  $lin->parseNS1($file);

This class has several methods to parse NetStumbler data file TODO: add Kismet and iStumbler support

new()

Returns a new Stumbler object.

parseNSSummaryLine($line)

Params: -string A line from a summary file Returns: an array of seperated values corresponding to output of a NetStumbler summary export **NOTE** Conversion of the verbose GPS data to doubles in standard GPS format Blank SSID will be set to "Hidden" The time data will have GMT stripped off If the line is not correctly formed return an empty list Example: my @line = $obj->parseNSSummaryLine($line); print "Line [@line] ";

isSummary($file)

Params: -string fully qualified filename Returns: true if the file is in NetStumbler Summary format Example: if($obj->isSummary($file)) { # do something here }

isNS1($file)

Params: -string fully qualified filename Returns: true if the file is in NetStumbler NS1 file Example: if($obj->isNS1($file)) { # do something here }

isKismetCSV($file)

Params: -string fully qualified filename Returns: true if the file is in Kismet CSV file Example: if($obj->isKismetCSV($file)) { # do something here }

parseKismetCSV($file)

Params: -string fully qualified filename Returns: list of lists each item in the sublist corresponds to a list from kismet summary file Example: $ref = $obj->parseKismetCSV($file); # The list is as follows 0 Network 1 NetType 2 ESSID 3 BSSID 4 Info 5 Channel 6 Cloaked 7 WEP 8 Decrypted 9 MaxRate 10 MaxSeenRate 11 Beacon 12 LLC 13 Data 14 Crypt 15 Weak 16 Total 17 Carrier 18 Encoding 19 FirstTime 20 LastTime 21 BestQuality 22 BestSignal 23 BestNoise 24 GPSMinLat 25 GPSMinLon 26 GPSMinAlt 27 GPSMinSpd 28 GPSMaxLat 29 GPSMaxLon 30 GPSMaxAlt 31 GPSMaxSpd 32 GPSBestLat 33 GPSBestLon 34 GPSBestAlt 35 DataSize 36 IPType 37 IP #

parseNS1($file)

Params: -string fully qualified filename Returns: list of lists each item in the sublist corresponds to a list from parseNSSummary Example: $ref = $obj->parseNS1($file);

readAPInfo($fileHandle,$fileVersion)

Params: reference - Filehandle reference number - NS1 Version Returns: list - smae format as parseNSSummary

readAPData($fileHandle,$fileVersion)

Params: reference - Filehandle reference number - NS1 Version Returns: nothing TODO: Add a return value to this method to build graphs

readGPSData($fileHandle)

Params: reference - Filehandle reference Returns: nothing TODO: Add a return value to this method to build graphs

readint64($fileHandle)

Params: reference - Filehandle reference Returns: a 64bit number

readDouble($fileHandle)

Params: reference - Filehandle reference Returns: a double

readint32($fileHandle)

Params: reference - Filehandle reference Returns: a 32bit number

readUint32($fileHandle)

Params: reference - Filehandle reference Returns: an unsigned 32bit number

readUint8($fileHandle)

Params: reference - Filehandle reference Returns: an unsigned 8bit number

readChars($fileHandle,$length)

Params: reference - Filehandle reference length - number of bytes to read Returns: a string

ensurePos($fileHandle,$prePosition,$postPosition,$amountNeeded)

This method was aadded due to an odd behavior with Perl5.8 read would sometimes put the file pointer 1 byte beyond where it was supposed to be. This method fixes that issue Params: reference - Filehandle reference number - Pre read position of the file number - Post position of the file number - Correct amount to data that was supposed to be read