Struct trust_dns_client::rr::RecordSet
source · [−]pub struct RecordSet { /* private fields */ }
Expand description
Set of resource records associated to a name and type
Implementations
Creates a new Resource Record Set.
Arguments
name
- The label for theRecordSet
record_type
-RecordType
of thisRecordSet
, all records in theRecordSet
must be of the specifiedRecordType
.serial
- current serial number of theSOA
record, this is to be used forIXFR
and signing for DNSSec after updates.
Return value
The newly created Resource Record Set TODO: make all cloned params pass by value
Creates a new Resource Record Set.
Arguments
name
- The label for theRecordSet
record_type
-RecordType
of thisRecordSet
, all records in theRecordSet
must be of the specifiedRecordType
.ttl
- time-to-live for theRecordSet
in seconds.
Return value
The newly created Resource Record Set TODO: make all cloned params pass by value
Return value
Label of the Resource Record Set
Return value
RecordType
of the Resource Record Set
Sets the DNSClass to the specified value
This will traverse every record and associate with it the specified dns_class
Sets the TTL, in seconds, to the specified value
This will traverse every record and associate with it the specified ttl
Returns the time-to-live for the record.
Return value
TTL, time-to-live, of the Resource Record Set, this is the maximum length of time that an RecordSet should be cached.
pub fn records(
&self,
and_rrsigs: bool,
supported_algorithms: SupportedAlgorithms
) -> RrsetRecords<'_>
pub fn records(
&self,
and_rrsigs: bool,
supported_algorithms: SupportedAlgorithms
) -> RrsetRecords<'_>
Returns a Vec of all records in the set.
Arguments
and_rrsigs
- if true, RRSIGs will be returned if they existsupported_algorithms
- the RRSIGs will be filtered by the set of supported_algorithms, and then only the maximal RRSIG algorithm will be returned.
pub fn records_with_rrsigs(
&self,
supported_algorithms: SupportedAlgorithms
) -> RrsetRecords<'_>
pub fn records_with_rrsigs(
&self,
supported_algorithms: SupportedAlgorithms
) -> RrsetRecords<'_>
Returns a Vec of all records in the set, with RRSIGs, if present.
Arguments
supported_algorithms
- the RRSIGs will be filtered by the set of supported_algorithms, and then only the maximal RRSIG algorithm will be returned.
Returns a Vec of all records in the set, without any RRSIGs.
👎 Deprecated: see records_without_rrsigs
see records_without_rrsigs
Returns an iterator over the records in the set
Returns a slice of all the Records signatures in the RecordSet
Inserts a Signature for the Record set
Many can be associated with the RecordSet. Once added, the RecordSet should not be changed
Arguments
rrsig
- A signature which covers the RecordSet.
Useful for clearing all signatures when the RecordSet is updated, or keys are rotated.
creates a new Record as part of this RecordSet, adding the associated RData
this interface may be deprecated in the future.
creates a new Record as part of this RecordSet, adding the associated RData
Inserts a new Resource Record into the Set.
If the record is inserted, the ttl for the most recent record will be used for the ttl of the entire resource record set.
This abides by the following restrictions in RFC 2136, April 1997:
1.1.5. The following RR types cannot be appended to an RRset. If the
following comparison rules are met, then an attempt to add the new RR
will result in the replacement of the previous RR:
SOA compare only NAME, CLASS and TYPE -- it is not possible to
have more than one SOA per zone, even if any of the data
fields differ.
CNAME compare only NAME, CLASS, and TYPE -- it is not possible
to have more than one CNAME RR, even if their data fields
differ.
Arguments
record
-Record
asserts that thename
andrecord_type
match theRecordSet
.serial
- current serial number of theSOA
record, this is to be used forIXFR
and signing for DNSSec after updates. The serial will only be updated if the record was added.
Return value
True if the record was inserted.
TODO: make a default add without serial number for basic usage
Removes the Resource Record if it exists.
Arguments
record
-Record
asserts that thename
andrecord_type
match theRecordSet
. Removes anyrecord
if the record data,RData
, match.serial
- current serial number of theSOA
record, this is to be used forIXFR
and signing for DNSSec after updates. The serial will only be updated if the record was added.
Return value
True if a record was removed.
Consumes RecordSet
and returns its components
Trait Implementations
use From/Into
Performs the conversion to a RecordSet
Auto Trait Implementations
impl RefUnwindSafe for RecordSet
impl UnwindSafe for RecordSet
Blanket Implementations
Mutably borrows from an owned value. Read more