Skip to content

Commit

Permalink
Fix the url
Browse files Browse the repository at this point in the history
  • Loading branch information
XVilka committed Jun 15, 2020
1 parent 4d782c8 commit 46d3866
Show file tree
Hide file tree
Showing 22 changed files with 49 additions and 67 deletions.
18 changes: 0 additions & 18 deletions intro.md

This file was deleted.

6 changes: 3 additions & 3 deletions package.json
Original file line number Diff line number Diff line change
Expand Up @@ -9,14 +9,14 @@
},
"repository": {
"type": "git",
"url": "git+https://github.com/radare/radare2book.git"
"url": "git+https://github.com/radareorg/radare2book.git"
},
"author": "",
"license": "ISC",
"bugs": {
"url": "https://github.com/radare/radare2book/issues"
"url": "https://github.com/radareorg/radare2book/issues"
},
"homepage": "https://github.com/radare/radare2book#readme",
"homepage": "https://github.com/radareorg/radare2book#readme",
"dependencies": {
"gitbook-cli": "^2.3.2"
}
Expand Down
2 changes: 1 addition & 1 deletion src/analysis/variables.md
Original file line number Diff line number Diff line change
Expand Up @@ -115,7 +115,7 @@ local_32h

The type inference for local variables and arguments is well integrated with the command `afta`.

Let's see an example of this with a simple [hello_world](https://github.com/radare/radare2book/tree/master/examples/hello_world) binary
Let's see an example of this with a simple [hello_world](https://github.com/radareorg/radare2book/tree/master/examples/hello_world) binary

```
[0x000007aa]> pdf
Expand Down
4 changes: 2 additions & 2 deletions src/crackmes/avatao/01-reverse4/radare2.md
Original file line number Diff line number Diff line change
Expand Up @@ -72,6 +72,6 @@ use the git version!
Some highly recommended reading materials:

- [Cheatsheet by pwntester](https://github.com/pwntester/cheatsheets/blob/master/radare2.md)
- [Radare2 Book](https://www.gitbook.com/book/radare/radare2book/details)
- [Radare2 Book](https://www.gitbook.com/book/radareorg/radare2book/details)
- [Radare2 Blog](http://radare.today)
- [Radare2 Wiki](https://github.com/radare/radare2/wiki)
- [Radare2 Wiki](https://github.com/radareorg/radare2/wiki)
2 changes: 1 addition & 1 deletion src/crackmes/avatao/01-reverse4/vmloop.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ reverse yet. The thing is that this function uses a jump table at 0x00400a74,
![vmloop bb-0a74](img/vmloop/bb-0a74.png)

and r2 can't yet recognize jump tables
([Issue 3201](https://github.com/radare/radare2/issues/3201)), so the analysis of
([Issue 3201](https://github.com/radareorg/radare2/issues/3201)), so the analysis of
this function is a bit incomplete. This means that we can't really use the graph
view now, so either we just use visual mode, or fix those basic blocks. The
entire function is just 542 bytes long, so we certainly could reverse it without
Expand Down
2 changes: 1 addition & 1 deletion src/crackmes/ioli/intro.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,4 +3,4 @@ IOLI CrackMes

The IOLI crackme is a good starting point for learning r2. This is a set of tutorials based on the tutorial at [dustri](http://dustri.org/b/defeating-ioli-with-radare2.html)

The IOLI crackmes are available at a locally hosted [mirror](https://github.com/radare/radare2book/tree/master/crackmes/ioli/IOLI-crackme.tar.gz)
The IOLI crackmes are available at a locally hosted [mirror](https://github.com/radareorg/radare2book/tree/master/crackmes/ioli/IOLI-crackme.tar.gz)
4 changes: 2 additions & 2 deletions src/debugger/migration.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ Use `rarun2` (`libpath=$PWD:/tmp/lib`, `arg2=hello`, `setenv=FOO=BAR` ...) see `

