2012-10-22 23:03:26 +00:00
|
|
|
<pre>
|
|
|
|
____ ___ ___ ___ ____ ___ ____
|
|
|
|
| _ \/ \| \/ \ _ \/ _ \ |__ \
|
2012-10-22 23:06:38 +00:00
|
|
|
| ( V | | ) V | ( _/ / __/
|
2012-10-22 23:03:26 +00:00
|
|
|
|__\__|_|__|___/__|__|_\__|___| |____|
|
|
|
|
|
|
|
|
www.radare.org
|
|
|
|
|
|
|
|
--pancake
|
|
|
|
</pre>
|
|
|
|
|
2014-04-12 23:46:10 +00:00
|
|
|
[![Build Status](http://ci.rada.re/buildStatus/icon?job=radare2)](http://ci.rada.re/job/radare2/)
|
2014-04-13 00:10:14 +00:00
|
|
|
|
2014-04-12 23:46:10 +00:00
|
|
|
[![Build Status](https://scan.coverity.com/projects/416/badge.svg)](https://scan.coverity.com/projects/416)
|
|
|
|
|
2012-10-22 23:03:26 +00:00
|
|
|
# Introduction
|
|
|
|
|
|
|
|
r2 is a rewrite from scratch of radare in order to provide
|
|
|
|
a set of libraries and tools to work with binary files
|
|
|
|
|
|
|
|
This is the rewrite of radare (1.x branch) to provide a
|
|
|
|
framework with a set of libraries and programs to work
|
|
|
|
with binary data.
|
|
|
|
|
|
|
|
Radare project started as a forensics tool, an scriptable
|
|
|
|
commandline hexadecimal editor able to open disk files,
|
|
|
|
but later support for analyzing binaries, disassembling
|
2013-03-21 12:52:29 +00:00
|
|
|
code, debugging programs, attaching to remote gdb servers, ..
|
2012-10-22 23:03:26 +00:00
|
|
|
|
|
|
|
radare2 is portable.
|
|
|
|
|
2013-06-14 00:51:33 +00:00
|
|
|
Architectures:
|
2012-10-22 23:03:26 +00:00
|
|
|
|
2015-04-24 22:19:28 +00:00
|
|
|
6502, 8051, CRIS, H8/300, LH5801, LH5801, T8200, arc, arm, avr, bf, blackfin,
|
|
|
|
csr, dalvik, dcpu16, gameboy, i386, i4004, i8080, m68k, malbolge, mips, mips,
|
|
|
|
msil, nios II, powerpc, rar, sh, snes, sparc, tms320 (c54x c55x c55+), x86-64,
|
|
|
|
zimg.
|
2012-10-22 23:03:26 +00:00
|
|
|
|
2013-06-14 00:51:33 +00:00
|
|
|
File Formats:
|
2012-10-22 23:03:26 +00:00
|
|
|
|
2014-02-26 21:16:51 +00:00
|
|
|
bios, dex, elf, elf64, filesystem, java, fatmach0, mach0,
|
|
|
|
mach0-64, MZ, PE, PE+, TE, COFF, plan9, bios, dyldcache,
|
2014-09-27 23:37:54 +00:00
|
|
|
Gameboy and Nintendo DS ROMs
|
2013-06-14 00:51:33 +00:00
|
|
|
|
|
|
|
Operating Systems:
|
|
|
|
|
2014-02-26 21:16:51 +00:00
|
|
|
Android, GNU/Linux, [Net|Free|Open]BSD, iOS, OSX, QNX, w32,
|
|
|
|
w64, Solaris, Haiku, FirefoxOS
|
2013-06-14 00:51:33 +00:00
|
|
|
|
|
|
|
Bindings:
|
|
|
|
|
2014-02-26 21:16:51 +00:00
|
|
|
Vala/Genie, Python (2, 3), NodeJS, LUA, Go, Perl,
|
|
|
|
Guile, php5, newlisp, Ruby, Java, OCAML, ...
|
2012-10-22 23:03:26 +00:00
|
|
|
|
|
|
|
# Dependencies
|
|
|
|
|
|
|
|
radare2 can be built without any special dependency, just
|
2013-06-14 00:51:33 +00:00
|
|
|
use make and get a working toolchain (gcc, clang, tcc, ..)
|
2012-10-22 23:03:26 +00:00
|
|
|
|
|
|
|
Optionally you can use libewf for loading EnCase disk images.
|
|
|
|
|
2013-06-14 00:51:33 +00:00
|
|
|
To build the bindings you need latest valabind, g++ and swig2.
|
2012-10-22 23:03:26 +00:00
|
|
|
|
|
|
|
# Install
|
|
|
|
|
2014-11-22 19:13:02 +00:00
|
|
|
The easiest way to install radare2 from git is by running
|
2012-10-22 23:03:26 +00:00
|
|
|
the following command:
|
|
|
|
|
|
|
|
$ sys/install.sh
|
|
|
|
|
2012-10-23 16:44:32 +00:00
|
|
|
# Uninstall
|
|
|
|
|
2014-11-22 19:13:02 +00:00
|
|
|
In case of a polluted filesystem you can uninstall the current
|
2013-06-14 00:51:33 +00:00
|
|
|
version or remove all previous installations:
|
2012-10-23 16:44:32 +00:00
|
|
|
|
|
|
|
$ make uninstall
|
|
|
|
$ make purge
|
|
|
|
|
2012-10-22 23:03:26 +00:00
|
|
|
# Bindings
|
|
|
|
|
|
|
|
All language bindings are under the r2-bindings directory.
|
|
|
|
You will need to install swig2 and valabind in order to
|
|
|
|
build the bindings for Python, LUA, etc..
|
|
|
|
|
|
|
|
APIs are defined in vapi files which are then translated
|
|
|
|
to swig interfaces, nodejs-ffi or other and then compiled.
|
|
|
|
|
2014-11-22 19:13:02 +00:00
|
|
|
The easiest way to install the python bindings is to run:
|
2012-10-22 23:03:26 +00:00
|
|
|
|
|
|
|
$ sys/python.sh
|
|
|
|
|
|
|
|
If you want to use the NodeJS bindings just do:
|
|
|
|
|
|
|
|
$ npm install radare2.js
|
|
|
|
|
2014-11-22 19:13:02 +00:00
|
|
|
To specify the installed version of radare2:
|
2012-10-22 23:03:26 +00:00
|
|
|
|
|
|
|
$ npm install radare2.js@0.9.2
|
|
|
|
|
|
|
|
# Tests
|
|
|
|
|
|
|
|
There is a test suite that can be retrieved by running:
|
|
|
|
|
|
|
|
$ make tests
|
|
|
|
|
|
|
|
# Documentation
|
|
|
|
|
|
|
|
There is no formal documentation of r2 yet. Not all commands
|
|
|
|
are compatible with radare1, so the best way to learn how to
|
|
|
|
do stuff in r2 is by reading the examples from the web and
|
2014-11-22 19:13:02 +00:00
|
|
|
appending '?' to every command you are interested in.
|
2012-10-22 23:03:26 +00:00
|
|
|
|
|
|
|
Commands are small mnemonics of few characters and there is
|
|
|
|
some extra syntax sugar that makes the shell much more pleasant
|
|
|
|
for scripting and interacting with the apis.
|
|
|
|
|
|
|
|
# Webserver
|
|
|
|
|
|
|
|
radare2 comes with an embedded webserver that serves a pure
|
|
|
|
html/js interface that sends ajax queries to the core and
|
|
|
|
aims to implement an usable UI for phones, tablets and desktops.
|
|
|
|
|
|
|
|
$ r2 -c=H /bin/ls
|
|
|
|
|
|
|
|
# Pointers
|
|
|
|
|
|
|
|
Website: http://www.radare.org/
|
|
|
|
|
|
|
|
IRC: irc.freenode.net #radare
|
|
|
|
|
|
|
|
Twitter: @radareorg
|