This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

Simple python script which uses pcap, arp-scan, and avahi to:

  1. Find hosts that are on the LAN passively
  2. Uses an arp-ping to actively identify hosts
  3. Scan each host to determine open ports and services
  4. Store record of hosts in JSON file, html webpage, or prints to screen

Note: Since IP addresses change, the hosts are finger printed via their MAC address.

Note: On linux it uses avahi to get hostnames, but doesn’t work on OSX

Alternatives

Fing is a great and fast network scanner, I have their app on my iPad. However, the fing commandline tool for RPi I have noticed errors in the MAC address and therefor don’t trust it for this application.

Install

Pre-requisites:

brew install pcap arp-scan

or

sudo apt-get install libpcap-dev arp-scan

Download and unzip, then from inside the package:

sudo python setup.py install

If you are working on it:

sudo python setup.py develop

Run Active

To see all run time options:

netscan --help

Basic, to search for addresses on your network, use:

sudo netscan -a -r 5000 -i en1
-i, --interface
 interface to listen to, ex. en0, en1
-r, --range what ports to scan (1 … n), where n in this case is 5000 (upper limit)

The default is to display results to the screen.

Note: This has to be run as root

Run Passive

sudo netscan -p 1000 -j network.json -i en1
-p, --passive conduct passive mode, scan 1000 packets and output results
-j, --json output results to a json file

Run Active/Passive

sudo netscan -a -p 1000 -w network.html -i en1
-w, --webpage output to webpage name network.html

Make HTML from a JSON file

html5 network.json

JSON files can be hard to read (one long string), this puts it into an easier form to digest.

To Do

  • remove arp-scan and code directly in python
  • add ability to feed a earlier json scan into program and wol to bring up sleeping hosts
  • better documentation
  • add a verbose argument, sometimes it seems like nothing is happening
  • currently not using awake, netaddr, or commands … need to fix

Web Server

This is designed to work with Node.js netscan but that is still work in progress.

Release History

Release History

2.1.2

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

2.1.1

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

2.1.0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
netscan-2.1.2.tar.gz (13.9 kB) Copy SHA256 Checksum SHA256 Source Aug 23, 2015

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting