第一个 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 遇到的问题

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

0x11 运行步骤

1、Build Hello

Build Hello Pass，生成 LLVMHello.dylib。

2、测试代码

创建一个 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 放到这个目录中吧：

3、运行 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 才是我的核心。

转载于:https://juejin.im/post/5cf8e5cdf265da1bb31c297c