INSTALLATION

perl Makefile.PL
make
make test
make install

NOTE: This module relies on XML::SAX for parsing the XML output of

       nmap; it will use any XML::SAX conformant parser installed on
       a system as it uses XML::SAX::ParserFactory.  Please see the 
       documentation for XML::SAX for the rules on what parser the parser 
       factory will choose to use.  XML::SAX always comes with at least
       one implementation of an XML::SAX compliant parser, XML::SAX::PurePerl.
       For better speed, install a C-glue code SAX:XML module like 
       XML::LibXML::SAX.

DOCUMENTATION

If you want to view the docs post installation, do

perldoc Nmap::Scanner

then

perldoc Nmap::Scanner::Scanner

to start.

If you want to look pre-install, cd to lib first.

SYNOPSIS

Nmap::Scanner perlifies the output of the network mapping tool nmap (http://www.insecure.org/nmap/), creating lists of model objects in batch scan mode or firing events when significant scanning events occur in event scan mode.

If you do not have nmap installed on your system, you will need to install it before you can use this module (or only use scan_from_file(), which reads nmap-generated XML files). Please make sure to use a version of nmap that is newer than 3.50 if possible, as the XML DTD for nmap changed several times prior to 3.50. Using a version prior to 3.50 may work but no guarantees.

PROJECT INFORMATION

Home page: http://nmap-scanner.sourceforge.net/

If you are interested in making suggestions, reporting bugs, etc, please join the nmap-scanner mailing list at

https://lists.sourceforge.net/lists/listinfo/nmap-scanner-general

or use the Sourceforge "Help" or "Open Discussion" forums:

http://sourceforge.net/forum/?group_id=101546

If you are interested in contributing, join the mailing list or post to the "Developers" forum:

http://sourceforge.net/forum/forum.php?forum_id=351428

Please feel free to email me with nmap-scanner related questions, comments, and criticisms (mailing list postings preferred). All feedback is welcomed.

I hope you find this project useful,
Max

maxschube@cpan.org