Struct Host 

pub struct Host { /* private fields */ }

A comprehensive identity and state record for a network-reachable host.

A Host is the primary unit of work for the Zond scanner. It holds multi-homed IP data, forensic hardware IDs, and a history of network performance metrics.

Large metadata blocks (like OsFingerprint) are stored in Boxes to minimize the overall stack size of the Host struct.

Implementations

impl Host

pub fn new(primary_ip: IpAddr) -> Self

Creates a new Host centered around a primary IP address.

The initial status is always HostStatus::Unknown.

pub fn primary_ip(&self) -> IpAddr

Returns the primary IP address for this host.

pub fn ips(&self) -> &BTreeSet<IpAddr>

Returns all known IP addresses for this host.

pub fn hostname(&self) -> Option<&str>

Returns the resolved hostname, if any.

pub fn status(&self) -> HostStatus

Returns the current reachability status.

pub fn reasons(&self) -> &HashSet<StatusReason>

Returns all aggregated evidence for the current status.

pub fn os(&self) -> Option<&OsFingerprint>

Returns the identified operating system, if any.

pub fn hardware(&self) -> Option<&HardwareInfo>

Returns physical hardware information, if any.

pub fn telemetry(&self) -> &HostTelemetry

Returns network performance and path telemetry.

pub fn network_roles(&self) -> &HashSet<NetworkRole>

Returns inferred roles based on network location or discovered services.

pub fn scripts(&self) -> Option<&HashMap<String, String>>

Returns the map of scan script results.

pub fn first_seen(&self) -> SystemTime

Returns the timestamp of the first discovery event.

pub fn last_seen(&self) -> SystemTime

Returns the timestamp of the most recent discovery or update event.

pub fn set_primary_ip(&mut self, ip: IpAddr)

Updates the primary IP, ensures it exists in the ips set, and bumps the last_seen timestamp.

pub fn add_ip(&mut self, ip: IpAddr) -> bool

Adds a new IP address to the host’s record and bumps last_seen. Returns true if the IP was newly added.

pub fn extend_ips(&mut self, ips: impl IntoIterator<Item = IpAddr>)

Adds multiple IP addresses to the host’s record and bumps last_seen.

pub fn set_hostname(&mut self, hostname: Option<String>)

Sets the host’s hostname and bumps last_seen.

pub fn set_status(&mut self, status: HostStatus)

Updates the reachability status and bumps last_seen.

pub fn add_reason(&mut self, reason: StatusReason)

Adds a status reason and bumps last_seen.

pub fn set_os(&mut self, os: OsFingerprint)

Sets the OS fingerprint and bumps last_seen.

pub fn set_hardware(&mut self, hardware: HardwareInfo)

Sets the hardware info and bumps last_seen.

pub fn with_mac(self, mac: MacAddr) -> Self

Builder method to set the hardware MAC and return Self.

pub fn add_rtt(&mut self, rtt: Duration)

Adds a single RTT measurement and bumps last_seen.

pub fn with_rtt(self, rtt: Duration) -> Self

Builder method to add a single RTT measurement and return Self.

pub fn set_rtts(&mut self, rtts: impl IntoIterator<Item = Duration>)

Adds multiple RTT measurements and bumps last_seen.

pub fn add_network_role(&mut self, role: NetworkRole)

Adds a network role and bumps last_seen.

pub fn add_script_result(&mut self, key: String, value: String)

Adds or updates a script result and bumps last_seen.

pub fn min_rtt(&self) -> Option<Duration>

Returns the minimum recorded RTT.

pub fn max_rtt(&self) -> Option<Duration>

Returns the maximum recorded RTT.

pub fn average_rtt(&self) -> Option<Duration>

Returns the average recorded RTT.

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

Returns the most recent MAC address, if hardware info is available.

pub fn vendor(&self) -> Option<&str>

Returns the hardware vendor, if hardware info is available.

pub fn is_alive(&self) -> bool

Returns true if this host is confirmed to be on the network (either fully responding or filtered).

pub fn ports(&self) -> impl Iterator<Item = &Port>

Returns an iterator over all discovered ports in sorted order.

pub fn port_count(&self) -> usize

Returns the total number of recorded ports for this host.

pub fn add_port(&mut self, new_port: Port)

Ingests a new port finding.

If the port is already known, it is merged with the existing record. If the total port count exceeds MAX_PORTS_PER_HOST, the port is ignored and the host is assigned the NetworkRole::Tarpit role.

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

Merges architectural findings from another Host record.

This is the core aggregation method of the library, used to combine results from multiple asynchronous scan stages into a single truth.

• Status is promoted based on semantic ordering.
• Telemetry and OS data are merged using their respective logic.
• Port caps are enforced during aggregation.

Trait Implementations

impl Clone for Host

fn clone(&self) -> Host

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Host

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

Formats the value using the given formatter.

impl Display for Host

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

Formats the value using the given formatter.