binger-udp

Cross-platform, batch-native UDP I/O with platform-optimal syscalls.

Send and receive tens of thousands of small UDP packets efficiently using a unified batch API. Under the hood it picks the best syscall available: sendmmsg/recvmmsg on Linux, sendmsg_x/recvmsg_x on macOS, WSASendMsg/WSARecvMsg on Windows, with a sendto/recvfrom fallback everywhere.

Why binger

Rust has no general-purpose, cross-platform batch UDP I/O library:

• quinn-udp — great but QUIC-specific, API not portable
• nix — has sendmmsg but complex API and history of zero-alloc UB
• socket2 — sendmmsg PR stalled for over a year
• fastudp / unix-udp-sock — unmaintained since 2022

binger fills the gap: a clean batch API that automatically selects the optimal platform backend.

Highlights

Platform backends

Quick start

use binger_udp::{BingerUdp, SendBatch, RecvBatch, Config};

#[tokio::main]
async fn main() -> std::io::Result<()> {
    let socket = BingerUdp::from_std(
        std::net::UdpSocket::bind("0.0.0.0:0")?,
        Config::default(),
    )?;

    // Batch-send 32 packets in a single syscall
    let mut send = SendBatch::<32>::new();
    for i in 0..32 {
        send.push(b"hello", "192.168.1.1:8080".parse().unwrap())?;
    }
    let sent = socket.send_batch(&mut send).await?;

    // Batch-receive up to 32 packets in a single syscall
    let mut recv = RecvBatch::<32>::new(2048);
    let n = socket.recv_batch(&mut recv).await?;
    for i in 0..n {
        println!("from {}: {} bytes", recv.addr(i), recv.data(i).len());
    }

    Ok(())
}

KCP integration

use binger_udp::BingerUdp;

// BingerUdp implements traits needed by KCP transports,
// enabling batch I/O for KCP sessions.

Installation

[dependencies]
binger-udp = "0.1"

Optional features:

[dependencies]
binger-udp = { version = "0.1", features = ["metrics", "gso", "gro", "pacing", "busy-poll", "timestamping", "pktinfo"] }

MSRV: Rust 1.75+ (edition 2021)

Use cases

Performance expectations

Documentation

• Architecture
• API design

Roadmap

License

MIT