Struct PinnedHashes 

pub struct PinnedHashes(/* private fields */);

Operator-pinned blob hashes (#276). Hashes here are excluded from the LRU eviction-candidate snapshot. Constructing this type is the only way to feed pinned hashes into CacheEngine::open_with_pinned or CacheEngine::set_pinned, so a future “blocklist” or similar HashSet<Hash>-shaped feature can’t be silently passed into the pinning slot.

Held as Arc<HashSet<Hash>> internally so reload paths that swap the active set don’t need to clone the underlying map.

Implementations

impl PinnedHashes

pub fn new(set: HashSet<Hash>) -> PinnedHashes

Build a PinnedHashes from a freshly parsed set.

pub fn empty() -> PinnedHashes

The empty pinned set.

pub fn len(&self) -> usize

Number of pinned hashes.

pub fn is_empty(&self) -> bool

Is the pinned set empty?

pub fn contains(&self, hash: &Hash) -> bool

Is hash pinned?

pub fn iter(&self) -> Iter<'_, Hash>

Iterate over the pinned hashes.

pub fn diff(&self, prev: &PinnedHashes) -> PinDiff

Compute counts of additions / removals between prev (older snapshot) and self (newer). Used by the SIGHUP reload path to log a diff line — operators pin/unpin individual hashes and want to see the delta in the success log without scraping the full set.

Trait Implementations

impl Clone for PinnedHashes

fn clone(&self) -> PinnedHashes

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PinnedHashes

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

Formats the value using the given formatter.

impl Default for PinnedHashes

fn default() -> PinnedHashes

Returns the “default value” for a type.

impl<'a> IntoIterator for &'a PinnedHashes

type Item = &'a Hash

The type of the elements being iterated over.

type IntoIter = Iter<'a, Hash>

Which kind of iterator are we turning this into?

fn into_iter(self) -> <&'a PinnedHashes as IntoIterator>::IntoIter

Creates an iterator from a value.