capstone/cstool
Tim Haines 98a393e34d
Stringify BH fields when printing ppc details (#2663)
* Stringify BH fields when printing ppc details

This extends #2662.

* Add clarification for 'at' bits in BO field

* Fix Doxygen comment
2025-04-04 13:39:09 +08:00
..
Makefile Fix cstool Makefile for non-C99-defaulting compilers (#2315) 2024-04-23 21:57:39 +08:00
README merge next to master 2018-07-20 12:36:50 +08:00
cstool.c Tms32c64x Little Endian (#2648) 2025-03-22 21:49:54 +08:00
cstool.h Rebased #2570 (#2614) 2025-01-28 22:34:24 +08:00
cstool_aarch64.c AArch64 issues (#2473) 2024-09-24 12:32:10 +08:00
cstool_alpha.c Add Alpha architecture (#2071) 2023-12-28 11:10:38 +09:00
cstool_arc.c Rebased #2570 (#2614) 2025-01-28 22:34:24 +08:00
cstool_arm.c ARM fixes (#2477) 2024-09-23 11:30:33 +08:00
cstool_bpf.c Fix compilation warnings related to TriCore. (#2012) 2023-05-09 20:46:10 +08:00
cstool_evm.c Fix compilation warnings related to TriCore. (#2012) 2023-05-09 20:46:10 +08:00
cstool_hppa.c HPPA dissassembler fix unitialized variables errors (#2309) 2024-04-10 13:49:43 +08:00
cstool_loongarch.c Initial auto-sync LoongArch support (#2349) 2024-06-26 14:47:44 +08:00
cstool_m68k.c Fix compilation warnings related to TriCore. (#2012) 2023-05-09 20:46:10 +08:00
cstool_m680x.c Fix compilation warnings related to TriCore. (#2012) 2023-05-09 20:46:10 +08:00
cstool_mips.c Auto-Sync Mips (#2410) 2024-09-07 22:30:47 +08:00
cstool_mos65xx.c Fix compilation warnings related to TriCore. (#2012) 2023-05-09 20:46:10 +08:00
cstool_powerpc.c Stringify BH fields when printing ppc details (#2663) 2025-04-04 13:39:09 +08:00
cstool_riscv.c Add access support for RISC-V (#2393) 2024-07-10 11:36:39 +08:00
cstool_sh.c Fix compilation warnings related to TriCore. (#2012) 2023-05-09 20:46:10 +08:00
cstool_sparc.c Fix compilation warnings related to TriCore. (#2012) 2023-05-09 20:46:10 +08:00
cstool_systemz.c Coverity defects (#2469) 2024-09-18 21:19:42 +08:00
cstool_tms320c64x.c Fix compilation warnings related to TriCore. (#2012) 2023-05-09 20:46:10 +08:00
cstool_tricore.c Fix tricore UB (#2204) 2023-11-30 00:20:44 +08:00
cstool_wasm.c Fix compilation warnings related to TriCore. (#2012) 2023-05-09 20:46:10 +08:00
cstool_x86.c Coverity defects (#2469) 2024-09-18 21:19:42 +08:00
cstool_xcore.c Fix compilation warnings related to TriCore. (#2012) 2023-05-09 20:46:10 +08:00
cstool_xtensa.c xtensa: update to espressif/llvm-project (#2533) 2024-11-10 21:55:40 +08:00
getopt.c cstool: move code from getopt.h to getopt.c 2019-02-03 14:34:20 +08:00
getopt.h cstool: move code from getopt.h to getopt.c 2019-02-03 14:34:20 +08:00

README

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