58 lines
1.3 KiB
ReStructuredText
58 lines
1.3 KiB
ReStructuredText
|
Getting Started
|
||
|
|
===============
|
||
|
|
|
||
|
|
|
||
|
|
Building and Installing udis86
|
||
|
|
------------------------------
|
||
|
|
|
||
|
|
udis86 is developed for unix-like environments, and like most software,
|
||
|
|
the basic steps towards building and installing it are as follows.
|
||
|
|
|
||
|
|
.. code::
|
||
|
|
|
||
|
|
$ ./configure
|
||
|
|
$ make
|
||
|
|
$ make install
|
||
|
|
|
||
|
|
Depending on your choice of install location, you may need to have root
|
||
|
|
privileges to do an install. The install scripts copy the necessary header
|
||
|
|
and library files to appropriate locations in your system.
|
||
|
|
|
||
|
|
|
||
|
|
Interfacing with libudis86: A Quick Example
|
||
|
|
-------------------------------------------
|
||
|
|
|
||
|
|
The following is an example of a program that interfaces with libudis86
|
||
|
|
and uses the API to generate assembly language output for 64-bit code,
|
||
|
|
input from STDIN.
|
||
|
|
|
||
|
|
.. code-block:: c
|
||
|
|
|
||
|
|
#include <stdio.h>
|
||
|
|
#include <udis86.h>
|
||
|
|
|
||
|
|
int main()
|
||
|
|
{
|
||
|
|
ud_t ud_obj;
|
||
|
|
|
||
|
|
ud_init(&ud_obj);
|
||
|
|
ud_set_input_file(&ud_obj, stdin);
|
||
|
|
ud_set_mode(&ud_obj, 64);
|
||
|
|
ud_set_syntax(&ud_obj, UD_SYN_INTEL);
|
||
|
|
|
||
|
|
while (ud_disassemble(&ud_obj)) {
|
||
|
|
printf("\t%s\n", ud_insn_asm(&ud_obj));
|
||
|
|
}
|
||
|
|
|
||
|
|
return 0;
|
||
|
|
}
|
||
|
|
|
||
|
|
To compile the program (using gcc):
|
||
|
|
|
||
|
|
.. code::
|
||
|
|
|
||
|
|
$ gcc -ludis86 example.c -o example
|
||
|
|
|
||
|
|
This example should give you an idea of how this library can be used. The
|
||
|
|
following sections describe, in detail, the complete API of libudis86.
|