9 releases (breaking)

✓ Uses Rust 2018 edition

0.9.1 May 11, 2019
0.9.0 Dec 18, 2018
0.8.0 Feb 16, 2018
0.7.0 May 17, 2017
0.3.0 Jul 24, 2016
Download history 15/week @ 2019-04-27 11/week @ 2019-05-04 30/week @ 2019-05-11 31/week @ 2019-05-18 10/week @ 2019-05-25 13/week @ 2019-06-01 11/week @ 2019-06-08 15/week @ 2019-06-15 66/week @ 2019-06-22 35/week @ 2019-06-29 65/week @ 2019-07-06 3/week @ 2019-07-13 4/week @ 2019-07-20 10/week @ 2019-07-27 12/week @ 2019-08-03

70 downloads per month

GPL-2.0 license

142K SLoC

C 129K SLoC // 0.1% comments Visual Studio Project 5.5K SLoC Python 5K SLoC // 0.1% comments Rust 2K SLoC // 0.1% comments Visual Studio Solution 369 SLoC Shell 145 SLoC // 0.1% comments Batch 61 SLoC // 0.1% comments C++ 15 SLoC


Cargo Documentation Build Status

Looking for maintainers: I am looking for new maintainers for the project. If you are interested, please open an issue or contact me by email at ekse.0x@gmail.com.

Rust bindings for the unicorn CPU emulator.

use unicorn::{Cpu, CpuX86};

fn main() {
    let x86_code32: Vec<u8> = vec![0x41, 0x4a]; // INC ecx; DEC edx

    let emu = CpuX86::new(unicorn::Mode::MODE_32).expect("failed to instantiate emulator");
    let _ = emu.mem_map(0x1000, 0x4000, unicorn::Protection::ALL);
    let _ = emu.mem_write(0x1000, &x86_code32);
    let _ = emu.reg_write_i32(unicorn::RegisterX86::ECX, -10);
    let _ = emu.reg_write_i32(unicorn::RegisterX86::EDX, -50);

    let _ = emu.emu_start(0x1000, (0x1000 + x86_code32.len()) as u64, 10 * unicorn::SECOND_SCALE, 1000);
    assert_eq!(emu.reg_read_i32(unicorn::RegisterX86::ECX), Ok(-9));
    assert_eq!(emu.reg_read_i32(unicorn::RegisterX86::EDX), Ok(-51));


This project has been tested on Linux, OS X and Windows. The bindings are built for version 1.0 of unicorn.

This package attempts to build unicorn if it is not already installed on the system. To build unicorn on Linux and OS X, the following tools are needed : gcc, make, git, python 2.7. Visual Studio is needed on Windows.

To use unicorn-rs, simply add it as dependency to the Cargo.toml of your program.

unicorn = "0.8.0"



Error now implements the Error trait (thanks to @tathanhdinh), the RESOURCE and EXCEPTION error cases are now supported (thanks to @endeav0r). The CPU context can now be saved and restored (thanks to @oblivia-simplex). You can find an example use in the test x86_context_save_and_restore, in tests/unicorn.rs. The ffi bindings crate unicorn-sys is now no_std by default (thanks to @strake). Finally the crate was migrated to Rust edition 2018.

Thank you again to all the contributors, your help is always appreciated.


Added support for mem_map_ptr.


Windows is now supported (thanks to kichristensen).


We now check if unicorn is installed on the system via pkg-tool and use that version if available. Otherwise unicorn is compiled when building the package.


unicorn is now compiled as part of the build process of unicorn-rs.


The handling of callbacks has been modified, callbacks should be implemented using closures. See the tests for examples.

  • added support for interrupt, in/out and sysenter callbacks


Contributions to this project are super appreciated. Pull requests, bug reports, code review, tests, documentation or feedback on your use of the bindings, nothing is too small. Don't hesitate to open an issue if you have questions.


  • Sébastien Duquette (@ekse)
  • Israel Hallé (@isra17) for redesigning the callbacks API
  • Richo Healey (@richo)
  • Kim Christensen (@kichristensen) for the Windows support
  • petevine for reviewing the project and adding tests
  • jschievink for his help with the API design
  • m4b for the build.rs script
  • TA Thanh Dinh
  • Lucca Fraser (@oblivia-simplex)
  • Matthew Farkas-Dyck (@strake)
  • endeav0r