Skip to content

A C library for creating and using TCP/IP packets with raw network sockets

License

Notifications You must be signed in to change notification settings

h3xduck/RawTCP_Lib

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

38 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

██████╗  █████╗ ██╗    ██╗████████╗ ██████╗██████╗ 
██╔══██╗██╔══██╗██║    ██║╚══██╔══╝██╔════╝██╔══██╗
██████╔╝███████║██║ █╗ ██║   ██║   ██║     ██████╔╝
██╔══██╗██╔══██║██║███╗██║   ██║   ██║     ██╔═══╝ 
██║  ██║██║  ██║╚███╔███╔╝   ██║   ╚██████╗██║     
╚═╝  ╚═╝╚═╝  ╚═╝ ╚══╝╚══╝    ╚═╝    ╚═════╝╚═╝     
                                                   

GitHub release (latest by date) Maintainability GitHub code size in bytes GitHub last commit

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 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 RawTCP and put it in your project directory.

  2. Integrate it in your project

    • METHOD 1: With gcc compiler
    gcc <your-files> libRawTCP_Lib.a
    • METHOD 2 With cmake
    target_link_libraries(<your-target> ${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

//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 for the TCP flags. Multiple flags can be set at the same time by adding their values.

//Setting both SYN and FIN flags
set_TCP_flags(packet, 0x03);

RawTCP manages the recomputation of the checksums automatically.

Sending packet to destination

//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

//Sequence number & checksum automatically updated by OS
packet_t packet = build_standard_packet(...)
while(1){
    rawsocket_send(packet);
}

Sniff incoming TCP packets

//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 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

About

A C library for creating and using TCP/IP packets with raw network sockets

Resources

License

Stars

Watchers

Forks