Nmap/Parser version 0.75
============================

nmap output parser in perl

This module is intended to sift through the nmap scan outputs in xml form,
either by passing a filehandle that is being piped from a current nmap scan
or using an xml filename that is formatted as the output of nmap when using
the '-oX file.xml' command line option. It uses the XML::Twig library, which is
memory efficient and fast. In the authors opinion, this module is very easy to
use to extract information from an nmap xml scan output about the scan itself
and the hosts that were scanned.

I am trying to balance efficiency with ease of use. If you think something
can be done differently send your feedback.

INSTALLATION

Latest version: http://sourceforge.net/projects/npx
		http://search.cpan.org/~apersaud/Nmap-Parser/
Website:        http://npx.sourceforge.net/

Download the file and unpack. This is usually done by:

   tar xvf Nmap-Parser-x.xx.tar.gz

Where x.xx is the version number. Next change into the newly created directory.
To install this module type the following:

   perl Makefile.PL
   make
   make test
   make install

DEPENDENCIES

This module requires these other modules and libraries:

	XML::Twig 3.09+

In addition, you will need nmap 3.00+. You don't exactly need it, but this
version of nmap supports the xml output that this module can parse. So, you do
not really need the executable, but the xml output that you will be parsing
(or able to parse), must be from this version onward.

CHANGES

IMPORTANT: If you wish to upgrade your old Nmap::Parser::XML scripts, just
change the 'use' statement to call Nmap::Parser instead of Nmap::Parser::XML.

Changes from 0.71 to 0.75
	- new core module Nmap::Parser
	- deprecated: Nmap::Parser::XML
	- fixed ip address input bug
	- updated example scripts
	- fixed nmap not found bug
	- updated authorship informatin
	- raised verbose level to 2 in example scripts (help pages)
	- test script 4_scanner does not test. If nmap not installed
		it skips all tests.
	- updated tests
	- some example scripts read IP addresses from file
	- placed sourceforge image link on documentation
	- status_check is now called sweep
	- sweep.pl outputs active IP's to a file with a new command line switch
	- scan_host.pl is renamed to scanhost.pl
	- get_host_list,filter_by_osfamily, filter_by_status returns IP
		addresses in sorted IP order. ( uses sort_ips() )
- sort_ips is a new function which will take a series of IPs and sort
		them correctly by comparing each quad in the address to each
		other.
	- example scripts use --randomize_hosts to be more stealthy
	- updated information on some example scripts because they require
		nmap 3.50+ for the version scanning.
	- updated parser tests, to check for sorted ip order
	- removed safe_* functions and placed them in the actual parsing
	functions. (I don't think they were never used.
	- updated BUG REPORT information
	- removed IGNORE_ADDPORTS constant
	- added contribution from Sebastian: nmap2csv.
	- edited the links to the sourceforge project site.
	- added parsescan() function to peroform quick nmap scans
	and parsing.
	- added more documentation
	- fixed some example scripts
	- added more tests for the new functionality

FOR OTHER CHANGE INFORMATION SEE THE "CHANGES" FILE

COPYRIGHT AND LICENCE

Copyright (C) 2004 Anthony G Persaud <ironstar@iastate.edu>

 http://www.opensource.org/licenses/gpl-license.php

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 MERCHANTABILITY or FITNESS FOR  A
PARTICULAR PURPOSE. See the GNU General Public License for more details.

