UNIX-like reverse engineering framework and command-line toolset
Go to file
2019-06-08 11:38:55 +02:00
.github/ISSUE_TEMPLATE Remove legacy issue templates and use modern one's ##docs 2018-11-03 13:15:44 +01:00
binr Add r2preload demo program 2019-05-28 23:15:59 +02:00
doc Update doc/capstone 2019-05-20 18:41:55 +02:00
libr Handle R2_CURL env var in RSocket.httpGet ##network 2019-06-08 11:38:55 +02:00
man Fix #13988 - Add JSON output format to rafind2 ##search 2019-05-11 18:41:59 +02:00
mk Fix the iOS simulator build 2019-02-11 15:49:26 +01:00
pkgcfg Move trie, mixed, slist into Sdb's Attic, and DES from util to crypto ##refactor 2018-11-07 17:18:14 +01:00
prefix Better webui, 'pi' counts opcodes and remove /new and htmlgraph 2013-01-25 03:22:09 +01:00
shlr Upgrade capstone from git 2019-06-07 14:34:17 +02:00
sys Add sys/build-shlib.sh and fix static builds ##build 2019-05-28 23:15:22 +02:00
t Remove obsolete test file 2019-01-13 12:28:39 +01:00
.appveyor.yml Fix appveyour thing 2019-05-08 14:18:54 +02:00
.clang-format gcc8 warnings (fixes #10338) (#11798) 2018-10-13 01:32:20 +02:00
.gitignore Create script to apply style to diffs (#11261) 2018-09-26 10:49:16 +02:00
.lgtm.yml Fix LGTM builds 2019-05-10 16:21:29 +08:00
.travis.yml Set bin_obj on bios_bin load_buffer method (#14188) 2019-05-30 12:56:04 +02:00
AUTHORS.md Grammar edits to README.md (#11713) 2018-10-02 15:23:59 +02:00
autogen.sh Improve autogen.sh to use r2pm if available 2018-10-16 00:28:51 +02:00
config-user.mk.acr Enable capstone5 at configure time option ##disasm 2019-05-07 12:47:27 +02:00
configure Rewrite the RBuffer API to make it safer and adjust the codebase ##refactor (#13656) 2019-05-15 15:34:06 +02:00
configure-plugins Fix meson build on macOS 2017-05-14 23:15:07 +02:00
configure.acr Post release version bump 2019-05-15 11:17:03 +02:00
configure.hook Fix shellcheck problem in scripts 2015-04-29 10:46:22 +02:00
CONTRIBUTING.md Grammar edits to README.md (#11713) 2018-10-02 15:23:59 +02:00
COPYING Honor FSF filename license rules (LICENSE->COPYING) 2013-03-30 00:54:05 +01:00
COPYING.LESSER Honor FSF filename license rules (LICENSE->COPYING) 2013-03-30 00:54:05 +01:00
DEVELOPERS.md Add a parenthesis 2019-06-07 12:51:03 +08:00
Dockerfile Make git clones quieter 2018-10-06 04:32:03 +02:00
Dockerfile.travis Prerelease travis release (#13189) 2019-02-28 16:58:09 +01:00
Doxyfile Initial doxygen config 2018-06-15 23:57:04 +02:00
env.sh Add more R2_ prefix for some var 2018-08-07 22:14:54 +02:00
global.mk Avoid hardcoding prefix in global.mk (#11813) 2018-10-15 00:54:03 +02:00
Makefile Bring back mrproper to fix all the recent build issues 2018-08-13 14:17:41 +02:00
meson_options.txt Enable capstone5 at configure time option ##disasm 2019-05-07 12:47:27 +02:00
meson.build meson: Change completions installation directory (#13647) 2019-04-07 09:59:06 +02:00
package.json Appveyor windows-installer integration 2017-06-05 11:00:51 +02:00
plugins.bin.cfg WebAssembly improvements in branch lines and namings ##wasm 2019-01-18 11:29:51 +01:00
plugins.def.cfg Initial import of the RISCV capstone plugins for asm and anal ##disasm (#14117) 2019-05-21 02:24:24 +02:00
plugins.emscripten.cfg Support r2core.js for Emscripten >=v1.37.24 (#12502) 2018-12-17 11:55:44 +01:00
plugins.ios-store.cfg Add io.r2web, io.r2pipe, fs.io and debug.io for iOS ##build 2018-10-22 01:40:35 +02:00
plugins.ios.cfg Some more build fixes for iOS 2018-10-22 16:00:02 +02:00
plugins.nogpl.cfg Update plugins.nogpl.cfg and fix a couple of warnings 2019-02-11 12:18:23 +01:00
plugins.static.cfg Add chip8 pseudo support ##disasm 2019-03-16 20:48:27 +01:00
plugins.static.nogpl.cfg Import the XNU kernelcache RBin plugin ##bin 2019-03-08 02:03:47 +01:00
plugins.tiny.cfg Prerelease travis release (#13189) 2019-02-28 16:58:09 +01:00
radare2.spec SPEC file updated to version 0.10.0 2015-10-25 12:08:06 +01:00
README.md Fix and reorder bindings languages 2019-05-16 20:12:21 +08:00
snapcraft.yaml Fixed snapcraft.yaml to work on build.snapcraft.io 2018-07-18 02:11:28 +02:00
travis-extract-var.sh Prerelease travis release (#13189) 2019-02-28 16:58:09 +01:00
travis-script Prerelease travis release (#13189) 2019-02-28 16:58:09 +01:00
Vagrantfile Add Vagrantfile for radare2 + ArchLinux 2017-12-19 00:50:56 +01:00
Vagrantfile.sh Add Vagrantfile for radare2 + ArchLinux 2017-12-19 00:50:56 +01:00

 ____  ___  ___  ___ ____  ___   ____
|  _ \/   \|   \/   \  _ \/ _ \ (__  \
|    (  -  | |  ) -  |   (   _/ /  __/
|__\__|_|__|___/__|__|_\__|___| |____|

             https://www.radare.org

                             --pancake
Jenkins Build Status
TravisCI Build Status
AppVeyor Build Status
Coverity Build Status
LGTM Total alerts
Infrastructure CII Best Practices
Codecov codecov
Packaging status

Introduction

r2 is a rewrite from scratch of radare in order to provide a set of libraries and tools to work with binary files.

Radare project started as a forensics tool, a scriptable command-line hexadecimal editor able to open disk files, but later added support for analyzing binaries, disassembling code, debugging programs, attaching to remote gdb servers...

radare2 is portable.

To learn more on radare2 you may want to read the official radare2 book.

Operating Systems

Windows (since XP), GNU/Linux, OS X, [Net|Free|Open]BSD, Android, iOS, OSX, QNX, Solaris, Haiku, FirefoxOS.

Architectures

i386, x86-64, ARM, MIPS, PowerPC, SPARC, RISC-V, SH, m68k, m680x, AVR, XAP, System Z, XCore, CR16, HPPA, ARC, Blackfin, Z80, H8/300, V810, V850, CRIS, XAP, PIC, LM32, 8051, 6502, i4004, i8080, Propeller, Tricore, CHIP-8, LH5801, T8200, GameBoy, SNES, SPC700, MSP430, Xtensa, NIOS II, Java, Dalvik, WebAssembly, MSIL, EBC, TMS320 (c54x, c55x, c55+, c66), Hexagon, Brainfuck, Malbolge, whitespace, DCPU16, LANAI, MCORE, mcs96, RSP, SuperH-4, VAX.

File Formats

ELF, Mach-O, Fatmach-O, PE, PE+, MZ, COFF, OMF, TE, XBE, BIOS/UEFI, Dyldcache, DEX, ART, CGC, Java class, Android boot image, Plan9 executable, ZIMG, MBN/SBL bootloader, ELF coredump, MDMP (Windows minidump), WASM (WebAssembly binary), Commodore VICE emulator, QNX, Game Boy (Advance), Nintendo DS ROMs and Nintendo 3DS FIRMs, various filesystems.

Scripting

Native bindings are supported but the recommended way to interact with r2 from other languages is by using r2pipe

Python, Ruby, JavaScript, Lua, Perl, PHP, Go, Rust, Swift, C#, Java, Shell, OCaml, Haskell, Scheme (Guile), CommonLisp, Clojure, Erlang, D, Vala/Genie, Prolog, Nim, Newlisp...

Install / Update

The recommended way to install or update radare2 from git for single-user systems:

$ sys/install.sh

If you don't have root, or just want to install it in your home use:

$ sys/user.sh

Note that those scripts will install using configure+make using symlinks, so you don't need to reinstall everytime you change something in the builddir.

  • If you don't like symlinks use sys/install.sh --install
  • To use capstone5 use the --with-capstone5 flag.

Alternatively you can also build with meson + ninja:

$ ./sys/meson.py --prefix=/usr --shared --install

Uninstall

In case of a polluted filesystem, you can uninstall the current version or remove all previous installations:

$ make uninstall
$ make purge

To remove all stuff including libraries, use

$ make system-purge

Package Manager

Radare2 has its own package manager - r2pm. Its packages repository is on GitHub too. To start to using it for the first time, you need to initialize packages:

$ r2pm init

Refresh the packages database before installing any package:

$ r2pm update

To install a package, use the following command:

$ r2pm install [package name]

Development

Coding Style

Look at CONTRIBUTING.md.

Tests

Running make tests will fetch the radare2-regressions repository and run all the tests in order to verify that no changes break any functionality.

We run those tests on every commit, and they are also executed with ASAN and valgrind on different platforms to catch other unwanted 'features'.

Community

Website: https://www.radare.org/

Telegram: https://t.me/radare

Twitter: @radareorg

IRC: irc.freenode.net #radare

Matrix: @radare2:matrix.org