Enum SnapshotCreateOutcome 

pub enum SnapshotCreateOutcome {
    Created(Box<SnapshotCreateResult>),
    Unchanged,
}

What a kopia snapshot create actually did.

Two outcomes, both successes, and they are NOT interchangeable:

• Created — a new manifest exists and this run owns it.
• Unchanged — kopia declined to write one because the source is byte-identical to the previous snapshot (its retention knob ignoreIdenticalSnapshots). There is no new manifest, and crucially nothing this run may claim: the newest manifest for this identity belongs to the previous Snapshot CR, which owns it via a finalizer and will delete it when retention prunes that CR.

Modelled as an enum rather than Option<SnapshotCreateResult> so the distinction cannot be unwrap_or_default-ed away. Collapsing it is exactly the bug: a deduped run recorded as an ordinary success goes looking for “its” snapshot, finds its predecessor’s, and two CRs end up claiming one manifest (#351).

Variants

Created(Box<SnapshotCreateResult>)

kopia wrote a new manifest; this run owns it.

Boxed so the enum stays small: SnapshotCreateResult is ~320 bytes and Unchanged is zero-sized, and every caller moves the result out immediately.

Unchanged

kopia deduped: nothing changed, so no manifest was written and this run owns nothing. The previous snapshot remains the live restore point.

Trait Implementations

impl Clone for SnapshotCreateOutcome

fn clone(&self) -> SnapshotCreateOutcome

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SnapshotCreateOutcome

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

Formats the value using the given formatter.

impl Eq for SnapshotCreateOutcome

impl PartialEq for SnapshotCreateOutcome

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