Skip to main content

NetworkRole

Enum NetworkRole 

Source
#[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
Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.
§

Router

Forwards traffic on behalf of other hosts.

Three independent proofs, since no one of them covers a whole network:

  1. 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.
  2. A router advertisement (ICMPv6 type 134), sent unprompted every few minutes while a segment sweep is listening.
  3. 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

Source

pub const ALL: &'static [Self]

Every role this build knows, in declaration order, which is the order label spells them in.

Every round trip through wire is tested over this, so a new variant fails those tests until it is spelled everywhere.

Source

pub const fn label(self) -> &'static str

How a role is written for a person to read.

Separate from network_role_name, the wire spelling: this may be reworded, that may not.

Acronyms are capitals and words are not, so a list reads router, DNS, DHCP.

Trait Implementations§

Source§

impl Clone for NetworkRole

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Copy for NetworkRole

Source§

impl Debug for NetworkRole

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Eq for NetworkRole

Source§

impl Hash for NetworkRole

Source§

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher. Read more
1.3.0 · Source§

fn hash_slice<H>(data: &[Self], state: &mut H)
where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher. Read more
Source§

impl Ord for NetworkRole

Source§

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other. Read more
1.21.0 (const: unstable) · Source§

fn max(self, other: Self) -> Self
where Self: Sized,

Compares and returns the maximum of two values. Read more
1.21.0 (const: unstable) · Source§

fn min(self, other: Self) -> Self
where Self: Sized,

Compares and returns the minimum of two values. Read more
1.50.0 (const: unstable) · Source§

fn clamp(self, min: Self, max: Self) -> Self
where Self: Sized,

Restrict a value to a certain interval. Read more
Source§

fn clamp_to<R>(self, range: R) -> Self
where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)
Restrict a value to a certain range. Read more
Source§

impl PartialEq for NetworkRole

Source§

fn eq(&self, other: &Self) -> bool

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=. Read more
Source§

impl PartialOrd for NetworkRole

Source§

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists. Read more
1.0.0 (const: unstable) · Source§

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator. Read more
1.0.0 (const: unstable) · Source§

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator. Read more
1.0.0 (const: unstable) · Source§

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator. Read more
1.0.0 (const: unstable) · Source§

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator. Read more
Source§

impl StructuralPartialEq for NetworkRole

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<'a, T, E> AsTaggedExplicit<'a, E> for T
where T: 'a,

Source§

fn explicit(self, class: Class, tag: u32) -> TaggedParser<'a, Explicit, Self, E>

Source§

impl<'a, T, E> AsTaggedImplicit<'a, E> for T
where T: 'a,

Source§

fn implicit( self, class: Class, constructed: bool, tag: u32, ) -> TaggedParser<'a, Implicit, Self, E>

Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<Q, K> Comparable<K> for Q
where Q: Ord + ?Sized, K: Borrow<Q> + ?Sized,

Source§

fn compare(&self, key: &K) -> Ordering

Compare self to key and return their ordering.
Source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

Source§

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.
Source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

Source§

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ

Converts 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 more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
where F: FnOnce(&Self) -> bool,

Converts 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
Source§

impl<T> Pointable for T

Source§

const ALIGN: usize

The alignment of pointer.
Source§

type Init = T

The type for initializers.
Source§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
Source§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
Source§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
Source§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
Source§

impl<T> PolicyExt for T
where T: ?Sized,

Source§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more
Source§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more