rustscanr 0.1.0

🦀 rustscanr: A simple async TCP port scanner
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75

# rustscanr

[![Crates.io](https://img.shields.io/crates/v/rustscanr.svg)](https://crates.io/crates/rustscanr)
[![Docs.rs](https://docs.rs/rustscanr/badge.svg)](https://docs.rs/rustscanr)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![CI](https://github.com/bvdwalt/rustscanr/actions/workflows/ci.yml/badge.svg)](https://github.com/yourusername/rustscanr/actions/workflows/ci.yml)
[![Release](https://github.com/bvdwalt/rustscanr/actions/workflows/release.yml/badge.svg)](https://github.com/bvdwalt/rustscanr/actions/workflows/release.yml)

---

`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

```sh
cargo install rustscanr
```

Or clone and build manually:

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

## Usage

```sh
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:
```sh
rustscanr example.com
```

Scan a specific port range with custom concurrency:
```sh
rustscanr 192.168.1.10 -s 80 -e 8080 -c 200
```

Scan with custom timeout:
```sh
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.