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 才负责定义它。
/* main.c */
int sum(int a, int b);
int main(void)
{
return sum(2, 3) == 5 ? 0 : 1;
}/* math.c */
int sum(int a, int b)
{
return a + b;
}执行编译并确认目标文件存在:
gcc -c main.c math.c
test -f main.o && echo main.o
test -f math.o && echo math.o预期输出:
main.o
math.o这里只完成编译,还没有进入最终链接,因此两个 .o 可以分别观察。
用 nm 区分引用者和提供者
先检查 main.o 的未定义符号:
nm -u main.o预期输出:
U sumU sum 表示 main.o 使用了 sum,但没有提供实现。再看 math.o 已定义的符号,只打印符号名以避开地址差异:
nm -j --defined-only math.o预期输出:
sum这两次输出合起来已经能回答关键问题:main.o 是引用者,math.o 是提供者。若链接命令漏掉 math.o,链接器就不可能解析 sum。
把符号检查用于链接故障
故意只链接 main.o:
gcc main.o -o app预期结果:
undefined reference to 'sum'
collect2: error: ld returned 1 exit status具体文件路径、地址和前缀可能因 GNU ld 版本不同而变化,但诊断核心是 sum 没有找到定义。把提供者加入链接后再运行:
gcc main.o math.o -o app
./app
echo $?预期输出:
0当真实工程出现类似问题时,可以先对报错符号执行 nm -u 或 nm --defined-only,再判断是“调用方写错名字”“实现没有被编译”“目标文件没有进入链接”,还是“库的链接顺序或选择不正确”。
工程里常用的 nm 组合
nm -A 适合同时检查多个对象,因为它会带上文件名;-u 只显示未定义符号;--defined-only 只显示已经定义的符号;-j 只输出符号名,适合脚本过滤。
例如要找哪些目标文件定义了 sum:
nm -A --defined-only *.o | grep ' sum$'预期结果:
math.o:0000000000000000 T sum地址长度可能随平台变化,判断时重点看对象文件名、符号类型和符号名。若同一符号完全没有定义,应回到构建配置确认实现源文件或库是否进入目标;若出现多份外部定义,则应转向重复定义问题继续排查。