Struct trust_dns_proto::multicast::MdnsStream

pub struct MdnsStream { /* private fields */ }

A UDP stream of DNS binary packets

Implementations

impl MdnsStream

pub fn new_ipv4( mdns_query_type: MdnsQueryType, packet_ttl: Option<u32>, ipv4_if: Option<Ipv4Addr> ) -> (Box<dyn Future<Output = Result<Self, Error>> + Send + Unpin>, BufDnsStreamHandle)

associates the socket to the well-known ipv4 multicast address

pub fn new_ipv6( mdns_query_type: MdnsQueryType, packet_ttl: Option<u32>, ipv6_if: Option<u32> ) -> (Box<dyn Future<Output = Result<Self, Error>> + Send + Unpin>, BufDnsStreamHandle)

associates the socket to the well-known ipv6 multicast address

pub fn multicast_addr(&self) -> SocketAddr

Returns the address of the multicast network in use

pub fn new( multicast_addr: SocketAddr, mdns_query_type: MdnsQueryType, packet_ttl: Option<u32>, ipv4_if: Option<Ipv4Addr>, ipv6_if: Option<u32> ) -> (Box<dyn Future<Output = Result<Self, Error>> + Send + Unpin>, BufDnsStreamHandle)

This method is available for specifying a custom Multicast address to use.

In general this operates nearly identically to UDP, except that it automatically joins the default multicast DNS addresses. See https://tools.ietf.org/html/rfc6762#section-5 for details.

When sending ipv6 multicast packets, the interface being used is required, this will panic if the interface is not specified for all MdnsQueryType except Passive (which does not allow sending data)

Arguments

• multicast_addr - address to use for multicast requests
• mdns_query_type - true if the querier using this socket will only perform standard DNS queries over multicast.
• ipv4_if - Address to bind to for sending multicast packets, defaults to 0.0.0.0 if not specified (not relevant for ipv6)
• ipv6_if - Interface index for the interface to be used when sending ipv6 packets.

Return

a tuple of a Future Stream which will handle sending and receiving messages, and a handle which can be used to send messages into the stream.

Trait Implementations

impl Stream for MdnsStream

type Item = Result<SerialMessage, Error>

Values yielded by the stream.

fn poll_next( self: Pin<&mut Self>, cx: &mut Context<'_> ) -> Poll<Option<Self::Item>>

Attempt to pull out the next value of this stream, registering the current task for wakeup if the value is not yet available, and returning None if the stream is exhausted.

fn size_hint(&self) -> (usize, Option<usize>)

Returns the bounds on the remaining length of the stream.