#[non_exhaustive]pub enum NetworkRole {
Router,
DnsServer,
DhcpServer,
NtpServer,
SnmpAgent,
DomainController,
Switch,
Origin,
Tarpit,
Truncated,
}Expand description
What a host turned out to be, beyond an address with ports on it.
Most variants name a function the network depends on (forwarding, naming, addressing); the last three are claims about the record. A reader can act on either without reading anything else about the host.
A role is never a port number restated: an open port 80 is
Port::service, which carries a confidence.
Every role is concluded from evidence in its own protocol (an advertisement that
says it forwards, a DNS message that parses as a response, a DHCP server naming
itself), so it needs no confidence of its own.
A variant nothing assigns yet says so in its documentation, since an empty roles
array would otherwise read as “checked, none”.
ALL is the list to iterate.
Variants (Non-exhaustive)§
This enum is marked as non-exhaustive
Router
Forwards traffic on behalf of other hosts.
Three independent proofs, since no one of them covers a whole network:
- A neighbour advertisement with the R flag set (RFC 4861 §4.4). The host is answering an ordinary discovery probe and saying, in the same message, that it routes.
- A router advertisement (ICMPv6 type 134), sent unprompted every few minutes while a segment sweep is listening.
- This machine’s own routing table. The address is a default gateway of an interface the scan runs on. The only proof on an IPv4-only segment.
Not called a gateway: a gateway is somebody’s next hop, which is relational. These proofs establish only that the box forwards.
DnsServer
Answered a query on port 53 with a message that parses as a DNS response.
The reply is the evidence, not the open port. The engine’s UDP probe for port 53 carries a real question, so a resolver ordinarily answers.
mDNS and LLMNR (5353, 5355) do not count: nearly every laptop and printer answers them.
DhcpServer
Answered a DHCP message as a server.
The engine sends a DHCPINFORM, which asks for configuration without asking for
an address, and reads the server identifier (option 54) from the reply. The role
goes on that address only when the reply also came from it; behind a relay agent
the two differ.
Port state cannot show it: UDP/67 is OpenOrNoReply on silence like any UDP
port.
NtpServer
Answered with a valid NTP response, so it serves time.
Nothing assigns this yet: the probe for port 123 goes out, but the reply is not yet read as NTP.
SnmpAgent
Answered SNMP, so it is managed over it.
Nothing assigns this yet: the reply to the probe for port 161 is parsed for operating-system evidence, but no strategy concludes the role from it.
DomainController
Answered a NetBIOS node-status request with a name table holding a suffix only a domain controller registers.
<1C> is registered as a group name by every controller in a domain and nothing
else, and <1B> as a unique name by the domain master browser. Either identifies
the machine from one unauthenticated datagram.
The reply is the evidence, as for DnsServer. A role because
it is a fact about the machine, which also speaks SMB, LDAP and Kerberos as
separate services.
<20> (the server service) and <00> (every NetBIOS host) do not count.
Switch
Switches frames on behalf of the machines attached to it.
Concluded from the device’s own announcement (LLDP’s bridge capability, or CDP’s switch, transparent-bridge or source-route-bridge bits), and only where the capability is enabled. A switch with an unconfigured routing licence advertises routing as supported but not enabled; reading the wrong half would put a router on every access switch.
Testimony, like DhcpServer, where Router
and DnsServer are observed behaviour. Anything on a segment
can send either, so neither is evidence about a distant machine; see
crate::protocols::lldp.
Still worth having: a switch usually presents no open port and often holds no address, so a scan otherwise cannot see it.
Origin
The machine this scan is running from.
A sweep of the scanner’s own segment reaches it, and its record is unusual: services answer over loopback, latency is not a network measurement, and no probe crossed a wire.
Read from this machine’s interface addresses, without sending anything.
Tarpit
Reported more ports open than any machine plausibly runs services on.
Past TARPIT_OPEN_PORTS the host is answering everything, so its open ports
are not findings to act on. A deliberate tarpit and a middlebox answering by
accident look the same from here.
Truncated
Answered on more ports than this record will hold, so the port list is incomplete.
A claim about the scan: MAX_PORTS_PER_HOST was reached and later ports were
dropped. Separate from Tarpit, which is about the host.
No scan this build can run assigns it; see MAX_PORTS_PER_HOST.
Implementations§
Source§impl NetworkRole
impl NetworkRole
Trait Implementations§
Source§impl Clone for NetworkRole
impl Clone for NetworkRole
impl Copy for NetworkRole
Source§impl Debug for NetworkRole
impl Debug for NetworkRole
impl Eq for NetworkRole
Source§impl Hash for NetworkRole
impl Hash for NetworkRole
Source§impl Ord for NetworkRole
impl Ord for NetworkRole
1.21.0 (const: unstable) · Source§fn max(self, other: Self) -> Selfwhere
Self: Sized,
fn max(self, other: Self) -> Selfwhere
Self: Sized,
1.21.0 (const: unstable) · Source§fn min(self, other: Self) -> Selfwhere
Self: Sized,
fn min(self, other: Self) -> Selfwhere
Self: Sized,
Source§impl PartialEq for NetworkRole
impl PartialEq for NetworkRole
Source§impl PartialOrd for NetworkRole
impl PartialOrd for NetworkRole
impl StructuralPartialEq for NetworkRole
Auto Trait Implementations§
impl Freeze for NetworkRole
impl RefUnwindSafe for NetworkRole
impl Send for NetworkRole
impl Sync for NetworkRole
impl Unpin for NetworkRole
impl UnsafeUnpin for NetworkRole
impl UnwindSafe for NetworkRole
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<Q, K> Comparable<K> for Q
impl<Q, K> Comparable<K> for Q
Source§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
Source§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
key and return true if they are equal.Source§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
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