1 /* All symbol handling for the linker
2 Copyright (C) 1991 Free Software Foundation, Inc.
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 symbol
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.
60 extern int symbol_truncate;
61 extern bfd *output_bfd;
62 extern strip_symbols_type strip_symbols;
63 extern discard_locals_type discard_locals;
64 /* Head and tail of global symbol table chronological list */
66 ldsym_type *symbol_head = (ldsym_type *)NULL;
67 ldsym_type **symbol_tail_ptr = &symbol_head;
68 CONST char *keepsyms_file;
71 extern ld_config_type config;
73 struct obstack global_sym_obstack;
74 #define obstack_chunk_alloc ldmalloc
75 #define obstack_chunk_free free
78 incremented for each symbol in the ldsym_type table
79 no matter what flavour it is
81 unsigned int global_symbol_count;
85 extern boolean option_longmap ;
89 static ldsym_type *global_symbol_hash_table[TABSIZE];
91 /* Compute the hash code for symbol name KEY. */
98 DEFUN(hash_string,(key),
101 register CONST char *cp;
106 while (*cp && l < symbol_truncate) {
107 k = (((k << 1) + (k >> 14)) ^ (*cp++)) & 0x3fff;
116 #endif ldsym_type *bp;
118 DEFUN(search,(key,hashval) ,
123 for (bp = global_symbol_hash_table[hashval]; bp; bp = bp->link)
124 if (! strncmp (key, bp->name, symbol_truncate)) {
125 if (bp->flags & SYM_INDIRECT) {
126 /* Use the symbol we're aliased to instead */
127 return (ldsym_type *)(bp->sdefs_chain);
135 /* Get the symbol table entry for the global symbol named KEY.
136 Create one if there is none. */
138 DEFUN(ldsym_get,(key),
141 register int hashval;
142 register ldsym_type *bp;
144 /* Determine the proper bucket. */
146 hashval = hash_string (key) % TABSIZE;
148 /* Search the bucket. */
149 bp = search(key, hashval);
154 /* Nothing was found; create a new symbol table entry. */
156 bp = (ldsym_type *) obstack_alloc (&global_sym_obstack, (bfd_size_type)(sizeof (ldsym_type)));
157 bp->srefs_chain = (asymbol **)NULL;
158 bp->sdefs_chain = (asymbol **)NULL;
159 bp->scoms_chain = (asymbol **)NULL;
160 bp->name = obstack_copy(&global_sym_obstack, key, strlen(key)+1);
162 /* Add the entry to the bucket. */
164 bp->link = global_symbol_hash_table[hashval];
165 global_symbol_hash_table[hashval] = bp;
167 /* Keep the chronological list up to date too */
168 *symbol_tail_ptr = bp;
169 symbol_tail_ptr = &bp->next;
171 global_symbol_count++;
176 /* Like `ldsym_get' but return 0 if the symbol is not already known. */
179 DEFUN(ldsym_get_soft,(key),
182 register int hashval;
183 /* Determine which bucket. */
185 hashval = hash_string (key) % TABSIZE;
187 /* Search the bucket. */
188 return search(key, hashval);
192 process_keepsyms (table, size)
196 struct obstack obstack;
197 char *start_of_obstack;
199 asymbol **out = table;
200 asymbol **end = table + size;
203 if (!keepsyms_file || size == 0)
205 obstack_init (&obstack);
206 obstack_alloc (&obstack, 1);
207 obstack_finish (&obstack);
208 start_of_obstack = obstack_alloc (&obstack, 1);
209 ks_file = fopen (keepsyms_file, "r");
212 info ("%X%P: can't open keep-symbols file `%s'\n", keepsyms_file);
218 do { asymbol **p=(S), *tmp=*out; *out=*p; *p=tmp; out++; } while (0)
220 while (!feof (ks_file) && !ferror (ks_file))
226 obstack_free (&obstack, start_of_obstack);
232 obstack_1grow (&obstack, c);
240 info ("%X%P: error reading keep-symbols file `%s': %E\n",
245 if (obstack_next_free (&obstack) != obstack_base (&obstack) + 1)
246 /* eof in middle of symbol */
248 info ("%X%P: eof reached mid-line while reading keep-symbols file `%s'\n",
253 /* All okay -- no incomplete lines, EOF reached. */
256 ptr = obstack_next_free (&obstack) - 2;
257 /* discard trailing trash */
261 ptr = obstack_base (&obstack);
262 for (sym = out; sym < end; sym++)
263 if (!strncmp ((*sym)->name, ptr, symbol_truncate))
269 info ("%P: symbol `%s' (requested to be kept) not found\n", ptr);
271 /* It'd be slightly faster to move this pass above the previous one,
272 but that'd mean any symbols preserved in this pass would generate
273 warnings if they were also listed in the keepsyms file. */
274 for (sym = out; sym < end; sym++)
277 if (s->section == &bfd_und_section
278 || bfd_is_com_section (s->section)
279 || s->flags & BSF_KEEP_G)
283 obstack_free (&obstack, start_of_obstack);
290 list_file_locals (entry)
291 lang_input_statement_type *entry;
294 fprintf (config.map_file, "\nLocal symbols of ");
296 fprintf (config.map_file, ":\n\n");
297 if (entry->asymbols) {
298 for (q = entry->asymbols; *q; q++)
301 /* If this is a definition,
302 update it if necessary by this file's start address. */
303 if (p->flags & BSF_LOCAL)
304 info(" %V %s\n",p->value, p->name);
311 DEFUN(print_file_stuff,(f),
312 lang_input_statement_type *f)
314 fprintf (config.map_file," %s\n", f->filename);
315 if (f->just_syms_flag)
317 fprintf (config.map_file, " symbols only\n");
322 if (true || option_longmap) {
323 for (s = f->the_bfd->sections;
324 s != (asection *)NULL;
326 print_address(s->output_offset);
329 fprintf (config.map_file, " %08x 2**%2ud %s\n",
330 (unsigned)bfd_get_section_size_after_reloc(s),
331 s->alignment_power, s->name);
336 fprintf (config.map_file, " %08x 2**%2ud %s\n",
337 (unsigned)bfd_get_section_size_before_reloc(s),
338 s->alignment_power, s->name);
344 for (s = f->the_bfd->sections;
345 s != (asection *)NULL;
347 fprintf(config.map_file, "%s ", s->name);
348 print_address(s->output_offset);
349 fprintf(config.map_file, "(%x)", (unsigned)bfd_get_section_size_after_reloc(s));
351 fprintf(config.map_file, "hex \n");
354 fprintf (config.map_file, "\n");
358 ldsym_print_symbol_table ()
360 fprintf (config.map_file, "**FILES**\n\n");
362 lang_for_each_file(print_file_stuff);
364 fprintf(config.map_file, "**GLOBAL SYMBOLS**\n\n");
365 fprintf(config.map_file, "offset section offset symbol\n");
367 register ldsym_type *sp;
369 for (sp = symbol_head; sp; sp = sp->next)
371 if (sp->flags & SYM_INDIRECT) {
372 fprintf(config.map_file,"indirect %s to %s\n",
373 sp->name, (((ldsym_type *)(sp->sdefs_chain))->name));
378 asymbol *defsym = *(sp->sdefs_chain);
379 asection *defsec = bfd_get_section(defsym);
380 print_address(defsym->value);
383 fprintf(config.map_file, " %-10s",
384 bfd_section_name(output_bfd,
387 print_address(defsym->value+defsec->vma);
392 fprintf(config.map_file, " .......");
398 if (sp->scoms_chain) {
399 fprintf(config.map_file, "common ");
400 print_address((*(sp->scoms_chain))->value);
401 fprintf(config.map_file, " %s ",sp->name);
403 else if (sp->sdefs_chain) {
404 fprintf(config.map_file, " %s ",sp->name);
407 fprintf(config.map_file, "undefined ");
408 fprintf(config.map_file, "%s ",sp->name);
416 if (option_longmap) {
417 lang_for_each_file(list_file_locals);
421 extern lang_output_section_statement_type *create_object_symbols;
424 write_file_locals(output_buffer)
425 asymbol **output_buffer;
427 LANG_FOR_EACH_INPUT_STATEMENT(entry)
429 /* Run trough the symbols and work out what to do with them */
432 /* Add one for the filename symbol if needed */
433 if (create_object_symbols
434 != (lang_output_section_statement_type *)NULL) {
436 for (s = entry->the_bfd->sections;
437 s != (asection *)NULL;
439 if (s->output_section == create_object_symbols->bfd_section) {
440 /* Add symbol to this section */
442 (asymbol *)bfd_make_empty_symbol(entry->the_bfd);
443 newsym->name = entry->local_sym_name;
444 /* The symbol belongs to the output file's text section */
446 /* The value is the start of this section in the output file*/
448 /* FIXME: Usurping BSF_KEEP_G flag, since it's defined as
449 "used by the linker" and I can't find any other code that
450 uses it. Should be a cleaner way of doing this (like an
451 "application flags" field in the symbol structure?). */
452 newsym->flags = BSF_LOCAL | BSF_KEEP_G;
454 *output_buffer++ = newsym;
459 for (i = 0; i < entry->symbol_count; i++)
461 asymbol *p = entry->asymbols[i];
462 /* FIXME, temporary hack, since not all of ld knows about the new abs section convention */
465 p->section = &bfd_abs_section;
466 if (flag_is_global(p->flags) )
468 /* We are only interested in outputting
469 globals at this stage in special circumstances */
470 if (bfd_asymbol_bfd(p) == entry->the_bfd
471 && flag_is_not_at_end(p->flags)) {
472 /* And this is one of them */
473 *(output_buffer++) = p;
474 p->flags |= BSF_KEEP;
478 if (flag_is_debugger(p->flags))
480 /* Only keep the debugger symbols if no stripping required */
481 if (strip_symbols == STRIP_NONE) {
482 *output_buffer++ = p;
485 else if (p->section == &bfd_und_section
486 || bfd_is_com_section (p->section))
488 /* These must be global. */
490 else if (flag_is_ordinary_local(p->flags))
492 if (discard_locals == DISCARD_ALL)
494 else if (discard_locals == DISCARD_L &&
495 (p->name[0] == lprefix))
497 else if (p->flags == BSF_WARNING)
500 { *output_buffer++ = p; }
502 else if (p->flags & BSF_CTOR) {
514 return output_buffer;
519 write_file_globals(symbol_table)
520 asymbol **symbol_table;
524 if ((sp->flags & SYM_INDIRECT) == 0 && sp->sdefs_chain != (asymbol **)NULL) {
525 asymbol *bufp = (*(sp->sdefs_chain));
527 if ((bufp->flags & BSF_KEEP) ==0) {
528 ASSERT(bufp != (asymbol *)NULL);
530 bufp->name = sp->name;
532 if (sp->scoms_chain != (asymbol **)NULL)
536 defined as common but not allocated, this happens
537 only with -r and not -d, write out a common
540 bufp = *(sp->scoms_chain);
542 *symbol_table++ = bufp;
545 else if (sp->scoms_chain != (asymbol **)NULL) {
546 /* This symbol is a common - just output */
547 asymbol *bufp = (*(sp->scoms_chain));
548 *symbol_table++ = bufp;
550 else if (sp->srefs_chain != (asymbol **)NULL) {
551 /* This symbol is undefined but has a reference */
552 asymbol *bufp = (*(sp->srefs_chain));
553 *symbol_table++ = bufp;
557 This symbol has neither defs nor refs, it must have come
558 from the command line, since noone has used it it has no
559 data attatched, so we'll ignore it
569 if (keepsyms_file != 0
570 && strip_symbols != STRIP_SOME)
572 info ("%P `-retain-symbols-file' overrides `-s' and `-S'\n");
573 strip_symbols = STRIP_SOME;
575 if (strip_symbols != STRIP_ALL) {
576 /* We know the maximum size of the symbol table -
577 it's the size of all the global symbols ever seen +
578 the size of all the symbols from all the files +
579 the number of files (for the per file symbols)
580 +1 (for the null at the end)
582 extern unsigned int total_files_seen;
583 extern unsigned int total_symbols_seen;
585 asymbol ** symbol_table = (asymbol **)
586 ldmalloc ((bfd_size_type)(global_symbol_count +
588 total_symbols_seen + 1) * sizeof (asymbol *));
589 asymbol ** tablep = write_file_locals(symbol_table);
591 tablep = write_file_globals(tablep);
592 tablep = process_keepsyms (symbol_table, tablep - symbol_table);
594 *tablep = (asymbol *)NULL;
595 bfd_set_symtab(output_bfd, symbol_table, (unsigned)( tablep - symbol_table));
600 return true if the supplied symbol name is not in the
604 DEFUN(ldsym_undefined,(sym),
607 ldsym_type *from_table = ldsym_get_soft(sym);
608 if (from_table != (ldsym_type *)NULL)
610 if (from_table->sdefs_chain != (asymbol **)NULL) return false;
616 DEFUN_VOID(ldsym_init)
618 obstack_begin(&global_sym_obstack, 20000);