<commit_before># GEF - GDB Enhanced Features  [![Documentation Status](https://readthedocs.org/projects/gef/badge/?version=latest)](https://gef.readthedocs.org/en/latest/)

`GEF` is aimed to be used mostly by exploiters and reverse-engineers. It
provides additional features to GDB using the Python API to assist during the
process of dynamic analysis or exploit development.

`GEF` fully relies on GDB API and other Linux specific source of information
(such as `/proc/pid`). As a consequence, some of the features might not work on
custom or harden systems such as GrSec.
It has fully support for Python2 and Python3 indifferently (as more and more
distro start pushing `gdb` compiled with Python3 support).


## Quick start

Simply make sure you're having a [GDB 7.x+](https://www.gnu.org/s/gdb).
``` bash
 $ wget -q -O- https://github.com/hugsy/gef/raw/master/gef.sh | sh
```

Then just start playing (for local files):
```bash
$ gdb -q /path/to/my/bin
gef> gef help
```

Or (for remote debugging)
```bash
remote:~ $ gdbserver /path/to/my/remote/file 0.0.0.0:1234
```
And 
```bash
local:~ $ gdb -q
gef> gef-remote your.ip.address:1234
```

## Show me

### x86
![gef-x86](https://i.imgur.com/P6ZGp6E.png)
<commit_msg>Update index.md<commit_after># GEF - GDB Enhanced Features  [![Documentation Status](https://readthedocs.org/projects/gef/badge/?version=latest)](https://gef.readthedocs.org/en/latest/)

`GEF` is aimed to be used mostly by exploiters and reverse-engineers. It
provides additional features to GDB using the Python API to assist during the
process of dynamic analysis or exploit development.

`GEF` fully relies on GDB API and other Linux specific source of information
(such as `/proc/pid`). As a consequence, some of the features might not work on
custom or harden systems such as GrSec.
It has fully support for Python2 and Python3 indifferently (as more and more
distro start pushing `gdb` compiled with Python3 support).


## Quick start

Simply make sure you're having a [GDB 7.x+](https://www.gnu.org/s/gdb).
``` bash
 $ wget -q -O- https://github.com/hugsy/gef/raw/master/gef.sh | sh
```

Then just start playing (for local files):
```bash
$ gdb -q /path/to/my/bin
gef> gef help
```

Or (for remote debugging)
```bash
remote:~ $ gdbserver 0.0.0.0:1234 /path/to/file 
```
And 
```bash
local:~ $ gdb -q
gef> gef-remote your.ip.address:1234
```

## Show me

### x86
![gef-x86](https://i.imgur.com/P6ZGp6E.png)

{'fraction_non_alphanumeric': 0.13111385121249486, 'fraction_numerical': 0.018084669132757913, 'mean_word_length': 4.092050209205021, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 7, 'https://': 10, 'lorem ipsum': 0, 'www.': 2, 'xml': 0}, 'pii_count': 2, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '4281632', 'n_tokens_mistral': 891, 'n_tokens_neox': 822, 'n_words': 291}