Go to file
pancake f27b8d9bfb Support loading/unloading multiple QJS plugins ##js
* This is a hacky and experimental feature, without
* breaking the ABI for all the Core plugins this is
* not possible to be done properly, so i'll keep it
* until 5.9, also rlib api is also unable to unload
* plugins, which will require more breaking changes
2022-12-29 21:29:16 +01:00
.github Add --with-ssl-crypto, rename --with-openssl to --with-ssl ##build (#21213) 2022-12-29 16:57:00 +01:00
binr Also replace __UNIX__ with R2__UNIX__ 2022-12-10 20:32:10 +01:00
dist Fix #21196 - e?? not printing config var 2022-12-24 17:52:01 +01:00
doc Fix fortune message for #md5 and add ph: variant of "ph " ##print 2022-12-24 16:41:29 +01:00
libr Support loading/unloading multiple QJS plugins ##js 2022-12-29 21:29:16 +01:00
man Add the ability to run qjs scripts with `r2 -je` ##shell 2022-12-23 13:09:46 +01:00
mk Also replace __UNIX__ with R2__UNIX__ 2022-12-10 20:32:10 +01:00
pkgcfg Merge RParse into RAsm ##api 2022-12-03 02:26:41 +01:00
shlr Support loading/unloading multiple QJS plugins ##js 2022-12-29 21:29:16 +01:00
sys Use fakeroot if available when packaging for debian ##build 2022-12-24 17:54:25 +01:00
test Add some test for ARM assembler ##test 2022-12-29 11:39:15 +01:00
.clang-format Some clang-format improvements ##indent 2021-01-25 00:34:58 +01:00
.gitignore Move the arm assembler plugin from asm to arch ##arch 2022-11-30 15:43:54 +01:00
.lgtm.yml Fix LGTM builds 2019-05-10 16:21:29 +08:00
COMMUNITY.md Improve wording of COMMUNITY.md 2022-05-30 19:35:37 +02:00
CONTRIBUTING.md Rewrite user-facing documentation (#19543) 2022-01-01 06:11:46 -06: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 Increase maximum recommended line length ##doc 2022-07-19 18:54:20 +02:00
INSTALL.md Minor updates to README.md (#19546) 2022-01-06 18:05:42 +01:00
Makefile Import the quickjs rlang plugin ##lang 2022-12-10 18:58:33 +01:00
README.md Release 5.8.0 - codename: icebucket 2022-12-23 00:40:31 +01:00
SECURITY.md Rewrite user-facing documentation (#19543) 2022-01-01 06:11:46 -06:00
USAGE.md Rewrite user-facing documentation (#19543) 2022-01-01 06:11:46 -06:00
autogen.sh Take care of package.json when running autogen 2022-02-26 01:45:20 +01:00
config-user.mk.acr Add --with-ssl-crypto, rename --with-openssl to --with-ssl ##build (#21213) 2022-12-29 16:57:00 +01:00
configure Add --with-ssl-crypto, rename --with-openssl to --with-ssl ##build (#21213) 2022-12-29 16:57:00 +01:00
configure-plugins Initial implementation of the arch.any.as plugin ##arch 2022-11-30 15:43:54 +01:00
configure.acr Add --with-ssl-crypto, rename --with-openssl to --with-ssl ##build (#21213) 2022-12-29 16:57:00 +01:00
configure.bat Windows builds include debug information by default ##build 2022-06-22 00:56:29 +02:00
configure.hook Create dist/ to hold all the distribution build files ##build (#18131) 2020-12-31 18:57:05 +01:00
env.sh Add more R2_ prefix for some var 2018-08-07 22:14:54 +02:00
global.mk Improve output for make -s and fix magic install with symlinks issue (#18781) 2021-05-30 23:46:58 +02:00
make.bat Simplify meson logic and use ole's PR to fix Windows ##build 2022-01-31 23:54:00 +01:00
meson.build Add --with-ssl-crypto, rename --with-openssl to --with-ssl ##build (#21213) 2022-12-29 16:57:00 +01:00
meson_options.txt Add --with-ssl-crypto, rename --with-openssl to --with-ssl ##build (#21213) 2022-12-29 16:57:00 +01:00
preconfigure Fix and move failing tests, reorder lib build ##arch 2022-11-30 15:43:54 +01:00
preconfigure.bat Update v35arm64 to fix build on riscv ##build 2022-06-10 01:10:12 +02:00
vsfix.bat Update sdb to remove double include paths ##build 2022-11-19 01:05:18 +01:00

README.md

screenshot

Radare2: Libre Reversing Framework for Unix Geeks

Latest packaged version Tests Status build tcc CII Best Practices Build Status Total alerts TODO GLOBALSXXX Discord

See the Releases page for downloads. The current git master branch is 5.8.1, next will be 5.8.2.

  • Since r2-5.6.0 all the patch releases are abi stable
  • Odd patch versions are used in git builds only, releases use even numbers
  • No need to recompile the plugins, bindings or tools if the major and minor version are the same

Description

r2 is a complete rewrite of radare. It provides a set of libraries, tools and plugins to ease reverse engineering tasks. Distributed mostly under LGPLv3, each plugin can have different licenses (see r2 -L, rasm2 -L, ...).

The radare project started as a simple command-line hexadecimal editor focused on forensics. Today, r2 is a featureful low-level command-line tool with support for scripting. r2 can edit files on local hard drives, view kernel memory, and debug programs locally or via a remote gdb server. r2's wide architecture support allows you to analyze, emulate, debug, modify, and disassemble any binary.

screenshot

Installation

  • r2 can be installed from git or via pip using r2env.
  • Run sys/install.sh for the default acr+make+symlink installation
  • meson/ninja (muon/samu also works) and make builds are supported.
  • Windows builds require meson and msvc or mingw as compilers
  • To uninstall the current build of r2 run make uninstall
  • To uninstall ALL the system installations of r2 do: sudo make purge
git clone https://github.com/radareorg/radare2
radare2/sys/install.sh

Default Windows builds use MSVC, so run those .bat:

preconfigure.bat       REM setup python, meson, ninja
configure.bat          REM run meson b + vs project
make.bat               REM run ninja -C b
prefix\bin\radare2.exe

Alternatively you can use r2env to switch between different versions.

pip install -U r2env
r2env init
r2env add radare2@git

Usage

These are the first steps to use r2, read the book or find tutorials for more details

$ r2 /bin/ls   # open the binary in read-only mode
> aaa          # same as r2 -A, analyse the binary
> afl          # list all functions (try aflt, aflm)
> px 32        # print 32 byte hexdump current block
> s sym.main   # seek to the given offset (by flag name, number, ..)
> f~foo        # filter flags with ~grep (same as |grep)
> iS;is        # list sections and symbols (same as rabin2 -Ss)
> pdf; agf     # print function and show control-flow-graph in ascii-art
> oo+;w hello  # reopen in rw mode and write a string in the current offset
> ?*~...       # interactive filter all command help messages
> q            # quit

Resources

Plugins

Many plugins are included in r2 by default. But you can extend its capabilities by using the r2pm package manager.

r2pm -s <word> # search package by word
r2pm -ci <pkg> # install a package

Most popular packages are:

  • esilsolve: The symbolic execution plugin, based on esil and z3
  • iaito: The official Qt graphical interface
  • radius2: A fast symbolic execution engine based on boolector and esil
  • r2dec: A decompiler based on r2 written in JS, accessed with the pdd command
  • r2ghidra: The native ghidra decompiler plugin, accessed with the pdg command
  • r2frida: The frida io plugin. Start r2 with r2 frida://0 to use it

Contributing

There are many ways to contribute to the project. Contact the community, check out the github issues, or grep for TODO/FIXME/XXX comments in the source.

To contribute code, push your changes to a branch on your fork of the repository. Please ensure that you follow the coding and style guidelines and that your changes pass the testing suite, which you can run with the r2r tool. If you are adding significant code, it may be necessary to modify or add additional tests in the test/ directory.

For more details, see CONTRIBUTING.md and DEVELOPERS.md.

Documentation

To learn more about r2 we encourage you to watch youtube talks from r2con. In addition to reading blogposts, slides or the official radare2 book, here are some methods to contact us:

Community

Supported Platforms

Operating Systems

Windows (since XP), Linux, Darwin, GNU/Hurd, Apple's {Mac,i,iPad,watch}OS, Android, [Dragonfly, Net, Free, Open] BSD, Z/OS, QNX, SerenityOS, Solaris, Haiku, Vinix, FirefoxOS.

Architectures

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

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, WAD, OFF, TIC-80 Game Boy (Advance), Nintendo DS ROMs and Nintendo 3DS FIRMs, various filesystems.

Packaging Status

  • Termux package
  • Alpine Linux Edge package Alpine Linux 3.13 package Alpine Linux 3.12 package
  • Arch package AUR package
  • Fedora Dev Fedora 36 Fedora 34
  • FreeBSD port OpenBSD port pkgsrc current package
  • Homebrew package MacPorts package
  • Haiku Ports Void Linux
  • Ubuntu 22.10 package Ubuntu 20.04 package Ubuntu 18.04 package
  • Debian Unstable package Raspbian Stable package Kali Linux Rolling package