Wild链接器处理静态链接时TLS符号未定义问题的技术解析

在开发和使用Wild链接器的过程中，我们遇到了一个与线程局部存储(TLS)相关的静态链接问题。当尝试使用静态链接方式编译一个简单的C++异常处理程序时，链接器报告了__tls_get_addr符号未定义的错误。这个问题揭示了链接器在处理线程局部存储和静态链接时的几个关键技术点。

问题现象

当使用以下命令编译一个包含异常处理的基本C++程序时：

g++ t.cc -B ~/Programming/wild -fPIC -static

链接器会报错：

Error: Undefined symbol __tls_get_addr, referenced by /usr/lib64/gcc/x86_64-suse-linux/14/libstdc++.a @ eh_globals.o

技术背景

这个问题涉及几个重要的技术概念：

1. 线程局部存储(TLS)：这是一种允许每个线程拥有变量独立副本的机制。__tls_get_addr是动态链接器提供的用于访问TLS变量的运行时函数。

2. 静态链接与动态链接的区别：在静态链接中，所有代码都被直接包含在最终的可执行文件中；而在动态链接中，部分功能会在运行时通过共享库提供。

3. 链接器重定位处理：链接器需要处理各种重定位类型，包括与TLS相关的特殊重定位。

问题根源分析

深入分析发现，这个问题只在静态链接时出现，因为：

1. 动态链接时，__tls_get_addr函数由动态链接器ld-linux-x86-64.so.2提供。

2. 在静态链接场景下，所有对__tls_get_addr的引用实际上都会被优化掉，因为相关的TLS重定位(TLSGD)会被消除，随后的PLT32重定位也会被跳过。

3. Wild链接器当前在布局阶段就检查未定义符号，而此时尚未应用重定位优化，导致误报了实际上不会真正需要的符号。

解决方案探讨

针对这个问题，开发团队考虑了多种解决方案：

1. 延迟未定义符号检查：将未定义符号的检查推迟到写入输出文件阶段，此时已经应用了重定位优化，能够准确判断哪些符号真正需要。

2. 特殊符号白名单：临时方案可以特判__tls_get_addr符号，在静态链接时不报错。

3. 重构重定位处理逻辑：将产生next_modifier的代码分离出来，使布局阶段也能预测重定位优化结果。

经过评估，第一种方案最为合理，因为：

• 与其他主流链接器(如LLD和mold)的行为一致
• 符合链接器处理流程的自然顺序
• 不会引入特殊情况的处理逻辑

技术实现细节

Wild链接器之所以需要两次计算重定位(布局阶段和写入阶段)，是因为：

1. 布局阶段需要知道重定位结果以确定各段(如全局偏移表)的大小。

2. 写入阶段才实际应用重定位修改指令字节，避免临时复制段数据带来的性能开销。

这种设计权衡了准确性和性能，是链接器开发中的典型模式。

总结

这个问题展示了链接器开发中静态链接与TLS处理的复杂性。通过分析主流链接器的实现策略，Wild项目选择了将未定义符号检查推迟到写入阶段的解决方案，既保持了代码的整洁性，又与其他工具的行为保持一致。这个案例也提醒我们，在链接器开发中，各种优化和检查的顺序安排需要精心设计，才能正确处理各种边界情况。

对于使用Wild链接器的开发者，遇到类似问题时可以：

1. 首先确认是否是静态链接特有的问题
2. 检查是否涉及TLS相关功能
3. 考虑使用动态链接作为临时解决方案