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)
1181 new_mini = xmalloc ((symcount + synth_count + 1) * sizeof (*symp));
1182 symp = (asymbol **) new_mini;
1183 memcpy (symp, minisyms, symcount * sizeof (*symp));
1185 for (i = 0; i < synth_count; i++)
1186 *symp++ = synthsyms + i;
1188 minisyms = new_mini;
1189 symcount += synth_count;
1193 /* Discard the symbols we don't want to print.
1194 It's OK to do this in place; we'll free the storage anyway
1195 (after printing). */
1197 symcount = filter_symbols (abfd, dynamic, minisyms, symcount, size);
1203 sort_dynamic = dynamic;
1204 sort_x = bfd_make_empty_symbol (abfd);
1205 sort_y = bfd_make_empty_symbol (abfd);
1206 if (sort_x == NULL || sort_y == NULL)
1207 bfd_fatal (bfd_get_filename (abfd));
1210 qsort (minisyms, symcount, size,
1211 sorters[sort_numerically][reverse_sort]);
1213 symcount = sort_symbols_by_size (abfd, dynamic, minisyms, symcount,
1218 print_symbols (abfd, dynamic, minisyms, symcount, size, archive_bfd);
1220 print_size_symbols (abfd, dynamic, symsizes, symcount, archive_bfd);
1229 set_print_width (bfd *file)
1231 print_width = bfd_get_arch_size (file);
1233 if (print_width == -1)
1236 Guess the target's bitsize based on its name.
1237 We assume here than any 64-bit format will include
1238 "64" somewhere in its name. The only known exception
1239 is the MMO object file format. */
1240 if (strstr (bfd_get_target (file), "64") != NULL
1241 || strcmp (bfd_get_target (file), "mmo") == 0)
1249 display_archive (bfd *file)
1252 bfd *last_arfile = NULL;
1255 format->print_archive_filename (bfd_get_filename (file));
1258 print_symdef_entry (file);
1264 arfile = bfd_openr_next_archived_file (file, arfile);
1268 if (bfd_get_error () != bfd_error_no_more_archived_files)
1269 bfd_fatal (bfd_get_filename (file));
1273 if (bfd_check_format_matches (arfile, bfd_object, &matching))
1275 set_print_width (arfile);
1276 format->print_archive_member (bfd_get_filename (file),
1277 bfd_get_filename (arfile));
1278 display_rel_file (arfile, file);
1282 bfd_nonfatal (bfd_get_filename (arfile));
1283 if (bfd_get_error () == bfd_error_file_ambiguously_recognized)
1285 list_matching_formats (matching);
1290 if (last_arfile != NULL)
1292 bfd_close (last_arfile);
1293 lineno_cache_bfd = NULL;
1294 lineno_cache_rel_bfd = NULL;
1295 if (arfile == last_arfile)
1298 last_arfile = arfile;
1301 if (last_arfile != NULL)
1303 bfd_close (last_arfile);
1304 lineno_cache_bfd = NULL;
1305 lineno_cache_rel_bfd = NULL;
1310 display_file (char *filename)
1312 bfd_boolean retval = TRUE;
1316 if (get_file_size (filename) < 1)
1319 file = bfd_openr (filename, target ? target : plugin_target);
1322 bfd_nonfatal (filename);
1326 /* If printing line numbers, decompress the debug sections. */
1328 file->flags |= BFD_DECOMPRESS;
1330 if (bfd_check_format (file, bfd_archive))
1332 display_archive (file);
1334 else if (bfd_check_format_matches (file, bfd_object, &matching))
1336 set_print_width (file);
1337 format->print_object_filename (filename);
1338 display_rel_file (file, NULL);
1342 bfd_nonfatal (filename);
1343 if (bfd_get_error () == bfd_error_file_ambiguously_recognized)
1345 list_matching_formats (matching);
1351 if (!bfd_close (file))
1352 bfd_fatal (filename);
1354 lineno_cache_bfd = NULL;
1355 lineno_cache_rel_bfd = NULL;
1360 /* The following 3 groups of functions are called unconditionally,
1361 once at the start of processing each file of the appropriate type.
1362 They should check `filename_per_file' and `filename_per_symbol',
1363 as appropriate for their output format, to determine whether to
1366 /* Print the name of an object file given on the command line. */
1369 print_object_filename_bsd (char *filename)
1371 if (filename_per_file && !filename_per_symbol)
1372 printf ("\n%s:\n", filename);
1376 print_object_filename_sysv (char *filename)
1379 printf (_("\n\nUndefined symbols from %s:\n\n"), filename);
1381 printf (_("\n\nSymbols from %s:\n\n"), filename);
1382 if (print_width == 32)
1384 Name Value Class Type Size Line Section\n\n"));
1387 Name Value Class Type Size Line Section\n\n"));
1391 print_object_filename_posix (char *filename)
1393 if (filename_per_file && !filename_per_symbol)
1394 printf ("%s:\n", filename);
1397 /* Print the name of an archive file given on the command line. */
1400 print_archive_filename_bsd (char *filename)
1402 if (filename_per_file)
1403 printf ("\n%s:\n", filename);
1407 print_archive_filename_sysv (char *filename ATTRIBUTE_UNUSED)
1412 print_archive_filename_posix (char *filename ATTRIBUTE_UNUSED)
1416 /* Print the name of an archive member file. */
1419 print_archive_member_bsd (char *archive ATTRIBUTE_UNUSED,
1420 const char *filename)
1422 if (!filename_per_symbol)
1423 printf ("\n%s:\n", filename);
1427 print_archive_member_sysv (char *archive, const char *filename)
1430 printf (_("\n\nUndefined symbols from %s[%s]:\n\n"), archive, filename);
1432 printf (_("\n\nSymbols from %s[%s]:\n\n"), archive, filename);
1433 if (print_width == 32)
1435 Name Value Class Type Size Line Section\n\n"));
1438 Name Value Class Type Size Line Section\n\n"));
1442 print_archive_member_posix (char *archive, const char *filename)
1444 if (!filename_per_symbol)
1445 printf ("%s[%s]:\n", archive, filename);
1448 /* Print the name of the file (and archive, if there is one)
1449 containing a symbol. */
1452 print_symbol_filename_bsd (bfd *archive_bfd, bfd *abfd)
1454 if (filename_per_symbol)
1457 printf ("%s:", bfd_get_filename (archive_bfd));
1458 printf ("%s:", bfd_get_filename (abfd));
1463 print_symbol_filename_sysv (bfd *archive_bfd, bfd *abfd)
1465 if (filename_per_symbol)
1468 printf ("%s:", bfd_get_filename (archive_bfd));
1469 printf ("%s:", bfd_get_filename (abfd));
1474 print_symbol_filename_posix (bfd *archive_bfd, bfd *abfd)
1476 if (filename_per_symbol)
1479 printf ("%s[%s]: ", bfd_get_filename (archive_bfd),
1480 bfd_get_filename (abfd));
1482 printf ("%s: ", bfd_get_filename (abfd));
1486 /* Print a symbol value. */
1489 print_value (bfd *abfd ATTRIBUTE_UNUSED, bfd_vma val)
1491 switch (print_width)
1494 printf (value_format_32bit, (unsigned long) val);
1498 #if BFD_HOST_64BIT_LONG || BFD_HOST_64BIT_LONG_LONG
1499 printf (value_format_64bit, val);
1501 /* We have a 64 bit value to print, but the host is only 32 bit. */
1502 if (print_radix == 16)
1503 bfd_fprintf_vma (abfd, stdout, val);
1509 s = buf + sizeof buf;
1513 *--s = (val % print_radix) + '0';
1516 while ((buf + sizeof buf - 1) - s < 16)
1524 fatal (_("Print width has not been initialized (%d)"), print_width);
1529 /* Print a line of information about a symbol. */
1532 print_symbol_info_bsd (struct extended_symbol_info *info, bfd *abfd)
1534 if (bfd_is_undefined_symclass (SYM_TYPE (info)))
1536 if (print_width == 64)
1542 /* Normally we print the value of the symbol. If we are printing the
1543 size or sorting by size then we print its size, except for the
1544 (weird) special case where both flags are defined, in which case we
1545 print both values. This conforms to documented behaviour. */
1546 if (sort_by_size && !print_size)
1547 print_value (abfd, SYM_SIZE (info));
1549 print_value (abfd, SYM_VALUE (info));
1550 if (print_size && SYM_SIZE (info))
1553 print_value (abfd, SYM_SIZE (info));
1557 printf (" %c", SYM_TYPE (info));
1559 if (SYM_TYPE (info) == '-')
1563 printf (other_format, SYM_STAB_OTHER (info));
1565 printf (desc_format, SYM_STAB_DESC (info));
1566 printf (" %5s", SYM_STAB_NAME (info));
1568 print_symname (" %s", SYM_NAME (info), abfd);
1572 print_symbol_info_sysv (struct extended_symbol_info *info, bfd *abfd)
1574 print_symname ("%-20s|", SYM_NAME (info), abfd);
1576 if (bfd_is_undefined_symclass (SYM_TYPE (info)))
1578 if (print_width == 32)
1584 print_value (abfd, SYM_VALUE (info));
1586 printf ("| %c |", SYM_TYPE (info));
1588 if (SYM_TYPE (info) == '-')
1591 printf ("%18s| ", SYM_STAB_NAME (info)); /* (C) Type. */
1592 printf (desc_format, SYM_STAB_DESC (info)); /* Size. */
1593 printf ("| |"); /* Line, Section. */
1597 /* Type, Size, Line, Section */
1600 get_elf_symbol_type (ELF_ST_TYPE (info->elfinfo->internal_elf_sym.st_info)));
1601 else if (info->coffinfo)
1603 get_coff_symbol_type (&info->coffinfo->native->u.syment));
1607 if (SYM_SIZE (info))
1608 print_value (abfd, SYM_SIZE (info));
1611 if (print_width == 32)
1618 printf("| |%s", info->elfinfo->symbol.section->name);
1619 else if (info->coffinfo)
1620 printf("| |%s", info->coffinfo->symbol.section->name);
1627 print_symbol_info_posix (struct extended_symbol_info *info, bfd *abfd)
1629 print_symname ("%s ", SYM_NAME (info), abfd);
1630 printf ("%c ", SYM_TYPE (info));
1632 if (bfd_is_undefined_symclass (SYM_TYPE (info)))
1636 print_value (abfd, SYM_VALUE (info));
1638 if (SYM_SIZE (info))
1639 print_value (abfd, SYM_SIZE (info));
1644 main (int argc, char **argv)
1649 #if defined (HAVE_SETLOCALE) && defined (HAVE_LC_MESSAGES)
1650 setlocale (LC_MESSAGES, "");
1652 #if defined (HAVE_SETLOCALE)
1653 setlocale (LC_CTYPE, "");
1654 setlocale (LC_COLLATE, "");
1656 bindtextdomain (PACKAGE, LOCALEDIR);
1657 textdomain (PACKAGE);
1659 program_name = *argv;
1660 xmalloc_set_program_name (program_name);
1661 bfd_set_error_program_name (program_name);
1662 #if BFD_SUPPORTS_PLUGINS
1663 bfd_plugin_set_program_name (program_name);
1666 START_PROGRESS (program_name, 0);
1668 expandargv (&argc, &argv);
1670 if (bfd_init () != BFD_INIT_MAGIC)
1671 fatal (_("fatal error: libbfd ABI mismatch"));
1672 set_default_bfd_target ();
1674 while ((c = getopt_long (argc, argv, "aABCDef:gHhlnopPrSst:uvVvX:",
1675 long_options, (int *) 0)) != EOF)
1680 print_debug_syms = 1;
1684 filename_per_symbol = 1;
1686 case 'B': /* For MIPS compatibility. */
1687 set_output_format ("bsd");
1693 enum demangling_styles style;
1695 style = cplus_demangle_name_to_style (optarg);
1696 if (style == unknown_demangling)
1697 fatal (_("unknown demangling style `%s'"),
1700 cplus_demangle_set_style (style);
1703 case OPTION_RECURSE_LIMIT:
1704 demangle_flags &= ~ DMGL_NO_RECURSE_LIMIT;
1706 case OPTION_NO_RECURSE_LIMIT:
1707 demangle_flags |= DMGL_NO_RECURSE_LIMIT;
1713 /* Ignored for HP/UX compatibility. */
1716 set_output_format (optarg);
1730 sort_numerically = 1;
1735 sort_numerically = 0;
1738 case OPTION_SIZE_SORT:
1740 sort_numerically = 0;
1744 set_output_format ("posix");
1756 set_print_radix (optarg);
1765 /* Ignored for (partial) AIX compatibility. On AIX, the
1766 argument has values 32, 64, or 32_64, and specifies that
1767 only 32-bit, only 64-bit, or both kinds of objects should
1768 be examined. The default is 32. So plain AIX nm on a
1769 library archive with both kinds of objects will ignore
1770 the 64-bit ones. For GNU nm, the default is and always
1771 has been -X 32_64, and other options are not supported. */
1772 if (strcmp (optarg, "32_64") != 0)
1773 fatal (_("Only -X 32_64 is supported"));
1776 case OPTION_TARGET: /* --target */
1780 case OPTION_PLUGIN: /* --plugin */
1781 #if BFD_SUPPORTS_PLUGINS
1782 bfd_plugin_set_plugin (optarg);
1784 fatal (_("sorry - this program has been built without plugin support\n"));
1788 case 0: /* A long option that just sets a flag. */
1797 print_version ("nm");
1799 if (sort_by_size && undefined_only)
1801 non_fatal (_("Using the --size-sort and --undefined-only options together"));
1802 non_fatal (_("will produce no output, since undefined symbols have no size."));
1806 /* OK, all options now parsed. If no filename specified, do a.out. */
1808 return !display_file ("a.out");
1812 if (argc - optind > 1)
1813 filename_per_file = 1;
1815 /* We were given several filenames to do. */
1816 while (optind < argc)
1819 if (!display_file (argv[optind++]))
1823 END_PROGRESS (program_name);