capstone/cstool
Denys Melnyk 4eb90672f3
Xtensa: gate ESP32-S3 and HIFI3 ops behind CS_MODE_XTENSA_ESP32S3 (#2979)
The Xtensa disassembler enabled the ESP32-S3 SIMD/AI (ee.*) and HiFi3 ops for
every target because the subtarget feature gates were stubbed to return true
(Xtensa_getFeatureBits and hasDensity/hasESP32S3Ops/hasHIFI3). As a result, on a
non-ESP32-S3 Xtensa config any instruction with op0=0xE/0xF was matched as a
4-byte ee.* op, so a base-ISA byte stream desynced.

Make Xtensa_getFeatureBits map the mode to a feature set (mirroring the SystemZ
precedent), thread MI->csh->mode into the three has*Ops gates, and add an opt-in
CS_MODE_XTENSA_ESP32S3. Base/esp32/esp32s2/esp8266 no longer emit ESP32-S3 ops;
CS_MODE_XTENSA_ESP32S3 preserves them. Concrete instance of issue #1992.

The saved auto-sync patch hashes are updated so the fix survives the next LLVM
re-sync. Adds tests/MC/Xtensa/esp32s3.s.yaml.

Co-authored-by: Denys Melnyk <denys@com2cloud.com>
2026-07-22 16:13:28 +00:00
..
cstool.c Xtensa: gate ESP32-S3 and HIFI3 ops behind CS_MODE_XTENSA_ESP32S3 (#2979) 2026-07-22 16:13:28 +00:00
cstool.h Rebased #2570 (#2614) 2025-01-28 22:34:24 +08:00
cstool_aarch64.c AArch64: prevent literal displacement truncation (#2984) 2026-07-18 17:02:29 +00:00
cstool_alpha.c Fix imm to be 64bit wide (#2840) 2025-12-30 15:55:48 +00:00
cstool_arc.c Rebased #2570 (#2614) 2025-01-28 22:34:24 +08:00
cstool_arm.c Add workflow to check for C code formatting and format all code with clang-format-17 (#2744) 2025-08-27 08:50:50 +00:00
cstool_bpf.c Add workflow to check for C code formatting and format all code with clang-format-17 (#2744) 2025-08-27 08:50:50 +00:00
cstool_evm.c Fix compilation warnings related to TriCore. (#2012) 2023-05-09 20:46:10 +08:00
cstool_hppa.c HPPA fix mem operands access and instruction printing (#2746) 2025-07-06 11:21:22 +00:00
cstool_loongarch.c Initial auto-sync LoongArch support (#2349) 2024-06-26 14:47:44 +08:00
cstool_m68k.c Add M68K ColdFire ISA support (#2927) 2026-05-22 15:04:35 +00:00
cstool_m680x.c Add workflow to check for C code formatting and format all code with clang-format-17 (#2744) 2025-08-27 08:50:50 +00:00
cstool_mips.c Add workflow to check for C code formatting and format all code with clang-format-17 (#2744) 2025-08-27 08:50:50 +00:00
cstool_mos65xx.c Add workflow to check for C code formatting and format all code with clang-format-17 (#2744) 2025-08-27 08:50:50 +00:00
cstool_powerpc.c Add workflow to check for C code formatting and format all code with clang-format-17 (#2744) 2025-08-27 08:50:50 +00:00
cstool_riscv.c Add frm operands to float/double instructions (#2972) 2026-06-23 13:28:28 +00:00
cstool_sh.c Add workflow to check for C code formatting and format all code with clang-format-17 (#2744) 2025-08-27 08:50:50 +00:00
cstool_sparc.c Add workflow to check for C code formatting and format all code with clang-format-17 (#2744) 2025-08-27 08:50:50 +00:00
cstool_systemz.c Add workflow to check for C code formatting and format all code with clang-format-17 (#2744) 2025-08-27 08:50:50 +00:00
cstool_tms320c64x.c Add workflow to check for C code formatting and format all code with clang-format-17 (#2744) 2025-08-27 08:50:50 +00:00
cstool_tricore.c Fix tricore UB (#2204) 2023-11-30 00:20:44 +08:00
cstool_wasm.c Add workflow to check for C code formatting and format all code with clang-format-17 (#2744) 2025-08-27 08:50:50 +00:00
cstool_x86.c Add workflow to check for C code formatting and format all code with clang-format-17 (#2744) 2025-08-27 08:50:50 +00:00
cstool_xcore.c Add workflow to check for C code formatting and format all code with clang-format-17 (#2744) 2025-08-27 08:50:50 +00:00
cstool_xtensa.c Use cs_ac_type for operand access mode in all arches and use cs_xtensa_op_type for Xtensa operand type (#2721) 2025-06-05 11:49:20 +08:00
getopt.c Add workflow to check for C code formatting and format all code with clang-format-17 (#2744) 2025-08-27 08:50:50 +00:00
getopt.h Add workflow to check for C code formatting and format all code with clang-format-17 (#2744) 2025-08-27 08:50:50 +00:00
Makefile Fix cstool Makefile for non-C99-defaulting compilers (#2315) 2024-04-23 21:57:39 +08:00
README.md Convert all README's to markdown files. (#2863) 2026-02-14 13:56:07 +00:00

This directory contains cstool of Capstone Engine.

Cstool is a command-line tool to disassemble assembly hex-string. For example, to decode a hexcode string for Intel 32bit, run:

$ cstool x32 "90 91"

0	90	nop
1	91	xchg	eax, ecx

Cstool disassembles the input and prints out the assembly instructions. On each line, the first column is the instruction offset, the second column is opcodes, and the rest is the instruction itself.

Cstool is flexible enough to accept all kind of hexcode format. The following inputs have the same output with the example above.

$ cstool x32 "0x90 0x91"
$ cstool x32 "\x90\x91"
$ cstool x32 "90,91"
$ cstool x32 "90;91"
$ cstool x32 "90+91"
$ cstool x32 "90:91"

To print out instruction details, run Cstool with -d option, like below.

$ cstool -d x32 "01 d8"
0  01d8                              add	eax, ebx
Prefix:0x00 0x00 0x00 0x00
Opcode:0x01 0x00 0x00 0x00
rex: 0x0
addr_size: 4
modrm: 0xd8
disp: 0x0
sib: 0x0
op_count: 2
	operands[0].type: REG = eax
	operands[0].size: 4
	operands[0].access: READ | WRITE
	operands[1].type: REG = ebx
	operands[1].size: 4
	operands[1].access: READ
	Registers read: eax ebx
Registers modified: eflags eax
EFLAGS: MOD_AF MOD_CF MOD_SF MOD_ZF MOD_PF MOD_OF

To see all the supported options, run ./cstool