Struct SnapshotPinRegistry 

pub struct SnapshotPinRegistry { /* private fields */ }

Registry of filesystem snapshot paths that must be excluded from GC.

When the HNSW index or the knowledge-base is flushed to disk the resulting file path should be registered here so the OrphanGarbageCollector (and any future full GC pass) can honour the exclusion without needing to understand the internal format of those files.

The registry holds std::path::PathBufs rather than CIDs because snapshot files are not (yet) tracked as content-addressed blocks in the primary block store.

Implementations

impl SnapshotPinRegistry

pub fn new() -> Self

Create an empty registry.

pub fn pin_snapshot(&mut self, path: PathBuf)

Mark path as pinned so it is not eligible for GC removal.

pub fn unpin_snapshot(&mut self, path: &Path)

Remove path from the pin registry, making it eligible for GC.

No-ops silently if path is not currently pinned.

pub fn is_pinned(&self, path: &Path) -> bool

Return true if path is currently registered as pinned.

pub fn pinned_count(&self) -> usize

Number of paths currently pinned in this registry.

pub fn pinned_paths(&self) -> impl Iterator<Item = &PathBuf>

Iterate over all pinned paths in arbitrary order.

pub fn is_empty(&self) -> bool

Return true when the registry holds no pinned paths.

Trait Implementations

impl Default for SnapshotPinRegistry

fn default() -> Self

Returns the “default value” for a type.