1.命令簡介

nm 命令是 GNU Binutils 二進制工具集的一員，用于顯示目標文件中的符號。如果沒有為 nm 命令指明目標文件，則 nm 假定目標文件是 a.out。

nm 命令顯示的符號類型，至少使用以下類型，其他類型取決于目標文件格式。符號類型如果是小寫，符號通常是本地的；如果是大寫，符號是全局的（外部的）。但是，有一些小寫符號類型表示特殊的全局符號，例如 u、v 和 w。

A
該符號的值是絕對的，在以后的鏈接過程中，不允許進行改變。這樣的符號值，常常出現在中斷向量表中，例如用符號來表示各個中斷向量函數在中斷向量表中的位置。

b,B
該符號的值出現在非初始化數據段（BSS）中。例如，在一個文件中定義全局static int test。則該符號test的類型為b，位于bss section中。其值表示該符號在BSS段中的偏移。

C
該符號為common。common symbol是未初始化的數據。該符號沒有包含在一個普通section中，只有在鏈接過程中才進行分配。符號的值表示該符號需要的字節數。例如在一個C文件中，定義int test，并且該符號在別的地方會被引用，則該符號類型即為C，否則其類型為B。

d,D
該符號位于初始化數據段（data section）。例如定義全局變量 int baud_table[5]={9600, 19200, 38400, 57600, 115200}，則會被分配在初始化數據段中。

g,G
該符號也位于初始化數據段中。主要用于small object提高訪問small data object的一種方式

i
這是對標準ELF符號類型集的GNU擴展。它表示一個符號如果被重定位引用，不會計算該符號的地址，而是必須在運行時計算

N
該符號是一個debugging符號。

p
該符號在stackunwindsection

r,R
該符號位于只讀數據段（readonly data section）。例如定義全局const int test[]={123,123};則test就是一個只讀數據段的符號。

s,S
符號位于非初始化數據區，用于small object。

t,T
該符號位于代碼段（text section）。

u
符號是唯一的全局符號。這是GNU對標準ELF符號綁定集的擴展。對于這樣的符號，動態鏈接器將確保在整個過程中只有一個使用此名稱和類型的符號。

U
該符號在當前文件中是未定義的，即該符號定義在別的文件中。例如，當前文件調用另一個文件中定義的函數，這個被調用的函數在當前文件就是未定義的，但是在定義它的文件中類型是T。對于全局變量來說，在定義它的文件中，其符號類型為B或D，在使用它的文件中，其類型為U。

v,V
該符號是一個弱符號。當弱定義符號與正常定義符號鏈接時，使用正常定義符號時不會出錯。當鏈接未定義的弱定義符號，弱符號的值將變為零，且沒有錯誤。在某些系統上，大寫表示已指定默認值

w,W
該符號是一個弱符號，未專門標記為弱對象符號。當弱定義符號與正常定義符號鏈接時，使用正常定義符號時不會出錯。當鏈接未定義的弱未定義符號時，該符號的值將以系統特定的方式確定，且不會出錯。在某些系統上，大寫表示已指定默認值

-
該符號是a.out格式文件中的stabs symbol。在這種情況下，打印的下一個值是stabs other字段、stabs desc字段和stab類型。stabs符號用于保存調試信息

?
該符號類型沒有定義

2.命令格式

nm[-A|-o|--print-file-name][-a|--debug-syms]
[-B|--format=bsd][-C|--demangle[=style]]
[-D|--dynamic][-f|--format=]
[-g|--extern-only][-h|--help]
[-l|--line-numbers][-n|-v|--numeric-sort]
[-P|--portability][-p|--no-sort]
[-r|--reverse-sort][-S|--print-size]
[-s|--print-armap][-t|--radix=]
[-u|--undefined-only][-V|--version]
[-X32_64][--defined-only][--no-demangle]
[--plugin][--size-sort][--special-syms]
[--synthetic][--target=bfdname]
[objfile...]

3.選項說明

