Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hoshigakikisame/hostprobe
Host Probe is a Python script that simplifies host discovery using ICMP ping. It enables users to determine the status of a list of IP addresses or domain names, helping identify hosts that are online (UP) or offline (DOWN).
https://github.com/hoshigakikisame/hostprobe
bugbounty cybersecurity prober
Last synced: about 1 month ago
JSON representation
Host Probe is a Python script that simplifies host discovery using ICMP ping. It enables users to determine the status of a list of IP addresses or domain names, helping identify hosts that are online (UP) or offline (DOWN).
- Host: GitHub
- URL: https://github.com/hoshigakikisame/hostprobe
- Owner: hoshigakikisame
- License: mit
- Created: 2023-09-09T03:45:15.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2023-09-09T03:47:47.000Z (over 1 year ago)
- Last Synced: 2024-11-10T09:17:58.735Z (3 months ago)
- Topics: bugbounty, cybersecurity, prober
- Language: Python
- Homepage:
- Size: 2.93 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Host Probe
Host Probe is a Python script that performs host discovery using ICMP ping. It allows you to determine which hosts are up and which are down from a list of IP addresses or domain names.
## Installation
You can use [pipenv](https://pipenv.pypa.io/en/latest/) to create a virtual environment and install the required dependencies. If you don't have pipenv installed, you can install it using pip:
```bash
pip install pipenv
```
Once pipenv is installed, navigate to the project directory and run:
```bash
pipenv install
```
This will create a virtual environment and install the required dependencies listed in the `Pipfile`.
## Usage
```bash
pipenv run python hostprobe.py [OPTIONS]
```
## Options
- `-f, --file FILE`: Input file containing a list of host IP addresses or domain names (one per line). (Required)
- `-r, --retry INT`: Number of ping retries for each host (default: 3).
- `-t, --timeout FLOAT`: Timeout (in seconds) for each ping request (default: 2.0).
- `-o, --output FILE`: Output file for results.
- `-v, --verbose:` Enable verbose output (real-time).
- `-s, --sleep FLOAT`: Sleep interval (in seconds) between probes (default: 0.0).
## Example
Perform host discovery using a host list file named `hostlist.txt`, save the results to `output.txt`, enable verbose (real-time) output, and add a 1-second sleep interval between probes:
```bash
pipenv run python hostprobe.py -f hostlist.txt -o output.txt -v -s 1.0
```
## Dependencies
- [ping3](https://pypi.org/project/ping3/): Python 3 ICMP ping implementation.
- [colorama](https://pypi.org/project/colorama/): Library for colored text output.