.TH NM 1 
.SH NAME
nm \- print name list
.SH SYNOPSIS
.B nm
[
.B \-agnopru
]
[ file ... ]
.SH DESCRIPTION
.I nm
prints the name list (symbol table) of each object
.I 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
.I file
is given, the symbols in
`a.out'
are listed.
.PP
Each symbol name is preceded by its value (blanks if undefined)
and one of the letters
.SM
.B U
(undefined),
.SM
.B A
(absolute),
.SM
.B  T
(text segment symbol),
.SM
.B D
(data segment symbol),
.SM
.B B
(bss segment symbol),
.SM
.B C
(common symbol),
.SM
.B f
file name,
or
.B \-
for sdb symbol table entries (see
.B \-a
below).
If the symbol is local (non-external) the type letter is in
lower case.
The output is sorted alphabetically.
.PP
Options are:
.TP
.B \-a
Include all symbols in candidates for printing; normally
symbols destined for
.IR sdb (1)
are excluded.
.TP
.B  \-g
Print only global (external) symbols.
.TP
.B \-n
Sort numerically rather than alphabetically.
.TP
.B  \-o
Prepend file or archive element name to each
output line rather than only once.
.TP
.B  \-p
Don't sort; print in symbol-table order.
.TP
.B  \-r
Sort in reverse order.
.TP
.B  \-u
Print only undefined symbols.
.SH SEE ALSO
ar(1), ar(5), a.out(5), stab(5)