grap 项目安装与使用教程

1. 项目目录结构及介绍

grap/
├── doc/
│   ├── COMPILE_OPTIONS.md
│   ├── DEBUG.md
│   ├── TESTS.md
│   └── syntax_highlighting.md
├── examples/
│   ├── analyze_backspace.py
│   └── backspace_samples.md
├── patterns/
│   ├── basic_block_loop.grapp
│   └── short_loops.grapp
├── src/
│   ├── main.cpp
│   └── ...
├── IDA.md
├── LICENSE
├── README.md
├── WINDOWS.md
└── ...

目录结构说明

• doc/: 包含项目的编译选项、调试、测试和语法高亮的相关文档。
• examples/: 包含用于分析 Backspace 恶意软件的示例 Python 脚本和相关文档。
• patterns/: 包含用于匹配二进制文件的图形模式文件。
• src/: 包含项目的主要源代码文件。
• IDA.md: 包含 IDA 插件的安装和使用说明。
• LICENSE: 项目的 MIT 许可证文件。
• README.md: 项目的主文档，包含项目的基本介绍和使用说明。
• WINDOWS.md: 包含在 Windows 系统上安装和使用项目的说明。

2. 项目启动文件介绍

项目的启动文件位于 src/ 目录下，主要文件为 main.cpp。该文件是项目的入口点，负责初始化并启动 grap 工具。

启动文件说明

• main.cpp: 这是项目的启动文件，包含了程序的主函数 main()。该函数负责解析命令行参数、初始化必要的组件，并调用相应的功能模块来执行图形模式匹配。

3. 项目的配置文件介绍

项目没有传统的配置文件，但可以通过命令行参数进行配置。主要的配置选项包括：

• -h: 显示帮助信息，描述所有支持的选项。
• -v: 输出详细信息，包括推断的模式路径。
• -od: 指定二进制文件的反汇编方式。
• -f: 强制重新反汇编二进制文件。
• -raw: 指定反汇编原始文件。
• -q: 控制输出的详细程度。
• -m: 显示所有匹配的节点。
• -o: 指定反汇编文件的输出路径。
• -r: 递归处理目录中的文件。

配置示例

$ grap -h
$ grap -v "sub->xor->sub" test.exe
$ grap -od pattern.grapp samples/*
$ grap -f pattern.grapp test.exe
$ grap --raw pattern.grapp test.bin
$ grap -q -sa pattern.grapp samples/*
$ grap -m pattern.grapp test.grapcfg
$ grap patterns/basic_block_loop.grapp -o ls.grapcfg /bin/ls
$ grap pattern1.grapp -p pattern2.grapp test.exe
$ grap -r -q patterns/ /bin/ -o /tmp/

通过这些命令行选项，用户可以灵活地配置 grap 工具的行为，以满足不同的需求。