NAME

NetworkInfo::Discovery::Nmap - NetworkInfo::Discovery extension using Nmap

VERSION

Version 0.02

SYNOPSIS

    use NetworkInfo::Discovery::Nmap;

    my $scanner = NetworkInfo::Discovery::Nmap->new(
        hosts => [ qw( 192.168.0.0/24 192.168.1.0/24 ) ], 
    );
    $scanner->do_it;

See eg/nmapdisc.pl for a more complete example.

DESCRIPTION

This module is an extension to NetworkInfo::Discovery which uses the Nmap utility to scan networks, find active hosts, their services and operating system.

METHODS

new()

Creates and returns a new NetworkInfo::Discovery::Nmap object, which derives from NetworkInfo::Discovery::Detect.

Options

  • hosts - expects a scalar or an arrayref of IP addresses in CIDR notation

  • ports - expects a scalar or an arrayref with a port or a ports range

  • guess_system - when enabled, tells nmap to use TCP/IP fingerprinting to guess remote operating system (note: root privileges required). Default is 0 (disabled).

Example

    # specify one host
    my $scanner = new NetworkInfo::Discovery::Nmap hosts => '192.168.0.0/24';
    
    # specify several hosts
    my $scanner = new NetworkInfo::Discovery::Nmap hosts => [ qw(192.168.0.0/24) ];
do_it()

Run the scan.

hosts()

Add hosts or networks to the scan list. Expects addresses in CIDR notation. Return the current list of hosts when called with no argument.

Examples

    $scanner->hosts('192.168.4.53');     # add one host
    $scanner->hosts('192.168.5.48/29');  # add a subnet
    $scanner->hosts(qw(192.168.6.0/30 10.0.0.3/28));  # add two subnets
ports()

Add ports to the scan list. Expects single ports (e.g. '8080') or ports ranges (e.g. '1-123'). Return the current list of ports when called with no argument.

Examples

    $scanner->ports('8080');     # add one port
    $scanner->ports('1-123');    # add a ports range
    $scanner->ports(qw(137-139 201-208));  # add two ports ranges
guess_system()

When enabled, tells nmap to use TCP/IP fingerprinting to guess remote operating system (note: root privileges required). Default is 0 (disabled).

SEE ALSO

NetworkInfo::Discovery, Nmap::Scanner

AUTHOR

Sébastien Aperghis-Tramoni, <sebastien@aperghis.net>

BUGS

Please report any bugs or feature requests to bug-networkinfo-discovery-nmap@rt.cpan.org, or through the web interface at https://rt.cpan.org/NoAuth/ReportBug.html?Queue=NetworkInfo-Discovery-Nmap. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

COPYRIGHT & LICENSE

Copyright 2004 Sébastien Aperghis-Tramoni, All Rights Reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.