Struct PacketSocket 

pub struct PacketSocket { /* private fields */ }

Wrapper around an AF_PACKET SOCK_DGRAM file descriptor.

Owns the fd and closes it on drop. Provides synchronous send/recv methods used by the async wrappers via AsyncFd.

Implementations

impl PacketSocket

pub fn open(interface: &str, ethertype: u16) -> Result<Self, TransportError>

Create and bind an AF_PACKET SOCK_DGRAM socket.

Returns an error with a clear message if CAP_NET_RAW is missing.

pub fn if_index(&self) -> i32

Get the interface index.

pub fn local_mac(&self) -> Result<[u8; 6], TransportError>

Get the local MAC address of the bound interface.

pub fn interface_mtu(&self) -> Result<u16, TransportError>

Get the interface MTU.

pub fn set_recv_buffer_size(&self, size: usize) -> Result<(), TransportError>

Set the socket receive buffer size.

pub fn set_send_buffer_size(&self, size: usize) -> Result<(), TransportError>

Set the socket send buffer size.

pub fn send_to(&self, data: &[u8], dest_mac: &[u8; 6]) -> Result<usize>

Send a payload to a destination MAC address.

Returns the number of bytes sent, or an io::Error.

pub fn recv_from(&self, buf: &mut [u8]) -> Result<(usize, [u8; 6])>

Receive a payload and source MAC address.

Returns (bytes_read, source_mac), or an io::Error.

impl PacketSocket

pub fn into_async(self) -> Result<AsyncPacketSocket, TransportError>

Wrap this socket in an async wrapper for tokio integration.

Trait Implementations

impl AsRawFd for PacketSocket

fn as_raw_fd(&self) -> RawFd

Extracts the raw file descriptor.

impl Drop for PacketSocket

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.