Struct frida_gum::interceptor::Interceptor

pub struct Interceptor<'a> { /* fields omitted */ }

Function hooking engine interface.

Implementations

impl<'a> Interceptor<'a>

pub fn obtain<'b>(_gum: &'b Gum) -> Interceptor<'_> where
    'b: 'a, 

Obtain an Interceptor handle, ensuring that the runtime is properly initialized. This may be called as many times as needed, and results in a no-op if the Interceptor is already initialized.

pub fn attach<I: InvocationListener>(
    &mut self,
    f: NativePointer,
    listener: &mut I
) -> NativePointer

This is supported on crate feature invocation-listener only.

Attach a listener to the beginning of a function address.

Safety

The provided address must point to the start of a function in a valid memory region.

pub fn detach(&mut self, listener: NativePointer)

This is supported on crate feature invocation-listener only.

Detach an attached listener.

Safety

The listener must have been attached with Interceptor::attach().

pub fn begin_transaction(&mut self)

Begin an Interceptor transaction. This may improve performance if applying many hooks.

Safety

After placing hooks, the transaction must be ended with Interceptor::end_transaction().

pub fn end_transaction(&mut self)

End an Interceptor transaction. This must be called after placing hooks if in a transaction started with Interceptor::begin_transaction().