Struct PathSet 

pub struct PathSet { /* private fields */ }

A bounded set of alternative paths for a single destination.

paths[0] is always the primary (best) path. Ranking: lowest hops first, then most-recent timestamp.

Implementations

impl PathSet

pub fn from_single(entry: PathEntry, capacity: usize) -> Self

Create a new PathSet containing a single path.

pub fn primary(&self) -> Option<&PathEntry>

Access the primary (best) path, if any.

pub fn primary_mut(&mut self) -> Option<&mut PathEntry>

Mutable access to the primary path.

pub fn is_empty(&self) -> bool

Whether the set contains any paths.

pub fn len(&self) -> usize

Number of stored paths.

pub fn iter(&self) -> impl Iterator<Item = &PathEntry>

Iterator over all paths (primary first).

pub fn upsert(&mut self, entry: PathEntry)

Insert or update a path entry.

• If a path with the same next_hop already exists, it is replaced in-place.
• Otherwise the entry is added as an alternative. If at capacity the worst path (highest hops, then oldest) is evicted.

After mutation the vector is re-sorted so paths[0] remains the best.

pub fn failover(&mut self, remove: bool)

Promote the next-best path after the current primary becomes unresponsive.

If remove is true the old primary is discarded; otherwise it is moved to the back of the list (it may recover later).

pub fn cull( &mut self, now: f64, interface_exists: impl Fn(&InterfaceId) -> bool, )

Remove expired or orphaned paths.

interface_exists is a predicate that checks whether an interface is still registered.

pub fn retain(&mut self, predicate: impl Fn(&PathEntry) -> bool)

Filter paths by a predicate, keeping only those that match.

pub fn expire_all(&mut self)

Expire all paths in this set (set timestamp/expires to 0).

pub fn all_random_blobs(&self) -> Vec<[u8; 10]>

Collect all random_blobs across every path in this set.

pub fn find_by_next_hop(&self, next_hop: &[u8; 16]) -> Option<&PathEntry>

Find the path entry that matches a given next_hop, if any.

Trait Implementations

impl Clone for PathSet

fn clone(&self) -> PathSet

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PathSet

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

Formats the value using the given formatter.