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.

Multi-interface binding (one socket pair per interface) is not yet supported — callers who need to advertise on several NICs should construct one Endpoint per 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 fn with_ipv4(self, enable: bool) -> Self

Disable IPv4. At least one of v4/v6 must remain enabled.

pub const fn ipv6(&self) -> bool

Whether IPv6 is enabled.

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

Disable IPv6.

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

The pinned interface index, if any.

pub 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 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 fn with_max_payload_size(self, size: usize) -> Self

Override the maximum outgoing packet size.

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 (jumbo-frame-sized) even though outgoing messages should fit in the path MTU.

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

Override the recv buffer size.

pub const fn update_channel_capacity(&self) -> usize

👎Deprecated:

per-handle channels are unbounded; this setting has no effect

Capacity of the per-handle update channel that the driver writes to.

Deprecated: per-handle channels are now unbounded so that critical events (Established/Renamed/Conflict/HostConflict/ Terminal) cannot be silently dropped under backpressure. This value is preserved for API compatibility but has no effect.

pub fn with_update_channel_capacity(self, cap: usize) -> Self

👎Deprecated:

per-handle channels are unbounded; this setting has no effect

Override the per-handle update channel capacity. No-op — see Self::update_channel_capacity.

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

The proto-layer EndpointConfig.

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.