Capstone disassembly/disassembler framework for ARM, ARM64 (ARMv8), Alpha, BPF, Ethereum VM, HPPA, LoongArch, M68K, M680X, Mips, MOS65XX, PPC, RISC-V(rv32G/rv64G), SH, Sparc, SystemZ, TMS320C64X, TriCore, Webassembly, XCore and X86.
Go to file
2022-04-15 11:17:20 +02:00
.github/workflows Merge cmake.yml into CITest.yml 2022-04-11 09:35:10 +02:00
arch Merge branch 'next' into aarch64-alias-vas-specifiers 2022-03-22 22:58:06 +08:00
bindings Combine aarch64 sys operand enums 2022-03-18 14:15:46 -04:00
contrib Constify backends (#1549) 2019-12-23 20:30:57 +08:00
cstool systemz: pad instruction width up to 6 bytes (#1679) 2020-09-16 17:03:34 +08:00
docs Update README (#1534) 2019-08-30 23:39:52 +08:00
include Combine aarch64 sys operand enums 2022-03-18 14:15:46 -04:00
msvc msvc: Add more test projects. (#1446) 2019-03-24 11:37:09 +08:00
packages merge next to master 2018-07-20 12:36:50 +08:00
suite Merge branch 'next' into aarch64-alias-vas-specifiers 2022-03-22 22:58:06 +08:00
tests test_customized_mnem: avoid abort() if x86 not supported 2022-01-08 00:25:26 -08:00
windows Fix user data alignment in MEMBLOCK (#1471) 2019-05-09 10:24:47 +08:00
windowsce Added documentation for building for Windows CE. 2016-04-12 09:26:47 +02:00
xcode merge next to master 2018-07-20 12:36:50 +08:00
.appveyor.yml rename appveyor.yml to .appveyor.yml 2016-03-15 00:01:10 +08:00
.clang-format Update AARCH64 to ARMv8.1-4 (minus tablegen stuff) (#1425) 2019-03-18 13:29:45 +08:00
.editorconfig Add editorconfig to maintain consistent style (#1486) 2019-05-18 19:30:55 +07:00
.gitattributes Fix language statistics by considering *.inc files to be C files. (#1078) 2018-01-14 20:42:20 +08:00
.gitignore CMake presets + simple CMake Workflow 2022-04-03 11:34:00 +02:00
.travis.yml Fuzzit integration (#1520) 2019-07-25 09:06:52 +08:00
capstone-config.cmake.in Add cmake config and export targets. (#1637) 2020-06-02 20:58:33 +08:00
capstone.pc.in revert #1276 2022-01-26 12:34:43 +08:00
ChangeLog Update ChangeLog for v5.0.0-rc2 2022-02-28 22:13:21 +08:00
cmake_uninstall.cmake.in add cmake uninstall option 2022-01-27 14:22:43 +08:00
cmake.sh Fix pkgcfg generation for the archs variable (#1830) 2022-01-26 11:28:04 +08:00
CMakeLists.txt Merge branch 'next' into fix-install-pkgconfig 2022-04-15 11:17:20 +02:00
CMakePresets.json Merge cmake.yml into CITest.yml 2022-04-11 09:35:10 +02:00
COMPILE_CMAKE.TXT [RISCV] Update COMPILE_CMAKE.TXT 2022-01-18 09:42:45 +08:00
COMPILE_MSVC.TXT Add vcpkg installation instructions (#1602) 2020-03-24 16:29:17 +08:00
COMPILE.TXT Update top-level COMPILE.TXT file (#1578) 2020-01-01 09:53:16 +08:00
config.mk RISCV support ISRV32/ISRV64 (#1401) 2019-03-09 08:41:12 +08:00
CREDITS.TXT update CREDITS.TXT 2021-12-22 16:29:37 +08:00
cs_priv.h [M680X] Fix #1483: errors logged to stderr, using abort (2) (#1489) 2019-05-20 10:22:27 +07:00
cs.c fix sp undeclared error 2022-01-09 11:22:01 +08:00
functions.mk Fixed 47 missing dependencies and 51 excessive dependencies in Makefile (#1522) 2019-07-29 14:15:05 +08:00
HACK.TXT Adds corpus generation for bpf architecture (#1396) 2019-02-21 10:42:31 +08:00
LEB128.h sync with LLVM 7.0.1. X86 is first 2019-02-26 15:19:51 +08:00
LICENSE_LLVM.TXT initial import 2013-11-27 12:11:31 +08:00
LICENSE.TXT a a newline to LICENSE.TXT 2014-02-20 17:08:28 +08:00
make.sh build: add xlc and AIX support (#1559) 2019-10-31 04:02:31 +08:00
Makefile Fix pkgcfg generation for the archs variable (#1830) 2022-01-26 11:28:04 +08:00
MathExtras.h sync with LLVM 7.0.1. X86 is first 2019-02-26 15:19:51 +08:00
MCDisassembler.h sync with LLVM 7.0.1. X86 is first 2019-02-26 15:19:51 +08:00
MCFixedLenDisassembler.h RISCV support ISRV32/ISRV64 (#1401) 2019-03-09 08:41:12 +08:00
MCInst.c clean up code 2022-01-05 15:49:11 +08:00
MCInst.h x86: printf64m should print qword ptr by default. TODO: fix related cases in tablegen instead 2019-06-09 01:58:03 +08:00
MCInstrDesc.c sync with LLVM 7.0.1. X86 is first 2019-02-26 15:19:51 +08:00
MCInstrDesc.h sync with LLVM 7.0.1. X86 is first 2019-02-26 15:19:51 +08:00
MCRegisterInfo.c sync with LLVM 7.0.1. X86 is first 2019-02-26 15:19:51 +08:00
MCRegisterInfo.h arm64: sync with LLVM 7.0.1 2019-04-10 14:17:08 +08:00
nmake.bat Add cmake option to tell whether architectures should be included by default (#1463) (#1466) 2019-04-29 19:20:01 +07:00
pkgconfig.mk update pkgconfig.mk 2022-02-28 23:28:58 +08:00
README.md Adds oss-fuzz badge (#1541) 2021-11-10 00:23:13 +08:00
RELEASE_NOTES empty RELEASE_NOTES for v4.1 2018-12-19 07:50:18 +07:00
SPONSORS.TXT Add webassembly arch (#1359) 2019-02-01 23:03:47 +08:00
SStream.c ppc: sync with llvm 7.0.1 2019-04-30 13:50:42 +08:00
SStream.h ppc: sync with llvm 7.0.1 2019-04-30 13:50:42 +08:00
TODO TODO 2015-03-11 11:33:00 +08:00
utils.c arm64: sync with LLVM 7.0.1 2019-04-10 14:17:08 +08:00
utils.h arm64: sync with LLVM 7.0.1 2019-04-10 14:17:08 +08:00

Capstone Engine

Build Status Build status pypi package pypi downloads Fuzzit Status
oss-fuzz Status

Capstone is a disassembly framework with the target of becoming the ultimate disasm engine for binary analysis and reversing in the security community.

Created by Nguyen Anh Quynh, then developed and maintained by a small community, Capstone offers some unparalleled features:

  • Support multiple hardware architectures: ARM, ARM64 (ARMv8), BPF, Ethereum VM, Webassembly, M68K, Mips, MOS65XX, PPC, Sparc, SystemZ, TMS320C64X, M680X, XCore, RISC-V(rv32G/rv64G) and X86 (including X86_64).

  • Having clean/simple/lightweight/intuitive architecture-neutral API.

  • Provide details on disassembled instruction (called “decomposer” by others).

  • Provide semantics of the disassembled instruction, such as list of implicit registers read & written.

  • Implemented in pure C language, with lightweight bindings for Swift, D, Clojure, F#, Common Lisp, Visual Basic, PHP, PowerShell, Emacs, Haskell, Perl, Python, Ruby, C#, NodeJS, Java, GO, C++, OCaml, Lua, Rust, Delphi, Free Pascal & Vala ready either in main code, or provided externally by the community).

  • Native support for all popular platforms: Windows, Mac OSX, iOS, Android, Linux, *BSD, Solaris, etc.

  • Thread-safe by design.

  • Special support for embedding into firmware or OS kernel.

  • High performance & suitable for malware analysis (capable of handling various X86 malware tricks).

  • Distributed under the open source BSD license.

Further information is available at http://www.capstone-engine.org

Compile

See COMPILE.TXT file for how to compile and install Capstone.

Documentation

See docs/README for how to customize & program your own tools with Capstone.

Hack

See HACK.TXT file for the structure of the source code.

Fuzz

See suite/fuzz/README.md for more information.

License

This project is released under the BSD license. If you redistribute the binary or source code of Capstone, please attach file LICENSE.TXT with your products.