Enum KmRefreshEvent 

#[non_exhaustive]
pub enum KmRefreshEvent {
    PreAnnounce {
        next_parity: KeyParity,
    },
    Switchover {
        new_active: KeyParity,
    },
    Decommission {
        retired: KeyParity,
    },
}

Available on crate feature crypto only.

One state transition KmRefreshDriver::on_packet_sent / KmRefreshDriver::tick can fire (draft-sharabayko-srt-01 §6.1.6).

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

PreAnnounce

refresh_period - pre_announcement_period packets sent under the active key: generate, wrap, and send a fresh SEK for next_parity now (§6.1.5’s Key Material exchange, driven out-of-band of this driver — see the module doc).

Fields

next_parity: KeyParity

The parity the newly-generated key will use.

Switchover

refresh_period packets sent under the active key: start encrypting new outgoing packets with new_active from now on. The previous key remains valid for decrypting late/retransmitted packets until KmRefreshEvent::Decommission fires for it.

Fields

new_active: KeyParity

The parity now active for new packets.

Decommission

pre_announcement_period packets after switchover: the previous key may be dropped — no more retransmits will need it (§6.1.6, “both keys valid in parallel for 2 * Pre-Announcement Period”).

Fields

retired: KeyParity

The parity being retired.

Trait Implementations

impl Clone for KmRefreshEvent

fn clone(&self) -> KmRefreshEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for KmRefreshEvent

impl Debug for KmRefreshEvent

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

Formats the value using the given formatter.

impl Eq for KmRefreshEvent

impl PartialEq for KmRefreshEvent

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for KmRefreshEvent