Nmap/Parser version 0.80
============================

nmap output parser in perl

This perl module is here to ease the pain of developing scripts or collecting
network information from nmap scans. Nmap::Parser does its task by parsing the
information in the output of an nmap scan by using the xml-formatted output.
An nmap parser for xml scan data using perl. Nmap Parser is a PERL module that
makes developing security and audit tools using nmap and perl easier.

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://www.nmapparser.com
                http://npx.sourceforge.net

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

   tar zxvf 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.16+
	Storable

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

Changes from 0.78 to 0.80
	- Support for multiple instances of Nmap::Parser objects without overwriting data
	- All data (except filters) is are localized per object
	- The use of Storable (dclone) to correctly make duplicate of data structured
	- When filters are used to skip portinfo, all ports return state of 'closed'.
	- Nmap::Parser::XML no longer supported in distribution
		(you should change all calls to Nmap::Parser::XML to Nmap::Parser)
	- fixed ports that were declared as 'open|filtered'
	    these now are counted as both 'open' and 'filtered'
	    when using tcp_ports() and udp_ports().
	- sent a patch for XML::Twig in order to fix. It is now released in
	    XML:Twig 3.16
	- added start_str() and time_str() : they return the human readable format
	of the scan start time and scan finish time (respectively).
	- updated for Nmap 3.81
	- documentation changes

FOR OTHER CHANGE INFORMATION SEE THE "CHANGES" FILE

COPYRIGHT AND LICENCE

Copyright (C) 2003-2005 Anthony G Persaud <ironstar@iastate.edu> <http://www.anthonypersaud.com>

 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.

