nm - list symbols from object files.
nm [-a|--debug-syms] [-g|--extern-only] [-B]
[-C|--demangle] [-D|--dynamic] [-s|--print-armap]
[-p|--no-sort] [-r|--reverse-sort] [--size-sort]
[-u|--undefined-only] [-l|--line-numbers] [--help]
[--version] [-t radix|--radix=radix]
[-P|--portability] [-f format|--format=format]
GNU nm lists the symbols from object files objfile. If no
object files are given as arguments, nm assumes `a.out'.
The long and short forms of options, shown here as alternatives,
Precede each symbol by the name of the input file
where it was found, rather than identifying the input
file once only before all of its symbols.
Display debugger-only symbols; normally these are
-B The same as --format=bsd (for compatibility with
the MIPS nm).
Decode (demangle) low-level symbol names into userlevel
names. Besides removing any initial underscore
prepended by the system, this makes C++ function
Display the dynamic symbols rather than the normal
symbols. This is only meaningful for dynamic objects,
such as certain types of shared libraries.
Use the output format format, which can be ``bsd'',
``sysv'', or ``posix''. The default is ``bsd''.
Only the first character of format is significant;
it can be either upper or lower case.
Display only external symbols.
Sort symbols numerically by their addresses, not
alphabetically by their names.
Don't bother to sort the symbols in any order; just
print them in the order encountered.
Use the POSIX.2 standard output format instead of
the default format. Equivalent to ``-f posix''.
When listing symbols from archive members, include
the index: a mapping (stored in the archive by ar
or ranlib) of what modules contain definitions for
Reverse the sense of the sort (whether numeric or
alphabetic); let the last come first.
Sort symbols by size. The size is computed as the
difference between the value of the symbol and the
value of the symbol with the next higher value.
The size of the symbol is printed, rather than the
Use radix as the radix for printing the symbol values.
It must be ``d'' for decimal, ``o'' for octal,
or ``x'' for hexadecimal.
Specify an object code format other than your system's
default format. See objdump(1), for information
on listing available formats.
Display only undefined symbols (those external to
each object file).
For each symbol, use debugging information to try
to find a filename and line number. For a defined
symbol, look for the line number of the address of
the symbol. For an undefined symbol, look for the
line number of a relocation entry which refers to
the symbol. If line number information can be
found, print it after the other symbol information.
Show the version number of nm and exit.
--help Show a summary of the options to nm and exit.
`binutils' entry in info; The GNU Binary Utilities, Roland
H. Pesch (October 1991); ar(1), objdump(1), ranlib(1).
Copyright (c) 1991, 2000 Free Software Foundation, Inc.
This document is distributed under the terms of the GNU
Free Documentation License, version 1.1. That license is
described in the sources for this manual page, but it is
not displayed here in order to make this manual more consise.
Copies of this license can also be obtained from:
Free Software Foundation 5 November 1991 nm(1)
[ Back ]