1 /* All symbol handling for the linker
2 Copyright (C) 1991 Free Software Foundation, Inc.
3 Written by Steve Chamberlain steve@cygnus.com
5 This file is part of GLD, the Gnu Linker.
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program; if not, write to the Free Software
19 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */
22 We keep a hash table of global symbols. Each entry in a hash table
23 is called an ldsym_type. Each has three chains; a pointer to a
24 chain of definitions for the symbol (hopefully one long), a pointer
25 to a chain of references to the symbol, and a pointer to a chain of
26 common symbols. Each pointer points into the canonical symbol table
27 provided by bfd, each one of which points to an asymbol. During
28 linkage, the linker uses the udata field to point to the next entry
29 in a canonical table....
34 +----------+ +----------+
35 | defs | a canonical symbol table
36 +----------+ +----------+
37 | refs | -----> | one entry| -----> asymbol
38 +----------+ +----------+ | |
39 | coms | | | +---------+
40 +----------+ +----------+ | udata |-----> another canonical
45 It is very simple to make all the symbol pointers point to the same
46 definition - just run down the chain and make the asymbols pointers
47 within the canonical table point to the asymbol attacthed to the
48 definition of the symbol.
63 /* Head and tail of global symbol table chronological list */
65 ldsym_type
*symbol_head
= (ldsym_type
*) NULL
;
66 ldsym_type
**symbol_tail_ptr
= &symbol_head
;
67 CONST
char *keepsyms_file
;
70 struct obstack global_sym_obstack
;
71 #define obstack_chunk_alloc ldmalloc
72 #define obstack_chunk_free free
75 incremented for each symbol in the ldsym_type table
76 no matter what flavour it is
78 unsigned int global_symbol_count
;
82 static ldsym_type
*global_symbol_hash_table
[TABSIZE
];
84 /* Compute the hash code for symbol name KEY. */
94 register CONST
char *cp
;
99 while (*cp
&& l
< symbol_truncate
)
101 k
= (((k
<< 1) + (k
>> 14)) ^ (*cp
++)) & 0x3fff;
112 search (key
, hashval
)
117 for (bp
= global_symbol_hash_table
[hashval
]; bp
; bp
= bp
->link
)
118 if (!strncmp (key
, bp
->name
, symbol_truncate
))
120 if (bp
->flags
& SYM_INDIRECT
)
122 /* Use the symbol we're aliased to instead */
123 return (ldsym_type
*) (bp
->sdefs_chain
);
131 /* Get the symbol table entry for the global symbol named KEY.
132 Create one if there is none. */
137 register int hashval
;
138 register ldsym_type
*bp
;
140 /* Determine the proper bucket. */
142 hashval
= hash_string (key
) % TABSIZE
;
144 /* Search the bucket. */
145 bp
= search (key
, hashval
);
151 /* Nothing was found; create a new symbol table entry. */
153 bp
= (ldsym_type
*) obstack_alloc (&global_sym_obstack
, (bfd_size_type
) (sizeof (ldsym_type
)));
154 bp
->srefs_chain
= (asymbol
**) NULL
;
155 bp
->sdefs_chain
= (asymbol
**) NULL
;
156 bp
->scoms_chain
= (asymbol
**) NULL
;
157 bp
->name
= obstack_copy (&global_sym_obstack
, key
, strlen (key
) + 1);
159 /* Add the entry to the bucket. */
161 bp
->link
= global_symbol_hash_table
[hashval
];
162 global_symbol_hash_table
[hashval
] = bp
;
164 /* Keep the chronological list up to date too */
165 *symbol_tail_ptr
= bp
;
166 symbol_tail_ptr
= &bp
->next
;
168 global_symbol_count
++;
173 /* Like `ldsym_get' but return 0 if the symbol is not already known. */
179 register int hashval
;
180 /* Determine which bucket. */
182 hashval
= hash_string (key
) % TABSIZE
;
184 /* Search the bucket. */
185 return search (key
, hashval
);
189 process_keepsyms (table
, size
)
193 struct obstack obstack
;
194 char *start_of_obstack
;
196 asymbol
**out
= table
;
197 asymbol
**end
= table
+ size
;
200 if (!keepsyms_file
|| size
== 0)
202 obstack_init (&obstack
);
203 obstack_alloc (&obstack
, 1);
204 obstack_finish (&obstack
);
205 start_of_obstack
= obstack_alloc (&obstack
, 1);
206 ks_file
= fopen (keepsyms_file
, "r");
209 info_msg ("%X%P: cannot open keep-symbols file `%s'\n", keepsyms_file
);
215 do { asymbol **p = (S), *tmp = *out; *out = *p; *p = tmp; out++; } while (0)
217 while (!feof (ks_file
) && !ferror (ks_file
))
223 obstack_free (&obstack
, start_of_obstack
);
229 obstack_1grow (&obstack
, c
);
237 info_msg ("%X%P: error reading keep-symbols file `%s': %E\n",
242 if (obstack_next_free (&obstack
) != obstack_base (&obstack
) + 1)
243 /* eof in middle of symbol */
245 info_msg ("%X%P: eof reached mid-line while reading keep-symbols file `%s'\n",
250 /* All okay -- no incomplete lines, EOF reached. */
253 ptr
= obstack_next_free (&obstack
) - 2;
254 /* discard trailing trash */
258 ptr
= obstack_base (&obstack
);
259 for (sym
= out
; sym
< end
; sym
++)
260 if (!strncmp ((*sym
)->name
, ptr
, symbol_truncate
))
266 info_msg ("%P: symbol `%s' (requested to be kept) not found\n", ptr
);
268 /* It'd be slightly faster to move this pass above the previous one,
269 but that'd mean any symbols preserved in this pass would generate
270 warnings if they were also listed in the keepsyms file. */
271 for (sym
= out
; sym
< end
; sym
++)
274 if (s
->section
== &bfd_und_section
275 || bfd_is_com_section (s
->section
)
276 || s
->flags
& BSF_KEEP_G
)
280 obstack_free (&obstack
, start_of_obstack
);
288 /* This function is not used. */
291 list_file_locals (entry
)
292 lang_input_statement_type
*entry
;
295 fprintf (config
.map_file
, "\nLocal symbols of ");
297 fprintf (config
.map_file
, ":\n\n");
300 for (q
= entry
->asymbols
; *q
; q
++)
303 /* If this is a definition,
304 update it if necessary by this file's start address. */
305 if (p
->flags
& BSF_LOCAL
)
306 info_msg (" %V %s\n", p
->value
, p
->name
);
315 lang_input_statement_type
* f
;
317 fprintf (config
.map_file
, " %s\n", f
->filename
);
318 if (f
->just_syms_flag
)
320 fprintf (config
.map_file
, " symbols only\n");
327 for (s
= f
->the_bfd
->sections
;
328 s
!= (asection
*) NULL
;
331 print_address (s
->output_offset
);
334 fprintf (config
.map_file
, " %08x 2**%2ud %s\n",
335 (unsigned) bfd_get_section_size_after_reloc (s
),
336 s
->alignment_power
, s
->name
);
341 fprintf (config
.map_file
, " %08x 2**%2ud %s\n",
342 (unsigned) bfd_get_section_size_before_reloc (s
),
343 s
->alignment_power
, s
->name
);
349 for (s
= f
->the_bfd
->sections
;
350 s
!= (asection
*) NULL
;
353 fprintf (config
.map_file
, "%s ", s
->name
);
354 print_address (s
->output_offset
);
355 fprintf (config
.map_file
, "(%x)", (unsigned) bfd_get_section_size_after_reloc (s
));
357 fprintf (config
.map_file
, "hex \n");
360 fprintf (config
.map_file
, "\n");
364 ldsym_print_symbol_table ()
366 fprintf (config
.map_file
, "**FILES**\n\n");
368 lang_for_each_file (print_file_stuff
);
370 fprintf (config
.map_file
, "**GLOBAL SYMBOLS**\n\n");
371 fprintf (config
.map_file
, "offset section offset symbol\n");
373 register ldsym_type
*sp
;
375 for (sp
= symbol_head
; sp
; sp
= sp
->next
)
377 if (sp
->flags
& SYM_INDIRECT
)
379 fprintf (config
.map_file
, "indirect %s to %s\n",
380 sp
->name
, (((ldsym_type
*) (sp
->sdefs_chain
))->name
));
386 asymbol
*defsym
= *(sp
->sdefs_chain
);
387 asection
*defsec
= bfd_get_section (defsym
);
388 print_address (defsym
->value
);
391 fprintf (config
.map_file
, " %-10s",
392 bfd_section_name (output_bfd
,
395 print_address (defsym
->value
+ defsec
->vma
);
400 fprintf (config
.map_file
, " .......");
408 fprintf (config
.map_file
, "common ");
409 print_address ((*(sp
->scoms_chain
))->value
);
410 fprintf (config
.map_file
, " %s ", sp
->name
);
412 else if (sp
->sdefs_chain
)
414 fprintf (config
.map_file
, " %s ", sp
->name
);
418 fprintf (config
.map_file
, "undefined ");
419 fprintf (config
.map_file
, "%s ", sp
->name
);
430 write_file_locals (output_buffer
)
431 asymbol
**output_buffer
;
433 LANG_FOR_EACH_INPUT_STATEMENT (entry
)
435 /* Run trough the symbols and work out what to do with them */
438 /* Add one for the filename symbol if needed */
439 if (create_object_symbols
440 != (lang_output_section_statement_type
*) NULL
)
443 for (s
= entry
->the_bfd
->sections
;
444 s
!= (asection
*) NULL
;
447 if (s
->output_section
== create_object_symbols
->bfd_section
)
449 /* Add symbol to this section */
451 (asymbol
*) bfd_make_empty_symbol (entry
->the_bfd
);
452 newsym
->name
= entry
->local_sym_name
;
453 /* The symbol belongs to the output file's text section */
455 /* The value is the start of this section in the output file*/
457 /* FIXME: Usurping BSF_KEEP_G flag, since it's defined as
458 "used by the linker" and I can't find any other code that
459 uses it. Should be a cleaner way of doing this (like an
460 "application flags" field in the symbol structure?). */
461 newsym
->flags
= BSF_LOCAL
| BSF_KEEP_G
| BSF_FILE
;
463 *output_buffer
++ = newsym
;
468 for (i
= 0; i
< entry
->symbol_count
; i
++)
470 asymbol
*p
= entry
->asymbols
[i
];
471 /* FIXME, temporary hack, since not all of ld knows about the new abs section convention */
474 p
->section
= &bfd_abs_section
;
475 if ((p
->flags
& BSF_GLOBAL
)
476 || (p
->flags
& BSF_WEAK
))
478 /* If this symbol is marked as occurring now, rather than
479 at the end, output it now. This is used for COFF C_EXT
480 FCN symbols. FIXME: There must be a better way. */
481 if (bfd_asymbol_bfd (p
) == entry
->the_bfd
482 && (p
->flags
& BSF_NOT_AT_END
))
484 *(output_buffer
++) = p
;
485 p
->flags
|= BSF_KEEP
;
490 if (p
->section
== &bfd_ind_section
)
492 /* Dont think about indirect symbols */
494 else if (p
->flags
& BSF_DEBUGGING
)
496 /* Only keep the debugger symbols if no stripping required */
497 if (strip_symbols
== STRIP_NONE
)
499 *output_buffer
++ = p
;
502 else if (p
->section
== &bfd_und_section
503 || bfd_is_com_section (p
->section
))
505 /* These must be global. */
507 else if (p
->flags
& BSF_LOCAL
)
509 if (discard_locals
== DISCARD_ALL
)
512 else if (discard_locals
== DISCARD_L
&&
513 (p
->name
[0] == lprefix
))
516 else if (p
->flags
== BSF_WARNING
)
521 *output_buffer
++ = p
;
524 else if (p
->flags
& BSF_CONSTRUCTOR
)
526 if (strip_symbols
!= STRIP_ALL
)
528 *output_buffer
++ = p
;
540 return output_buffer
;
545 write_file_globals (symbol_table
)
546 asymbol
**symbol_table
;
550 if (sp
->flags
& SYM_INDIRECT
)
552 asymbol
*bufp
= (*(sp
->srefs_chain
));
553 ldsym_type
*aliased_to
= (ldsym_type
*) (sp
->sdefs_chain
);
554 if (aliased_to
->sdefs_chain
)
556 asymbol
*p
= aliased_to
->sdefs_chain
[0];
557 bufp
->value
= p
->value
;
558 bufp
->section
= p
->section
;
559 bufp
->flags
= p
->flags
;
565 bufp
->section
= &bfd_und_section
;
567 *symbol_table
++ = bufp
;
569 else if ((sp
->flags
& SYM_INDIRECT
) == 0 && sp
->sdefs_chain
!= (asymbol
**) NULL
)
571 asymbol
*bufp
= (*(sp
->sdefs_chain
));
573 if ((bufp
->flags
& BSF_KEEP
) == 0)
575 ASSERT (bufp
!= (asymbol
*) NULL
);
577 bufp
->name
= sp
->name
;
579 if (sp
->scoms_chain
!= (asymbol
**) NULL
)
583 defined as common but not allocated, this happens
584 only with -r and not -d, write out a common
587 bufp
= *(sp
->scoms_chain
);
589 *symbol_table
++ = bufp
;
592 else if (sp
->scoms_chain
!= (asymbol
**) NULL
)
594 /* This symbol is a common - just output */
595 asymbol
*bufp
= (*(sp
->scoms_chain
));
596 *symbol_table
++ = bufp
;
598 else if (sp
->srefs_chain
!= (asymbol
**) NULL
)
600 /* This symbol is undefined but has a reference */
601 asymbol
*bufp
= (*(sp
->srefs_chain
));
602 *symbol_table
++ = bufp
;
607 This symbol has neither defs nor refs, it must have come
608 from the command line, since noone has used it it has no
609 data attatched, so we'll ignore it
619 if (keepsyms_file
!= 0
620 && strip_symbols
!= STRIP_SOME
)
622 info_msg ("%P: `-retain-symbols-file' overrides `-s' and `-S'\n");
623 strip_symbols
= STRIP_SOME
;
625 if (strip_symbols
!= STRIP_ALL
)
627 /* We know the maximum size of the symbol table -
628 it's the size of all the global symbols ever seen +
629 the size of all the symbols from all the files +
630 the number of files (for the per file symbols)
631 +1 (for the null at the end)
633 asymbol
**symbol_table
=
635 ldmalloc ((bfd_size_type
) ((global_symbol_count
639 * sizeof (asymbol
*))));
640 asymbol
**tablep
= write_file_locals (symbol_table
);
642 tablep
= write_file_globals (tablep
);
643 tablep
= process_keepsyms (symbol_table
, tablep
- symbol_table
);
645 *tablep
= (asymbol
*) NULL
;
646 bfd_set_symtab (output_bfd
, symbol_table
, (unsigned) (tablep
- symbol_table
));
651 return true if the supplied symbol name is not in the
655 ldsym_undefined (sym
)
658 ldsym_type
*from_table
= ldsym_get_soft (sym
);
659 if (from_table
!= (ldsym_type
*) NULL
)
661 if (from_table
->sdefs_chain
!= (asymbol
**) NULL
)
670 obstack_begin (&global_sym_obstack
, 20000);