capstone-sys

Low-level, unsafe Rust bindings for the capstone disassembly library.

API Documentation

Requirements

• Rust version >= 1.19
  • We export Rust unions, which were first stabilized with release 1.19
• One of the following:
  1. A toolchain capable of compiling capstone (see the make.sh script)
  2. A pre-built version 3.0 capstone dynamic library (specify the use_system_capstone feature)

Features

capstone-sys will build differently based on features that are specified in Cargo.toml.

capstone-sys supports the following features:

• use_system_capstone: use the system capstone instead of the bundled copy of the capstone library.
  • Requires that capstone is already installed on the system. We highly recommend that you supply the exact version bundled with capstone-sys.
    • See the CAPSTONE_REVISION variable in scripts/update_capstone.sh to determine the exact Capstone version.
  • Eliminates the default step of compiling capstone
• build_capstone_cmake: if using the bundled capstone library, then build capstone using cmake.
• use_bindgen: instead of using the pre-generated capstone bindings, dynamically generate bindings with bindgen.