Metadata-Version: 1.0
Name: python-nmap
Version: 0.1.1
Summary: This is a python class to use nmap and access scan results from python
Home-page: http://xael.org/norman/python/python-nmap/
Author: Alexandre Norman
Author-email: norman@xael.org
License: gpl-3.0.txt
Description: ===========
        python-nmap
        ===========
        
        python-nmap is a python library which helps in using nmap port scanner.
        It allows to easilly manipulate nmap scan results and will be a perfect
        tool for systems administrators who want to automatize scanning task
        and reports. It also supports nmap script outputs.
        
        Typical usage looks like::
        
        #!/usr/bin/env python
        import nmap                         # import nmap.py module
        nm = nmap.PortScanner()         # instantiate nmap.PortScanner object
        nm.scan('127.0.0.1', '22-443')      # scan host 127.0.0.1, ports from 22 to 443
        nm.command_line()                   # get command line used for the scan : nmap -oX - -p 22-443 127.0.0.1
        nm.scaninfo()                       # get nmap scan informations {'tcp': {'services': '22-443', 'method': 'connect'}}
        nm.all_hosts()                      # get all hosts that were scanned
        nm['127.0.0.1'].hostname()          # get hostname for host 127.0.0.1
        nm['127.0.0.1'].state()             # get state of host 127.0.0.1 (up|down|unknown|skipped)
        nm['127.0.0.1'].all_protocols()     # get all scanned protocols ['tcp', 'udp'] in (ip|tcp|udp|sctp)
        nm['127.0.0.1']['tcp'].keys()       # get all ports for tcp protocol
        nm['127.0.0.1'].all_tcp()           # get all ports for tcp protocol (sorted version)
        nm['127.0.0.1'].all_udp()           # get all ports for udp protocol (sorted version)
        nm['127.0.0.1'].all_ip()            # get all ports for ip protocol (sorted version)
        nm['127.0.0.1'].all_sctp()          # get all ports for sctp protocol (sorted version)
        nm['127.0.0.1'].has_tcp(22)         # is there any information for port 22/tcp on host 127.0.0.1
        nm['127.0.0.1']['tcp'][22]          # get infos about port 22 in tcp on host 127.0.0.1
        nm['127.0.0.1'].tcp(22)             # get infos about port 22 in tcp on host 127.0.0.1
        nm['127.0.0.1']['tcp'][22]['state'] # get state of port 22/tcp on host 127.0.0.1 (open
        
        
        # a more usefull example :
        for host in nm.all_hosts():
        print '----------------------------------------------------'
        print 'Host : %s (%s)' % (host, nm[host].hostname())
        print 'State : %s' % nm[host].state()
        
        for proto in nm[host].all_protocols():
        print '----------'
        print 'Protocol : %s' % proto
        
        lport = nm[host][proto].keys()
        lport.sort()
        for port in lport:
        print 'port : %s\tstate : %s' % (port, nm[host][proto][port]['state'])
        
        
        
        Homepage
        ========
        
        http://xael.org/norman/python/python-nmap/
        
        
Keywords: nmap,portscanner,network,sysadmin
Platform: UNKNOWN