-A,-o,--print-file-name
在找到的各個符號的名字前加上文件名，而不是在此文件的所有符號前只出現文件名一次
-a,--debug-syms
顯示調試符號
-B,--format=bsd
用來兼容MIPS的nm
-C,--demangle[=STYLE]
將低級符號名解碼（demangle）成用戶級名字，比如去除編譯時添加的前置下劃線，這樣可以使得 C++函數名具有可讀性。不同的編譯器符號修飾風格不同，可以使用=STYLE 參數來選擇合適的解碼風格
-D, --dynamic：顯示動態符號。該任選項僅對于動態目標(例如特定類型的共享庫)有意義
-f,--format=FORMAT
FORMAT可取值bsd、sysv或posix，該選項在GNUnm中有用，默認為bsd
-g,--extern-only
僅顯示外部符號
-h,--help
顯示幫助信息
-l,--line-numbers
對每個符號，使用調試信息來試圖找到文件名和行號。對于已定義的符號，查找符號地址的行號。對于未定義符號，查找指向符號重定位入口的行號。如果可以找到行號信息，顯示在符號信息之后
-n,-v,--numeric-sort
按符號對應地址的順序排序，而非按符號名的字符順序
-P,--portability
使用 POSIX.2 標準輸出格式代替默認的輸出格式。等同于-f posix
-p,--no-sort
按目標文件中遇到的符號順序顯示，不排序
-r,--reverse-sort
逆序排序。例如，升序變為降序
-S,--print-size
以 BSD 輸出樣式輸出已定義符號的值和大小。對于不記錄符號大小的目標文件格式，此選項不起作用，除非使用了--size sort，在這種情況下，將顯示計算的大小
-s,--print-armap
當列出庫中成員的符號時，同時列出索引。索引的內容包含：模塊與其包含的名字的定義之間的映射
-t,--radix=RADIX
使用基數 radix 進制顯示符號值。radix 只能為 d（十進制）、o（八進制）或 x（十六進制）
-u,--undefined-only
僅顯示沒有定義的符號
-V,--version
顯示版本信息并退出
-X
為了與 AIX 版本的 nm 兼容，選項-X 將被忽略。它可接受一個參數，該參數必須是字符串32_64。AIX nm 的默認模式對應于-X 32，GNU nm 不支持模式-X 32
--defined-only
僅顯示有定義的符號
--no-demangle
不解碼低級符號名，這是默認選項
--pluginNAME
加載名為 name 的插件以添加對額外目標類型的支持。只有在啟用插件支持的情況下構建了工具鏈時，此選項才可用
--size-sort
按符號大小排列
--special-syms
顯示目標相關的具體特殊含義的符號。這些符號通常被特定目標文件用于某些特殊處理，當包含在正常符號列表中時通常不起作用。例如，對于ARM目標，此選項將跳過用于標記ARM代碼、Thumb代碼和數據之間轉換的映射符號
--synthetic
輸出合成符號。合成符號是鏈接器為各種目的創建的特殊符號，默認情況下不會顯示它們，因為它們不是二進制文件源代碼的一部分
--target=BFDNAME
指定系統默認格式以外的目標文件格式

4.常用示例

首先給出后面大部分示例所基于的源代碼以及編譯指令。涉及兩個 C++ 源文件。
test.cpp：

#include

intdUnInitialized;
intdInitialized=1;
charsTest[]="good";

voidprint()
{
std::cout<<"dUnInitialized="<"dInitialized="<"sTest="<

g++-c-gtest.cpp-otest.o
g++-c-gmain.cpp-omain.o

arcrvlibnm.amain.otest.o

nm-C*.o
main.o:
U__cxa_atexit
U__dso_handle
UdUnInitialized
0000000000000057t_GLOBAL__sub_I_main
0000000000000000Tmain
000000000000001at__static_initialization_and_destruction_0(int,int)
Uprint()
Ustd::Init()
Ustd::~Init()
0000000000000000bstd::__ioinit

test.o:
U__cxa_atexit
0000000000000000DdInitialized
U__dso_handle
0000000000000000BdUnInitialized
00000000000000aet_GLOBAL__sub_I_dUnInitialized
0000000000000004DsTest
0000000000000071t__static_initialization_and_destruction_0(int,int)
0000000000000000Tprint()
Ustd::operator<<(int)
?????????????????U?std::operator<<(std::ostream&?(*)(std::ostream&))
?????????????????U?std::Init()
?????????????????U?std::~Init()
?????????????????U?std::cout
?????????????????U?std::basic_ostream>&std::endl>(std::basic_ostream>&)
0000000000000004bstd::__ioinit
Ustd::basic_ostream>&std::operator<>(std::basic_ostream>&,charconst*)