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
Rot127 3ef564bcf4
Add issue and PR templates (#2294)
* Add PR template.

* Add issue templates.
2024-03-20 16:57:52 +08:00
.github Add issue and PR templates (#2294) 2024-03-20 16:57:52 +08:00
arch [PPC] Expose instruction formats (#2276) 2024-02-23 13:20:46 +08:00
bindings [PPC] Expose instruction formats (#2276) 2024-02-23 13:20:46 +08:00
contrib Constify backends (#1549) 2019-12-23 20:30:57 +08:00
cstool cstool: Fix ppc_br_hint comparison (#2254) 2024-01-20 23:44:05 +08:00
docs [PPC] Expose instruction formats (#2276) 2024-02-23 13:20:46 +08:00
include [PPC] Expose instruction formats (#2276) 2024-02-23 13:20:46 +08:00
msvc Raise minimum requirement to VS2017 (#2228) 2024-01-07 19:10:59 +08:00
packages merge next to master 2018-07-20 12:36:50 +08:00
suite [CMake] Architecture definition fix (#2272) 2024-02-23 13:20:00 +08:00
tests add Alpha big-endian (#2227) 2024-01-02 13:02:38 +09: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 Architecture updater (auto-sync) - Updating AArch64 (#2026) 2023-11-15 12:12:14 +08:00
.appveyor.yml rename appveyor.yml to .appveyor.yml 2016-03-15 00:01:10 +08:00
.clang-format Add .clang-format and format 2023-05-30 11:09:37 +08:00
.editorconfig Add OCaml to EditorConfig 2022-07-23 10:46:03 +02:00
.gitattributes Fix language statistics by considering *.inc files to be C files. (#1078) 2018-01-14 20:42:20 +08:00
.gitignore Ignore JetBrains based IDE data for clean PRs (#2224) 2023-12-29 01:10:57 +09:00
.gitmodules Architecture updater (auto-sync) - Updating ARM (#1949) 2023-07-19 17:56:27 +08:00
.travis.yml Fuzzit integration (#1520) 2019-07-25 09:06:52 +08:00
capstone-config.cmake.in allow absolute CMAKE_INSTALL_*DIR (#2134) 2023-08-09 23:05:06 +08:00
capstone.pc.in support pkg-config --static flag in capstone.pc (#2173) 2023-10-06 20:12:50 +08:00
ChangeLog Update ChangeLog v5.0 Final 2023-07-05 22:58:24 +08:00
cmake_uninstall.cmake.in allow absolute CMAKE_INSTALL_*DIR (#2134) 2023-08-09 23:05:06 +08:00
cmake.sh Architecture updater (auto-sync) - Updating AArch64 (#2026) 2023-11-15 12:12:14 +08:00
CMakeLists.txt [CMake] Architecture definition fix (#2272) 2024-02-23 13:20:00 +08:00
CMakePresets.json Merge cmake.yml into CITest.yml 2022-04-11 09:35:10 +02:00
COMPILE_CMAKE.TXT Add support for architecture registration (#2252) 2024-01-20 21:48:05 +08:00
COMPILE_MSVC.TXT Raise minimum requirement to VS2017 (#2228) 2024-01-07 19:10:59 +08:00
COMPILE.TXT Add Alpha architecture (#2071) 2023-12-28 11:10:38 +09:00
config.mk Add Alpha architecture (#2071) 2023-12-28 11:10:38 +09:00
CREDITS.TXT Add Alpha architecture (#2071) 2023-12-28 11:10:38 +09:00
cs_priv.h Architecture updater (auto-sync) - Updating PPC (#2013) 2023-09-05 12:24:59 +08:00
cs_simple_types.h Make helper functions static to prevent multiple defintions. (#2266) 2024-02-15 15:51:46 +08:00
cs.c Add support for architecture registration (#2252) 2024-01-20 21:48:05 +08:00
dev_requirements.txt Update docs wit ASUpdater.py script (#2217) 2024-01-07 22:07:46 +09:00
functions.mk Fix if indent 2023-05-19 19:50:46 +01:00
HACK.TXT Makefile: Improve Apple detection (#2263) 2024-02-23 13:18:53 +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 LIBDIRARCH does not propagate to Makefile (#2214) 2024-01-03 17:30:49 +09:00
Makefile Makefile: Improve Apple detection (#2263) 2024-02-23 13:18:53 +08:00
Mapping.c [PPC] Expose instruction formats (#2276) 2024-02-23 13:20:46 +08:00
Mapping.h [PPC] Expose instruction formats (#2276) 2024-02-23 13:20:46 +08:00
MathExtras.h Fix MSVC warning overrides when using non-MSVC toolchains (#2250) 2024-01-20 21:45:21 +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 Architecture updater (auto-sync) - Updating AArch64 (#2026) 2023-11-15 12:12:14 +08:00
MCInst.h Architecture updater (auto-sync) - Updating AArch64 (#2026) 2023-11-15 12:12:14 +08:00
MCInstPrinter.c Architecture updater (auto-sync) - Updating AArch64 (#2026) 2023-11-15 12:12:14 +08:00
MCInstPrinter.h Architecture updater (auto-sync) - Updating ARM (#1949) 2023-07-19 17:56:27 +08:00
MCInstrDesc.c Add .clang-format and format 2023-05-30 11:09:37 +08:00
MCInstrDesc.h Architecture updater (auto-sync) - Updating ARM (#1949) 2023-07-19 17:56:27 +08:00
MCRegisterInfo.c In x86: Fixed backward compatibility with C90 (#1969) 2023-03-10 08:37:47 +08:00
MCRegisterInfo.h arm64: sync with LLVM 7.0.1 2019-04-10 14:17:08 +08:00
nmake.bat Add Alpha architecture (#2071) 2023-12-28 11:10:38 +09:00
pkgconfig.mk 5.0-post1 2023-07-05 23:30:22 +08:00
README.md Architecture updater (auto-sync) - Updating AArch64 (#2026) 2023-11-15 12:12:14 +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 Architecture updater (auto-sync) - Updating PPC (#2013) 2023-09-05 12:24:59 +08:00
SStream.h Architecture updater (auto-sync) - Updating PPC (#2013) 2023-09-05 12:24:59 +08:00
utils.c Architecture updater (auto-sync) - Updating AArch64 (#2026) 2023-11-15 12:12:14 +08:00
utils.h [ARM] Add alias support (#2209) 2023-12-02 15:18:58 +08:00

Capstone Engine

Build status pypi package pypi downloads 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, AArch64, BPF, Ethereum VM, M68K, M680X, Mips, MOS65XX, PPC, RISC-V(rv32G/rv64G), SH, Sparc, SystemZ, TMS320C64X, TriCore, Webassembly, XCore and X86 (16, 32, 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 https://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.