第一个 LLVM Pass 体验 (小白笔录)

小白笔录、大佬跳过。

这种技术、尽然遇到了，最好作一个笔录，毕竟在开发中不经常使用，说不许明天就忘记了。也并不是无端造轮子，而是由于在研究的过程当中发现经过官方文档以及网上不少大佬的步骤有所悬殊，因此想从新记录一下。

0x00 准备

记得更新 cmake：brew upgrade CMake
接下来直接使用 Hikari 做为引子，clone 其相关代码：

> git clone --recursive -b release_80 https://github.com/HikariObfuscator/Hikari.git Hikari   
> cd Hikari  
> git submodule update --remote --recursive  
> cd ../   
> mkdir BuildXcode  
> cd BuildXcode
> cmake -G Xcode ../Hikari  
复制代码

以上的命令能够经过 && 进行链接一次性执行的。

其中、最后一个 cmake 的操做大概半个小时。结束以后的目录是这样的：

在这里多说一嘴，本节这些操做是对 LLVM 编译都须要作的。只是每次编译 LLVM 的目的不一样罢了。咱们都清楚 LLVM 的功能是不少、很强大的，当前文档主要是介绍 Pass， 可是除了 Pass， 还有其它：ClangPlugins: LLVM 的插件开发。

0x01 Hello World

从第一小节生成的 Xcode 项目中就已经有 Hello 的 Pass 实现了，以下所示：

其中 LLVMHello.dylib 就是 Build 后生成的。在这里还须要说明一下，选中 Hello.cpp 而后 Show In Finder 一下，会发现这个文件是在这里的：

如上图所示，自定义 Pass 区域中有一个目录 Obfuscation 就是 Hikari 的核心实现。
关于 LLVMHello.dylib 的更多细节，参考官方文档 WritingAnLLVMPass，我艹，尽然有官方文档，我还在这里写个毛啊！ 小哥哥不要着急，我不是那种写个博客都要 copy 官方文档的屌丝，很是讨厌那样的屌丝，纯粹的浪费别人的时间。总之，我在看完官方文档以后，我蒙圈了，多是文档过久了，也有多是个人理解有偏差。具体我遇到的问题，请看下节介绍。

0x10 遇到的问题

一、在官方文档中，提到一个 .so 文件，我是一直没有找见，我看到的是 LLVMHello.dylib。
二、opt 是什么，是命令？个人终端为何没有，难道是过期了？网上其它大佬的博客中也有提到，可是不知道是怎么来的？后来才发现，这个 opt 也是 LLVM 的一部分。

0x11 运行步骤

一、Build Hello

Build Hello Pass，生成 LLVMHello.dylib。

二、测试代码

建立一个 Coder.c 文件，代码详情以下：

#include <stdio.h>

void funcTest() {
    printf("funcTest\n");
}

int main() {
    funcTest();
    printf("CoderHG\n");
    return 1;
}
复制代码

史上最干净的代码，没有半行注释。生成 .bc 文件以供备用：

> clang -emit-llvm -c Coder.c -o main.bc
复制代码

注意，也像我同样，将 Coder.c 与 main.bc 放到这个目录中吧：

三、运行 opt

在 Xcode 中切换到 opt 的 Scheme，而后编辑其 Scheme 的配置，以下：

OK、运行 opt 吧，具体运行多长时间，听天由命吧，下图是个人运行时长：

可是最终倒是是成功了：

好了，你们能够鼓掌了...👏...👏...👏...
以上是属于 Xcode 的实时调试，仍是很方便的。经过对 Scheme 的配置，咱们也能看出来，咱们运行 opt 的目的就是触发 Pass 的功能，因此在 opt 运行成功以后,在 bin 目录中就有 opt 应用文件了：

因此能够直接 cd 到 bin 目录中这么执行：

> ./opt -load ../lib/LLVMHello.dylib -hello -disable-output ../main.bc
复制代码

打印结果是这样的：

厉害了，不少大佬在博客中，就直接这么介绍的，因此我懵逼了整整一个早上。

总结

至此，一个简单的 Pass 流程就走完了，很神奇吧，自始至终我没写过一句代码。可是在过程当中也学习到很多的东西、万丈高楼平地起，关于 Pass 的实现以及运用还需更多的时间去研究。Hikari 才是个人核心。