Struct MailExchanger 

pub struct MailExchanger {
    pub domain_name: String,
    pub hosts: Vec<String>,
    pub site_name: String,
    pub by_pref: BTreeMap<u16, Vec<String>>,
    pub is_domain_literal: bool,
    pub is_secure: bool,
    pub is_mx: bool,
    pub mta_sts: PolicyMode,
    /* private fields */
}

Fields

domain_name: String

hosts: Vec<String>

site_name: String

by_pref: BTreeMap<u16, Vec<String>>

is_domain_literal: bool

is_secure: bool

DNSSEC verified

is_mx: bool

mta_sts: PolicyMode

The applicable MTA-STS policy mode (PolicyMode::None when no policy applies). hosts/by_pref already exclude any hosts disallowed by the policy, so this is consulted only for TLS posture, not host gating.

Implementations

impl MailExchanger

pub async fn resolve(domain_name: &str) -> Result<Arc<Self>>

pub async fn resolve_via( domain_name: &str, resolver: Option<&dyn Resolver>, ) -> Result<Arc<Self>>

Like resolve, but performs DNS via the supplied resolver when one is provided. A supplied resolver bypasses the shared MX cache so callers (such as tests using a fixture resolver) get hermetic, order-independent results.

pub fn has_expired(&self) -> bool

pub async fn resolve_addresses( &self, resolver: Option<&dyn Resolver>, strategy: IpLookupStrategy, max_plan_size: usize, max_addresses_per_host: usize, ) -> ResolvedMxAddresses

Returns the list of resolved MX hosts in reverse preference order.

max_addresses_per_host caps the A/AAAA addresses kept from any single MX host, and max_plan_size caps the total across all hosts. Both bound the plan: a destination publishing a very large number of addresses cannot force an unbounded plan. When a cap truncates the list, the addresses that are dropped are from the least-preferred hosts.

Trait Implementations

impl Clone for MailExchanger

fn clone(&self) -> MailExchanger

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MailExchanger

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

Formats the value using the given formatter.

impl Serialize for MailExchanger

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.