zasm

项目状态

简介

Zasm 提供了一个非常灵活和轻量级的库，用于操作和生成x86-64代码，使用Zydis作为后端。Zasm将所有内容存储为节点，如指令、数据、标签、段等，这提供了一种在将代码序列化为二进制之前轻松操作/转换代码的方法。API的灵感来自AsmJit，所以如果你以前使用过AsmJit，这应该会让你感到非常熟悉。

---

目录

1. 动机
2. 构建
3. 设计
   • 程序
   • 汇编器
   • 序列化器
   • 解码器
4. 示例

---

动机

我的一些项目使用Zydis和AsmJit，其中指令首先由Zydis解码，然后放入AsmJit的Builder中，以允许在重新编码/重定位修改后的代码之前处理/分析指令/分支，这种方法有一些缺点，将在下面进一步解释。Zydis最近引入了一种方法，可以使用它已经拥有的相同结构/数据来编码指令，这导致了Zasm的诞生。这个库旨在成为一个更高级的汇编器/解码器，可用于各种用途，如前面提到的示例。

Zasm和AsmJit之间的一个重要区别是对准确指令数据的关注，如操作数访问、隐藏寄存器使用、正确的CPU标志，所有这些在AsmJit中可能缺失或错误（当然也有一些例外），AsmJit旨在为脚本或高性能计算提供一种友好的方式来动态生成代码。Zasm并不试图以任何方式取代AsmJit，它有不同的目标。

Zasm的第二个原因是Zydis编码器非常低级，这意味着你没有标签之类的东西，Zasm提供了一个用于汇编指令的高级类，并提供了像普通汇编器一样的标签。

---

构建

Zasm使用CMake结合cmkr来简化CMakeLists.txt的维护。构建应该像在根目录的终端中使用以下命令一样简单：

cmake . -B build
cmake --build build --config Release

如果你也想构建测试，请使用

cmake . -B build -DZASM_BUILD_TESTS=ON

---

设计

程序

程序是保存所有数据的容器，也作为双向链表。指令、标签、数据、段等都作为节点存储，这允许用户轻松地删除/插入/重新排序。

汇编器

汇编器类提供生成的成员函数，用于在指定的光标位置生成指令/数据/标签到程序中。要生成 mov rax, -1，等效的代码是 assembler.mov(operands::rax, operands::Imm(-1));

序列化器

序列化器类将程序节点序列化为二进制并存储结果状态。成功序列化后，用户可以查询结果二进制代码和数据，如标签地址、重定位信息、段数据等。

解码器

将二进制数据解码为指令对象，可以直接使用或存储在程序中。

---

示例

该项目提供了一些基本示例，可以在这里找到。对于zasm提供的几乎所有功能也有各种测试，如果有什么缺失的，请先查看测试，它们也提供了很好的示例。如果你仍有疑问，可以通过Discord联系我们。

---

<!-- markdownlint-enable -->