`[0x80480423]> #!c` - enter C repl (see `#!` to list all available RLang plugins) => [[video](http://asciinema.org/a/12019)], everything have to be done in a oneliner or a .c file must be passed as an argument.

To get `#!python` and much more, just build [radare2-bindings](https://github.com/radare/radare2-bindings)
To get `#!python` and much more, just build [radare2-bindings](https://github.com/radareorg/radare2-bindings)

## How to list Source code as in gdb list ?

Expand Down Expand Up @@ -73,7 +73,7 @@ To get `#!python` and much more, just build [radare2-bindings](https://github.co
|step over |`F8` |`dso` | `S` | `s` | `p`
|step until a specific address|?|`dsu <addr>` | ? | `s` | `g <addr>`
|Run until return|`Ctrl+F7` |`dcr` | ? | `finish` | `gu`
|Run until cursor|`F4` |[#249](https://github.com/radare/radare2/issues/249)| [#249](https://github.com/radare/radare2/issues/249) | N/A | N/A
|Run until cursor|`F4` |[#249](https://github.com/radareorg/radare2/issues/249)| [#249](https://github.com/radareorg/radare2/issues/249) | N/A | N/A
|Show Backtrace |`?` |`dbt` | ? | `bt` |
|display Register|On register Windows|`dr all` | Shown in Visual mode | `info registers` | `r`
|display eax |On register Windows |`dr?eax` | Shown in Visual mode | `info registers eax` | `r rax`
Expand Down
2 changes: 1 addition & 1 deletion src/disassembling/adding_metadata.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
The typical work involved in reversing binary files makes powerful annotation capabilities essential.
Radare offers multiple ways to store and retrieve such metadata.

By following common basic UNIX principles, it is easy to write a small utility in a scripting language which uses `objdump`, `otool` or any other existing utility to obtain information from a binary and to import it into radare. For example, take a look at `idc2r.py` shipped with [radare2ida](https://github.com/radare/radare2ida). To use it, invoke it as `idc2r.py file.idc > file.r2`. It reads an IDC file exported from an IDA Pro database and produces an r2 script containing the same comments, names of functions and other data. You can import the resulting 'file.r2' by using the dot `.` command of radare:
By following common basic UNIX principles, it is easy to write a small utility in a scripting language which uses `objdump`, `otool` or any other existing utility to obtain information from a binary and to import it into radare. For example, take a look at `idc2r.py` shipped with [radare2ida](https://github.com/radareorg/radare2ida). To use it, invoke it as `idc2r.py file.idc > file.r2`. It reads an IDC file exported from an IDA Pro database and produces an r2 script containing the same comments, names of functions and other data. You can import the resulting 'file.r2' by using the dot `.` command of radare:
```
[0x00000000]> . file.r2
```
Expand Down
2 changes: 1 addition & 1 deletion src/first_steps/compilation_portability.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ $ sys/static.sh
```
### Docker

Radare2 repository ships a [Dockerfile](https://github.com/radare/radare2/blob/master/Dockerfile) that you can use with Docker.
Radare2 repository ships a [Dockerfile](https://github.com/radareorg/radare2/blob/master/Dockerfile) that you can use with Docker.

This dockerfile is also used by Remnux distribution from SANS, and is available on the docker [registryhub](https://registry.hub.docker.com/u/remnux/radare2/).

Expand Down
4 changes: 2 additions & 2 deletions src/first_steps/contributing.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

### Radare2 Book

If you want to contribute to the Radare2 book, you can do it at the [Github repository](https://github.com/radare/radare2book).
If you want to contribute to the Radare2 book, you can do it at the [Github repository](https://github.com/radareorg/radare2book).
Suggested contributions include:

* Crackme writeups
Expand All @@ -14,5 +14,5 @@ Suggested contributions include:

Please get permission to port any content you do not own/did not create before you put it in the Radare2 book.

See <https://github.com/radare/radare2/blob/master/DEVELOPERS.md> for general help on contributing to radare2.
See <https://github.com/radareorg/radare2/blob/master/DEVELOPERS.md> for general help on contributing to radare2.

4 changes: 2 additions & 2 deletions src/first_steps/getting_radare.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
## Downloading radare2

You can get radare from the website, [http://radare.org](http://radare.org),
or the GitHub repository: [https://github.com/radare/radare2](https://github.com/radare/radare2)
or the GitHub repository: [https://github.com/radareorg/radare2](https://github.com/radareorg/radare2)


Binary packages are available for a number of operating systems (Ubuntu, Maemo, Gentoo, Windows, iPhone, and so on). Yet, you are highly encouraged to get the source and compile it yourself to better understand the dependencies, to make examples more accessible and of course to have the most recent version.
Expand All @@ -10,7 +10,7 @@ A new stable release is typically published every month. Nightly tarballs are so

The radare development repository is often more stable than the 'stable' releases. To obtain the latest version:
```
$ git clone https://github.com/radare/radare2.git
$ git clone https://github.com/radareorg/radare2.git
```
This will probably take a while, so take a coffee break and continue reading this book.

Expand Down
6 changes: 3 additions & 3 deletions src/first_steps/history.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,12 +13,12 @@ After that, pancake decided to extend the tool to have a pluggable io to be able

Since then, the project has evolved to provide a complete framework for analyzing binaries, while making use of basic UNIX concepts. Those concepts include the famous "everything is a file", "small programs that interact using stdin/stdout", and "keep it simple" paradigms.

The need for scripting showed the fragility of the initial design: a monolithic tool made the API hard to use, and so a deep refactoring was needed. In 2009 radare2 (r2) was born as a fork of radare1. The refactor added flexibility and dynamic features. This enabled much better integration, paving the way to use r2 [from different programming languages](https://github.com/radare/radare2-bindings). Later on, the [r2pipe API](https://github.com/radare/radare2-r2pipe) allowed access to radare2 via pipes from any language.
The need for scripting showed the fragility of the initial design: a monolithic tool made the API hard to use, and so a deep refactoring was needed. In 2009 radare2 (r2) was born as a fork of radare1. The refactor added flexibility and dynamic features. This enabled much better integration, paving the way to use r2 [from different programming languages](https://github.com/radareorg/radare2-bindings). Later on, the [r2pipe API](https://github.com/radareorg/radare2-r2pipe) allowed access to radare2 via pipes from any language.

What started as a one-man project, with some eventual contributions, gradually evolved into a big community-based project around 2014. The number of users was growing fast, and the author-and main developer-had to switch roles from coder to manager in order to integrate the work of the different developers that were joining the project.

Instructing users to report their issues allows the project to define new directions to evolve in. Everything is managed in [radare2's GitHub](https://github.com/radare/radare2) and discussed in the Telegram channel.
Instructing users to report their issues allows the project to define new directions to evolve in. Everything is managed in [radare2's GitHub](https://github.com/radareorg/radare2) and discussed in the Telegram channel.

The project remains active at the time of writing this book, and there are several side projects that provide, among other things, a graphical user interface ([Cutter](https://github.com/radareorg/cutter)), a decompiler ([r2dec](https://github.com/wargio/r2dec-js), [radeco](https://github.com/radareorg/radeco)), Frida integration ([r2frida](https://github.com/nowsecure/r2frida)), Yara, Unicorn, Keystone, and many other projects indexed in the [r2pm](https://github.com/radare/radare2-pm) (the radare2 package manager).
The project remains active at the time of writing this book, and there are several side projects that provide, among other things, a graphical user interface ([Cutter](https://github.com/radareorg/cutter)), a decompiler ([r2dec](https://github.com/wargio/r2dec-js), [radeco](https://github.com/radareorg/radeco)), Frida integration ([r2frida](https://github.com/nowsecure/r2frida)), Yara, Unicorn, Keystone, and many other projects indexed in the [r2pm](https://github.com/radareorg/radare2-pm) (the radare2 package manager).

Since 2016, the community gathers once a year in [r2con](https://www.radare.org/con/), a congress around radare2 that takes place in Barcelona.
2 changes: 1 addition & 1 deletion src/first_steps/windows_compilation.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,7 @@ Follow these steps to install Git for Windows.
Follow these steps to clone the Radare2 git repository.

1. In your Radare2 Conda environment, navigate to a location where the code will be saved and compiled. This location needs approximately **3-4GiB** of space
2. Clone the repository with `git clone https://github.com/radare/radare2.git`
2. Clone the repository with `git clone https://github.com/radareorg/radare2.git`

#### Compile Radare2 Code
Follow these steps to compile the Radare2 Code.
Expand Down
6 changes: 3 additions & 3 deletions src/plugins/dev-anal.md
Original file line number Diff line number Diff line change
Expand Up @@ -111,10 +111,10 @@ After compiling radare2 will list this plugin in the output:
_dA_ _8_16 snes LGPL3 SuperNES CPU
```

**snes_op_table**.h: https://github.com/radare/radare2/blob/master/libr/asm/arch/snes/snes_op_table.h
**snes_op_table**.h: https://github.com/radareorg/radare2/blob/master/libr/asm/arch/snes/snes_op_table.h

Example:

* **6502**: https://github.com/radare/radare2/commit/64636e9505f9ca8b408958d3c01ac8e3ce254a9b
* **SNES**: https://github.com/radare/radare2/commit/60d6e5a1b9d244c7085b22ae8985d00027624b49
* **6502**: https://github.com/radareorg/radare2/commit/64636e9505f9ca8b408958d3c01ac8e3ce254a9b
* **SNES**: https://github.com/radareorg/radare2/commit/60d6e5a1b9d244c7085b22ae8985d00027624b49

4 changes: 2 additions & 2 deletions src/plugins/dev-asm.md
Original file line number Diff line number Diff line change
Expand Up @@ -113,9 +113,9 @@ List of affected files:
Check out how the NIOS II CPU disassembly plugin was implemented by reading those commits:
Implement RAsm plugin:
https://github.com/radare/radare2/commit/933dc0ef6ddfe44c88bbb261165bf8f8b531476b
https://github.com/radareorg/radare2/commit/933dc0ef6ddfe44c88bbb261165bf8f8b531476b
Implement RAnal plugin:
https://github.com/radare/radare2/commit/ad430f0d52fbe933e0830c49ee607e9b0e4ac8f2
https://github.com/radareorg/radare2/commit/ad430f0d52fbe933e0830c49ee607e9b0e4ac8f2
10 changes: 5 additions & 5 deletions src/plugins/dev-bin.md
Original file line number Diff line number Diff line change
Expand Up @@ -101,9 +101,9 @@ R_API RLibStruct radare_plugin = {
### Some Examples
* XBE - https://github.com/radare/radare2/pull/972
* COFF - https://github.com/radare/radare2/pull/645
* TE - https://github.com/radare/radare2/pull/61
* Zimgz - https://github.com/radare/radare2/commit/d1351cf836df3e2e63043a6dc728e880316f00eb
* OMF - https://github.com/radare/radare2/commit/44fd8b2555a0446ea759901a94c06f20566bbc40
* XBE - https://github.com/radareorg/radare2/pull/972
* COFF - https://github.com/radareorg/radare2/pull/645
* TE - https://github.com/radareorg/radare2/pull/61
* Zimgz - https://github.com/radareorg/radare2/commit/d1351cf836df3e2e63043a6dc728e880316f00eb
* OMF - https://github.com/radareorg/radare2/commit/44fd8b2555a0446ea759901a94c06f20566bbc40
24 changes: 12 additions & 12 deletions src/plugins/dev-other.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,21 +12,21 @@ If you want to add support for the gdb, you can see the register profile in the

Some commits related to "Implementing a new architecture"

* Extensa: https://github.com/radare/radare2/commit/6f1655c49160fe9a287020537afe0fb8049085d7
* Malbolge: https://github.com/radare/radare2/pull/579
* 6502: https://github.com/radare/radare2/pull/656
* h8300: https://github.com/radare/radare2/pull/664
* GBA: https://github.com/radare/radare2/pull/702
* CR16: https://github.com/radare/radare2/pull/721/ && 726
* XCore: https://github.com/radare/radare2/commit/bb16d1737ca5a471142f16ccfa7d444d2713a54d
* Extensa: https://github.com/radareorg/radare2/commit/6f1655c49160fe9a287020537afe0fb8049085d7
* Malbolge: https://github.com/radareorg/radare2/pull/579
* 6502: https://github.com/radareorg/radare2/pull/656
* h8300: https://github.com/radareorg/radare2/pull/664
* GBA: https://github.com/radareorg/radare2/pull/702
* CR16: https://github.com/radareorg/radare2/pull/721/ && 726
* XCore: https://github.com/radareorg/radare2/commit/bb16d1737ca5a471142f16ccfa7d444d2713a54d
* SharpLH5801: https://github.com/neuschaefer/radare2/commit/f4993cca634161ce6f82a64596fce45fe6b818e7
* MSP430: https://github.com/radare/radare2/pull/1426
* HP-PA-RISC: https://github.com/radare/radare2/commit/f8384feb6ba019b91229adb8fd6e0314b0656f7b
* V810: https://github.com/radare/radare2/pull/2899
* TMS320: https://github.com/radare/radare2/pull/596
* MSP430: https://github.com/radareorg/radare2/pull/1426
* HP-PA-RISC: https://github.com/radareorg/radare2/commit/f8384feb6ba019b91229adb8fd6e0314b0656f7b
* V810: https://github.com/radareorg/radare2/pull/2899
* TMS320: https://github.com/radareorg/radare2/pull/596

## Implementing a new pseudo architecture

This is an simple plugin for z80 that you may use as example:

https://github.com/radare/radare2/commit/8ff6a92f65331cf8ad74cd0f44a60c258b137a06
https://github.com/radareorg/radare2/commit/8ff6a92f65331cf8ad74cd0f44a60c258b137a06
2 changes: 1 addition & 1 deletion src/plugins/dev.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ Bear in mind that plugins can be compiled static or dynamically, this means that

To configure which plugins you want to compile use the `./configure-plugins` script which accepts the flags --shared and --static to specify them. You can also add it manually inside the `plugins.def.cfg` and then remove the `plugins.cfg` and run `./configure-plugins` again to update the `libr/config.mk` and `libr/config.h`.

You may find some examples of external plugins in [radare2-extras](https://github.com/radare/radare2-extras) repository.
You may find some examples of external plugins in [radare2-extras](https://github.com/radareorg/radare2-extras) repository.

## Writing the r_asm plugin

Expand Down
4 changes: 2 additions & 2 deletions src/plugins/python.md
Original file line number Diff line number Diff line change
Expand Up @@ -109,8 +109,8 @@ Or you can load it from the r2 shell: `#!python mycpu.py`

See also:

* [Python](https://github.com/radare/radare2-bindings/blob/master/libr/lang/p/test-py-asm.py)
* [Javascript](https://github.com/radare/radare2-bindings/blob/master/libr/lang/p/dukasm.js)
* [Python](https://github.com/radareorg/radare2-bindings/blob/master/libr/lang/p/test-py-asm.py)
* [Javascript](https://github.com/radareorg/radare2-bindings/blob/master/libr/lang/p/dukasm.js)

### Implementing new format plugin in Python

Expand Down
2 changes: 1 addition & 1 deletion src/scripting/r2pipe.md
Original file line number Diff line number Diff line change
Expand Up @@ -72,7 +72,7 @@ r2pipe.open('/bin/ls', (err, res) => {

Checkout the GIT repository for more examples and details.

https://github.com/radare/radare2-r2pipe/blob/master/nodejs/r2pipe/README.md
https://github.com/radareorg/radare2-r2pipe/blob/master/nodejs/r2pipe/README.md

Go
--
Expand Down
6 changes: 3 additions & 3 deletions src/tools/r2pm/intro.md
Original file line number Diff line number Diff line change
@@ -1,14 +1,14 @@
## Radare2 package manager

Radare2 has its own package manager for managing external plugins (mainly from
[radare2-extras](https://github.com/radare/radare2-extras)). As most of the package managers it allows you to install, remove or update packages (plugins). There is one restriction though - currently it supports only the compilation from sources, so providing the toolchan, necessary build tools and dependencies for each plugin is the user responsibility. It might change in the future.
[radare2-extras](https://github.com/radareorg/radare2-extras)). As most of the package managers it allows you to install, remove or update packages (plugins). There is one restriction though - currently it supports only the compilation from sources, so providing the toolchan, necessary build tools and dependencies for each plugin is the user responsibility. It might change in the future.

```
$ r2pm -h
$R2PM_DBDIR: No such file or directory.
Run 'r2pm init' to initialize the package repository
$ r2pm init
git clone https://github.com/radare/radare2-pm
git clone https://github.com/radareorg/radare2-pm
Cloning into 'radare2-pm'...
remote: Counting objects: 147, done.
remote: Compressing objects: 100% (139/139), done.
Expand All @@ -19,7 +19,7 @@ Resolving deltas: 100% (26/26), done.
r2pm database initialized. Use 'r2pm update' to update later today
```

As you noticed, the packages database located at [radare2-pm](https://github.com/radare/radare2-pm)
As you noticed, the packages database located at [radare2-pm](https://github.com/radareorg/radare2-pm)
repository. At any point of the time we can update the database using `r2pm update`:

```
Expand Down
Binary file modified translations/radare2book-persian.pdf
Binary file not shown.

0 comments on commit 46d3866

Please sign in to comment.