Struct DiscoveryOptions 

#[non_exhaustive]
pub struct DiscoveryOptions {
    pub dns_server: Option<String>,
    pub enabled: bool,
    pub dns_nameservers: Vec<String>,
}

DNS-based peer discovery configuration.

Marked #[non_exhaustive] so future additive fields are not a source-compatibility break for downstream crates: construct it via DiscoveryOptions::new (or Default) and set optional fields on the returned value rather than with an exhaustive struct literal.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

dns_server: Option<String>

DNS discovery server URL. Uses n0 DNS defaults when None.

enabled: bool

Whether to enable DNS discovery. Default: true.

dns_nameservers: Vec<String>

Explicit ordinary-DNS nameservers for iroh’s resolver.

Accepts IPs such as "8.8.8.8" and numeric scoped IPv6 addresses such as "fe80::1%17". This setting is unrelated to DNS-SD/mDNS: it supplies the resolver used for relay, pkarr, and DNS-discovery hostnames when the platform’s system DNS config is unavailable. Empty means use iroh’s default resolver.

Implementations

impl DiscoveryOptions

pub fn new(dns_server: Option<String>, enabled: bool) -> Self

Construct a DiscoveryOptions with an empty dns_nameservers list.

The forward-compatible constructor for downstream crates: since the struct is #[non_exhaustive] they cannot use a struct literal. Set dns_nameservers (or any future field) on the returned value.

Trait Implementations

impl Clone for DiscoveryOptions

fn clone(&self) -> DiscoveryOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DiscoveryOptions

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

Formats the value using the given formatter.

impl Default for DiscoveryOptions

fn default() -> Self

Returns the “default value” for a type.