1 /* nm.c -- Describe symbol table of a rel file.
2 Copyright (C) 1991-2014 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"
34 /* When sorting by size, we use this structure to hold the size and a
35 pointer to the minisymbol. */
43 /* When fetching relocs, we use this structure to pass information to
46 struct get_relocs_info
54 struct extended_symbol_info
58 elf_symbol_type
*elfinfo
;
59 /* FIXME: We should add more fields for Type, Line, Section. */
61 #define SYM_NAME(sym) (sym->sinfo->name)
62 #define SYM_VALUE(sym) (sym->sinfo->value)
63 #define SYM_TYPE(sym) (sym->sinfo->type)
64 #define SYM_STAB_NAME(sym) (sym->sinfo->stab_name)
65 #define SYM_STAB_DESC(sym) (sym->sinfo->stab_desc)
66 #define SYM_STAB_OTHER(sym) (sym->sinfo->stab_other)
67 #define SYM_SIZE(sym) \
68 (sym->elfinfo ? sym->elfinfo->internal_elf_sym.st_size: sym->ssize)
70 /* The output formatting functions. */
71 static void print_object_filename_bsd (char *);
72 static void print_object_filename_sysv (char *);
73 static void print_object_filename_posix (char *);
74 static void print_archive_filename_bsd (char *);
75 static void print_archive_filename_sysv (char *);
76 static void print_archive_filename_posix (char *);
77 static void print_archive_member_bsd (char *, const char *);
78 static void print_archive_member_sysv (char *, const char *);
79 static void print_archive_member_posix (char *, const char *);
80 static void print_symbol_filename_bsd (bfd
*, bfd
*);
81 static void print_symbol_filename_sysv (bfd
*, bfd
*);
82 static void print_symbol_filename_posix (bfd
*, bfd
*);
83 static void print_value (bfd
*, bfd_vma
);
84 static void print_symbol_info_bsd (struct extended_symbol_info
*, bfd
*);
85 static void print_symbol_info_sysv (struct extended_symbol_info
*, bfd
*);
86 static void print_symbol_info_posix (struct extended_symbol_info
*, bfd
*);
88 /* Support for different output formats. */
91 /* Print the name of an object file given on the command line. */
92 void (*print_object_filename
) (char *);
94 /* Print the name of an archive file given on the command line. */
95 void (*print_archive_filename
) (char *);
97 /* Print the name of an archive member file. */
98 void (*print_archive_member
) (char *, const char *);
100 /* Print the name of the file (and archive, if there is one)
101 containing a symbol. */
102 void (*print_symbol_filename
) (bfd
*, bfd
*);
104 /* Print a line of information about a symbol. */
105 void (*print_symbol_info
) (struct extended_symbol_info
*, bfd
*);
108 static struct output_fns formats
[] =
110 {print_object_filename_bsd
,
111 print_archive_filename_bsd
,
112 print_archive_member_bsd
,
113 print_symbol_filename_bsd
,
114 print_symbol_info_bsd
},
115 {print_object_filename_sysv
,
116 print_archive_filename_sysv
,
117 print_archive_member_sysv
,
118 print_symbol_filename_sysv
,
119 print_symbol_info_sysv
},
120 {print_object_filename_posix
,
121 print_archive_filename_posix
,
122 print_archive_member_posix
,
123 print_symbol_filename_posix
,
124 print_symbol_info_posix
}
127 /* Indices in `formats'. */
129 #define FORMAT_SYSV 1
130 #define FORMAT_POSIX 2
131 #define FORMAT_DEFAULT FORMAT_BSD
133 /* The output format to use. */
134 static struct output_fns
*format
= &formats
[FORMAT_DEFAULT
];
136 /* Command options. */
138 static int do_demangle
= 0; /* Pretty print C++ symbol names. */
139 static int external_only
= 0; /* Print external symbols only. */
140 static int defined_only
= 0; /* Print defined symbols only. */
141 static int no_sort
= 0; /* Don't sort; print syms in order found. */
142 static int print_debug_syms
= 0;/* Print debugger-only symbols too. */
143 static int print_armap
= 0; /* Describe __.SYMDEF data in archive files. */
144 static int print_size
= 0; /* Print size of defined symbols. */
145 static int reverse_sort
= 0; /* Sort in downward(alpha or numeric) order. */
146 static int sort_numerically
= 0;/* Sort in numeric rather than alpha order. */
147 static int sort_by_size
= 0; /* Sort by size of symbol. */
148 static int undefined_only
= 0; /* Print undefined symbols only. */
149 static int dynamic
= 0; /* Print dynamic symbols. */
150 static int show_version
= 0; /* Show the version number. */
151 static int show_stats
= 0; /* Show statistics. */
152 static int show_synthetic
= 0; /* Display synthesized symbols too. */
153 static int line_numbers
= 0; /* Print line numbers for symbols. */
154 static int allow_special_symbols
= 0; /* Allow special symbols. */
156 /* When to print the names of files. Not mutually exclusive in SYSV format. */
157 static int filename_per_file
= 0; /* Once per file, on its own line. */
158 static int filename_per_symbol
= 0; /* Once per symbol, at start of line. */
160 /* Print formats for printing a symbol value. */
161 static char value_format_32bit
[] = "%08lx";
162 #if BFD_HOST_64BIT_LONG
163 static char value_format_64bit
[] = "%016lx";
164 #elif BFD_HOST_64BIT_LONG_LONG
166 static char value_format_64bit
[] = "%016llx";
168 static char value_format_64bit
[] = "%016I64x";
171 static int print_width
= 0;
172 static int print_radix
= 16;
173 /* Print formats for printing stab info. */
174 static char other_format
[] = "%02x";
175 static char desc_format
[] = "%04x";
177 static char *target
= NULL
;
178 #if BFD_SUPPORTS_PLUGINS
179 static const char *plugin_target
= "plugin";
181 static const char *plugin_target
= NULL
;
184 /* Used to cache the line numbers for a BFD. */
185 static bfd
*lineno_cache_bfd
;
186 static bfd
*lineno_cache_rel_bfd
;
188 #define OPTION_TARGET 200
189 #define OPTION_PLUGIN (OPTION_TARGET + 1)
190 #define OPTION_SIZE_SORT (OPTION_PLUGIN + 1)
192 static struct option long_options
[] =
194 {"debug-syms", no_argument
, &print_debug_syms
, 1},
195 {"demangle", optional_argument
, 0, 'C'},
196 {"dynamic", no_argument
, &dynamic
, 1},
197 {"extern-only", no_argument
, &external_only
, 1},
198 {"format", required_argument
, 0, 'f'},
199 {"help", no_argument
, 0, 'h'},
200 {"line-numbers", no_argument
, 0, 'l'},
201 {"no-cplus", no_argument
, &do_demangle
, 0}, /* Linux compatibility. */
202 {"no-demangle", no_argument
, &do_demangle
, 0},
203 {"no-sort", no_argument
, 0, 'p'},
204 {"numeric-sort", no_argument
, 0, 'n'},
205 {"plugin", required_argument
, 0, OPTION_PLUGIN
},
206 {"portability", no_argument
, 0, 'P'},
207 {"print-armap", no_argument
, &print_armap
, 1},
208 {"print-file-name", no_argument
, 0, 'o'},
209 {"print-size", no_argument
, 0, 'S'},
210 {"radix", required_argument
, 0, 't'},
211 {"reverse-sort", no_argument
, &reverse_sort
, 1},
212 {"size-sort", no_argument
, 0, OPTION_SIZE_SORT
},
213 {"special-syms", no_argument
, &allow_special_symbols
, 1},
214 {"stats", no_argument
, &show_stats
, 1},
215 {"synthetic", no_argument
, &show_synthetic
, 1},
216 {"target", required_argument
, 0, OPTION_TARGET
},
217 {"defined-only", no_argument
, &defined_only
, 1},
218 {"undefined-only", no_argument
, &undefined_only
, 1},
219 {"version", no_argument
, &show_version
, 1},
220 {0, no_argument
, 0, 0}
223 /* Some error-reporting functions. */
226 usage (FILE *stream
, int status
)
228 fprintf (stream
, _("Usage: %s [option(s)] [file(s)]\n"), program_name
);
229 fprintf (stream
, _(" List symbols in [file(s)] (a.out by default).\n"));
230 fprintf (stream
, _(" The options are:\n\
231 -a, --debug-syms Display debugger-only symbols\n\
232 -A, --print-file-name Print name of the input file before every symbol\n\
233 -B Same as --format=bsd\n\
234 -C, --demangle[=STYLE] Decode low-level symbol names into user-level names\n\
235 The STYLE, if specified, can be `auto' (the default),\n\
236 `gnu', `lucid', `arm', `hp', `edg', `gnu-v3', `java'\n\
238 --no-demangle Do not demangle low-level symbol names\n\
239 -D, --dynamic Display dynamic symbols instead of normal symbols\n\
240 --defined-only Display only defined symbols\n\
242 -f, --format=FORMAT Use the output format FORMAT. FORMAT can be `bsd',\n\
243 `sysv' or `posix'. The default is `bsd'\n\
244 -g, --extern-only Display only external symbols\n\
245 -l, --line-numbers Use debugging information to find a filename and\n\
246 line number for each symbol\n\
247 -n, --numeric-sort Sort symbols numerically by address\n\
249 -p, --no-sort Do not sort the symbols\n\
250 -P, --portability Same as --format=posix\n\
251 -r, --reverse-sort Reverse the sense of the sort\n"));
252 #if BFD_SUPPORTS_PLUGINS
253 fprintf (stream
, _("\
254 --plugin NAME Load the specified plugin\n"));
256 fprintf (stream
, _("\
257 -S, --print-size Print size of defined symbols\n\
258 -s, --print-armap Include index for symbols from archive members\n\
259 --size-sort Sort symbols by size\n\
260 --special-syms Include special symbols in the output\n\
261 --synthetic Display synthetic symbols as well\n\
262 -t, --radix=RADIX Use RADIX for printing symbol values\n\
263 --target=BFDNAME Specify the target object format as BFDNAME\n\
264 -u, --undefined-only Display only undefined symbols\n\
265 -X 32_64 (ignored)\n\
266 @FILE Read options from FILE\n\
267 -h, --help Display this information\n\
268 -V, --version Display this program's version number\n\
270 list_supported_targets (program_name
, stream
);
271 if (REPORT_BUGS_TO
[0] && status
== 0)
272 fprintf (stream
, _("Report bugs to %s.\n"), REPORT_BUGS_TO
);
276 /* Set the radix for the symbol value and size according to RADIX. */
279 set_print_radix (char *radix
)
291 value_format_32bit
[4] = *radix
;
292 #if BFD_HOST_64BIT_LONG
293 value_format_64bit
[5] = *radix
;
294 #elif BFD_HOST_64BIT_LONG_LONG
296 value_format_64bit
[6] = *radix
;
298 value_format_64bit
[7] = *radix
;
301 other_format
[3] = desc_format
[3] = *radix
;
304 fatal (_("%s: invalid radix"), radix
);
309 set_output_format (char *f
)
328 fatal (_("%s: invalid output format"), f
);
330 format
= &formats
[i
];
334 get_symbol_type (unsigned int type
)
336 static char buff
[32];
340 case STT_NOTYPE
: return "NOTYPE";
341 case STT_OBJECT
: return "OBJECT";
342 case STT_FUNC
: return "FUNC";
343 case STT_SECTION
: return "SECTION";
344 case STT_FILE
: return "FILE";
345 case STT_COMMON
: return "COMMON";
346 case STT_TLS
: return "TLS";
348 if (type
>= STT_LOPROC
&& type
<= STT_HIPROC
)
349 sprintf (buff
, _("<processor specific>: %d"), type
);
350 else if (type
>= STT_LOOS
&& type
<= STT_HIOS
)
351 sprintf (buff
, _("<OS specific>: %d"), type
);
353 sprintf (buff
, _("<unknown>: %d"), type
);
358 /* Print symbol name NAME, read from ABFD, with printf format FORM,
359 demangling it if requested. */
362 print_symname (const char *form
, const char *name
, bfd
*abfd
)
364 if (do_demangle
&& *name
)
366 char *res
= bfd_demangle (abfd
, name
, DMGL_ANSI
| DMGL_PARAMS
);
380 print_symdef_entry (bfd
*abfd
)
382 symindex idx
= BFD_NO_MORE_SYMBOLS
;
384 bfd_boolean everprinted
= FALSE
;
386 for (idx
= bfd_get_next_mapent (abfd
, idx
, &thesym
);
387 idx
!= BFD_NO_MORE_SYMBOLS
;
388 idx
= bfd_get_next_mapent (abfd
, idx
, &thesym
))
393 printf (_("\nArchive index:\n"));
396 elt
= bfd_get_elt_at_index (abfd
, idx
);
398 bfd_fatal ("bfd_get_elt_at_index");
399 if (thesym
->name
!= (char *) NULL
)
401 print_symname ("%s", thesym
->name
, abfd
);
402 printf (" in %s\n", bfd_get_filename (elt
));
407 /* Choose which symbol entries to print;
408 compact them downward to get rid of the rest.
409 Return the number of symbols to be printed. */
412 filter_symbols (bfd
*abfd
, bfd_boolean is_dynamic
, void *minisyms
,
413 long symcount
, unsigned int size
)
415 bfd_byte
*from
, *fromend
, *to
;
418 store
= bfd_make_empty_symbol (abfd
);
420 bfd_fatal (bfd_get_filename (abfd
));
422 from
= (bfd_byte
*) minisyms
;
423 fromend
= from
+ symcount
* size
;
424 to
= (bfd_byte
*) minisyms
;
426 for (; from
< fromend
; from
+= size
)
433 sym
= bfd_minisymbol_to_symbol (abfd
, is_dynamic
, (const void *) from
, store
);
435 bfd_fatal (bfd_get_filename (abfd
));
437 if (strcmp (sym
->name
, "__gnu_lto_slim") == 0)
438 non_fatal (_("%s: plugin needed to handle lto object"),
439 bfd_get_filename (abfd
));
442 keep
= bfd_is_und_section (sym
->section
);
443 else if (external_only
)
444 /* PR binutls/12753: Unique symbols are global too. */
445 keep
= ((sym
->flags
& (BSF_GLOBAL
447 | BSF_GNU_UNIQUE
)) != 0
448 || bfd_is_und_section (sym
->section
)
449 || bfd_is_com_section (sym
->section
));
454 && ! print_debug_syms
455 && (sym
->flags
& BSF_DEBUGGING
) != 0)
460 && (bfd_is_abs_section (sym
->section
)
461 || bfd_is_und_section (sym
->section
)))
467 if (bfd_is_und_section (sym
->section
))
472 && bfd_is_target_special_symbol (abfd
, sym
)
473 && ! allow_special_symbols
)
479 memcpy (to
, from
, size
);
484 return (to
- (bfd_byte
*) minisyms
) / size
;
487 /* These globals are used to pass information into the sorting
489 static bfd
*sort_bfd
;
490 static bfd_boolean sort_dynamic
;
491 static asymbol
*sort_x
;
492 static asymbol
*sort_y
;
494 /* Symbol-sorting predicates */
495 #define valueof(x) ((x)->section->vma + (x)->value)
497 /* Numeric sorts. Undefined symbols are always considered "less than"
498 defined symbols with zero values. Common symbols are not treated
499 specially -- i.e., their sizes are used as their "values". */
502 non_numeric_forward (const void *P_x
, const void *P_y
)
507 x
= bfd_minisymbol_to_symbol (sort_bfd
, sort_dynamic
, P_x
, sort_x
);
508 y
= bfd_minisymbol_to_symbol (sort_bfd
, sort_dynamic
, P_y
, sort_y
);
509 if (x
== NULL
|| y
== NULL
)
510 bfd_fatal (bfd_get_filename (sort_bfd
));
512 xn
= bfd_asymbol_name (x
);
513 yn
= bfd_asymbol_name (y
);
521 /* Solaris 2.5 has a bug in strcoll.
522 strcoll returns invalid values when confronted with empty strings. */
528 return strcoll (xn
, yn
);
530 return strcmp (xn
, yn
);
535 non_numeric_reverse (const void *x
, const void *y
)
537 return - non_numeric_forward (x
, y
);
541 numeric_forward (const void *P_x
, const void *P_y
)
546 x
= bfd_minisymbol_to_symbol (sort_bfd
, sort_dynamic
, P_x
, sort_x
);
547 y
= bfd_minisymbol_to_symbol (sort_bfd
, sort_dynamic
, P_y
, sort_y
);
548 if (x
== NULL
|| y
== NULL
)
549 bfd_fatal (bfd_get_filename (sort_bfd
));
551 xs
= bfd_get_section (x
);
552 ys
= bfd_get_section (y
);
554 if (bfd_is_und_section (xs
))
556 if (! bfd_is_und_section (ys
))
559 else if (bfd_is_und_section (ys
))
561 else if (valueof (x
) != valueof (y
))
562 return valueof (x
) < valueof (y
) ? -1 : 1;
564 return non_numeric_forward (P_x
, P_y
);
568 numeric_reverse (const void *x
, const void *y
)
570 return - numeric_forward (x
, y
);
573 static int (*(sorters
[2][2])) (const void *, const void *) =
575 { non_numeric_forward
, non_numeric_reverse
},
576 { numeric_forward
, numeric_reverse
}
579 /* This sort routine is used by sort_symbols_by_size. It is similar
580 to numeric_forward, but when symbols have the same value it sorts
581 by section VMA. This simplifies the sort_symbols_by_size code
582 which handles symbols at the end of sections. Also, this routine
583 tries to sort file names before other symbols with the same value.
584 That will make the file name have a zero size, which will make
585 sort_symbols_by_size choose the non file name symbol, leading to
586 more meaningful output. For similar reasons, this code sorts
587 gnu_compiled_* and gcc2_compiled before other symbols with the same
591 size_forward1 (const void *P_x
, const void *P_y
)
599 x
= bfd_minisymbol_to_symbol (sort_bfd
, sort_dynamic
, P_x
, sort_x
);
600 y
= bfd_minisymbol_to_symbol (sort_bfd
, sort_dynamic
, P_y
, sort_y
);
601 if (x
== NULL
|| y
== NULL
)
602 bfd_fatal (bfd_get_filename (sort_bfd
));
604 xs
= bfd_get_section (x
);
605 ys
= bfd_get_section (y
);
607 if (bfd_is_und_section (xs
))
609 if (bfd_is_und_section (ys
))
612 if (valueof (x
) != valueof (y
))
613 return valueof (x
) < valueof (y
) ? -1 : 1;
615 if (xs
->vma
!= ys
->vma
)
616 return xs
->vma
< ys
->vma
? -1 : 1;
618 xn
= bfd_asymbol_name (x
);
619 yn
= bfd_asymbol_name (y
);
623 /* The symbols gnu_compiled and gcc2_compiled convey even less
624 information than the file name, so sort them out first. */
626 xf
= (strstr (xn
, "gnu_compiled") != NULL
627 || strstr (xn
, "gcc2_compiled") != NULL
);
628 yf
= (strstr (yn
, "gnu_compiled") != NULL
629 || strstr (yn
, "gcc2_compiled") != NULL
);
636 /* We use a heuristic for the file name. It may not work on non
637 Unix systems, but it doesn't really matter; the only difference
638 is precisely which symbol names get printed. */
640 #define file_symbol(s, sn, snl) \
641 (((s)->flags & BSF_FILE) != 0 \
642 || ((sn)[(snl) - 2] == '.' \
643 && ((sn)[(snl) - 1] == 'o' \
644 || (sn)[(snl) - 1] == 'a')))
646 xf
= file_symbol (x
, xn
, xnl
);
647 yf
= file_symbol (y
, yn
, ynl
);
654 return non_numeric_forward (P_x
, P_y
);
657 /* This sort routine is used by sort_symbols_by_size. It is sorting
658 an array of size_sym structures into size order. */
661 size_forward2 (const void *P_x
, const void *P_y
)
663 const struct size_sym
*x
= (const struct size_sym
*) P_x
;
664 const struct size_sym
*y
= (const struct size_sym
*) P_y
;
666 if (x
->size
< y
->size
)
667 return reverse_sort
? 1 : -1;
668 else if (x
->size
> y
->size
)
669 return reverse_sort
? -1 : 1;
671 return sorters
[0][reverse_sort
] (x
->minisym
, y
->minisym
);
674 /* Sort the symbols by size. ELF provides a size but for other formats
675 we have to make a guess by assuming that the difference between the
676 address of a symbol and the address of the next higher symbol is the
680 sort_symbols_by_size (bfd
*abfd
, bfd_boolean is_dynamic
, void *minisyms
,
681 long symcount
, unsigned int size
,
682 struct size_sym
**symsizesp
)
684 struct size_sym
*symsizes
;
685 bfd_byte
*from
, *fromend
;
687 asymbol
*store_sym
, *store_next
;
689 qsort (minisyms
, symcount
, size
, size_forward1
);
691 /* We are going to return a special set of symbols and sizes to
693 symsizes
= (struct size_sym
*) xmalloc (symcount
* sizeof (struct size_sym
));
694 *symsizesp
= symsizes
;
696 /* Note that filter_symbols has already removed all absolute and
697 undefined symbols. Here we remove all symbols whose size winds
699 from
= (bfd_byte
*) minisyms
;
700 fromend
= from
+ symcount
* size
;
707 sym
= bfd_minisymbol_to_symbol (abfd
, is_dynamic
, (const void *) from
,
710 bfd_fatal (bfd_get_filename (abfd
));
713 for (; from
< fromend
; from
+= size
)
720 if (from
+ size
< fromend
)
722 next
= bfd_minisymbol_to_symbol (abfd
,
724 (const void *) (from
+ size
),
727 bfd_fatal (bfd_get_filename (abfd
));
732 sec
= bfd_get_section (sym
);
734 if (bfd_get_flavour (abfd
) == bfd_target_elf_flavour
)
735 sz
= ((elf_symbol_type
*) sym
)->internal_elf_sym
.st_size
;
736 else if (bfd_is_com_section (sec
))
740 if (from
+ size
< fromend
741 && sec
== bfd_get_section (next
))
742 sz
= valueof (next
) - valueof (sym
);
744 sz
= (bfd_get_section_vma (abfd
, sec
)
745 + bfd_section_size (abfd
, sec
)
751 symsizes
->minisym
= (const void *) from
;
759 store_sym
= store_next
;
763 symcount
= symsizes
- *symsizesp
;
765 /* We must now sort again by size. */
766 qsort ((void *) *symsizesp
, symcount
, sizeof (struct size_sym
), size_forward2
);
771 /* This function is used to get the relocs for a particular section.
772 It is called via bfd_map_over_sections. */
775 get_relocs (bfd
*abfd
, asection
*sec
, void *dataarg
)
777 struct get_relocs_info
*data
= (struct get_relocs_info
*) dataarg
;
781 if ((sec
->flags
& SEC_RELOC
) == 0)
783 *data
->relocs
= NULL
;
790 relsize
= bfd_get_reloc_upper_bound (abfd
, sec
);
792 bfd_fatal (bfd_get_filename (abfd
));
794 *data
->relocs
= (arelent
**) xmalloc (relsize
);
795 *data
->relcount
= bfd_canonicalize_reloc (abfd
, sec
, *data
->relocs
,
797 if (*data
->relcount
< 0)
798 bfd_fatal (bfd_get_filename (abfd
));
806 /* Print a single symbol. */
809 print_symbol (bfd
* abfd
,
813 bfd_boolean is_synthetic
)
816 struct extended_symbol_info info
;
820 format
->print_symbol_filename (archive_bfd
, abfd
);
822 bfd_get_symbol_info (abfd
, sym
, &syminfo
);
824 info
.sinfo
= &syminfo
;
826 /* Synthetic symbols do not have a full elf_symbol_type set of data available. */
827 info
.elfinfo
= is_synthetic
? NULL
: elf_symbol_from (abfd
, sym
);
829 format
->print_symbol_info (&info
, abfd
);
833 static asymbol
**syms
;
834 static long symcount
;
835 const char *filename
, *functionname
;
838 /* We need to get the canonical symbols in order to call
839 bfd_find_nearest_line. This is inefficient, but, then, you
840 don't have to use --line-numbers. */
841 if (abfd
!= lineno_cache_bfd
&& syms
!= NULL
)
850 symsize
= bfd_get_symtab_upper_bound (abfd
);
852 bfd_fatal (bfd_get_filename (abfd
));
853 syms
= (asymbol
**) xmalloc (symsize
);
854 symcount
= bfd_canonicalize_symtab (abfd
, syms
);
856 bfd_fatal (bfd_get_filename (abfd
));
857 lineno_cache_bfd
= abfd
;
860 if (bfd_is_und_section (bfd_get_section (sym
)))
862 static asection
**secs
;
863 static arelent
***relocs
;
864 static long *relcount
;
865 static unsigned int seccount
;
869 /* For an undefined symbol, we try to find a reloc for the
870 symbol, and print the line number of the reloc. */
871 if (abfd
!= lineno_cache_rel_bfd
&& relocs
!= NULL
)
873 for (i
= 0; i
< seccount
; i
++)
874 if (relocs
[i
] != NULL
)
886 struct get_relocs_info rinfo
;
888 seccount
= bfd_count_sections (abfd
);
890 secs
= (asection
**) xmalloc (seccount
* sizeof *secs
);
891 relocs
= (arelent
***) xmalloc (seccount
* sizeof *relocs
);
892 relcount
= (long *) xmalloc (seccount
* sizeof *relcount
);
895 rinfo
.relocs
= relocs
;
896 rinfo
.relcount
= relcount
;
898 bfd_map_over_sections (abfd
, get_relocs
, (void *) &rinfo
);
899 lineno_cache_rel_bfd
= abfd
;
902 symname
= bfd_asymbol_name (sym
);
903 for (i
= 0; i
< seccount
; i
++)
907 for (j
= 0; j
< relcount
[i
]; j
++)
912 if (r
->sym_ptr_ptr
!= NULL
913 && (*r
->sym_ptr_ptr
)->section
== sym
->section
914 && (*r
->sym_ptr_ptr
)->value
== sym
->value
916 bfd_asymbol_name (*r
->sym_ptr_ptr
)) == 0
917 && bfd_find_nearest_line (abfd
, secs
[i
], syms
,
918 r
->address
, &filename
,
919 &functionname
, &lineno
)
922 /* We only print the first one we find. */
923 printf ("\t%s:%u", filename
, lineno
);
930 else if (bfd_get_section (sym
)->owner
== abfd
)
932 if ((bfd_find_line (abfd
, syms
, sym
, &filename
, &lineno
)
933 || bfd_find_nearest_line (abfd
, bfd_get_section (sym
),
934 syms
, sym
->value
, &filename
,
935 &functionname
, &lineno
))
938 printf ("\t%s:%u", filename
, lineno
);
945 /* Print the symbols when sorting by size. */
948 print_size_symbols (bfd
* abfd
,
949 bfd_boolean is_dynamic
,
950 struct size_sym
* symsizes
,
956 struct size_sym
*from
;
957 struct size_sym
*fromend
;
958 struct size_sym
*fromsynth
;
960 store
= bfd_make_empty_symbol (abfd
);
962 bfd_fatal (bfd_get_filename (abfd
));
965 fromend
= from
+ symcount
;
966 fromsynth
= symsizes
+ (symcount
- synth_count
);
968 for (; from
< fromend
; from
++)
972 sym
= bfd_minisymbol_to_symbol (abfd
, is_dynamic
, from
->minisym
, store
);
974 bfd_fatal (bfd_get_filename (abfd
));
976 print_symbol (abfd
, sym
, from
->size
, archive_bfd
, from
>= fromsynth
);
981 /* Print the symbols of ABFD that are held in MINISYMS.
983 If ARCHIVE_BFD is non-NULL, it is the archive containing ABFD.
985 SYMCOUNT is the number of symbols in MINISYMS and SYNTH_COUNT
986 is the number of these that are synthetic. Synthetic symbols,
987 if any are present, always come at the end of the MINISYMS.
989 SIZE is the size of a symbol in MINISYMS. */
992 print_symbols (bfd
* abfd
,
993 bfd_boolean is_dynamic
,
1003 bfd_byte
*fromsynth
;
1005 store
= bfd_make_empty_symbol (abfd
);
1007 bfd_fatal (bfd_get_filename (abfd
));
1009 from
= (bfd_byte
*) minisyms
;
1010 fromend
= from
+ symcount
* size
;
1011 fromsynth
= (bfd_byte
*) minisyms
+ ((symcount
- synth_count
) * size
);
1013 for (; from
< fromend
; from
+= size
)
1017 sym
= bfd_minisymbol_to_symbol (abfd
, is_dynamic
, from
, store
);
1019 bfd_fatal (bfd_get_filename (abfd
));
1021 print_symbol (abfd
, sym
, (bfd_vma
) 0, archive_bfd
, from
>= fromsynth
);
1025 /* If ARCHIVE_BFD is non-NULL, it is the archive containing ABFD. */
1028 display_rel_file (bfd
*abfd
, bfd
*archive_bfd
)
1031 long synth_count
= 0;
1034 struct size_sym
*symsizes
;
1038 if (!(bfd_get_file_flags (abfd
) & HAS_SYMS
))
1040 non_fatal (_("%s: no symbols"), bfd_get_filename (abfd
));
1045 symcount
= bfd_read_minisymbols (abfd
, dynamic
, &minisyms
, &size
);
1048 if (dynamic
&& bfd_get_error () == bfd_error_no_symbols
)
1050 non_fatal (_("%s: no symbols"), bfd_get_filename (abfd
));
1054 bfd_fatal (bfd_get_filename (abfd
));
1059 non_fatal (_("%s: no symbols"), bfd_get_filename (abfd
));
1063 if (show_synthetic
&& size
== sizeof (asymbol
*))
1066 asymbol
**static_syms
= NULL
;
1067 asymbol
**dyn_syms
= NULL
;
1068 long static_count
= 0;
1073 dyn_count
= symcount
;
1074 dyn_syms
= (asymbol
**) minisyms
;
1078 long storage
= bfd_get_dynamic_symtab_upper_bound (abfd
);
1080 static_count
= symcount
;
1081 static_syms
= (asymbol
**) minisyms
;
1085 dyn_syms
= (asymbol
**) xmalloc (storage
);
1086 dyn_count
= bfd_canonicalize_dynamic_symtab (abfd
, dyn_syms
);
1088 bfd_fatal (bfd_get_filename (abfd
));
1092 synth_count
= bfd_get_synthetic_symtab (abfd
, static_count
, static_syms
,
1093 dyn_count
, dyn_syms
, &synthsyms
);
1094 if (synth_count
> 0)
1100 new_mini
= xmalloc ((symcount
+ synth_count
+ 1) * sizeof (*symp
));
1101 symp
= (asymbol
**) new_mini
;
1102 memcpy (symp
, minisyms
, symcount
* sizeof (*symp
));
1104 for (i
= 0; i
< synth_count
; i
++)
1105 *symp
++ = synthsyms
+ i
;
1107 minisyms
= new_mini
;
1108 symcount
+= synth_count
;
1112 /* Discard the symbols we don't want to print.
1113 It's OK to do this in place; we'll free the storage anyway
1114 (after printing). */
1116 symcount
= filter_symbols (abfd
, dynamic
, minisyms
, symcount
, size
);
1122 sort_dynamic
= dynamic
;
1123 sort_x
= bfd_make_empty_symbol (abfd
);
1124 sort_y
= bfd_make_empty_symbol (abfd
);
1125 if (sort_x
== NULL
|| sort_y
== NULL
)
1126 bfd_fatal (bfd_get_filename (abfd
));
1129 qsort (minisyms
, symcount
, size
,
1130 sorters
[sort_numerically
][reverse_sort
]);
1132 symcount
= sort_symbols_by_size (abfd
, dynamic
, minisyms
, symcount
,
1137 print_symbols (abfd
, dynamic
, minisyms
, symcount
, synth_count
, size
, archive_bfd
);
1139 print_size_symbols (abfd
, dynamic
, symsizes
, symcount
, synth_count
, archive_bfd
);
1146 set_print_width (bfd
*file
)
1148 print_width
= bfd_get_arch_size (file
);
1150 if (print_width
== -1)
1153 Guess the target's bitsize based on its name.
1154 We assume here than any 64-bit format will include
1155 "64" somewhere in its name. The only known exception
1156 is the MMO object file format. */
1157 if (strstr (bfd_get_target (file
), "64") != NULL
1158 || strcmp (bfd_get_target (file
), "mmo") == 0)
1166 display_archive (bfd
*file
)
1169 bfd
*last_arfile
= NULL
;
1172 format
->print_archive_filename (bfd_get_filename (file
));
1175 print_symdef_entry (file
);
1181 arfile
= bfd_openr_next_archived_file (file
, arfile
);
1185 if (bfd_get_error () != bfd_error_no_more_archived_files
)
1186 bfd_fatal (bfd_get_filename (file
));
1190 if (bfd_check_format_matches (arfile
, bfd_object
, &matching
))
1192 set_print_width (arfile
);
1193 format
->print_archive_member (bfd_get_filename (file
),
1194 bfd_get_filename (arfile
));
1195 display_rel_file (arfile
, file
);
1199 bfd_nonfatal (bfd_get_filename (arfile
));
1200 if (bfd_get_error () == bfd_error_file_ambiguously_recognized
)
1202 list_matching_formats (matching
);
1207 if (last_arfile
!= NULL
)
1209 bfd_close (last_arfile
);
1210 lineno_cache_bfd
= NULL
;
1211 lineno_cache_rel_bfd
= NULL
;
1212 if (arfile
== last_arfile
)
1215 last_arfile
= arfile
;
1218 if (last_arfile
!= NULL
)
1220 bfd_close (last_arfile
);
1221 lineno_cache_bfd
= NULL
;
1222 lineno_cache_rel_bfd
= NULL
;
1227 display_file (char *filename
)
1229 bfd_boolean retval
= TRUE
;
1233 if (get_file_size (filename
) < 1)
1236 file
= bfd_openr (filename
, target
? target
: plugin_target
);
1239 bfd_nonfatal (filename
);
1243 /* If printing line numbers, decompress the debug sections. */
1245 file
->flags
|= BFD_DECOMPRESS
;
1247 if (bfd_check_format (file
, bfd_archive
))
1249 display_archive (file
);
1251 else if (bfd_check_format_matches (file
, bfd_object
, &matching
))
1253 set_print_width (file
);
1254 format
->print_object_filename (filename
);
1255 display_rel_file (file
, NULL
);
1259 bfd_nonfatal (filename
);
1260 if (bfd_get_error () == bfd_error_file_ambiguously_recognized
)
1262 list_matching_formats (matching
);
1268 if (!bfd_close (file
))
1269 bfd_fatal (filename
);
1271 lineno_cache_bfd
= NULL
;
1272 lineno_cache_rel_bfd
= NULL
;
1277 /* The following 3 groups of functions are called unconditionally,
1278 once at the start of processing each file of the appropriate type.
1279 They should check `filename_per_file' and `filename_per_symbol',
1280 as appropriate for their output format, to determine whether to
1283 /* Print the name of an object file given on the command line. */
1286 print_object_filename_bsd (char *filename
)
1288 if (filename_per_file
&& !filename_per_symbol
)
1289 printf ("\n%s:\n", filename
);
1293 print_object_filename_sysv (char *filename
)
1296 printf (_("\n\nUndefined symbols from %s:\n\n"), filename
);
1298 printf (_("\n\nSymbols from %s:\n\n"), filename
);
1299 if (print_width
== 32)
1301 Name Value Class Type Size Line Section\n\n"));
1304 Name Value Class Type Size Line Section\n\n"));
1308 print_object_filename_posix (char *filename
)
1310 if (filename_per_file
&& !filename_per_symbol
)
1311 printf ("%s:\n", filename
);
1314 /* Print the name of an archive file given on the command line. */
1317 print_archive_filename_bsd (char *filename
)
1319 if (filename_per_file
)
1320 printf ("\n%s:\n", filename
);
1324 print_archive_filename_sysv (char *filename ATTRIBUTE_UNUSED
)
1329 print_archive_filename_posix (char *filename ATTRIBUTE_UNUSED
)
1333 /* Print the name of an archive member file. */
1336 print_archive_member_bsd (char *archive ATTRIBUTE_UNUSED
,
1337 const char *filename
)
1339 if (!filename_per_symbol
)
1340 printf ("\n%s:\n", filename
);
1344 print_archive_member_sysv (char *archive
, const char *filename
)
1347 printf (_("\n\nUndefined symbols from %s[%s]:\n\n"), archive
, filename
);
1349 printf (_("\n\nSymbols from %s[%s]:\n\n"), archive
, filename
);
1350 if (print_width
== 32)
1352 Name Value Class Type Size Line Section\n\n"));
1355 Name Value Class Type Size Line Section\n\n"));
1359 print_archive_member_posix (char *archive
, const char *filename
)
1361 if (!filename_per_symbol
)
1362 printf ("%s[%s]:\n", archive
, filename
);
1365 /* Print the name of the file (and archive, if there is one)
1366 containing a symbol. */
1369 print_symbol_filename_bsd (bfd
*archive_bfd
, bfd
*abfd
)
1371 if (filename_per_symbol
)
1374 printf ("%s:", bfd_get_filename (archive_bfd
));
1375 printf ("%s:", bfd_get_filename (abfd
));
1380 print_symbol_filename_sysv (bfd
*archive_bfd
, bfd
*abfd
)
1382 if (filename_per_symbol
)
1385 printf ("%s:", bfd_get_filename (archive_bfd
));
1386 printf ("%s:", bfd_get_filename (abfd
));
1391 print_symbol_filename_posix (bfd
*archive_bfd
, bfd
*abfd
)
1393 if (filename_per_symbol
)
1396 printf ("%s[%s]: ", bfd_get_filename (archive_bfd
),
1397 bfd_get_filename (abfd
));
1399 printf ("%s: ", bfd_get_filename (abfd
));
1403 /* Print a symbol value. */
1406 print_value (bfd
*abfd ATTRIBUTE_UNUSED
, bfd_vma val
)
1408 switch (print_width
)
1411 printf (value_format_32bit
, (unsigned long) val
);
1415 #if BFD_HOST_64BIT_LONG || BFD_HOST_64BIT_LONG_LONG
1416 printf (value_format_64bit
, val
);
1418 /* We have a 64 bit value to print, but the host is only 32 bit. */
1419 if (print_radix
== 16)
1420 bfd_fprintf_vma (abfd
, stdout
, val
);
1426 s
= buf
+ sizeof buf
;
1430 *--s
= (val
% print_radix
) + '0';
1433 while ((buf
+ sizeof buf
- 1) - s
< 16)
1441 fatal (_("Print width has not been initialized (%d)"), print_width
);
1446 /* Print a line of information about a symbol. */
1449 print_symbol_info_bsd (struct extended_symbol_info
*info
, bfd
*abfd
)
1451 if (bfd_is_undefined_symclass (SYM_TYPE (info
)))
1453 if (print_width
== 64)
1459 /* Normally we print the value of the symbol. If we are printing the
1460 size or sorting by size then we print its size, except for the
1461 (weird) special case where both flags are defined, in which case we
1462 print both values. This conforms to documented behaviour. */
1463 if (sort_by_size
&& !print_size
)
1464 print_value (abfd
, SYM_SIZE (info
));
1466 print_value (abfd
, SYM_VALUE (info
));
1467 if (print_size
&& SYM_SIZE (info
))
1470 print_value (abfd
, SYM_SIZE (info
));
1474 printf (" %c", SYM_TYPE (info
));
1476 if (SYM_TYPE (info
) == '-')
1480 printf (other_format
, SYM_STAB_OTHER (info
));
1482 printf (desc_format
, SYM_STAB_DESC (info
));
1483 printf (" %5s", SYM_STAB_NAME (info
));
1485 print_symname (" %s", SYM_NAME (info
), abfd
);
1489 print_symbol_info_sysv (struct extended_symbol_info
*info
, bfd
*abfd
)
1491 print_symname ("%-20s|", SYM_NAME (info
), abfd
);
1493 if (bfd_is_undefined_symclass (SYM_TYPE (info
)))
1495 if (print_width
== 32)
1501 print_value (abfd
, SYM_VALUE (info
));
1503 printf ("| %c |", SYM_TYPE (info
));
1505 if (SYM_TYPE (info
) == '-')
1508 printf ("%18s| ", SYM_STAB_NAME (info
)); /* (C) Type. */
1509 printf (desc_format
, SYM_STAB_DESC (info
)); /* Size. */
1510 printf ("| |"); /* Line, Section. */
1514 /* Type, Size, Line, Section */
1517 get_symbol_type (ELF_ST_TYPE (info
->elfinfo
->internal_elf_sym
.st_info
)));
1521 if (SYM_SIZE (info
))
1522 print_value (abfd
, SYM_SIZE (info
));
1525 if (print_width
== 32)
1532 printf("| |%s", info
->elfinfo
->symbol
.section
->name
);
1539 print_symbol_info_posix (struct extended_symbol_info
*info
, bfd
*abfd
)
1541 print_symname ("%s ", SYM_NAME (info
), abfd
);
1542 printf ("%c ", SYM_TYPE (info
));
1544 if (bfd_is_undefined_symclass (SYM_TYPE (info
)))
1548 print_value (abfd
, SYM_VALUE (info
));
1550 if (SYM_SIZE (info
))
1551 print_value (abfd
, SYM_SIZE (info
));
1556 main (int argc
, char **argv
)
1561 #if defined (HAVE_SETLOCALE) && defined (HAVE_LC_MESSAGES)
1562 setlocale (LC_MESSAGES
, "");
1564 #if defined (HAVE_SETLOCALE)
1565 setlocale (LC_CTYPE
, "");
1566 setlocale (LC_COLLATE
, "");
1568 bindtextdomain (PACKAGE
, LOCALEDIR
);
1569 textdomain (PACKAGE
);
1571 program_name
= *argv
;
1572 xmalloc_set_program_name (program_name
);
1573 bfd_set_error_program_name (program_name
);
1574 #if BFD_SUPPORTS_PLUGINS
1575 bfd_plugin_set_program_name (program_name
);
1578 START_PROGRESS (program_name
, 0);
1580 expandargv (&argc
, &argv
);
1583 set_default_bfd_target ();
1585 while ((c
= getopt_long (argc
, argv
, "aABCDef:gHhlnopPrSst:uvVvX:",
1586 long_options
, (int *) 0)) != EOF
)
1591 print_debug_syms
= 1;
1595 filename_per_symbol
= 1;
1597 case 'B': /* For MIPS compatibility. */
1598 set_output_format ("bsd");
1604 enum demangling_styles style
;
1606 style
= cplus_demangle_name_to_style (optarg
);
1607 if (style
== unknown_demangling
)
1608 fatal (_("unknown demangling style `%s'"),
1611 cplus_demangle_set_style (style
);
1618 /* Ignored for HP/UX compatibility. */
1621 set_output_format (optarg
);
1635 sort_numerically
= 1;
1640 sort_numerically
= 0;
1643 case OPTION_SIZE_SORT
:
1645 sort_numerically
= 0;
1649 set_output_format ("posix");
1661 set_print_radix (optarg
);
1670 /* Ignored for (partial) AIX compatibility. On AIX, the
1671 argument has values 32, 64, or 32_64, and specifies that
1672 only 32-bit, only 64-bit, or both kinds of objects should
1673 be examined. The default is 32. So plain AIX nm on a
1674 library archive with both kinds of objects will ignore
1675 the 64-bit ones. For GNU nm, the default is and always
1676 has been -X 32_64, and other options are not supported. */
1677 if (strcmp (optarg
, "32_64") != 0)
1678 fatal (_("Only -X 32_64 is supported"));
1681 case OPTION_TARGET
: /* --target */
1685 case OPTION_PLUGIN
: /* --plugin */
1686 #if BFD_SUPPORTS_PLUGINS
1687 bfd_plugin_set_plugin (optarg
);
1689 fatal (_("sorry - this program has been built without plugin support\n"));
1693 case 0: /* A long option that just sets a flag. */
1702 print_version ("nm");
1704 if (sort_by_size
&& undefined_only
)
1706 non_fatal (_("Using the --size-sort and --undefined-only options together"));
1707 non_fatal (_("will produce no output, since undefined symbols have no size."));
1711 /* OK, all options now parsed. If no filename specified, do a.out. */
1713 return !display_file ("a.out");
1717 if (argc
- optind
> 1)
1718 filename_per_file
= 1;
1720 /* We were given several filenames to do. */
1721 while (optind
< argc
)
1724 if (!display_file (argv
[optind
++]))
1728 END_PROGRESS (program_name
);
1733 char *lim
= (char *) sbrk (0);
1735 non_fatal (_("data size %ld"), (long) (lim
- (char *) &environ
));