Enum ExpirationInfo 

enum ExpirationInfo {
    Unused {
        created: Instant,
    },
    Dirty {
        dirty_since: Instant,
    },
    LongLived {
        last_known_to_be_used_at: Instant,
    },
}

Enumeration to track the expiration state of a tunnel.

A tunnel an either be unused (at which point it should expire if it is still unused by a certain time, or dirty (at which point it should expire after a certain duration).

All tunnels start out “unused” and become “dirty” when their spec is first restricted – that is, when they are first handed out to be used for a request.

Variants

Unused

The tunnel has never been used, and has never been restricted for use with a request.

Fields

created: Instant

A time when the tunnel was created.

Dirty

The tunnel is not-long-lived; we will expire by waiting until a certain amount of time after it was first used.

Fields

dirty_since: Instant

The time at which this tunnel’s spec was first restricted.

LongLived

The tunnel is long-lived; we will expire by waiting until it has passed a certain amount of time without having any streams attached to it.

Fields

last_known_to_be_used_at: Instant

Last time at which the tunnel was checked and found not to have any streams.

(This is a bit complicated: We have to be vague here, since we need an async check to find out that a tunnel is used, or when it actually became disused.)

Implementations

impl ExpirationInfo

fn new(now: Instant) -> Self

Return an ExpirationInfo for a newly created tunnel.

fn mark_used(&mut self, now: Instant, long_lived: bool)

Mark this ExpirationInfo as having been in-use at now.

If long_lived is false, the associated tunnel should expire a certain amount of time after it was first used. If long_lived is true, the associated tunnel should expire a certain amount of time after it was last used.

fn check_long_lived(&self) -> Result<()>

Return an internal error if this ExpirationInfo is not marked as long-lived.

Trait Implementations

impl Clone for ExpirationInfo

fn clone(&self) -> ExpirationInfo

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ExpirationInfo

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

Formats the value using the given formatter.

impl PartialEq for ExpirationInfo

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

impl StructuralPartialEq for ExpirationInfo