gdb-pt-dump 项目使用教程

gdb-pt-dump 项目使用教程

1. 项目的目录结构及介绍

gdb-pt-dump 是一个用于增强 QEMU 虚拟机调试的 GDB 脚本项目。项目的目录结构如下：

gdb-pt-dump/
├── example_pictures/
├── pt/
│   ├── pt.py
│   └── pt_gdb.py
├── pt_host/
│   ├── pt_host.py
│   └── tests/
│       └── integration_tests/
├── .gitignore
├── LICENSE.md
├── README.md
├── pyproject.toml

目录结构介绍

• example_pictures/: 存放示例图片的目录，可能用于文档或演示。
• pt/: 包含主要的 GDB 脚本文件 pt.py 和 pt_gdb.py，用于增强调试功能。
• pt_host/: 包含一个 BPF 程序 pt_host.py，用于检查 Linux 进程的页表。tests/integration_tests/ 目录下可能包含一些集成测试脚本。
• .gitignore: Git 忽略文件，指定哪些文件或目录不需要被版本控制。
• LICENSE.md: 项目的许可证文件，采用 MIT 许可证。
• README.md: 项目的说明文档，包含项目的基本信息和使用方法。
• pyproject.toml: Python 项目的配置文件，定义了项目的依赖和构建配置。

2. 项目的启动文件介绍

项目的启动文件主要是 pt/pt.py 和 pt_host/pt_host.py。

pt/pt.py

pt.py 是 GDB 脚本的核心文件，用于增强 QEMU 虚拟机的调试功能。通过在 GDB 中加载该脚本，用户可以执行以下操作：

• 从特定的客户物理地址转储页表。
• 合并语义上相似的连续内存。
• 提供详细的架构信息，如可写、可执行、U/S、可缓存、写回、XN、PXN 等。
• 缓存收集的信息以供未来过滤和打印。
• 通过页属性（x、w、u、s 等）和虚拟地址（之前、之后、之间）过滤页表信息。
• 使用 /proc/QEMU_PID/mem 快速搜索内存。
• 通过地址对齐过滤搜索结果，有助于过滤掉 SLAB 分配。
• 尝试通过检查地址空间来确定 KASLR 信息。
• 查找虚拟内存别名。

pt_host/pt_host.py

pt_host.py 是一个 BPF 程序，用于检查 Linux 进程的页表。它允许用户转储主机页表，并提供相关的调试信息。

3. 项目的配置文件介绍

项目的配置文件主要是 pyproject.toml。

pyproject.toml

pyproject.toml 是一个标准的 Python 项目配置文件，用于定义项目的依赖和构建配置。该文件通常包含以下内容：

• 工具配置: 定义了项目使用的工具和插件，如 black、flake8 等。
• 依赖管理: 列出了项目所需的 Python 包及其版本要求。
• 构建系统: 指定了项目的构建系统，如 setuptools、poetry 等。

通过 pyproject.toml，开发者可以轻松管理项目的依赖和构建过程，确保项目的可维护性和一致性。