Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/h3xduck/RawTCP_Lib
A C library for creating and using TCP/IP packets with raw network sockets
https://github.com/h3xduck/RawTCP_Lib
Last synced: about 2 months ago
JSON representation
A C library for creating and using TCP/IP packets with raw network sockets
- Host: GitHub
- URL: https://github.com/h3xduck/RawTCP_Lib
- Owner: h3xduck
- License: mit
- Created: 2021-03-28T18:40:02.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2022-05-09T22:54:54.000Z (over 2 years ago)
- Last Synced: 2024-06-02T20:57:53.924Z (4 months ago)
- Language: C
- Homepage:
- Size: 8.1 MB
- Stars: 57
- Watchers: 6
- Forks: 10
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-embedded-software - RawTCP_Lib - C library for creating and using TCP/IP packets with raw network sockets. (Protocols / Network protocols)
README
```
██████╗ █████╗ ██╗ ██╗████████╗ ██████╗██████╗
██╔══██╗██╔══██╗██║ ██║╚══██╔══╝██╔════╝██╔══██╗
██████╔╝███████║██║ █╗ ██║ ██║ ██║ ██████╔╝
██╔══██╗██╔══██║██║███╗██║ ██║ ██║ ██╔═══╝
██║ ██║██║ ██║╚███╔███╔╝ ██║ ╚██████╗██║
╚═╝ ╚═╝╚═╝ ╚═╝ ╚══╝╚══╝ ╚═╝ ╚═════╝╚═╝
```
# RawTCP_Lib
RawTCP is a library to build custom TCP/IP packets from the ground and send/receive them using only raw sockets and the C language.
## Features
* Create custom TCP/IP packets with control over all their fields (including network flags).
* Automatically build packets' checksums, or request a recalculation manually.
* Send built packets over raw sockets.
* **NEW:** Sniff incoming packets to your device, and operate with them later.
## Use cases
You can have a look at my project [TCPcannon](https://github.com/h3xduck/TCPcannon) built on top of this library for an example!
* Send spoofed network packets (fake source IP/port).
* Build specific packets for network attacks (e.g SYN flooding).
* Monitor your device network traffic.
* Fast integration in your network application.
Note: RawTCP uses the AF_INET address family so it supports both customization of the Network Layer (IP) and the Transport Layer (TCP) headers. Support for the Link Layer will come in future updates.
## Installation
RawTCP is built as an static library to facilitate integration with your project.
1. [Download](https://github.com/h3xduck/RawTCP_Lib/releases/latest) RawTCP and put it in your project directory.
2. Integrate it in your project
* METHOD 1: With gcc compiler
```sh
gcc libRawTCP_Lib.a
```
* METHOD 2 With cmake
```cmake
target_link_libraries( ${CMAKE_CURRENT_SOURCE_DIR}/libRawTCP_Lib.a)
```
Note that you will need to specify the path to the library in both cases if you stored it under a project folder.
3. Import "RawTCP.h" from a source file whenever you need RawTCP.
## Examples
### Create a TCP/IP packet
```c
//Packet indicates source=192.168.1.10:8000, dest=192.168.1.20:8080
packet_t packet = build_standard_packet(8000, 8080, "192.168.1.10", "192.168.1.20", 4096, "MyMessage");
```
### Set TCP flag active
RawTCP uses [hexadecimal notation](https://synfinner.blog/tcp-flags-hex-values) for the TCP flags. Multiple flags can be set at the same time by adding their values.
```c
//Setting both SYN and FIN flags
set_TCP_flags(packet, 0x03);
```
RawTCP manages the recomputation of the checksums automatically.
### Sending packet to destination
```c
//Destination port and destination IP are those specified when creating the packet.
rawsocket_send(packet);
```
IMPORTANT: Raw sockets need root priviliges, so you will need them before you can run this specific function.
### Continously sending packets
```c
//Sequence number & checksum automatically updated by OS
packet_t packet = build_standard_packet(...)
while(1){
rawsocket_send(packet);
}
```
### Sniff incoming TCP packets
```c
//The packet can be used as if it was generated with build_standard_packet()
packet_t packet = rawsocket_sniff();
```
## Issues?
Whether it is a bug, question or suggestion, please [open a ticket](https://github.com/h3xduck/RawTCP_Lib/issues/new) and I will have a look at it as fast as I possibly can.
## LICENSE
This software is licensed under the MIT license. See [LICENSE](https://github.com/h3xduck/RawTCP_Lib/blob/master/LICENSE)