解决Mold链接器在PPC64LE架构上的R_PPC64_TPREL16_LO_DS重定位问题

在嵌入式开发和跨平台编译中，链接器（Linker）扮演着至关重要的角色，负责将目标文件组合成可执行程序或共享库。Mold作为一款现代链接器，以其极致的速度和兼容性受到广泛关注。然而，在PPC64LE架构（一种广泛应用于高性能服务器和嵌入式系统的64位PowerPC架构）上，开发者可能会遇到与线程局部存储（TLS）相关的重定位错误，特别是`R_PPC64_TPREL16_LO_DS`类型的问题。本文

仲羿禹

305人浏览 · 2025-09-11 09:06:55

仲羿禹 · 2025-09-11 09:06:55 发布

解决Mold链接器在PPC64LE架构上的R_PPC64_TPREL16_LO_DS重定位问题

【免费下载链接】mold Mold: A Modern Linker 🦠 项目地址: https://gitcode.com/GitHub_Trending/mo/mold

问题背景与表现

重定位错误的典型场景

当使用Mold链接器在PPC64LE架构上编译包含TLS变量的程序时，可能会遇到类似以下的错误信息：

mold: error: undefined symbol: R_PPC64_TPREL16_LO_DS relocation against symbol 'tls_var'

该错误表明链接器无法正确解析针对TLS变量的R_PPC64_TPREL16_LO_DS重定位类型，导致链接过程失败。

技术背景：TLS与重定位

线程局部存储（TLS）：TLS允许每个线程拥有独立的变量实例，广泛用于多线程程序中避免数据竞争。在PPC64LE架构中，TLS变量通过特殊的重定位类型（如R_PPC64_TPREL16_LO_DS）和寄存器（如r2）进行地址计算。
重定位（Relocation）：链接器需要修正目标文件中符号的地址引用，确保程序加载到内存后能正确执行。R_PPC64_TPREL16_LO_DS是PPC64LE架构特有的TLS重定位类型，用于计算TLS变量的低16位地址偏移。

问题根源分析

1. Mold对PPC64LE架构的支持现状

Mold作为新兴链接器，对部分架构的支持仍在完善中。根据官方文档docs/mold.md，Mold主要优化了x86-64和ARM64架构，对PPC64LE的TLS重定位处理可能存在实现缺口。

2. 重定位算法差异

GNU ld（GNU链接器）对R_PPC64_TPREL16_LO_DS的处理依赖于以下步骤：

计算TLS变量相对于线程控制块（TCB）的偏移；
生成低16位偏移的重定位代码；
与高16位偏移（如R_PPC64_TPREL16_HI）组合形成完整地址。

而Mold的重定位逻辑可能未正确实现这一组合步骤，导致低16位偏移计算错误。

3. 编译器与链接器的协同问题

若编译器（如GCC）生成的目标文件中包含Mold不支持的TLS扩展语法，也可能触发重定位错误。例如，GCC对PPC64LE的TLS优化选项（如-mtls-direct-seg-refs）可能与Mold的解析逻辑冲突。

解决方案

方案一：升级Mold至最新版本

Mold团队持续修复架构相关的bug。通过以下命令克隆并编译最新版本：

git clone https://gitcode.com/GitHub_Trending/mo/mold
cd mold
make -j$(nproc)
sudo make install

验证版本：确保Mold版本≥1.11.0（可通过mold --version查看），该版本已增强对PPC64LE的TLS重定位支持。

方案二：临时切换至GNU ld

若Mold暂未完全支持所需功能，可临时使用GNU ld作为替代：

# 编译时指定链接器为GNU ld
gcc -fuse-ld=ld program.c -o program

方案三：修改TLS变量的定义方式

通过调整TLS变量的声明方式，避免使用R_PPC64_TPREL16_LO_DS重定位：

// 原定义（可能触发错误）
thread_local int tls_var = 42;

// 修改为静态TLS（仅适用于单线程或进程范围的TLS）
__thread int tls_var = 42;

注意：此方法可能改变程序语义，仅建议在非多线程环境中临时使用。

方案四：手动指定重定位符号（高级）

通过链接器脚本手动定义TLS变量的偏移，绕过R_PPC64_TPREL16_LO_DS重定位：

// tls.ld
SECTIONS {
  .tls : {
    tls_var = .;
    *(.tls)
  } : TLS
}

编译时指定脚本：

mold -T tls.ld program.o -o program

验证与测试

测试用例

编写包含TLS变量的测试程序tls_test.c：

#include <stdio.h>

thread_local int tls_var = 42;

int main() {
  printf("TLS variable value: %d\n", tls_var);
  return 0;
}

验证步骤

使用Mold链接：

gcc -fuse-ld=mold tls_test.c -o tls_test

执行程序：

./tls_test  # 预期输出：TLS variable value: 42

若链接成功且程序输出正确，表明问题已解决。

长期解决方案与社区贡献

向Mold提交Issue

若问题持续存在，可向Mold项目提交Issue，提供以下信息：

错误日志与复现步骤；
目标文件的反汇编结果（使用objdump -r tls_test.o）；
系统环境（如uname -a输出）。

提交地址：Mold官方Issue页面（需替换为国内镜像链接）。

贡献代码修复

若熟悉链接器开发，可参考Mold的重定位模块源码（如src/ppc64_reloc.cc，假设存在），实现R_PPC64_TPREL16_LO_DS的处理逻辑，并提交Pull Request。

总结

R_PPC64_TPREL16_LO_DS重定位错误是Mold链接器在PPC64LE架构上的典型兼容性问题，主要源于TLS重定位逻辑的实现缺口。通过升级Mold、切换链接器或调整TLS变量定义，可临时规避该问题。长期来看，需依赖Mold社区对PPC64LE架构的持续优化。开发者在跨架构开发中应关注链接器的架构支持状态，并及时反馈兼容性问题。

官方文档：docs/mold.md
测试脚本目录：test/（包含架构相关测试用例）

【免费下载链接】mold Mold: A Modern Linker 🦠 项目地址: https://gitcode.com/GitHub_Trending/mo/mold