Enum BridgeCloseReason 

#[non_exhaustive]
pub enum BridgeCloseReason {
    Shutdown,
    IdleTimeout,
    PeerEofLeft,
    PeerEofRight,
    ReadErrorLeft,
    ReadErrorRight,
    WriteErrorLeft,
    WriteErrorRight,
    PeekTimeout,
    HandlerDeadline,
    PausedTimeout,
    FirstByteTimeout,
}

Available on crate feature std only.

Reason why a rama bridge — byte-oriented (see IoForwardService in rama-net) or frame-oriented (see StreamForwardService) — terminated.

Shared vocabulary used in close-log events emitted by rama bridges. Consumers are free to emit any subset; each variant carries no metadata of its own.

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.

Shutdown

Graceful shutdown was requested via the configured shutdown signal.

IdleTimeout

The bridge observed no progress in either direction within the configured idle window.

PeerEofLeft

The “left” / a side reached EOF.

PeerEofRight

The “right” / b side reached EOF.

ReadErrorLeft

Read from the left half failed.

ReadErrorRight

Read from the right half failed.

WriteErrorLeft

Write to the left half failed.

WriteErrorRight

Write to the right half failed.

PeekTimeout

A protocol-peek read deadline elapsed before the peek completed. Used by tproxy bridges that peek the first bytes for protocol detection.

HandlerDeadline

The flow handler did not produce a decision within the configured deadline. The flow was rejected (or passed through, depending on configuration) without bridging.

PausedTimeout

A backpressure-paused write side was never re-armed by its peer drain signal within the configured maximum-pause window. Surfaces stuck downstream writers (e.g. a Swift flow.write completion handler that never invokes signalServerDrain) instead of wedging the bridge indefinitely.

FirstByteTimeout

The upstream (right / egress) half wrote no byte within the configured first-byte window. Surfaces a silent origin that accepts the connection but never responds, distinct from IdleTimeout, which only fires when neither direction moves (a silent origin still receives the client’s bytes).

Trait Implementations

impl Clone for BridgeCloseReason

fn clone(&self) -> BridgeCloseReason

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for BridgeCloseReason

impl Debug for BridgeCloseReason

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

Formats the value using the given formatter.

impl Display for BridgeCloseReason

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

Formats the value using the given formatter.

impl Eq for BridgeCloseReason

impl Hash for BridgeCloseReason

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for BridgeCloseReason

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for BridgeCloseReason

impl TraceField for BridgeCloseReason

Available on crate feature dial9 only.

type Ref<'a> = BridgeCloseReason

The zero-copy decoded form of this field.

fn field_type() -> FieldType

fn encode<W>(&self, enc: &mut EventEncoder<'_, W>) -> Result<(), Error>

where W: Write,

Encode this field’s value into the event encoder.

fn decode_ref<'a>( val: &FieldValueRef<'a>, ) -> Option<<BridgeCloseReason as TraceField>::Ref<'a>>

Extract this field’s value from a zero-copy FieldValueRef.

fn is_optional() -> bool

Whether this field is optional on the wire (high-bit modifier).

fn decode_missing<'a>() -> Option<Self::Ref<'a>>

Called when the field is absent from the wire data (not in the schema). Returns None for required fields (decode failure) and Some(None) for optional fields.