项目状态
简介
Zasm 提供了一个非常灵活和轻量级的库,用于操作和生成x86-64代码,使用Zydis作为后端。Zasm将所有内容存储为节点,如指令、数据、标签、段等,这提供了一种在将代码序列化为二进制之前轻松操作/转换代码的方法。API的灵感来自AsmJit,所以如果你以前使用过AsmJit,这应该会让你感到非常熟悉。
目录
动机
我的一些项目使用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联系我们。