C / C++ / 系统课时

用 nm 查看程序里的符号

用 nm 查看程序里的符号

链接错误经常只告诉你“某个符号找不到”或“某个符号重复”,却没有直接指出哪个模块负责提供它。nm 能读取目标文件和可执行文件的符号表,让你看到谁在定义符号、谁还在引用符号,从而缩小排查范围。

学习目标

  • 看懂 nm 中常见的 T、D、B、U 符号类型
  • 能检查某个目标文件定义了什么、还缺什么
  • 能用符号表判断 undefined reference 应从哪个模块排查

先认识 nm 输出里的关键字母

在 GNU 工具链的 ELF 目标文件中,nm 常见类型有:

类型 常见含义 排查价值
T 已定义的代码符号,通常位于文本段 判断函数实现是否真的进入目标文件
D 已初始化的全局或静态数据 判断数据定义是否存在
B 未显式初始化或零初始化的数据 常见于全局变量
U 当前文件未定义、等待其他模块提供 排查 undefined reference 的重点

大小写还会反映符号可见性差异,但定位普通链接问题时,先区分“已定义”和 U 通常已经足够。

构造两个目标文件

下面让 main.c 调用 sum,而真正的实现放在 math.c。两个源文件独立编译后,main.o 应该只引用 sum,math.o 才负责定义它。

c
/* main.c */
int sum(int a, int b);

int main(void)
{
    return sum(2, 3) == 5 ? 0 : 1;
}
c
/* math.c */
int sum(int a, int b)
{
    return a + b;
}

执行编译并确认目标文件存在:

bash
gcc -c main.c math.c
test -f main.o && echo main.o
test -f math.o && echo math.o

预期输出:

text
main.o
math.o

这里只完成编译,还没有进入最终链接,因此两个 .o 可以分别观察。

用 nm 区分引用者和提供者

先检查 main.o 的未定义符号:

bash
nm -u main.o

预期输出:

text
                 U sum

U sum 表示 main.o 使用了 sum,但没有提供实现。再看 math.o 已定义的符号,只打印符号名以避开地址差异:

bash
nm -j --defined-only math.o

预期输出:

text
sum

这两次输出合起来已经能回答关键问题:main.o 是引用者,math.o 是提供者。若链接命令漏掉 math.o,链接器就不可能解析 sum。

把符号检查用于链接故障

故意只链接 main.o:

bash
gcc main.o -o app

预期结果:

text
undefined reference to 'sum'
collect2: error: ld returned 1 exit status

具体文件路径、地址和前缀可能因 GNU ld 版本不同而变化,但诊断核心是 sum 没有找到定义。把提供者加入链接后再运行:

bash
gcc main.o math.o -o app
./app
echo $?

预期输出:

text
0

当真实工程出现类似问题时,可以先对报错符号执行 nm -u 或 nm --defined-only,再判断是“调用方写错名字”“实现没有被编译”“目标文件没有进入链接”,还是“库的链接顺序或选择不正确”。

工程里常用的 nm 组合

nm -A 适合同时检查多个对象,因为它会带上文件名;-u 只显示未定义符号;--defined-only 只显示已经定义的符号;-j 只输出符号名,适合脚本过滤。

例如要找哪些目标文件定义了 sum:

bash
nm -A --defined-only *.o | grep ' sum$'

预期结果:

text
math.o:0000000000000000 T sum

地址长度可能随平台变化,判断时重点看对象文件名、符号类型和符号名。若同一符号完全没有定义,应回到构建配置确认实现源文件或库是否进入目标;若出现多份外部定义,则应转向重复定义问题继续排查。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 nm 查看程序里的符号

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

登录哪都通