Skip to main content

ScanError

Enum ScanError 

Source
#[non_exhaustive]
pub enum ScanError { TaskFailed { panicked: bool, detail: String, }, WrongPhase, PlanChanged(PlanChanged), OptionChanged(OptionChanged), Evasion(EvasionError), TooFewDescriptors { limit: usize, needed: usize, }, }
Expand description

An error returned when a scan fails to run to completion.

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.
§

TaskFailed

The scan task did not run to completion.

Reached on a panic inside the engine or on the runtime shutting down under it. A stop through ScanHandle::abort still yields a report. A panic carries its message so the caller has something to report upstream.

Fields

§panicked: bool

Whether the task panicked; false if the runtime cancelled it.

§detail: String

What the panic said, or why the task was cancelled.

§

WrongPhase

The journal handed to a scan records the engine’s other phase.

A sweep counts addresses and a port scan counts address-and-port pairs, so one continued as the other would skip targets nothing ever probed.

§

PlanChanged(PlanChanged)

Available on crate feature journal-format only.

This run’s settings would not produce the plan the journal is counted in.

§

OptionChanged(OptionChanged)

Available on crate feature journal-format only.

This run asks for an option the job its journal records did not run under.

A sitting under a different technique, retry policy or set of passes answers a different question, and its results would be mixed into one report with the earlier sittings’. See JobOptions for which options are held, and JobOptions::apply_to for continuing a job under the ones it recorded.

§

Evasion(EvasionError)

The evasion profile is not one a scan could put on the wire.

Checked once before anything is sent, since a profile every probe refuses would report an empty network. See EvasionProfile::validate for what the check covers.

§

TooFewDescriptors

The process may hold too few file descriptors for a scan to keep a socket for its connections beside what the rest of the process needs, counting what it holds open when the scan starts where that can be counted.

Checked before anything is sent, since the scan’s connections and the process’s other files, a journal among them, would otherwise run out of descriptors partway through. The engine never raises the limit; a caller raises its own soft limit, within the hard one, before starting a scan.

Fields

§limit: usize

The soft limit the process has.

§needed: usize

The least limit a scan needs, beside what the process holds open.

Trait Implementations§

Source§

impl Coded for ScanError

Source§

fn code(&self) -> &'static str

A short, stable name for what went wrong. Read more
Source§

impl Debug for ScanError

Source§

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

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

impl Display for ScanError

Source§

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

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

impl Error for ScanError

Source§

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any. Read more
1.0.0 · Source§

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

1.0.0 · Source§

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

Source§

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)
Provides type-based access to context intended for error reports. Read more
Source§

impl From<EvasionError> for ScanError

Source§

fn from(source: EvasionError) -> Self

Converts to this type from the input type.
Source§

impl From<OptionChanged> for ScanError

Source§

fn from(source: OptionChanged) -> Self

Converts to this type from the input type.
Source§

impl From<PlanChanged> for ScanError

Source§

fn from(source: PlanChanged) -> Self

Converts to this type from the input type.

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> 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> ToString for T
where T: Display + ?Sized,

Source§

fn to_string(&self) -> String

Converts the given value to a String. 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