Enum Error 

#[non_exhaustive]
pub enum Error {
    AlreadyHooked {
        address: usize,
    },
    NotEnoughSpace {
        address: usize,
    },
    UnrelocatableInstruction {
        address: usize,
    },
    InvalidInstruction {
        address: usize,
    },
    NoNearMemory {
        address: usize,
    },
    NotExecutable {
        address: usize,
    },
    SameAddress {
        address: usize,
    },
    TargetModified {
        address: usize,
    },
    ThreadNotRelocatable,
    Assembly {
        address: usize,
        reason: String,
    },
    Os(OsError),
    InvalidPattern {
        pattern: String,
        position: usize,
    },
    PatternNotFound {
        pattern: String,
    },
    PatternNotUnique {
        pattern: String,
        matches: usize,
    },
    ModuleNotFound {
        name: String,
    },
}

Everything that can go wrong when finding, installing, enabling or disabling a hook.

Variants about a specific location carry its address, and those about a scan its pattern or module, which the Display message names.

Variants (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.

AlreadyHooked

A detour or injection is already installed at this address; hooks aren’t chained.

Fields

address: usize

The address that is already hooked.

NotEnoughSpace

The target is too small to patch and has no usable padding or hot-patch area.

Fields

address: usize

The address that could not be patched.

UnrelocatableInstruction

A displaced instruction can’t be relocated to the trampoline, such as a relative branch that would be out of range.

Fields

address: usize

The address of the offending instruction.

InvalidInstruction

The target does not begin with a valid instruction.

Fields

address: usize

The address that could not be decoded.

NoNearMemory

No executable memory could be allocated within branch range of the target.

Fields

address: usize

The address no nearby memory could be found for.

NotExecutable

The address is not executable memory.

Fields

address: usize

The address that is not executable.

SameAddress

The target and the detour are the same address.

Fields

address: usize

The shared address.

TargetModified

A third party changed the code at the address since the hook was installed, so it can’t be toggled safely.

Fields

address: usize

The address whose code was modified.

ThreadNotRelocatable

A thread suspended for patching is running code that can’t be relocated.

Assembly

The assembly supplied to an injection could not be encoded.

Fields

address: usize

The address the injection was being built for.

reason: String

The assembler’s message, prefixed with the instruction’s position when one instruction is invalid.

Os(OsError)

An operating system call failed, such as changing memory protection or suspending a thread.

InvalidPattern

A scan pattern can’t be parsed, or doesn’t spell out the call that follow_call needs.

Fields

pattern: String

The pattern as given.

position: usize

The byte position in pattern where it goes wrong.

PatternNotFound

A pattern matched nowhere in the module’s code.

Fields

pattern: String

The pattern as given.

PatternNotUnique

A pattern matched more than once, so it can’t tell which place is meant.

Fields

pattern: String

The pattern as given.

matches: usize

How many times it matched.

ModuleNotFound

No loaded module has the name a scan was given.

Fields

name: String

The module name as given.

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Eq for Error

impl Error for Error

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

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

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

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

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.

impl PartialEq for Error

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Error