Struct DirTolerance 

#[non_exhaustive]
pub struct DirTolerance {
    pre_valid_tolerance: Duration,
    post_valid_tolerance: Duration,
}

Configuration for how much much to extend the official tolerances of our directory information.

Because of possible clock skew, and because we want to tolerate possible failures of the directory authorities to reach a consensus, we want to consider a directory to be valid for a while before and after its official range of validity.

TODO: Remove the Default because it is too tightly bound to a client.

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.

pre_valid_tolerance: Duration

post_valid_tolerance: Duration

Implementations

impl DirTolerance

pub fn builder() -> DirToleranceBuilder

Return a new [DirTolerance Builder] to construct an instance of this type.

impl DirTolerance

pub fn pre_valid_tolerance(&self) -> Duration

For how long before a directory document is valid should we accept it?

Having a nonzero value here allows us to tolerate a little clock skew.

Defaults to 1 day.

pub fn post_valid_tolerance(&self) -> Duration

For how long after a directory document is valid should we consider it usable?

Having a nonzero value here allows us to tolerate a little clock skew, and makes us more robust to temporary failures for the directory authorities to reach consensus.

Defaults to 3 days (per prop212).

impl DirTolerance

pub fn extend_tolerance<B>( &self, timebound: TimerangeBound<B>, ) -> TimerangeBound<B>

Return a new TimerangeBound that extends the validity interval of timebound according to this configuration.

pub fn extend_lifetime(&self, lifetime: &Lifetime) -> Lifetime

Return a new consensus Lifetime that extends the validity intervals of lifetime according to this configuration.

Trait Implementations

impl Buildable for DirTolerance

type Builder = DirToleranceBuilder

The type that constructs this Buildable.

fn builder() -> DirToleranceBuilder

Return a new Builder for this type.

impl Clone for DirTolerance

fn clone(&self) -> DirTolerance

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DirTolerance

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

Formats the value using the given formatter.

impl Default for DirTolerance

fn default() -> DirTolerance

Returns the “default value” for a type.

impl PartialEq for DirTolerance

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

impl StructuralPartialEq for DirTolerance