Struct CpuX86

pub struct CpuX86 { /* private fields */ }

An X86 emulator instance.

Implementations

impl CpuX86

pub fn new(mode: Mode) -> Result<Self, Error>

Create an X86 emulator instance for the specified hardware mode.

Trait Implementations

impl Cpu for CpuX86

type Reg = RegisterX86

fn emu(&self) -> &Unicorn

fn mut_emu(&mut self) -> &mut Unicorn

fn reg_read(&self, reg: Self::Reg) -> Result<u64, Error>

Read an unsigned value from a register.

fn reg_read_i32(&self, reg: Self::Reg) -> Result<i32, Error>

Read a signed 32-bit value from a register.

unsafe fn reg_write_generic<T: Sized>( &self, reg: Self::Reg, value: T, ) -> Result<(), Error>

Write a generic type to a register.

fn reg_write(&self, reg: Self::Reg, value: u64) -> Result<(), Error>

Write an unsigned value register.

fn reg_write_i32(&self, reg: Self::Reg, value: i32) -> Result<(), Error>

Write a signed 32-bit value to a register.

fn mem_map( &self, address: u64, size: size_t, perms: Protection, ) -> Result<(), Error>

Map a memory region in the emulator at the specified address.

unsafe fn mem_map_ptr<T>( &self, address: u64, size: size_t, perms: Protection, ptr: *mut T, ) -> Result<(), Error>

Map an existing memory region in the emulator at the specified address.

fn mem_unmap(&self, address: u64, size: size_t) -> Result<(), Error>

Unmap a memory region.

fn mem_write(&self, address: u64, bytes: &[u8]) -> Result<(), Error>

Write a range of bytes to memory at the specified address.

fn mem_read(&self, address: u64, bytes: &mut [u8]) -> Result<(), Error>

Read a range of bytes from memory at the specified address.

fn mem_read_as_vec(&self, address: u64, size: usize) -> Result<Vec<u8>, Error>

Read a range of bytes from memory at the specified address; return the bytes read as a Vec.

fn mem_protect( &self, address: u64, size: usize, perms: Protection, ) -> Result<(), Error>

Set the memory permissions for an existing memory region.

fn mem_regions(&self) -> Result<Vec<MemRegion>, Error>

Returns a vector with the memory regions that are mapped in the emulator.

fn emu_start( &self, begin: u64, until: u64, timeout: u64, count: usize, ) -> Result<(), Error>

Emulate machine code for a specified duration.

fn emu_stop(&self) -> Result<(), Error>

Stop the emulation.

fn add_code_hook<F>( &mut self, hook_type: CodeHookType, begin: u64, end: u64, callback: F, ) -> Result<uc_hook, Error>

where F: Fn(&Unicorn, u64, u32) + 'static,

Add a code hook.

fn add_intr_hook<F>(&mut self, callback: F) -> Result<uc_hook, Error>

where F: Fn(&Unicorn, u32) + 'static,

Add an interrupt hook.

fn add_mem_hook<F>( &mut self, hook_type: MemHookType, begin: u64, end: u64, callback: F, ) -> Result<uc_hook, Error>

where F: Fn(&Unicorn, MemType, u64, usize, i64) -> bool + 'static,

Add a memory hook.

fn add_insn_in_hook<F>(&mut self, callback: F) -> Result<uc_hook, Error>

where F: Fn(&Unicorn, u32, usize) -> u32 + 'static,

Add an “in” instruction hook.

fn add_insn_out_hook<F>(&mut self, callback: F) -> Result<uc_hook, Error>

where F: Fn(&Unicorn, u32, usize, u32) + 'static,

Add an “out” instruction hook.

fn add_insn_sys_hook<F>( &mut self, insn_type: InsnSysX86, begin: u64, end: u64, callback: F, ) -> Result<uc_hook, Error>

where F: Fn(&Unicorn) + 'static,

Add a “syscall” or “sysenter” instruction hook.

fn remove_hook(&mut self, hook: uc_hook) -> Result<(), Error>

Remove a hook.

fn errno(&self) -> Error

Return the last error code when an API function failed.

fn query(&self, query: Query) -> Result<usize, Error>

Query the internal status of the engine.

fn context_save(&self) -> Result<Context, Error>

Save the CPU context into an opaque struct.

fn context_restore(&self, context: &Context) -> Result<(), Error>