Enum hickory_proto::multicast::MdnsQueryType

pub enum MdnsQueryType {
    OneShot,
    Continuous,
    OneShotJoin,
    Passive,
}

Available on crate feature mdns only.

See rfc6762 details on these different types.

Variants

OneShot

The querier using this socket will only perform standard DNS queries over multicast. (clients only)

Effectively treats mDNS as essentially no different than any other DNS query; one request followed by one response. Only one UDP socket will be created.

Continuous

The querier is fully compliant with rfc6762. (servers, clients)

mDNS capable clients will sent messages with many queries, and they will expect many responses. Two UDP sockets will be created, one for receiving multicast traffic, the other used for sending queries and direct responses. This requires port 5353 to be available on the system (many modern OSes already have mDNSResponders running taking this port).

OneShotJoin

The querier operates under the OneShot semantics, but also joins the multicast group. (non-compliant servers, clients)

This is not defined in the mDNS RFC, but allows for a multicast client to join the group, receiving all multicast network traffic. This is useful where listening for all mDNS traffic is of interest, but because another mDNS process may have already taken the known port, 5353. Query responses will come from and to the standard UDP socket with a random port, multicast traffic will come from the multicast socket. This will create two sockets.

Passive

The querier operates under the OneShot semantics, but also joins the multicast group. (servers)

Not defined in the RFC, allows for a passive listener to receive all mDNS traffic.

Implementations

impl MdnsQueryType

pub fn sender(self) -> bool

This will be sending packets, i.e. a standard UDP socket will be created

pub fn bind_on_5353(self) -> bool

Returns true if this process can bind to *:5353

pub fn join_multicast(self) -> bool

Returns true if this mDNS client should join, listen, on the multicast address

Trait Implementations

impl Clone for MdnsQueryType

fn clone(&self) -> MdnsQueryType

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for MdnsQueryType

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

Formats the value using the given formatter.

impl PartialEq for MdnsQueryType

fn eq(&self, other: &MdnsQueryType) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for MdnsQueryType

impl Eq for MdnsQueryType

impl StructuralPartialEq for MdnsQueryType