Struct Hook 

pub struct Hook { /* private fields */ }

An installed inline hook that redirects a target function to a detour.

The hook overwrites the first few bytes of the target function with a jump to the detour. A trampoline is allocated nearby containing the original instructions and a jump back, allowing the detour to call the original.

The hook is automatically removed when dropped.

Implementations

impl Hook

pub unsafe fn install(target: *const u8, detour: *const u8) -> Result<Self>

Install an inline hook at target, redirecting calls to detour.

Returns a Hook whose trampoline can be used to call the original function.

Safety

• target must point to the start of a callable function in executable memory.
• detour must be a function with the same calling convention and signature.
• No thread may be executing the first 14 bytes of target during this call.

pub fn trampoline(&self) -> *const u8

Returns a pointer to the trampoline that calls the original function.

Transmute this to the original function’s type to call it:

let original: extern "C" fn(i32) -> i32 = std::mem::transmute(hook.trampoline());

pub unsafe fn unhook(&mut self) -> Result<()>

Remove the hook, restoring the original function bytes.

Safety

No thread may be executing the trampoline or the patched region of the target.

Trait Implementations

impl Drop for Hook

fn drop(&mut self)

Executes the destructor for this type.

impl Send for Hook

impl Sync for Hook