Struct MulticastEtherFace 

pub struct MulticastEtherFace { /* private fields */ }

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

Joins the NDN multicast group on the specified interface so that frames sent to NDN_ETHER_MCAST_MAC are received. Outgoing packets are always sent to the multicast address.

Suitable for L2 neighbor discovery and local-subnet NDN communication without IP. Mirrors MulticastUdpFace but at the link layer.

Requires CAP_NET_RAW or root. Linux only.

Implementations

impl MulticastEtherFace

pub fn new(id: FaceId, iface: impl Into<String>) -> Result<Self>

Create a new multicast Ethernet face on iface.

Opens an AF_PACKET + SOCK_DGRAM socket, joins the NDN multicast group (01:00:5e:00:17:aa), and sets up TPACKET_V2 ring buffers.

pub fn iface(&self) -> &str

Interface name this face is bound to.

pub async fn recv_with_source(&self) -> Result<(Bytes, MacAddr), FaceError>

Receive the next NDN packet along with the sender’s MAC address.

This is the discovery-layer variant of Face::recv. The source MAC is extracted from the TPACKET_V2 sockaddr_ll embedded in each ring frame — no extra syscall is needed. Discovery protocols use this to identify which peer sent a Hello packet and create a unicast face for it.

Trait Implementations

impl Face for MulticastEtherFace

fn id(&self) -> FaceId

fn kind(&self) -> FaceKind

fn link_type(&self) -> LinkType

Link type of this face.

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.

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

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

async fn recv_with_addr(&self) -> Result<(Bytes, Option<FaceAddr>), FaceError>

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

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

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