NAME

nm − print program’s 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

−aDisplays all symbols including debug symbol table. 

−gPrints only global (external) symbols. 

−nSorts numerically rather than alphabetically. 

−oPrepends file or archive element name to each output line. 

−pPrints symbolic table order and does not sort. 

−rSorts in reverse order. 

−uDisplays 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)