diversion 0.1.0

Ergonomic function hooks for Windows and Linux
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47

use std::io;

use closure_ffi_iced_x86::IcedError;
use thiserror::Error;

/// The error type returned by functions in this crate.
#[derive(Debug, Error)]
pub enum Error {
    #[error("failed to acquire diversion process context: {0}")]
    ProcessContext(io::Error),

    #[error("memory protection error at {addr:x}: {err}")]
    Protection { addr: usize, err: io::Error },

    #[error(
        "failed to disassemble function at {addr:x} ({bytes:x?}): all instructions failed to decode"
    )]
    Disassembly { addr: usize, bytes: [u8; 16] },

    #[error(
        "failed to disassemble function at {addr:x} ({bytes:x?}): function is too short to hook safely"
    )]
    TooShort { addr: usize, bytes: [u8; 16] },

    #[error("failed to allocate memory nearby {addr:x}: {err}")]
    Alloc { addr: usize, err: io::Error },

    #[error("failed to encode instructions for trampoline at {addr:x}: {err}")]
    Encode { addr: usize, err: IcedError },

    #[error(
        "failed to encode instructions for trampoline at {addr:x}: encoding is too long ({size} bytes)"
    )]
    EncodeSize { addr: usize, size: usize },

    #[error("failed to suspend other threads: {0}")]
    Suspend(io::Error),
}

impl Error {
    pub fn oom(addr: usize) -> Self {
        Self::Alloc {
            addr,
            err: io::ErrorKind::OutOfMemory.into(),
        }
    }
}