Struct GenerationManifest 

pub struct GenerationManifest<'a> {
    pub base_snapshot_key: &'a str,
    pub page_size: usize,
    pub checkpoint_seq: u32,
    pub salt: Option<WalSalt>,
    pub first_frame: u64,
    pub last_frame: u64,
    pub epoch: u64,
    pub owner: Option<&'a str>,
    pub frame_batches: &'a [(u64, u64)],
}

In-memory shape of a generation manifest. Format on disk:

TURSO-BACKUP STREAM v4
base_snapshot <key>
page_size <n>
checkpoint_seq <n>
wal_salt <salt1>-<salt2>
first_frame <n>
last_frame <n>
epoch <n>
owner <label>        (optional)
frame_batch <first>-<last>   (one per batch object, ascending, gap-free)

Text, dependency-free (no serde), one field per line. Mirrors the dedup::Manifest convention so the crate stays consistent.

R732-F2 added epoch/owner and moved the header to v2. R761-F2 added the frame_batch list and moved it to v3. R858-B19 added wal_salt and moved it to v4. Older manifests still parse — v1 with epoch = 0, owner = None; v1/v2 with no batch list, which is what marks their frames as living one-per-object; v1/v2/v3 with salt = None — so backups written before any of those changes stay parseable. No older version is ever written any more.

R858-B19, and this is the one place a legacy manifest is not merely second-class: a chain of two or more manifests where any of them lacks a salt is refused by [validate_generation_chain], because a pre-R858-B19 writer could splice two WAL generations into a contiguous-looking chain and nothing in the manifest records which WAL each range came from. A single-manifest chain is still restored — one generation cannot be a splice.

Fields

base_snapshot_key: &'a str

page_size: usize

checkpoint_seq: u32

salt: Option<WalSalt>

R858-B19: the WAL header salt these frames were read under — the field that actually names the generation, since checkpoint_seq resets to 0 across a writer restart. None only when re-formatting a pre-R858-B19 manifest; tail_frames always has one.

first_frame: u64

last_frame: u64

epoch: u64

R732-F2: the fencing epoch this generation was written under. 0 means it predates fencing (a v1 manifest), which is also the key shape its frames live under — see BackupTarget::frame_key.

owner: Option<&'a str>

R732-F2: opaque owner label, diagnostic only. See StreamConfig::owner.

frame_batches: &'a [(u64, u64)]

R761-F2: the (first, last) frame range of each batch object holding this generation’s frames, ascending and exactly tiling first_frame..=last_frame. Empty means the pre-batching layout (one object per frame); a writer emits it empty only when re-formatting a legacy manifest.

Trait Implementations

impl<'a> Clone for GenerationManifest<'a>

fn clone(&self) -> GenerationManifest<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for GenerationManifest<'a>

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

Formats the value using the given formatter.

impl<'a> Eq for GenerationManifest<'a>

impl<'a> PartialEq for GenerationManifest<'a>

fn eq(&self, other: &GenerationManifest<'a>) -> bool

Equality operator ==.

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

Inequality operator !=.

impl<'a> StructuralPartialEq for GenerationManifest<'a>