1 /* nm.c -- Describe symbol table of a rel file.
2 Copyright (C) 1991-2018 Free Software Foundation, Inc.
4 This file is part of GNU Binutils.
6 This program is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 3 of the License, or
9 (at your option) any later version.
11 This program is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with this program; if not, write to the Free Software
18 Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston, MA
25 #include "aout/stab_gnu.h"
26 #include "aout/ranlib.h"
28 #include "libiberty.h"
30 #include "elf/common.h"
31 #define DO_NOT_DEFINE_AOUTHDR
32 #define DO_NOT_DEFINE_FILHDR
33 #define DO_NOT_DEFINE_LINENO
34 #define DO_NOT_DEFINE_SCNHDR
35 #include "coff/external.h"
36 #include "coff/internal.h"
39 #include "plugin-api.h"
42 /* When sorting by size, we use this structure to hold the size and a
43 pointer to the minisymbol. */
51 /* When fetching relocs, we use this structure to pass information to
54 struct get_relocs_info
62 struct extended_symbol_info
66 elf_symbol_type *elfinfo;
67 coff_symbol_type *coffinfo;
68 /* FIXME: We should add more fields for Type, Line, Section. */
70 #define SYM_NAME(sym) (sym->sinfo->name)
71 #define SYM_VALUE(sym) (sym->sinfo->value)
72 #define SYM_TYPE(sym) (sym->sinfo->type)
73 #define SYM_STAB_NAME(sym) (sym->sinfo->stab_name)
74 #define SYM_STAB_DESC(sym) (sym->sinfo->stab_desc)
75 #define SYM_STAB_OTHER(sym) (sym->sinfo->stab_other)
76 #define SYM_SIZE(sym) \
77 (sym->elfinfo ? sym->elfinfo->internal_elf_sym.st_size: sym->ssize)
79 /* The output formatting functions. */
80 static void print_object_filename_bsd (char *);
81 static void print_object_filename_sysv (char *);
82 static void print_object_filename_posix (char *);
83 static void print_archive_filename_bsd (char *);
84 static void print_archive_filename_sysv (char *);
85 static void print_archive_filename_posix (char *);
86 static void print_archive_member_bsd (char *, const char *);
87 static void print_archive_member_sysv (char *, const char *);
88 static void print_archive_member_posix (char *, const char *);
89 static void print_symbol_filename_bsd (bfd *, bfd *);
90 static void print_symbol_filename_sysv (bfd *, bfd *);
91 static void print_symbol_filename_posix (bfd *, bfd *);
92 static void print_value (bfd *, bfd_vma);
93 static void print_symbol_info_bsd (struct extended_symbol_info *, bfd *);
94 static void print_symbol_info_sysv (struct extended_symbol_info *, bfd *);
95 static void print_symbol_info_posix (struct extended_symbol_info *, bfd *);
97 /* Support for different output formats. */
100 /* Print the name of an object file given on the command line. */
101 void (*print_object_filename) (char *);
103 /* Print the name of an archive file given on the command line. */
104 void (*print_archive_filename) (char *);
106 /* Print the name of an archive member file. */
107 void (*print_archive_member) (char *, const char *);
109 /* Print the name of the file (and archive, if there is one)
110 containing a symbol. */
111 void (*print_symbol_filename) (bfd *, bfd *);
113 /* Print a line of information about a symbol. */
114 void (*print_symbol_info) (struct extended_symbol_info *, bfd *);
117 static struct output_fns formats[] =
119 {print_object_filename_bsd,
120 print_archive_filename_bsd,
121 print_archive_member_bsd,
122 print_symbol_filename_bsd,
123 print_symbol_info_bsd},
124 {print_object_filename_sysv,
125 print_archive_filename_sysv,
126 print_archive_member_sysv,
127 print_symbol_filename_sysv,
128 print_symbol_info_sysv},
129 {print_object_filename_posix,
130 print_archive_filename_posix,
131 print_archive_member_posix,
132 print_symbol_filename_posix,
133 print_symbol_info_posix}
136 /* Indices in `formats'. */
138 #define FORMAT_SYSV 1
139 #define FORMAT_POSIX 2
140 #define FORMAT_DEFAULT FORMAT_BSD
142 /* The output format to use. */
143 static struct output_fns *format = &formats[FORMAT_DEFAULT];
145 /* Command options. */
147 static int do_demangle = 0; /* Pretty print C++ symbol names. */
148 static int external_only = 0; /* Print external symbols only. */
149 static int defined_only = 0; /* Print defined symbols only. */
150 static int no_sort = 0; /* Don't sort; print syms in order found. */
151 static int print_debug_syms = 0;/* Print debugger-only symbols too. */
152 static int print_armap = 0; /* Describe __.SYMDEF data in archive files. */
153 static int print_size = 0; /* Print size of defined symbols. */
154 static int reverse_sort = 0; /* Sort in downward(alpha or numeric) order. */
155 static int sort_numerically = 0;/* Sort in numeric rather than alpha order. */
156 static int sort_by_size = 0; /* Sort by size of symbol. */
157 static int undefined_only = 0; /* Print undefined symbols only. */
158 static int dynamic = 0; /* Print dynamic symbols. */
159 static int show_version = 0; /* Show the version number. */
160 static int show_synthetic = 0; /* Display synthesized symbols too. */
161 static int line_numbers = 0; /* Print line numbers for symbols. */
162 static int allow_special_symbols = 0; /* Allow special symbols. */
163 static int with_symbol_versions = 0; /* Include symbol version information in the output. */
165 static int demangle_flags = DMGL_ANSI | DMGL_PARAMS;
167 /* When to print the names of files. Not mutually exclusive in SYSV format. */
168 static int filename_per_file = 0; /* Once per file, on its own line. */
169 static int filename_per_symbol = 0; /* Once per symbol, at start of line. */
171 /* Print formats for printing a symbol value. */
172 static char value_format_32bit[] = "%08lx";
173 #if BFD_HOST_64BIT_LONG
174 static char value_format_64bit[] = "%016lx";
175 #elif BFD_HOST_64BIT_LONG_LONG
177 static char value_format_64bit[] = "%016llx";
179 static char value_format_64bit[] = "%016I64x";
182 static int print_width = 0;
183 static int print_radix = 16;
184 /* Print formats for printing stab info. */
185 static char other_format[] = "%02x";
186 static char desc_format[] = "%04x";
188 static char *target = NULL;
189 #if BFD_SUPPORTS_PLUGINS
190 static const char *plugin_target = "plugin";
192 static const char *plugin_target = NULL;
195 /* Used to cache the line numbers for a BFD. */
196 static bfd *lineno_cache_bfd;
197 static bfd *lineno_cache_rel_bfd;
199 enum long_option_values
204 OPTION_RECURSE_LIMIT,
205 OPTION_NO_RECURSE_LIMIT
208 static struct option long_options[] =
210 {"debug-syms", no_argument, &print_debug_syms, 1},
211 {"demangle", optional_argument, 0, 'C'},
212 {"dynamic", no_argument, &dynamic, 1},
213 {"extern-only", no_argument, &external_only, 1},
214 {"format", required_argument, 0, 'f'},
215 {"help", no_argument, 0, 'h'},
216 {"line-numbers", no_argument, 0, 'l'},
217 {"no-cplus", no_argument, &do_demangle, 0}, /* Linux compatibility. */
218 {"no-demangle", no_argument, &do_demangle, 0},
219 {"no-recurse-limit", no_argument, NULL, OPTION_NO_RECURSE_LIMIT},
220 {"no-recursion-limit", no_argument, NULL, OPTION_NO_RECURSE_LIMIT},
221 {"no-sort", no_argument, 0, 'p'},
222 {"numeric-sort", no_argument, 0, 'n'},
223 {"plugin", required_argument, 0, OPTION_PLUGIN},
224 {"portability", no_argument, 0, 'P'},
225 {"print-armap", no_argument, &print_armap, 1},
226 {"print-file-name", no_argument, 0, 'o'},
227 {"print-size", no_argument, 0, 'S'},
228 {"radix", required_argument, 0, 't'},
229 {"recurse-limit", no_argument, NULL, OPTION_RECURSE_LIMIT},
230 {"recursion-limit", no_argument, NULL, OPTION_RECURSE_LIMIT},
231 {"reverse-sort", no_argument, &reverse_sort, 1},
232 {"size-sort", no_argument, 0, OPTION_SIZE_SORT},
233 {"special-syms", no_argument, &allow_special_symbols, 1},
234 {"synthetic", no_argument, &show_synthetic, 1},
235 {"target", required_argument, 0, OPTION_TARGET},
236 {"defined-only", no_argument, &defined_only, 1},
237 {"undefined-only", no_argument, &undefined_only, 1},
238 {"version", no_argument, &show_version, 1},
239 {"with-symbol-versions", no_argument, &with_symbol_versions, 1},
240 {0, no_argument, 0, 0}
243 /* Some error-reporting functions. */
245 ATTRIBUTE_NORETURN static void
246 usage (FILE *stream, int status)
248 fprintf (stream, _("Usage: %s [option(s)] [file(s)]\n"), program_name);
249 fprintf (stream, _(" List symbols in [file(s)] (a.out by default).\n"));
250 fprintf (stream, _(" The options are:\n\
251 -a, --debug-syms Display debugger-only symbols\n\
252 -A, --print-file-name Print name of the input file before every symbol\n\
253 -B Same as --format=bsd\n\
254 -C, --demangle[=STYLE] Decode low-level symbol names into user-level names\n\
255 The STYLE, if specified, can be `auto' (the default),\n\
256 `gnu', `lucid', `arm', `hp', `edg', `gnu-v3', `java'\n\
258 --no-demangle Do not demangle low-level symbol names\n\
259 --recurse-limit Enable a demangling recursion limit. This is the default.\n\
260 --no-recurse-limit Disable a demangling recursion limit.\n\
261 -D, --dynamic Display dynamic symbols instead of normal symbols\n\
262 --defined-only Display only defined symbols\n\
264 -f, --format=FORMAT Use the output format FORMAT. FORMAT can be `bsd',\n\
265 `sysv' or `posix'. The default is `bsd'\n\
266 -g, --extern-only Display only external symbols\n\
267 -l, --line-numbers Use debugging information to find a filename and\n\
268 line number for each symbol\n\
269 -n, --numeric-sort Sort symbols numerically by address\n\
271 -p, --no-sort Do not sort the symbols\n\
272 -P, --portability Same as --format=posix\n\
273 -r, --reverse-sort Reverse the sense of the sort\n"));
274 #if BFD_SUPPORTS_PLUGINS
275 fprintf (stream, _("\
276 --plugin NAME Load the specified plugin\n"));
278 fprintf (stream, _("\
279 -S, --print-size Print size of defined symbols\n\
280 -s, --print-armap Include index for symbols from archive members\n\
281 --size-sort Sort symbols by size\n\
282 --special-syms Include special symbols in the output\n\
283 --synthetic Display synthetic symbols as well\n\
284 -t, --radix=RADIX Use RADIX for printing symbol values\n\
285 --target=BFDNAME Specify the target object format as BFDNAME\n\
286 -u, --undefined-only Display only undefined symbols\n\
287 --with-symbol-versions Display version strings after symbol names\n\
288 -X 32_64 (ignored)\n\
289 @FILE Read options from FILE\n\
290 -h, --help Display this information\n\
291 -V, --version Display this program's version number\n\
293 list_supported_targets (program_name, stream);
294 if (REPORT_BUGS_TO[0] && status == 0)
295 fprintf (stream, _("Report bugs to %s.\n"), REPORT_BUGS_TO);
299 /* Set the radix for the symbol value and size according to RADIX. */
302 set_print_radix (char *radix)
314 value_format_32bit[4] = *radix;
315 #if BFD_HOST_64BIT_LONG
316 value_format_64bit[5] = *radix;
317 #elif BFD_HOST_64BIT_LONG_LONG
319 value_format_64bit[6] = *radix;
321 value_format_64bit[7] = *radix;
324 other_format[3] = desc_format[3] = *radix;
327 fatal (_("%s: invalid radix"), radix);
332 set_output_format (char *f)
351 fatal (_("%s: invalid output format"), f);
353 format = &formats[i];
357 get_elf_symbol_type (unsigned int type)
364 case STT_NOTYPE: return "NOTYPE";
365 case STT_OBJECT: return "OBJECT";
366 case STT_FUNC: return "FUNC";
367 case STT_SECTION: return "SECTION";
368 case STT_FILE: return "FILE";
369 case STT_COMMON: return "COMMON";
370 case STT_TLS: return "TLS";
374 if (type >= STT_LOPROC && type <= STT_HIPROC)
375 n = asprintf (&bufp, _("<processor specific>: %d"), type);
376 else if (type >= STT_LOOS && type <= STT_HIOS)
377 n = asprintf (&bufp, _("<OS specific>: %d"), type);
379 n = asprintf (&bufp, _("<unknown>: %d"), type);
381 fatal ("%s", xstrerror (errno));
386 get_coff_symbol_type (const struct internal_syment *sym)
391 switch (sym->n_sclass)
393 case C_BLOCK: return "Block";
394 case C_FILE: return "File";
395 case C_LINE: return "Line";
401 switch (DTYPE(sym->n_type))
403 case DT_FCN: return "Function";
404 case DT_PTR: return "Pointer";
405 case DT_ARY: return "Array";
409 n = asprintf (&bufp, _("<unknown>: %d/%d"), sym->n_sclass, sym->n_type);
411 fatal ("%s", xstrerror (errno));
415 /* Print symbol name NAME, read from ABFD, with printf format FORM,
416 demangling it if requested. */
419 print_symname (const char *form, const char *name, bfd *abfd)
421 if (do_demangle && *name)
423 char *res = bfd_demangle (abfd, name, demangle_flags);
437 print_symdef_entry (bfd *abfd)
439 symindex idx = BFD_NO_MORE_SYMBOLS;
441 bfd_boolean everprinted = FALSE;
443 for (idx = bfd_get_next_mapent (abfd, idx, &thesym);
444 idx != BFD_NO_MORE_SYMBOLS;
445 idx = bfd_get_next_mapent (abfd, idx, &thesym))
450 printf (_("\nArchive index:\n"));
453 elt = bfd_get_elt_at_index (abfd, idx);
455 bfd_fatal ("bfd_get_elt_at_index");
456 if (thesym->name != (char *) NULL)
458 print_symname ("%s", thesym->name, abfd);
459 printf (" in %s\n", bfd_get_filename (elt));
464 /* Choose which symbol entries to print;
465 compact them downward to get rid of the rest.
466 Return the number of symbols to be printed. */
469 filter_symbols (bfd *abfd, bfd_boolean is_dynamic, void *minisyms,
470 long symcount, unsigned int size)
472 bfd_byte *from, *fromend, *to;
475 store = bfd_make_empty_symbol (abfd);
477 bfd_fatal (bfd_get_filename (abfd));
479 from = (bfd_byte *) minisyms;
480 fromend = from + symcount * size;
481 to = (bfd_byte *) minisyms;
483 for (; from < fromend; from += size)
490 sym = bfd_minisymbol_to_symbol (abfd, is_dynamic, (const void *) from, store);
492 bfd_fatal (bfd_get_filename (abfd));
494 if (sym->name[0] == '_'
495 && sym->name[1] == '_'
496 && strcmp (sym->name + (sym->name[2] == '_'), "__gnu_lto_slim") == 0)
497 non_fatal (_("%s: plugin needed to handle lto object"),
498 bfd_get_filename (abfd));
501 keep = bfd_is_und_section (sym->section);
502 else if (external_only)
503 /* PR binutls/12753: Unique symbols are global too. */
504 keep = ((sym->flags & (BSF_GLOBAL
506 | BSF_GNU_UNIQUE)) != 0
507 || bfd_is_und_section (sym->section)
508 || bfd_is_com_section (sym->section));
513 && ! print_debug_syms
514 && (sym->flags & BSF_DEBUGGING) != 0)
519 && (bfd_is_abs_section (sym->section)
520 || bfd_is_und_section (sym->section)))
526 if (bfd_is_und_section (sym->section))
531 && bfd_is_target_special_symbol (abfd, sym)
532 && ! allow_special_symbols)
538 memcpy (to, from, size);
543 return (to - (bfd_byte *) minisyms) / size;
546 /* These globals are used to pass information into the sorting
548 static bfd *sort_bfd;
549 static bfd_boolean sort_dynamic;
550 static asymbol *sort_x;
551 static asymbol *sort_y;
553 /* Symbol-sorting predicates */
554 #define valueof(x) ((x)->section->vma + (x)->value)
556 /* Numeric sorts. Undefined symbols are always considered "less than"
557 defined symbols with zero values. Common symbols are not treated
558 specially -- i.e., their sizes are used as their "values". */
561 non_numeric_forward (const void *P_x, const void *P_y)
566 x = bfd_minisymbol_to_symbol (sort_bfd, sort_dynamic, P_x, sort_x);
567 y = bfd_minisymbol_to_symbol (sort_bfd, sort_dynamic, P_y, sort_y);
568 if (x == NULL || y == NULL)
569 bfd_fatal (bfd_get_filename (sort_bfd));
571 xn = bfd_asymbol_name (x);
572 yn = bfd_asymbol_name (y);
580 /* Solaris 2.5 has a bug in strcoll.
581 strcoll returns invalid values when confronted with empty strings. */
587 return strcoll (xn, yn);
589 return strcmp (xn, yn);
594 non_numeric_reverse (const void *x, const void *y)
596 return - non_numeric_forward (x, y);
600 numeric_forward (const void *P_x, const void *P_y)
605 x = bfd_minisymbol_to_symbol (sort_bfd, sort_dynamic, P_x, sort_x);
606 y = bfd_minisymbol_to_symbol (sort_bfd, sort_dynamic, P_y, sort_y);
607 if (x == NULL || y == NULL)
608 bfd_fatal (bfd_get_filename (sort_bfd));
610 xs = bfd_get_section (x);
611 ys = bfd_get_section (y);
613 if (bfd_is_und_section (xs))
615 if (! bfd_is_und_section (ys))
618 else if (bfd_is_und_section (ys))
620 else if (valueof (x) != valueof (y))
621 return valueof (x) < valueof (y) ? -1 : 1;
623 return non_numeric_forward (P_x, P_y);
627 numeric_reverse (const void *x, const void *y)
629 return - numeric_forward (x, y);
632 static int (*(sorters[2][2])) (const void *, const void *) =
634 { non_numeric_forward, non_numeric_reverse },
635 { numeric_forward, numeric_reverse }
638 /* This sort routine is used by sort_symbols_by_size. It is similar
639 to numeric_forward, but when symbols have the same value it sorts
640 by section VMA. This simplifies the sort_symbols_by_size code
641 which handles symbols at the end of sections. Also, this routine
642 tries to sort file names before other symbols with the same value.
643 That will make the file name have a zero size, which will make
644 sort_symbols_by_size choose the non file name symbol, leading to
645 more meaningful output. For similar reasons, this code sorts
646 gnu_compiled_* and gcc2_compiled before other symbols with the same
650 size_forward1 (const void *P_x, const void *P_y)
658 x = bfd_minisymbol_to_symbol (sort_bfd, sort_dynamic, P_x, sort_x);
659 y = bfd_minisymbol_to_symbol (sort_bfd, sort_dynamic, P_y, sort_y);
660 if (x == NULL || y == NULL)
661 bfd_fatal (bfd_get_filename (sort_bfd));
663 xs = bfd_get_section (x);
664 ys = bfd_get_section (y);
666 if (bfd_is_und_section (xs))
668 if (bfd_is_und_section (ys))
671 if (valueof (x) != valueof (y))
672 return valueof (x) < valueof (y) ? -1 : 1;
674 if (xs->vma != ys->vma)
675 return xs->vma < ys->vma ? -1 : 1;
677 xn = bfd_asymbol_name (x);
678 yn = bfd_asymbol_name (y);
682 /* The symbols gnu_compiled and gcc2_compiled convey even less
683 information than the file name, so sort them out first. */
685 xf = (strstr (xn, "gnu_compiled") != NULL
686 || strstr (xn, "gcc2_compiled") != NULL);
687 yf = (strstr (yn, "gnu_compiled") != NULL
688 || strstr (yn, "gcc2_compiled") != NULL);
695 /* We use a heuristic for the file name. It may not work on non
696 Unix systems, but it doesn't really matter; the only difference
697 is precisely which symbol names get printed. */
699 #define file_symbol(s, sn, snl) \
700 (((s)->flags & BSF_FILE) != 0 \
702 && (sn)[(snl) - 2] == '.' \
703 && ((sn)[(snl) - 1] == 'o' \
704 || (sn)[(snl) - 1] == 'a')))
706 xf = file_symbol (x, xn, xnl);
707 yf = file_symbol (y, yn, ynl);
714 return non_numeric_forward (P_x, P_y);
717 /* This sort routine is used by sort_symbols_by_size. It is sorting
718 an array of size_sym structures into size order. */
721 size_forward2 (const void *P_x, const void *P_y)
723 const struct size_sym *x = (const struct size_sym *) P_x;
724 const struct size_sym *y = (const struct size_sym *) P_y;
726 if (x->size < y->size)
727 return reverse_sort ? 1 : -1;
728 else if (x->size > y->size)
729 return reverse_sort ? -1 : 1;
731 return sorters[0][reverse_sort] (x->minisym, y->minisym);
734 /* Sort the symbols by size. ELF provides a size but for other formats
735 we have to make a guess by assuming that the difference between the
736 address of a symbol and the address of the next higher symbol is the
740 sort_symbols_by_size (bfd *abfd, bfd_boolean is_dynamic, void *minisyms,
741 long symcount, unsigned int size,
742 struct size_sym **symsizesp)
744 struct size_sym *symsizes;
745 bfd_byte *from, *fromend;
747 asymbol *store_sym, *store_next;
749 qsort (minisyms, symcount, size, size_forward1);
751 /* We are going to return a special set of symbols and sizes to
753 symsizes = (struct size_sym *) xmalloc (symcount * sizeof (struct size_sym));
754 *symsizesp = symsizes;
756 /* Note that filter_symbols has already removed all absolute and
757 undefined symbols. Here we remove all symbols whose size winds
759 from = (bfd_byte *) minisyms;
760 fromend = from + symcount * size;
767 sym = bfd_minisymbol_to_symbol (abfd, is_dynamic, (const void *) from,
770 bfd_fatal (bfd_get_filename (abfd));
773 for (; from < fromend; from += size)
780 if (from + size < fromend)
782 next = bfd_minisymbol_to_symbol (abfd,
784 (const void *) (from + size),
787 bfd_fatal (bfd_get_filename (abfd));
792 sec = bfd_get_section (sym);
794 /* Synthetic symbols don't have a full type set of data available, thus
795 we can't rely on that information for the symbol size. Ditto for
796 bfd/section.c:global_syms like *ABS*. */
797 if ((sym->flags & (BSF_SECTION_SYM | BSF_SYNTHETIC)) == 0
798 && bfd_get_flavour (abfd) == bfd_target_elf_flavour)
799 sz = ((elf_symbol_type *) sym)->internal_elf_sym.st_size;
800 else if ((sym->flags & (BSF_SECTION_SYM | BSF_SYNTHETIC)) == 0
801 && bfd_is_com_section (sec))
805 if (from + size < fromend
806 && sec == bfd_get_section (next))
807 sz = valueof (next) - valueof (sym);
809 sz = (bfd_get_section_vma (abfd, sec)
810 + bfd_section_size (abfd, sec)
816 symsizes->minisym = (const void *) from;
824 store_sym = store_next;
828 symcount = symsizes - *symsizesp;
830 /* We must now sort again by size. */
831 qsort ((void *) *symsizesp, symcount, sizeof (struct size_sym), size_forward2);
836 /* This function is used to get the relocs for a particular section.
837 It is called via bfd_map_over_sections. */
840 get_relocs (bfd *abfd, asection *sec, void *dataarg)
842 struct get_relocs_info *data = (struct get_relocs_info *) dataarg;
846 if ((sec->flags & SEC_RELOC) == 0)
848 *data->relocs = NULL;
855 relsize = bfd_get_reloc_upper_bound (abfd, sec);
857 bfd_fatal (bfd_get_filename (abfd));
859 *data->relocs = (arelent **) xmalloc (relsize);
860 *data->relcount = bfd_canonicalize_reloc (abfd, sec, *data->relocs,
862 if (*data->relcount < 0)
863 bfd_fatal (bfd_get_filename (abfd));
871 /* Print a single symbol. */
874 print_symbol (bfd * abfd,
880 struct extended_symbol_info info;
884 format->print_symbol_filename (archive_bfd, abfd);
886 bfd_get_symbol_info (abfd, sym, &syminfo);
888 info.sinfo = &syminfo;
890 /* Synthetic symbols do not have a full symbol type set of data available.
891 Nor do bfd/section.c:global_syms like *ABS*. */
892 if ((sym->flags & (BSF_SECTION_SYM | BSF_SYNTHETIC)) != 0)
895 info.coffinfo = NULL;
899 info.elfinfo = elf_symbol_from (abfd, sym);
900 info.coffinfo = coff_symbol_from (sym);
903 format->print_symbol_info (&info, abfd);
905 if (with_symbol_versions)
907 const char * version_string = NULL;
908 bfd_boolean hidden = FALSE;
910 if ((sym->flags & (BSF_SECTION_SYM | BSF_SYNTHETIC)) == 0)
911 version_string = bfd_get_symbol_version_string (abfd, sym, &hidden);
913 if (bfd_is_und_section (bfd_get_section (sym)))
916 if (version_string && *version_string != '\0')
917 printf (hidden ? "@%s" : "@@%s", version_string);
922 static asymbol **syms;
923 static long symcount;
924 const char *filename, *functionname;
927 /* We need to get the canonical symbols in order to call
928 bfd_find_nearest_line. This is inefficient, but, then, you
929 don't have to use --line-numbers. */
930 if (abfd != lineno_cache_bfd && syms != NULL)
939 symsize = bfd_get_symtab_upper_bound (abfd);
941 bfd_fatal (bfd_get_filename (abfd));
942 syms = (asymbol **) xmalloc (symsize);
943 symcount = bfd_canonicalize_symtab (abfd, syms);
945 bfd_fatal (bfd_get_filename (abfd));
946 lineno_cache_bfd = abfd;
949 if (bfd_is_und_section (bfd_get_section (sym)))
951 static asection **secs;
952 static arelent ***relocs;
953 static long *relcount;
954 static unsigned int seccount;
958 /* For an undefined symbol, we try to find a reloc for the
959 symbol, and print the line number of the reloc. */
960 if (abfd != lineno_cache_rel_bfd && relocs != NULL)
962 for (i = 0; i < seccount; i++)
963 if (relocs[i] != NULL)
975 struct get_relocs_info rinfo;
977 seccount = bfd_count_sections (abfd);
979 secs = (asection **) xmalloc (seccount * sizeof *secs);
980 relocs = (arelent ***) xmalloc (seccount * sizeof *relocs);
981 relcount = (long *) xmalloc (seccount * sizeof *relcount);
984 rinfo.relocs = relocs;
985 rinfo.relcount = relcount;
987 bfd_map_over_sections (abfd, get_relocs, (void *) &rinfo);
988 lineno_cache_rel_bfd = abfd;
991 symname = bfd_asymbol_name (sym);
992 for (i = 0; i < seccount; i++)
996 for (j = 0; j < relcount[i]; j++)
1001 if (r->sym_ptr_ptr != NULL
1002 && (*r->sym_ptr_ptr)->section == sym->section
1003 && (*r->sym_ptr_ptr)->value == sym->value
1005 bfd_asymbol_name (*r->sym_ptr_ptr)) == 0
1006 && bfd_find_nearest_line (abfd, secs[i], syms,
1007 r->address, &filename,
1008 &functionname, &lineno)
1009 && filename != NULL)
1011 /* We only print the first one we find. */
1012 printf ("\t%s:%u", filename, lineno);
1019 else if (bfd_get_section (sym)->owner == abfd)
1021 if ((bfd_find_line (abfd, syms, sym, &filename, &lineno)
1022 || bfd_find_nearest_line (abfd, bfd_get_section (sym),
1023 syms, sym->value, &filename,
1024 &functionname, &lineno))
1027 printf ("\t%s:%u", filename, lineno);
1034 /* Print the symbols when sorting by size. */
1037 print_size_symbols (bfd * abfd,
1038 bfd_boolean is_dynamic,
1039 struct size_sym * symsizes,
1044 struct size_sym *from;
1045 struct size_sym *fromend;
1047 store = bfd_make_empty_symbol (abfd);
1049 bfd_fatal (bfd_get_filename (abfd));
1052 fromend = from + symcount;
1054 for (; from < fromend; from++)
1058 sym = bfd_minisymbol_to_symbol (abfd, is_dynamic, from->minisym, store);
1060 bfd_fatal (bfd_get_filename (abfd));
1062 print_symbol (abfd, sym, from->size, archive_bfd);
1067 /* Print the symbols of ABFD that are held in MINISYMS.
1069 If ARCHIVE_BFD is non-NULL, it is the archive containing ABFD.
1071 SYMCOUNT is the number of symbols in MINISYMS.
1073 SIZE is the size of a symbol in MINISYMS. */
1076 print_symbols (bfd * abfd,
1077 bfd_boolean is_dynamic,
1087 store = bfd_make_empty_symbol (abfd);
1089 bfd_fatal (bfd_get_filename (abfd));
1091 from = (bfd_byte *) minisyms;
1092 fromend = from + symcount * size;
1094 for (; from < fromend; from += size)
1098 sym = bfd_minisymbol_to_symbol (abfd, is_dynamic, from, store);
1100 bfd_fatal (bfd_get_filename (abfd));
1102 print_symbol (abfd, sym, (bfd_vma) 0, archive_bfd);
1106 /* If ARCHIVE_BFD is non-NULL, it is the archive containing ABFD. */
1109 display_rel_file (bfd *abfd, bfd *archive_bfd)
1114 struct size_sym *symsizes;
1115 asymbol *synthsyms = NULL;
1119 if (!(bfd_get_file_flags (abfd) & HAS_SYMS))
1121 non_fatal (_("%s: no symbols"), bfd_get_filename (abfd));
1126 symcount = bfd_read_minisymbols (abfd, dynamic, &minisyms, &size);
1129 if (dynamic && bfd_get_error () == bfd_error_no_symbols)
1131 non_fatal (_("%s: no symbols"), bfd_get_filename (abfd));
1135 bfd_fatal (bfd_get_filename (abfd));
1140 non_fatal (_("%s: no symbols"), bfd_get_filename (abfd));
1144 if (show_synthetic && size == sizeof (asymbol *))
1146 asymbol **static_syms = NULL;
1147 asymbol **dyn_syms = NULL;
1148 long static_count = 0;
1154 dyn_count = symcount;
1155 dyn_syms = (asymbol **) minisyms;
1159 long storage = bfd_get_dynamic_symtab_upper_bound (abfd);
1161 static_count = symcount;
1162 static_syms = (asymbol **) minisyms;
1166 dyn_syms = (asymbol **) xmalloc (storage);
1167 dyn_count = bfd_canonicalize_dynamic_symtab (abfd, dyn_syms);
1169 bfd_fatal (bfd_get_filename (abfd));
1173 synth_count = bfd_get_synthetic_symtab (abfd, static_count, static_syms,
1174 dyn_count, dyn_syms, &synthsyms);
1175 if (synth_count > 0)
1180 minisyms = xrealloc (minisyms,
1181 (symcount + synth_count + 1) * sizeof (*symp));
1182 symp = (asymbol **) minisyms + symcount;
1183 for (i = 0; i < synth_count; i++)
1184 *symp++ = synthsyms + i;
1186 symcount += synth_count;
1190 /* Discard the symbols we don't want to print.
1191 It's OK to do this in place; we'll free the storage anyway
1192 (after printing). */
1194 symcount = filter_symbols (abfd, dynamic, minisyms, symcount, size);
1200 sort_dynamic = dynamic;
1201 sort_x = bfd_make_empty_symbol (abfd);
1202 sort_y = bfd_make_empty_symbol (abfd);
1203 if (sort_x == NULL || sort_y == NULL)
1204 bfd_fatal (bfd_get_filename (abfd));
1207 qsort (minisyms, symcount, size,
1208 sorters[sort_numerically][reverse_sort]);
1210 symcount = sort_symbols_by_size (abfd, dynamic, minisyms, symcount,
1215 print_symbols (abfd, dynamic, minisyms, symcount, size, archive_bfd);
1217 print_size_symbols (abfd, dynamic, symsizes, symcount, archive_bfd);
1226 set_print_width (bfd *file)
1228 print_width = bfd_get_arch_size (file);
1230 if (print_width == -1)
1233 Guess the target's bitsize based on its name.
1234 We assume here than any 64-bit format will include
1235 "64" somewhere in its name. The only known exception
1236 is the MMO object file format. */
1237 if (strstr (bfd_get_target (file), "64") != NULL
1238 || strcmp (bfd_get_target (file), "mmo") == 0)
1246 display_archive (bfd *file)
1249 bfd *last_arfile = NULL;
1252 format->print_archive_filename (bfd_get_filename (file));
1255 print_symdef_entry (file);
1261 arfile = bfd_openr_next_archived_file (file, arfile);
1265 if (bfd_get_error () != bfd_error_no_more_archived_files)
1266 bfd_fatal (bfd_get_filename (file));
1270 if (bfd_check_format_matches (arfile, bfd_object, &matching))
1272 set_print_width (arfile);
1273 format->print_archive_member (bfd_get_filename (file),
1274 bfd_get_filename (arfile));
1275 display_rel_file (arfile, file);
1279 bfd_nonfatal (bfd_get_filename (arfile));
1280 if (bfd_get_error () == bfd_error_file_ambiguously_recognized)
1282 list_matching_formats (matching);
1287 if (last_arfile != NULL)
1289 bfd_close (last_arfile);
1290 lineno_cache_bfd = NULL;
1291 lineno_cache_rel_bfd = NULL;
1292 if (arfile == last_arfile)
1295 last_arfile = arfile;
1298 if (last_arfile != NULL)
1300 bfd_close (last_arfile);
1301 lineno_cache_bfd = NULL;
1302 lineno_cache_rel_bfd = NULL;
1307 display_file (char *filename)
1309 bfd_boolean retval = TRUE;
1313 if (get_file_size (filename) < 1)
1316 file = bfd_openr (filename, target ? target : plugin_target);
1319 bfd_nonfatal (filename);
1323 /* If printing line numbers, decompress the debug sections. */
1325 file->flags |= BFD_DECOMPRESS;
1327 if (bfd_check_format (file, bfd_archive))
1329 display_archive (file);
1331 else if (bfd_check_format_matches (file, bfd_object, &matching))
1333 set_print_width (file);
1334 format->print_object_filename (filename);
1335 display_rel_file (file, NULL);
1339 bfd_nonfatal (filename);
1340 if (bfd_get_error () == bfd_error_file_ambiguously_recognized)
1342 list_matching_formats (matching);
1348 if (!bfd_close (file))
1349 bfd_fatal (filename);
1351 lineno_cache_bfd = NULL;
1352 lineno_cache_rel_bfd = NULL;
1357 /* The following 3 groups of functions are called unconditionally,
1358 once at the start of processing each file of the appropriate type.
1359 They should check `filename_per_file' and `filename_per_symbol',
1360 as appropriate for their output format, to determine whether to
1363 /* Print the name of an object file given on the command line. */
1366 print_object_filename_bsd (char *filename)
1368 if (filename_per_file && !filename_per_symbol)
1369 printf ("\n%s:\n", filename);
1373 print_object_filename_sysv (char *filename)
1376 printf (_("\n\nUndefined symbols from %s:\n\n"), filename);
1378 printf (_("\n\nSymbols from %s:\n\n"), filename);
1379 if (print_width == 32)
1381 Name Value Class Type Size Line Section\n\n"));
1384 Name Value Class Type Size Line Section\n\n"));
1388 print_object_filename_posix (char *filename)
1390 if (filename_per_file && !filename_per_symbol)
1391 printf ("%s:\n", filename);
1394 /* Print the name of an archive file given on the command line. */
1397 print_archive_filename_bsd (char *filename)
1399 if (filename_per_file)
1400 printf ("\n%s:\n", filename);
1404 print_archive_filename_sysv (char *filename ATTRIBUTE_UNUSED)
1409 print_archive_filename_posix (char *filename ATTRIBUTE_UNUSED)
1413 /* Print the name of an archive member file. */
1416 print_archive_member_bsd (char *archive ATTRIBUTE_UNUSED,
1417 const char *filename)
1419 if (!filename_per_symbol)
1420 printf ("\n%s:\n", filename);
1424 print_archive_member_sysv (char *archive, const char *filename)
1427 printf (_("\n\nUndefined symbols from %s[%s]:\n\n"), archive, filename);
1429 printf (_("\n\nSymbols from %s[%s]:\n\n"), archive, filename);
1430 if (print_width == 32)
1432 Name Value Class Type Size Line Section\n\n"));
1435 Name Value Class Type Size Line Section\n\n"));
1439 print_archive_member_posix (char *archive, const char *filename)
1441 if (!filename_per_symbol)
1442 printf ("%s[%s]:\n", archive, filename);
1445 /* Print the name of the file (and archive, if there is one)
1446 containing a symbol. */
1449 print_symbol_filename_bsd (bfd *archive_bfd, bfd *abfd)
1451 if (filename_per_symbol)
1454 printf ("%s:", bfd_get_filename (archive_bfd));
1455 printf ("%s:", bfd_get_filename (abfd));
1460 print_symbol_filename_sysv (bfd *archive_bfd, bfd *abfd)
1462 if (filename_per_symbol)
1465 printf ("%s:", bfd_get_filename (archive_bfd));
1466 printf ("%s:", bfd_get_filename (abfd));
1471 print_symbol_filename_posix (bfd *archive_bfd, bfd *abfd)
1473 if (filename_per_symbol)
1476 printf ("%s[%s]: ", bfd_get_filename (archive_bfd),
1477 bfd_get_filename (abfd));
1479 printf ("%s: ", bfd_get_filename (abfd));
1483 /* Print a symbol value. */
1486 print_value (bfd *abfd ATTRIBUTE_UNUSED, bfd_vma val)
1488 switch (print_width)
1491 printf (value_format_32bit, (unsigned long) val);
1495 #if BFD_HOST_64BIT_LONG || BFD_HOST_64BIT_LONG_LONG
1496 printf (value_format_64bit, val);
1498 /* We have a 64 bit value to print, but the host is only 32 bit. */
1499 if (print_radix == 16)
1500 bfd_fprintf_vma (abfd, stdout, val);
1506 s = buf + sizeof buf;
1510 *--s = (val % print_radix) + '0';
1513 while ((buf + sizeof buf - 1) - s < 16)
1521 fatal (_("Print width has not been initialized (%d)"), print_width);
1526 /* Print a line of information about a symbol. */
1529 print_symbol_info_bsd (struct extended_symbol_info *info, bfd *abfd)
1531 if (bfd_is_undefined_symclass (SYM_TYPE (info)))
1533 if (print_width == 64)
1539 /* Normally we print the value of the symbol. If we are printing the
1540 size or sorting by size then we print its size, except for the
1541 (weird) special case where both flags are defined, in which case we
1542 print both values. This conforms to documented behaviour. */
1543 if (sort_by_size && !print_size)
1544 print_value (abfd, SYM_SIZE (info));
1546 print_value (abfd, SYM_VALUE (info));
1547 if (print_size && SYM_SIZE (info))
1550 print_value (abfd, SYM_SIZE (info));
1554 printf (" %c", SYM_TYPE (info));
1556 if (SYM_TYPE (info) == '-')
1560 printf (other_format, SYM_STAB_OTHER (info));
1562 printf (desc_format, SYM_STAB_DESC (info));
1563 printf (" %5s", SYM_STAB_NAME (info));
1565 print_symname (" %s", SYM_NAME (info), abfd);
1569 print_symbol_info_sysv (struct extended_symbol_info *info, bfd *abfd)
1571 print_symname ("%-20s|", SYM_NAME (info), abfd);
1573 if (bfd_is_undefined_symclass (SYM_TYPE (info)))
1575 if (print_width == 32)
1581 print_value (abfd, SYM_VALUE (info));
1583 printf ("| %c |", SYM_TYPE (info));
1585 if (SYM_TYPE (info) == '-')
1588 printf ("%18s| ", SYM_STAB_NAME (info)); /* (C) Type. */
1589 printf (desc_format, SYM_STAB_DESC (info)); /* Size. */
1590 printf ("| |"); /* Line, Section. */
1594 /* Type, Size, Line, Section */
1597 get_elf_symbol_type (ELF_ST_TYPE (info->elfinfo->internal_elf_sym.st_info)));
1598 else if (info->coffinfo)
1600 get_coff_symbol_type (&info->coffinfo->native->u.syment));
1604 if (SYM_SIZE (info))
1605 print_value (abfd, SYM_SIZE (info));
1608 if (print_width == 32)
1615 printf("| |%s", info->elfinfo->symbol.section->name);
1616 else if (info->coffinfo)
1617 printf("| |%s", info->coffinfo->symbol.section->name);
1624 print_symbol_info_posix (struct extended_symbol_info *info, bfd *abfd)
1626 print_symname ("%s ", SYM_NAME (info), abfd);
1627 printf ("%c ", SYM_TYPE (info));
1629 if (bfd_is_undefined_symclass (SYM_TYPE (info)))
1633 print_value (abfd, SYM_VALUE (info));
1635 if (SYM_SIZE (info))
1636 print_value (abfd, SYM_SIZE (info));
1641 main (int argc, char **argv)
1646 #if defined (HAVE_SETLOCALE) && defined (HAVE_LC_MESSAGES)
1647 setlocale (LC_MESSAGES, "");
1649 #if defined (HAVE_SETLOCALE)
1650 setlocale (LC_CTYPE, "");
1651 setlocale (LC_COLLATE, "");
1653 bindtextdomain (PACKAGE, LOCALEDIR);
1654 textdomain (PACKAGE);
1656 program_name = *argv;
1657 xmalloc_set_program_name (program_name);
1658 bfd_set_error_program_name (program_name);
1659 #if BFD_SUPPORTS_PLUGINS
1660 bfd_plugin_set_program_name (program_name);
1663 START_PROGRESS (program_name, 0);
1665 expandargv (&argc, &argv);
1667 if (bfd_init () != BFD_INIT_MAGIC)
1668 fatal (_("fatal error: libbfd ABI mismatch"));
1669 set_default_bfd_target ();
1671 while ((c = getopt_long (argc, argv, "aABCDef:gHhlnopPrSst:uvVvX:",
1672 long_options, (int *) 0)) != EOF)
1677 print_debug_syms = 1;
1681 filename_per_symbol = 1;
1683 case 'B': /* For MIPS compatibility. */
1684 set_output_format ("bsd");
1690 enum demangling_styles style;
1692 style = cplus_demangle_name_to_style (optarg);
1693 if (style == unknown_demangling)
1694 fatal (_("unknown demangling style `%s'"),
1697 cplus_demangle_set_style (style);
1700 case OPTION_RECURSE_LIMIT:
1701 demangle_flags &= ~ DMGL_NO_RECURSE_LIMIT;
1703 case OPTION_NO_RECURSE_LIMIT:
1704 demangle_flags |= DMGL_NO_RECURSE_LIMIT;
1710 /* Ignored for HP/UX compatibility. */
1713 set_output_format (optarg);
1727 sort_numerically = 1;
1732 sort_numerically = 0;
1735 case OPTION_SIZE_SORT:
1737 sort_numerically = 0;
1741 set_output_format ("posix");
1753 set_print_radix (optarg);
1762 /* Ignored for (partial) AIX compatibility. On AIX, the
1763 argument has values 32, 64, or 32_64, and specifies that
1764 only 32-bit, only 64-bit, or both kinds of objects should
1765 be examined. The default is 32. So plain AIX nm on a
1766 library archive with both kinds of objects will ignore
1767 the 64-bit ones. For GNU nm, the default is and always
1768 has been -X 32_64, and other options are not supported. */
1769 if (strcmp (optarg, "32_64") != 0)
1770 fatal (_("Only -X 32_64 is supported"));
1773 case OPTION_TARGET: /* --target */
1777 case OPTION_PLUGIN: /* --plugin */
1778 #if BFD_SUPPORTS_PLUGINS
1779 bfd_plugin_set_plugin (optarg);
1781 fatal (_("sorry - this program has been built without plugin support\n"));
1785 case 0: /* A long option that just sets a flag. */
1794 print_version ("nm");
1796 if (sort_by_size && undefined_only)
1798 non_fatal (_("Using the --size-sort and --undefined-only options together"));
1799 non_fatal (_("will produce no output, since undefined symbols have no size."));
1803 /* OK, all options now parsed. If no filename specified, do a.out. */
1805 return !display_file ("a.out");
1809 if (argc - optind > 1)
1810 filename_per_file = 1;
1812 /* We were given several filenames to do. */
1813 while (optind < argc)
1816 if (!display_file (argv[optind++]))
1820 END_PROGRESS (program_name);