Struct InjectionBuilder 

pub struct InjectionBuilder { /* private fields */ }

An injection builder holding the target address, returned by Injection::at.

Implementations

impl InjectionBuilder

pub fn code(self, code: &[u8]) -> InjectionWith

Injects the caller’s own machine code at the target.

The bytes are copied, so the slice needn’t outlive this call. The code must follow the ABI rules of install.

pub fn asm<F>(self, build: F) -> InjectionWith

where F: FnOnce(&mut CodeAssembler) -> Result<(), IcedError> + 'static,

Injects machine code written as assembly.

build appends to an asm::CodeAssembler; pass Rust values as operands, e.g. a.mov(rax, some_addr). It’s assembled at the stub’s real address, so rip-relative operands resolve, and the jump back is appended. The ABI rules of install apply.

pub fn inspect<F>(self, callback: F) -> InjectionWith

where F: Fn(&Context) + Send + Sync + 'static,

Injects a callback that reads the registers at the target.

callback gets the saved Context, then the original code resumes unchanged. It may run on several threads at once; see Injection.

pub fn modify<F>(self, callback: F) -> InjectionWith

where F: Fn(&mut Context) + Send + Sync + 'static,

Injects a callback that can change the registers at the target.

Like inspect, but register writes take effect before the original code resumes. Changing rip jumps there instead, skipping the displaced instructions.