调试程序 (zxdb)

Zxdb 是一个控制台调试程序,适用于使用 DWARF 符号(C、C++ 和 Rust)编译的原生代码。前端在主机上运行,并连接到设备上的 debug_agent。本文档介绍了如何设置这些流程。

连接客户端

zxdb 客户端程序在主机上运行。它可以通过交互式 connect 调试程序命令连接到 debug_agent,也可以根据命令行标志自动连接。同时支持 IPv4 和 IPv6 地址(如需查找地址,请参阅 ffx)。

zxdb -c "[f370::5051:ff:1e53:589a%qemu]"

通过脚本连接

脚本可能需要自动启动代理和客户端。脚本应等待该端口在目标系统上打开,然后再启动客户端。客户端中尚未实现自动重试。

如需在客户端退出时妥善清理调试代理,请将 --quit-agent-on-exit 命令行标志传递给客户端。

指定符号路径

调试程序要求本地主机系统上提供未剥离的 ELF 文件。目标上的符号不使用。必须将本地 build 存储符号的位置传递给 zxdb 客户端。

如需详细了解如何指定符号路径,请参阅设置符号位置