Ghidra-to-LLVM 项目安装与使用教程

1. 项目目录结构及介绍

Ghidra-to-LLVM 项目的目录结构如下：

Ghidra-to-LLVM/
├── extra_scripts/
├── src/
├── tests/
├── LICENSE
├── README.md
└── g2llvm.py

目录结构介绍

• extra_scripts/: 包含额外的脚本文件，如 HighFunction_Analysis.java 和 HighFunction2LLVM.java，用于分析和转换高函数表示。
• src/: 包含项目的主要源代码文件，如 xmltollvm.py 和 lifting-opt-verify.py，用于将 Ghidra 的 IR 转换为 LLVM IR。
• tests/: 包含项目的测试文件，用于验证转换过程的正确性。
• LICENSE: 项目的开源许可证文件，采用 MIT 许可证。
• README.md: 项目的说明文件，包含项目的简介、安装和使用说明。
• g2llvm.py: 项目的启动文件，用于执行二进制文件到 LLVM IR 的转换。

2. 项目启动文件介绍

项目的启动文件是 g2llvm.py，它是一个 Python 脚本，负责将编译后的二进制文件转换为 LLVM IR。以下是 g2llvm.py 的主要功能和使用方法：

主要功能

• 二进制文件导入: 使用 Ghidra 的 analyzeHeadless 工具导入目标二进制文件。
• P-code 转换: 将 Ghidra 的 P-code 转换为 XML 格式。
• LLVM IR 生成: 将 XML 格式的 P-code 转换为 LLVM IR。
• 优化和验证: 对生成的 LLVM IR 进行优化和验证。
• 控制流图生成: 可选生成控制流图（CFG）。

使用方法

python3 g2llvm.py <input_file> [options]

参数说明

• input_file: 目标二进制文件的路径。
• -out: 可选参数，输出中间文件。
• -opt X: 可选参数，选择优化级别（0-3），目前仅支持级别 0。
• -cfg: 可选参数，生成控制流图。

3. 项目配置文件介绍

项目的主要配置在 g2llvm.py 脚本中进行，以下是配置项的介绍：

配置项

• ghidra_headless_loc: Ghidra 的 analyzeHeadless 工具的路径。
• prj_dir: Ghidra 项目目录的路径。
• prj_name: Ghidra 项目的名称。
• xml_script: Ghidra 转换脚本的路径。

示例配置

ghidra_headless_loc = "/home/tej/buildsGhidra/ghidra_9.1.1_PUBLIC/support/analyzeHeadless"
prj_dir = "/home/tej/GhidraProjects/"
prj_name = "lifting"
xml_script = "./src/GhidraToXML.java"

配置说明

• ghidra_headless_loc: 需要根据本地 Ghidra 安装路径进行配置。
• prj_dir: 指定 Ghidra 项目目录的路径。
• prj_name: 指定 Ghidra 项目的名称。
• xml_script: 指定 Ghidra 转换脚本的路径。

通过以上配置，可以确保 g2llvm.py 脚本能够正确调用 Ghidra 工具并完成二进制文件到 LLVM IR 的转换。