Struct ServerOptions 

pub struct ServerOptions { /* private fields */ }

The options for [Server].

Implementations

impl ServerOptions

pub const fn new() -> Self

Returns a new instance of ServerOptions.

pub const fn ipv4_interface(&self) -> Option<&Ipv4Addr>

Returns the Ipv4 interface to bind the multicast listener to.

Example

use agnostic_mdns::ServerOptions;
use std::net::Ipv4Addr;

let opts = ServerOptions::new().with_ipv4_interface(Ipv4Addr::new(192, 168, 1, 1));
assert_eq!(opts.ipv4_interface(), Some(&Ipv4Addr::new(192, 168, 1, 1)));

pub fn with_ipv4_interface(self, iface: Ipv4Addr) -> Self

Sets the IPv4 interface to bind the multicast listener to.

Example

use agnostic_mdns::ServerOptions;
use std::net::Ipv4Addr;

let opts = ServerOptions::new().with_ipv4_interface(Ipv4Addr::new(192, 168, 1, 1));

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

Returns the Ipv6 interface to bind the multicast listener to.

Example

use agnostic_mdns::ServerOptions;

let opts = ServerOptions::new().with_ipv6_interface(1);
assert_eq!(opts.ipv6_interface(), Some(1));

pub fn with_ipv6_interface(self, index: u32) -> Self

Sets the IPv6 interface to bind the multicast listener to.

Example

use agnostic_mdns::ServerOptions;

let opts = ServerOptions::new().with_ipv6_interface(1);

pub fn with_log_empty_responses(self, log_empty_responses: bool) -> Self

Sets whether the server should print an informative message when there is an mDNS query for which the server has no response.

Default is false.

Example

use agnostic_mdns::ServerOptions;

let opts = ServerOptions::new().with_log_empty_responses(true);
assert_eq!(opts.log_empty_responses(), true);

pub const fn log_empty_responses(&self) -> bool

Returns whether the server should print an informative message when there is an mDNS query for which the server has no response.

Example

use agnostic_mdns::ServerOptions;

let opts = ServerOptions::new().with_log_empty_responses(true);
assert_eq!(opts.log_empty_responses(), true);

pub const fn max_payload_size(&self) -> usize

Returns the configured maximum payload size for mDNS message packets.

This value limits how large each mDNS packet can be when sending queries or receiving responses.

Smaller values may be necessary on networks with MTU constraints or when working with devices that have limited buffer sizes.

Default is 1500 bytes.

Example

use agnostic_mdns::ServerOptions;

let opts = ServerOptions::new().with_max_payload_size(1500);

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

Sets the maximum payload size for mDNS message packets.

This controls how large each mDNS packet can be when sending queries or receiving responses.

You might want to adjust this value to:

• Reduce the size to avoid IP fragmentation on networks with lower MTUs
• Match device-specific constraints in IoT environments
• Optimize for specific network conditions

Default is 1500 bytes.

Example

use agnostic_mdns::ServerOptions;

let opts = ServerOptions::new().with_max_payload_size(1500);

assert_eq!(opts.max_payload_size(), 1500);

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.