1 stable release
1.0.0 | Nov 5, 2021 |
---|
#4 in #emu
76KB
2.5K
SLoC
Qnicorn-engine
Rust bindings for the Qnicorn emulator with utility functions.
Checkout Unicorn2 source code at dev branch.
use qnicorn::RegisterARM;
use qnicorn::qnicorn_const::{Arch, Mode, Permission, SECOND_SCALE};
fn main() {
let arm_code32: Vec<u8> = vec![0x17, 0x00, 0x40, 0xe2]; // sub r0, #23
let mut qnicorn = qnicorn-engine::Qnicorn::new(Arch::ARM, Mode::LITTLE_ENDIAN).expect("failed to initialize Qnicorn instance");
let mut emu = qnicorn.borrow();
emu.mem_map(0x1000, 0x4000, Permission::ALL).expect("failed to map code page");
emu.mem_write(0x1000, &arm_code32).expect("failed to write instructions");
emu.reg_write(RegisterARM::R0 as i32, 123).expect("failed write R0");
emu.reg_write(RegisterARM::R5 as i32, 1337).expect("failed write R5");
let _ = emu.emu_start(0x1000, (0x1000 + arm_code32.len()) as u64, 10 * SECOND_SCALE, 1000);
assert_eq!(emu.reg_read(RegisterARM::R0 as i32), Ok(100));
assert_eq!(emu.reg_read(RegisterARM::R5 as i32), Ok(1337));
}
Further sample code can be found in tests/qnicorn.rs
.
Usage
Add this to your Cargo.toml
:
[dependencies]
qnicorn = "1.0.0"
Acknowledgements
These bindings are based on Sébastien Duquette's (@ekse) unicorn-rs. We picked up the project, as it is no longer maintained. Thanks to all contributors.
Dependencies
~0–2MB
~32K SLoC