pub struct EntryChanged<const S: usize, const T: usize> {
pub admin_node_id: Option<NodeId>,
pub admin_passcode_id: Option<u16>,
pub change_type: ChangeType,
pub latest_value: Option<Entry<S, T>>,
pub fabric_index: FabricIndex,
}Expand description
What one change to the ACL attribute should be recorded as (§9.10.9.1).
The server “SHALL generate AccessControlEntryChanged events whenever its ACL attribute data is changed by an Administrator”, and the event names who: “Exactly one of AdminNodeID and AdminPasscodeID SHALL be set, depending on whether the change occurred via a CASE or PASE session”. Reported rather than logged here, because §7.14’s event store is the device’s and this cluster does not own one.
Fields§
§admin_node_id: Option<NodeId>The administrator’s node id, when the change came over CASE.
admin_passcode_id: Option<u16>The passcode id, when it came over PASE. Always Some(0) in practice: “Non-zero
values are reserved for future use”.
change_type: ChangeTypeWhat happened.
latest_value: Option<Entry<S, T>>LatestValue [4] — “The latest value of the changed entry”, which for a removal is the
entry as it stood when it was removed.
None is the field’s null, which §9.10.9.1 permits only as a concession: “This field
SHOULD be set if resources are adequate for it; otherwise it SHALL be set to NULL if
resources are scarce.” An audit trail of when the list changed and never to what is
most of the way to no audit trail, so this carries the entry wherever one is available.
fabric_index: FabricIndexThe fabric whose list changed.
Implementations§
Source§impl<const S: usize, const T: usize> EntryChanged<S, T>
impl<const S: usize, const T: usize> EntryChanged<S, T>
Sourcepub fn for_session(
ctx: &InteractionContext<'_>,
change_type: ChangeType,
latest_value: Option<Entry<S, T>>,
) -> Self
pub fn for_session( ctx: &InteractionContext<'_>, change_type: ChangeType, latest_value: Option<Entry<S, T>>, ) -> Self
The record for a change made on ctx’s session.
Sourcepub fn for_fabric(self, fabric_index: FabricIndex) -> Self
pub fn for_fabric(self, fabric_index: FabricIndex) -> Self
The same record, attributed to a fabric the session does not yet carry.
§11.18.6.8 step 7 adds the administrator entry for a fabric during AddNOC, over a
PASE session whose accessing fabric is bound only at step 10a — so at the moment of the
change ctx.fabric_index is still none, and the event would be attributed to fabric 0
and visible to nobody. §7.14.4 makes a fabric-sensitive event readable only by its own
fabric, which for this one means the fabric it just created.