Import first try of a documentation
[frida/doc.git] / source / intro.rst
1 Introduction
2 ============
3
4 What is FrIDA?
5 --------------
6
7 Frida is a tool to better understand how some binary program works --
8 an Interactive Disassembler. Instead of the long instruction listing
9 you get by running objdump, FrIDa provides you with a control flow
10 graph and lets you annotate parts of the program you already
11 understood. It lets you add names to things (like functions) to
12 actually describe their function -- even if the binary has been
13 stripped and the original names are gone.
14
15 Why use FrIDa?
16 --------------
17
18 The competition in this field isn't particularly large and FrIDa may
19 well be the only tool available that works for you and fits your
20 wallet. FrIDa uses the LLVM library and, as a result, can handle
21 almost any binary program you encounter. It can do ELF binaries just
22 as well as PE (Windows) and Mac binaries for every CPU architecture
23 LLVM supports -- including x86 and ARM but also less common targets
24 like Power, SPARC or MIPS.
25
26
27 FrIDa is Free Software
28 ----------------------
29
30 FrIDa is free software: you can redistribute it and/or modify it under
31 the terms of the GNU Lesser General Public License as published by the
32 Free Software Foundation, either version 3 of the License, or (at your
33 option) any later version.
34
35 This program is distributed in the hope that it will be useful,
36 but WITHOUT ANY WARRANTY; without even the implied warranty of
37 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
38 GNU General Public License for more details.