https://github.com/haroldadmin/pps
A parallel port scanner, not intended for real use
https://github.com/haroldadmin/pps
go golang networking
Last synced: 12 months ago
JSON representation
A parallel port scanner, not intended for real use
- Host: GitHub
- URL: https://github.com/haroldadmin/pps
- Owner: haroldadmin
- License: apache-2.0
- Created: 2020-03-16T07:28:03.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2022-01-03T19:01:24.000Z (over 4 years ago)
- Last Synced: 2025-01-13T15:13:59.479Z (over 1 year ago)
- Topics: go, golang, networking
- Language: Go
- Homepage:
- Size: 9.77 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Parallel Port Scanner
This is a simple port scanner written in Go to find open ports on a host. Ports are scanned parallelly.
## Installation
To get the tool, make sure you have Go installed on the your system, and can access the `go` command line too.
```bash
go get github.com/haroldadmin/pps
```
This will install Parallel Port Scanner in your Path, and you should be able to access it directly.
## Usage
Run the `pps` command with the `hostname` argument.
```bash
pps --hostname 192.168.1.2
--------------------
Parallel Port Scanner
Scanning 192.168.1.2 with 1000 goroutines
Open: Port 53
--------------------
```
Only ports 1-1000 are scanned on the host.
Optionally, you can also control the parallelism of the tool with the `parallelism` argument.
```bash
pps --hostname 192.168.1.2 --parallelism 4
--------------------
Parallel Port Scanner
Scanning 192.168.1.2 with 4 goroutines
Open: Port 53
--------------------
```
The default timeout duration for a port connection attempt is 1 second. It can be configured with the `timeout` argument.
```bash
pps --hostname 192.168.1.2 --parallelism 1 --timeout 10
--------------------
Parallel Port Scanner
Scanning 192.168.1.2 with 1 goroutines
Open: Port 53
--------------------
```
## Disclaimer
If it wasn't clear from the name of the tool already (*PPs*), this project meant solely as a fun learning experience. *I do not recommend using it as a tool in your network-utilities belt.*