Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/andreafioraldi/angrgdb
Use angr inside GDB. Create an angr state from the current debugger state.
https://github.com/andreafioraldi/angrgdb
angr angrdbg concrete debugger gdb plugin python
Last synced: 3 days ago
JSON representation
Use angr inside GDB. Create an angr state from the current debugger state.
- Host: GitHub
- URL: https://github.com/andreafioraldi/angrgdb
- Owner: andreafioraldi
- License: bsd-2-clause
- Created: 2018-05-10T12:14:49.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2020-07-22T15:30:21.000Z (over 4 years ago)
- Last Synced: 2024-12-30T12:07:32.713Z (11 days ago)
- Topics: angr, angrdbg, concrete, debugger, gdb, plugin, python
- Language: Python
- Size: 52.7 KB
- Stars: 198
- Watchers: 15
- Forks: 25
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# angrgdb
Use angr inside GDB. Create an angr state from the current debugger state.
## Install
```
pip install angrgdb
echo "python import angrgdb.commands" >> ~/.gdbinit
```
## Usage
angrgdb implements the [angrdbg](https://github.com/andreafioraldi/angrdbg) API in GDB.
You can use it in scripts like this:
```python
from angrgdb import *
gdb.execute("b *0x004005f9")
gdb.execute("r aaaaaaaa")
sm = StateManager()
sm.sim(sm["rax"], 100)
m = sm.simulation_manager()
m.explore(find=0x00400607, avoid=0x00400613)
sm.to_dbg(m.found[0]) #write input to GDB
gdb.execute("x/s $rax")
#0x7fffffffe768: "ais3{I_tak3_g00d_n0t3s}"
gdb.execute("c")
#Correct! that is the secret key!
```
You can also use angrgdb commands directly in GDB for simple stuffs:
+ `angrgdb sim [size]` Symbolize a register
+ `angrgdb sim
[size]` Symbolize a memory area
+ `angrgdb list` List all items that you setted as symbolic
+ `angrgdb find ... ` Set the list of find targets
+ `angrgdb avoid ... ` Set the list of avoid targets
+ `angrgdb reset` Reset the context (symbolic values and targets)
+ `angrgdb run` Generate a state from the debugger state and run the exploration
+ `angrgdb shell` Open an shell with a StateManager instance created from the current GDB state
+ `angrgdb interactive` Generate a state from the debugger state and explore by hand using a modified version of [angr-cli](https://github.com/fmagin/angr-cli)
An example crackme solve using angrgdb+GEF+[idb2gdb](https://github.com/andreafioraldi/idb2gdb):
[](https://asciinema.org/a/207571)
### Loading scripts in GDB
This is a tip if you don't want to use angrgdb from the cli but you want to use a python script.
To load a script in GDB use `source script.py`.
## TODO
+ add remote angrdbg like in IDAngr
## Cite
Thesis [PDF](https://arxiv.org/pdf/2006.16601.pdf).
Bibtex:
```
@misc{fioraldi2020symbolic,
title={Symbolic Execution and Debugging Synchronization},
author={Andrea Fioraldi},
year={2020},
eprint={2006.16601},
archivePrefix={arXiv},
primaryClass={cs.CR}
}
```