Known Bugs

SourceForge.net Logo

[Create scripts that use nmap with perl]

By Max Schubert a.k.a. "perldork"


Revision history:


   - XML scan now uses open3, helps produce more informative error
     output when nmap produces an error message.
   - Added Nmap::Scanner::Task class to model taskbegin and taskend
     XML elements.
   - Added Nmap::Scanner::TaskProgress class to model taskbegin and taskend
     XML elements.
   - Added Nmap::Scanner::Distance class for host->distance.
   - Added register_task_started and register_task_ended event
     handlers to allow calling programs to be immediately notified
     when taskbegin and taskend elements appear in the XML output.
   - Added register_task_progress handler to allow calling programs 
     to be immediately notified when taskprogress elements appear
     in XML (good for GUIs).


    - scan_from_file() can now use LWP to retrieve files using
      HTTP GET, i.e. http://nmap-scanner.sf.net/scan-test.xml
    - Changed model classes to use Class::Generate to make
      development and changing of model classes easier
    - RPC scan option was broken, fixed now.
    - Documentation clean up
    - Examples updated and cleaned up
    - run-examples.sh driver added to run all examples from one
      spot (makes regression testing of the module easier)
    - Noted in documentation that ident scan is now deprecated

    - Added Nmap::Scanner::RunStats::Finished class
    - Added vendor to Nmap::Scanner::Address class
    - Added startstr to Nmap::Scanner::NmapRun class
    - Added tunnel to Nmap::Scanner::Service class
    - Documentation updates / edits

    David Blank-Edelman (dnb ~at~ pobox -.- com)
    - XML.pm will now use any XML::SAX parser available on a host,
      not just XML::SAX::PurePerl.
    - Documentation correction for Nmap::Scanner, where I incorrectly
      stated that a port is identified by nmap only when that port
      is found to be open.  If the port is explicitly passed to -P,
      nmap will report it's state regardless of whether it is
      open or not.

0.8 - Added port_found call to port() routine as 
      was removed from nmap version 3.75
   - Updated README file with correct information
   - Updated tests so tests that require nmap binary get
     skipped (instead of failing) if nmap binary not found
   - Updated version in lib/Nmap/Scanner.pm to .7


   Will Saxon (WillS --at-- housing dot ufl DOT edu)
   - Uninitialized value bug in XML.pm, PORT_COUNT attribute.

   Mario Manno (mm AT koeln dot ccc . de)
   - Many XML fixes to make Nmap::Scanner XML output comply with nmap DTD
   - Code suggestion to separate method that reads nmap scan
     from file out of main scan() method.
   - Added Nmap::Scanner::OS::Class for use with nmap OS guess output
     to account for multiple OS class guesses that may be generated
     by using -O switch.
   - Patched source to deal with 'defined but false' values for XML
     output where class atributes have not been populated.
   - Contributed example program that will perform an nmap scan and
     generate graphs and charts showing the results of the scan
     (see examples/bannerscan/ directory).
   - Fix all nmap class names and attributes so they match the names
     nmap uses in it's XML output.
   - Alter examples to use new attribute / method names

   Max Schubert
   - Code clean up after applying patches from Mario.
   - Perldoc for new methods added by Mario, clean up of some
     existing perldoc.
   - Clean up of die() calls in scan_from_file method to make
     sure messages are clear to user.
   - Added code to handle  child of  element and multiple 
      elements, along with Hostname class.
   - Added stub hostnames and ports routines to Nmap::Scanner::Backend::XML 
     so that running in debug mode does not show unhandled XML warnings.
   - Corrected smurf routine mapping so that smurf XML element calls
     smurf() routine (instead of hostname()) in Nmap::Scanner::Backend::XML.
   - Changed XML for error output so there are two lines; one is nmap output
     error string, the other is perl error ($@) as eval{} will catch perl
     runtime errors too.
   - Altered examples/osguess.pl to work with new module/class names.
   - Add code to handle multiple OS guess ports (Bug 906269)
   - Alter examples to use new attribute / method names
   - Alter tests to use new attribute / method names

    - Set up mailing list and fixed link to it in README file .. thanks to
          Andrew Thornton (ThorntonA /AT/ nv -dot- doe -dot- gov for pointing
                        out the bad URL in the file.
    - David Klann grunch _AHT_ klann daw-T cx -- patch to 
      Nmap/Scanner/Scanner.pm to properly anchor nmap binary search in
      _find_nmap routine.
    - Jon Amundsen (jamundsen - at - jamundsen dot dydns -dot- org).  
        * Fix for path with spaces and Win32 (cygwin) nmap search in PATH by 
          Jon Amundsen
    - Anthony Persaud (Anthony_Persaud -at- cargill dot com)
        * Tell users defaults are being used and what they are for example 
        * Return $self for object chaining where possible in 
        * Make add_* methods and delete* methods take arrays of args.
        * Add open_nmap() method to Nmap::Scanner::Scanner to allow user to just
          use Nmap::Scanner::Scanner as front end option processor .. this 
          method returns the pid of the newly opened nmap process, and the 
          reader, writer, and error filehandle attached to the nmap pipe; 
          uses IPC::Open3.
    - Add support for -sV switch:
        * version_scan() switch in Nmap::Scanner::Scanner
        * Add mutators for version, product, and extrainfo to 
    - Jasmin Lvesque (jlevesque -At- crosemont.qc _DOT_ ca)
        * Add support for parsing/outputting smurf detection.
    - Change process() method of Nmap::Scanner::Backend::Processor to 
      start_nmap().  This method just opens a pipe to nmap; it returns the 
      pid, reader, writer and error filehandles to the caller.  Caller is 
      responsible for processing errors from nmap.  I changed this so that 
      the backend-processor could produce an error message in the appropriate 
    - Changed to using the XML output format from nmap.
    - Changed object model to match the XML output.
    - Added scan($options) so that users don't have to learn MY method names
      just to use the module set.
    - Added more examples.
    - Eliminated all "normal" output processors and the Factory sub-package, as
      it is not needed anymore.
    - Eliminated Protocol and ProtocolList models as XML output defines 
      protocols as ports of type IP.
    - Changed tests to ONLY use tcp connect scans so we don't have install 
      problems for non-root users (reported to me by the CPAN testers .. 
    - Eliminated all Nmap::Scanner::Util modules except BannerScanner .. 
      moved others into examples/ as they really aren't core.
0.01  -- February, 2002
	- First attempt at upload and release.