#unicorn #emulator #bindings #arch #emu #register-arm #second-scale

sys unicorn-rs

Rust bindings for the unicorn emulator

1 unstable release

0.1.0 Aug 13, 2021

#4 in #emu

GPL-2.0 license

7MB
173K SLoC

C 133K SLoC // 0.1% comments Python 11K SLoC // 0.1% comments Visual Studio Project 6K SLoC Java 4K SLoC // 0.2% comments Go 3K SLoC // 0.0% comments Ruby 3K SLoC // 0.1% comments F# 3K SLoC // 0.0% comments Pascal 2.5K SLoC // 0.1% comments Rust 2K SLoC // 0.0% comments VB6 1.5K SLoC // 0.6% comments Haskell 1.5K SLoC // 0.2% comments C# 472 SLoC // 0.1% comments Visual Studio Solution 418 SLoC C++ 298 SLoC // 0.2% comments Shell 195 SLoC // 0.2% comments GNU Style Assembly 193 SLoC // 0.0% comments Batch 74 SLoC // 0.2% comments Cabal 38 SLoC // 0.1% comments Assembly 9 SLoC // 0.5% comments NuGet Config 4 SLoC Forge Config 2 SLoC

Contains (ELF exe/lib, 1KB) x86_self_modifying.elf

Bindings for the Unicorn emulator.

Example use


use unicorn::RegisterARM;
use unicorn::unicorn_const::{Arch, Mode, Permission, SECOND_SCALE};

fn main() {
    let arm_code32: Vec<u8> = vec![0x17, 0x00, 0x40, 0xe2]; // sub r0, #23

    let mut unicorn = unicorn::Unicorn::new(Arch::ARM, Mode::LITTLE_ENDIAN).expect("failed to initialize Unicorn instance");
    let mut emu = unicorn.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));
}

Dependencies