Struct Instruction

pub struct Instruction<'a> { /* private fields */ }

Wrapper structure for a qemu_plugin_insn *

Safety

This structure is safe to use as long as the pointer is valid. The pointer is always opaque, and therefore may not be dereferenced.

Implementations

impl<'a> Instruction<'a>

pub fn data(&self) -> Vec<u8>

Returns the data for this instruction. This method may only be called inside the callback in which the instruction is obtained, but the resulting data is owned.

pub fn size(&self) -> usize

Returns the size of the data for this instruction

pub fn vaddr(&self) -> u64

Returns the virtual address of this instruction

pub fn haddr(&self) -> u64

Returns the hardware (physical) address of this instruction

pub fn disas(&self) -> Result<String>

Returns the textual disassembly of this instruction

pub fn symbol(&self) -> Result<Option<String>>

Returns the symbol associated with this instruction, if one exists and the binary contains a symbol table

pub fn register_execute_callback<F>(&self, cb: F)

where F: FnMut(VCPUIndex) + Send + Sync + 'static,

Register a callback to be run on execution of this instruction

pub fn register_execute_callback_flags<F>(&self, cb: F, flags: CallbackFlags)

where F: FnMut(VCPUIndex) + Send + Sync + 'static,

Register a callback to be run on execution of this instruction

pub fn register_memory_access_callback<F>(&self, cb: F, rw: MemRW)

where F: FnMut(VCPUIndex, MemoryInfo<'_>, u64) + Send + Sync + 'static,

Register a callback to be run on memory access of this instruction

Arguments

• cb: The callback to be run
• rw: The type of memory access to trigger the callback on

pub fn register_memory_access_callback_flags<F>( &self, cb: F, rw: MemRW, flags: CallbackFlags, )

where F: FnMut(VCPUIndex, MemoryInfo<'_>, u64) + Send + Sync + 'static,

Register a callback to be run on memory access of this instruction

Arguments

• cb: The callback to be run
• rw: The type of memory access to trigger the callback on