https://github.com/wcampbell0x2a/heretek

GDB TUI Dashboard for the understanding of vast knowledge
https://github.com/wcampbell0x2a/heretek

ctf embedded gdb linux reverse-engineering rust tui

Last synced: 6 days ago
JSON representation

GDB TUI Dashboard for the understanding of vast knowledge

• Host: GitHub
• URL: https://github.com/wcampbell0x2a/heretek
• Owner: wcampbell0x2a
• License: apache-2.0
• Created: 2024-12-02T02:47:25.000Z (2 months ago)
• Default Branch: master
• Last Pushed: 2025-01-29T04:39:29.000Z (11 days ago)
• Last Synced: 2025-01-29T05:20:07.985Z (11 days ago)
• Topics: ctf, embedded, gdb, linux, reverse-engineering, rust, tui
• Language: Rust
• Homepage:
• Size: 9.64 MB
• Stars: 155
• Watchers: 4
• Forks: 3
• Open Issues: 24
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE-APACHE

Awesome Lists containing this project

README

        
# heretek

[](https://github.com/wcampbell0x2a/heretek)

[](https://crates.io/crates/heretek)

[](https://github.com/wcampbell0x2a/heretek/actions?query=branch%3Amaster)

GDB TUI Dashboard inspired by `gef`, designed to seamlessly connect to remote targets even without a functioning `gdbserver`.

* **No python requirements**: Many vendors ship `gdb` without python support, we ship a single statically-linked musl binary.

* **Architecture agnostic**: `heretek` only uses information given by `gdb`, no extra code required!

* **No gdbserver requirements**: Many vendors ship invalid `gdbserver` binaries, this works on remote targets with just `gdb`, `nc`, `cat`, and `mkfifo`. No more wrestling with invalid or missing `gdbserver` binaries.

* See [features](./docs/features.md) for `heretek` demos.

* See [commands](./docs/commands.md) for internal `heretek` commands.

![screenshot](images/screenshot.png)

## Build

Either build from published source in crates.io.

```

$ cargo install heretek --locked

```

Or download from [github releases](https://github.com/wcampbell0x2a/heretek/releases).

## Usage

```console

GDB TUI Dashboard for the understanding of vast knowledge

Usage: heretek [OPTIONS]

Options:

      --gdb-path 

          Override gdb executable path

  -r, --remote 

          Connect to nc session

          `mkfifo gdb_pipe; cat gdb_pipe | gdb --interpreter=mi | nc -l -p 12345 > gdb_pipe`

      --32

          Switch into 32-bit mode

  -c, --cmds 

          Execute GDB commands

          lines starting with # are ignored

      --log-path 

          Path to write log

          Set env `RUST_LOG` to change log level

  -h, --help

          Print help (see a summary with '-h')

  -V, --version

          Print version

```

> "To every problem, a solution lies in the application of tech-lore" - Ferrarch Asklepian, Warhammer 40,000: Mechanicus