nm

display symbol table of object, library, or executable file 

Command


SYNOPSIS

nm [-AaefgnoPprsuvx] [-t format] file ...


DESCRIPTION

nm displays the symbol table associated with an object, archive library of objects, or executable file. nm recognizes several different file types that may contain symbol tables:

Note that nm does not list entry points in a DLL, unless there is a symbol table associated with it.

By default, nm lists the symbols in file in alphabetical order by name and provides the following information on each:

Options

-A 

prefixes each line with the file name or archive member name.

-a 

displays all symbols, including line number entries on systems which support them.

-e 

displays only global (external) and static symbols.

-f 

displays full output. This is the default, since this implementation does not suppress any output.

-g 

displays only global symbols.

-n 

is equivalent to -v.

-o 

displays output in octal (same as -t o).

-P 

displays output in a portable POSIX-compliant format, with blanks separating the output fields. If you specified -A and file is not a library, the format is

file: name type value size

If you specified -A and file is a library, the format is

file[object_file]: name type value size

where object_file is the object file in the library which contains the symbol being described. If you did not specify -A, the format is

name type value size

If you did not also specify the -t option, nm displays value and size in hexadecimal.

If you did not specify -A and the command line contains more than one file, or file is a library, nm displays a line preceding the list of symbols for each specified file or each object file in a specified library. If file is a library, this line has the following format:

file[object_file]:

If file is not a library, the format is simply

file:
-p 

does not sort output.

-r 

reverses sort order.

-s 

includes symbol size for each symbol.

-t format 

defines the numeric value formatting base. The format shall be one of d, o, or x, for decimal, octal, or hexadecimal, respectively. If this option is not used, numbers are displayed in decimal.

-u 

displays only undefined symbols.

-v 

sorts output by value.

-x 

displays information in hexadecimal (same as -t x).


DIAGNOSTICS

Possible exit status values are:

0 

Successful completion.

1 

Failure due to any of the following:

— invalid command line option
— missing file name
— unknown symbol table type
— invalid library file
— end-of-file found in library
— bad record in the library
— out of memory

If a file does not contain a symbol table, nm displays a warning and goes to the next file, but this is not considered an error.


PORTABILITY

POSIX.2. x/OPEN Portability Guide 4.0. All UNIX systems. Windows 7. Windows Server 2008 R2. Windows 8. Windows Server 2012. Windows 10. Windows Server 2016.

The -a, -e, -f, -n, -o, -p, -r, -s and -x options are not part of the POSIX standard.

The -a, -n, -p, -r, -s options and -t d are not part of the x/OPEN standard.


NOTE

On Windows systems, data (D, d) and uninitialized data (B, b) are not currently recognized in executable files, as this involves trying to guess segment types. All such symbols come out as text (T, t) symbols.


AVAILABILITY

PTC MKS Toolkit for Developers
PTC MKS Toolkit for Interoperability
PTC MKS Toolkit for Professional Developers
PTC MKS Toolkit for Professional Developers 64-Bit Edition
PTC MKS Toolkit for Enterprise Developers
PTC MKS Toolkit for Enterprise Developers 64-Bit Edition
PTC Integrity


SEE ALSO

Commands:
ar, size, strip


PTC MKS Toolkit 10.1 Documentation Build 15.