C / C++ / 系统课时

读懂目标文件与符号

读懂目标文件与符号

链接错误往往要回到 .o 目标文件才能看清。本篇用两个最小 C 文件生成 ELF 可重定位目标文件,再用 nm、readelf 和 objdump 分别检查符号、节区与重定位,建立定位未定义符号和重复定义的固定顺序。

学习目标

  • 能区分目标文件中的已定义符号、未定义符号、节区和重定位记录。
  • 能使用 nm、readelf 与 objdump 找到“谁引用、谁定义、哪里需要修补”。
  • 能从 undefined reference 与 multiple definition 反推出常见源码或链接配置问题。

先建立目标文件的阅读顺序

编译器使用 -c 时只生成可重定位目标文件,不执行最终链接。目标文件包含 .text、.data 等节区,符号表记录本文件定义或引用的名字,重定位表则标记“此处地址暂时未知,链接时需要修补”。

链接器随后合并输入节区、解析跨文件符号,并按照重定位记录修正机器码或数据中的地址。遇到错误时,不要只盯着链接器最后一行;先确认引用者、定义者与重定位位置,问题通常会迅速收敛。

ELF 目标文件中的节区、符号与重定位关系

构造一个带未定义引用的目标文件

把下面两个文件放在同一目录。main.c 声明并调用 add,但不提供实现,因此单独查看 main.o 时,add 应当是未定义符号;counter 和 main 则由本文件定义。

c
/* 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;
}
c
/* math.c */
/* 这里提供 main.o 所需的外部符号 add。 */
int add(int a, int b) {
    return a + b;
}

分别编译但暂不链接:

bash
# -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'

预期输出

text
objects ready

此时 main.o 可以合法存在,因为可重定位目标文件允许保留尚未解析的外部引用;只有进入最终链接时,这些引用才必须由其他目标文件、静态库或共享库满足。

用三种工具交叉读取

下面的命令对原始工具输出做了简单归一化,避免地址和重定位类型因编译器版本或 CPU 架构不同而干扰阅读。核心信息仍直接来自三个工具。

bash
# 先用 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

预期输出

text
[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
printf

nm 的 U 表示本目标文件引用但没有定义该符号,T 表示定义位于代码节区,D 表示定义位于已初始化数据节区。readelf -S 负责看 ELF 节区,readelf -r 和 objdump -r 则从不同视角展示需要链接器修补的重定位记录。

把两个目标文件交给链接器后,add 可以由 math.o 满足;printf 通常作为对 C 共享库的动态导入留到程序装载阶段解析。

bash
# 最终链接时同时提供 add 的定义。
gcc main.o math.o -o app
./app

预期输出

text
12

从链接报错反推根因

undefined reference 的本质是:最终链接需要某个外部符号,但参与链接的输入没有提供可用定义。常见原因包括实现文件没有加入链接命令、库缺失、静态库顺序不合适、函数名拼写不一致,或声明与实际导出的符号不匹配。

定位时先对报错方运行 nm -u,确认它确实在引用该名字;再对预期提供者运行 nm -g --defined-only,确认定义真的存在。若符号存在但仍未解析,再检查归档库顺序、可见性和实际参与链接的文件列表。

multiple definition 则表示同名强符号被多个输入文件同时定义。最常见的源码问题,是在头文件里直接写了具有外部链接的变量定义,并被多个 .c 文件包含。头文件通常只放 extern 声明,真正定义只保留在一个实现文件中。

当你把“节区承载什么、符号由谁定义、哪个位置需要重定位”三件事分开检查后,大多数链接问题都能从模糊报错还原为具体的目标文件事实。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

读懂目标文件与符号

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通