NAME

nm − print name list

SYNTAX

nm [ −agnopru ] [ file ... ]

DESCRIPTION

The nm command prints the name list (symbol table) of each object file in the argument list.  If an argument is an archive, a listing for each object file in the archive will be produced.  If no file is given, the “a.out” file is used. 

Each symbol name is preceded by its value, which is blank if undefined, and a letter.  The letter defines the symbol type:

UUndefined

AAbsolute

TText segment symbol

DData segment symbol

BBss segment symbol

CCommon symbol

fFile name

−For dbx() symbol table entries (see −a option below). 

If the symbol is local (non-external) the letter is in lower case.  The output is sorted alphabetically. 

OPTIONS

−a Print all symbols.  Debug symbol table information (see stab())) is not displayed unless you use this option.

−g Print only global (external) symbols. 

−n Sort numerically rather than alphabetically. 

−o Prepend file or archive element name to each output line. 

−p Print in symbol-table order; do not sort. 

−r Sort in reverse order. 

−u Print only undefined symbols. 

DIAGNOSTICS

bad format Indicates that the file is neither an archive file nor a ‘.o’ file. 

cannot open Indicates that the file could not be opened. 

invalid argument Indicates that an invalid option was specified. 

no name list Indicates that the file does not contain a symbol table. 

ran out of memory Indicates that the string table in either the archive or ‘.o’ file is too big. 

SEE ALSO

ar(1), ar(5), a.out(5), stab(5)