.TH NM 1 
.UC
.SH NAME
nm  \-  print name list
.SH SYNOPSIS
.B nm
[
.B \-gnopru
]
[ 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),
or
.SM
.B C
(common symbol).
If the symbol is local (non-external) the type letter is in
lower case.
If the file is an overlaid executable, the overlay number
is printed after the name.
The number is printed if the symbol is in an overlay
or if it is the entry point (in the base segment)
for a subroutine in an overlay.
The output is sorted alphabetically.
.PP
Options are:
.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 FILES
.SH SEE ALSO
ar(1), ar(5), a.out(5)