~nabijaczleweli/yaxpeax-dis

ref: 2c29f911b43923c2b370c53f8b089053d144cbe8 yaxpeax-dis/README.md -rw-r--r-- 1.3 KiB
2c29f911 — iximeow bump yaxpeax-x86 8 months ago

#yaxpeax-dis

yaxpeax-dis is the repo providing yaxdis, a small and very naive disassembler to exercise decoders in the yaxpeax project. it does not (currently?) do much other than disassembling hex input, and is mostly useful as an example of how to use decoders and spot-checking a specific instruction's decoding.

#usage

if you just want to build and use it, cargo install yaxpeax-dis should get you started. otherwise, clone this repo and a cargo build will work as well.

yaxdis [-a arch] [hex bytes], such as yaxdis -a x86_64 33c0c3 which should yield:

0x00000000: 33c0          : xor eax, eax
0x00000002: c3            : ret

or yaxdis -a armv7 83591764ab46cd42, producing:

0x00000000: 83591764      : ldrvs r5, [r7], #-0x260c
0x00000004: ab46cd42      : sbcmi sp, 0x46ab

yaxdis also takes a -v flag to emit more verbose information (really, a Debug display of decoded instructions).

#supported architectures / ! user beware !

yaxdis should support all architectures listed in the yaxpeax-arch readme. that is currently x86_64, armv7, armv8, mips, msp430, pic17, pic18, and m16c. specific levels of support and stability vary, beware.