OSDN Git Service

* elfread.c (elf_symtab_read): Revert changes by Amit S. Kale. A
[pf3gnuchains/pf3gnuchains3x.git] / bfd / elf-bfd.h
1 /* BFD back-end data structures for ELF files.
2    Copyright (C) 1992, 93, 94, 95, 96, 97, 98, 1999 Free Software
3    Foundation, Inc.
4    Written by Cygnus Support.
5
6 This file is part of BFD, the Binary File Descriptor library.
7
8 This program is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 2 of the License, or
11 (at your option) any later version.
12
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16 GNU General Public License for more details.
17
18 You should have received a copy of the GNU General Public License
19 along with this program; if not, write to the Free Software
20 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.  */
21
22 #ifndef _LIBELF_H_
23 #define _LIBELF_H_ 1
24
25 #include "elf/common.h"
26 #include "elf/internal.h"
27 #include "elf/external.h"
28 #include "bfdlink.h"
29
30 /* If size isn't specified as 64 or 32, NAME macro should fail.  */
31 #ifndef NAME
32 #if ARCH_SIZE==64
33 #define NAME(x,y) CAT4(x,64,_,y)
34 #endif
35 #if ARCH_SIZE==32
36 #define NAME(x,y) CAT4(x,32,_,y)
37 #endif
38 #endif
39
40 #ifndef NAME
41 #define NAME(x,y) CAT4(x,NOSIZE,_,y)
42 #endif
43
44 #define ElfNAME(X)      NAME(Elf,X)
45 #define elfNAME(X)      NAME(elf,X)
46
47 /* Information held for an ELF symbol.  The first field is the
48    corresponding asymbol.  Every symbol is an ELF file is actually a
49    pointer to this structure, although it is often handled as a
50    pointer to an asymbol.  */
51
52 typedef struct
53 {
54   /* The BFD symbol.  */
55   asymbol symbol;
56   /* ELF symbol information.  */
57   Elf_Internal_Sym internal_elf_sym;
58   /* Backend specific information.  */
59   union
60     {
61       unsigned int hppa_arg_reloc;
62       PTR mips_extr;
63       PTR any;
64     }
65   tc_data;
66
67   /* Version information.  This is from an Elf_Internal_Versym
68      structure in a SHT_GNU_versym section.  It is zero if there is no
69      version information.  */
70   unsigned short version;
71
72 } elf_symbol_type;
73 \f
74 /* ELF linker hash table entries.  */
75
76 struct elf_link_hash_entry
77 {
78   struct bfd_link_hash_entry root;
79
80   /* Symbol index in output file.  This is initialized to -1.  It is
81      set to -2 if the symbol is used by a reloc.  */
82   long indx;
83
84   /* Symbol size.  */
85   bfd_size_type size;
86
87   /* Symbol index as a dynamic symbol.  Initialized to -1, and remains
88      -1 if this is not a dynamic symbol.  */
89   /* ??? Note that this is consistently used as a synonym for tests
90      against whether we can perform various simplifying transformations
91      to the code.  (E.g. changing a pc-relative jump to a PLT entry
92      into a pc-relative jump to the target function.)  That test, which
93      is often relatively complex, and someplaces wrong or incomplete,
94      should really be replaced by a predicate in elflink.c.
95
96      End result: this field -1 does not indicate that the symbol is
97      not in the dynamic symbol table, but rather that the symbol is
98      not visible outside this DSO.  */
99   long dynindx;
100
101   /* String table index in .dynstr if this is a dynamic symbol.  */
102   unsigned long dynstr_index;
103
104   /* If this is a weak defined symbol from a dynamic object, this
105      field points to a defined symbol with the same value, if there is
106      one.  Otherwise it is NULL.  */
107   struct elf_link_hash_entry *weakdef;
108
109   /* If this symbol requires an entry in the global offset table, the
110      processor specific backend uses this field to track usage and
111      final offset.  We use a union and two names primarily to document
112      the intent of any particular piece of code.  The field should be
113      used as a count until size_dynamic_sections, at which point the
114      contents of the .got is fixed.  Afterward, if this field is -1,
115      then the symbol does not require a global offset table entry.  */
116   union
117     {
118       bfd_signed_vma refcount;
119       bfd_vma offset;
120     } got;
121
122   /* Same, but tracks a procedure linkage table entry.  */
123   union
124     {
125       bfd_signed_vma refcount;
126       bfd_vma offset;
127     } plt;
128
129   /* If this symbol is used in the linker created sections, the processor
130      specific backend uses this field to map the field into the offset
131      from the beginning of the section.  */
132   struct elf_linker_section_pointers *linker_section_pointer;
133
134   /* Version information.  */
135   union
136   {
137     /* This field is used for a symbol which is not defined in a
138        regular object.  It points to the version information read in
139        from the dynamic object.  */
140     Elf_Internal_Verdef *verdef;
141     /* This field is used for a symbol which is defined in a regular
142        object.  It is set up in size_dynamic_sections.  It points to
143        the version information we should write out for this symbol.  */
144     struct bfd_elf_version_tree *vertree;
145   } verinfo;
146
147   /* Virtual table entry use information.  This array is nominally of size
148      size/sizeof(target_void_pointer), though we have to be able to assume
149      and track a size while the symbol is still undefined.  It is indexed
150      via offset/sizeof(target_void_pointer).  */
151   size_t vtable_entries_size;
152   boolean *vtable_entries_used;
153
154   /* Virtual table derivation info.  */
155   struct elf_link_hash_entry *vtable_parent;
156
157   /* Symbol type (STT_NOTYPE, STT_OBJECT, etc.).  */
158   char type;
159
160   /* Symbol st_other value, symbol visibility.  */
161   unsigned char other;
162
163   /* Hash value of the name computed using the ELF hash function.  */
164   unsigned long elf_hash_value;
165
166   /* Some flags; legal values follow.  */
167   unsigned short elf_link_hash_flags;
168   /* Symbol is referenced by a non-shared object.  */
169 #define ELF_LINK_HASH_REF_REGULAR 01
170   /* Symbol is defined by a non-shared object.  */
171 #define ELF_LINK_HASH_DEF_REGULAR 02
172   /* Symbol is referenced by a shared object.  */
173 #define ELF_LINK_HASH_REF_DYNAMIC 04
174   /* Symbol is defined by a shared object.  */
175 #define ELF_LINK_HASH_DEF_DYNAMIC 010
176   /* Symbol has a non-weak reference from a non-shared object.  */
177 #define ELF_LINK_HASH_REF_REGULAR_NONWEAK 020
178   /* Dynamic symbol has been adjustd.  */
179 #define ELF_LINK_HASH_DYNAMIC_ADJUSTED 040
180   /* Symbol needs a copy reloc.  */
181 #define ELF_LINK_HASH_NEEDS_COPY 0100
182   /* Symbol needs a procedure linkage table entry.  */
183 #define ELF_LINK_HASH_NEEDS_PLT 0200
184   /* Symbol appears in a non-ELF input file.  */
185 #define ELF_LINK_NON_ELF 0400
186   /* Symbol should be marked as hidden in the version information.  */
187 #define ELF_LINK_HIDDEN 01000
188   /* Symbol was forced to local scope due to a version script file.  */
189 #define ELF_LINK_FORCED_LOCAL 02000
190   /* Symbol was marked during garbage collection.  */
191 #define ELF_LINK_HASH_MARK 04000
192   /* Symbol is referenced by a non-GOT/non-PLT relocation.  This is
193      not currently set by all the backends.  */
194 #define ELF_LINK_NON_GOT_REF 010000
195 };
196
197 /* Records local symbols to be emitted in the dynamic symbol table.  */
198
199 struct elf_link_local_dynamic_entry
200 {
201   struct elf_link_local_dynamic_entry *next;
202
203   /* The input bfd this symbol came from.  */
204   bfd *input_bfd;
205
206   /* The index of the local symbol being copied.  */
207   long input_indx;
208
209   /* The index in the outgoing dynamic symbol table.  */
210   long dynindx;
211   
212   /* A copy of the input symbol.  */
213   Elf_Internal_Sym isym;
214 };
215
216 /* ELF linker hash table.  */
217
218 struct elf_link_hash_table
219 {
220   struct bfd_link_hash_table root;
221   /* Whether we have created the special dynamic sections required
222      when linking against or generating a shared object.  */
223   boolean dynamic_sections_created;
224   /* The BFD used to hold special sections created by the linker.
225      This will be the first BFD found which requires these sections to
226      be created.  */
227   bfd *dynobj;
228   /* The number of symbols found in the link which must be put into
229      the .dynsym section.  */
230   bfd_size_type dynsymcount;
231   /* The string table of dynamic symbols, which becomes the .dynstr
232      section.  */
233   struct bfd_strtab_hash *dynstr;
234   /* The number of buckets in the hash table in the .hash section.
235      This is based on the number of dynamic symbols.  */
236   bfd_size_type bucketcount;
237   /* A linked list of DT_NEEDED names found in dynamic objects
238      included in the link.  */
239   struct bfd_link_needed_list *needed;
240   /* The _GLOBAL_OFFSET_TABLE_ symbol.  */
241   struct elf_link_hash_entry *hgot;
242   /* A pointer to information used to link stabs in sections.  */
243   PTR stab_info;
244   /* A linked list of local symbols to be added to .dynsym.  */
245   struct elf_link_local_dynamic_entry *dynlocal;
246
247   void (*copy_indirect) PARAMS ((struct elf_link_hash_table *,
248                                  struct elf_link_hash_entry *,
249                                  struct elf_link_hash_entry *));
250   void (*hide_symbol) PARAMS ((struct elf_link_hash_table *,
251                                struct elf_link_hash_entry *));
252 };
253
254 /* Look up an entry in an ELF linker hash table.  */
255
256 #define elf_link_hash_lookup(table, string, create, copy, follow)       \
257   ((struct elf_link_hash_entry *)                                       \
258    bfd_link_hash_lookup (&(table)->root, (string), (create),            \
259                          (copy), (follow)))
260
261 /* Traverse an ELF linker hash table.  */
262
263 #define elf_link_hash_traverse(table, func, info)                       \
264   (bfd_link_hash_traverse                                               \
265    (&(table)->root,                                                     \
266     (boolean (*) PARAMS ((struct bfd_link_hash_entry *, PTR))) (func),  \
267     (info)))
268
269 /* Get the ELF linker hash table from a link_info structure.  */
270
271 #define elf_hash_table(p) ((struct elf_link_hash_table *) ((p)->hash))
272
273 /* Call the copy_indirect method.  */
274
275 #define elf_link_hash_copy_indirect(TABLE,DIR,IND) \
276   ((*(TABLE)->copy_indirect) ((TABLE), (DIR), (IND)))
277
278 /* Call the hide_symbol method.  */
279
280 #define elf_link_hash_hide_symbol(TABLE,SYM) \
281   ((*(TABLE)->hide_symbol) ((TABLE), (SYM)))
282 \f
283 /* Constant information held for an ELF backend.  */
284
285 struct elf_size_info {
286   unsigned char sizeof_ehdr, sizeof_phdr, sizeof_shdr;
287   unsigned char sizeof_rel, sizeof_rela, sizeof_sym, sizeof_dyn, sizeof_note;
288
289   /* The size of entries in the .hash section.  */
290   unsigned char sizeof_hash_entry;
291
292   /* The number of internal relocations to allocate per external
293      relocation entry.  */
294   unsigned char int_rels_per_ext_rel;
295
296   unsigned char arch_size, file_align;
297   unsigned char elfclass, ev_current;
298   int (*write_out_phdrs) PARAMS ((bfd *, const Elf_Internal_Phdr *, int));
299   boolean (*write_shdrs_and_ehdr) PARAMS ((bfd *));
300   void (*write_relocs) PARAMS ((bfd *, asection *, PTR));
301   void (*swap_symbol_out) PARAMS ((bfd *, const Elf_Internal_Sym *, PTR));
302   boolean (*slurp_reloc_table)
303     PARAMS ((bfd *, asection *, asymbol **, boolean));
304   long (*slurp_symbol_table) PARAMS ((bfd *, asymbol **, boolean));
305   void (*swap_dyn_in) PARAMS ((bfd *, const PTR, Elf_Internal_Dyn *));
306   void (*swap_dyn_out) PARAMS ((bfd *, const Elf_Internal_Dyn *, PTR));
307
308   /* This function, if defined, is called to swap in a REL
309      relocation.  If an external relocation corresponds to more than
310      one internal relocation, then all relocations are swapped in at
311      once.  */
312   void (*swap_reloc_in)
313     PARAMS ((bfd *, const bfd_byte *, Elf_Internal_Rel *));
314
315   /* This function, if defined, is called to swap out a REL
316      relocation.  */
317   void (*swap_reloc_out)
318     PARAMS ((bfd *, const Elf_Internal_Rel *, bfd_byte *));
319
320   /* This function, if defined, is called to swap in a RELA
321      relocation.  If an external relocation corresponds to more than
322      one internal relocation, then all relocations are swapped in at
323      once.  */
324   void (*swap_reloca_in)
325     PARAMS ((bfd *, const bfd_byte *, Elf_Internal_Rela *));
326
327   /* This function, if defined, is called to swap out a RELA
328      relocation.  */
329   void (*swap_reloca_out)
330     PARAMS ((bfd *, const Elf_Internal_Rela *, bfd_byte *));
331
332 };
333
334 #define elf_symbol_from(ABFD,S) \
335         (((S)->the_bfd->xvec->flavour == bfd_target_elf_flavour \
336           && (S)->the_bfd->tdata.elf_obj_data != 0) \
337          ? (elf_symbol_type *) (S) \
338          : 0)
339
340 struct elf_backend_data
341 {
342   /* The architecture for this backend.  */
343   enum bfd_architecture arch;
344
345   /* The ELF machine code (EM_xxxx) for this backend.  */
346   int elf_machine_code;
347
348   /* The maximum page size for this backend.  */
349   bfd_vma maxpagesize;
350
351   /* A function to translate an ELF RELA relocation to a BFD arelent
352      structure.  */
353   void (*elf_info_to_howto) PARAMS ((bfd *, arelent *,
354                                      Elf_Internal_Rela *));
355
356   /* A function to translate an ELF REL relocation to a BFD arelent
357      structure.  */
358   void (*elf_info_to_howto_rel) PARAMS ((bfd *, arelent *,
359                                          Elf_Internal_Rel *));
360
361   /* A function to determine whether a symbol is global when
362      partitioning the symbol table into local and global symbols.
363      This should be NULL for most targets, in which case the correct
364      thing will be done.  MIPS ELF, at least on the Irix 5, has
365      special requirements.  */
366   boolean (*elf_backend_sym_is_global) PARAMS ((bfd *, asymbol *));
367
368   /* The remaining functions are hooks which are called only if they
369      are not NULL.  */
370
371   /* A function to permit a backend specific check on whether a
372      particular BFD format is relevant for an object file, and to
373      permit the backend to set any global information it wishes.  When
374      this is called elf_elfheader is set, but anything else should be
375      used with caution.  If this returns false, the check_format
376      routine will return a bfd_error_wrong_format error.  */
377   boolean (*elf_backend_object_p) PARAMS ((bfd *));
378
379   /* A function to do additional symbol processing when reading the
380      ELF symbol table.  This is where any processor-specific special
381      section indices are handled.  */
382   void (*elf_backend_symbol_processing) PARAMS ((bfd *, asymbol *));
383
384   /* A function to do additional symbol processing after reading the
385      entire ELF symbol table.  */
386   boolean (*elf_backend_symbol_table_processing) PARAMS ((bfd *,
387                                                           elf_symbol_type *,
388                                                           unsigned int));
389
390    /* A function to set the type of the info field.  Processor-specific
391      types should be handled here. */
392   int (*elf_backend_get_symbol_type) PARAMS (( Elf_Internal_Sym *, int)); 
393  
394   /* A function to do additional processing on the ELF section header
395      just before writing it out.  This is used to set the flags and
396      type fields for some sections, or to actually write out data for
397      unusual sections.  */
398   boolean (*elf_backend_section_processing) PARAMS ((bfd *,
399                                                      Elf32_Internal_Shdr *));
400
401   /* A function to handle unusual section types when creating BFD
402      sections from ELF sections.  */
403   boolean (*elf_backend_section_from_shdr) PARAMS ((bfd *,
404                                                     Elf32_Internal_Shdr *,
405                                                     char *));
406
407   /* A function to handle unusual program segment types when creating BFD
408      sections from ELF program segments. */
409   boolean (*elf_backend_section_from_phdr) PARAMS ((bfd *,
410                                                     Elf32_Internal_Phdr *,
411                                                     int));
412
413   /* A function to set up the ELF section header for a BFD section in
414      preparation for writing it out.  This is where the flags and type
415      fields are set for unusual sections.  */
416   boolean (*elf_backend_fake_sections) PARAMS ((bfd *, Elf32_Internal_Shdr *,
417                                                 asection *));
418
419   /* A function to get the ELF section index for a BFD section.  If
420      this returns true, the section was found.  If it is a normal ELF
421      section, *RETVAL should be left unchanged.  If it is not a normal
422      ELF section *RETVAL should be set to the SHN_xxxx index.  */
423   boolean (*elf_backend_section_from_bfd_section)
424     PARAMS ((bfd *, Elf32_Internal_Shdr *, asection *, int *retval));
425
426   /* If this field is not NULL, it is called by the add_symbols phase
427      of a link just before adding a symbol to the global linker hash
428      table.  It may modify any of the fields as it wishes.  If *NAME
429      is set to NULL, the symbol will be skipped rather than being
430      added to the hash table.  This function is responsible for
431      handling all processor dependent symbol bindings and section
432      indices, and must set at least *FLAGS and *SEC for each processor
433      dependent case; failure to do so will cause a link error.  */
434   boolean (*elf_add_symbol_hook)
435     PARAMS ((bfd *abfd, struct bfd_link_info *info,
436              const Elf_Internal_Sym *, const char **name,
437              flagword *flags, asection **sec, bfd_vma *value));
438
439   /* If this field is not NULL, it is called by the elf_link_output_sym
440      phase of a link for each symbol which will appear in the object file.  */
441   boolean (*elf_backend_link_output_symbol_hook)
442     PARAMS ((bfd *, struct bfd_link_info *info, const char *,
443              Elf_Internal_Sym *, asection *));
444
445   /* The CREATE_DYNAMIC_SECTIONS function is called by the ELF backend
446      linker the first time it encounters a dynamic object in the link.
447      This function must create any sections required for dynamic
448      linking.  The ABFD argument is a dynamic object.  The .interp,
449      .dynamic, .dynsym, .dynstr, and .hash functions have already been
450      created, and this function may modify the section flags if
451      desired.  This function will normally create the .got and .plt
452      sections, but different backends have different requirements.  */
453   boolean (*elf_backend_create_dynamic_sections)
454     PARAMS ((bfd *abfd, struct bfd_link_info *info));
455
456   /* The CHECK_RELOCS function is called by the add_symbols phase of
457      the ELF backend linker.  It is called once for each section with
458      relocs of an object file, just after the symbols for the object
459      file have been added to the global linker hash table.  The
460      function must look through the relocs and do any special handling
461      required.  This generally means allocating space in the global
462      offset table, and perhaps allocating space for a reloc.  The
463      relocs are always passed as Rela structures; if the section
464      actually uses Rel structures, the r_addend field will always be
465      zero.  */
466   boolean (*check_relocs)
467     PARAMS ((bfd *abfd, struct bfd_link_info *info, asection *o,
468              const Elf_Internal_Rela *relocs));
469
470   /* The ADJUST_DYNAMIC_SYMBOL function is called by the ELF backend
471      linker for every symbol which is defined by a dynamic object and
472      referenced by a regular object.  This is called after all the
473      input files have been seen, but before the SIZE_DYNAMIC_SECTIONS
474      function has been called.  The hash table entry should be
475      bfd_link_hash_defined ore bfd_link_hash_defweak, and it should be
476      defined in a section from a dynamic object.  Dynamic object
477      sections are not included in the final link, and this function is
478      responsible for changing the value to something which the rest of
479      the link can deal with.  This will normally involve adding an
480      entry to the .plt or .got or some such section, and setting the
481      symbol to point to that.  */
482   boolean (*elf_backend_adjust_dynamic_symbol)
483     PARAMS ((struct bfd_link_info *info, struct elf_link_hash_entry *h));
484
485   /* The ALWAYS_SIZE_SECTIONS function is called by the backend linker
486      after all the linker input files have been seen but before the
487      section sizes have been set.  This is called after
488      ADJUST_DYNAMIC_SYMBOL, but before SIZE_DYNAMIC_SECTIONS.  */
489   boolean (*elf_backend_always_size_sections)
490     PARAMS ((bfd *output_bfd, struct bfd_link_info *info));
491
492   /* The SIZE_DYNAMIC_SECTIONS function is called by the ELF backend
493      linker after all the linker input files have been seen but before
494      the sections sizes have been set.  This is called after
495      ADJUST_DYNAMIC_SYMBOL has been called on all appropriate symbols.
496      It is only called when linking against a dynamic object.  It must
497      set the sizes of the dynamic sections, and may fill in their
498      contents as well.  The generic ELF linker can handle the .dynsym,
499      .dynstr and .hash sections.  This function must handle the
500      .interp section and any sections created by the
501      CREATE_DYNAMIC_SECTIONS entry point.  */
502   boolean (*elf_backend_size_dynamic_sections)
503     PARAMS ((bfd *output_bfd, struct bfd_link_info *info));
504
505   /* The RELOCATE_SECTION function is called by the ELF backend linker
506      to handle the relocations for a section.
507
508      The relocs are always passed as Rela structures; if the section
509      actually uses Rel structures, the r_addend field will always be
510      zero.
511
512      This function is responsible for adjust the section contents as
513      necessary, and (if using Rela relocs and generating a
514      relocateable output file) adjusting the reloc addend as
515      necessary.
516
517      This function does not have to worry about setting the reloc
518      address or the reloc symbol index.
519
520      LOCAL_SYMS is a pointer to the swapped in local symbols.
521
522      LOCAL_SECTIONS is an array giving the section in the input file
523      corresponding to the st_shndx field of each local symbol.
524
525      The global hash table entry for the global symbols can be found
526      via elf_sym_hashes (input_bfd).
527
528      When generating relocateable output, this function must handle
529      STB_LOCAL/STT_SECTION symbols specially.  The output symbol is
530      going to be the section symbol corresponding to the output
531      section, which means that the addend must be adjusted
532      accordingly.  */
533   boolean (*elf_backend_relocate_section)
534     PARAMS ((bfd *output_bfd, struct bfd_link_info *info,
535              bfd *input_bfd, asection *input_section, bfd_byte *contents,
536              Elf_Internal_Rela *relocs, Elf_Internal_Sym *local_syms,
537              asection **local_sections));
538
539   /* The FINISH_DYNAMIC_SYMBOL function is called by the ELF backend
540      linker just before it writes a symbol out to the .dynsym section.
541      The processor backend may make any required adjustment to the
542      symbol.  It may also take the opportunity to set contents of the
543      dynamic sections.  Note that FINISH_DYNAMIC_SYMBOL is called on
544      all .dynsym symbols, while ADJUST_DYNAMIC_SYMBOL is only called
545      on those symbols which are defined by a dynamic object.  */
546   boolean (*elf_backend_finish_dynamic_symbol)
547     PARAMS ((bfd *output_bfd, struct bfd_link_info *info,
548              struct elf_link_hash_entry *h, Elf_Internal_Sym *sym));
549
550   /* The FINISH_DYNAMIC_SECTIONS function is called by the ELF backend
551      linker just before it writes all the dynamic sections out to the
552      output file.  The FINISH_DYNAMIC_SYMBOL will have been called on
553      all dynamic symbols.  */
554   boolean (*elf_backend_finish_dynamic_sections)
555     PARAMS ((bfd *output_bfd, struct bfd_link_info *info));
556
557   /* A function to do any beginning processing needed for the ELF file
558      before building the ELF headers and computing file positions.  */
559   void (*elf_backend_begin_write_processing)
560     PARAMS ((bfd *, struct bfd_link_info *));
561
562   /* A function to do any final processing needed for the ELF file
563      before writing it out.  The LINKER argument is true if this BFD
564      was created by the ELF backend linker.  */
565   void (*elf_backend_final_write_processing)
566     PARAMS ((bfd *, boolean linker));
567
568   /* This function is called by get_program_header_size.  It should
569      return the number of additional program segments which this BFD
570      will need.  It should return -1 on error.  */
571   int (*elf_backend_additional_program_headers) PARAMS ((bfd *));
572
573   /* This function is called to modify an existing segment map in a
574      backend specific fashion.  */
575   boolean (*elf_backend_modify_segment_map) PARAMS ((bfd *));
576
577   /* This function is called during section gc to discover the section a
578      particular relocation refers to.  It need not be defined for hosts
579      that have no queer relocation types.  */
580   asection * (*gc_mark_hook)
581     PARAMS ((bfd *abfd, struct bfd_link_info *, Elf_Internal_Rela *,
582              struct elf_link_hash_entry *h, Elf_Internal_Sym *));
583
584   /* This function, if defined, is called during the sweep phase of gc
585      in order that a backend might update any data structures it might
586      be maintaining.  */
587   boolean (*gc_sweep_hook)
588     PARAMS ((bfd *abfd, struct bfd_link_info *info, asection *o,
589              const Elf_Internal_Rela *relocs));
590
591   /* This function, if defined, is called after the ELF headers have
592      been created.  This allows for things like the OS and ABI versions
593      to be changed.  */
594   void (*elf_backend_post_process_headers)
595     PARAMS ((bfd *, struct bfd_link_info *));
596
597   /* This function, if defined, prints a symbol to file and returns the
598      name of the symbol to be printed.  It should return NULL to fall
599      back to default symbol printing.  */
600   const char *(*elf_backend_print_symbol_all)
601     PARAMS ((bfd *, PTR, asymbol *));
602
603   /* This function, if defined, is called after all local symbols and
604      global symbols converted to locals are emited into the symtab
605      section.  It allows the backend to emit special global symbols
606      not handled in the hash table.  */
607   boolean (*elf_backend_output_arch_syms)
608     PARAMS ((bfd *, struct bfd_link_info *, PTR,
609             boolean (*) PARAMS ((PTR, const char *,
610              Elf_Internal_Sym *, asection *))));
611
612   /* The swapping table to use when dealing with ECOFF information.
613      Used for the MIPS ELF .mdebug section.  */
614   const struct ecoff_debug_swap *elf_backend_ecoff_debug_swap;
615
616   /* Alternate EM_xxxx machine codes for this backend.  */
617   int elf_machine_alt1;
618   int elf_machine_alt2;
619
620   const struct elf_size_info *s;
621
622   /* offset of the _GLOBAL_OFFSET_TABLE_ symbol from the start of the
623      .got section */
624   bfd_vma got_symbol_offset;
625
626   /* The size in bytes of the headers for the GOT and PLT.  This includes
627      the so-called reserved entries on some systems.  */
628   bfd_vma got_header_size;
629   bfd_vma plt_header_size;
630
631   /* This is true if the linker should act like collect and gather
632      global constructors and destructors by name.  This is true for
633      MIPS ELF because the Irix 5 tools can not handle the .init
634      section.  */
635   unsigned collect : 1;
636
637   /* This is true if the linker should ignore changes to the type of a
638      symbol.  This is true for MIPS ELF because some Irix 5 objects
639      record undefined functions as STT_OBJECT although the definitions
640      are STT_FUNC.  */
641   unsigned type_change_ok : 1;
642
643   /* Whether the backend may use REL relocations.  (Some backends use
644      both REL and RELA relocations, and this flag is set for those
645      backends.)  */
646   unsigned may_use_rel_p : 1;
647     
648   /* Whether the backend may use RELA relocations.  (Some backends use
649      both REL and RELA relocations, and this flag is set for those
650      backends.)  */
651   unsigned may_use_rela_p : 1;
652
653   /* Whether the default relocation type is RELA.  If a backend with
654      this flag set wants REL relocations for a particular section,
655      it must note that explicitly.  Similarly, if this flag is clear,
656      and the backend wants RELA relocations for a particular 
657      section.  */   
658   unsigned default_use_rela_p : 1;
659
660   /* True if addresses "naturally" sign extend.  This is used when
661      swapping in from Elf32 when BFD64.  */
662   unsigned sign_extend_vma : 1;
663
664   unsigned want_got_plt : 1;
665   unsigned plt_readonly : 1;
666   unsigned want_plt_sym : 1;
667   unsigned plt_not_loaded : 1;
668   unsigned plt_alignment : 4;
669   unsigned can_gc_sections : 1;
670   unsigned want_dynbss : 1;
671 };
672
673 /* Information stored for each BFD section in an ELF file.  This
674    structure is allocated by elf_new_section_hook.  */
675
676 struct bfd_elf_section_data
677 {
678   /* The ELF header for this section.  */
679   Elf_Internal_Shdr this_hdr;
680   /* The ELF header for the reloc section associated with this
681      section, if any.  */
682   Elf_Internal_Shdr rel_hdr;
683   /* If there is a second reloc section associated with this section,
684      as can happen on Irix 6, this field points to the header.  */
685   Elf_Internal_Shdr *rel_hdr2;
686   /* The number of relocations currently assigned to REL_HDR.  */
687   unsigned int rel_count;
688   /* The number of relocations currently assigned to REL_HDR2.  */
689   unsigned int rel_count2;
690   /* The ELF section number of this section.  Only used for an output
691      file.  */
692   int this_idx;
693   /* The ELF section number of the reloc section indicated by
694      REL_HDR if any.  Only used for an output file.  */
695   int rel_idx;
696   /* The ELF section number of the reloc section indicated by
697      REL_HDR2 if any.  Only used for an output file.  */
698   int rel_idx2;
699   /* Used by the backend linker to store the symbol hash table entries
700      associated with relocs against global symbols.  */
701   struct elf_link_hash_entry **rel_hashes;
702   /* A pointer to the swapped relocs.  If the section uses REL relocs,
703      rather than RELA, all the r_addend fields will be zero.  This
704      pointer may be NULL.  It is used by the backend linker.  */
705   Elf_Internal_Rela *relocs;
706   /* Used by the backend linker when generating a shared library to
707      record the dynamic symbol index for a section symbol
708      corresponding to this section.  A value of 0 means that there is
709      no dynamic symbol for this section.  */
710   long dynindx;
711   /* A pointer used for .stab linking optimizations.  */
712   PTR stab_info;
713   /* A pointer available for the processor specific ELF backend.  */
714   PTR tdata;
715   /* Nonzero if this section uses RELA relocations, rather than REL.  */
716   unsigned int use_rela_p:1;
717 };
718
719 #define elf_section_data(sec)  ((struct bfd_elf_section_data*)sec->used_by_bfd)
720
721 #define get_elf_backend_data(abfd) \
722   ((struct elf_backend_data *) (abfd)->xvec->backend_data)
723
724 /* Enumeration to specify the special section.  */
725 typedef enum elf_linker_section_enum
726 {
727   LINKER_SECTION_UNKNOWN,               /* not used */
728   LINKER_SECTION_GOT,                   /* .got section for global offset pointers */
729   LINKER_SECTION_PLT,                   /* .plt section for generated procedure stubs */
730   LINKER_SECTION_SDATA,                 /* .sdata/.sbss section for PowerPC */
731   LINKER_SECTION_SDATA2,                /* .sdata2/.sbss2 section for PowerPC */
732   LINKER_SECTION_MAX                    /* # of linker sections */
733 } elf_linker_section_enum_t;
734
735 /* Sections created by the linker.  */
736
737 typedef struct elf_linker_section
738 {
739   char *name;                           /* name of the section */
740   char *rel_name;                       /* name of the associated .rel{,a}. section */
741   char *bss_name;                       /* name of a related .bss section */
742   char *sym_name;                       /* name of symbol to reference this section */
743   asection *section;                    /* pointer to the section */
744   asection *bss_section;                /* pointer to the bss section associated with this */
745   asection *rel_section;                /* pointer to the relocations needed for this section */
746   struct elf_link_hash_entry *sym_hash; /* pointer to the created symbol hash value */
747   bfd_vma initial_size;                 /* initial size before any linker generated allocations */
748   bfd_vma sym_offset;                   /* offset of symbol from beginning of section */
749   bfd_vma hole_size;                    /* size of reserved address hole in allocation */
750   bfd_vma hole_offset;                  /* current offset for the hole */
751   bfd_vma max_hole_offset;              /* maximum offset for the hole */
752   elf_linker_section_enum_t which;      /* which section this is */
753   boolean hole_written_p;               /* whether the hole has been initialized */
754   unsigned int alignment;               /* alignment for the section */
755   flagword flags;                       /* flags to use to create the section */
756 } elf_linker_section_t;
757
758 /* Linked list of allocated pointer entries.  This hangs off of the symbol lists, and
759    provides allows us to return different pointers, based on different addend's.  */
760
761 typedef struct elf_linker_section_pointers
762 {
763   struct elf_linker_section_pointers *next;     /* next allocated pointer for this symbol */
764   bfd_vma offset;                               /* offset of pointer from beginning of section */
765   bfd_signed_vma addend;                        /* addend used */
766   elf_linker_section_enum_t which;              /* which linker section this is */
767   boolean written_address_p;                    /* whether address was written yet */
768 } elf_linker_section_pointers_t;
769
770 /* Some private data is stashed away for future use using the tdata pointer
771    in the bfd structure.  */
772
773 struct elf_obj_tdata
774 {
775   Elf_Internal_Ehdr elf_header[1];      /* Actual data, but ref like ptr */
776   Elf_Internal_Shdr **elf_sect_ptr;
777   Elf_Internal_Phdr *phdr;
778   struct elf_segment_map *segment_map;
779   struct bfd_strtab_hash *strtab_ptr;
780   int num_locals;
781   int num_globals;
782   asymbol **section_syms;               /* STT_SECTION symbols for each section */
783   Elf_Internal_Shdr symtab_hdr;
784   Elf_Internal_Shdr shstrtab_hdr;
785   Elf_Internal_Shdr strtab_hdr;
786   Elf_Internal_Shdr dynsymtab_hdr;
787   Elf_Internal_Shdr dynstrtab_hdr;
788   Elf_Internal_Shdr dynversym_hdr;
789   Elf_Internal_Shdr dynverref_hdr;
790   Elf_Internal_Shdr dynverdef_hdr;
791   unsigned int symtab_section, shstrtab_section;
792   unsigned int strtab_section, dynsymtab_section;
793   unsigned int dynversym_section, dynverdef_section, dynverref_section;
794   file_ptr next_file_pos;
795 #if 0
796   /* we don't need these inside bfd anymore, and I think
797      these weren't used outside bfd. */
798   void *prstatus;                       /* The raw /proc prstatus structure */
799   void *prpsinfo;                       /* The raw /proc prpsinfo structure */
800 #endif
801   bfd_vma gp;                           /* The gp value (MIPS only, for now) */
802   unsigned int gp_size;                 /* The gp size (MIPS only, for now) */
803
804   /* Information grabbed from an elf core file. */
805   int core_signal;
806   int core_pid;
807   int core_lwpid;
808   char* core_program;
809   char* core_command;
810
811   /* This is set to true if the object was created by the backend
812      linker.  */
813   boolean linker;
814
815   /* A mapping from external symbols to entries in the linker hash
816      table, used when linking.  This is indexed by the symbol index
817      minus the sh_info field of the symbol table header.  */
818   struct elf_link_hash_entry **sym_hashes;
819
820   /* A mapping from local symbols to offsets into the global offset
821      table, used when linking.  This is indexed by the symbol index.
822      Like for the globals, we use a union and two names primarily to
823      document the intent of any particular piece of code.  The field
824      should be used as a count until size_dynamic_sections, at which
825      point the contents of the .got is fixed.  Afterward, if an entry
826      is -1, then the symbol does not require a global offset table entry. */
827   union
828     {
829       bfd_signed_vma *refcounts;
830       bfd_vma *offsets;
831     } local_got;
832
833   /* A mapping from local symbols to offsets into the various linker
834      sections added.  This is index by the symbol index.  */
835   elf_linker_section_pointers_t **linker_section_pointers;
836
837   /* The linker ELF emulation code needs to let the backend ELF linker
838      know what filename should be used for a dynamic object if the
839      dynamic object is found using a search.  The emulation code then
840      sometimes needs to know what name was actually used.  Until the
841      file has been added to the linker symbol table, this field holds
842      the name the linker wants.  After it has been added, it holds the
843      name actually used, which will be the DT_SONAME entry if there is
844      one.  */
845   const char *dt_name;
846
847   /* Irix 5 often screws up the symbol table, sorting local symbols
848      after global symbols.  This flag is set if the symbol table in
849      this BFD appears to be screwed up.  If it is, we ignore the
850      sh_info field in the symbol table header, and always read all the
851      symbols.  */
852   boolean bad_symtab;
853
854   /* Records the result of `get_program_header_size'.  */
855   bfd_size_type program_header_size;
856
857   /* Used by find_nearest_line entry point.  */
858   PTR line_info;
859
860   /* Used by MIPS ELF find_nearest_line entry point.  The structure
861      could be included directly in this one, but there's no point to
862      wasting the memory just for the infrequently called
863      find_nearest_line.  */
864   struct mips_elf_find_line *find_line_info;
865
866   /* A place to stash dwarf1 info for this bfd. */
867   struct dwarf1_debug *dwarf1_find_line_info;
868
869   /* A place to stash dwarf2 info for this bfd. */
870   struct dwarf2_debug *dwarf2_find_line_info;
871
872   /* An array of stub sections indexed by symbol number, used by the
873      MIPS ELF linker.  FIXME: We should figure out some way to only
874      include this field for a MIPS ELF target.  */
875   asection **local_stubs;
876
877   /* Used to determine if the e_flags field has been initialized */
878   boolean flags_init;
879
880   /* Number of symbol version definitions we are about to emit.  */
881   unsigned int cverdefs;
882
883   /* Number of symbol version references we are about to emit.  */
884   unsigned int cverrefs;
885
886   /* Symbol version definitions in external objects.  */
887   Elf_Internal_Verdef *verdef;
888
889   /* Symbol version references to external objects.  */
890   Elf_Internal_Verneed *verref;
891
892   /* Linker sections that we are interested in.  */
893   struct elf_linker_section *linker_section[ (int)LINKER_SECTION_MAX ];
894 };
895
896 #define elf_tdata(bfd)          ((bfd) -> tdata.elf_obj_data)
897 #define elf_elfheader(bfd)      (elf_tdata(bfd) -> elf_header)
898 #define elf_elfsections(bfd)    (elf_tdata(bfd) -> elf_sect_ptr)
899 #define elf_shstrtab(bfd)       (elf_tdata(bfd) -> strtab_ptr)
900 #define elf_onesymtab(bfd)      (elf_tdata(bfd) -> symtab_section)
901 #define elf_dynsymtab(bfd)      (elf_tdata(bfd) -> dynsymtab_section)
902 #define elf_dynversym(bfd)      (elf_tdata(bfd) -> dynversym_section)
903 #define elf_dynverdef(bfd)      (elf_tdata(bfd) -> dynverdef_section)
904 #define elf_dynverref(bfd)      (elf_tdata(bfd) -> dynverref_section)
905 #define elf_num_locals(bfd)     (elf_tdata(bfd) -> num_locals)
906 #define elf_num_globals(bfd)    (elf_tdata(bfd) -> num_globals)
907 #define elf_section_syms(bfd)   (elf_tdata(bfd) -> section_syms)
908 #define core_prpsinfo(bfd)      (elf_tdata(bfd) -> prpsinfo)
909 #define core_prstatus(bfd)      (elf_tdata(bfd) -> prstatus)
910 #define elf_gp(bfd)             (elf_tdata(bfd) -> gp)
911 #define elf_gp_size(bfd)        (elf_tdata(bfd) -> gp_size)
912 #define elf_sym_hashes(bfd)     (elf_tdata(bfd) -> sym_hashes)
913 #define elf_local_got_refcounts(bfd) (elf_tdata(bfd) -> local_got.refcounts)
914 #define elf_local_got_offsets(bfd) (elf_tdata(bfd) -> local_got.offsets)
915 #define elf_local_ptr_offsets(bfd) (elf_tdata(bfd) -> linker_section_pointers)
916 #define elf_dt_name(bfd)        (elf_tdata(bfd) -> dt_name)
917 #define elf_bad_symtab(bfd)     (elf_tdata(bfd) -> bad_symtab)
918 #define elf_flags_init(bfd)     (elf_tdata(bfd) -> flags_init)
919 #define elf_linker_section(bfd,n) (elf_tdata(bfd) -> linker_section[(int)n])
920 \f
921 extern void _bfd_elf_swap_verdef_in
922   PARAMS ((bfd *, const Elf_External_Verdef *, Elf_Internal_Verdef *));
923 extern void _bfd_elf_swap_verdef_out
924   PARAMS ((bfd *, const Elf_Internal_Verdef *, Elf_External_Verdef *));
925 extern void _bfd_elf_swap_verdaux_in
926   PARAMS ((bfd *, const Elf_External_Verdaux *, Elf_Internal_Verdaux *));
927 extern void _bfd_elf_swap_verdaux_out
928   PARAMS ((bfd *, const Elf_Internal_Verdaux *, Elf_External_Verdaux *));
929 extern void _bfd_elf_swap_verneed_in
930   PARAMS ((bfd *, const Elf_External_Verneed *, Elf_Internal_Verneed *));
931 extern void _bfd_elf_swap_verneed_out
932   PARAMS ((bfd *, const Elf_Internal_Verneed *, Elf_External_Verneed *));
933 extern void _bfd_elf_swap_vernaux_in
934   PARAMS ((bfd *, const Elf_External_Vernaux *, Elf_Internal_Vernaux *));
935 extern void _bfd_elf_swap_vernaux_out
936   PARAMS ((bfd *, const Elf_Internal_Vernaux *, Elf_External_Vernaux *));
937 extern void _bfd_elf_swap_versym_in
938   PARAMS ((bfd *, const Elf_External_Versym *, Elf_Internal_Versym *));
939 extern void _bfd_elf_swap_versym_out
940   PARAMS ((bfd *, const Elf_Internal_Versym *, Elf_External_Versym *));
941
942 extern int _bfd_elf_section_from_bfd_section PARAMS ((bfd *, asection *));
943 extern char *bfd_elf_string_from_elf_section
944   PARAMS ((bfd *, unsigned, unsigned));
945 extern char *bfd_elf_get_str_section PARAMS ((bfd *, unsigned));
946
947 extern boolean _bfd_elf_print_private_bfd_data PARAMS ((bfd *, PTR));
948 extern void bfd_elf_print_symbol PARAMS ((bfd *, PTR, asymbol *,
949                                           bfd_print_symbol_type));
950 #define elf_string_from_elf_strtab(abfd,strindex) \
951      bfd_elf_string_from_elf_section(abfd,elf_elfheader(abfd)->e_shstrndx,strindex)
952
953 #define bfd_elf32_print_symbol  bfd_elf_print_symbol
954 #define bfd_elf64_print_symbol  bfd_elf_print_symbol
955
956 extern unsigned long bfd_elf_hash PARAMS ((const char *));
957
958 extern bfd_reloc_status_type bfd_elf_generic_reloc PARAMS ((bfd *,
959                                                             arelent *,
960                                                             asymbol *,
961                                                             PTR,
962                                                             asection *,
963                                                             bfd *,
964                                                             char **));
965 extern boolean bfd_elf_mkobject PARAMS ((bfd *));
966 extern boolean bfd_elf_mkcorefile PARAMS ((bfd *));
967 extern Elf_Internal_Shdr *bfd_elf_find_section PARAMS ((bfd *, char *));
968 extern boolean _bfd_elf_make_section_from_shdr
969   PARAMS ((bfd *abfd, Elf_Internal_Shdr *hdr, const char *name));
970 extern boolean _bfd_elf_make_section_from_phdr
971   PARAMS ((bfd *abfd, Elf_Internal_Phdr *hdr, int index, const char *typename));
972 extern struct bfd_hash_entry *_bfd_elf_link_hash_newfunc
973   PARAMS ((struct bfd_hash_entry *, struct bfd_hash_table *, const char *));
974 extern struct bfd_link_hash_table *_bfd_elf_link_hash_table_create
975   PARAMS ((bfd *));
976 extern boolean _bfd_elf_link_hash_table_init
977   PARAMS ((struct elf_link_hash_table *, bfd *,
978            struct bfd_hash_entry *(*) (struct bfd_hash_entry *,
979                                        struct bfd_hash_table *,
980                                        const char *)));
981 extern boolean _bfd_elf_slurp_version_tables PARAMS ((bfd *));
982
983 extern boolean _bfd_elf_copy_private_symbol_data
984   PARAMS ((bfd *, asymbol *, bfd *, asymbol *));
985 extern boolean _bfd_elf_copy_private_section_data
986   PARAMS ((bfd *, asection *, bfd *, asection *));
987 extern boolean _bfd_elf_write_object_contents PARAMS ((bfd *));
988 extern boolean _bfd_elf_write_corefile_contents PARAMS ((bfd *));
989 extern boolean _bfd_elf_set_section_contents PARAMS ((bfd *, sec_ptr, PTR,
990                                                        file_ptr,
991                                                        bfd_size_type));
992 extern long _bfd_elf_get_symtab_upper_bound PARAMS ((bfd *));
993 extern long _bfd_elf_get_symtab PARAMS ((bfd *, asymbol **));
994 extern long _bfd_elf_get_dynamic_symtab_upper_bound PARAMS ((bfd *));
995 extern long _bfd_elf_canonicalize_dynamic_symtab PARAMS ((bfd *, asymbol **));
996 extern long _bfd_elf_get_reloc_upper_bound PARAMS ((bfd *, sec_ptr));
997 extern long _bfd_elf_canonicalize_reloc PARAMS ((bfd *, sec_ptr,
998                                                   arelent **, asymbol **));
999 extern long _bfd_elf_get_dynamic_reloc_upper_bound PARAMS ((bfd *));
1000 extern long _bfd_elf_canonicalize_dynamic_reloc PARAMS ((bfd *, arelent **,
1001                                                          asymbol **));
1002 extern asymbol *_bfd_elf_make_empty_symbol PARAMS ((bfd *));
1003 extern void _bfd_elf_get_symbol_info PARAMS ((bfd *, asymbol *,
1004                                                symbol_info *));
1005 extern boolean _bfd_elf_is_local_label_name PARAMS ((bfd *, const char *));
1006 extern alent *_bfd_elf_get_lineno PARAMS ((bfd *, asymbol *));
1007 extern boolean _bfd_elf_set_arch_mach PARAMS ((bfd *, enum bfd_architecture,
1008                                                 unsigned long));
1009 extern boolean _bfd_elf_find_nearest_line PARAMS ((bfd *, asection *,
1010                                                     asymbol **,
1011                                                     bfd_vma, CONST char **,
1012                                                     CONST char **,
1013                                                     unsigned int *));
1014 #define _bfd_elf_read_minisymbols _bfd_generic_read_minisymbols
1015 #define _bfd_elf_minisymbol_to_symbol _bfd_generic_minisymbol_to_symbol
1016 extern int _bfd_elf_sizeof_headers PARAMS ((bfd *, boolean));
1017 extern boolean _bfd_elf_new_section_hook PARAMS ((bfd *, asection *));
1018 extern boolean _bfd_elf_init_reloc_shdr 
1019   PARAMS ((bfd *, Elf_Internal_Shdr *, asection *, boolean));
1020
1021 /* If the target doesn't have reloc handling written yet:  */
1022 extern void _bfd_elf_no_info_to_howto PARAMS ((bfd *, arelent *,
1023                                                Elf_Internal_Rela *));
1024
1025 extern boolean bfd_section_from_shdr PARAMS ((bfd *, unsigned int shindex));
1026 extern boolean bfd_section_from_phdr PARAMS ((bfd *, Elf_Internal_Phdr *, int));
1027
1028 extern int _bfd_elf_symbol_from_bfd_symbol PARAMS ((bfd *, asymbol **));
1029
1030 asection *bfd_section_from_elf_index PARAMS ((bfd *, unsigned int));
1031 boolean _bfd_elf_create_dynamic_sections PARAMS ((bfd *,
1032                                                   struct bfd_link_info *));
1033 struct bfd_strtab_hash *_bfd_elf_stringtab_init PARAMS ((void));
1034 boolean
1035 _bfd_elf_link_record_dynamic_symbol PARAMS ((struct bfd_link_info *,
1036                                              struct elf_link_hash_entry *));
1037 long
1038 _bfd_elf_link_lookup_local_dynindx PARAMS ((struct bfd_link_info *,
1039                                             bfd *, long));
1040 boolean
1041 _bfd_elf_compute_section_file_positions PARAMS ((bfd *,
1042                                                  struct bfd_link_info *));
1043 void _bfd_elf_assign_file_positions_for_relocs PARAMS ((bfd *));
1044 file_ptr _bfd_elf_assign_file_position_for_section PARAMS ((Elf_Internal_Shdr *,
1045                                                             file_ptr,
1046                                                             boolean));
1047
1048 extern boolean _bfd_elf_validate_reloc PARAMS ((bfd *, arelent *));
1049
1050 boolean _bfd_elf_create_dynamic_sections PARAMS ((bfd *,
1051                                                   struct bfd_link_info *));
1052 boolean _bfd_elf_create_got_section PARAMS ((bfd *,
1053                                              struct bfd_link_info *));
1054 unsigned long _bfd_elf_link_renumber_dynsyms PARAMS ((bfd *,
1055                                                       struct bfd_link_info *));
1056
1057 elf_linker_section_t *_bfd_elf_create_linker_section
1058   PARAMS ((bfd *abfd,
1059            struct bfd_link_info *info,
1060            enum elf_linker_section_enum,
1061            elf_linker_section_t *defaults));
1062
1063 elf_linker_section_pointers_t *_bfd_elf_find_pointer_linker_section
1064   PARAMS ((elf_linker_section_pointers_t *linker_pointers,
1065            bfd_signed_vma addend,
1066            elf_linker_section_enum_t which));
1067
1068 boolean bfd_elf32_create_pointer_linker_section
1069   PARAMS ((bfd *abfd,
1070            struct bfd_link_info *info,
1071            elf_linker_section_t *lsect,
1072            struct elf_link_hash_entry *h,
1073            const Elf32_Internal_Rela *rel));
1074
1075 bfd_vma bfd_elf32_finish_pointer_linker_section
1076   PARAMS ((bfd *output_abfd,
1077            bfd *input_bfd,
1078            struct bfd_link_info *info,
1079            elf_linker_section_t *lsect,
1080            struct elf_link_hash_entry *h,
1081            bfd_vma relocation,
1082            const Elf32_Internal_Rela *rel,
1083            int relative_reloc));
1084
1085 boolean bfd_elf64_create_pointer_linker_section
1086   PARAMS ((bfd *abfd,
1087            struct bfd_link_info *info,
1088            elf_linker_section_t *lsect,
1089            struct elf_link_hash_entry *h,
1090            const Elf64_Internal_Rela *rel));
1091
1092 bfd_vma bfd_elf64_finish_pointer_linker_section
1093   PARAMS ((bfd *output_abfd,
1094            bfd *input_bfd,
1095            struct bfd_link_info *info,
1096            elf_linker_section_t *lsect,
1097            struct elf_link_hash_entry *h,
1098            bfd_vma relocation,
1099            const Elf64_Internal_Rela *rel,
1100            int relative_reloc));
1101
1102 boolean _bfd_elf_make_linker_section_rela
1103   PARAMS ((bfd *dynobj,
1104            elf_linker_section_t *lsect,
1105            int alignment));
1106
1107 boolean _bfd_elfcore_section_from_phdr
1108   PARAMS ((bfd *, Elf_Internal_Phdr *, int));
1109
1110 extern const bfd_target *bfd_elf32_object_p PARAMS ((bfd *));
1111 extern const bfd_target *bfd_elf32_core_file_p PARAMS ((bfd *));
1112 extern char *bfd_elf32_core_file_failing_command PARAMS ((bfd *));
1113 extern int bfd_elf32_core_file_failing_signal PARAMS ((bfd *));
1114 extern boolean bfd_elf32_core_file_matches_executable_p PARAMS ((bfd *,
1115                                                                  bfd *));
1116
1117 extern boolean bfd_elf32_bfd_link_add_symbols
1118   PARAMS ((bfd *, struct bfd_link_info *));
1119 extern boolean bfd_elf32_bfd_final_link
1120   PARAMS ((bfd *, struct bfd_link_info *));
1121
1122 extern void bfd_elf32_swap_symbol_in
1123   PARAMS ((bfd *, const Elf32_External_Sym *, Elf_Internal_Sym *));
1124 extern void bfd_elf32_swap_symbol_out
1125   PARAMS ((bfd *, const Elf_Internal_Sym *, PTR));
1126 extern void bfd_elf32_swap_reloc_in
1127   PARAMS ((bfd *, const Elf32_External_Rel *, Elf_Internal_Rel *));
1128 extern void bfd_elf32_swap_reloc_out
1129   PARAMS ((bfd *, const Elf_Internal_Rel *, Elf32_External_Rel *));
1130 extern void bfd_elf32_swap_reloca_in
1131   PARAMS ((bfd *, const Elf32_External_Rela *, Elf_Internal_Rela *));
1132 extern void bfd_elf32_swap_reloca_out
1133   PARAMS ((bfd *, const Elf_Internal_Rela *, Elf32_External_Rela *));
1134 extern void bfd_elf32_swap_phdr_in
1135   PARAMS ((bfd *, const Elf32_External_Phdr *, Elf_Internal_Phdr *));
1136 extern void bfd_elf32_swap_phdr_out
1137   PARAMS ((bfd *, const Elf_Internal_Phdr *, Elf32_External_Phdr *));
1138 extern void bfd_elf32_swap_dyn_in
1139   PARAMS ((bfd *, const PTR, Elf_Internal_Dyn *));
1140 extern void bfd_elf32_swap_dyn_out
1141   PARAMS ((bfd *, const Elf_Internal_Dyn *, PTR));
1142 extern long bfd_elf32_slurp_symbol_table
1143   PARAMS ((bfd *, asymbol **, boolean));
1144 extern boolean bfd_elf32_write_shdrs_and_ehdr PARAMS ((bfd *));
1145 extern int bfd_elf32_write_out_phdrs
1146   PARAMS ((bfd *, const Elf_Internal_Phdr *, int));
1147 extern boolean bfd_elf32_add_dynamic_entry
1148   PARAMS ((struct bfd_link_info *, bfd_vma, bfd_vma));
1149 extern boolean bfd_elf32_link_create_dynamic_sections
1150   PARAMS ((bfd *, struct bfd_link_info *));
1151 extern Elf_Internal_Rela *_bfd_elf32_link_read_relocs
1152   PARAMS ((bfd *, asection *, PTR, Elf_Internal_Rela *, boolean));
1153
1154 extern const bfd_target *bfd_elf64_object_p PARAMS ((bfd *));
1155 extern const bfd_target *bfd_elf64_core_file_p PARAMS ((bfd *));
1156 extern char *bfd_elf64_core_file_failing_command PARAMS ((bfd *));
1157 extern int bfd_elf64_core_file_failing_signal PARAMS ((bfd *));
1158 extern boolean bfd_elf64_core_file_matches_executable_p PARAMS ((bfd *,
1159                                                                  bfd *));
1160 extern boolean bfd_elf64_bfd_link_add_symbols
1161   PARAMS ((bfd *, struct bfd_link_info *));
1162 extern boolean bfd_elf64_bfd_final_link
1163   PARAMS ((bfd *, struct bfd_link_info *));
1164
1165 extern void bfd_elf64_swap_symbol_in
1166   PARAMS ((bfd *, const Elf64_External_Sym *, Elf_Internal_Sym *));
1167 extern void bfd_elf64_swap_symbol_out
1168   PARAMS ((bfd *, const Elf_Internal_Sym *, PTR));
1169 extern void bfd_elf64_swap_reloc_in
1170   PARAMS ((bfd *, const Elf64_External_Rel *, Elf_Internal_Rel *));
1171 extern void bfd_elf64_swap_reloc_out
1172   PARAMS ((bfd *, const Elf_Internal_Rel *, Elf64_External_Rel *));
1173 extern void bfd_elf64_swap_reloca_in
1174   PARAMS ((bfd *, const Elf64_External_Rela *, Elf_Internal_Rela *));
1175 extern void bfd_elf64_swap_reloca_out
1176   PARAMS ((bfd *, const Elf_Internal_Rela *, Elf64_External_Rela *));
1177 extern void bfd_elf64_swap_phdr_in
1178   PARAMS ((bfd *, const Elf64_External_Phdr *, Elf_Internal_Phdr *));
1179 extern void bfd_elf64_swap_phdr_out
1180   PARAMS ((bfd *, const Elf_Internal_Phdr *, Elf64_External_Phdr *));
1181 extern void bfd_elf64_swap_dyn_in
1182   PARAMS ((bfd *, const PTR, Elf_Internal_Dyn *));
1183 extern void bfd_elf64_swap_dyn_out
1184   PARAMS ((bfd *, const Elf_Internal_Dyn *, PTR));
1185 extern long bfd_elf64_slurp_symbol_table
1186   PARAMS ((bfd *, asymbol **, boolean));
1187 extern boolean bfd_elf64_write_shdrs_and_ehdr PARAMS ((bfd *));
1188 extern int bfd_elf64_write_out_phdrs
1189   PARAMS ((bfd *, const Elf_Internal_Phdr *, int));
1190 extern boolean bfd_elf64_add_dynamic_entry
1191   PARAMS ((struct bfd_link_info *, bfd_vma, bfd_vma));
1192 extern boolean bfd_elf64_link_create_dynamic_sections
1193   PARAMS ((bfd *, struct bfd_link_info *));
1194 extern Elf_Internal_Rela *_bfd_elf64_link_read_relocs
1195   PARAMS ((bfd *, asection *, PTR, Elf_Internal_Rela *, boolean));
1196
1197 #define bfd_elf32_link_record_dynamic_symbol \
1198   _bfd_elf_link_record_dynamic_symbol
1199 #define bfd_elf64_link_record_dynamic_symbol \
1200   _bfd_elf_link_record_dynamic_symbol
1201
1202 boolean _bfd_elf32_link_record_local_dynamic_symbol
1203   PARAMS ((struct bfd_link_info *, bfd *, long));
1204 boolean _bfd_elf64_link_record_local_dynamic_symbol
1205   PARAMS ((struct bfd_link_info *, bfd *, long));
1206
1207 extern boolean _bfd_elf_close_and_cleanup PARAMS ((bfd *));
1208 extern bfd_reloc_status_type _bfd_elf_rel_vtable_reloc_fn
1209   PARAMS ((bfd *, arelent *, struct symbol_cache_entry *, PTR,
1210            asection *, bfd *, char **));
1211
1212 boolean _bfd_elf32_gc_sections
1213   PARAMS ((bfd *abfd, struct bfd_link_info *info));
1214 boolean _bfd_elf32_gc_common_finalize_got_offsets
1215   PARAMS ((bfd *abfd, struct bfd_link_info *info));
1216 boolean _bfd_elf32_gc_common_final_link
1217   PARAMS ((bfd *, struct bfd_link_info *));
1218 boolean _bfd_elf32_gc_record_vtinherit
1219   PARAMS ((bfd *, asection *, struct elf_link_hash_entry *, bfd_vma));
1220 boolean _bfd_elf32_gc_record_vtentry
1221   PARAMS ((bfd *, asection *, struct elf_link_hash_entry *, bfd_vma));
1222
1223 boolean _bfd_elf64_gc_sections
1224   PARAMS ((bfd *abfd, struct bfd_link_info *info));
1225 boolean _bfd_elf64_gc_common_finalize_got_offsets
1226   PARAMS ((bfd *abfd, struct bfd_link_info *info));
1227 boolean _bfd_elf64_gc_common_final_link
1228   PARAMS ((bfd *, struct bfd_link_info *));
1229 boolean _bfd_elf64_gc_record_vtinherit
1230   PARAMS ((bfd *, asection *, struct elf_link_hash_entry *, bfd_vma));
1231 boolean _bfd_elf64_gc_record_vtentry
1232   PARAMS ((bfd *, asection *, struct elf_link_hash_entry *, bfd_vma));
1233
1234 /* MIPS ELF specific routines.  */
1235
1236 extern boolean _bfd_mips_elf_object_p PARAMS ((bfd *));
1237 extern boolean _bfd_mips_elf_section_from_shdr
1238   PARAMS ((bfd *, Elf_Internal_Shdr *, char *));
1239 extern boolean _bfd_mips_elf_fake_sections
1240   PARAMS ((bfd *, Elf_Internal_Shdr *, asection *));
1241 extern boolean _bfd_mips_elf_section_from_bfd_section
1242   PARAMS ((bfd *, Elf_Internal_Shdr *, asection *, int *));
1243 extern boolean _bfd_mips_elf_section_processing
1244   PARAMS ((bfd *, Elf_Internal_Shdr *));
1245 extern void _bfd_mips_elf_symbol_processing PARAMS ((bfd *, asymbol *));
1246 extern boolean _bfd_mips_elf_read_ecoff_info
1247   PARAMS ((bfd *, asection *, struct ecoff_debug_info *));
1248 extern void _bfd_mips_elf_final_write_processing PARAMS ((bfd *, boolean));
1249 extern bfd_reloc_status_type _bfd_mips_elf_hi16_reloc
1250   PARAMS ((bfd *, arelent *, asymbol *, PTR, asection *, bfd *, char **));
1251 extern bfd_reloc_status_type _bfd_mips_elf_lo16_reloc
1252   PARAMS ((bfd *, arelent *, asymbol *, PTR, asection *, bfd *, char **));
1253 extern bfd_reloc_status_type _bfd_mips_elf_gprel16_reloc
1254   PARAMS ((bfd *, arelent *, asymbol *, PTR, asection *, bfd *, char **));
1255 extern bfd_reloc_status_type _bfd_mips_elf_got16_reloc
1256   PARAMS ((bfd *, arelent *, asymbol *, PTR, asection *, bfd *, char **));
1257 extern bfd_reloc_status_type _bfd_mips_elf_gprel32_reloc
1258   PARAMS ((bfd *, arelent *, asymbol *, PTR, asection *, bfd *, char **));
1259 extern boolean _bfd_mips_elf_set_private_flags PARAMS ((bfd *, flagword));
1260 extern boolean _bfd_mips_elf_copy_private_bfd_data PARAMS ((bfd *, bfd *));
1261 extern boolean _bfd_mips_elf_merge_private_bfd_data PARAMS ((bfd *, bfd *));
1262 extern boolean _bfd_mips_elf_find_nearest_line
1263   PARAMS ((bfd *, asection *, asymbol **, bfd_vma, const char **,
1264            const char **, unsigned int *));
1265 extern boolean _bfd_mips_elf_set_section_contents
1266   PARAMS ((bfd *, asection *, PTR, file_ptr, bfd_size_type));
1267 extern boolean _bfd_mips_elf_create_dynamic_sections
1268   PARAMS ((bfd *, struct bfd_link_info *));
1269 extern boolean _bfd_mips_elf_add_symbol_hook
1270   PARAMS ((bfd *, struct bfd_link_info *, const Elf_Internal_Sym *,
1271            const char **, flagword *, asection **, bfd_vma *));
1272 extern boolean _bfd_mips_elf_adjust_dynamic_symbol
1273   PARAMS ((struct bfd_link_info *, struct elf_link_hash_entry *));
1274 extern boolean _bfd_mips_elf_finish_dynamic_symbol
1275   PARAMS ((bfd *, struct bfd_link_info *, struct elf_link_hash_entry *,
1276            Elf_Internal_Sym *));
1277 extern boolean _bfd_mips_elf_finish_dynamic_sections
1278   PARAMS ((bfd *, struct bfd_link_info *));
1279 extern asection * _bfd_mips_elf_gc_mark_hook 
1280   PARAMS ((bfd *, struct bfd_link_info *, Elf_Internal_Rela *,
1281            struct elf_link_hash_entry *, Elf_Internal_Sym *));
1282 extern boolean _bfd_mips_elf_gc_sweep_hook 
1283   PARAMS ((bfd *, struct bfd_link_info *, asection *, 
1284            const Elf_Internal_Rela *));
1285 extern boolean _bfd_mips_elf_always_size_sections
1286   PARAMS ((bfd *, struct bfd_link_info *));
1287 extern boolean _bfd_mips_elf_size_dynamic_sections
1288   PARAMS ((bfd *, struct bfd_link_info *));
1289 extern boolean _bfd_mips_elf_check_relocs
1290   PARAMS ((bfd *, struct bfd_link_info *, asection *,
1291            const Elf_Internal_Rela *));
1292 extern struct bfd_link_hash_table *_bfd_mips_elf_link_hash_table_create
1293   PARAMS ((bfd *));
1294 extern boolean _bfd_mips_elf_print_private_bfd_data 
1295   PARAMS ((bfd *, PTR));
1296 extern boolean _bfd_mips_elf_link_output_symbol_hook
1297   PARAMS ((bfd *, struct bfd_link_info *, const char *, Elf_Internal_Sym *,
1298            asection *));
1299 extern boolean _bfd_mips_elf_final_link
1300   PARAMS ((bfd *, struct bfd_link_info *));
1301 extern int _bfd_mips_elf_additional_program_headers PARAMS ((bfd *));
1302 extern boolean _bfd_mips_elf_modify_segment_map PARAMS ((bfd *));
1303 extern boolean _bfd_mips_elf_relocate_section
1304   PARAMS ((bfd *, struct bfd_link_info *, bfd *, asection *, bfd_byte *,
1305            Elf_Internal_Rela *, Elf_Internal_Sym *, asection **));
1306
1307 #endif /* _LIBELF_H_ */