LLDBagility 使用教程

1. 项目介绍

LLDBagility 是一个用于 macOS 内核调试的工具，它允许 LLDB 连接到运行在经过补丁的 VirtualBox 虚拟机上的 macOS 虚拟机。通过虚拟机自省的能力，LLDBagility 提供了一种便捷的 macOS 内核调试方法。该工具实现了一些新的 LLDB 命令，使得调试器能够：

• 连接到正在运行的 macOS VirtualBox 虚拟机并秘密地调试其内核，而无需更改客户操作系统。
• 随时中断（然后恢复）客户内核的执行。
• 在内核代码中的任何位置设置硬件断点。
• 设置在指定存储位置的读取或写入访问时触发的硬件观察点。
• 保存并在几秒钟内恢复虚拟机的状态。

2. 项目快速启动

2.1 安装依赖

确保满足以下依赖条件：

• 最新版本的 macOS 作为主机操作系统。
• 最新版本的 LLDB 调试器（可以通过 xcode-select --install 安装）。
• kdputils Python 包（参见 kdputils 的 README）。
• 经过 FDP 补丁的 VirtualBox 构建，以及 PyFDP 绑定（参见 FDP 的 README）。
• 一个 VirtualBox 虚拟机，运行任何版本的 macOS 作为客户操作系统。

2.2 安装 LLDBagility

假设所有依赖条件都已满足，只需将以下命令添加到 ~/.lldbinit 文件中：

command script import <path-to-LLDBagility>/LLDBagility/lldbagility.py

2.3 使用 LLDBagility

1. 启动 macOS 虚拟机进行调试。
2. 启动 LLDB。
3. 在 LLDB 中执行以下命令以开始调试：

(lldb) target create <path-to-guest-kernel-binary>
(lldb) fdp-attach <name-of-macos-vm>

2.4 常用命令

LLDBagility 实现了以下新的 LLDB 命令：

• fdp-attach 或 fa：连接调试器到正在运行的 macOS VirtualBox 虚拟机。
• fdp-hbreakpoint 或 fh：设置和取消设置读/写/执行硬件断点。
• fdp-interrupt 或 fi：暂停虚拟机的执行并将控制权返回给调试器。
• fdp-save 或 fs：保存虚拟机当前状态。
• fdp-restore 或 fr：将虚拟机恢复到上一次保存的状态。

3. 应用案例和最佳实践

3.1 调试 macOS 内核

LLDBagility 提供了一种无需修改客户操作系统的方式来调试 macOS 内核。通过使用 fdp-attach 命令，调试器可以连接到正在运行的 macOS 虚拟机，并开始调试其内核。

3.2 设置硬件断点

使用 fdp-hbreakpoint 命令，可以在内核代码中的任何位置设置硬件断点。这对于调试特定内核函数或代码路径非常有用。

3.3 保存和恢复虚拟机状态

在调试过程中，可以使用 fdp-save 和 fdp-restore 命令保存和恢复虚拟机的状态。这对于在调试过程中进行多次测试和恢复非常有用。

4. 典型生态项目

4.1 VirtualBox

LLDBagility 依赖于经过 FDP 补丁的 VirtualBox 虚拟机管理程序。VirtualBox 是一个开源的虚拟化软件，支持多种操作系统作为客户机。

4.2 LLDB

LLDB 是一个强大的调试器，广泛用于 macOS 和 iOS 开发。LLDBagility 扩展了 LLDB 的功能，使其能够调试 macOS 虚拟机中的内核。

4.3 PyFDP

PyFDP 是 FDP 的 Python 绑定，提供了与虚拟机自省相关的功能。LLDBagility 使用 PyFDP 来实现与 VirtualBox 虚拟机的交互。

通过这些工具的结合使用，开发者可以更高效地进行 macOS 内核调试和虚拟机管理。