Enum GcPhaseKind 

pub enum GcPhaseKind {
    LockStore,
    CollectGcRoots,
    ComputeLiveSet,
    ScanStore,
    ComputeDeadSet,
    FilterByAgeAndSize,
    DeleteDeadPaths,
    UnlockStore,
    EmitReport,
    AttestRunToChain,
}

Closed set of GC phases.

Variants

LockStore

Acquire the global store lock to prevent concurrent builds from racing with the dead-set computation.

CollectGcRoots

Collect every GC root: profile generation links, gcroots directory, indirect roots, builder roots, --keep paths.

ComputeLiveSet

Compute the live set as the transitive closure of references reachable from the GC roots.

ScanStore

Enumerate every path in /nix/store.

ComputeDeadSet

Subtract live set from all paths to derive the dead set.

FilterByAgeAndSize

Apply policy filters: --delete-older-than, --max-freed, --keep-going. Some dead paths may survive a single GC if the operator’s policy caps the deletion rate.

DeleteDeadPaths

Delete dead paths from /nix/store. Recursively chmod -R u+w store entries that have read-only bits set, then unlink.

UnlockStore

Release the store lock.

EmitReport

Emit a typed GcReport (paths deleted, bytes freed, runtime) for operator surfacing.

AttestRunToChain

Optional: attest the GC run to the OutcomeChain so audit trails carry the deletion event. Skipped on hosts without the attestation layer.

Trait Implementations

impl Clone for GcPhaseKind

fn clone(&self) -> GcPhaseKind

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for GcPhaseKind

impl Debug for GcPhaseKind

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for GcPhaseKind

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for GcPhaseKind

impl Hash for GcPhaseKind

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for GcPhaseKind

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

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for GcPhaseKind