Struct Gruus 

pub struct Gruus { /* private fields */ }

The GRUUs a registrar issued for one instance’s binding (§4.2, §5.2).

Held with the registration rather than beside it, and replaced wholesale on every 2xx. That is not tidiness: §4.2 requires a UA to “discard all temporary GRUUs learned through prior REGISTER responses” whenever the Call-ID changes, and a set that is replaced rather than merged cannot carry a stale one across.

Implementations

impl Gruus

pub fn from_response(response: &Response, instance: &InstanceId) -> Self

Read the GRUUs a REGISTER 2xx issued for instance (§4.2).

§4.2 pairs the two parameters with the Contact carrying the +sip.instance they were minted for — and a 2xx lists every current binding for the address of record, other devices’ included (RFC 3261 §10.3). Selecting the row by instance rather than by position is what stops this adopting another phone’s GRUU and then answering to it.

A value that is not a GRUU is dropped rather than kept. §7 gives a GRUU the gr parameter, and a URI without one is the address of record: using it as though it named this instance would route every one of the user’s devices at a request meant for one.

pub fn public(&self) -> Option<&Uri>

The public GRUU, if the registrar issued one.

pub fn temporary(&self) -> Option<&Uri>

The temporary GRUU, if the registrar issued one.

pub fn is_empty(&self) -> bool

Whether the registrar issued neither.

§4.2: “A UA must be prepared for a Contact to contain just one, both, or neither” — a registrar that does not implement RFC 5627 answers a REGISTER perfectly well and attaches nothing, and that is not an error.

pub fn preferred(&self, kind: Kind) -> Option<&Uri>

The GRUU to use for a caller that asked for kind (§4.4).

One never stands in for the other. Asking for a temporary GRUU and being handed the public one would tell the caller the opposite of the truth about what it just put in a Contact: it believes it published an address nobody can correlate, and it published the device’s permanent name. None — falling back to the ordinary contact — is the honest answer, and it is the one that leaks least.

pub fn sent_to(&self, request_uri: &Uri) -> bool

Whether a request whose Request-URI is request_uri was sent to one of these (§4.5).

Trait Implementations

impl Clone for Gruus

fn clone(&self) -> Gruus

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Gruus

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

Formats the value using the given formatter.

impl Default for Gruus

fn default() -> Gruus

Returns the “default value” for a type.

impl PartialEq for Gruus

Compared by what the two URIs say, because [Uri] deliberately has no PartialEq: RFC 3261 §19.1.4 equivalence is not transitive, and it is the wrong relation here anyway — two registrations that returned different spellings of one GRUU did return different values.

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