#gdb #tui #debugging #embedded #gdbserver

app heretek

GDB TUI Dashboard for the understanding of vast knowledge

13 releases (4 breaking)

new 0.5.0 Feb 10, 2025
0.4.0 Jan 15, 2025
0.3.0 Jan 10, 2025
0.2.0 Jan 3, 2025
0.1.0-rc9 Dec 17, 2024

#165 in Development tools

Download history 409/week @ 2024-12-07 531/week @ 2024-12-14 135/week @ 2024-12-21 263/week @ 2024-12-28 209/week @ 2025-01-04 165/week @ 2025-01-11 26/week @ 2025-01-18 1/week @ 2025-01-25 5/week @ 2025-02-01

315 downloads per month

MIT/Apache and AGPL-3.0-only

2MB
3.5K SLoC

heretek

github crates.io build status

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 for heretek demos.

  • See commands for internal heretek commands.

screenshot

Build

Either build from published source in crates.io.

$ cargo install heretek --locked

Or download from github releases.

Usage

GDB TUI Dashboard for the understanding of vast knowledge

Usage: heretek [OPTIONS]

Options:
      --gdb-path <GDB_PATH>
          Override gdb executable path

  -r, --remote <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 <CMDS>
          Execute GDB commands

          lines starting with # are ignored

      --log-path <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

Dependencies

~13–24MB
~356K SLoC