
* Rust bindings (#1295) * rust bindings init * updated bindings/README * Improved Rust bindings: (#1309) * Added basic block hooking * Changed confusing struct naming. Before: Protection::All -> R,W,X, Now: Permission::All -> R,W,X * Fixed issue with remove_hook(..). Implementation tried to remove hook from incorrect hashmap. * Made unused private vmmap(..) public. * Improve Rust bindings (#1367) * fixed tests * constant readability * HookType as bitflags * Mode as bitflags * improve bitflags * cargo fmt * removed unnecessary "as usize" * fixed buggy deallocation of uc_context structs * Remove data field in rust bindings Co-authored-by: Lukas Seidel <pr0me@users.noreply.github.com> Co-authored-by: Nikolas Eller <nikolas.e@mail.de> Co-authored-by: Simon Wörner <git@simon-woerner.de> Co-authored-by: floesen <floesen@users.noreply.github.com>
231 lines
6.5 KiB
Rust
231 lines
6.5 KiB
Rust
#![allow(non_camel_case_types)]
|
|
#![allow(dead_code)]
|
|
|
|
use super::unicorn_const::*;
|
|
use libc::{c_char, c_int};
|
|
use std::ffi::c_void;
|
|
use std::pin::Pin;
|
|
|
|
pub type uc_handle = *mut c_void;
|
|
pub type uc_hook = *mut c_void;
|
|
pub type uc_context = libc::size_t;
|
|
|
|
extern "C" {
|
|
pub fn uc_version(major: *mut u32, minor: *mut u32) -> u32;
|
|
pub fn uc_arch_supported(arch: Arch) -> bool;
|
|
pub fn uc_open(arch: Arch, mode: Mode, engine: *mut uc_handle) -> uc_error;
|
|
pub fn uc_close(engine: uc_handle) -> uc_error;
|
|
pub fn uc_context_free(mem: uc_context) -> uc_error;
|
|
pub fn uc_errno(engine: uc_handle) -> uc_error;
|
|
pub fn uc_strerror(error_code: uc_error) -> *const c_char;
|
|
pub fn uc_reg_write(engine: uc_handle, regid: c_int, value: *const c_void) -> uc_error;
|
|
pub fn uc_reg_read(engine: uc_handle, regid: c_int, value: *mut c_void) -> uc_error;
|
|
pub fn uc_mem_write(
|
|
engine: uc_handle,
|
|
address: u64,
|
|
bytes: *const u8,
|
|
size: libc::size_t,
|
|
) -> uc_error;
|
|
pub fn uc_mem_read(
|
|
engine: uc_handle,
|
|
address: u64,
|
|
bytes: *mut u8,
|
|
size: libc::size_t,
|
|
) -> uc_error;
|
|
pub fn uc_mem_map(engine: uc_handle, address: u64, size: libc::size_t, perms: u32) -> uc_error;
|
|
pub fn uc_mem_map_ptr(
|
|
engine: uc_handle,
|
|
address: u64,
|
|
size: libc::size_t,
|
|
perms: u32,
|
|
ptr: *mut c_void,
|
|
) -> uc_error;
|
|
pub fn uc_mem_unmap(engine: uc_handle, address: u64, size: libc::size_t) -> uc_error;
|
|
pub fn uc_mem_protect(
|
|
engine: uc_handle,
|
|
address: u64,
|
|
size: libc::size_t,
|
|
perms: u32,
|
|
) -> uc_error;
|
|
pub fn uc_mem_regions(
|
|
engine: uc_handle,
|
|
regions: *const *const MemRegion,
|
|
count: *mut u32,
|
|
) -> uc_error;
|
|
pub fn uc_emu_start(
|
|
engine: uc_handle,
|
|
begin: u64,
|
|
until: u64,
|
|
timeout: u64,
|
|
count: libc::size_t,
|
|
) -> uc_error;
|
|
pub fn uc_emu_stop(engine: uc_handle) -> uc_error;
|
|
pub fn uc_hook_add(
|
|
engine: uc_handle,
|
|
hook: *mut uc_hook,
|
|
hook_type: HookType,
|
|
callback: *mut c_void,
|
|
user_data: *mut c_void,
|
|
begin: u64,
|
|
end: u64,
|
|
...
|
|
) -> uc_error;
|
|
pub fn uc_hook_del(engine: uc_handle, hook: uc_hook) -> uc_error;
|
|
pub fn uc_query(engine: uc_handle, query_type: Query, result: *mut libc::size_t) -> uc_error;
|
|
pub fn uc_context_alloc(engine: uc_handle, context: *mut uc_context) -> uc_error;
|
|
pub fn uc_context_save(engine: uc_handle, context: uc_context) -> uc_error;
|
|
pub fn uc_context_restore(engine: uc_handle, context: uc_context) -> uc_error;
|
|
}
|
|
|
|
pub struct CodeHook {
|
|
pub unicorn: *mut crate::UnicornInner,
|
|
pub callback: Box<dyn FnMut(crate::UnicornHandle, u64, u32)>,
|
|
}
|
|
|
|
pub struct BlockHook {
|
|
pub unicorn: *mut crate::UnicornInner,
|
|
pub callback: Box<dyn FnMut(crate::UnicornHandle, u64, u32)>,
|
|
}
|
|
|
|
pub struct MemHook {
|
|
pub unicorn: *mut crate::UnicornInner,
|
|
pub callback: Box<dyn FnMut(crate::UnicornHandle, MemType, u64, usize, i64)>,
|
|
}
|
|
|
|
pub struct InterruptHook {
|
|
pub unicorn: *mut crate::UnicornInner,
|
|
pub callback: Box<dyn FnMut(crate::UnicornHandle, u32)>,
|
|
}
|
|
|
|
pub struct InstructionInHook {
|
|
pub unicorn: *mut crate::UnicornInner,
|
|
pub callback: Box<dyn FnMut(crate::UnicornHandle, u32, usize)>,
|
|
}
|
|
|
|
pub struct InstructionOutHook {
|
|
pub unicorn: *mut crate::UnicornInner,
|
|
pub callback: Box<dyn FnMut(crate::UnicornHandle, u32, usize, u32)>,
|
|
}
|
|
|
|
pub struct InstructionSysHook {
|
|
pub unicorn: *mut crate::UnicornInner,
|
|
pub callback: Box<dyn FnMut(crate::UnicornHandle)>,
|
|
}
|
|
|
|
pub extern "C" fn code_hook_proxy(
|
|
uc: uc_handle,
|
|
address: u64,
|
|
size: u32,
|
|
user_data: *mut CodeHook,
|
|
) {
|
|
let unicorn = unsafe { &mut *(*user_data).unicorn };
|
|
let callback = &mut unsafe { &mut *(*user_data).callback };
|
|
assert_eq!(uc, unicorn.uc);
|
|
callback(
|
|
crate::UnicornHandle {
|
|
inner: unsafe { Pin::new_unchecked(unicorn) },
|
|
},
|
|
address,
|
|
size,
|
|
);
|
|
}
|
|
|
|
pub extern "C" fn block_hook_proxy(
|
|
uc: uc_handle,
|
|
address: u64,
|
|
size: u32,
|
|
user_data: *mut BlockHook,
|
|
) {
|
|
let unicorn = unsafe { &mut *(*user_data).unicorn };
|
|
let callback = &mut unsafe { &mut *(*user_data).callback };
|
|
assert_eq!(uc, unicorn.uc);
|
|
callback(
|
|
crate::UnicornHandle {
|
|
inner: unsafe { Pin::new_unchecked(unicorn) },
|
|
},
|
|
address,
|
|
size,
|
|
);
|
|
}
|
|
|
|
pub extern "C" fn mem_hook_proxy(
|
|
uc: uc_handle,
|
|
mem_type: MemType,
|
|
address: u64,
|
|
size: u32,
|
|
value: i64,
|
|
user_data: *mut MemHook,
|
|
) {
|
|
let unicorn = unsafe { &mut *(*user_data).unicorn };
|
|
let callback = &mut unsafe { &mut *(*user_data).callback };
|
|
assert_eq!(uc, unicorn.uc);
|
|
callback(
|
|
crate::UnicornHandle {
|
|
inner: unsafe { Pin::new_unchecked(unicorn) },
|
|
},
|
|
mem_type,
|
|
address,
|
|
size as usize,
|
|
value,
|
|
);
|
|
}
|
|
|
|
pub extern "C" fn intr_hook_proxy(uc: uc_handle, value: u32, user_data: *mut InterruptHook) {
|
|
let unicorn = unsafe { &mut *(*user_data).unicorn };
|
|
let callback = &mut unsafe { &mut *(*user_data).callback };
|
|
assert_eq!(uc, unicorn.uc);
|
|
callback(
|
|
crate::UnicornHandle {
|
|
inner: unsafe { Pin::new_unchecked(unicorn) },
|
|
},
|
|
value,
|
|
);
|
|
}
|
|
|
|
pub extern "C" fn insn_in_hook_proxy(
|
|
uc: uc_handle,
|
|
port: u32,
|
|
size: usize,
|
|
user_data: *mut InstructionInHook,
|
|
) {
|
|
let unicorn = unsafe { &mut *(*user_data).unicorn };
|
|
let callback = &mut unsafe { &mut *(*user_data).callback };
|
|
assert_eq!(uc, unicorn.uc);
|
|
callback(
|
|
crate::UnicornHandle {
|
|
inner: unsafe { Pin::new_unchecked(unicorn) },
|
|
},
|
|
port,
|
|
size,
|
|
);
|
|
}
|
|
|
|
pub extern "C" fn insn_out_hook_proxy(
|
|
uc: uc_handle,
|
|
port: u32,
|
|
size: usize,
|
|
value: u32,
|
|
user_data: *mut InstructionOutHook,
|
|
) {
|
|
let unicorn = unsafe { &mut *(*user_data).unicorn };
|
|
let callback = &mut unsafe { &mut *(*user_data).callback };
|
|
assert_eq!(uc, unicorn.uc);
|
|
callback(
|
|
crate::UnicornHandle {
|
|
inner: unsafe { Pin::new_unchecked(unicorn) },
|
|
},
|
|
port,
|
|
size,
|
|
value,
|
|
);
|
|
}
|
|
|
|
pub extern "C" fn insn_sys_hook_proxy(uc: uc_handle, user_data: *mut InstructionSysHook) {
|
|
let unicorn = unsafe { &mut *(*user_data).unicorn };
|
|
let callback = &mut unsafe { &mut *(*user_data).callback };
|
|
assert_eq!(uc, unicorn.uc);
|
|
callback(crate::UnicornHandle {
|
|
inner: unsafe { Pin::new_unchecked(unicorn) },
|
|
});
|
|
}
|