You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
_xeroxz 095f1b17d0
init commit
3 years ago
..
examples init commit 3 years ago
keystone-sys init commit 3 years ago
src init commit 3 years ago
tests init commit 3 years ago
.gitignore init commit 3 years ago
COPYING init commit 3 years ago
Cargo.toml init commit 3 years ago
Makefile init commit 3 years ago
README.md init commit 3 years ago

README.md

keystone-rs

Rust bindings for the keystone engine.

Sample

extern crate keystone;
use keystone::*;

fn main() {
    let engine = Keystone::new(Arch::X86, Mode::MODE_32)
        .expect("Could not initialize Keystone engine");

    engine.option(OptionType::SYNTAX, OptionValue::SYNTAX_NASM)
        .expect("Could not set option to nasm syntax");

    let result = engine.asm("mov ah, 0x80".to_string(), 0)
        .expect("Could not assemble");

    println!("ASM result: {}", result);

    if let Err(err) = engine.asm("INVALID".to_string(), 0) {
        println!("Error: {}", err);
    }
}

Installation

Add a dependency line into Cargo.toml.

[dependencies]
keystone = "0.9.2"

This package attempts to build keystone. That requires cmake and c/c++ compiler.

If you want to use keystone already installed in the system, specify use_system_keystone feature on Cargo.toml.

[dependencies.keystone]
version = "0.9.2"
default-features = false
features = ["use_system_keystone"]

Testing

cargo test

Contributors

  • Remco Verhoef (@remco_verhoef)
  • Tasuku SUENAGA a.k.a. gunyarakun (@tasukuchan)

Special thanks to:

  • Sébastien Duquette (@ekse) for his unicorn-rs binding