如何在Clang CodeGen中用Builder.CreateCall生成GCC内建函数调用？

嘿，我来帮你梳理下怎么在Clang的CodeGen模块里用Builder.CreateCall生成GCC内建函数（比如__builtin_frame_address）的调用。这事儿我之前折腾过几次，给你分享下靠谱的实现步骤：

Clang对GCC的内建函数（比如__builtin_frame_address）已经有一套映射机制，这些内建函数在Clang中对应着BuiltinDecl对象。我们的核心工作就是找到这个Decl，准备好符合要求的参数，再通过IRBuilder的CreateCall方法生成对应的LLVM IR调用。

1. 获取目标内建函数的BuiltinDecl #

首先得在CodeGen的上下文里拿到对应内建函数的声明。你可以通过CodeGenModule的getBuiltinDecl方法，传入内建函数的名字来获取：

// 假设你在CodeGenFunction的某个成员函数中操作，先拿到CodeGenModule引用
auto &CGM = getCGM();
const BuiltinDecl *Builtin = CGM.getBuiltinDecl("__builtin_frame_address");

// 一定要检查是否成功获取，避免空指针问题
if (!Builtin) {
  // 这里可以根据需求报错或者返回，比如用CGM.Error()输出错误信息
  CGM.Error(SourceLocation(), "Failed to find builtin function __builtin_frame_address");
  return;
}

2. 准备调用参数 #

以__builtin_frame_address为例，它要求传入一个int类型的参数（表示要获取的帧级别，0代表当前帧）。我们需要用IRBuilder生成对应的LLVM值作为参数：

SmallVector<llvm::Value*, 1> CallArgs;
// 传入0作为帧级别，生成对应的LLVM整数常量
CallArgs.push_back(Builder.getInt32(0));

3. 生成函数调用 #

接下来要把BuiltinDecl映射为LLVM IR中的函数值，然后调用CreateCall生成调用指令：

// 获取内建函数的LLVM IR类型
const FunctionType *ClangFTy = Builtin->getFunctionType();
llvm::FunctionType *LLVMFTy = CGM.getTypes().GetFunctionType(ClangFTy);

// 获取内建函数对应的LLVM Value（可能是intrinsic或者普通函数）
llvm::Value *BuiltinFn = CGM.GetAddrOfBuiltin(Builtin);

// 生成调用，最后一个参数是给生成的IR指令起的名字，方便调试
llvm::Value *FrameAddr = Builder.CreateCall(LLVMFTy, BuiltinFn, CallArgs, "frame_addr");

4. 处理返回值（可选） #

__builtin_frame_address的返回值是void*，如果需要将其转换为特定类型的指针，可以用CreateBitCast来做类型转换：

// 比如转换为int*类型
llvm::Type *IntPtrTy = llvm::PointerType::get(CGM.Int32Ty, 0);
llvm::Value *IntFrameAddr = Builder.CreateBitCast(FrameAddr, IntPtrTy, "int_frame_addr");

• 上下文有效性：确保你操作的IRBuilder是当前CodeGenFunction中的有效实例（比如CodeGenFunction::Builder），不然会生成无效的IR。
• 架构兼容性：有些GCC内建函数只支持特定架构（比如__builtin_frame_address在x86/x86_64上有效，ARM上也有但参数规则可能不同），所以最好先检查目标架构：

  if (!CGM.getTarget().getTriple().isX86() && !CGM.getTarget().getTriple().isARM()) {
    CGM.Error(SourceLocation(), "__builtin_frame_address is not supported on this target");
    return;
  }
  

• 参数类型匹配：一定要保证传入的参数类型和内建函数要求的类型完全匹配，否则会触发LLVM IR的验证错误，导致编译失败。

内容的提问来源于stack exchange，提问作者Mustakimur Khandaker