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
, asymbol
*sym
, bfd_vma ssize
, bfd
*archive_bfd
)
812 struct extended_symbol_info info
;
816 format
->print_symbol_filename (archive_bfd
, abfd
);
818 bfd_get_symbol_info (abfd
, sym
, &syminfo
);
819 info
.sinfo
= &syminfo
;
821 if (bfd_get_flavour (abfd
) == bfd_target_elf_flavour
)
822 info
.elfinfo
= (elf_symbol_type
*) sym
;
825 format
->print_symbol_info (&info
, abfd
);
829 static asymbol
**syms
;
830 static long symcount
;
831 const char *filename
, *functionname
;
834 /* We need to get the canonical symbols in order to call
835 bfd_find_nearest_line. This is inefficient, but, then, you
836 don't have to use --line-numbers. */
837 if (abfd
!= lineno_cache_bfd
&& syms
!= NULL
)
846 symsize
= bfd_get_symtab_upper_bound (abfd
);
848 bfd_fatal (bfd_get_filename (abfd
));
849 syms
= (asymbol
**) xmalloc (symsize
);
850 symcount
= bfd_canonicalize_symtab (abfd
, syms
);
852 bfd_fatal (bfd_get_filename (abfd
));
853 lineno_cache_bfd
= abfd
;
856 if (bfd_is_und_section (bfd_get_section (sym
)))
858 static asection
**secs
;
859 static arelent
***relocs
;
860 static long *relcount
;
861 static unsigned int seccount
;
865 /* For an undefined symbol, we try to find a reloc for the
866 symbol, and print the line number of the reloc. */
867 if (abfd
!= lineno_cache_rel_bfd
&& relocs
!= NULL
)
869 for (i
= 0; i
< seccount
; i
++)
870 if (relocs
[i
] != NULL
)
882 struct get_relocs_info rinfo
;
884 seccount
= bfd_count_sections (abfd
);
886 secs
= (asection
**) xmalloc (seccount
* sizeof *secs
);
887 relocs
= (arelent
***) xmalloc (seccount
* sizeof *relocs
);
888 relcount
= (long *) xmalloc (seccount
* sizeof *relcount
);
891 rinfo
.relocs
= relocs
;
892 rinfo
.relcount
= relcount
;
894 bfd_map_over_sections (abfd
, get_relocs
, (void *) &rinfo
);
895 lineno_cache_rel_bfd
= abfd
;
898 symname
= bfd_asymbol_name (sym
);
899 for (i
= 0; i
< seccount
; i
++)
903 for (j
= 0; j
< relcount
[i
]; j
++)
908 if (r
->sym_ptr_ptr
!= NULL
909 && (*r
->sym_ptr_ptr
)->section
== sym
->section
910 && (*r
->sym_ptr_ptr
)->value
== sym
->value
912 bfd_asymbol_name (*r
->sym_ptr_ptr
)) == 0
913 && bfd_find_nearest_line (abfd
, secs
[i
], syms
,
914 r
->address
, &filename
,
915 &functionname
, &lineno
)
918 /* We only print the first one we find. */
919 printf ("\t%s:%u", filename
, lineno
);
926 else if (bfd_get_section (sym
)->owner
== abfd
)
928 if ((bfd_find_line (abfd
, syms
, sym
, &filename
, &lineno
)
929 || bfd_find_nearest_line (abfd
, bfd_get_section (sym
),
930 syms
, sym
->value
, &filename
,
931 &functionname
, &lineno
))
934 printf ("\t%s:%u", filename
, lineno
);
941 /* Print the symbols when sorting by size. */
944 print_size_symbols (bfd
*abfd
, bfd_boolean is_dynamic
,
945 struct size_sym
*symsizes
, long symcount
,
949 struct size_sym
*from
, *fromend
;
951 store
= bfd_make_empty_symbol (abfd
);
953 bfd_fatal (bfd_get_filename (abfd
));
956 fromend
= from
+ symcount
;
957 for (; from
< fromend
; from
++)
961 sym
= bfd_minisymbol_to_symbol (abfd
, is_dynamic
, from
->minisym
, store
);
963 bfd_fatal (bfd_get_filename (abfd
));
965 print_symbol (abfd
, sym
, from
->size
, archive_bfd
);
970 /* Print the symbols. If ARCHIVE_BFD is non-NULL, it is the archive
974 print_symbols (bfd
*abfd
, bfd_boolean is_dynamic
, void *minisyms
, long symcount
,
975 unsigned int size
, bfd
*archive_bfd
)
978 bfd_byte
*from
, *fromend
;
980 store
= bfd_make_empty_symbol (abfd
);
982 bfd_fatal (bfd_get_filename (abfd
));
984 from
= (bfd_byte
*) minisyms
;
985 fromend
= from
+ symcount
* size
;
986 for (; from
< fromend
; from
+= size
)
990 sym
= bfd_minisymbol_to_symbol (abfd
, is_dynamic
, from
, store
);
992 bfd_fatal (bfd_get_filename (abfd
));
994 print_symbol (abfd
, sym
, (bfd_vma
) 0, archive_bfd
);
998 /* If ARCHIVE_BFD is non-NULL, it is the archive containing ABFD. */
1001 display_rel_file (bfd
*abfd
, bfd
*archive_bfd
)
1006 struct size_sym
*symsizes
;
1010 if (!(bfd_get_file_flags (abfd
) & HAS_SYMS
))
1012 non_fatal (_("%s: no symbols"), bfd_get_filename (abfd
));
1017 symcount
= bfd_read_minisymbols (abfd
, dynamic
, &minisyms
, &size
);
1020 if (dynamic
&& bfd_get_error () == bfd_error_no_symbols
)
1022 non_fatal (_("%s: no symbols"), bfd_get_filename (abfd
));
1026 bfd_fatal (bfd_get_filename (abfd
));
1031 non_fatal (_("%s: no symbols"), bfd_get_filename (abfd
));
1035 if (show_synthetic
&& size
== sizeof (asymbol
*))
1039 asymbol
**static_syms
= NULL
;
1040 asymbol
**dyn_syms
= NULL
;
1041 long static_count
= 0;
1046 dyn_count
= symcount
;
1047 dyn_syms
= (asymbol
**) minisyms
;
1051 long storage
= bfd_get_dynamic_symtab_upper_bound (abfd
);
1053 static_count
= symcount
;
1054 static_syms
= (asymbol
**) minisyms
;
1058 dyn_syms
= (asymbol
**) xmalloc (storage
);
1059 dyn_count
= bfd_canonicalize_dynamic_symtab (abfd
, dyn_syms
);
1061 bfd_fatal (bfd_get_filename (abfd
));
1064 synth_count
= bfd_get_synthetic_symtab (abfd
, static_count
, static_syms
,
1065 dyn_count
, dyn_syms
, &synthsyms
);
1066 if (synth_count
> 0)
1072 new_mini
= xmalloc ((symcount
+ synth_count
+ 1) * sizeof (*symp
));
1073 symp
= (asymbol
**) new_mini
;
1074 memcpy (symp
, minisyms
, symcount
* sizeof (*symp
));
1076 for (i
= 0; i
< synth_count
; i
++)
1077 *symp
++ = synthsyms
+ i
;
1079 minisyms
= new_mini
;
1080 symcount
+= synth_count
;
1084 /* Discard the symbols we don't want to print.
1085 It's OK to do this in place; we'll free the storage anyway
1086 (after printing). */
1088 symcount
= filter_symbols (abfd
, dynamic
, minisyms
, symcount
, size
);
1094 sort_dynamic
= dynamic
;
1095 sort_x
= bfd_make_empty_symbol (abfd
);
1096 sort_y
= bfd_make_empty_symbol (abfd
);
1097 if (sort_x
== NULL
|| sort_y
== NULL
)
1098 bfd_fatal (bfd_get_filename (abfd
));
1101 qsort (minisyms
, symcount
, size
,
1102 sorters
[sort_numerically
][reverse_sort
]);
1104 symcount
= sort_symbols_by_size (abfd
, dynamic
, minisyms
, symcount
,
1109 print_symbols (abfd
, dynamic
, minisyms
, symcount
, size
, archive_bfd
);
1111 print_size_symbols (abfd
, dynamic
, symsizes
, symcount
, archive_bfd
);
1118 set_print_width (bfd
*file
)
1120 print_width
= bfd_get_arch_size (file
);
1122 if (print_width
== -1)
1125 Guess the target's bitsize based on its name.
1126 We assume here than any 64-bit format will include
1127 "64" somewhere in its name. The only known exception
1128 is the MMO object file format. */
1129 if (strstr (bfd_get_target (file
), "64") != NULL
1130 || strcmp (bfd_get_target (file
), "mmo") == 0)
1138 display_archive (bfd
*file
)
1141 bfd
*last_arfile
= NULL
;
1144 format
->print_archive_filename (bfd_get_filename (file
));
1147 print_symdef_entry (file
);
1153 arfile
= bfd_openr_next_archived_file (file
, arfile
);
1157 if (bfd_get_error () != bfd_error_no_more_archived_files
)
1158 bfd_fatal (bfd_get_filename (file
));
1162 if (bfd_check_format_matches (arfile
, bfd_object
, &matching
))
1164 set_print_width (arfile
);
1165 format
->print_archive_member (bfd_get_filename (file
),
1166 bfd_get_filename (arfile
));
1167 display_rel_file (arfile
, file
);
1171 bfd_nonfatal (bfd_get_filename (arfile
));
1172 if (bfd_get_error () == bfd_error_file_ambiguously_recognized
)
1174 list_matching_formats (matching
);
1179 if (last_arfile
!= NULL
)
1181 bfd_close (last_arfile
);
1182 lineno_cache_bfd
= NULL
;
1183 lineno_cache_rel_bfd
= NULL
;
1185 last_arfile
= arfile
;
1188 if (last_arfile
!= NULL
)
1190 bfd_close (last_arfile
);
1191 lineno_cache_bfd
= NULL
;
1192 lineno_cache_rel_bfd
= NULL
;
1197 display_file (char *filename
)
1199 bfd_boolean retval
= TRUE
;
1203 if (get_file_size (filename
) < 1)
1206 file
= bfd_openr (filename
, target
? target
: plugin_target
);
1209 bfd_nonfatal (filename
);
1213 /* If printing line numbers, decompress the debug sections. */
1215 file
->flags
|= BFD_DECOMPRESS
;
1217 if (bfd_check_format (file
, bfd_archive
))
1219 display_archive (file
);
1221 else if (bfd_check_format_matches (file
, bfd_object
, &matching
))
1223 set_print_width (file
);
1224 format
->print_object_filename (filename
);
1225 display_rel_file (file
, NULL
);
1229 bfd_nonfatal (filename
);
1230 if (bfd_get_error () == bfd_error_file_ambiguously_recognized
)
1232 list_matching_formats (matching
);
1238 if (!bfd_close (file
))
1239 bfd_fatal (filename
);
1241 lineno_cache_bfd
= NULL
;
1242 lineno_cache_rel_bfd
= NULL
;
1247 /* The following 3 groups of functions are called unconditionally,
1248 once at the start of processing each file of the appropriate type.
1249 They should check `filename_per_file' and `filename_per_symbol',
1250 as appropriate for their output format, to determine whether to
1253 /* Print the name of an object file given on the command line. */
1256 print_object_filename_bsd (char *filename
)
1258 if (filename_per_file
&& !filename_per_symbol
)
1259 printf ("\n%s:\n", filename
);
1263 print_object_filename_sysv (char *filename
)
1266 printf (_("\n\nUndefined symbols from %s:\n\n"), filename
);
1268 printf (_("\n\nSymbols from %s:\n\n"), filename
);
1269 if (print_width
== 32)
1271 Name Value Class Type Size Line Section\n\n"));
1274 Name Value Class Type Size Line Section\n\n"));
1278 print_object_filename_posix (char *filename
)
1280 if (filename_per_file
&& !filename_per_symbol
)
1281 printf ("%s:\n", filename
);
1284 /* Print the name of an archive file given on the command line. */
1287 print_archive_filename_bsd (char *filename
)
1289 if (filename_per_file
)
1290 printf ("\n%s:\n", filename
);
1294 print_archive_filename_sysv (char *filename ATTRIBUTE_UNUSED
)
1299 print_archive_filename_posix (char *filename ATTRIBUTE_UNUSED
)
1303 /* Print the name of an archive member file. */
1306 print_archive_member_bsd (char *archive ATTRIBUTE_UNUSED
,
1307 const char *filename
)
1309 if (!filename_per_symbol
)
1310 printf ("\n%s:\n", filename
);
1314 print_archive_member_sysv (char *archive
, const char *filename
)
1317 printf (_("\n\nUndefined symbols from %s[%s]:\n\n"), archive
, filename
);
1319 printf (_("\n\nSymbols from %s[%s]:\n\n"), archive
, filename
);
1320 if (print_width
== 32)
1322 Name Value Class Type Size Line Section\n\n"));
1325 Name Value Class Type Size Line Section\n\n"));
1329 print_archive_member_posix (char *archive
, const char *filename
)
1331 if (!filename_per_symbol
)
1332 printf ("%s[%s]:\n", archive
, filename
);
1335 /* Print the name of the file (and archive, if there is one)
1336 containing a symbol. */
1339 print_symbol_filename_bsd (bfd
*archive_bfd
, bfd
*abfd
)
1341 if (filename_per_symbol
)
1344 printf ("%s:", bfd_get_filename (archive_bfd
));
1345 printf ("%s:", bfd_get_filename (abfd
));
1350 print_symbol_filename_sysv (bfd
*archive_bfd
, bfd
*abfd
)
1352 if (filename_per_symbol
)
1355 printf ("%s:", bfd_get_filename (archive_bfd
));
1356 printf ("%s:", bfd_get_filename (abfd
));
1361 print_symbol_filename_posix (bfd
*archive_bfd
, bfd
*abfd
)
1363 if (filename_per_symbol
)
1366 printf ("%s[%s]: ", bfd_get_filename (archive_bfd
),
1367 bfd_get_filename (abfd
));
1369 printf ("%s: ", bfd_get_filename (abfd
));
1373 /* Print a symbol value. */
1376 print_value (bfd
*abfd ATTRIBUTE_UNUSED
, bfd_vma val
)
1378 switch (print_width
)
1381 printf (value_format_32bit
, (unsigned long) val
);
1385 #if BFD_HOST_64BIT_LONG || BFD_HOST_64BIT_LONG_LONG
1386 printf (value_format_64bit
, val
);
1388 /* We have a 64 bit value to print, but the host is only 32 bit. */
1389 if (print_radix
== 16)
1390 bfd_fprintf_vma (abfd
, stdout
, val
);
1396 s
= buf
+ sizeof buf
;
1400 *--s
= (val
% print_radix
) + '0';
1403 while ((buf
+ sizeof buf
- 1) - s
< 16)
1411 fatal (_("Print width has not been initialized (%d)"), print_width
);
1416 /* Print a line of information about a symbol. */
1419 print_symbol_info_bsd (struct extended_symbol_info
*info
, bfd
*abfd
)
1421 if (bfd_is_undefined_symclass (SYM_TYPE (info
)))
1423 if (print_width
== 64)
1429 /* Normally we print the value of the symbol. If we are printing the
1430 size or sorting by size then we print its size, except for the
1431 (weird) special case where both flags are defined, in which case we
1432 print both values. This conforms to documented behaviour. */
1433 if (sort_by_size
&& !print_size
)
1434 print_value (abfd
, SYM_SIZE (info
));
1436 print_value (abfd
, SYM_VALUE (info
));
1438 if (print_size
&& SYM_SIZE (info
))
1441 print_value (abfd
, SYM_SIZE (info
));
1445 printf (" %c", SYM_TYPE (info
));
1447 if (SYM_TYPE (info
) == '-')
1451 printf (other_format
, SYM_STAB_OTHER (info
));
1453 printf (desc_format
, SYM_STAB_DESC (info
));
1454 printf (" %5s", SYM_STAB_NAME (info
));
1456 print_symname (" %s", SYM_NAME (info
), abfd
);
1460 print_symbol_info_sysv (struct extended_symbol_info
*info
, bfd
*abfd
)
1462 print_symname ("%-20s|", SYM_NAME (info
), abfd
);
1464 if (bfd_is_undefined_symclass (SYM_TYPE (info
)))
1466 if (print_width
== 32)
1472 print_value (abfd
, SYM_VALUE (info
));
1474 printf ("| %c |", SYM_TYPE (info
));
1476 if (SYM_TYPE (info
) == '-')
1479 printf ("%18s| ", SYM_STAB_NAME (info
)); /* (C) Type. */
1480 printf (desc_format
, SYM_STAB_DESC (info
)); /* Size. */
1481 printf ("| |"); /* Line, Section. */
1485 /* Type, Size, Line, Section */
1488 get_symbol_type (ELF_ST_TYPE (info
->elfinfo
->internal_elf_sym
.st_info
)));
1492 if (SYM_SIZE (info
))
1493 print_value (abfd
, SYM_SIZE (info
));
1496 if (print_width
== 32)
1503 printf("| |%s", info
->elfinfo
->symbol
.section
->name
);
1510 print_symbol_info_posix (struct extended_symbol_info
*info
, bfd
*abfd
)
1512 print_symname ("%s ", SYM_NAME (info
), abfd
);
1513 printf ("%c ", SYM_TYPE (info
));
1515 if (bfd_is_undefined_symclass (SYM_TYPE (info
)))
1519 print_value (abfd
, SYM_VALUE (info
));
1521 if (SYM_SIZE (info
))
1522 print_value (abfd
, SYM_SIZE (info
));
1527 main (int argc
, char **argv
)
1532 #if defined (HAVE_SETLOCALE) && defined (HAVE_LC_MESSAGES)
1533 setlocale (LC_MESSAGES
, "");
1535 #if defined (HAVE_SETLOCALE)
1536 setlocale (LC_CTYPE
, "");
1537 setlocale (LC_COLLATE
, "");
1539 bindtextdomain (PACKAGE
, LOCALEDIR
);
1540 textdomain (PACKAGE
);
1542 program_name
= *argv
;
1543 xmalloc_set_program_name (program_name
);
1544 #if BFD_SUPPORTS_PLUGINS
1545 bfd_plugin_set_program_name (program_name
);
1548 START_PROGRESS (program_name
, 0);
1550 expandargv (&argc
, &argv
);
1553 set_default_bfd_target ();
1555 while ((c
= getopt_long (argc
, argv
, "aABCDef:gHhlnopPrSst:uvVvX:",
1556 long_options
, (int *) 0)) != EOF
)
1561 print_debug_syms
= 1;
1565 filename_per_symbol
= 1;
1567 case 'B': /* For MIPS compatibility. */
1568 set_output_format ("bsd");
1574 enum demangling_styles style
;
1576 style
= cplus_demangle_name_to_style (optarg
);
1577 if (style
== unknown_demangling
)
1578 fatal (_("unknown demangling style `%s'"),
1581 cplus_demangle_set_style (style
);
1588 /* Ignored for HP/UX compatibility. */
1591 set_output_format (optarg
);
1605 sort_numerically
= 1;
1610 sort_numerically
= 0;
1613 case OPTION_SIZE_SORT
:
1615 sort_numerically
= 0;
1619 set_output_format ("posix");
1631 set_print_radix (optarg
);
1640 /* Ignored for (partial) AIX compatibility. On AIX, the
1641 argument has values 32, 64, or 32_64, and specifies that
1642 only 32-bit, only 64-bit, or both kinds of objects should
1643 be examined. The default is 32. So plain AIX nm on a
1644 library archive with both kinds of objects will ignore
1645 the 64-bit ones. For GNU nm, the default is and always
1646 has been -X 32_64, and other options are not supported. */
1647 if (strcmp (optarg
, "32_64") != 0)
1648 fatal (_("Only -X 32_64 is supported"));
1651 case OPTION_TARGET
: /* --target */
1655 case OPTION_PLUGIN
: /* --plugin */
1656 #if BFD_SUPPORTS_PLUGINS
1657 bfd_plugin_set_plugin (optarg
);
1659 fatal (_("sorry - this program has been built without plugin support\n"));
1663 case 0: /* A long option that just sets a flag. */
1672 print_version ("nm");
1674 if (sort_by_size
&& undefined_only
)
1676 non_fatal (_("Using the --size-sort and --undefined-only options together"));
1677 non_fatal (_("will produce no output, since undefined symbols have no size."));
1681 /* OK, all options now parsed. If no filename specified, do a.out. */
1683 return !display_file ("a.out");
1687 if (argc
- optind
> 1)
1688 filename_per_file
= 1;
1690 /* We were given several filenames to do. */
1691 while (optind
< argc
)
1694 if (!display_file (argv
[optind
++]))
1698 END_PROGRESS (program_name
);
1703 char *lim
= (char *) sbrk (0);
1705 non_fatal (_("data size %ld"), (long) (lim
- (char *) &environ
));