Struct Layer1Guards 

pub struct Layer1Guards {
    pub guards: HashMap<String, Layer1Stats>,
    pub num_layer1: u8,
}

Layer 1 guard tracking.

Tracks connections and usage for entry guards. Monitors for anomalies such as too many or too few guard connections, or unexpected guard usage.

Example

use vanguards_rs::pathverify::Layer1Guards;

let mut guards = Layer1Guards::new(2);

// Track a guard connection
guards.add_conn("AABBCCDD00112233445566778899AABBCCDDEEFF");
assert!(guards.contains("AABBCCDD00112233445566778899AABBCCDDEEFF"));

// Track guard usage
guards.add_use_count("AABBCCDD00112233445566778899AABBCCDDEEFF");

See Also

• Layer1Stats - Statistics for individual guards
• PathVerify - Uses this for layer 1 tracking

Fields

guards: HashMap<String, Layer1Stats>

Guard statistics by fingerprint.

num_layer1: u8

Expected number of layer 1 guards.

Implementations

impl Layer1Guards

pub fn new(num_layer1: u8) -> Self

Creates a new Layer1Guards tracker.

pub fn add_conn(&mut self, guard_fp: &str)

Adds a connection to a guard.

pub fn del_conn(&mut self, guard_fp: &str)

Removes a connection from a guard.

pub fn check_conn_counts(&self) -> i32

Checks connection counts and logs warnings.

Returns -1 when fewer than expected, 0 when correct, +1 when too many.

pub fn add_use_count(&mut self, guard_fp: &str)

Adds a use count for a guard.

pub fn check_use_counts(&self) -> i32

Checks use counts and logs warnings.

Returns -1 when fewer than expected, 0 when correct, +1 when too many.

pub fn contains(&self, guard_fp: &str) -> bool

Returns true if the guard is tracked.

Trait Implementations

impl Clone for Layer1Guards

fn clone(&self) -> Layer1Guards

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Layer1Guards

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

Formats the value using the given formatter.