Struct MulticastUdpFace 

pub struct MulticastUdpFace { /* private fields */ }

NDN face over IPv4 link-local multicast.

Interests sent on this face reach all NDN-capable nodes on the local link without requiring prior knowledge of their addresses. Data is returned via unicast UdpFace to the specific responder.

Typical usage

1. Start MulticastUdpFace at boot for neighbor discovery and prefix announcements.
2. On receiving a multicast Interest, create a unicast UdpFace back to the responder’s source address and register it in the FIB.
3. Subsequent traffic uses the unicast face; the multicast face handles only discovery and control traffic.

Implementations

impl MulticastUdpFace

pub async fn new( iface: Ipv4Addr, port: u16, group: Ipv4Addr, id: FaceId, ) -> Result<Self>

Bind to port, join group on interface iface. Use NDN_MULTICAST_V4 and NDN_PORT for standard NDN.

pub async fn ndn_default(iface: Ipv4Addr, id: FaceId) -> Result<Self>

Standard NDN multicast (224.0.23.170:6363) on iface.

pub fn with_socket(id: FaceId, socket: UdpSocket, dest: SocketAddr) -> Self

Wrap a pre-configured socket. The caller is responsible for binding and joining the multicast group. Useful when SO_REUSEADDR is needed.

pub fn ad_hoc(self) -> Self

Set link type to AdHoc for Wi-Fi IBSS / MANET deployments.

Ad-hoc link type signals to forwarding strategies that not all nodes on the link hear every multicast frame, so multi-access Interest suppression should be disabled.

pub fn dest(&self) -> SocketAddr

impl MulticastUdpFace

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

Receive the next NDN packet along with the UDP source address.

Used by the discovery layer to learn the sender’s address and create a unicast reply face — without requiring the sender to embed their address in the Interest payload.

Trait Implementations

impl Face for MulticastUdpFace

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

Receive the next NDN packet from any sender on the multicast group.

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

Receive packet and expose the UDP source address to the discovery layer.

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

Broadcast an NDN packet to the multicast group.

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.