Skip to content
unix-like reverse engineering framework and commandline tools
C C++ Objective-C JavaScript Makefile Shell Other
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.builds Change radare->radareorg links Oct 7, 2019
.github/ISSUE_TEMPLATE Fix regressions URL (#15027) Sep 13, 2019
binr Link sdb fully into r_util in meson (#15338) ##build Oct 23, 2019
doc Add fortunes :] (#15231) Oct 8, 2019
libr Deprecate anal.jmp.eob /refs #13482 ##anal (#15340) Oct 23, 2019
man Add ROP chain execution support in ragg2 ##rop (#13609) Aug 17, 2019
mk Fix macOS build with latest XCode ##build (#15202) Oct 8, 2019
pkgcfg Move trie, mixed, slist into Sdb's Attic, and DES from util to crypto… Nov 7, 2018
shlr Link sdb fully into r_util in meson (#15338) ##build Oct 23, 2019
sys Switch to travis-ci.com Oct 10, 2019
t Fix regressions URL (#15027) Sep 13, 2019
.appveyor.yml Use Inno Setup 6.0 for VS2019 Windows builds (#15160) Oct 4, 2019
.clang-format gcc8 warnings (fixes #10338) (#11798) Oct 12, 2018
.gitignore Enhance `drm` command, add `drm xmm0` functionality (#15214) ##debug Oct 10, 2019
.lgtm.yml Fix LGTM builds May 10, 2019
.travis.yml For utf-8 locale, check LC_ALL, LC_CTYPE and LANG in sequence instead ( Oct 22, 2019
AUTHORS.md More spelling fixes in the code Jun 20, 2019
CONTRIBUTING.md Change radare->radareorg links Oct 7, 2019
COPYING Honor FSF filename license rules (LICENSE->COPYING) Mar 29, 2013
COPYING.LESSER Honor FSF filename license rules (LICENSE->COPYING) Mar 29, 2013
DEVELOPERS.md Change radare->radareorg links Oct 7, 2019
Dockerfile Change radare->radareorg links Oct 7, 2019
Dockerfile.travis Prerelease travis release (#13189) Feb 28, 2019
Doxyfile Initial doxygen config Jun 15, 2018
Makefile Bring back mrproper to fix all the recent build issues Aug 13, 2018
README.md Switch to travis-ci.com Oct 10, 2019
Vagrantfile Add Vagrantfile for radare2 + ArchLinux Dec 18, 2017
Vagrantfile.sh Change radare->radareorg links Oct 7, 2019
autogen.sh Improve autogen.sh to use r2pm if available Oct 15, 2018
config-user.mk.acr Enable capstone5 at configure time option ##disasm May 7, 2019
configure Update version to 4.0.0-git Sep 17, 2019
configure-plugins Fix meson build on macOS May 14, 2017
configure.acr Update version to 4.0.0-git Sep 17, 2019
configure.hook Fix shellcheck problem in scripts Apr 29, 2015
env.sh Add more R2_ prefix for some var Aug 7, 2018
global.mk Avoid hardcoding prefix in global.mk (#11813) Oct 14, 2018
meson.build Update meson.build (#15099) Sep 22, 2019
meson_options.txt Set rpath if non-Windows Meson shared ##build (#15051) Sep 22, 2019
package.json Change radare->radareorg links Oct 7, 2019
plugins.android.cfg Fixes for the android compilations ##build Jul 18, 2019
plugins.bin.cfg Initial implementation of NE file format (#14573) Jul 17, 2019
plugins.def.cfg Add support for the amd29k architecture ##disasm ##r2con2019 Aug 19, 2019
plugins.emscripten.cfg Initial cleanup in RParse, delete mreplace plugin ##disasm Jun 17, 2019
plugins.ios-store.cfg Initial cleanup in RParse, delete mreplace plugin ##disasm Jun 17, 2019
plugins.ios.cfg Initial cleanup in RParse, delete mreplace plugin ##disasm Jun 17, 2019
plugins.nogpl.cfg Initial cleanup in RParse, delete mreplace plugin ##disasm Jun 17, 2019
plugins.static.cfg Add m680x arch support for the meson builds Sep 16, 2019
plugins.static.nogpl.cfg Initial cleanup in RParse, delete mreplace plugin ##disasm Jun 17, 2019
plugins.tiny.cfg Initial cleanup in RParse, delete mreplace plugin ##disasm Jun 17, 2019
radare2.spec SPEC file updated to version 0.10.0 Oct 25, 2015
snapcraft.yaml Change radare->radareorg links Oct 7, 2019
travis-extract-var.sh Prerelease travis release (#13189) Feb 28, 2019
travis-script Continuous Fuzzing Integration with Fuzzit ##build Jun 8, 2019

README.md

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

             https://www.radare.org

                             --pancake
Service Badge
TravisCI Build Status
AppVeyor Build status
FreeBSD (sr.ht) builds.sr.ht status
OpenBSD (sr.ht) builds.sr.ht status
Coverity Build Status
LGTM Total alerts
Infrastructure CII Best Practices
Codecov codecov
Fuzzit fuzzit
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.

You can also use r2lrn or r2golf for a hands-on learning experience.

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 every time 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

You can’t perform that action at this time.