GDBFrontend 是一个简单、灵活且可扩展的图形化调试器。

安装

必要条件

• GDB >= 8.2（带 python3）
• python3 >= 3.6
• tmux

PIP 包（Python Wheel）[推荐]

你可以使用 pip 安装 GDBFrontend。

sudo python3 -m pip install gdbfrontend

如果已经安装并且你在升级

sudo python3 -m pip install --upgrade gdbfrontend

或者如果你想安装特定的 GIT 快照：

sudo python3 setup.py install

然后你可以运行

gdbfrontend

从 GIT 运行

你可以下载最新源码并运行它。

你可以通过以下命令运行 gdb-frontend：

git clone https://github.com/rohanrhu/gdb-frontend.git gdb-frontend
cd gdb-frontend
./gdbfrontend

然后你可以通过以下地址打开它：

http://127.0.0.1:5550/

你可以使用以下命令打开 GDB shell：

tmux a -t gdb-frontend

Arch Linux（AUR）

你可以为基于 Arch 的发行版安装 Arch Linux 包。（AUR 包）

yay -S gdb-frontend-bin

然后运行它：

gdbfrontend

Flatpak

Flatpak 包是待办事项。

使用 GDBFrontend 调试 Docker 化的 C/C++ 应用

按照这个教程学习如何使用 GDBFrontend 调试 Docker 化的 C/C++ 应用。

使用 GDBFrontend 进行嵌入式调试

按照这个快速教程使用 GDBFrontend 调试嵌入式设备。

使用 GDBFrontend 调试 Python C 扩展

按照这个快速教程调试原生 C Python 扩展。

如何开发 GDBFrontend 插件？

GDBFrontend 拥有强大且可扩展的 API。按照这个快速教程学习开发 GDBFrontend 插件。

如何将 GDBFrontend 集成到你的 Makefile 中？

按照这个快速教程了解针对特殊开发/调试需求的集成思路。

在 Linux 上使用 OpenOCD、GDB 和 GDBFrontend 调试 STM32

按照这个教程使用 OpenOCD 和 GDBFrontend 调试 STM32。

功能特性

表达式求值器

GDBFrontend 有一个表达式求值器，你可以同时使用多个。

指针可视化

链表可视化

条件断点

右键单击断点可以设置其条件。

连接表达式

所有变量、成员和项的表达式在 GDBFrontend 的 VariablesExplorer 中都是连接的。

进程管理器

你可以通过进程管理器查看、筛选或管理进程。

数组图可视化

增强协作

GDBFrontend 有一组名为“增强协作”的协作功能。

协作绘图

启用增强协作后，可以使用协作绘图。点击“绘图”或使用 Ctrl + Shift + X 快捷键绘图，使用 Ctrl + Shift + C 清除所有绘图。

同步源码查看

启用增强协作后，所有调试器客户端在源码查看上是同步的。

表达式悬停弹出变量浏览器

可扩展性

GDBFrontend 非常可扩展，并拥有强大的 API。以下是 GDBFrontend 可扩展性的一些示例。

./gdbfrontend

$ gdbfrontend --help
GDBFrontend 是一个简单、灵活且可扩展的图形化调试器。

选项：
  --help, -h:                                   显示此帮助信息。
  --version, -v:                                显示版本。
  --gdb-args="ARGS", -G "ARGS":                 指定 GDB 命令行参数。（可选）
  --gdb-executable=PATH, -g PATH:               指定 GDB 可执行文件路径（默认为 PATH 环境变量中的 "gdb" 命令。）
  --tmux-executable=PATH, -tmux PATH:           指定 Tmux 可执行文件路径（默认为 PATH 环境变量中的 "tmux" 命令。）
  --terminal-id=NAME, -t NAME:                  指定 tmux 终端标识符名称（默认为 "gdb-frontend"。）
  --credentials=USER:PASS, -c USER:PASS:        指定访问调试器的用户名和密码。
  --host=IP, -H IP:                             指定当前主机地址，可通过 HTTP 和 WS 服务器访问。
  --listen=IP, -l IP:                           指定 HTTP 和 WS 服务器的监听地址。
  --port=PORT, -p PORT:                         指定 HTTP 端口。（0 表示随机端口。）
  --url-base=PATH, -u PATH:                     指定 URL 基础路径。（默认：/）
  --readonly, -r:                               使代码编辑器只读。（注意：此选项与安全性无关。）
  --workdir, -w:                                指定工作目录。
  --plugin-dir, -P:                             指定插件目录。
  --dontopenuionstartup, -D:                    避免在启动后打开 UI。
  --verbose, -V:                                启用详细输出。

选项

--help, -h

显示帮助文本。

--version, -v

显示版本。

--gdb-args="ARGS", -G "ARGS"

指定 GDB 命令行参数。（可选）

--gdb-executable=PATH, -g PATH

你可以指定 GDB 可执行文件路径，例如 gdbfrontend --gdb-executable=/path/to/gdb。（可选）

--tmux-executable=PATH, -tmux PATH

你可以指定 Tmux 可执行文件路径，例如 gdbfrontend --tmux-executable=/path/to/tmux。（可选）

--terminal-id=PATH, -t PATH

你可以指定 Tmux 终端 ID，例如 gdbfrontend --terminal-id=terminal-name。（默认：gdb-frontend）

--credentials=USER:PASS, -c USER:PASS

指定访问调试器的用户名和密码。

--host=IP, -H IP

指定当前主机地址，可通过 HTTP 和 WS 服务器访问。

--listen=IP, -l IP

指定 HTTP 和 WS 服务器的监听地址。

--port=PORT, -p PORT

指定 HTTP 端口。（0 表示随机端口。）

--url-base=PATH, -u PATH

指定 URL 基础路径。（默认：/）

--readonly, -r

使代码编辑器只读。（注意：此选项与安全性无关。）

--workdir, -w

指定工作目录。

--plugin-dir, -P

指定插件目录。

--dontopenuionstartup, -D

避免在启动后打开 UI。

--verbose, -V

启用详细输出。

GDB 命令