netring 0.29.0

High-performance zero-copy packet I/O for Linux (AF_PACKET TPACKET_V3 + AF_XDP)
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

//! Basic packet capture example.
//!
//! Usage: cargo run --example capture -- [interface]
//! Requires CAP_NET_RAW.

use netring::Capture;

fn main() -> Result<(), netring::Error> {
    env_logger::init();

    let iface = std::env::args().nth(1).unwrap_or_else(|| "lo".into());
    eprintln!("Capturing on {iface}... (Ctrl-C to stop)");

    let mut cap = Capture::builder()
        .interface(&iface)
        .promiscuous(true)
        .ignore_outgoing(true)
        .build()?;

    {
        let mut pkts = cap.packets();
        let mut seen = 0;
        while seen < 100 {
            let Some(pkt) = pkts.next_packet() else { break };
            println!(
                "[{}.{:09}] {} bytes (wire: {})",
                pkt.timestamp().sec,
                pkt.timestamp().nsec,
                pkt.len(),
                pkt.original_len(),
            );
            seen += 1;
        }
    }

    let stats = cap.stats()?;
    eprintln!("{stats}");
    Ok(())
}