Struct SegmentIdentity 

pub struct SegmentIdentity {
    pub database_id: [u8; 16],
    pub primary_generation: u64,
    pub wal_format_version: u16,
    pub catalog_version: u16,
}

Segment identity metadata used to reject forked or incompatible histories.

Fields

database_id: [u8; 16]

primary_generation: u64

wal_format_version: u16

catalog_version: u16

Implementations

impl SegmentIdentity

pub fn current(database_id: [u8; 16], primary_generation: u64) -> Self

Stamp an identity with this binary’s maximum supported catalog version.

Use this at consumer sites that want “the newest catalog format this binary can read” as the expected identity. Producers that publish segments must instead stamp the database’s active catalog version with Self::with_catalog_version, so a database that has not yet activated v6 keeps stamping v5 (old-replica compatibility).

pub fn with_catalog_version( database_id: [u8; 16], primary_generation: u64, catalog_version: u16, ) -> Self

Stamp an identity with an explicit (active) catalog version.

The catalog version is a compatibility annotation, not lineage: it records the on-disk catalog format the producing database was running when the segment was published. It is deliberately excluded from Self::lineage_matches; consumers accept an older annotation and reject a newer one via [validate_identity].

pub fn lineage_matches(self, other: SegmentIdentity) -> bool

True when the strict lineage fields (database id, primary generation, WAL format) match. catalog_version is intentionally ignored: it is a compatibility annotation that legitimately increases across a segment chain when a database activates a newer catalog format mid-stream.

pub fn validate(self) -> Result<()>

Trait Implementations

impl Clone for SegmentIdentity

fn clone(&self) -> SegmentIdentity

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for SegmentIdentity

impl Debug for SegmentIdentity

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

Formats the value using the given formatter.

impl Eq for SegmentIdentity

impl PartialEq for SegmentIdentity

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for SegmentIdentity