#[non_exhaustive]pub struct ProbeTuning {
pub send_mode: SendMode,
pub retry: RetryConfig,
pub max_probe_rate: Option<NonZeroU32>,
pub min_probe_rate: Option<NonZeroU32>,
pub tcp_technique: TcpScanTechnique,
pub sctp_technique: SctpScanTechnique,
pub os_detection: OsDetection,
pub service_detection: ServiceDetection,
pub evasion: EvasionProfile,
pub icmp_evidence: bool,
pub send_source: Vec<IpAddr>,
}Expand description
The knobs a probing strategy is built from, carried together so adding one does not change every constructor.
Not every strategy reads every field: local discovery builds its own Ethernet frames
and ignores SendMode, while every strategy that sends a probe uses
RetryConfig. max_probe_rate is read by routed host discovery and the raw port
scanners: the sweep and the UDP scan are paced by it, while a TCP port scan paces
itself by a congestion window and treats it only as a ceiling. The unprivileged paths
pace themselves by their connection concurrency.
Built by ZondConfig::probe_tuning and, in tests, from Default.
Fields (Non-exhaustive)§
This struct is marked as non-exhaustive
Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.send_mode: SendModeWhich layer a strategy puts its probes on the wire through, where it has the choice.
retry: RetryConfigHow many attempts a probe gets and how long each waits, as an effort level with optional overrides.
max_probe_rate: Option<NonZeroU32>The most probes per second a strategy may emit, or None for the pacing
each one arrives at on its own.
Non-zero, since a ceiling of zero probes per second would be no scan at all.
min_probe_rate: Option<NonZeroU32>The fewest probes per second a strategy should emit, or None for
whatever pace it arrives at.
Read in the same places as max_probe_rate: a floor
under a pace where the rate is the pace, and a floor under a ceiling where it is
only a ceiling. Non-zero, since a floor of zero is what None already says.
tcp_technique: TcpScanTechniqueWhich segment a TCP port probe carries. Read only by the raw TCP port scanner; host discovery always uses SYN, since the other techniques are no better at finding whether anything is there.
sctp_technique: SctpScanTechniqueWhich chunk an SCTP port probe carries. Read only by the raw SCTP port scanner; a sweep always sends an INIT, since a COOKIE-ECHO draws nothing from the open port a sweep hopes to hear from.
os_detection: OsDetectionHow far a strategy may go to identify the operating system behind a host.
Read by the raw TCP port scanner, where the replies that carry a stack’s shape
arrive. At OsDetection::Passive it changes no packet and no timing.
service_detection: ServiceDetectionHow far a strategy may go to name what is behind an open port.
Read by every strategy that fingerprints: the raw scanners, as a second pass over the ports they found, and the connect scanner, inline over the connection it already holds. Turning it off means neither completes a connection for identification.
evasion: EvasionProfileWhat the caller has chosen to change about the probes each strategy emits.
A default profile is inert. Read wherever a strategy chooses a probe field a
caller may override; the conversations that follow a probe over their own
connections ignore it. See EvasionProfile, and
what a profile shapes.
icmp_evidence: boolWhether the capture admits ICMP errors for a technique that finds open
and closed ports without them. See ZondConfig::icmp_evidence.
send_source: Vec<IpAddr>Source addresses to force, one per family. See
ZondConfig::send_source.
Trait Implementations§
Source§impl Clone for ProbeTuning
impl Clone for ProbeTuning
Source§impl Debug for ProbeTuning
impl Debug for ProbeTuning
Auto Trait Implementations§
impl Freeze for ProbeTuning
impl RefUnwindSafe for ProbeTuning
impl Send for ProbeTuning
impl Sync for ProbeTuning
impl Unpin for ProbeTuning
impl UnsafeUnpin for ProbeTuning
impl UnwindSafe for ProbeTuning
Blanket Implementations§
Source§impl<'a, T, E> AsTaggedExplicit<'a, E> for Twhere
T: 'a,
impl<'a, T, E> AsTaggedExplicit<'a, E> for Twhere
T: 'a,
Source§impl<'a, T, E> AsTaggedImplicit<'a, E> for Twhere
T: 'a,
impl<'a, T, E> AsTaggedImplicit<'a, E> for Twhere
T: 'a,
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§impl<T> Instrument for T
impl<T> Instrument for T
Source§fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
Source§fn in_current_span(self) -> Instrumented<Self> ⓘ
fn in_current_span(self) -> Instrumented<Self> ⓘ
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read more