nm

nm命令显示关于指定文件中符号的信息，文件可以是对象文件、可执行文件或对象文件库。如果文件没有包含符号信息，nm命令报告该情况，但不把它解释为出错条件。nm命令缺省情况下报告十进制符号表示法下的数字值。

语法

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

参数

-a, --debug-syms：显示所有的符号，包括debugger-only symbols
-A, --print-file-name：每行或者显示完整路径名或者显示对象库名。
-B,--format=bsd：在 Berkeley 软件分发 (BSD) 格式中显示输出：
-C, --demangle[=STYLE]：将低级符号名解析(demangle)成用户级名字。这样可以使得C++函数名具有可读性。
--no-demangle：默认的选项，不需要将低级符号名解析成用户级名。
-D, --dynamic：显示动态符号。该任选项仅对于动态目标(例如特定类型的共享库)有意义。
--defined-only：仅显示定义的符号。
-e：只显示静态的和外部的（全局）符号。
-f, --format=FORMAT：使用format格式输出。format可以选取bsd、sysv或posix，该选项在GNU的nm中有用。默认为bsd。
-g, --extern-only：仅显示外部符号。
-l, --line-numbers：对每个符号，使用调试信息来试图找到文件名和行号。
-n, --numeric-sort：按符号对应地址的顺序排序，而非按符号名的字符顺序。
-o：Same as -A
-p, --no-sort：按目标文件中遇到的符号顺序显示，不排序。
-P, --portability：使用POSIX.2标准输出格式代替默认的输出格式。等同于使用任选项-f posix。
-r, --reverse-sort：反转排序的顺序(例如，升序变为降序)。
-s, --print-armap：当列出库中成员的符号时，包含索引。索引的内容包含：哪些模块包含哪些名字的映射。
--size-sort：按大小排列符号顺序。该大小是按照一个符号的值与它下一个符号的值进行计算的。
--target=BFDNAME：指定一个目标代码的格式，而非使用系统的默认格式。
-u, --undefined-only：仅显示没有定义的符号(那些外部符号)。
-h, --help：帮助信息
-V, --version：版本信息

符号说明

对于每一个符号来说，其类型如果是小写的，则表明该符号是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中。
• 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.
• ? 该符号类型没有定义。

使用

1.寻找特殊标识
有时会碰到一个编译了但没有链接的代码，那是因为它缺失了标识符；这种情况，可以用nm和objdump、readelf命令来查看程序的符号表；所有这些命令做的工作基本一样；
比如连接器报错有未定义的标识符；大多数情况下，会发生在库的缺失或企图链接一个错误版本的库的时候；浏览目标代码来寻找一个特殊标识符的引用:

nm -uCA *.o

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

objdump、readelf命令可以完成同样的任务。等效命令为：objdump -t，readelf -s

2.列出 a.out 对象文件的静态和外部符

nm -e a.out