154 lines
3.2 KiB
Groff
154 lines
3.2 KiB
Groff
.\" Copyright (c) 1991 Free Software Foundation
|
|
.\" See section COPYING for conditions for redistribution
|
|
.TH nm 1 "5 November 1991" "cygnus support" "GNU Development Tools"
|
|
.de BP
|
|
.sp
|
|
.ti \-.2i
|
|
\(**
|
|
..
|
|
|
|
.SH NAME
|
|
nm\(em\&list symbols from object files.
|
|
|
|
.SH SYNOPSIS
|
|
.hy 0
|
|
.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
|
|
.I bfdname\c
|
|
\&\|]
|
|
.RB "[\|" \c
|
|
.I objfile\c
|
|
\&.\|.\|.\|]
|
|
.ad b
|
|
.hy 1
|
|
.SH DESCRIPTION
|
|
GNU \c
|
|
.B nm\c
|
|
\& will list the symbols from object files \c
|
|
.I objfile\c
|
|
\&.
|
|
|
|
.SH OPTIONS
|
|
The long and short forms of options, shown here as alternatives, are
|
|
equivalent.
|
|
|
|
.TP
|
|
.IR "objfile" .\|.\|.
|
|
Object files whose symbols are to be listed. If no object files are
|
|
listed as arguments, \c
|
|
.B nm\c
|
|
\& assumes `\|\c
|
|
.B a.out\c
|
|
\|'.
|
|
|
|
.TP
|
|
.B \-a
|
|
.TP
|
|
.B \-\-debug\-syms
|
|
Display debugger-only symbols; normally these are not listed.
|
|
|
|
.TP
|
|
.B \-g
|
|
.TP
|
|
.B \-\-extern\-only
|
|
Display only external symbols.
|
|
|
|
.TP
|
|
.B \-p
|
|
.TP
|
|
.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
|
|
Sort symbols numerically by their addresses, not alphabetically by their
|
|
names.
|
|
|
|
.TP
|
|
.B \-s
|
|
.TP
|
|
.B \-\-print\-armap
|
|
When listing symbols from archive members, include the index: a mapping
|
|
(stored in the archive by \c
|
|
.B ar\c
|
|
\& or \c
|
|
.B ranlib\c
|
|
\&) of what modules
|
|
contain definitions for what names.
|
|
|
|
.TP
|
|
.B \-o
|
|
.TP
|
|
.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
|
|
Reverse the sense of the sort (whether numeric or alphabetic); let the
|
|
last come first.
|
|
|
|
.TP
|
|
.BI "\-\-target " "bfdname"\c
|
|
\&
|
|
Specify an object code format other than your system's default format.
|
|
See
|
|
.BR objdump ( 1 ),
|
|
for information on listing available formats.
|
|
|
|
.TP
|
|
.B \-u
|
|
.TP
|
|
.B \-\-undefined\-only
|
|
Display only undefined symbols (those external to each object file).
|
|
|
|
.PP
|
|
|
|
.SH "SEE ALSO"
|
|
.RB "`\|" binutils "\|'"
|
|
entry in
|
|
.B
|
|
info\c
|
|
\&;
|
|
.I
|
|
The GNU Binary Utilities\c
|
|
\&, Roland H. Pesch (October 1991);
|
|
.BR ar "(" 1 "),"
|
|
.BR objdump ( 1 ),
|
|
.BR ranlib "(" 1 ")."
|
|
|
|
|
|
.SH COPYING
|
|
Copyright (c) 1991 Free Software Foundation, Inc.
|
|
.PP
|
|
Permission is granted to make and distribute verbatim copies of
|
|
this manual provided the copyright notice and this permission notice
|
|
are preserved on all copies.
|
|
.PP
|
|
Permission is granted to copy and distribute modified versions of this
|
|
manual under the conditions for verbatim copying, provided that the
|
|
entire resulting derived work is distributed under the terms of a
|
|
permission notice identical to this one.
|
|
.PP
|
|
Permission is granted to copy and distribute translations of this
|
|
manual into another language, under the above conditions for modified
|
|
versions, except that this permission notice may be included in
|
|
translations approved by the Free Software Foundation instead of in
|
|
the original English.
|