Enum Fault 

pub enum Fault {
    Undecodable {
        position: u64,
        detail: String,
    },
    UnsupportedFormat {
        position: u64,
        found: u16,
    },
    BrokenChain {
        position: u64,
        expected: Option<ContentHash>,
        found: Option<ContentHash>,
    },
    SeqMismatch {
        position: u64,
        found: u64,
    },
}

The first thing found wrong with a log, if anything was.

One fault, not a list, and deliberately so: after the first break every later record is being judged against a chain that is already wrong, so a list would be one real finding followed by noise.

Variants

Undecodable

A newline-terminated record did not decode. It was written whole once, so this is damage, not a torn write.

Fields

position: u64

Position in the file, counting records from zero.

detail: String

What the decoder said.

UnsupportedFormat

A record names a wire format this build does not support.

Fields

position: u64

Position in the file, counting records from zero.

found: u16

Version carried by the record.

BrokenChain

A record’s parent is not the hash of the record before it.

Fields

position: u64

Position in the file, counting records from zero.

expected: Option<ContentHash>

The hash the previous record actually has.

found: Option<ContentHash>

The hash this record claims its parent is.

SeqMismatch

A record’s seq is not its position in the file.

Separate from Fault::BrokenChain because the two fail independently: a log can renumber without breaking its hashes (the hash does not cover position) and can break its hashes while staying numbered correctly.

Fields

position: u64

Position in the file, counting records from zero.

found: u64

The seq the record carries.

Implementations

impl Fault

pub fn position(&self) -> u64

Where the log first goes wrong.

Trait Implementations

impl Clone for Fault

fn clone(&self) -> Fault

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Fault

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

Formats the value using the given formatter.

impl Display for Fault

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

Formats the value using the given formatter.

impl PartialEq for Fault

fn eq(&self, other: &Fault) -> 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 Fault

impl StructuralPartialEq for Fault