1 /* nm.c -- Describe symbol table of a rel file.
2 Copyright 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
3 2001, 2002, 2003, 2004, 2005, 2007, 2008, 2009, 2010
4 Free Software Foundation, Inc.
6 This file is part of GNU Binutils.
8 This program is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 3 of the License, or
11 (at your option) any later version.
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with this program; if not, write to the Free Software
20 Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston, MA
27 #include "aout/stab_gnu.h"
28 #include "aout/ranlib.h"
30 #include "libiberty.h"
32 #include "elf/common.h"
36 /* When sorting by size, we use this structure to hold the size and a
37 pointer to the minisymbol. */
45 /* When fetching relocs, we use this structure to pass information to
48 struct get_relocs_info
56 struct extended_symbol_info
60 elf_symbol_type
*elfinfo
;
61 /* FIXME: We should add more fields for Type, Line, Section. */
63 #define SYM_NAME(sym) (sym->sinfo->name)
64 #define SYM_VALUE(sym) (sym->sinfo->value)
65 #define SYM_TYPE(sym) (sym->sinfo->type)
66 #define SYM_STAB_NAME(sym) (sym->sinfo->stab_name)
67 #define SYM_STAB_DESC(sym) (sym->sinfo->stab_desc)
68 #define SYM_STAB_OTHER(sym) (sym->sinfo->stab_other)
69 #define SYM_SIZE(sym) \
70 (sym->elfinfo ? sym->elfinfo->internal_elf_sym.st_size: sym->ssize)
72 /* The output formatting functions. */
73 static void print_object_filename_bsd (char *);
74 static void print_object_filename_sysv (char *);
75 static void print_object_filename_posix (char *);
76 static void print_archive_filename_bsd (char *);
77 static void print_archive_filename_sysv (char *);
78 static void print_archive_filename_posix (char *);
79 static void print_archive_member_bsd (char *, const char *);
80 static void print_archive_member_sysv (char *, const char *);
81 static void print_archive_member_posix (char *, const char *);
82 static void print_symbol_filename_bsd (bfd
*, bfd
*);
83 static void print_symbol_filename_sysv (bfd
*, bfd
*);
84 static void print_symbol_filename_posix (bfd
*, bfd
*);
85 static void print_value (bfd
*, bfd_vma
);
86 static void print_symbol_info_bsd (struct extended_symbol_info
*, bfd
*);
87 static void print_symbol_info_sysv (struct extended_symbol_info
*, bfd
*);
88 static void print_symbol_info_posix (struct extended_symbol_info
*, bfd
*);
90 /* Support for different output formats. */
93 /* Print the name of an object file given on the command line. */
94 void (*print_object_filename
) (char *);
96 /* Print the name of an archive file given on the command line. */
97 void (*print_archive_filename
) (char *);
99 /* Print the name of an archive member file. */
100 void (*print_archive_member
) (char *, const char *);
102 /* Print the name of the file (and archive, if there is one)
103 containing a symbol. */
104 void (*print_symbol_filename
) (bfd
*, bfd
*);
106 /* Print a line of information about a symbol. */
107 void (*print_symbol_info
) (struct extended_symbol_info
*, bfd
*);
110 static struct output_fns formats
[] =
112 {print_object_filename_bsd
,
113 print_archive_filename_bsd
,
114 print_archive_member_bsd
,
115 print_symbol_filename_bsd
,
116 print_symbol_info_bsd
},
117 {print_object_filename_sysv
,
118 print_archive_filename_sysv
,
119 print_archive_member_sysv
,
120 print_symbol_filename_sysv
,
121 print_symbol_info_sysv
},
122 {print_object_filename_posix
,
123 print_archive_filename_posix
,
124 print_archive_member_posix
,
125 print_symbol_filename_posix
,
126 print_symbol_info_posix
}
129 /* Indices in `formats'. */
131 #define FORMAT_SYSV 1
132 #define FORMAT_POSIX 2
133 #define FORMAT_DEFAULT FORMAT_BSD
135 /* The output format to use. */
136 static struct output_fns
*format
= &formats
[FORMAT_DEFAULT
];
138 /* Command options. */
140 static int do_demangle
= 0; /* Pretty print C++ symbol names. */
141 static int external_only
= 0; /* Print external symbols only. */
142 static int defined_only
= 0; /* Print defined symbols only. */
143 static int no_sort
= 0; /* Don't sort; print syms in order found. */
144 static int print_debug_syms
= 0;/* Print debugger-only symbols too. */
145 static int print_armap
= 0; /* Describe __.SYMDEF data in archive files. */
146 static int print_size
= 0; /* Print size of defined symbols. */
147 static int reverse_sort
= 0; /* Sort in downward(alpha or numeric) order. */
148 static int sort_numerically
= 0;/* Sort in numeric rather than alpha order. */
149 static int sort_by_size
= 0; /* Sort by size of symbol. */
150 static int undefined_only
= 0; /* Print undefined symbols only. */
151 static int dynamic
= 0; /* Print dynamic symbols. */
152 static int show_version
= 0; /* Show the version number. */
153 static int show_stats
= 0; /* Show statistics. */
154 static int show_synthetic
= 0; /* Display synthesized symbols too. */
155 static int line_numbers
= 0; /* Print line numbers for symbols. */
156 static int allow_special_symbols
= 0; /* Allow special symbols. */
158 /* When to print the names of files. Not mutually exclusive in SYSV format. */
159 static int filename_per_file
= 0; /* Once per file, on its own line. */
160 static int filename_per_symbol
= 0; /* Once per symbol, at start of line. */
162 /* Print formats for printing a symbol value. */
163 static char value_format_32bit
[] = "%08lx";
164 #if BFD_HOST_64BIT_LONG
165 static char value_format_64bit
[] = "%016lx";
166 #elif BFD_HOST_64BIT_LONG_LONG
168 static char value_format_64bit
[] = "%016llx";
170 static char value_format_64bit
[] = "%016I64x";
173 static int print_width
= 0;
174 static int print_radix
= 16;
175 /* Print formats for printing stab info. */
176 static char other_format
[] = "%02x";
177 static char desc_format
[] = "%04x";
179 static char *target
= NULL
;
180 static char *plugin_target
= NULL
;
182 /* Used to cache the line numbers for a BFD. */
183 static bfd
*lineno_cache_bfd
;
184 static bfd
*lineno_cache_rel_bfd
;
186 #define OPTION_TARGET 200
187 #define OPTION_PLUGIN 201
189 static struct option long_options
[] =
191 {"debug-syms", no_argument
, &print_debug_syms
, 1},
192 {"demangle", optional_argument
, 0, 'C'},
193 {"dynamic", no_argument
, &dynamic
, 1},
194 {"extern-only", no_argument
, &external_only
, 1},
195 {"format", required_argument
, 0, 'f'},
196 {"help", no_argument
, 0, 'h'},
197 {"line-numbers", no_argument
, 0, 'l'},
198 {"no-cplus", no_argument
, &do_demangle
, 0}, /* Linux compatibility. */
199 {"no-demangle", no_argument
, &do_demangle
, 0},
200 {"no-sort", no_argument
, &no_sort
, 1},
201 {"numeric-sort", no_argument
, &sort_numerically
, 1},
202 {"plugin", required_argument
, 0, OPTION_PLUGIN
},
203 {"portability", no_argument
, 0, 'P'},
204 {"print-armap", no_argument
, &print_armap
, 1},
205 {"print-file-name", no_argument
, 0, 'o'},
206 {"print-size", no_argument
, 0, 'S'},
207 {"radix", required_argument
, 0, 't'},
208 {"reverse-sort", no_argument
, &reverse_sort
, 1},
209 {"size-sort", no_argument
, &sort_by_size
, 1},
210 {"special-syms", no_argument
, &allow_special_symbols
, 1},
211 {"stats", no_argument
, &show_stats
, 1},
212 {"synthetic", no_argument
, &show_synthetic
, 1},
213 {"target", required_argument
, 0, OPTION_TARGET
},
214 {"defined-only", no_argument
, &defined_only
, 1},
215 {"undefined-only", no_argument
, &undefined_only
, 1},
216 {"version", no_argument
, &show_version
, 1},
217 {0, no_argument
, 0, 0}
220 /* Some error-reporting functions. */
223 usage (FILE *stream
, int status
)
225 fprintf (stream
, _("Usage: %s [option(s)] [file(s)]\n"), program_name
);
226 fprintf (stream
, _(" List symbols in [file(s)] (a.out by default).\n"));
227 fprintf (stream
, _(" The options are:\n\
228 -a, --debug-syms Display debugger-only symbols\n\
229 -A, --print-file-name Print name of the input file before every symbol\n\
230 -B Same as --format=bsd\n\
231 -C, --demangle[=STYLE] Decode low-level symbol names into user-level names\n\
232 The STYLE, if specified, can be `auto' (the default),\n\
233 `gnu', `lucid', `arm', `hp', `edg', `gnu-v3', `java'\n\
235 --no-demangle Do not demangle low-level symbol names\n\
236 -D, --dynamic Display dynamic symbols instead of normal symbols\n\
237 --defined-only Display only defined symbols\n\
239 -f, --format=FORMAT Use the output format FORMAT. FORMAT can be `bsd',\n\
240 `sysv' or `posix'. The default is `bsd'\n\
241 -g, --extern-only Display only external symbols\n\
242 -l, --line-numbers Use debugging information to find a filename and\n\
243 line number for each symbol\n\
244 -n, --numeric-sort Sort symbols numerically by address\n\
246 -p, --no-sort Do not sort the symbols\n\
247 -P, --portability Same as --format=posix\n\
248 -r, --reverse-sort Reverse the sense of the sort\n"));
249 #if BFD_SUPPORTS_PLUGINS
250 fprintf (stream
, _("\
251 --plugin NAME Load the specified plugin\n"));
253 fprintf (stream
, _("\
254 -S, --print-size Print size of defined symbols\n\
255 -s, --print-armap Include index for symbols from archive members\n\
256 --size-sort Sort symbols by size\n\
257 --special-syms Include special symbols in the output\n\
258 --synthetic Display synthetic symbols as well\n\
259 -t, --radix=RADIX Use RADIX for printing symbol values\n\
260 --target=BFDNAME Specify the target object format as BFDNAME\n\
261 -u, --undefined-only Display only undefined symbols\n\
262 -X 32_64 (ignored)\n\
263 @FILE Read options from FILE\n\
264 -h, --help Display this information\n\
265 -V, --version Display this program's version number\n\
267 list_supported_targets (program_name
, stream
);
268 if (REPORT_BUGS_TO
[0] && status
== 0)
269 fprintf (stream
, _("Report bugs to %s.\n"), REPORT_BUGS_TO
);
273 /* Set the radix for the symbol value and size according to RADIX. */
276 set_print_radix (char *radix
)
288 value_format_32bit
[4] = *radix
;
289 #if BFD_HOST_64BIT_LONG
290 value_format_64bit
[5] = *radix
;
291 #elif BFD_HOST_64BIT_LONG_LONG
293 value_format_64bit
[6] = *radix
;
295 value_format_64bit
[7] = *radix
;
298 other_format
[3] = desc_format
[3] = *radix
;
301 fatal (_("%s: invalid radix"), radix
);
306 set_output_format (char *f
)
325 fatal (_("%s: invalid output format"), f
);
327 format
= &formats
[i
];
331 get_symbol_type (unsigned int type
)
333 static char buff
[32];
337 case STT_NOTYPE
: return "NOTYPE";
338 case STT_OBJECT
: return "OBJECT";
339 case STT_FUNC
: return "FUNC";
340 case STT_SECTION
: return "SECTION";
341 case STT_FILE
: return "FILE";
342 case STT_COMMON
: return "COMMON";
343 case STT_TLS
: return "TLS";
345 if (type
>= STT_LOPROC
&& type
<= STT_HIPROC
)
346 sprintf (buff
, _("<processor specific>: %d"), type
);
347 else if (type
>= STT_LOOS
&& type
<= STT_HIOS
)
348 sprintf (buff
, _("<OS specific>: %d"), type
);
350 sprintf (buff
, _("<unknown>: %d"), type
);
355 /* Print symbol name NAME, read from ABFD, with printf format FORM,
356 demangling it if requested. */
359 print_symname (const char *form
, const char *name
, bfd
*abfd
)
361 if (do_demangle
&& *name
)
363 char *res
= bfd_demangle (abfd
, name
, DMGL_ANSI
| DMGL_PARAMS
);
377 print_symdef_entry (bfd
*abfd
)
379 symindex idx
= BFD_NO_MORE_SYMBOLS
;
381 bfd_boolean everprinted
= FALSE
;
383 for (idx
= bfd_get_next_mapent (abfd
, idx
, &thesym
);
384 idx
!= BFD_NO_MORE_SYMBOLS
;
385 idx
= bfd_get_next_mapent (abfd
, idx
, &thesym
))
390 printf (_("\nArchive index:\n"));
393 elt
= bfd_get_elt_at_index (abfd
, idx
);
395 bfd_fatal ("bfd_get_elt_at_index");
396 if (thesym
->name
!= (char *) NULL
)
398 print_symname ("%s", thesym
->name
, abfd
);
399 printf (" in %s\n", bfd_get_filename (elt
));
404 /* Choose which symbol entries to print;
405 compact them downward to get rid of the rest.
406 Return the number of symbols to be printed. */
409 filter_symbols (bfd
*abfd
, bfd_boolean is_dynamic
, void *minisyms
,
410 long symcount
, unsigned int size
)
412 bfd_byte
*from
, *fromend
, *to
;
415 store
= bfd_make_empty_symbol (abfd
);
417 bfd_fatal (bfd_get_filename (abfd
));
419 from
= (bfd_byte
*) minisyms
;
420 fromend
= from
+ symcount
* size
;
421 to
= (bfd_byte
*) minisyms
;
423 for (; from
< fromend
; from
+= size
)
430 sym
= bfd_minisymbol_to_symbol (abfd
, is_dynamic
, (const void *) from
, store
);
432 bfd_fatal (bfd_get_filename (abfd
));
435 keep
= bfd_is_und_section (sym
->section
);
436 else if (external_only
)
437 keep
= ((sym
->flags
& BSF_GLOBAL
) != 0
438 || (sym
->flags
& BSF_WEAK
) != 0
439 || bfd_is_und_section (sym
->section
)
440 || bfd_is_com_section (sym
->section
));
445 && ! print_debug_syms
446 && (sym
->flags
& BSF_DEBUGGING
) != 0)
451 && (bfd_is_abs_section (sym
->section
)
452 || bfd_is_und_section (sym
->section
)))
458 if (bfd_is_und_section (sym
->section
))
463 && bfd_is_target_special_symbol (abfd
, sym
)
464 && ! allow_special_symbols
)
470 memcpy (to
, from
, size
);
475 return (to
- (bfd_byte
*) minisyms
) / size
;
478 /* These globals are used to pass information into the sorting
480 static bfd
*sort_bfd
;
481 static bfd_boolean sort_dynamic
;
482 static asymbol
*sort_x
;
483 static asymbol
*sort_y
;
485 /* Symbol-sorting predicates */
486 #define valueof(x) ((x)->section->vma + (x)->value)
488 /* Numeric sorts. Undefined symbols are always considered "less than"
489 defined symbols with zero values. Common symbols are not treated
490 specially -- i.e., their sizes are used as their "values". */
493 non_numeric_forward (const void *P_x
, const void *P_y
)
498 x
= bfd_minisymbol_to_symbol (sort_bfd
, sort_dynamic
, P_x
, sort_x
);
499 y
= bfd_minisymbol_to_symbol (sort_bfd
, sort_dynamic
, P_y
, sort_y
);
500 if (x
== NULL
|| y
== NULL
)
501 bfd_fatal (bfd_get_filename (sort_bfd
));
503 xn
= bfd_asymbol_name (x
);
504 yn
= bfd_asymbol_name (y
);
512 /* Solaris 2.5 has a bug in strcoll.
513 strcoll returns invalid values when confronted with empty strings. */
519 return strcoll (xn
, yn
);
521 return strcmp (xn
, yn
);
526 non_numeric_reverse (const void *x
, const void *y
)
528 return - non_numeric_forward (x
, y
);
532 numeric_forward (const void *P_x
, const void *P_y
)
537 x
= bfd_minisymbol_to_symbol (sort_bfd
, sort_dynamic
, P_x
, sort_x
);
538 y
= bfd_minisymbol_to_symbol (sort_bfd
, sort_dynamic
, P_y
, sort_y
);
539 if (x
== NULL
|| y
== NULL
)
540 bfd_fatal (bfd_get_filename (sort_bfd
));
542 xs
= bfd_get_section (x
);
543 ys
= bfd_get_section (y
);
545 if (bfd_is_und_section (xs
))
547 if (! bfd_is_und_section (ys
))
550 else if (bfd_is_und_section (ys
))
552 else if (valueof (x
) != valueof (y
))
553 return valueof (x
) < valueof (y
) ? -1 : 1;
555 return non_numeric_forward (P_x
, P_y
);
559 numeric_reverse (const void *x
, const void *y
)
561 return - numeric_forward (x
, y
);
564 static int (*(sorters
[2][2])) (const void *, const void *) =
566 { non_numeric_forward
, non_numeric_reverse
},
567 { numeric_forward
, numeric_reverse
}
570 /* This sort routine is used by sort_symbols_by_size. It is similar
571 to numeric_forward, but when symbols have the same value it sorts
572 by section VMA. This simplifies the sort_symbols_by_size code
573 which handles symbols at the end of sections. Also, this routine
574 tries to sort file names before other symbols with the same value.
575 That will make the file name have a zero size, which will make
576 sort_symbols_by_size choose the non file name symbol, leading to
577 more meaningful output. For similar reasons, this code sorts
578 gnu_compiled_* and gcc2_compiled before other symbols with the same
582 size_forward1 (const void *P_x
, const void *P_y
)
590 x
= bfd_minisymbol_to_symbol (sort_bfd
, sort_dynamic
, P_x
, sort_x
);
591 y
= bfd_minisymbol_to_symbol (sort_bfd
, sort_dynamic
, P_y
, sort_y
);
592 if (x
== NULL
|| y
== NULL
)
593 bfd_fatal (bfd_get_filename (sort_bfd
));
595 xs
= bfd_get_section (x
);
596 ys
= bfd_get_section (y
);
598 if (bfd_is_und_section (xs
))
600 if (bfd_is_und_section (ys
))
603 if (valueof (x
) != valueof (y
))
604 return valueof (x
) < valueof (y
) ? -1 : 1;
606 if (xs
->vma
!= ys
->vma
)
607 return xs
->vma
< ys
->vma
? -1 : 1;
609 xn
= bfd_asymbol_name (x
);
610 yn
= bfd_asymbol_name (y
);
614 /* The symbols gnu_compiled and gcc2_compiled convey even less
615 information than the file name, so sort them out first. */
617 xf
= (strstr (xn
, "gnu_compiled") != NULL
618 || strstr (xn
, "gcc2_compiled") != NULL
);
619 yf
= (strstr (yn
, "gnu_compiled") != NULL
620 || strstr (yn
, "gcc2_compiled") != NULL
);
627 /* We use a heuristic for the file name. It may not work on non
628 Unix systems, but it doesn't really matter; the only difference
629 is precisely which symbol names get printed. */
631 #define file_symbol(s, sn, snl) \
632 (((s)->flags & BSF_FILE) != 0 \
633 || ((sn)[(snl) - 2] == '.' \
634 && ((sn)[(snl) - 1] == 'o' \
635 || (sn)[(snl) - 1] == 'a')))
637 xf
= file_symbol (x
, xn
, xnl
);
638 yf
= file_symbol (y
, yn
, ynl
);
645 return non_numeric_forward (P_x
, P_y
);
648 /* This sort routine is used by sort_symbols_by_size. It is sorting
649 an array of size_sym structures into size order. */
652 size_forward2 (const void *P_x
, const void *P_y
)
654 const struct size_sym
*x
= (const struct size_sym
*) P_x
;
655 const struct size_sym
*y
= (const struct size_sym
*) P_y
;
657 if (x
->size
< y
->size
)
658 return reverse_sort
? 1 : -1;
659 else if (x
->size
> y
->size
)
660 return reverse_sort
? -1 : 1;
662 return sorters
[0][reverse_sort
] (x
->minisym
, y
->minisym
);
665 /* Sort the symbols by size. ELF provides a size but for other formats
666 we have to make a guess by assuming that the difference between the
667 address of a symbol and the address of the next higher symbol is the
671 sort_symbols_by_size (bfd
*abfd
, bfd_boolean is_dynamic
, void *minisyms
,
672 long symcount
, unsigned int size
,
673 struct size_sym
**symsizesp
)
675 struct size_sym
*symsizes
;
676 bfd_byte
*from
, *fromend
;
678 asymbol
*store_sym
, *store_next
;
680 qsort (minisyms
, symcount
, size
, size_forward1
);
682 /* We are going to return a special set of symbols and sizes to
684 symsizes
= (struct size_sym
*) xmalloc (symcount
* sizeof (struct size_sym
));
685 *symsizesp
= symsizes
;
687 /* Note that filter_symbols has already removed all absolute and
688 undefined symbols. Here we remove all symbols whose size winds
690 from
= (bfd_byte
*) minisyms
;
691 fromend
= from
+ symcount
* size
;
698 sym
= bfd_minisymbol_to_symbol (abfd
, is_dynamic
, (const void *) from
,
701 bfd_fatal (bfd_get_filename (abfd
));
704 for (; from
< fromend
; from
+= size
)
711 if (from
+ size
< fromend
)
713 next
= bfd_minisymbol_to_symbol (abfd
,
715 (const void *) (from
+ size
),
718 bfd_fatal (bfd_get_filename (abfd
));
723 sec
= bfd_get_section (sym
);
725 if (bfd_get_flavour (abfd
) == bfd_target_elf_flavour
)
726 sz
= ((elf_symbol_type
*) sym
)->internal_elf_sym
.st_size
;
727 else if (bfd_is_com_section (sec
))
731 if (from
+ size
< fromend
732 && sec
== bfd_get_section (next
))
733 sz
= valueof (next
) - valueof (sym
);
735 sz
= (bfd_get_section_vma (abfd
, sec
)
736 + bfd_section_size (abfd
, sec
)
742 symsizes
->minisym
= (const void *) from
;
750 store_sym
= store_next
;
754 symcount
= symsizes
- *symsizesp
;
756 /* We must now sort again by size. */
757 qsort ((void *) *symsizesp
, symcount
, sizeof (struct size_sym
), size_forward2
);
762 /* This function is used to get the relocs for a particular section.
763 It is called via bfd_map_over_sections. */
766 get_relocs (bfd
*abfd
, asection
*sec
, void *dataarg
)
768 struct get_relocs_info
*data
= (struct get_relocs_info
*) dataarg
;
772 if ((sec
->flags
& SEC_RELOC
) == 0)
774 *data
->relocs
= NULL
;
781 relsize
= bfd_get_reloc_upper_bound (abfd
, sec
);
783 bfd_fatal (bfd_get_filename (abfd
));
785 *data
->relocs
= (arelent
**) xmalloc (relsize
);
786 *data
->relcount
= bfd_canonicalize_reloc (abfd
, sec
, *data
->relocs
,
788 if (*data
->relcount
< 0)
789 bfd_fatal (bfd_get_filename (abfd
));
797 /* Print a single symbol. */
800 print_symbol (bfd
*abfd
, asymbol
*sym
, bfd_vma ssize
, bfd
*archive_bfd
)
803 struct extended_symbol_info info
;
807 format
->print_symbol_filename (archive_bfd
, abfd
);
809 bfd_get_symbol_info (abfd
, sym
, &syminfo
);
810 info
.sinfo
= &syminfo
;
812 if (bfd_get_flavour (abfd
) == bfd_target_elf_flavour
)
813 info
.elfinfo
= (elf_symbol_type
*) sym
;
816 format
->print_symbol_info (&info
, abfd
);
820 static asymbol
**syms
;
821 static long symcount
;
822 const char *filename
, *functionname
;
825 /* We need to get the canonical symbols in order to call
826 bfd_find_nearest_line. This is inefficient, but, then, you
827 don't have to use --line-numbers. */
828 if (abfd
!= lineno_cache_bfd
&& syms
!= NULL
)
837 symsize
= bfd_get_symtab_upper_bound (abfd
);
839 bfd_fatal (bfd_get_filename (abfd
));
840 syms
= (asymbol
**) xmalloc (symsize
);
841 symcount
= bfd_canonicalize_symtab (abfd
, syms
);
843 bfd_fatal (bfd_get_filename (abfd
));
844 lineno_cache_bfd
= abfd
;
847 if (bfd_is_und_section (bfd_get_section (sym
)))
849 static asection
**secs
;
850 static arelent
***relocs
;
851 static long *relcount
;
852 static unsigned int seccount
;
856 /* For an undefined symbol, we try to find a reloc for the
857 symbol, and print the line number of the reloc. */
858 if (abfd
!= lineno_cache_rel_bfd
&& relocs
!= NULL
)
860 for (i
= 0; i
< seccount
; i
++)
861 if (relocs
[i
] != NULL
)
873 struct get_relocs_info rinfo
;
875 seccount
= bfd_count_sections (abfd
);
877 secs
= (asection
**) xmalloc (seccount
* sizeof *secs
);
878 relocs
= (arelent
***) xmalloc (seccount
* sizeof *relocs
);
879 relcount
= (long *) xmalloc (seccount
* sizeof *relcount
);
882 rinfo
.relocs
= relocs
;
883 rinfo
.relcount
= relcount
;
885 bfd_map_over_sections (abfd
, get_relocs
, (void *) &rinfo
);
886 lineno_cache_rel_bfd
= abfd
;
889 symname
= bfd_asymbol_name (sym
);
890 for (i
= 0; i
< seccount
; i
++)
894 for (j
= 0; j
< relcount
[i
]; j
++)
899 if (r
->sym_ptr_ptr
!= NULL
900 && (*r
->sym_ptr_ptr
)->section
== sym
->section
901 && (*r
->sym_ptr_ptr
)->value
== sym
->value
903 bfd_asymbol_name (*r
->sym_ptr_ptr
)) == 0
904 && bfd_find_nearest_line (abfd
, secs
[i
], syms
,
905 r
->address
, &filename
,
906 &functionname
, &lineno
)
909 /* We only print the first one we find. */
910 printf ("\t%s:%u", filename
, lineno
);
917 else if (bfd_get_section (sym
)->owner
== abfd
)
919 if ((bfd_find_line (abfd
, syms
, sym
, &filename
, &lineno
)
920 || bfd_find_nearest_line (abfd
, bfd_get_section (sym
),
921 syms
, sym
->value
, &filename
,
922 &functionname
, &lineno
))
925 printf ("\t%s:%u", filename
, lineno
);
932 /* Print the symbols when sorting by size. */
935 print_size_symbols (bfd
*abfd
, bfd_boolean is_dynamic
,
936 struct size_sym
*symsizes
, long symcount
,
940 struct size_sym
*from
, *fromend
;
942 store
= bfd_make_empty_symbol (abfd
);
944 bfd_fatal (bfd_get_filename (abfd
));
947 fromend
= from
+ symcount
;
948 for (; from
< fromend
; from
++)
953 sym
= bfd_minisymbol_to_symbol (abfd
, is_dynamic
, from
->minisym
, store
);
955 bfd_fatal (bfd_get_filename (abfd
));
957 /* For elf we have already computed the correct symbol size. */
958 if (bfd_get_flavour (abfd
) == bfd_target_elf_flavour
)
961 ssize
= from
->size
- bfd_section_vma (abfd
, bfd_get_section (sym
));
963 print_symbol (abfd
, sym
, ssize
, archive_bfd
);
968 /* Print the symbols. If ARCHIVE_BFD is non-NULL, it is the archive
972 print_symbols (bfd
*abfd
, bfd_boolean is_dynamic
, void *minisyms
, long symcount
,
973 unsigned int size
, bfd
*archive_bfd
)
976 bfd_byte
*from
, *fromend
;
978 store
= bfd_make_empty_symbol (abfd
);
980 bfd_fatal (bfd_get_filename (abfd
));
982 from
= (bfd_byte
*) minisyms
;
983 fromend
= from
+ symcount
* size
;
984 for (; from
< fromend
; from
+= size
)
988 sym
= bfd_minisymbol_to_symbol (abfd
, is_dynamic
, from
, store
);
990 bfd_fatal (bfd_get_filename (abfd
));
992 print_symbol (abfd
, sym
, (bfd_vma
) 0, archive_bfd
);
996 /* If ARCHIVE_BFD is non-NULL, it is the archive containing ABFD. */
999 display_rel_file (bfd
*abfd
, bfd
*archive_bfd
)
1004 struct size_sym
*symsizes
;
1008 if (!(bfd_get_file_flags (abfd
) & HAS_SYMS
))
1010 non_fatal (_("%s: no symbols"), bfd_get_filename (abfd
));
1015 symcount
= bfd_read_minisymbols (abfd
, dynamic
, &minisyms
, &size
);
1017 bfd_fatal (bfd_get_filename (abfd
));
1021 non_fatal (_("%s: no symbols"), bfd_get_filename (abfd
));
1025 if (show_synthetic
&& size
== sizeof (asymbol
*))
1029 asymbol
**static_syms
= NULL
;
1030 asymbol
**dyn_syms
= NULL
;
1031 long static_count
= 0;
1036 dyn_count
= symcount
;
1037 dyn_syms
= (asymbol
**) minisyms
;
1041 long storage
= bfd_get_dynamic_symtab_upper_bound (abfd
);
1043 static_count
= symcount
;
1044 static_syms
= (asymbol
**) minisyms
;
1048 dyn_syms
= (asymbol
**) xmalloc (storage
);
1049 dyn_count
= bfd_canonicalize_dynamic_symtab (abfd
, dyn_syms
);
1051 bfd_fatal (bfd_get_filename (abfd
));
1054 synth_count
= bfd_get_synthetic_symtab (abfd
, static_count
, static_syms
,
1055 dyn_count
, dyn_syms
, &synthsyms
);
1056 if (synth_count
> 0)
1062 new_mini
= xmalloc ((symcount
+ synth_count
+ 1) * sizeof (*symp
));
1063 symp
= (asymbol
**) new_mini
;
1064 memcpy (symp
, minisyms
, symcount
* sizeof (*symp
));
1066 for (i
= 0; i
< synth_count
; i
++)
1067 *symp
++ = synthsyms
+ i
;
1069 minisyms
= new_mini
;
1070 symcount
+= synth_count
;
1074 /* Discard the symbols we don't want to print.
1075 It's OK to do this in place; we'll free the storage anyway
1076 (after printing). */
1078 symcount
= filter_symbols (abfd
, dynamic
, minisyms
, symcount
, size
);
1084 sort_dynamic
= dynamic
;
1085 sort_x
= bfd_make_empty_symbol (abfd
);
1086 sort_y
= bfd_make_empty_symbol (abfd
);
1087 if (sort_x
== NULL
|| sort_y
== NULL
)
1088 bfd_fatal (bfd_get_filename (abfd
));
1091 qsort (minisyms
, symcount
, size
,
1092 sorters
[sort_numerically
][reverse_sort
]);
1094 symcount
= sort_symbols_by_size (abfd
, dynamic
, minisyms
, symcount
,
1099 print_symbols (abfd
, dynamic
, minisyms
, symcount
, size
, archive_bfd
);
1101 print_size_symbols (abfd
, dynamic
, symsizes
, symcount
, archive_bfd
);
1108 set_print_width (bfd
*file
)
1110 print_width
= bfd_get_arch_size (file
);
1112 if (print_width
== -1)
1115 Guess the target's bitsize based on its name.
1116 We assume here than any 64-bit format will include
1117 "64" somewhere in its name. The only known exception
1118 is the MMO object file format. */
1119 if (strstr (bfd_get_target (file
), "64") != NULL
1120 || strcmp (bfd_get_target (file
), "mmo") == 0)
1128 display_archive (bfd
*file
)
1131 bfd
*last_arfile
= NULL
;
1134 format
->print_archive_filename (bfd_get_filename (file
));
1137 print_symdef_entry (file
);
1143 arfile
= bfd_openr_next_archived_file (file
, arfile
);
1147 if (bfd_get_error () != bfd_error_no_more_archived_files
)
1148 bfd_fatal (bfd_get_filename (file
));
1152 if (bfd_check_format_matches (arfile
, bfd_object
, &matching
))
1154 set_print_width (arfile
);
1155 format
->print_archive_member (bfd_get_filename (file
),
1156 bfd_get_filename (arfile
));
1157 display_rel_file (arfile
, file
);
1161 bfd_nonfatal (bfd_get_filename (arfile
));
1162 if (bfd_get_error () == bfd_error_file_ambiguously_recognized
)
1164 list_matching_formats (matching
);
1169 if (last_arfile
!= NULL
)
1171 bfd_close (last_arfile
);
1172 lineno_cache_bfd
= NULL
;
1173 lineno_cache_rel_bfd
= NULL
;
1175 last_arfile
= arfile
;
1178 if (last_arfile
!= NULL
)
1180 bfd_close (last_arfile
);
1181 lineno_cache_bfd
= NULL
;
1182 lineno_cache_rel_bfd
= NULL
;
1187 display_file (char *filename
)
1189 bfd_boolean retval
= TRUE
;
1193 if (get_file_size (filename
) < 1)
1196 file
= bfd_openr (filename
, target
? target
: plugin_target
);
1199 bfd_nonfatal (filename
);
1203 if (bfd_check_format (file
, bfd_archive
))
1205 display_archive (file
);
1207 else if (bfd_check_format_matches (file
, bfd_object
, &matching
))
1209 set_print_width (file
);
1210 format
->print_object_filename (filename
);
1211 display_rel_file (file
, NULL
);
1215 bfd_nonfatal (filename
);
1216 if (bfd_get_error () == bfd_error_file_ambiguously_recognized
)
1218 list_matching_formats (matching
);
1224 if (!bfd_close (file
))
1225 bfd_fatal (filename
);
1227 lineno_cache_bfd
= NULL
;
1228 lineno_cache_rel_bfd
= NULL
;
1233 /* The following 3 groups of functions are called unconditionally,
1234 once at the start of processing each file of the appropriate type.
1235 They should check `filename_per_file' and `filename_per_symbol',
1236 as appropriate for their output format, to determine whether to
1239 /* Print the name of an object file given on the command line. */
1242 print_object_filename_bsd (char *filename
)
1244 if (filename_per_file
&& !filename_per_symbol
)
1245 printf ("\n%s:\n", filename
);
1249 print_object_filename_sysv (char *filename
)
1252 printf (_("\n\nUndefined symbols from %s:\n\n"), filename
);
1254 printf (_("\n\nSymbols from %s:\n\n"), filename
);
1255 if (print_width
== 32)
1257 Name Value Class Type Size Line Section\n\n"));
1260 Name Value Class Type Size Line Section\n\n"));
1264 print_object_filename_posix (char *filename
)
1266 if (filename_per_file
&& !filename_per_symbol
)
1267 printf ("%s:\n", filename
);
1270 /* Print the name of an archive file given on the command line. */
1273 print_archive_filename_bsd (char *filename
)
1275 if (filename_per_file
)
1276 printf ("\n%s:\n", filename
);
1280 print_archive_filename_sysv (char *filename ATTRIBUTE_UNUSED
)
1285 print_archive_filename_posix (char *filename ATTRIBUTE_UNUSED
)
1289 /* Print the name of an archive member file. */
1292 print_archive_member_bsd (char *archive ATTRIBUTE_UNUSED
,
1293 const char *filename
)
1295 if (!filename_per_symbol
)
1296 printf ("\n%s:\n", filename
);
1300 print_archive_member_sysv (char *archive
, const char *filename
)
1303 printf (_("\n\nUndefined symbols from %s[%s]:\n\n"), archive
, filename
);
1305 printf (_("\n\nSymbols from %s[%s]:\n\n"), archive
, filename
);
1306 if (print_width
== 32)
1308 Name Value Class Type Size Line Section\n\n"));
1311 Name Value Class Type Size Line Section\n\n"));
1315 print_archive_member_posix (char *archive
, const char *filename
)
1317 if (!filename_per_symbol
)
1318 printf ("%s[%s]:\n", archive
, filename
);
1321 /* Print the name of the file (and archive, if there is one)
1322 containing a symbol. */
1325 print_symbol_filename_bsd (bfd
*archive_bfd
, bfd
*abfd
)
1327 if (filename_per_symbol
)
1330 printf ("%s:", bfd_get_filename (archive_bfd
));
1331 printf ("%s:", bfd_get_filename (abfd
));
1336 print_symbol_filename_sysv (bfd
*archive_bfd
, bfd
*abfd
)
1338 if (filename_per_symbol
)
1341 printf ("%s:", bfd_get_filename (archive_bfd
));
1342 printf ("%s:", bfd_get_filename (abfd
));
1347 print_symbol_filename_posix (bfd
*archive_bfd
, bfd
*abfd
)
1349 if (filename_per_symbol
)
1352 printf ("%s[%s]: ", bfd_get_filename (archive_bfd
),
1353 bfd_get_filename (abfd
));
1355 printf ("%s: ", bfd_get_filename (abfd
));
1359 /* Print a symbol value. */
1362 print_value (bfd
*abfd ATTRIBUTE_UNUSED
, bfd_vma val
)
1364 switch (print_width
)
1367 printf (value_format_32bit
, (unsigned long) val
);
1371 #if BFD_HOST_64BIT_LONG || BFD_HOST_64BIT_LONG_LONG
1372 printf (value_format_64bit
, val
);
1374 /* We have a 64 bit value to print, but the host is only 32 bit. */
1375 if (print_radix
== 16)
1376 bfd_fprintf_vma (abfd
, stdout
, val
);
1382 s
= buf
+ sizeof buf
;
1386 *--s
= (val
% print_radix
) + '0';
1389 while ((buf
+ sizeof buf
- 1) - s
< 16)
1397 fatal (_("Print width has not been initialized (%d)"), print_width
);
1402 /* Print a line of information about a symbol. */
1405 print_symbol_info_bsd (struct extended_symbol_info
*info
, bfd
*abfd
)
1407 if (bfd_is_undefined_symclass (SYM_TYPE (info
)))
1409 if (print_width
== 64)
1415 /* Normally we print the value of the symbol. If we are printing the
1416 size or sorting by size then we print its size, except for the
1417 (weird) special case where both flags are defined, in which case we
1418 print both values. This conforms to documented behaviour. */
1419 if (sort_by_size
&& !print_size
)
1420 print_value (abfd
, SYM_SIZE (info
));
1422 print_value (abfd
, SYM_VALUE (info
));
1424 if (print_size
&& SYM_SIZE (info
))
1427 print_value (abfd
, SYM_SIZE (info
));
1431 printf (" %c", SYM_TYPE (info
));
1433 if (SYM_TYPE (info
) == '-')
1437 printf (other_format
, SYM_STAB_OTHER (info
));
1439 printf (desc_format
, SYM_STAB_DESC (info
));
1440 printf (" %5s", SYM_STAB_NAME (info
));
1442 print_symname (" %s", SYM_NAME (info
), abfd
);
1446 print_symbol_info_sysv (struct extended_symbol_info
*info
, bfd
*abfd
)
1448 print_symname ("%-20s|", SYM_NAME (info
), abfd
);
1450 if (bfd_is_undefined_symclass (SYM_TYPE (info
)))
1452 if (print_width
== 32)
1458 print_value (abfd
, SYM_VALUE (info
));
1460 printf ("| %c |", SYM_TYPE (info
));
1462 if (SYM_TYPE (info
) == '-')
1465 printf ("%18s| ", SYM_STAB_NAME (info
)); /* (C) Type. */
1466 printf (desc_format
, SYM_STAB_DESC (info
)); /* Size. */
1467 printf ("| |"); /* Line, Section. */
1471 /* Type, Size, Line, Section */
1474 get_symbol_type (ELF_ST_TYPE (info
->elfinfo
->internal_elf_sym
.st_info
)));
1478 if (SYM_SIZE (info
))
1479 print_value (abfd
, SYM_SIZE (info
));
1482 if (print_width
== 32)
1489 printf("| |%s", info
->elfinfo
->symbol
.section
->name
);
1496 print_symbol_info_posix (struct extended_symbol_info
*info
, bfd
*abfd
)
1498 print_symname ("%s ", SYM_NAME (info
), abfd
);
1499 printf ("%c ", SYM_TYPE (info
));
1501 if (bfd_is_undefined_symclass (SYM_TYPE (info
)))
1505 print_value (abfd
, SYM_VALUE (info
));
1507 if (SYM_SIZE (info
))
1508 print_value (abfd
, SYM_SIZE (info
));
1513 main (int argc
, char **argv
)
1518 #if defined (HAVE_SETLOCALE) && defined (HAVE_LC_MESSAGES)
1519 setlocale (LC_MESSAGES
, "");
1521 #if defined (HAVE_SETLOCALE)
1522 setlocale (LC_CTYPE
, "");
1523 setlocale (LC_COLLATE
, "");
1525 bindtextdomain (PACKAGE
, LOCALEDIR
);
1526 textdomain (PACKAGE
);
1528 program_name
= *argv
;
1529 xmalloc_set_program_name (program_name
);
1530 #if BFD_SUPPORTS_PLUGINS
1531 bfd_plugin_set_program_name (program_name
);
1534 START_PROGRESS (program_name
, 0);
1536 expandargv (&argc
, &argv
);
1539 set_default_bfd_target ();
1541 while ((c
= getopt_long (argc
, argv
, "aABCDef:gHhlnopPrSst:uvVvX:",
1542 long_options
, (int *) 0)) != EOF
)
1547 print_debug_syms
= 1;
1551 filename_per_symbol
= 1;
1553 case 'B': /* For MIPS compatibility. */
1554 set_output_format ("bsd");
1560 enum demangling_styles style
;
1562 style
= cplus_demangle_name_to_style (optarg
);
1563 if (style
== unknown_demangling
)
1564 fatal (_("unknown demangling style `%s'"),
1567 cplus_demangle_set_style (style
);
1574 /* Ignored for HP/UX compatibility. */
1577 set_output_format (optarg
);
1590 sort_numerically
= 1;
1596 set_output_format ("posix");
1608 set_print_radix (optarg
);
1617 /* Ignored for (partial) AIX compatibility. On AIX, the
1618 argument has values 32, 64, or 32_64, and specifies that
1619 only 32-bit, only 64-bit, or both kinds of objects should
1620 be examined. The default is 32. So plain AIX nm on a
1621 library archive with both kinds of objects will ignore
1622 the 64-bit ones. For GNU nm, the default is and always
1623 has been -X 32_64, and other options are not supported. */
1624 if (strcmp (optarg
, "32_64") != 0)
1625 fatal (_("Only -X 32_64 is supported"));
1628 case OPTION_TARGET
: /* --target */
1632 case OPTION_PLUGIN
: /* --plugin */
1633 #if BFD_SUPPORTS_PLUGINS
1634 plugin_target
= "plugin";
1635 bfd_plugin_set_plugin (optarg
);
1637 fatal (_("sorry - this program has been built without plugin support\n"));
1641 case 0: /* A long option that just sets a flag. */
1650 print_version ("nm");
1652 if (sort_by_size
&& undefined_only
)
1654 non_fatal (_("Using the --size-sort and --undefined-only options together"));
1655 non_fatal (_("will produce no output, since undefined symbols have no size."));
1659 /* OK, all options now parsed. If no filename specified, do a.out. */
1661 return !display_file ("a.out");
1665 if (argc
- optind
> 1)
1666 filename_per_file
= 1;
1668 /* We were given several filenames to do. */
1669 while (optind
< argc
)
1672 if (!display_file (argv
[optind
++]))
1676 END_PROGRESS (program_name
);
1681 char *lim
= (char *) sbrk (0);
1683 non_fatal (_("data size %ld"), (long) (lim
- (char *) &environ
));