Struct GcRootSet 

pub struct GcRootSet {
    pub roots: Vec<GcRoot>,
    pub rejected: Vec<GcRootRejection>,
}

The validated, de-duplicated root set for one rch gc run.

Fields

roots: Vec<GcRoot>

Roots to scan, in a stable order: pooled remote base, pooled store base, configured extras, --root flags, then the worker temp base.

rejected: Vec<GcRootRejection>

Roots that failed validation and will NOT be scanned.

Implementations

impl GcRootSet

pub fn scan_bases(&self) -> Vec<String>

The client-resolvable roots, i.e. every root except the worker temp base. These are the paths handed to the remote enumeration/sweep scripts as $base.

pub fn attribute<'a>(&'a self, path: &str) -> Option<&'a GcRoot>

Look up which configured root a discovered absolute path belongs to.

Attribution is longest-prefix so a store_base nested inside remote_base still wins, and it is path-segment aware so /data/projects-old/x is never attributed to /data/projects. Returns None for a path under no configured root — in practice a dir found under the worker-resolved temp base.

NOTE: this matches the CONFIGURED spelling of each root. The remote scripts canonicalize their root with pwd -P and report it back (stale_target_reap::parse_scan_roots), so a caller holding those resolved paths — rch gc does — must match against them with path_is_under instead; a symlinked remote_base matches nothing here.

Trait Implementations

impl Clone for GcRootSet

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GcRootSet

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

Formats the value using the given formatter.

impl Eq for GcRootSet

impl PartialEq for GcRootSet

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for GcRootSet