.\" Copyright (c) 1991 Free Software Foundation
.\" See section COPYING for conditions for redistribution
-.\" $Id$
.TH nm 1 "5 November 1991" "cygnus support" "GNU Development Tools"
.de BP
.sp
.na
.TP
.B nm
-.RB "[\|" \-a | +debug-syms "\|]"
-.RB "[\|" \-g | +extern-only "\|]"
-.RB "[\|" \-s | +print-armap "\|]"
-.RB "[\|" \-o | +print-file-name "\|]"
-.RB "[\|" \-n | +numeric-sort "\|]"
-.RB "[\|" \-p | +no-sort "\|]"
-.RB "[\|" \-r | +reverse-sort "\|]"
-.RB "[\|" \-u | +undefined-only "\|]"
-.RB "[\|" "+target\ "\c
+.RB "[\|" \-a | \-\-debug\-syms "\|]"
+.RB "[\|" \-g | \-\-extern\-only "\|]"
+.RB "[\|" \-s | \-\-print\-armap "\|]"
+.RB "[\|" \-o | \-\-print\-file\-name "\|]"
+.RB "[\|" \-n | \-\-numeric\-sort "\|]"
+.RB "[\|" \-p | \-\-no\-sort "\|]"
+.RB "[\|" \-r | \-\-reverse\-sort "\|]"
+.RB "[\|" \-u | \-\-undefined\-only "\|]"
+.RB "[\|" "\-\-target="\c
.I bfdname\c
\&\|]
.RB "[\|" \c
-.I objfiles\c
+.I objfile\c
\&.\|.\|.\|]
.ad b
.hy 1
GNU \c
.B nm\c
\& will list the symbols from object files \c
-.I objfiles\c
+.I objfile\c
\&.
.SH OPTIONS
equivalent.
.TP
-.IR "objfiles" .\|.\|.
+.IR "objfile" .\|.\|.
Object files whose symbols are to be listed. If no object files are
listed as arguments, \c
.B nm\c
.TP
.B \-a
.TP
-.B +debug-syms
+.B \-\-debug\-syms
Display debugger-only symbols; normally these are not listed.
.TP
.B \-g
.TP
-.B +extern-only
+.B \-\-extern\-only
Display only external symbols.
.TP
.B \-p
.TP
-.B +no-sort
+.B \-\-no\-sort
Don't bother to sort the symbols in any order; just print them in the
order encountered.
.TP
.B \-n
.TP
-.B +numeric-sort
+.B \-\-numeric\-sort
Sort symbols numerically by their addresses, not alphabetically by their
names.
.TP
.B \-s
.TP
-.B +print-armap
+.B \-\-print\-armap
When listing symbols from archive members, include the index: a mapping
(stored in the archive by \c
.B ar\c
.TP
.B \-o
.TP
-.B +print-file-name
+.B \-\-print\-file\-name
Precede each symbol by the name of the input file where it was found,
rather than identifying the input file once only before all of its
symbols.
.TP
.B \-r
.TP
-.B +reverse-sort
+.B \-\-reverse\-sort
Reverse the sense of the sort (whether numeric or alphabetic); let the
last come first.
.TP
-.BI "+target " "bfdname"\c
+.BI "\-\-target " "bfdname"\c
\&
Specify an object code format other than your system's default format.
See
.TP
.B \-u
.TP
-.B +undefined-only
+.B \-\-undefined\-only
Display only undefined symbols (those external to each object file).
.PP