Struct HookGuard 

pub struct HookGuard<A: Architecture> { /* private fields */ }

RAII guard for an installed inline hook

when dropped, automatically restores the original function bytes unless leak() was called.

Implementations

impl<A: Architecture> HookGuard<A>

pub fn target(&self) -> usize

get the target (hooked) function address

pub fn detour(&self) -> usize

get the detour function address

pub fn trampoline(&self) -> Option<usize>

get the trampoline address (call this to invoke the original function)

returns None if no trampoline was allocated

pub fn original_bytes(&self) -> &[u8]

get the original bytes that were overwritten

pub fn will_auto_restore(&self) -> bool

check if auto-restore is enabled

pub fn set_auto_restore(&mut self, restore: bool)

set whether to auto-restore on drop

pub fn leak(self)

disable auto-restore and keep the hook active permanently

consumes the guard without restoring the original function. the trampoline memory is leaked and remains valid.

pub fn restore(self) -> Result<()>

manually restore the original function

consumes the guard and restores the hooked function to its original state.

pub fn disable(&mut self) -> Result<()>

temporarily disable the hook

restores original bytes but keeps the guard and trampoline alive for re-enabling later.

pub fn enable(&mut self, hook_bytes: &[u8]) -> Result<()>

re-enable a previously disabled hook

writes the hook stub back to the target function.

Trait Implementations

impl<A: Architecture> Drop for HookGuard<A>

fn drop(&mut self)

Executes the destructor for this type.

impl<A: Architecture> Send for HookGuard<A>

impl<A: Architecture> Sync for HookGuard<A>