#capstone #disassembly #bindings #engine #instructions #x86 #arch

capstone3

High level bindings to capstone disassembly engine (http://capstone-engine.org/)

1 unstable release

Uses old Rust 2015

0.1.0 Dec 16, 2016

#10 in #capstone


Used in cargo-sym

MIT license

25KB
546 lines

Contains (Mach-o exe, 9KB) examples/darwin

capstone3

Bindings to the capstone library disassembly framework.

There's an example in demo.rs, but as a sample:

extern crate capstone;

const CODE: &'static [u8; 8] = b"\x55\x48\x8b\x05\xb8\x13\x00\x00";

fn main() {
     match capstone::Capstone::new(capstone::Arch::X86) {
         Ok(cs) => {
             cs.detail().unwrap();
             cs.att();
             match cs.disasm(CODE, 0x1000) {
                 Ok(insns) => {
                     println!("Got {} instructions", insns.len());
                     for i in insns.iter() {
                         println!("{}", i);
                         println!("detail: {:?}", i.detail());
                     }
                 },
                 Err(err) => {
                     println!("Error disassembling: {}", err);
                 }
             }
         },
         Err(err) => {
             println!("Error creating disassembler: {}", err);
         }
     }
}

Produces:

Got 2 instructions
0x1000: push rbp
0x1001: mov rax, qword ptr [rip + 0x13b8]

Reporting Issues

Please open a Github issue

Demo

You can run:

cargo run --example=demo

To produce a short demonstration. More complex demos welcome!

Author

Library Author: Nguyen Anh Quynh Binding Author(s): m4b m4b.github.io@gmail.com Richo Healey richo@psych0tik.net

Contributors

  • @ekse

License

Mit.

Dependencies

~32MB
~1M SLoC