dynStruct 开源项目教程

dynStruct 开源项目教程

dynStructReverse engineering tool for automatic structure recovering and memory use analysis based on DynamoRIO and Capstone项目地址:https://gitcode.com/gh_mirrors/dy/dynStruct

项目介绍

dynStruct 是一个基于 DynamoRIO 和 Capstone 的自动逆向工程工具，用于结构恢复和内存使用分析。该项目通过监控 ELF 二进制文件的内存访问，收集数据并恢复原始代码的结构。dynStruct 不仅可以快速找到结构成员的读写位置和函数，还可以通过 Web 界面进行结构恢复和分析。

项目快速启动

环境设置

1. 安装依赖：

   • CMake >= 2.8
   • DynamoRIO（推荐使用 DynamoRIO cronbuild 的最新版本，避免使用最新发布版本，因为可能存在编译错误）
   • Python3
   • Capstone
   • Bottle

2. 设置环境变量：

   export DYNAMORIO_HOME=/path/to/your/DynamoRIO/installation
   

3. 编译 dynStruct：

   ./build.sh
   

   如果需要在 64 位操作系统上编译 32 位目标，请执行：

   ./build.sh 32
   

数据收集器设置

执行以下命令以启动数据收集器：

$DYNAMORIO_HOME/bin64/drrun -no_follow_children -opt_cleancall 3 -c dynStruct -m libc.so -- ls -l

结构恢复和 Web 界面

运行以下 Python 脚本以进行结构恢复并启动 Web 界面：

python3 dynStruct.py

应用案例和最佳实践

案例一：分析 ELF 二进制文件

假设我们有一个 ELF 二进制文件 example_binary，我们可以使用 dynStruct 来分析其内存访问模式和结构：

1. 启动数据收集器：

   $DYNAMORIO_HOME/bin64/drrun -no_follow_children -opt_cleancall 3 -c dynStruct -m libc.so -- ./example_binary
   

2. 运行结构恢复脚本：

   python3 dynStruct.py
   

3. 访问 Web 界面： 打开浏览器并访问 http://localhost:8080，即可查看和编辑恢复的结构。

最佳实践

• 确保 DynamoRIO 版本正确：避免使用最新发布版本，推荐使用 DynamoRIO cronbuild 的最新版本。
• 优化内存使用：如果输出文件存在，数据收集器会每 100 个块写入一次，以减少内存开销。
• 处理已知问题：如果遇到 JSON 输出缺失的问题，请在 includes/out_json.h 中注释相关宏并取消注释 DS_PRINTF 宏。

典型生态项目

DynamoRIO

DynamoRIO 是一个运行时代码操纵系统，支持在程序执行过程中动态修改代码。它是 dynStruct 的核心依赖之一。

Capstone

Capstone 是一个轻量级的多平台、多架构的反汇编框架，用于将二进制代码转换为可读的汇编代码。dynStruct 使用 Capstone 进行反汇编和分析。

Bottle

Bottle 是一个快速、简单、轻量级的 WSGI 微型 Web 框架，用于 Python。dynStruct 使用 Bottle 构建 Web 界面，方便用户进行结构恢复和分析。

通过结合这些生态项目，dynStruct 提供了一个强大的工具集，用于自动逆向工程和内存使用分析。

dynStructReverse engineering tool for automatic structure recovering and memory use analysis based on DynamoRIO and Capstone项目地址:https://gitcode.com/gh_mirrors/dy/dynStruct