dobby-hook-core 0.1.4

Dobby-like low-level inline hook core in Rust
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
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63

use core::ffi::{CStr, c_char, c_void};

mod backend;
mod imports;
mod instrument;
mod manager;

use crate::error::{Error, Result};

pub unsafe fn code_patch(address: *mut c_void, buffer: *const u8, buffer_size: u32) -> Result<()> {
    if address.is_null() || buffer.is_null() {
        return Err(Error::NullPointer);
    }
    backend::get().code_patch(address, buffer, buffer_size as usize)
}

pub unsafe fn hook(address: *mut c_void, fake_func: *mut c_void) -> Result<*mut c_void> {
    if address.is_null() || fake_func.is_null() {
        return Err(Error::NullPointer);
    }
    manager::hook(address, fake_func)
}

pub unsafe fn destroy(address: *mut c_void) -> Result<()> {
    if address.is_null() {
        return Err(Error::NullPointer);
    }
    manager::destroy(address)
}

pub unsafe fn symbol_resolver(
    image_name: *const c_char,
    symbol_name: *const c_char,
) -> *mut c_void {
    backend::get().symbol_resolver(image_name, symbol_name)
}

pub fn resolve_symbol(image_name: Option<&CStr>, symbol_name: &CStr) -> *mut c_void {
    unsafe {
        symbol_resolver(
            image_name.map_or(core::ptr::null(), CStr::as_ptr),
            symbol_name.as_ptr(),
        )
    }
}

pub fn import_table_replace(
    image_name: Option<&CStr>,
    symbol_name: &CStr,
    fake_func: *mut c_void,
) -> Result<*mut c_void> {
    if fake_func.is_null() {
        return Err(Error::NullPointer);
    }
    imports::import_table_replace(image_name, symbol_name, fake_func)
}

pub fn instrument(
    address: *mut c_void,
    pre_handler: unsafe fn(address: *mut c_void, context: *mut c_void),
) -> Result<()> {
    instrument::instrument(address, pre_handler)
}