Struct RawSocketDriver 

pub struct RawSocketDriver { /* private fields */ }

A driver over a packet socket bound to a host interface, sending and receiving whole frames.

Ethernet interfaces carry Ethernet frames (Medium::Ethernet), wpan interfaces carry IEEE 802.15.4 frames (Medium::Ieee802154). Linux and Android only.

Implementations

impl RawSocketDriver

pub fn new( name: &str, hardware_addr: HardwareAddress, ) -> Result<RawSocketDriver>

Open a packet socket bound to the interface called name.

hardware_addr is the address the interface reports to the stack, and picks the medium: an Ethernet address for an Ethernet interface, an IEEE 802.15.4 one for a wpan interface. It must match the address the host interface is configured with.

This requires superuser privileges or a corresponding capability bit set on the executable.

Errors:

• the OS error if the socket cannot be opened or bound, or the interface does not exist.
• Unsupported for HardwareAddress::Ip, and for an IEEE 802.15.4 address that is not an extended address.

Trait Implementations

impl AsRawFd for RawSocketDriver

fn as_raw_fd(&self) -> RawFd

Extracts the raw file descriptor.

impl Debug for RawSocketDriver

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Driver for RawSocketDriver

fn capabilities(&self) -> Capabilities

Get a description of the device’s capabilities.

fn hardware_address(&self) -> HardwareAddress

Get the device’s hardware address.

fn receive(&mut self) -> Option<PacketBuf>

Poll for a received frame.

fn transmit(&mut self, buf: PacketBuf) -> Result<(), PacketBuf>

Queue a frame for transmission, transferring ownership of the buffer to the driver.

fn can_transmit(&mut self) -> bool

Whether the device can transmit one frame right now.

fn link_state(&mut self) -> LinkState

Get the link state.

fn poll_tx_timestamp(&mut self) -> Option<TxTimestamp>

Poll for the timestamp of an already-transmitted packet.

impl Drop for RawSocketDriver

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.