python-nmap 0.7.1

From python/ipython:

>>> import nmap>>> nm = nmap.PortScanner()>>> nm.scan('127.0.0.1', '22-443')>>> nm.command_line()'nmap -oX - -p 22-443 -sV 127.0.0.1'>>> nm.scaninfo(){'tcp': {'services': '22-443', 'method': 'connect'}}>>> nm.all_hosts()['127.0.0.1']>>> nm['127.0.0.1'].hostname()'localhost'>>> nm['127.0.0.1'].state()'up'>>> nm['127.0.0.1'].all_protocols()['tcp']>>> nm['127.0.0.1']['tcp'].keys()[80, 25, 443, 22, 111]>>> nm['127.0.0.1'].has_tcp(22)True>>> nm['127.0.0.1'].has_tcp(23)False>>> nm['127.0.0.1']['tcp'][22]{'state': 'open', 'reason': 'syn-ack', 'name': 'ssh'}>>> nm['127.0.0.1'].tcp(22){'state': 'open', 'reason': 'syn-ack', 'name': 'ssh'}>>> nm['127.0.0.1']['tcp'][22]['state']'open'>>> 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']))----------------------------------------------------Host : 127.0.0.1 (localhost)State : up----------Protocol : tcpport : 22 state : openport : 25 state : openport : 80 state : openport : 111 state : openport : 443 state : open

To export to a file

>>> print(nm.csv())host;protocol;port;name;state;product;extrainfo;reason;version;conf127.0.0.1;tcp;22;ssh;open;OpenSSH;protocol 2.0;syn-ack;5.9p1 Debian 5ubuntu1;10127.0.0.1;tcp;25;smtp;open;Exim smtpd;;syn-ack;4.76;10127.0.0.1;tcp;53;domain;open;dnsmasq;;syn-ack;2.59;10127.0.0.1;tcp;80;http;open;Apache httpd;(Ubuntu);syn-ack;2.2.22;10127.0.0.1;tcp;111;rpcbind;open;;;syn-ack;;10127.0.0.1;tcp;139;netbios-ssn;open;Samba smbd;workgroup: WORKGROUP;syn-ack;3.X;10127.0.0.1;tcp;443;;open;;;syn-ack;;

To check the network status

>>> nm.scan(hosts='192.168.1.0/24', arguments='-n -sP -PE -PA21,23,80,3389')>>> hosts_list = [(x, nm[x]['status']['state']) for x in nm.all_hosts()]>>> for host, status in hosts_list:>>> print('{0}:{1}'.host)192.168.1.0:down192.168.1.1:up192.168.1.10:down192.168.1.100:down192.168.1.101:down192.168.1.102:down192.168.1.103:down192.168.1.104:down192.168.1.105:down[...]

Using a Scanner Async

>>> nma = nmap.PortScannerAsync()>>> def callback_result(host, scan_result):>>> print '------------------'>>> print host, scan_result>>>>>> nma.scan(hosts='192.168.1.0/30', arguments='-sP', callback=callback_result)>>> while nma.still_scanning():>>> print("Waiting >>>")>>> nma.wait(2) # you can do whatever you want but I choose to wait after the end of the scan>>>192.168.1.1 {'nmap': {'scanstats': {'uphosts': '1', 'timestr': 'Mon Jun 7 11:31:11 2010', 'downhosts': '0', 'totalhosts': '1', 'elapsed': '0.43'}, 'scaninfo': {}, 'command_line': 'nmap -oX - -sP 192.168.1.1'}, 'scan': {'192.168.1.1': {'status': {'state': 'up', 'reason': 'arp-response'}, 'hostname': 'neufbox'}}}------------------192.168.1.2 {'nmap': {'scanstats': {'uphosts': '0', 'timestr': 'Mon Jun 7 11:31:11 2010', 'downhosts': '1', 'totalhosts': '1', 'elapsed': '0.29'}, 'scaninfo': {}, 'command_line': 'nmap -oX - -sP 192.168.1.2'}, 'scan': {'192.168.1.2': {'status': {'state': 'down', 'reason': 'no-response'}, 'hostname': ''}}}------------------192.168.1.3 {'nmap': {'scanstats': {'uphosts': '0', 'timestr': 'Mon Jun 7 11:31:11 2010', 'downhosts': '1', 'totalhosts': '1', 'elapsed': '0.29'}, 'scaninfo': {}, 'command_line': 'nmap -oX - -sP 192.168.1.3'}, 'scan': {'192.168.1.3': {'status': {'state': 'down', 'reason': 'no-response'}, 'hostname': ''}}}>>> nm = nmap.PortScannerYield() >>> for progressive_result in nm.scan('127.0.0.1/24', '22-25'): >>> print(progressive_result)

