rustscanr

Crates.iorustscanr
lib.rsrustscanr
version0.1.0
created_at2025-09-25 16:25:38.355867+00
updated_at2025-09-25 16:25:38.355867+00
description🦀 rustscanr: A simple async TCP port scanner
homepage
repositoryhttps://github.com/bvdwalt/rustscanr
max_upload_size
id1854826
size29,258
Barend van der Walt (bvdwalt)

documentation

README

rustscanr

Crates.io Docs.rs License: MIT CI Release


rustscanr is a simple async TCP port scanner written in Rust. It is designed to quickly scan port ranges on target hosts, providing fast and efficient network reconnaissance.

Features

  • Blazing fast asynchronous TCP scanning
  • Customizable port ranges and concurrency
  • Configurable connection timeout
  • Easy to use CLI interface

Installation

cargo install rustscanr

Or clone and build manually:

git clone https://github.com/yourusername/rustscanr.git
cd rustscanr
cargo build --release

Usage

rustscanr <HOST>

Arguments

  • <HOST> - Hostname or IP to scan (e.g. example.com or 192.168.1.10)

Options

  • -s, --start <START> - Start port (inclusive) [default: 1]
  • -e, --end <END> - End port (inclusive) [default: 1024]
  • -c, --concurrency <CONCURRENCY> - Concurrency: how many ports to check in parallel [default: 100]
  • -t, --timeout-ms <TIMEOUT_MS> - Timeout per connection attempt in milliseconds [default: 300]
  • -h, --help - Print help

Examples

Scan default port range (1-1024) on a host:

rustscanr example.com

Scan a specific port range with custom concurrency:

rustscanr 192.168.1.10 -s 80 -e 8080 -c 200

Scan with custom timeout:

rustscanr example.com -s 1 -e 65535 -t 500

Contributing

Contributions are welcome! Please open issues or pull requests.

License

This project is licensed under the MIT License.

Commit count: 10

cargo fmt