WireForge

A pure Rust network packet processing library — a complete replacement for libpnet.

Architecture

wireforge-io        (Cross-platform raw socket I/O)
    └── wireforge-packet  (Packet enum, protocol dispatch)
        └── wireforge-core   (Zerocopy parsers, builders, types, checksums)

wireforge-app       (DNS, DHCP, NTP, HTTP, pcap I/O)
    └── wireforge-packet

Quick Start

cargo add wireforge-core wireforge-packet wireforge-io wireforge-app

// Parse an Ethernet frame
use wireforge_core::ether::EthernetPacket;
let eth = EthernetPacket::new(&frame_bytes).unwrap();
println!("EtherType: {:?}", eth.ethertype());

// Build a DNS query
use wireforge_app::dns::builder::DnsPacketBuilder;
use wireforge_app::dns::types::{DnsType, DnsClass};
let query = DnsPacketBuilder::query()
    .add_question("example.com", DnsType::A, DnsClass::IN)
    .build();

// Capture packets (cross-platform)
use wireforge_io::{DefaultL2Reader, traits::L2Reader};
let mut rx = DefaultL2Reader::new("eth0")?;
let eth = rx.recv()?;

Protocol Coverage

Platform Support

Migrating from libpnet

WireForge is a drop-in replacement for libpnet. See the Migration Guide for detailed API comparison and code examples.

Community

• Contributing Guide
• Security Policy
• Changelog

License

MIT