Enum TailStatus 

pub enum TailStatus {
    Clean,
    OrphanTail {
        bytes: u64,
    },
    Corrupt {
        bytes: u64,
        first_decode_error: DecodeError,
    },
}

Classification of the trailing bytes past the last decodable record, if any.

Classification is by decoder behavior, not by checkpoint-commit boundary: verify walks the byte stream and inspects the error (if any) that stopped the walk. A partially-written record whose header fits but whose body is truncated is OrphanTail; any structural violation (unknown opcode, reserved sentinel, body underflow after a valid length) is Corrupt. Higher layers combine this with checkpoint state to decide recovery strategy.

Variants

Clean

The log decoded cleanly from start to end; no trailing bytes.

OrphanTail

Trailing bytes exist and the decoder stopped on a Truncated error — consistent with a crashed-mid-write tail that write-protocol.md § 10 expects to be truncated on next open.

Fields

bytes: u64

Number of trailing bytes.

Corrupt

Trailing bytes exist and the decoder stopped on a non- truncation error (unknown opcode, body underflow, reserved sentinel, etc.) — genuine corruption, not the recoverable append-was-interrupted pattern.

Fields

bytes: u64

Number of trailing bytes.

first_decode_error: DecodeError

The DecodeError that stopped the walk.

Implementations

impl TailStatus

pub const fn is_clean(&self) -> bool

true if the tail is clean (no trailing bytes).

pub const fn is_corrupt(&self) -> bool

true if the tail indicates genuine corruption rather than a recoverable truncated write.

pub const fn trailing_bytes(&self) -> u64

Number of trailing bytes (zero for Clean).

Trait Implementations

impl Clone for TailStatus

fn clone(&self) -> TailStatus

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TailStatus

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

Formats the value using the given formatter.

impl PartialEq for TailStatus

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for TailStatus

impl StructuralPartialEq for TailStatus