nm 命令

在线编辑

用途

显示有关对象文件、可执行文件以及对象文件库里的符号信息。

语法

nm [ -A ] [ -C ] [ -X {32|64|32_64|d64| any}] [ -f ] [ -h ] [ -l ] [ -p ] [ -r ] [ -T ] [ -v ] [ -B | -P ] [ -e | -g | -u ] [ -d | -o | -x | -t Format ] File ...

描述

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

nm 命令将以下符号信息写到标准输出：

  • 库 或 对象名

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

  • 符号名称
  • 符号类型

    nm 命令使用以下符号（用同样的字符表示弱符号作为全局符号）之一来表示文件符号类型：

    项 描述
    a Global absolute 符号。
    a Local absolute 符号。
    B Global bss 符号。
    博 Local bss 符号。
    深 Global data 符号。
    天 Local data 符号。
    f Source file name 符号。
    L Global thread-local 符号 (TLS)。
    L Static thread-local 符号 (TLS)。
    云 Global text 符号。
    t Local text 符号。
    u Undefined 符号。
  • 值
  • 大小

    如果可应用，nm 命令报告与符号有关的大小。

标志

项 描述
-A 每行或者显示完整路径名或者显示对象库名。
-B 在 Berkeley 软件分发 (BSD) 格式中显示输出：
value   type   name
-C 限制解码 (demangle) C++ 名称。 缺省是解码所有 C++ 符号名。
注: C++ 对象文件中的符号在使用前会将其名称解压。
-d 用十进制显示符号的值和大小。 这是缺省情况。
-e 只显示静态的和外部的（全局）符号。
-f 显示完整的输出，包括冗余的 .text、.data 以及 .bss 符号，这些在通常都是被限制的。
-g 只显示外部的（全局）符号。
-h 限制输出头数据的显示。
-l 通过给 WEAK 符号的编码键附加一个 * 来区分 WEAK 和 GLOBAL 符号。 如果和 -P 选项一起使用，WEAK 符号的符号类型显示如下：
V
Weak Data 符号
W
Weak Text 符号
w
Weak 未定义符号
Z
Weak bss 符号
-O 用八进制而不是十进制数来显示符号的值和大小。
-P 以标准可移植输出格式显示信息：
library/object name   name   type   value   size

该格式以十六进制符号表示法显示数字值，除非您用 -t、-d 或 -o 标志指定不同的格式。

如果您指定了 -A 标志 -P 标志只显示 库/对象名字段。 同样，-P 标志只显示大小适用的符号 大小字段。
-p 不排序。 输出按符号表顺序显示。
-r 倒序排序。
-t 格式 显示指定格式下的数字值，其中 Format 参数是以下符号表示法之一：
天
十进制符号表示法。 这是 nm 命令的缺省格式。
o
八进制符号表示法。
X
十六进制符号表示法。
-t 将可能会溢出它的列的每个名称截短，使显示的名称的最后一个字符是星号。 缺省情况下，nm 显示列出的符号的全名，并且一个比为其设置的列的宽度长的名称会引起名称后的每个列无法对齐。
-U 只显示未定义符号。
-v 按值而不是按字母表顺序排序输出。
-x 用十六进制而不是十进制数来显示符号的值和大小。
-X 方式 指定 nm 应该检查的对象文件的类型。 mode 必须是以下各项中的一个：
32
只处理 32 位对象文件
64
只处理 64 位对象文件
32_64
既处理 32 位对象文件，又处理 64 位对象文件
d64
检测到不连续的 64 位 XCOFF 文件（幻数 = U803XTOCMAGIC）。
any
处理所有支持的对象文件。

缺省值为处理 32 位对象文件（忽略 64 位对象文件）。 mode 也可用 OBJECT_MODE 环境变量来设置。 例如，OBJECT_MODE=64 使 nm 处理任何 64 位对象并且忽略 32 位对象。 -X 标志覆盖 OBJECT_MODE 变量。
注: nm 命令支持 - (双连字符) 标志。 如果文件名会被曲解为一个选项，该标志区别于 File 操作数。 例如，要指定文件名以连字符开始，请使用 — 标志。

退出状态

本命令返回以下退出值：

项 描述
重大安全事件数量 成功完成。
> 0 发生错误。

示例

  1. 列出对象文件的静态符号和外部符号a.out，请输入:
    nm -e a.out
  2. 要以十六进制显示符号大小和值并按值对符号排序，请输入:
    nm -xv a.out
  3. 要显示 libc.a 中所有 64 位对象符号，忽略所有 32 位对象：
    nm -X64 /usr/lib/libc.a

文件

项 描述
/usr/ccs/bin/nm 包含 nm 命令。