Struct CAA 

#[non_exhaustive]
pub struct CAA {
    pub issuer_critical: bool,
    pub reserved_flags: u8,
    pub tag: String,
    pub value: Vec<u8>,
}

The CAA RR Type

RFC 8659, DNS Certification Authority Authorization, November 2019

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.

issuer_critical: bool

Indicates that the corresponding property tag MUST be understood if the semantics of the CAA record are to be correctly interpreted by an issuer

reserved_flags: u8

The flags of the record minus the issuer_critical flag

tag: String

The property tag

value: Vec<u8>

The raw value of the CAA record

Implementations

impl CAA

pub fn new_issue( issuer_critical: bool, name: Option<Name>, options: Vec<KeyValue>, ) -> Self

Creates a new CAA issue record data, the tag is issue

Arguments

• issuer_critical - indicates that the corresponding property tag MUST be understood if the semantics of the CAA record are to be correctly interpreted by an issuer
• name - authorized to issue certificates for the associated record label
• options - additional options for the issuer, e.g. ‘account’, etc.

pub fn new_issuewild( issuer_critical: bool, name: Option<Name>, options: Vec<KeyValue>, ) -> Self

Creates a new CAA issue record data, the tag is issuewild

Arguments

• issuer_critical - indicates that the corresponding property tag MUST be understood if the semantics of the CAA record are to be correctly interpreted by an issuer
• name - authorized to issue certificates for the associated record label
• options - additional options for the issuer, e.g. ‘account’, etc.

pub fn new_iodef(issuer_critical: bool, url: Url) -> Self

Creates a new CAA issue record data, the tag is iodef

Arguments

• issuer_critical - indicates that the corresponding property tag MUST be understood if the semantics of the CAA record are to be correctly interpreted by an issuer
• url - Url where issuer errors should be reported

pub fn flags(&self) -> u8

Returns the Flags field of the resource record

pub fn set_issuer_value( &mut self, name: Option<&Name>, key_values: &[KeyValue], ) -> Result<(), ProtoError>

Set the value associated with an issue or issuewild tag.

This returns an error if the tag is not issue or issuewild.

pub fn set_iodef_value(&mut self, url: &Url) -> Result<(), ProtoError>

Set the value associated with an iodef tag.

This returns an error if the tag is not iodef.

pub fn value_as_issue( &self, ) -> Result<(Option<Name>, Vec<KeyValue>), ProtoError>

Get the value of an issue or issuewild CAA record.

This returns an error if the record’s tag is not issue or issuewild, or if the value does not match the expected syntax.

pub fn value_as_iodef(&self) -> Result<Url, ProtoError>

Get the value of an iodef CAA record.

This returns an error if the record’s tag is not iodef, or if the value is an invalid URL.

Trait Implementations

impl BinEncodable for CAA

fn emit(&self, encoder: &mut BinEncoder<'_>) -> Result<(), ProtoError>

Write the type to the stream

fn to_bytes(&self) -> Result<Vec<u8>, ProtoError>

Returns the object in binary form

impl Clone for CAA

fn clone(&self) -> CAA

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CAA

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

Formats the value using the given formatter.

impl Display for CAA

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

Formats the value using the given formatter.

impl Hash for CAA

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for CAA

fn eq(&self, other: &CAA) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl RecordData for CAA

fn try_borrow(data: &RData) -> Option<&Self>

Attempts to borrow this RecordData from the RData type, if it is not the correct type the original is returned

fn record_type(&self) -> RecordType

Get the associated RecordType for the RecordData

fn into_rdata(self) -> RData

Converts this RecordData into generic RecordData

fn is_update(&self) -> bool

RDLENGTH = 0

impl Eq for CAA

impl StructuralPartialEq for CAA