Digital

NAME

nm − name list dump of object files

SYNOPSIS

nm [-abdefghnopruvxABTV] [ file1 ... fileN ]

DESCRIPTION

The nm command prints formatted listings of the symbol and external sections of an object file symbol table.  A file can be an object or an archive.  If you do not specify a file, this command assumes a.out.

These section letters describe the information that nm generates:

N nil storage class, compiler internal usage

T external text

t local text

D external initialized data

d local initialized data

B external zeroed data

b local zeroed data

A external absolute

a local absolute

U external undefined

G external small initialized data

g local small initialized data

S external small zeroed data

s local small zeroed data

R external read only

r local read only

C common

E small common

V external small undefined

The standard System V format and the −a specified Berkeley format provide an expanded listing with these columns:

Name the symbol or external name

Value the value field for the symbol or external, usually an address or interesting debugging information

Class the symbol type

Type the symbol’s language declaration

Size unused

Index the symbol’s index field

Section
the symbol’s storage class

NOTE: Every effort was made to map the field’s functionality into System V nomenclature. 

The nm command accepts these options:

-a prints debugging information, effectively turning Berkeley into System V format

-b prints the value field in octal

-d prints the value field in decimal (the System V default)

-e prints external and statics only

-f produces full output. (The nm command still accepts this old option, but ignores it.) 

-g prints only global symbols

-h does not print headers

-n for System V, sorts external symbols by name (default for Berkeley), and for Berkeley, sorts all symbols by value

-o for System V, prints the value field in octal, and for Berkeley prepends the filename to each symbol. (This is good for using the grep command to check through nm listings of libraries. 

-p prints symbols as they are found in the file (the System V default)

-r reverses the sense of a value or name sort

-u prints only undefined symbols

-v sorts external symbols by value

-x prints value field in hexadecimal (Berkeley default)

-A prints AT&T System V-style output (default)

-B prints Berkeley (4.3 BSD)-style output. This format produces and address or value field followed by a letter showing what section the symbol or external is located in. The third and final field is the name of the symbol or external. 

-T truncates long names, inserting a ‘∗’ as the last printed character

-V prints version information on stderr

RELATED INFORMATION

DEC OSF/1 Programmer’s Guide