Enum ServerEvent 

#[non_exhaustive]
pub enum ServerEvent<P: Protocol> {
    ClientLinked {
        peer: SocketAddr,
        callsign: Callsign,
        module: Module,
    },
    ClientUnlinked {
        peer: SocketAddr,
    },
    ClientStreamStarted {
        peer: SocketAddr,
        stream_id: StreamId,
        header: DStarHeader,
    },
    ClientStreamFrame {
        peer: SocketAddr,
        stream_id: StreamId,
        seq: u8,
        frame: VoiceFrame,
    },
    ClientStreamEnded {
        peer: SocketAddr,
        stream_id: StreamId,
    },
    ClientRejected {
        peer: SocketAddr,
        reason: ClientRejectedReason,
    },
    VoiceFromReadOnlyDropped {
        peer: SocketAddr,
        stream_id: StreamId,
    },
    ClientEvicted {
        peer: SocketAddr,
        reason: String,
    },
}

One event surfaced by the server-side session machine.

The P: Protocol parameter is a phantom — every variant carries the same data regardless of protocol. The phantom is for compile-time discrimination only, confined to a hidden ServerEvent::__Phantom variant that cannot be constructed (its payload is an uninhabited Infallible).

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.

ClientLinked

A new client has linked to a module.

Fields

peer: SocketAddr

Client peer address.

callsign: Callsign

Client callsign.

module: Module

Module the client linked to.

ClientUnlinked

A client has unlinked.

Fields

peer: SocketAddr

Client peer address.

ClientStreamStarted

A client started a voice stream.

Fields

peer: SocketAddr

Client peer.

stream_id: StreamId

Stream id.

header: DStarHeader

The header they sent.

ClientStreamFrame

A client sent a voice frame.

Fields

peer: SocketAddr

Client peer.

stream_id: StreamId

Stream id.

seq: u8

Frame seq.

frame: VoiceFrame

Voice frame.

ClientStreamEnded

A client ended a voice stream.

Fields

peer: SocketAddr

Client peer.

stream_id: StreamId

Stream id.

ClientRejected

A link attempt was refused by the shell authorizer.

Emitted before any handle is created — the rejected client is not present in the pool. The reflector additionally enqueues a protocol-appropriate NAK to the peer.

Fields

peer: SocketAddr

Client peer that was rejected.

reason: ClientRejectedReason

Why the authorizer refused the link.

VoiceFromReadOnlyDropped

Voice from a read-only client was dropped.

Emitted when a client whose AccessPolicy is ReadOnly sends a voice header / data / EOT packet. The reflector drops the frame silently on the wire so the originator isn’t told the difference — this event lets consumers observe the drop for metrics and audit purposes without exposing it on-air.

Fields

peer: SocketAddr

Client peer that attempted to transmit.

stream_id: StreamId

Stream id of the dropped frame.

ClientEvicted

A client was evicted by the reflector.

Emitted when the shell removes a client for reasons unrelated to a protocol-level UNLINK — e.g. the send-failure threshold was exceeded or a health check fired. The peer entry has already been removed from the pool by the time this event is observed.

Fields

peer: SocketAddr

Client peer that was evicted.

reason: String

Human-readable reason for eviction.

Trait Implementations

impl<P: Clone + Protocol> Clone for ServerEvent<P>

fn clone(&self) -> ServerEvent<P>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<P: Debug + Protocol> Debug for ServerEvent<P>

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

Formats the value using the given formatter.