1 .\" Copyright (c) 1991 Free Software Foundation
2 .\" See section COPYING for conditions for redistribution
3 .TH nm 1 "5 November 1991" "cygnus support" "GNU Development Tools"
11 nm \- list symbols from object files.
18 .RB "[\|" \-a | \-\-debug\-syms "\|]"
19 .RB "[\|" \-g | \-\-extern\-only "\|]"
21 .RB "[\|" \-C | \-\-demangle "\|]"
22 .RB "[\|" \-s | \-\-print\-armap "\|]"
23 .RB "[\|" \-o | \-\-print\-file\-name "\|]"
24 .RB "[\|" \-n | \-\-numeric\-sort "\|]"
25 .RB "[\|" \-p | \-\-no\-sort "\|]"
26 .RB "[\|" \-r | \-\-reverse\-sort "\|]"
27 .RB "[\|" \-u | \-\-undefined\-only "\|]"
28 .RB "[\|" \-\-help "\|]"
29 .RB "[\|" \-\-version "\|]"
30 .RB "[\|" "\-t \fIradix" | \-\-radix=\fIradix "\|]"
31 .RB "[\|" \-P | --portability "\|]"
32 .RB "[\|" "\-f \fIformat" | \-\-format=\fIformat "\|]"
33 .RB "[\|" "\-\-target=\fIbfdname" "\|]"
42 \& lists the symbols from object files \c
44 \&. If no object files are given as arguments, \c
51 The long and short forms of options, shown here as alternatives, are
59 .B \-\-print\-file\-name
60 Precede each symbol by the name of the input file where it was found,
61 rather than identifying the input file once only before all of its
68 Display debugger-only symbols; normally these are not listed.
74 (for compatibility with the MIPS \fBnm\fP).
80 Decode (\fIdemangle\fP) low-level symbol names into user-level names.
81 Besides removing any initial underscore prepended by the system, this
82 makes C++ function names readable.
86 Use the output format \fIformat\fP, which can be ``bsd'',
87 ``sysv'', or ``posix''. The default is `bsd''.
88 Only the first character of \fIformat\fP is significant; it can be
89 either upper or lower case.
95 Display only external symbols.
103 Sort symbols numerically by their addresses, not alphabetically by their
110 Don't bother to sort the symbols in any order; just print them in the
117 Use the POSIX.2 standard output format instead of the default format.
118 Equivalent to ``\-f posix''.
124 When listing symbols from archive members, include the index: a mapping
125 (stored in the archive by \c
130 contain definitions for what names.
136 Reverse the sense of the sort (whether numeric or alphabetic); let the
142 .B "\-\-radix=\fIradix"
143 Use \fIradix\fP as the radix for printing the symbol values. It must be
144 ``d'' for decimal, ``o'' for octal, or ``x'' for hexadecimal.
147 .BI "\-\-target=" "bfdname"\c
149 Specify an object code format other than your system's default format.
152 for information on listing available formats.
157 .B \-\-undefined\-only
158 Display only undefined symbols (those external to each object file).
164 Show the version number of
170 Show a summary of the options to
175 .RB "`\|" binutils "\|'"
181 The GNU Binary Utilities\c
182 \&, Roland H. Pesch (October 1991);
185 .BR ranlib "(" 1 ")."
189 Copyright (c) 1991 Free Software Foundation, Inc.
191 Permission is granted to make and distribute verbatim copies of
192 this manual provided the copyright notice and this permission notice
193 are preserved on all copies.
195 Permission is granted to copy and distribute modified versions of this
196 manual under the conditions for verbatim copying, provided that the
197 entire resulting derived work is distributed under the terms of a
198 permission notice identical to this one.
200 Permission is granted to copy and distribute translations of this
201 manual into another language, under the above conditions for modified
202 versions, except that this permission notice may be included in
203 translations approved by the Free Software Foundation instead of in
204 the original English.