| 1 | /* BFD ECOFF object file private structure. |
| 2 | Copyright 1993, 1994, 1995, 1996, 1999, 2001, 2002, 2003, 2004, |
| 3 | 2005, 2006, 2007, 2008, 2009, 2010 |
| 4 | Free Software Foundation, Inc. |
| 5 | Written by Ian Lance Taylor, Cygnus Support. |
| 6 | |
| 7 | This file is part of BFD, the Binary File Descriptor library. |
| 8 | |
| 9 | This program is free software; you can redistribute it and/or modify |
| 10 | it under the terms of the GNU General Public License as published by |
| 11 | the Free Software Foundation; either version 3 of the License, or |
| 12 | (at your option) any later version. |
| 13 | |
| 14 | This program is distributed in the hope that it will be useful, |
| 15 | but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 16 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| 17 | GNU General Public License for more details. |
| 18 | |
| 19 | You should have received a copy of the GNU General Public License |
| 20 | along with this program; if not, write to the Free Software |
| 21 | Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston, |
| 22 | MA 02110-1301, USA. */ |
| 23 | |
| 24 | #include "bfdlink.h" |
| 25 | |
| 26 | #ifndef ECOFF_H |
| 27 | #include "coff/ecoff.h" |
| 28 | #endif |
| 29 | |
| 30 | /* This is the backend information kept for ECOFF files. This |
| 31 | structure is constant for a particular backend. The first element |
| 32 | is the COFF backend data structure, so that ECOFF targets can use |
| 33 | the generic COFF code. */ |
| 34 | |
| 35 | #define ecoff_backend(abfd) \ |
| 36 | ((struct ecoff_backend_data *) (abfd)->xvec->backend_data) |
| 37 | |
| 38 | struct ecoff_backend_data |
| 39 | { |
| 40 | /* COFF backend information. This must be the first field. */ |
| 41 | bfd_coff_backend_data coff; |
| 42 | /* Supported architecture. */ |
| 43 | enum bfd_architecture arch; |
| 44 | /* Initial portion of armap string. */ |
| 45 | const char *armap_start; |
| 46 | /* The page boundary used to align sections in a demand-paged |
| 47 | executable file. E.g., 0x1000. */ |
| 48 | bfd_vma round; |
| 49 | /* TRUE if the .rdata section is part of the text segment, as on the |
| 50 | Alpha. FALSE if .rdata is part of the data segment, as on the |
| 51 | MIPS. */ |
| 52 | bfd_boolean rdata_in_text; |
| 53 | /* Bitsize of constructor entries. */ |
| 54 | unsigned int constructor_bitsize; |
| 55 | /* Reloc to use for constructor entries. */ |
| 56 | reloc_howto_type *constructor_reloc; |
| 57 | /* How to swap debugging information. */ |
| 58 | struct ecoff_debug_swap debug_swap; |
| 59 | /* External reloc size. */ |
| 60 | bfd_size_type external_reloc_size; |
| 61 | /* Reloc swapping functions. */ |
| 62 | void (*swap_reloc_in) (bfd *, void *, struct internal_reloc *); |
| 63 | void (*swap_reloc_out) (bfd *, const struct internal_reloc *, void *); |
| 64 | /* Backend reloc tweaking. */ |
| 65 | void (*adjust_reloc_in) |
| 66 | (bfd *, const struct internal_reloc *, arelent *); |
| 67 | void (*adjust_reloc_out) |
| 68 | (bfd *, const arelent *, struct internal_reloc *); |
| 69 | /* Relocate section contents while linking. */ |
| 70 | bfd_boolean (*relocate_section) |
| 71 | (bfd *, struct bfd_link_info *, bfd *, asection *, bfd_byte *, void *); |
| 72 | /* Do final adjustments to filehdr and aouthdr. */ |
| 73 | bfd_boolean (*adjust_headers) |
| 74 | (bfd *, struct internal_filehdr *, struct internal_aouthdr *); |
| 75 | /* Read an element from an archive at a given file position. This |
| 76 | is needed because OSF/1 3.2 uses a weird archive format. */ |
| 77 | bfd *(*get_elt_at_filepos) (bfd *, file_ptr); |
| 78 | }; |
| 79 | |
| 80 | /* ECOFF targets don't support COFF long section names, so this |
| 81 | macro is provided to use as an initialiser for the related |
| 82 | members of the embedded bfd_coff_backend_data struct. */ |
| 83 | #define ECOFF_NO_LONG_SECTION_NAMES (FALSE), _bfd_ecoff_no_long_sections |
| 84 | |
| 85 | /* This is the target specific information kept for ECOFF files. */ |
| 86 | |
| 87 | #define ecoff_data(abfd) ((abfd)->tdata.ecoff_obj_data) |
| 88 | |
| 89 | typedef struct ecoff_tdata |
| 90 | { |
| 91 | /* The reloc file position, set by |
| 92 | ecoff_compute_section_file_positions. */ |
| 93 | file_ptr reloc_filepos; |
| 94 | |
| 95 | /* The symbol table file position, set by _bfd_ecoff_mkobject_hook. */ |
| 96 | file_ptr sym_filepos; |
| 97 | |
| 98 | /* The start and end of the text segment. Only valid for an |
| 99 | existing file, not for one we are creating. */ |
| 100 | unsigned long text_start; |
| 101 | unsigned long text_end; |
| 102 | |
| 103 | /* The cached gp value. This is used when relocating. */ |
| 104 | bfd_vma gp; |
| 105 | |
| 106 | /* The maximum size of objects to optimize using gp. This is |
| 107 | typically set by the -G option to the compiler, assembler or |
| 108 | linker. */ |
| 109 | unsigned int gp_size; |
| 110 | |
| 111 | /* The register masks. When linking, all the masks found in the |
| 112 | input files are combined into the masks of the output file. |
| 113 | These are not all used for all targets, but that's OK, because |
| 114 | the relevant ones are the only ones swapped in and out. */ |
| 115 | unsigned long gprmask; |
| 116 | unsigned long fprmask; |
| 117 | unsigned long cprmask[4]; |
| 118 | |
| 119 | /* The ECOFF symbolic debugging information. */ |
| 120 | struct ecoff_debug_info debug_info; |
| 121 | |
| 122 | /* The unswapped ECOFF symbolic information. */ |
| 123 | void * raw_syments; |
| 124 | |
| 125 | /* The canonical BFD symbols. */ |
| 126 | struct ecoff_symbol_struct *canonical_symbols; |
| 127 | |
| 128 | /* A mapping from external symbol numbers to entries in the linker |
| 129 | hash table, used when linking. */ |
| 130 | struct ecoff_link_hash_entry **sym_hashes; |
| 131 | |
| 132 | /* A mapping from reloc symbol indices to sections, used when |
| 133 | linking. */ |
| 134 | asection **symndx_to_section; |
| 135 | |
| 136 | /* TRUE if this BFD was written by the backend linker. */ |
| 137 | bfd_boolean linker; |
| 138 | |
| 139 | /* TRUE if a warning that multiple global pointer values are |
| 140 | needed in the output binary was issued already. */ |
| 141 | bfd_boolean issued_multiple_gp_warning; |
| 142 | |
| 143 | /* Used by find_nearest_line entry point. The structure could be |
| 144 | included directly in this one, but there's no point to wasting |
| 145 | the memory just for the infrequently called find_nearest_line. */ |
| 146 | struct ecoff_find_line *find_line_info; |
| 147 | |
| 148 | /* Whether the .rdata section is in the text segment for this |
| 149 | particular ECOFF file. This is not valid until |
| 150 | ecoff_compute_section_file_positions is called. */ |
| 151 | bfd_boolean rdata_in_text; |
| 152 | |
| 153 | } ecoff_data_type; |
| 154 | |
| 155 | /* Each canonical asymbol really looks like this. */ |
| 156 | |
| 157 | typedef struct ecoff_symbol_struct |
| 158 | { |
| 159 | /* The actual symbol which the rest of BFD works with */ |
| 160 | asymbol symbol; |
| 161 | |
| 162 | /* The fdr for this symbol. */ |
| 163 | FDR *fdr; |
| 164 | |
| 165 | /* TRUE if this is a local symbol rather than an external one. */ |
| 166 | bfd_boolean local; |
| 167 | |
| 168 | /* A pointer to the unswapped hidden information for this symbol. |
| 169 | This is either a struct sym_ext or a struct ext_ext, depending on |
| 170 | the value of the local field above. */ |
| 171 | void * native; |
| 172 | } ecoff_symbol_type; |
| 173 | |
| 174 | /* We take the address of the first element of an asymbol to ensure that the |
| 175 | macro is only ever applied to an asymbol. */ |
| 176 | #define ecoffsymbol(asymbol) ((ecoff_symbol_type *) (&((asymbol)->the_bfd))) |
| 177 | |
| 178 | /* We need to save the index of an external symbol when we write it |
| 179 | out so that can set the symbol index correctly when we write out |
| 180 | the relocs. */ |
| 181 | #define ecoff_get_sym_index(symbol) ((symbol)->udata.i) |
| 182 | #define ecoff_set_sym_index(symbol, idx) ((symbol)->udata.i = (idx)) |
| 183 | |
| 184 | /* A pointer to this structure is put in the used_by_bfd pointer of |
| 185 | a section to keep track of any per-section data. |
| 186 | The user_by_bfd pointer will be NULL if the information was not |
| 187 | needed. */ |
| 188 | |
| 189 | struct ecoff_section_tdata |
| 190 | { |
| 191 | /* When producing an executable (i.e., final, non-relocatable link) |
| 192 | on the Alpha, we may need to use multiple global pointer values |
| 193 | to span the entire .lita section. In essence, we allow each |
| 194 | input .lita section to have its own gp value. To support this, |
| 195 | we need to keep track of the gp values that we picked for each |
| 196 | input .lita section . */ |
| 197 | bfd_vma gp; |
| 198 | }; |
| 199 | |
| 200 | /* An accessor macro for the ecoff_section_tdata structure. */ |
| 201 | #define ecoff_section_data(abfd, sec) \ |
| 202 | ((struct ecoff_section_tdata *) (sec)->used_by_bfd) |
| 203 | |
| 204 | /* ECOFF linker hash table entries. */ |
| 205 | |
| 206 | struct ecoff_link_hash_entry |
| 207 | { |
| 208 | struct bfd_link_hash_entry root; |
| 209 | /* Symbol index in output file. */ |
| 210 | long indx; |
| 211 | /* BFD that ext field value came from. */ |
| 212 | bfd *abfd; |
| 213 | /* ECOFF external symbol information. */ |
| 214 | EXTR esym; |
| 215 | /* Nonzero if this symbol has been written out. */ |
| 216 | char written; |
| 217 | /* Nonzero if this symbol was referred to as small undefined. */ |
| 218 | char small; |
| 219 | }; |
| 220 | |
| 221 | /* ECOFF linker hash table. */ |
| 222 | |
| 223 | struct ecoff_link_hash_table |
| 224 | { |
| 225 | struct bfd_link_hash_table root; |
| 226 | }; |
| 227 | |
| 228 | /* Make an ECOFF object. */ |
| 229 | extern bfd_boolean _bfd_ecoff_mkobject (bfd *); |
| 230 | |
| 231 | /* Read in the ECOFF symbolic debugging information. */ |
| 232 | extern bfd_boolean _bfd_ecoff_slurp_symbolic_info |
| 233 | (bfd *, asection *, struct ecoff_debug_info *); |
| 234 | |
| 235 | /* Generic ECOFF BFD backend vectors. */ |
| 236 | |
| 237 | extern bfd_boolean _bfd_ecoff_write_object_contents (bfd *); |
| 238 | |
| 239 | #define _bfd_ecoff_close_and_cleanup _bfd_generic_close_and_cleanup |
| 240 | #define _bfd_ecoff_bfd_free_cached_info _bfd_generic_bfd_free_cached_info |
| 241 | extern bfd_boolean _bfd_ecoff_new_section_hook |
| 242 | (bfd *, asection *); |
| 243 | extern bfd_boolean _bfd_ecoff_get_section_contents |
| 244 | (bfd *, asection *, void * location, file_ptr, bfd_size_type); |
| 245 | |
| 246 | #define _bfd_ecoff_bfd_link_split_section _bfd_generic_link_split_section |
| 247 | |
| 248 | extern bfd_boolean _bfd_ecoff_bfd_copy_private_bfd_data |
| 249 | (bfd *, bfd *); |
| 250 | #define _bfd_ecoff_bfd_copy_private_section_data \ |
| 251 | _bfd_generic_bfd_copy_private_section_data |
| 252 | |
| 253 | #define _bfd_ecoff_bfd_copy_private_symbol_data \ |
| 254 | _bfd_generic_bfd_copy_private_symbol_data |
| 255 | |
| 256 | #define _bfd_ecoff_bfd_copy_private_header_data \ |
| 257 | _bfd_generic_bfd_copy_private_header_data |
| 258 | |
| 259 | #define _bfd_ecoff_bfd_print_private_bfd_data \ |
| 260 | _bfd_generic_bfd_print_private_bfd_data |
| 261 | |
| 262 | #define _bfd_ecoff_bfd_merge_private_bfd_data \ |
| 263 | _bfd_generic_bfd_merge_private_bfd_data |
| 264 | |
| 265 | #define _bfd_ecoff_bfd_set_private_flags _bfd_generic_bfd_set_private_flags |
| 266 | extern bfd_boolean _bfd_ecoff_slurp_armap (bfd *); |
| 267 | #define _bfd_ecoff_slurp_extended_name_table _bfd_slurp_extended_name_table |
| 268 | #define _bfd_ecoff_construct_extended_name_table \ |
| 269 | _bfd_archive_bsd_construct_extended_name_table |
| 270 | #define _bfd_ecoff_truncate_arname bfd_dont_truncate_arname |
| 271 | extern bfd_boolean _bfd_ecoff_write_armap |
| 272 | (bfd *, unsigned int, struct orl *, unsigned int, int); |
| 273 | #define _bfd_ecoff_read_ar_hdr _bfd_generic_read_ar_hdr |
| 274 | #define _bfd_ecoff_write_ar_hdr _bfd_generic_write_ar_hdr |
| 275 | #define _bfd_ecoff_openr_next_archived_file \ |
| 276 | bfd_generic_openr_next_archived_file |
| 277 | #define _bfd_ecoff_get_elt_at_index _bfd_generic_get_elt_at_index |
| 278 | #define _bfd_ecoff_generic_stat_arch_elt bfd_generic_stat_arch_elt |
| 279 | #define _bfd_ecoff_update_armap_timestamp bfd_true |
| 280 | #define _bfd_ecoff_bfd_is_target_special_symbol \ |
| 281 | ((bfd_boolean (*) (bfd *, asymbol *)) bfd_false) |
| 282 | |
| 283 | extern long _bfd_ecoff_get_symtab_upper_bound (bfd *); |
| 284 | extern long _bfd_ecoff_canonicalize_symtab (bfd *, asymbol **); |
| 285 | extern asymbol *_bfd_ecoff_make_empty_symbol (bfd *); |
| 286 | extern void _bfd_ecoff_print_symbol |
| 287 | (bfd *, void *, asymbol *, bfd_print_symbol_type); |
| 288 | extern void _bfd_ecoff_get_symbol_info |
| 289 | (bfd *, asymbol *, symbol_info *); |
| 290 | extern bfd_boolean _bfd_ecoff_bfd_is_local_label_name |
| 291 | (bfd *, const char *); |
| 292 | #define _bfd_ecoff_get_lineno _bfd_nosymbols_get_lineno |
| 293 | extern bfd_boolean _bfd_ecoff_find_nearest_line |
| 294 | (bfd *, asection *, asymbol **, bfd_vma, const char **, const char **, |
| 295 | unsigned int *); |
| 296 | #define _bfd_ecoff_bfd_make_debug_symbol _bfd_nosymbols_bfd_make_debug_symbol |
| 297 | #define _bfd_ecoff_read_minisymbols _bfd_generic_read_minisymbols |
| 298 | #define _bfd_ecoff_minisymbol_to_symbol _bfd_generic_minisymbol_to_symbol |
| 299 | #define _bfd_ecoff_find_inliner_info _bfd_nosymbols_find_inliner_info |
| 300 | |
| 301 | #define _bfd_ecoff_get_reloc_upper_bound coff_get_reloc_upper_bound |
| 302 | extern long _bfd_ecoff_canonicalize_reloc |
| 303 | (bfd *, asection *, arelent **, asymbol **symbols); |
| 304 | /* ecoff_bfd_reloc_type_lookup defined by backend. */ |
| 305 | |
| 306 | extern bfd_boolean _bfd_ecoff_set_arch_mach |
| 307 | (bfd *, enum bfd_architecture, unsigned long); |
| 308 | extern bfd_boolean _bfd_ecoff_set_section_contents |
| 309 | (bfd *, asection *, const void * location, file_ptr, bfd_size_type); |
| 310 | |
| 311 | extern int _bfd_ecoff_sizeof_headers (bfd *, struct bfd_link_info *); |
| 312 | /* ecoff_bfd_get_relocated_section_contents defined by backend. */ |
| 313 | /* ecoff_bfd_relax_section defined by backend. */ |
| 314 | extern struct bfd_link_hash_table *_bfd_ecoff_bfd_link_hash_table_create |
| 315 | (bfd *); |
| 316 | #define _bfd_ecoff_bfd_link_hash_table_free _bfd_generic_link_hash_table_free |
| 317 | extern bfd_boolean _bfd_ecoff_bfd_link_add_symbols |
| 318 | (bfd *, struct bfd_link_info *); |
| 319 | #define _bfd_ecoff_bfd_link_just_syms _bfd_generic_link_just_syms |
| 320 | #define _bfd_ecoff_bfd_copy_link_hash_symbol_type \ |
| 321 | _bfd_generic_copy_link_hash_symbol_type |
| 322 | extern bfd_boolean _bfd_ecoff_bfd_final_link |
| 323 | (bfd *, struct bfd_link_info *); |
| 324 | |
| 325 | /* Hook functions for the generic COFF section reading code. */ |
| 326 | |
| 327 | extern void * _bfd_ecoff_mkobject_hook (bfd *, void *, void *); |
| 328 | #define _bfd_ecoff_set_alignment_hook \ |
| 329 | ((void (*) (bfd *, asection *, void *)) bfd_void) |
| 330 | extern bfd_boolean _bfd_ecoff_set_arch_mach_hook |
| 331 | (bfd *, void *); |
| 332 | extern bfd_boolean _bfd_ecoff_no_long_sections |
| 333 | (bfd *abfd, int enable); |
| 334 | extern bfd_boolean _bfd_ecoff_styp_to_sec_flags |
| 335 | (bfd *, void *, const char *, asection *, flagword *); |
| 336 | extern bfd_boolean _bfd_ecoff_slurp_symbol_table (bfd *); |
| 337 | |
| 338 | /* ECOFF auxiliary information swapping routines. These are the same |
| 339 | for all ECOFF targets, so they are defined in ecofflink.c. */ |
| 340 | |
| 341 | extern void _bfd_ecoff_swap_tir_in |
| 342 | (int, const struct tir_ext *, TIR *); |
| 343 | extern void _bfd_ecoff_swap_tir_out |
| 344 | (int, const TIR *, struct tir_ext *); |
| 345 | extern void _bfd_ecoff_swap_rndx_in |
| 346 | (int, const struct rndx_ext *, RNDXR *); |
| 347 | extern void _bfd_ecoff_swap_rndx_out |
| 348 | (int, const RNDXR *, struct rndx_ext *); |