See also example.py in archive file.

Using a Scanner Async

>>> nm = nmap.PortScanner()>>> nm.scan('127.0.0.1', '22-40043', timeout=10)PortScannerTimeout: 'Timeout from nmap process'

2021年10月26日 (v0.7.1)

• Fix setup.cfg

• Fix build tools

2020年03月02日 (v0.7.0)

• Add black and flake8 for development

• Drop support for python2.7

2020年02月28日 (v0.6.4)

• Add timeout parameter and PortScannerTimeout exception

2018年09月23日 (v0.6.3)

• Refactor Readme and changelog files for the Pypi pattern and applying styles to the blocks for better visualization

• Change setup.py to use an explicit version of python, since asynchronous tasks are not available for python 2.x

• Add clean method to the Makefile

• Update Manifest file

• Update version and Fix PEP8 on nmap/nmap.py

2017年01月07日 (v0.6.2)

2016年07月29日 (v0.6.1)

• Fix bug #22 UnboundLocalError in scan_progressive

• Fix bug #23 Scanning fails on nmap warnings

• Fix bug #20: Fix for empty <hostnames> values which results in blank CSV output

• Fix bug #18: print(nm.csv()) does not return any results

• Fix bug #19: nmap program was not found in path

• Fix bug #17: hostname is no longer reported

2016年03月15日 (v0.6.0)

• Add information about Nmap special licence

• Licence precision for distributing python-nmap along with nmap

2016年03月15日 (v0.5.2)

• add hostname to csv export

2015年12月05日 (v0.5.0-1)

• updating example.py

2015年11月18日 (v0.5.0)

• Closes bugs : - #11 Display only one osclass/osmatch instead of multiple

• Change in data structure : - osmatch is a list of osclass - osclass is a list of dictionnary - added cpe which is a list of string - added portused which is a list of dictionnary

  Data structure for a host looks like :

{'addresses': {'ipv4': '127.0.0.1'}, 'hostnames': [], 'osmatch': [{'accuracy': '98', 'line': '36241', 'name': 'Juniper SA4000 SSL VPN gateway (IVE OS 7.0)', 'osclass': [{'accuracy': '98', 'cpe': ['cpe:/h:juniper:sa4000', 'cpe:/o:juniper:ive_os:7'], 'osfamily': 'IVE OS', 'osgen': '7.X', 'type': 'firewall', 'vendor': 'Juniper'}]}, {'accuracy': '91', 'line': '17374', 'name': 'Citrix Access Gateway VPN gateway', 'osclass': [{'accuracy': '91', 'cpe': [], 'osfamily': 'embedded', 'osgen': None, 'type': 'proxy server', 'vendor': 'Citrix'}]}], 'portused': [{'portid': '443', 'proto': 'tcp', 'state': 'open'}, {'portid': '113', 'proto': 'tcp', 'state': 'closed'}], 'status': {'reason': 'syn-ack', 'state': 'up'}, 'tcp': {113: {'conf': '3', 'cpe': '', 'extrainfo': '', 'name': 'ident', 'product': '', 'reason': 'conn-refused', 'state': 'closed', 'version': ''}, 443: {'conf': '10', 'cpe': '', 'extrainfo': '', 'name': 'http', 'product': 'Juniper SA2000 or SA4000 VPN gateway http config', 'reason': 'syn-ack', 'state': 'open', 'version': ''}}, 'vendor': {}}

2015年11月17日 (v0.4.7)

• Closes bugs: - #10 Error when trying to parse ‘osclass’ , ‘osmatch’ removed addresses, hostnames, status, vendor, osclass, uptime, osmatch from all_protocols()

• Changed shebang line from python3 to python as it works with python2

2015年11月13日 (v0.4.6)

• Closes bugs : - #10 Error when trying to parse ‘osclass’ , ‘osmatch’

2015年10月25日 (v0.4.5)

• Closes bugs : - #9 Can not pass ports with unicode string at scan function

2015年10月17日 (v0.4.4)

• Closes bugs : - #8 IPv6 Async scanner doesn’t work

2015年09月11日 (v0.4.3)

• Change in url for __get_last_online_version

2015年09月11日 (v0.4.2)

• Closes bugs : - #7: Error with empty hostname - #6: Windows support of close_fds if you redirect stdin/stdout/stderr

