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
billow 21f7bc85f9
Xtensa Support (#2380)
* Fix leaks

* Remove unnecessary new lines

* Add checks for actual buffer length before attempting reading it.

* Xtensa: add xtensa support

* Xtensa fixes

- fix MCExpr
- fix Xtensa_add_cs_detail
- add `add_cs_detail`
- add `MCExpr *MCOperand_getExpr(const MCOperand *MC)` `void printExpr(const MCExpr *E, SStream *O)`

autosync fix

- fix StreamOperation.py
- replace `report_fatal_error` with `CS_ASSERT`
- fix patch StreamOperation.py
- replace `assert` with `CS_ASSERT`
- fix AddCSDetail.py
- fix QualifiedIdentifier

* Xtensa fix

* Xtensa fix .py

* add Xtensa to the fuzzer

* Xtensa `LITBASE`: add a basic implementation

* Xtensa `LITBASE`: add a integration test

* Xtensa: fix cs_v6_release_guide.md

* Xtensa: fix `XTENSA_OP_GROUP_MEMOPERAND`

* Xtensa: fix

* Xtensa: fix Targets.py

* Use isUint and isInt all over Xtensa

* Add documentation about LITBASE functionality

* Fix typo

* Replace hard with Capstone assert

* Xtensa: fix arch_config.json

* Xtensa: fix

---------

Co-authored-by: Rot127 <unisono@quyllur.org>
2024-09-30 11:35:51 +08:00
.github Xtensa Support (#2380) 2024-09-30 11:35:51 +08:00
.reuse [Auto-Sync] LLVM 18 update (#2296) 2024-04-22 11:55:44 +08:00
arch Xtensa Support (#2380) 2024-09-30 11:35:51 +08:00
bindings Xtensa Support (#2380) 2024-09-30 11:35:51 +08:00
contrib Documentation updates (#2476) 2024-09-23 11:26:56 +08:00
cstool Xtensa Support (#2380) 2024-09-30 11:35:51 +08:00
docs Xtensa Support (#2380) 2024-09-30 11:35:51 +08:00
include Xtensa Support (#2380) 2024-09-30 11:35:51 +08:00
LICENSES [Auto-Sync] LLVM 18 update (#2296) 2024-04-22 11:55:44 +08:00
packages fix typos (#2387) 2024-06-19 18:54:05 +08:00
suite Xtensa Support (#2380) 2024-09-30 11:35:51 +08:00
tests Xtensa Support (#2380) 2024-09-30 11:35:51 +08:00
windows Fix user data alignment in MEMBLOCK (#1471) 2019-05-09 10:24:47 +08:00
windowsce Documentation updates (#2476) 2024-09-23 11:26:56 +08:00
xcode fix typos (#2346) 2024-05-12 21:17:20 +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 Auto-Sync Mips (#2410) 2024-09-07 22:30:47 +08: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
BUILDING.md Documentation updates (#2476) 2024-09-23 11:26:56 +08:00
capstone-config.cmake.in Add back support for relocatable packages (#2431) 2024-08-17 23:54:12 +08:00
capstone.pc.in Add back support for relocatable packages (#2431) 2024-08-17 23:54:12 +08:00
ChangeLog fix typos (#2387) 2024-06-19 18:54:05 +08:00
cmake_uninstall.cmake.in Add back support for relocatable packages (#2431) 2024-08-17 23:54:12 +08:00
cmake.sh SystemZ Auto-Sync refactor (#2462) 2024-09-14 16:57:54 +08:00
CMakeLists.txt Xtensa Support (#2380) 2024-09-30 11:35:51 +08:00
CMakePresets.json Merge cmake.yml into CITest.yml 2022-04-11 09:35:10 +02:00
COMPILE_MAKE.TXT Documentation updates (#2476) 2024-09-23 11:26:56 +08:00
config.mk Xtensa Support (#2380) 2024-09-30 11:35:51 +08:00
CONTRIBUTING.md Documentation updates (#2476) 2024-09-23 11:26:56 +08:00
CREDITS.TXT Xtensa Support (#2380) 2024-09-30 11:35:51 +08:00
cs_priv.h Xtensa Support (#2380) 2024-09-30 11:35:51 +08:00
cs_simple_types.h AArch64 update to LLVM 18 (#2298) 2024-07-08 10:28:54 +08:00
cs.c Xtensa Support (#2380) 2024-09-30 11:35:51 +08:00
functions.mk Fix if indent 2023-05-19 19:50:46 +01:00
LEB128.h sync with LLVM 7.0.1. X86 is first 2019-02-26 15:19:51 +08:00
make.sh LIBDIRARCH does not propagate to Makefile (#2214) 2024-01-03 17:30:49 +09:00
Makefile Xtensa Support (#2380) 2024-09-30 11:35:51 +08:00
Mapping.c Xtensa Support (#2380) 2024-09-30 11:35:51 +08:00
Mapping.h Xtensa Support (#2380) 2024-09-30 11:35:51 +08:00
MathExtras.h Xtensa Support (#2380) 2024-09-30 11:35:51 +08:00
MCAsmInfo.h SystemZ Auto-Sync refactor (#2462) 2024-09-14 16:57:54 +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 Replace assert with CS_ASSERT in modules (#2478) 2024-09-25 14:58:06 +08:00
MCInst.h Xtensa Support (#2380) 2024-09-30 11:35:51 +08:00
MCInstPrinter.c Coverity defects (#2469) 2024-09-18 21:19:42 +08:00
MCInstPrinter.h fix typos (#2346) 2024-05-12 21:17:20 +08:00
MCInstrDesc.c AArch64 update to LLVM 18 (#2298) 2024-07-08 10:28:54 +08:00
MCInstrDesc.h AArch64 update to LLVM 18 (#2298) 2024-07-08 10:28:54 +08:00
MCRegisterInfo.c Auto-Sync Mips (#2410) 2024-09-07 22:30:47 +08:00
MCRegisterInfo.h Xtensa Support (#2380) 2024-09-30 11:35:51 +08:00
nmake.bat Xtensa Support (#2380) 2024-09-30 11:35:51 +08:00
pkgconfig.mk 5.0-post1 2023-07-05 23:30:22 +08:00
README.md Xtensa Support (#2380) 2024-09-30 11:35:51 +08:00
run-clang-tidy.sh Modern Testing (#2456) 2024-08-31 21:33:38 +08:00
SPONSORS.TXT Update sponsors and remove empty file. (#2485) 2024-09-25 15:35:29 +08:00
SStream.c Coverity defects (#2469) 2024-09-18 21:19:42 +08:00
SStream.h Coverity defects (#2469) 2024-09-18 21:19:42 +08:00
utils.c Xtensa Support (#2380) 2024-09-30 11:35:51 +08:00
utils.h Xtensa Support (#2380) 2024-09-30 11:35:51 +08:00

Capstone Engine

Build status pypi package pypi downloads oss-fuzz Status

Tip

Welcome to join our community group!

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, Alpha, BPF, Ethereum VM, LoongArch, HP PA-RISC (HPPA), M68K, M680X, Mips, MOS65XX, PPC, RISC-V(rv32G/rv64G), SH, Sparc, SystemZ, TMS320C64X, TriCore, Webassembly, XCore and X86 (16, 32, 64), Xtensa.

  • 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 BUILDING.md file for how to compile and install Capstone.

Documentation

Contributing

See CONTRIBUTING.md for an intro.

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.