Struct NamedEtherFace 

pub struct NamedEtherFace {
    pub node_name: Name,
    pub radio: RadioFaceMetadata,
    /* private fields */
}

NDN face over raw Ethernet (AF_PACKET / Ethertype 0x8624).

Uses SOCK_DGRAM with a TPACKET_V2 mmap’d ring buffer for zero-copy packet I/O. The kernel strips/builds the Ethernet header automatically: recv() returns the NDN TLV payload directly; send() accepts the NDN TLV payload and the kernel prepends the Ethernet frame header.

The MAC address is an internal implementation detail — above the face layer everything is NDN names. The node name is stable across channel switches and radio changes; only the internal MAC binding needs updating on mobility.

Requires CAP_NET_RAW or root.

Fields

node_name: Name

NDN node name of the remote peer.

radio: RadioFaceMetadata

Radio metadata for multi-radio strategies.

Implementations

impl NamedEtherFace

pub fn new( id: FaceId, node_name: Name, peer_mac: MacAddr, iface: impl Into<String>, radio: RadioFaceMetadata, ) -> Result<Self>

Create a new Ethernet face bound to iface.

Opens an AF_PACKET + SOCK_DGRAM socket, configures a TPACKET_V2 mmap ring buffer, binds to the given network interface, and registers the socket with the tokio reactor. Requires CAP_NET_RAW.

pub fn set_peer_mac(&mut self, mac: MacAddr)

Update the peer MAC address (e.g. after a mobility event).

pub fn peer_mac(&self) -> MacAddr

Current peer MAC address.

pub fn iface(&self) -> &str

Interface name this face is bound to.

Trait Implementations

impl Face for NamedEtherFace

fn id(&self) -> FaceId

fn kind(&self) -> FaceKind

async fn recv(&self) -> Result<Bytes, FaceError>

Receive the next packet. Blocks until a packet arrives or the face closes.

async fn send(&self, pkt: Bytes) -> Result<(), FaceError>

Send a packet. Must not block the caller; use internal buffering.

fn remote_uri(&self) -> Option<String>

Remote URI (e.g. udp4://192.168.1.1:6363). Returns None for face types that don’t have a meaningful remote endpoint.

fn local_uri(&self) -> Option<String>

Local URI (e.g. unix:///run/nfd/nfd.sock). Returns None for face types that don’t expose local binding info.

fn recv_with_addr( &self, ) -> impl Future<Output = Result<(Bytes, Option<FaceAddr>), FaceError>> + Send

Receive the next packet together with the link-layer sender address.

fn link_type(&self) -> LinkType

Link type of this face.