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