Struct Timestamp

pub struct Timestamp(/* private fields */);

A Timestamp for RRSIG Records.

DNS uses 32 bit timestamps that are conceptionally viewed as the 32 bit modulus of a larger number space. Because of that, special rules apply when processing these values. RFC 4034 defines Timestamps as the number of seconds elepased since since 1 January 1970 00:00:00 UTC, ignoring leap seconds. Timestamps are compared using so-called “Serial number arithmetic”, as defined in RFC 1982. The RFC defines the semantics for doing arithmetics in the face of these wrap-arounds. This type implements these semantics atop a native u32. The RFC defines two operations: addition and comparison.

For addition, the amount added can only be a positive number of up to 2^31 - 1. Because of this, we decided to not implement the Add trait but rather have a dedicated method add so as to not cause surprise panics.

Timestamps only implement a partial ordering. That is, there are pairs of values that are not equal but there still isn’t one value larger than the other. Since this is neatly implemented by the PartialOrd trait, the type implements that.

Implementations

impl Timestamp

pub fn now() -> Self

Returns a serial number for the current Unix time.

pub fn scan<S: Scanner>(scanner: &mut S) -> Result<Self, S::Error>

Scan a serial represention signature time value.

In RRSIG records, the expiration and inception times are given as serial values. Their representation format can either be the value or a specific date in YYYYMMDDHHmmSS format.

pub fn into_int(self) -> u32

Returns the timestamp as a raw integer.

impl Timestamp

Parsing and Composing

pub const COMPOSE_LEN: u16 = 4u16

pub fn parse<Octs: AsRef<[u8]> + ?Sized>( parser: &mut Parser<'_, Octs>, ) -> Result<Self, ParseError>

pub fn compose<Target: Composer + ?Sized>( &self, target: &mut Target, ) -> Result<(), Target::AppendError>

Trait Implementations

impl CanonicalOrd for Timestamp

fn canonical_cmp(&self, other: &Self) -> Ordering

Returns the canonical ordering between self and other.

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

Returns whether self is canonically less than other.

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

Returns whether self is canonically less than or equal to other.

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

Returns whether self is canonically greater than other.

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

Returns whether self is canonically greater than or equal to other.

impl Clone for Timestamp

fn clone(&self) -> Timestamp

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Timestamp

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

Formats the value using the given formatter.

impl Display for Timestamp

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

Formats the value using the given formatter.

impl From<u32> for Timestamp

fn from(item: u32) -> Self

Converts to this type from the input type.

impl FromStr for Timestamp

fn from_str(src: &str) -> Result<Self, Self::Err>

Parses a timestamp value from a string.

The presentation format can either be their integer value or a specific date in YYYYMMDDHHmmSS format.

type Err = IllegalSignatureTime

The associated error which can be returned from parsing.

impl PartialEq for Timestamp

fn eq(&self, other: &Timestamp) -> 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 PartialOrd for Timestamp

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Copy for Timestamp

impl StructuralPartialEq for Timestamp