C / C++ / 系统课时
读懂目标文件与符号
读懂目标文件与符号
链接错误往往要回到 .o 目标文件才能看清。本篇用两个最小 C 文件生成 ELF 可重定位目标文件,再用 nm、readelf 和 objdump 分别检查符号、节区与重定位,建立定位未定义符号和重复定义的固定顺序。
学习目标
- 能区分目标文件中的已定义符号、未定义符号、节区和重定位记录。
- 能使用
nm、readelf与objdump找到“谁引用、谁定义、哪里需要修补”。 - 能从
undefined reference与multiple definition反推出常见源码或链接配置问题。
先建立目标文件的阅读顺序
编译器使用 -c 时只生成可重定位目标文件,不执行最终链接。目标文件包含 .text、.data 等节区,符号表记录本文件定义或引用的名字,重定位表则标记“此处地址暂时未知,链接时需要修补”。
链接器随后合并输入节区、解析跨文件符号,并按照重定位记录修正机器码或数据中的地址。遇到错误时,不要只盯着链接器最后一行;先确认引用者、定义者与重定位位置,问题通常会迅速收敛。

构造一个带未定义引用的目标文件
把下面两个文件放在同一目录。main.c 声明并调用 add,但不提供实现,因此单独查看 main.o 时,add 应当是未定义符号;counter 和 main 则由本文件定义。
/* main.c */
#include <stdio.h>
/* add 的实现位于另一个翻译单元,最终由链接器解析。 */
extern int add(int a, int b);
int counter = 7;
int main(void) {
printf("%d\n", add(counter, 5));
return 0;
}/* math.c */
/* 这里提供 main.o 所需的外部符号 add。 */
int add(int a, int b) {
return a + b;
}分别编译但暂不链接:
# -c 只生成目标文件,不执行最终链接。
gcc -std=c11 -Wall -Wextra -c main.c -o main.o
gcc -std=c11 -Wall -Wextra -c math.c -o math.o
printf 'objects ready\n'预期输出
objects ready此时 main.o 可以合法存在,因为可重定位目标文件允许保留尚未解析的外部引用;只有进入最终链接时,这些引用才必须由其他目标文件、静态库或共享库满足。
用三种工具交叉读取
下面的命令对原始工具输出做了简单归一化,避免地址和重定位类型因编译器版本或 CPU 架构不同而干扰阅读。核心信息仍直接来自三个工具。
# 先用 nm 区分“本文件引用”和“本文件定义”。
printf '[nm undefined]\n'
nm -u main.o | sed 's/^[[:space:]]*//'
printf '[nm defined]\n'
nm -g --defined-only main.o | awk '{print $2, $3}'
# 再用 readelf 与 objdump 确认节区和需要修补的引用。
printf '[sections]\n'
readelf -SW main.o | grep -oE '\.(text|data|bss|rela?\.text)(\.[^ ]+)?' | sed -E 's/\.rela?\.text/.reloc.text/' | sort -u
printf '[readelf reloc symbols]\n'
readelf -r main.o | grep -E 'add|counter|printf' | sed -E 's/^.* (counter|add|printf)( [-+] .*)?$/\1/' | sort -u
printf '[objdump reloc symbols]\n'
objdump -r main.o | grep -E 'add|counter|printf' | sed -E 's/^.*(counter|add|printf)([-+].*)?$/\1/' | sort -u预期输出
[nm undefined]
U add
U printf
[nm defined]
D counter
T main
[sections]
.bss
.data
.reloc.text
.text
[readelf reloc symbols]
add
counter
printf
[objdump reloc symbols]
add
counter
printfnm 的 U 表示本目标文件引用但没有定义该符号,T 表示定义位于代码节区,D 表示定义位于已初始化数据节区。readelf -S 负责看 ELF 节区,readelf -r 和 objdump -r 则从不同视角展示需要链接器修补的重定位记录。
把两个目标文件交给链接器后,add 可以由 math.o 满足;printf 通常作为对 C 共享库的动态导入留到程序装载阶段解析。
# 最终链接时同时提供 add 的定义。
gcc main.o math.o -o app
./app预期输出
12从链接报错反推根因
undefined reference 的本质是:最终链接需要某个外部符号,但参与链接的输入没有提供可用定义。常见原因包括实现文件没有加入链接命令、库缺失、静态库顺序不合适、函数名拼写不一致,或声明与实际导出的符号不匹配。
定位时先对报错方运行 nm -u,确认它确实在引用该名字;再对预期提供者运行 nm -g --defined-only,确认定义真的存在。若符号存在但仍未解析,再检查归档库顺序、可见性和实际参与链接的文件列表。
multiple definition 则表示同名强符号被多个输入文件同时定义。最常见的源码问题,是在头文件里直接写了具有外部链接的变量定义,并被多个 .c 文件包含。头文件通常只放 extern 声明,真正定义只保留在一个实现文件中。
当你把“节区承载什么、符号由谁定义、哪个位置需要重定位”三件事分开检查后,大多数链接问题都能从模糊报错还原为具体的目标文件事实。