• Home
Name Date Size #Lines LOC

..--

MakefileD03-May-2024867 4835

READMED03-May-20241.1 KiB4333

cstool.cD03-May-20249.3 KiB400322

cstool_arm.cD03-May-20243.1 KiB11489

cstool_arm64.cD03-May-20243 KiB10382

cstool_mips.cD03-May-20241.2 KiB4835

cstool_ppc.cD03-May-20242.1 KiB9074

cstool_sparc.cD03-May-20241.4 KiB5541

cstool_systemz.cD03-May-20241.6 KiB5744

cstool_x86.cD03-May-20243.2 KiB11280

cstool_xcore.cD03-May-20241.4 KiB5340

README

1This directory contains cstool of Capstone Engine.
2
3Cstool is a command-line tool to disassemble assembly hex-string.
4For example, to decode a hexcode string for Intel 32bit, run:
5
6	$ cstool x32 "90 91"
7
8	0	90	nop
9	1	91	xchg	eax, ecx
10
11Cstool disassembles the input and prints out the assembly instructions.
12On each line, the first column is the instruction offset, the second
13column is opcodes, and the rest is the instruction itself.
14
15Cstool is flexible enough to accept all kind of hexcode format. The following
16inputs have the same output with the example above.
17
18	$ cstool x32 "0x90 0x91"
19	$ cstool x32 "\x90\x91"
20	$ cstool x32 "90,91"
21	$ cstool x32 "90;91"
22	$ cstool x32 "90+91"
23	$ cstool x32 "90:91"
24
25To print out instruction details, run Cstool with -d option, like below.
26
27	$ cstool -d x32 "01 d8"
28	0  01d8                              add	eax, ebx
29		Prefix:0x00 0x00 0x00 0x00
30		Opcode:0x01 0x00 0x00 0x00
31		rex: 0x0
32		addr_size: 4
33		modrm: 0xd8
34		disp: 0x0
35		sib: 0x0
36		op_count: 2
37			operands[0].type: REG = eax
38			operands[0].size: 4
39			operands[1].type: REG = ebx
40			operands[1].size: 4
41
42To see all the supported options, run ./cstool
43