Struct Registered 

pub struct Registered {
    pub lease: Lease,
    pub observation: RegistrationObservation,
    pub path: PathSet,
    pub service_route: ServiceRoute,
    pub flow_accepted: bool,
    pub flow_timer: Option<Duration>,
    pub gruus: Gruus,
    pub push: Support,
}

A successful registration: the lease, and the two route vectors that came back with it.

A struct rather than three positional fields on the enum variant, because PathSet and ServiceRoute are the same shape and opposite directions — Path routes requests toward this UA and is not ours to follow, Service-Route routes the requests we send. Positionally interchangeable arguments of identical type are how they would eventually get swapped.

Fields

lease: Lease

What the registrar granted, and when to refresh it.

observation: RegistrationObservation

The source address the registrar reported in the top response Via.

Informational only: it never rewrites a Contact, route or media address. Invalid or absent observations do not change the lease or any other registration result.

path: PathSet

The proxies the registrar recorded on the path back to this contact (RFC 3327).

service_route: ServiceRoute

The proxies this UA’s own outbound requests must traverse (RFC 3608).

flow_accepted: bool

Whether the registrar reports having performed an outbound registration (RFC 5626 §6).

§6 requires a registrar that did to say so in Require. Believing it happened without being told means keeping a flow alive that nothing is routing down, and treating a binding that is only as durable as its NAT mapping as though it were durable.

flow_timer: Option<Duration>

The Flow-Timer the registrar named, if any (RFC 5626 §4.4).

How long it will hold the flow open without traffic. When present it replaces the UA’s own choice of keep-alive interval outright.

gruus: Gruus

The GRUUs the registrar issued for this instance’s binding (RFC 5627 §4.2).

Empty when GRUU was not asked for, and empty when it was and the registrar issued nothing — §4.2 makes both ordinary. They travel with the binding rather than beside it because they expire with it: a GRUU outliving the registration that produced it is an address a UA would keep publishing after it had stopped resolving.

push: Support

What the registrar said about push notifications (RFC 8599 §8.2).

Empty when push was not asked for, and empty when it was and the registrar implements nothing of RFC 8599 — which is not a refusal. The case worth reading it for is the third one: a registrar that answered 200 while naming a different push service has recorded a binding nothing will ever wake, and this is the only place that says so.

Trait Implementations

impl Clone for Registered

fn clone(&self) -> Registered

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Registered

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

Formats the value using the given formatter.

impl PartialEq for Registered

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

impl StructuralPartialEq for Registered