Enum TxtRecord 

pub enum TxtRecord {
    Spf(Arc<SpfRecord>),
    SpfExplanation(Arc<Macro>),
    DomainKey(Arc<DomainKey>),
    DkimReport(Arc<DkimReportRecord>),
    Dmarc(Arc<DmarcRecord>),
    Atps(Arc<AtpsRecord>),
    MtaSts(Arc<MtaStsRecord>),
    TlsRpt(Arc<TlsRptRecord>),
    Error(Error),
}

A parsed DNS TXT record, as stored in the TXT ResolverCache of a DnsCache.

MessageAuthenticator::txt_lookup parses the TXT answer into the record type the caller asked for and caches the outcome as a TxtRecord, so a cache hit skips both the query and the parse. When no TXT record of the requested type parses, the error is cached as TxtRecord::Error, and so is a negative answer (NXDOMAIN or NODATA) that carries an SOA record; resolver failures are not cached. Each record type converts into its variant with From, which lets cache implementations pre-populate entries.

Variants

Spf(Arc<SpfRecord>)

An SPF record (RFC 7208 Section 4.5).

SpfExplanation(Arc<Macro>)

The explanation string fetched from the target of an SPF exp= modifier (RFC 7208 Section 6.2), kept unexpanded.

DomainKey(Arc<DomainKey>)

A DKIM public key record (RFC 6376 Section 3.6.1).

DkimReport(Arc<DkimReportRecord>)

A DKIM failure reporting record (RFC 6651 Section 3).

Dmarc(Arc<DmarcRecord>)

A DMARC policy record (RFC 9989).

Atps(Arc<AtpsRecord>)

A DKIM Authorized Third-Party Signatures record (RFC 6541 Section 4).

MtaSts(Arc<MtaStsRecord>)

An MTA-STS record (RFC 8461 Section 3.1).

TlsRpt(Arc<TlsRptRecord>)

An SMTP TLS Reporting record (RFC 8460 Section 3).

Error(Error)

No TXT record at the name parsed as the requested type, or the name has no TXT records. Holds the error returned to the caller.

Implementations

impl TxtRecord

pub fn heap_size(&self) -> usize

Approximate heap memory owned by this record, in bytes, including the shared allocation of the parsed record. Walks the record once, so cache implementations should compute it when the entry is inserted.

Trait Implementations

impl Clone for TxtRecord

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl From<AtpsRecord> for TxtRecord

fn from(v: AtpsRecord) -> Self

Converts to this type from the input type.

impl From<DkimReportRecord> for TxtRecord

fn from(v: DkimReportRecord) -> Self

Converts to this type from the input type.

impl From<DmarcRecord> for TxtRecord

fn from(v: DmarcRecord) -> Self

Converts to this type from the input type.

impl From<DomainKey> for TxtRecord

fn from(v: DomainKey) -> Self

Converts to this type from the input type.

impl From<Macro> for TxtRecord

fn from(v: Macro) -> Self

Converts to this type from the input type.

impl From<MtaStsRecord> for TxtRecord

fn from(v: MtaStsRecord) -> Self

Converts to this type from the input type.

impl<T: Into<TxtRecord>> From<Result<T, Error>> for TxtRecord

fn from(v: Result<T>) -> Self

Converts to this type from the input type.

impl From<SpfRecord> for TxtRecord

fn from(v: SpfRecord) -> Self

Converts to this type from the input type.

impl From<TlsRptRecord> for TxtRecord

fn from(v: TlsRptRecord) -> Self

Converts to this type from the input type.