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)

Supported Platforms

| Platform | system capstone | gmake | cmake | cc | | ------------------------------- | ----- | --------------- | ----- | ----- | | x86_64-apple-darwin | :heavycheckmark: | :heavycheckmark: | :heavycheckmark: | :heavycheckmark: | | i686-apple-darwin | :heavycheckmark:* | :x: | :heavycheckmark:* | :heavycheckmark:* | | x86_64-pc-windows-msvc | :noentrysign: | :noentrysign: | :noentrysign: | :heavycheckmark: | | x86_64-pc-windows-gnu | :noentrysign: | :noentrysign: | :noentrysign: | :heavycheckmark: | | i686-pc-windows-msvc | :noentrysign: | :noentrysign: | :noentrysign: | :heavycheckmark:* | | i686-pc-windows-gnu | :noentrysign: | :noentrysign: | :noentrysign: | :heavycheckmark:* | | x86_64-unknown-linux-gnu | :heavycheckmark: | :heavycheckmark: | :heavycheckmark: | :heavycheckmark: | | i686-unknown-linux-gnu | :heavycheckmark:* | :x: | :heavycheckmark:* | :heavycheckmark:* |

| Symbol | Meaning | | ------ | ------- | | :heavycheckmark: | build succeeds, all tests pass | | :heavycheckmark:* | build succeeds, some bindgen tests fail (issue #18) | | :noentrysign: | build method is not supported/tested | | :x: | build fails |

Features

capstone-sys has different features that can be specified in Cargo.toml.

Build Features

These features affect how capstone-sys will use/build the bundled Capstone C library:

• no feature or gmake (default on non-Windows platforms): build bundled Capstone with GNU make.
• use_system_capstone: use the system Capstone instead of the bundled copy of the Capstone library.
  • Requires that Capstone is already manually 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 Git commit of Capstone.
  • Does not compile Capstone
• build_capstone_cmake: build the bundled Capstone with cmake (requires CMake to be installed).
• build_capstone_cc (default on Windows platforms): build the bundled Capstone with the cc Rust crate.

Other Features

• use_bindgen: instead of using the pre-generated Capstone bindings, dynamically generate bindings with bindgen.

Tested Platforms

The following platforms have automated testing:

• x86_64-unknown-linux-gnu: Travis CI