Struct HardwareInfo 

pub struct HardwareInfo {
    pub vendor: Option<Arc<str>>,
    /* private fields */
}

Physical hardware identification and auditing data for a network host.

HardwareInfo tracks multiple MAC addresses to support multi-NIC hosts and to detect “MAC hopping” on randomized devices.

Fields

vendor: Option<Arc<str>>

The hardware vendor identified from the MAC OUI (e.g., “Apple”, “Dell”).

This field should ideally be shared via an Arc to minimize heap allocations across thousands of identical host records.

Implementations

impl HardwareInfo

pub fn new(mac: MacAddr) -> Self

Creates a new HardwareInfo record for a specifically discovered MAC address.

The vendor is resolved automatically from the MAC’s OUI, if known.

pub fn add_mac(&mut self, mac: MacAddr)

Records a discovery event for a specific MAC address, updating its “last seen” timestamp.

If no vendor has been identified yet, this attempts to resolve one from the newly observed MAC’s OUI.

pub fn macs(&self) -> &BTreeMap<MacAddr, Instant>

Returns a read-only view of all recorded MAC addresses and their last-seen timestamps.

pub fn most_recent_mac(&self) -> Option<MacAddr>

Returns the MAC address that was most recently observed.

This is typically used to identify the primary hardware interface currently active on the network.

pub fn prune_stale_macs(&mut self, cutoff: Instant)

Removes all MAC address records that were last seen before the given cutoff.

This is a critical forensic cleanup step for long-running monitors in environments with aggressive MAC randomization, preventing memory exhaustion from “ghost” hardware records.

pub fn merge(&mut self, other: HardwareInfo)

Merges architectural findings from another hardware record.

MAC addresses are interleaved, with the newest timestamp prevailing for each unique address to prevent timeline regressions.

Trait Implementations

impl Clone for HardwareInfo

fn clone(&self) -> HardwareInfo

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HardwareInfo

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

Formats the value using the given formatter.

impl Eq for HardwareInfo

impl PartialEq for HardwareInfo

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for HardwareInfo