1 /* BFD ECOFF object file private structure.
2 Copyright (C) 1993 Free Software Foundation, Inc.
3 Written by Ian Lance Taylor, Cygnus Support.
5 This file is part of BFD, the Binary File Descriptor library.
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program; if not, write to the Free Software
19 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */
24 #include "coff/ecoff.h"
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. */
32 #define ecoff_backend(abfd) \
33 ((struct ecoff_backend_data *) (abfd)->xvec->backend_data)
35 struct ecoff_backend_data
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. */
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
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
*,
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
,
70 PTR external_relocs
));
73 /* This is the target specific information kept for ECOFF files. */
75 #define ecoff_data(abfd) ((abfd)->tdata.ecoff_obj_data)
77 typedef struct ecoff_tdata
79 /* The reloc file position, set by
80 ecoff_compute_section_file_positions. */
81 file_ptr reloc_filepos
;
83 /* The symbol table file position, set by _bfd_ecoff_mkobject_hook. */
86 /* The start and end of the text segment. Only valid for an
87 existing file, not for one we are creating. */
88 unsigned long text_start
;
89 unsigned long text_end
;
91 /* The cached gp value. This is used when relocating. */
94 /* The maximum size of objects to optimize using gp. This is
95 typically set by the -G option to the compiler, assembler or
99 /* The register masks. When linking, all the masks found in the
100 input files are combined into the masks of the output file.
101 These are not all used for all targets, but that's OK, because
102 the relevant ones are the only ones swapped in and out. */
103 unsigned long gprmask
;
104 unsigned long fprmask
;
105 unsigned long cprmask
[4];
107 /* The ECOFF symbolic debugging information. */
108 struct ecoff_debug_info debug_info
;
110 /* The unswapped ECOFF symbolic information. */
113 /* The canonical BFD symbols. */
114 struct ecoff_symbol_struct
*canonical_symbols
;
116 /* A mapping from external symbol numbers to entries in the linker
117 hash table, used when linking. */
118 struct ecoff_link_hash_entry
**sym_hashes
;
120 /* A mapping from reloc symbol indices to sections, used when
122 asection
**symndx_to_section
;
124 /* True if this BFD was written by the backend linker. */
127 /* Used by find_nearest_line entry point. The structure could be
128 included directly in this one, but there's no point to wasting
129 the memory just for the infrequently called find_nearest_line. */
130 struct ecoff_find_line
*find_line_info
;
134 /* Each canonical asymbol really looks like this. */
136 typedef struct ecoff_symbol_struct
138 /* The actual symbol which the rest of BFD works with */
141 /* The fdr for this symbol. */
144 /* true if this is a local symbol rather than an external one. */
147 /* A pointer to the unswapped hidden information for this symbol.
148 This is either a struct sym_ext or a struct ext_ext, depending on
149 the value of the local field above. */
153 /* We take the address of the first element of a asymbol to ensure that the
154 macro is only ever applied to an asymbol. */
155 #define ecoffsymbol(asymbol) ((ecoff_symbol_type *) (&((asymbol)->the_bfd)))
157 /* We need to save the index of an external symbol when we write it
158 out so that can set the symbol index correctly when we write out
160 #define ecoff_get_sym_index(symbol) ((symbol)->udata.i)
161 #define ecoff_set_sym_index(symbol, idx) ((symbol)->udata.i = (idx))
163 /* When generating MIPS embedded PIC code, the linker relaxes the code
164 to turn PC relative branches into longer code sequences when the PC
165 relative branch is out of range. This involves reading the relocs
166 in bfd_relax_section as well as in bfd_final_link, and requires the
167 code to keep track of which relocs have been expanded. A pointer
168 to this structure is put in the used_by_bfd pointer of a section to
169 keep track of this information. The user_by_bfd pointer will be
170 NULL if the information was not needed. */
172 struct ecoff_section_tdata
174 /* The unswapped relocs for this section. These are stored in
175 memory so the input file does not have to be read twice. */
178 /* The contents of the section. These bytes may or may not be saved
179 in memory, but if it is this is a pointer to them. */
182 /* Offset adjustments for PC relative branches. A number other than
183 1 is an addend for a PC relative branch, or a switch table entry
184 which is the difference of two .text locations; this addend
185 arises because the branch or difference crosses one or more
186 branches which were expanded into a larger code sequence. A 1
187 means that this branch was itself expanded into a larger code
188 sequence. 1 is not a possible offset, since all offsets must be
189 multiples of the instruction size, which is 4; also, the only
190 relocs with non-zero offsets will be PC relative branches or
191 switch table entries within the same object file. If this field
192 is NULL, no branches were expanded and no offsets are required.
193 Otherwise there are as many entries as there are relocs in the
194 section, and the entry for any reloc that is not PC relative is
199 /* An accessor macro for the ecoff_section_tdata structure. */
200 #define ecoff_section_data(abfd, sec) \
201 ((struct ecoff_section_tdata *) (sec)->used_by_bfd)
203 /* ECOFF linker hash table entries. */
205 struct ecoff_link_hash_entry
207 struct bfd_link_hash_entry root
;
208 /* Symbol index in output file. */
210 /* BFD that ext field value came from. */
212 /* ECOFF external symbol information. */
214 /* Nonzero if this symbol has been written out. */
216 /* Nonzero if this symbol was referred to as small undefined. */
220 /* ECOFF linker hash table. */
222 struct ecoff_link_hash_table
224 struct bfd_link_hash_table root
;
227 /* Make an ECOFF object. */
228 extern boolean _bfd_ecoff_mkobject
PARAMS ((bfd
*));
230 /* Read in the ECOFF symbolic debugging information. */
231 extern boolean _bfd_ecoff_slurp_symbolic_info
232 PARAMS ((bfd
*, asection
*, struct ecoff_debug_info
*));
234 /* Generic ECOFF BFD backend vectors. */
236 extern boolean _bfd_ecoff_write_object_contents
PARAMS ((bfd
*abfd
));
237 extern const bfd_target
*_bfd_ecoff_archive_p
PARAMS ((bfd
*abfd
));
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 boolean _bfd_ecoff_new_section_hook
242 PARAMS ((bfd
*, asection
*));
243 extern boolean _bfd_ecoff_get_section_contents
244 PARAMS ((bfd
*, asection
*, PTR location
, file_ptr
, bfd_size_type
));
246 #define _bfd_ecoff_bfd_link_split_section _bfd_generic_link_split_section
248 extern boolean _bfd_ecoff_bfd_copy_private_bfd_data
PARAMS ((bfd
*, bfd
*));
249 #define _bfd_ecoff_bfd_copy_private_section_data \
250 _bfd_generic_bfd_copy_private_section_data
252 #define _bfd_ecoff_bfd_copy_private_symbol_data \
253 _bfd_generic_bfd_copy_private_symbol_data
255 #define _bfd_ecoff_bfd_merge_private_bfd_data \
256 _bfd_generic_bfd_merge_private_bfd_data
258 #define _bfd_ecoff_bfd_set_private_flags _bfd_generic_bfd_set_private_flags
259 extern boolean _bfd_ecoff_slurp_armap
PARAMS ((bfd
*abfd
));
260 #define _bfd_ecoff_slurp_extended_name_table _bfd_slurp_extended_name_table
261 #define _bfd_ecoff_construct_extended_name_table \
262 _bfd_archive_bsd_construct_extended_name_table
263 #define _bfd_ecoff_truncate_arname bfd_dont_truncate_arname
264 extern boolean _bfd_ecoff_write_armap
265 PARAMS ((bfd
*, unsigned int, struct orl
*, unsigned int, int));
266 #define _bfd_ecoff_openr_next_archived_file \
267 bfd_generic_openr_next_archived_file
268 #define _bfd_ecoff_generic_stat_arch_elt bfd_generic_stat_arch_elt
269 #define _bfd_ecoff_update_armap_timestamp bfd_true
271 extern long _bfd_ecoff_get_symtab_upper_bound
PARAMS ((bfd
*abfd
));
272 extern long _bfd_ecoff_get_symtab
PARAMS ((bfd
*abfd
, asymbol
**alocation
));
273 extern asymbol
*_bfd_ecoff_make_empty_symbol
PARAMS ((bfd
*abfd
));
274 extern void _bfd_ecoff_print_symbol
275 PARAMS ((bfd
*, PTR filep
, asymbol
*, bfd_print_symbol_type
));
276 extern void _bfd_ecoff_get_symbol_info
277 PARAMS ((bfd
*, asymbol
*, symbol_info
*));
278 extern boolean _bfd_ecoff_bfd_is_local_label
279 PARAMS ((bfd
*, asymbol
*));
280 #define _bfd_ecoff_get_lineno _bfd_nosymbols_get_lineno
281 extern boolean _bfd_ecoff_find_nearest_line
282 PARAMS ((bfd
*, asection
*, asymbol
**, bfd_vma offset
,
283 const char **filename_ptr
, const char **fnname_ptr
,
284 unsigned int *retline_ptr
));
285 #define _bfd_ecoff_bfd_make_debug_symbol _bfd_nosymbols_bfd_make_debug_symbol
287 #define _bfd_ecoff_get_reloc_upper_bound coff_get_reloc_upper_bound
288 extern long _bfd_ecoff_canonicalize_reloc
289 PARAMS ((bfd
*, asection
*, arelent
**, asymbol
**symbols
));
290 /* ecoff_bfd_reloc_type_lookup defined by backend. */
292 extern boolean _bfd_ecoff_set_arch_mach
293 PARAMS ((bfd
*, enum bfd_architecture
, unsigned long machine
));
294 extern boolean _bfd_ecoff_set_section_contents
295 PARAMS ((bfd
*, asection
*, PTR location
, file_ptr
, bfd_size_type
));
297 extern int _bfd_ecoff_sizeof_headers
PARAMS ((bfd
*abfd
, boolean reloc
));
298 /* ecoff_bfd_get_relocated_section_contents defined by backend. */
299 /* ecoff_bfd_relax_section defined by backend. */
300 extern struct bfd_link_hash_table
*_bfd_ecoff_bfd_link_hash_table_create
302 extern boolean _bfd_ecoff_bfd_link_add_symbols
303 PARAMS ((bfd
*, struct bfd_link_info
*));
304 extern boolean _bfd_ecoff_bfd_final_link
305 PARAMS ((bfd
*, struct bfd_link_info
*));
307 /* Hook functions for the generic COFF section reading code. */
309 extern PTR _bfd_ecoff_mkobject_hook
PARAMS ((bfd
*, PTR filehdr
, PTR aouthdr
));
310 extern asection
*_bfd_ecoff_make_section_hook
PARAMS ((bfd
*abfd
, char *name
));
311 #define _bfd_ecoff_set_alignment_hook \
312 ((void (*) PARAMS ((bfd *, asection *, PTR))) bfd_void)
313 extern boolean _bfd_ecoff_set_arch_mach_hook
PARAMS ((bfd
*abfd
, PTR filehdr
));
314 extern flagword _bfd_ecoff_styp_to_sec_flags
315 PARAMS ((bfd
*abfd
, PTR hdr
, const char *name
));
316 extern boolean _bfd_ecoff_slurp_symbol_table
PARAMS ((bfd
*abfd
));
318 /* ECOFF auxiliary information swapping routines. These are the same
319 for all ECOFF targets, so they are defined in ecofflink.c. */
321 extern void _bfd_ecoff_swap_tir_in
322 PARAMS ((int, const struct tir_ext
*, TIR
*));
323 extern void _bfd_ecoff_swap_tir_out
324 PARAMS ((int, const TIR
*, struct tir_ext
*));
325 extern void _bfd_ecoff_swap_rndx_in
326 PARAMS ((int, const struct rndx_ext
*, RNDXR
*));
327 extern void _bfd_ecoff_swap_rndx_out
328 PARAMS ((int, const RNDXR
*, struct rndx_ext
*));