|
Name |
|
Date |
Size |
#Lines |
LOC |
| .. | | 07-May-2022 | - |
| include/ | H | 10-Oct-2021 | - | 34 | 6 |
| src/ | H | 10-Oct-2021 | - | 11,997 | 9,837 |
| README | H A D | 10-Oct-2021 | 2.6 KiB | 92 | 63 |
README
1Udis86
2======
3
4Udis86 is a disassembler for the x86 and x86-64 class of instruction set
5architectures. It consists of a C library called libudis86 which
6provides a clean and simple interface to decode a stream of raw binary
7data, and to inspect the disassembled instructions in a structured
8manner.
9
10
11LICENSE
12-------
13
14Udis86 is distributed under the terms of the 2-clause "Simplified BSD
15License". A copy of the license is included with the source in LICENSE.
16
17
18libudis86
19---------
20
21 o Supports all x86 and x86-64 (AMD64) General purpose and
22 System instructions.
23 o Supported ISA extensions:
24 - MMX, FPU (x87), AMD 3DNow
25 - SSE, SSE2, SSE3, SSSE3, SSE4.1, SSE4.2, AES,
26 - AMD-V, INTEL-VMX, SMX
27 o Instructions are defined in an XML document, with opcode
28 tables generated for performance.
29 o Supports output in both INTEL (NASM) as well as AT&T (GNU as) style
30 assembly language syntax.
31 o Supports a variety of input methods: Files, Memory Buffers, and
32 Function Callback hooks.
33 o Re-entrant, no dynamic memory allocation.
34 o Fully documented API
35
36
37 -- EXAMPLE -----------------------------------------------------------
38
39 ud_t u;
40
41 ud_init(&u);
42 ud_set_input_file(&u, stdin);
43 ud_set_mode(&u, 64);
44 ud_set_syntax(&u, UD_SYN_INTEL);
45
46 while (ud_disassemble(&u)) {
47 printf("\t%s\n", ud_insn_asm(&ud_obj));
48 }
49
50 ----------------------------------------------------------------------
51
52
53udcli
54-----
55
56udcli is a small command-line tool for your quick disassembly needs.
57
58 -- EXAMPLE -----------------------------------------------------------
59
60 $ echo "65 67 89 87 76 65 54 56 78 89 09 00 90" | udcli -32 -x
61 0000000080000800 656789877665 mov [gs:bx+0x6576], eax
62 0000000080000806 54 push esp
63 0000000080000807 56 push esi
64 0000000080000808 7889 js 0x80000793
65 000000008000080a 0900 or [eax], eax
66 000000008000080c 90 nop
67
68 ----------------------------------------------------------------------
69
70
71Documentation
72-------------
73
74The libudis86 api is fully documented. The package distribution contains
75a Texinfo file which can be installed by invoking "make install-info".
76You can also find an online html version of the documentation available
77at http://udis86.sourceforge.net/.
78
79
80Autotools Build
81---------------
82
83You need autotools if building from sources cloned form version control
84system, or if you need to regenerate the build system. The wrapper
85script 'autogen.sh' is provided that'll generate the build system.
86
87
88AUTHOR
89------
90
91Udis86 is written and maintained by Vivek Thampi (vivek.mt@gmail.com).
92