Struct ReinitializeContext 

#[non_exhaustive]
pub struct ReinitializeContext {
    pub state: ReinitializedState,
    pub source_mac: MacAddr,
    pub source_network: Option<NpduAddress>,
    pub provenance: TransportProvenance,
    pub invoke_id: u8,
}

The ReinitializeDevice request a ReinitializeHandler is asked to carry out, and who sent it.

The addresses are claims, not an authenticated operator. For routed traffic source_mac is the last router, so restrict routed requesters by source_network; only direct_sc_identity is verified. Neither the mutation policy nor the mutation authorizer sees this service, so a handler that serves only some peers checks them here.

The server builds the context; new lets a test build one to call a handler directly.

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.

state: ReinitializedState

The requested state, one of those Clause 16.4 defines.

source_mac: MacAddr

Immediate data-link peer (or router) address.

source_network: Option<NpduAddress>

Originating NPDU source when the request was routed.

provenance: TransportProvenance

Immutable ingress snapshot, retained after the admitting connection closes.

invoke_id: u8

Confirmed-request invoke identifier.

Implementations

impl ReinitializeContext

pub fn new( state: ReinitializedState, source_mac: MacAddr, source_network: Option<NpduAddress>, provenance: TransportProvenance, invoke_id: u8, ) -> Self

A context with these fields, for calling a handler outside the server, such as in its unit tests. Outside bacnet-transport only TransportProvenance::unverified can be built.

pub fn direct_sc_identity(&self) -> Option<DirectScIdentity>

Original verified direct-SC leaf and incarnation, separate from claims.

Trait Implementations

impl Clone for ReinitializeContext

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ReinitializeContext

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

Formats the value using the given formatter.

impl Eq for ReinitializeContext

impl PartialEq for ReinitializeContext

fn eq(&self, other: &Self) -> bool

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ReinitializeContext