pktkit 0.1.3

Zero-copy L2/L3 packet handling toolkit. Frames, packets, hubs, adapters, NAT, virtual TCP/IP, WireGuard, OpenVPN, QEMU networking, TUN/TAP, AF_XDP — all gated behind opt-in cargo features.
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
40
41
42
43
44
45
46
47
48
49
50
51
52

//! Stub for platforms without `AF_PACKET`.
//!
//! The type exists so that code naming it still compiles; every operation
//! reports `Unsupported`.

use super::Config;
use crate::{Frame, L2Device, L2Handler, MacAddr, Result};
use std::io;
use std::sync::Arc;

/// An `AF_PACKET` socket. Not available on this platform.
#[derive(Debug)]
pub struct Socket(());

impl Socket {
    /// Always fails with [`io::ErrorKind::Unsupported`] off Linux.
    pub fn open(_cfg: Config) -> Result<Arc<Socket>> {
        Err(io::Error::new(
            io::ErrorKind::Unsupported,
            "AF_PACKET sockets are Linux-only",
        ))
    }

    /// The interface this socket is bound to.
    pub fn interface(&self) -> &str {
        ""
    }

    /// The interface MTU.
    pub fn mtu(&self) -> usize {
        0
    }
}

impl L2Device for Socket {
    fn set_handler(&self, _h: L2Handler) {}

    fn send(&self, _frame: &Frame) -> Result<()> {
        Err(io::Error::new(
            io::ErrorKind::Unsupported,
            "AF_PACKET sockets are Linux-only",
        ))
    }

    fn hw_addr(&self) -> MacAddr {
        MacAddr::zero()
    }

    fn close(&self) -> Result<()> {
        Ok(())
    }
}