Skip to content

Commit

Permalink
Better wording for the overview and sync contributor's list
Browse files Browse the repository at this point in the history
  • Loading branch information
radare committed Jun 26, 2024
1 parent cefc48b commit 6acefb4
Show file tree
Hide file tree
Showing 2 changed files with 170 additions and 87 deletions.
219 changes: 145 additions & 74 deletions src/credits/credits.md
Original file line number Diff line number Diff line change
@@ -1,82 +1,153 @@
## Authors & Contributors
## Authors And Contributors

This book wouldn't be possible without the help of a large list of contributors who have been reviewing, writing and reporting bugs and stuff in the radare2 project as well as in this book.

### The radare2 book

This book was started by maijin as a new version of the original radare book written by pancake.
The original [radare book](http://www.radare.org/get/radare.pdf) was written by pancake, the work towards syncing it with the latest radare2 was started by Maijin, nowadays this book is mainly maintained by pancake again and updated in a collaborative way by the community.

* Old radare1 book [http://www.radare.org/get/radare.pdf](http://www.radare.org/get/radare.pdf)
Many thanks to everyone who have contributed to this book.

Many thanks to everyone who has been involved with the gitbook:
```
$ git log | grep ^Author | cut -d ':' -f 2- | cut -d '<' -f 1 | sort -u |xargs echo '* '
```

Adrian Studer,
Ahmed Mohamed Abd El-MAwgood,
Akshay Krishnan R,
Andrew Hoog,
Anton Kochkov,
Antonio Sánchez,
Austin Hartzheim,
Aswin C (officialcjunior),
Bob131,
DZ_ruyk,
David Tomaschik,
Eric,
Fangrui Song,
Francesco Tamagni,
FreeArtMan,
Gerardo García Peña,
Giuseppe,
Grigory Rechistov,
Hui Peng,
ITAYC0HEN,
Itay Cohen,
Jeffrey Crowell,
John,
Judge Dredd (key 6E23685A),
Jupiter,
Kevin Grandemange,
Kevin Laeufer,
Luca Di Bartolomeo,
Lukas Dresel,
Maijin,
Michael Scherer,
Mike,
Nikita Abdullin,
Paul,
Paweł Łukasik,
Peter C,
RandomLive,
Ren Kimura,
Reto Schneider,
SchumBlubBlub,
SkUaTeR,
Solomon,
Srimanta Barua,
Sushant Dinesh,
TDKPS,
Thanat0s,
Vanellope,
Vex Woo,
Vorlent,
XYlearn,
Yuri Slobodyanyuk,
ali,
aoighost,
condret,
hdznrrd,
izhuer,
jvoisin,
kij,
madblobfish,
muzlightbeer,
pancake,
polym (Tim),
puddl3glum,
radare,
sghctoma,
shakreiner,
sivaramaaa,
taiyu,
vane11ope,
xarkes.
* 7flying
* Adrian Studer
* Agustín Dall'Alba
* Ahmed Mohamed Abd El-MAwgood
* Akshay Krishnan R
* Ali Raheem
* Andrew Hoog
* Anton Kochkov
* Antonio Sánchez
* Apkunpacker
* Aswin
* Aswin C
* Austin Hartzheim
* Bob131
* Braiden Kindt
* Connor Armand Du Plooy
* Cyrill Leutwiler
* DZ_ruyk
* David Tomaschik
* Deepak Chethan
* Dennis Goodlett
* Dennis van der Schagt
* Dāvis
* Enshin Andrey
* Eric
* Evgeny Cherkashin
* Fangrui Song
* Francesco Tamagni
* FreeArtMan
* Gerardo García Peña
* Giovanni
* Giovanni Dante Grazioli
* Giuseppe
* Grigory Rechistov
* GustavoLCR
* Heersin
* Hui Peng
* ITAYC0HEN
* Itay Cohen
* Jacob Rosenthal
* Jeffrey Crowell
* John
* Judge Dredd (key 6E23685A)
* Jupiter
* Jürgen Hötzel
* Kali Kaneko
* Kevin Grandemange
* Kevin Laeufer
* LGTM Migrator
* Lazula
* Lev Aronsky
* Liumeo
* Luca Di Bartolomeo
* Lukas Dresel
* Maijin
* Martin Brunner
* Michael Scherer
* Michele
* Mike
* Nikita Abdullin
* Nikolaos Chatzikonstantinou
* Pau RE
* Paul
* Paweł Łukasik
* Peter C
* Rafael Rivera
* RandomLive
* Ren Kimura
* Reto Schneider
* Riccardo Schirone
* Roman Valls Guimera
* Ryan Geary
* SchumBlubBlub
* SkUaTeR
* Solomon
* Sophie Chen
* Srimanta Barua
* Sushant Dinesh
* Sylvain Pelissier
* TDKPS
* Thanat0s
* Tomasz Różański
* Vanellope
* Vasilij Schneidermann
* Vex Woo
* Vitaly Bogdanov
* Vorlent
* XYlearn
* Yuri Slobodyanyuk
* Zelalem Mekonnen
* Zi Fan
* adwait1-g
* aemmitt-ns
* ali
* aoighost
* ayedaemon
* ckanibal
* condret
* dependabot[bot]
* dodococo
* dreamist
* gogo
* gogo2464
* grepharder
* h0pp
* hdznrrd
* hmht
* ivan tkachenko
* izhuer
* jvoisin
* karliss
* kij
* krmpotic
* leongross
* lowsec
* madblobfish
* meowmeowxw
* mrmacete
* ms111ds
* muzlightbeer
* officialcjunior
* pancake
* pickDefault
* polym (Tim)
* puddl3glum
* ratijas
* sghctoma
* shakreiner
* sivaramaaa
* taiyu
* tick
* vane11ope
* xarkes
* xunoaib
* yep
* yossizap
* yurayake
* Óscar Carrasco
* Florian Best
38 changes: 25 additions & 13 deletions src/first_steps/overview.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
## The Framework

The Radare2 project is a set of small command-line utilities that can be used together or independently.
The Radare2 project provides a collection of command-line tools, APIs and scripting capabilities that focus on several aspects of reverse engineering.

This chapter will give you a quick understanding of them, but you can check the dedicated sections for each tool at the end of this book.

Expand All @@ -19,19 +19,17 @@ A program to extract information from executable binaries, such as ELF, PE, Java
A command line assembler and disassembler for multiple architectures (including Intel x86 and x86-64, MIPS, ARM, PowerPC, Java, and myriad of others).

#### Examples

```
$ rasm2 -a java 'nop'
00
```
```
$ rasm2 -a x86 -d '90'
nop
```
```
$ rasm2 -a x86 -b 32 'mov eax, 33'
b821000000
```
```
$ echo 'push eax;nop;nop' | rasm2 -f -
509090
```
Expand All @@ -58,9 +56,19 @@ A binary diffing utility that implements multiple algorithms. It supports byte-l

A program to find byte patterns in files.

Implements the most common subcommand of the radare2's `/` (search) command.

### ragg2

A frontend for r_egg. ragg2 compiles programs written in a simple high-level language into tiny binaries for x86, x86-64, and ARM.
Ragg2 is a versatile tool primarily serving as a shellcode compiler.

The tool is written on top of the `r_egg` library which can construct exploit payloads from the commandline, adding paddings, nops, sequences of bytes, compile small relocatable programs and even apply transformations to avoid some specific characters.

The `ragg2-cc` tool can compile C programs into raw linear instructions that are relocatable and are useful for injecting them in target processes or use them in exploits.

This feature is conceptually based on shellforge4, but only linux/osx x86-32/64 platforms are supported.

It can also compile a specific low level domain specific language and generate tiny binaries without the need of any system compiler or toolchain as exemplified below:

#### Examples

Expand Down Expand Up @@ -99,7 +107,8 @@ permissions, directories, and overridden default file descriptors. rarun2 is use
* Test suites

#### Sample rarun2 script
```

```bash
$ cat foo.rr2
#!/usr/bin/rarun2
program=./pp400
Expand All @@ -110,7 +119,8 @@ chdir=/tmp
./foo.rr2
```

#### Connecting a Program with a Socket
#### Using a program via TCP/IP

```
$ nc -l 9999
$ rarun2 program=/bin/ls connect=localhost:9999
Expand All @@ -126,15 +136,17 @@ $ tty ; clear ; sleep 999999
```

2 - Create a new file containing the following rarun2 profile named foo.rr2:
```

```sh
#!/usr/bin/rarun2
program=/bin/ls
stdio=/dev/ttys010
```

3 - Launch the following radare2 command:
```
r2 -r foo.rr2 -d /bin/ls

```bash
$ r2 -r foo.rr2 -d /bin/ls
```

### rax2
Expand Down

0 comments on commit 6acefb4

Please sign in to comment.