Struct ServerOptions 

pub struct ServerOptions { /* private fields */ }

Build-time configuration for an mDNS Endpoint.

The defaults bind on one interface for both IPv4 and IPv6: the first up + multicast-capable, non-loopback interface reported by getifs::interfaces that has a usable address for each enabled family, falling back to the loopback interface if no other is eligible. Use Self::with_interface_index to pin a specific interface.

Implementations

impl ServerOptions

pub fn new() -> Self

Build a new options bundle with defaults.

pub const fn ipv4(&self) -> bool

Whether IPv4 is enabled.

pub const fn ipv6(&self) -> bool

Whether IPv6 is enabled.

pub const fn interface_index(&self) -> Option<u32>

The pinned interface index, if any.

pub const fn max_payload_size(&self) -> usize

Maximum outgoing-packet buffer size. RFC 6762 §17 recommends staying within the path MTU on send (~1500 bytes for Ethernet).

pub const fn max_recv_packet_size(&self) -> usize

Maximum size of an inbound mDNS datagram that we will fully receive without truncation. RFC 6762 §17 says implementations MUST be prepared to receive messages up to 9000 bytes.

pub const fn endpoint_config(&self) -> &EndpointConfig

The proto-layer EndpointConfig.

pub const fn with_ipv4(self, enable: bool) -> Self

Enable or disable IPv4. At least one of v4/v6 must remain enabled.

pub const fn with_ipv6(self, enable: bool) -> Self

Enable or disable IPv6.

pub const fn with_interface_index(self, idx: Option<u32>) -> Self

Pin the listener to a specific interface (by OS index). When None (the default), the first multicast-capable, non-loopback interface is picked.

pub const fn with_max_payload_size(self, size: usize) -> Self

Override the maximum outgoing-packet buffer size.

pub const fn with_max_recv_packet_size(self, size: usize) -> Self

Override the inbound receive buffer size.

pub fn with_endpoint_config(self, cfg: EndpointConfig) -> Self

Override the proto-layer EndpointConfig.

Trait Implementations

impl Clone for ServerOptions

fn clone(&self) -> ServerOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ServerOptions

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

Formats the value using the given formatter.

impl Default for ServerOptions

fn default() -> Self

Returns the “default value” for a type.