Struct ScanTimer 

pub struct ScanTimer { /* private fields */ }

Manages the loop lifecycle and operational boundaries for network scanning operations.

ScanTimer tracks hard deadlines, enforces minimum runtimes, and aborts loops early if a period of network “silence” (time since the last relevant packet) exceeds a configured maximum.

Implementations

impl ScanTimer

pub fn new( max_total_duration: Duration, min_runtime_duration: Duration, max_silence: Duration, ) -> Self

Constructs a new ScanTimer with the specified operational limits.

Arguments

• max_total_duration - The absolute maximum time the scan is allowed to run.
• min_runtime_duration - The absolute minimum time the scan must run before it can abort due to silence.
• max_silence - The maximum duration of network silence allowed after the minimum runtime is reached.

pub fn mark_activity(&mut self)

Resets the internal “silence” tracker.

This should be called whenever a relevant packet or activity is observed on the network.

pub fn time_until_next_tick(&self) -> Duration

Calculates how long to wait for the next timeout event.

Returns a fallback duration (e.g., 100ms) if the maximum silence period has already been exceeded.

pub fn has_expired(&self) -> bool

Checks if the entire operation should abort due to hard limits or excessive silence.

Returns true if:

1. The current time has exceeded the hard_deadline.
2. The min_runtime has elapsed AND the time since the last recorded activity exceeds max_silence.

pub fn should_break_on_timeout(&self) -> bool

Helper to decide if a socket timeout is fatal or if the scan should continue.

Returns true if the minimum runtime has been met, indicating that a timeout could be a valid reason to break the loop.

Trait Implementations

impl Clone for ScanTimer

fn clone(&self) -> ScanTimer

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ScanTimer

impl Debug for ScanTimer

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

Formats the value using the given formatter.