如何通过Clang运行自定义LLVM编译器Pass？

我编写了一个用于修改IR的编译器Pass，使用opt命令：

opt -load=/home/yyb/Desktop/test/libinsertca.so -passes=Insertca -S test.ll -o test2.ll

可以正常运行并修改IR。但使用Clang前端命令（如clang -Xclang -load -Xclang /home/yyb/Desktop/test/libinsertca.so -Xclang -passes=Insertca或clang -fpass-plugin=/home/yyb/Desktop/test/libinsertca.so）时，IR未被修改，仿佛Pass未加载。请问使用Clang编译C文件时，加载该Pass的正确命令是什么？

我的Clang版本信息：

clang version 20.0.0git (https://github.com/llvm/llvm-project.git f2f9cdd22171f0c54cad7c6b183857f3d856c344)
Target: x86_64-unknown-linux-gnu
Thread model: posix
InstalledDir: /usr/local/bin

针对LLVM 20版本，正确加载自定义Pass的Clang命令及注意事项如下：

• 使用-fpass-plugin的标准命令
  LLVM 16+版本推荐用-fpass-plugin替代旧的-load参数，同时必须保留IR输出才能验证修改效果。正确命令示例：

  clang -fpass-plugin=/home/yyb/Desktop/test/libinsertca.so -S -emit-llvm -Xclang -passes=Insertca test.c -o test.ll
  

  参数说明：

  • -fpass-plugin=...: 指定自定义Pass的动态库路径
  • -S -emit-llvm: 让Clang生成LLVM IR文件而非直接编译为二进制，方便检查Pass是否生效
  • -Xclang -passes=Insertca: 明确告诉Clang运行你的自定义Pass

• 检查Pass的注册接口
  确保你的Pass使用LLVM新Pass管理器接口注册，因为Clang默认使用新管理器。注册代码需类似：

  #include "llvm/Passes/PassPlugin.h"
  #include "llvm/Passes/PassBuilder.h"
  
  extern "C" LLVM_ATTRIBUTE_WEAK PassPluginLibraryInfo llvmGetPassPluginInfo() {
    return {
      LLVM_PLUGIN_API_VERSION, "Insertca", "v0.1",
      [](PassBuilder &PB) {
        PB.registerPipelineParsingCallback(
          [](StringRef Name, FunctionPassManager &FPM, ArrayRef<PassBuilder::PipelineElement>) {
            if (Name == "Insertca") {
              FPM.addPass(InsertcaPass());
              return true;
            }
            return false;
          });
      }
    };
  }
  

  若仍使用旧的RegisterPass接口，新Pass管理器无法识别，需切换到上述新接口。

• 验证Pass加载状态
  加-v参数查看编译流程，确认Pass是否被加载：

  clang -fpass-plugin=/home/yyb/Desktop/test/libinsertca.so -v -S -emit-llvm -Xclang -passes=Insertca test.c -o test.ll
  

  在输出日志中查找Insertca相关内容，确认Pass已被调用。

• 排查优化阶段冲突
  若指定了优化级别（如-O2），需确保Pass插入到合适的阶段。可通过以下命令查看每个Pass运行后的IR：

  clang -fpass-plugin=/home/yyb/Desktop/test/libinsertca.so -S -emit-llvm -Xclang -passes=Insertca -Xclang -print-after-all test.c 2>&1 | grep -A 20 "After Insertca"
  

内容的提问来源于stack exchange，提问作者yibo yuan