PingSweeper

A Python script that runs pings to determine how many hosts are up on a specified subnet. This script will also run a DNS lookup to find host names if they are available.

Installation

Script can be installed using pip install pingsweeper

Requirements

• Python - https://www.python.org

Note: the script will need to be in the PATH environment variable to work as demonstrated here

Usage

Running the script:

pingsweeper

To show available arguments:

pingsweeper -h

Example with all available arguments:

pingsweeper -s 192.168.1.0/24 -t 0.5 -c 3

• -s → Specifies the subnet in CIDR notation.
• -r → Prompt for a range instead of entire subnet.
• -t → Sets the timeout per ping (in seconds).
• -c → Specifies the number of packets to send per host.

Once the script completes, the console will print a summary including the number of hosts ping, hosts that responded, and the results of all the hosts that were UP. A text file with the results will be generated at sweep_results/ and opened (assuming the system has a GUI).

Upgrading

To upgrade to the latest version:

python -m pip install --upgrade pingsweeper

To install a specific version:

python pip install pingsweeper==0.1.1

Possible issues

There have been cases where the following warning may be shown after installing the package which will not allow you to run pingsweeper as intended. If this is the case, then the file path highlighted will need added to the system PATH environment variable.

License

This project is licensed under the MIT License - see the LICENSE file for details.