#[non_exhaustive]pub enum HostChange {
Status(Change<HostStatus>),
Hostname(Change<Option<String>>),
Names {
gained: Vec<HostName>,
lost: Vec<HostName>,
},
Addresses {
gained: Vec<IpAddr>,
lost: Vec<IpAddr>,
},
Os(Box<Change<Option<OsFingerprint>>>),
Macs {
gained: Vec<MacAddr>,
lost: Vec<MacAddr>,
},
Vendor(Change<Option<String>>),
Roles {
gained: Vec<NetworkRole>,
lost: Vec<NetworkRole>,
},
Filtering {
gained: Vec<Filtering>,
lost: Vec<Filtering>,
},
IpProtocols {
changed: Vec<IpProtocolChange>,
},
Findings {
appeared: Vec<Finding>,
resolved: Vec<Finding>,
reassessed: Vec<Reassessment>,
},
}Expand description
Something that moved about a host.
#[non_exhaustive] because new protocols let a scan establish more about a
host, and adding a variant should not need a major version.
Variants (Non-exhaustive)§
This enum is marked as non-exhaustive
Status(Change<HostStatus>)
Whether the host answers changed. A host that stopped answering moves to
Unknown; only an intermediary saying so produces
Down.
Hostname(Change<Option<String>>)
The resolved name changed.
Names
The names the host gave for itself changed, each list in the model’s order.
Compared only within the protocols the current scan heard names in. A
scan that opened no SMB session or read no directory established nothing
about those names, so a quick scan against a thorough one does not report
them lost. Os follows the same rule.
Fields
Addresses
The addresses the host answers at changed, each list ascending.
Fields
Os(Box<Change<Option<OsFingerprint>>>)
What the host was identified as running changed, or was first identified.
The same system at a different confidence is not a change, and a current
scan that identified nothing is not reported, so after is never None.
Boxed because a pair of fingerprints is several times the size of any other variant, and a change list is mostly the other variants.
Macs
The hardware addresses the host was seen at changed, each list ascending.
Only a scan that reached the link layer sees these, so both lists are empty when either scan did not.
Fields
Vendor(Change<Option<String>>)
The hardware vendor the address resolves to changed or was first named.
A current scan that named none is not reported, so after is never
None.
Roles
The roles inferred for the host changed, each list ascending.
Fields
gained: Vec<NetworkRole>Roles the current scan inferred and the baseline did not.
lost: Vec<NetworkRole>Roles the baseline inferred and the current scan does not.
Filtering
What the filter in front of the host was shown to be doing changed, each list ascending.
A verdict about the network path, such as a stateful filter appearing or one that stopped reassembling fragments.
Each conclusion comes from a comparative probe that runs only when asked
for, so both lists are empty when
characterise was off in
either scan.
Fields
IpProtocols
The IP protocols whose verdict moved, ascending by number.
Only the protocols both scans established something about. One that only
one scan asked about is a difference in what was asked, read the same way
as PortState::Unasked in
port. A scan that named a protocol and never reached it holds
IpProtocolState::Unasked for it.
Fields
changed: Vec<IpProtocolChange>What moved, ascending by protocol number.
Findings
Findings that appeared on the host, findings the current scan stopped claiming, and findings whose severity moved.
Paired by ClaimId, so a detection’s own version bump does not read as
one finding going away and another arriving.
Implementations§
Source§impl HostChange
impl HostChange
Sourcepub fn significance(&self) -> Significance
pub fn significance(&self) -> Significance
How much this change is worth somebody’s attention.
Matched with no wildcard, so a new kind of change fails to compile here until somebody decides what it is worth.
Trait Implementations§
Source§impl Clone for HostChange
impl Clone for HostChange
Source§impl Debug for HostChange
impl Debug for HostChange
Source§impl PartialEq for HostChange
impl PartialEq for HostChange
impl StructuralPartialEq for HostChange
Auto Trait Implementations§
impl Freeze for HostChange
impl RefUnwindSafe for HostChange
impl Send for HostChange
impl Sync for HostChange
impl Unpin for HostChange
impl UnsafeUnpin for HostChange
impl UnwindSafe for HostChange
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