简介

nm 命令显示关于指定 File 中符号的信息，文件可以是对象文件、可执行文件或对象文件库。所谓符号，通常指定义出的函数，全局变量等等。

使用

nm [option(s)] [file(s)]

有用的options:

• A 在每个符号信息的前面打印所在对象文件名称；
• C 输出demangle过了的符号名称；
• D 打印动态符号；
• l 使用对象文件中的调试信息打印出所在源文件及行号；
• n 按照地址/符号值来排序；
• u 打印出那些未定义的符号；

常见的符号类型:

• A 该符号的值在今后的链接中将不再改变；
• B 该符号放在BSS段中，通常是那些未初始化的全局变量；
• D 该符号放在普通的数据段中，通常是那些已经初始化的全局变量；
• T 该符号放在代码段中，通常是那些全局非静态函数；
• U 该符号未定义过，需要自其他对象文件中链接进来；
• W 未明确指定的弱链接符号；同链接的其他对象文件中有它的定义就用上，否则就用一个系统特别指定的默认值。

注意几点：

• -C 总是适用于c++编译出来的对象文件。还记得c++中有重载么？为了区分重载函数，c++编译器会将函数返回值/参数等信息附加到函数名称中去形成一个mangle过的符号，那用这个选项列出符号的时候，做一个逆操作，输出那些原始的、我们可理解的符号名称。
• 使用 -l 时，必须保证你的对象文件中带有符号调式信息，这一般要求你在编译的时候指定一个 -g 选项，见 Linux:Gcc。
• 使用nm前，最好先用Linux:File查看对象文件所属处理器架构，然后再用相应交叉版本的nm工具。

举例

---

更详细的内容见man page。这里举例说明：

nm -u hello.o

显示hello.o 中的未定义符号，需要和其他对象文件进行链接.

---

nm -A /usr/lib/* 2>/dev/null | grep "T memset"

在 /usr/lib/ 目录下找出哪个库文件定义了memset函数.

---

寻找特殊标识

有时会碰到一个编译了但没有链接的代码，那是因为它缺失了标识符；这种情况，可以用nm和objdump、readelf命令来查看程序的符号表；所有这些命令做的工作基本一样；

比如连接器报错有未定义的标识符；大多数情况下，会发生在库的缺失或企图链接一个错误版本的库的时候；浏览目标代码来寻找一个特殊标识符的引用:

nm -uCA *.o | grep foo

-u选项限制了每个目标文件中未定义标识符的输出。-A选项用于显示每个标识符的文件名信息；对于C++代码，常用的还有-C选项，它也为解码这些标识符；

注解：
objdump、readld命令可以完成同样的任务。等效命令为：

objdump−tobjdump−treadelf -s 列出 a.out 对象文件的静态和外部符:

---

符号详细说明

这些包含可执行代码的段称为正文段。同样地，数据段包含了不可执行的信息或数据。另一种类型的段，称为BSS 段，它包含以符号数据开头的块。对于 nm 命令列出的每个符号，它们的值使用十六进制来表示（缺省行为），并且在该符号前面加上了一个表示符号类型的编码字符。

可以将目标文件中所包含的不同的部分划分为段。段可以包含可执行代码、符号名称、初始数据值和许多其他类型的数据。有关这些类型的数据的详细信息，可以阅读 UNIX 中 nm 的 man 页面，其中按照该命令输出中的字符编码分别对每种类型进行了描述。

对于每一个符号来说，其类型如果是小写的，则表明该符号是local的；大写则表明该符号是global(external)的。

• A 该符号的值是绝对的，在以后的链接过程中，不允许进行改变。这样的符号值，常常出现在中断向量表中，例如用符号来表示各个中断向量函数在中断向量表中的位置。

• B 该符号的值出现在非初始化数据段(BSS)中。例如，在一个文件中定义全局static int test。则该符号test的类型为b，位于bss section中。其值表示该符号在bss段中的偏移。一般而言，bss段分配于RAM中。

• C 该符号为common。common symbol是未初始话数据段。该符号没有包含于一个普通section中。只有在链接过程中才进行分配。符号的值表示该符号需要的字节数。例如在一个c文件中，定义int test，并且该符号在别的地方会被引用，则该符号类型即为C。否则其类型为B

• D 该符号位于初始化数据段中。一般来说，分配到data section中。
  例如：定义全局int baud_table[5] = {9600, 19200, 38400, 57600, 115200}，会分配到初始化数据段中。

• G 该符号也位于初始化数据段中。主要用于small object提高访问small data object的一种方式。

• I 该符号是对另一个符号的间接引用。

• N 该符号是一个debugging符号。

• R 该符号位于只读数据区。
  例如定义全局const int test[] = {123, 123};则test就是一个只读数据区的符号。
  值得注意的是，如果在一个函数中定义const char *test = “abc”, const char test_int = 3。使用nm都不会得到符号信息，但是字符串”abc”分配于只读存储器中，test在rodata section中，大小为4。

• S 符号位于非初始化数据区，用于small object。

• T 该符号位于代码区text section。

• U 该符号在当前文件中是未定义的，即该符号的定义在别的文件中。
  例如，当前文件调用另一个文件中定义的函数，在这个被调用的函数在当前就是未定义的；但是在定义它的文件中类型是T。但是对于全局变量来说，在定义它的文件中，其符号类型为C，在使用它的文件中，其类型为U。

• V 该符号是一个weak object。

• W The symbol is a weak symbol that has not been specifically tagged as a weak object symbol.
  ? 该符号类型没有定义

库或对象名 如果您指定了 -A 选项，则 nm 命令只报告与该文件有关的或者库或者对象名。

---

参考：

Linux的nm查看动态和静态库中的符号
linux工具之nm：文件格式分析