2015年08月21日 (v0.4.1)

• Closes bugs : - #5: only one hostname stored per host

• Add hostnames() method which return the list of hostnames as a list of dict [{‘name’:’hostname1’, ‘type’:’PTR’}, {‘name’:’hostname2’, ‘type’:’user’}]

2015年08月01日 (v0.4.0)

• Closes bugs : - #2: use close_fds in subprocess.Popen - #3: memory leak parsing xml using xml.dom.minidom

• Corrects a bug in parsing osclass

• Add nosetests for case testing

• Removed test case in docstring

2015年05月08日 (v0.3.7)

• adding sudo parameter for scanning (idea from scupython)

2015年05月08日 (v0.3.6)

• correcting issue 7 : Issues under windows

2015年05月08日 (v0.3.5)

• correcting a bug in all_protocols()

• correcting issue 8 : PortScannerAsync Doesn’t work in windows...

2014年06月22日 (v0.3.4)

• adding PortScannerYield class with generator >>> nm = nmap.PortScannerYield() >>> for i in nm.scan(‘127.0.0.1/24’, ‘22-25’): >>> print(i)

2014年03月13日 (v0.3.3)

• moving file example.py

• adding function convert_nmap_output_to_encoding

• adding vendor for mac address

2013年09月23日 (v0.3.2)

• adding acces to CPE values under [host][proto][port][‘cpe’] key

2013年07月27日 (v0.3.1)

• Bug correction on callback’s assert in PortScannerAsync.scan proposed by Robert Bost

2013年06月23日 (v0.3.0)

• added support for NMAP SCRIPT ENGINE

>>> r=nm.scan(hosts='127.0.0.1', ports='139', arguments="-sC ")>>> print(nm._scan_result['scan']['127.0.0.1']['hostscript'])

2013年02月24日 (v0.2.7)

• added an address block in host scan result which contains ipv4, mac and other addresses :

nm = nmap.PortScanner()r = nm.scan(arguments='-sS -p T:22', hosts='192.168.1.3')print r['scan']['192.168.1.3']['addresses']{u'mac': u'02:50:43:F4:02:B1', u'ipv4': u'192.168.1.3'}- Adding a CSV scan output as a string.- Changes examples.py to make it python3 compliant

2012年12月13日 (v0.2.6)

• patch from lundberg.johan

• bug correction : when nmap doesn’t work displays stderr instead of stdout

2012年11月23日 (v0.2.5)

• corrected : Issue 2: "map.nmap.PortScannerError: ‘nmap program was not found in path’" on CentOS

• corrected : Issue 3: nmap.scan() short-circuits prematurely

2011年11月09日 (v0.2.4)

• implemented a request from Santhosh Edukulla <santhosh.edukulla@gmail.com> : parse OS scanning output

• Error with multiple host specifications : bug and patch from old.schepperhand@gmail.com

2011年11月04日

• bug in example.py : if no tcp port was open between 22-443

2010年12月17日 (v0.2.3)

• adding __get_last_online_version to check if current version is the last published

2010年12月17日 (v0.2.2)

• bug in handling nmap_error output (returned value was bin, string was expected)

• removed test strings form __init__.py file.

2010年12月15日 (v0.2.1)

• corrected bug in __init__.py about scope problem

• try to find nmap executable in known directories

• raise AssertionError when trying to call command_line, scaninfo, scanstats, has_host before scanning

2010年12月14日 (v0.2.0)

• Make python-nmap works with Python 3.x

• Contribution from Brian Bustin <brian at bustin.us>

2010年06月07日 (v0.1.4)

• Patches from Steve ‘Ashcrow’ Milner <steve at gnulinux.net>

• remove shebang from __init__.py as it is not a runnable script

• allow use with ALPHA and BETA nmap releases

• .has_key() is deprecated, replaced instances with in

• move to using the print function for python2 and 3 usage

2010年06月04日

• adding PortScanner.listscan

• PortScanner.scan now returns scan_result

• adding class PortScannerAsync (idea from Steve ‘Ashcrow’ Milner <steve at gnulinux.net>)

2010年06月03日

• Import on google code svn checkout https://python-nmap.googlecode.com/svn/trunk/ python-nmap –username XXXXX

• added PortScanner.scanstats method

• updated example.py and documentation for pingsweep

• updated Makefile for generating documentation

2010年03月09日

• Modified packaging. v0.1.1 [norman]

2010年03月08日

• Initial release. v0.1.0 [norman]