1 /* Support for the generic parts of most COFF variants, for BFD.
2 Copyright 1990, 1991, 1992, 1993, 1994 Free Software Foundation, Inc.
3 Written by 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. */
22 Most of this hacked by Steve Chamberlain,
30 BFD supports a number of different flavours of coff format.
31 The major differences between formats are the sizes and
32 alignments of fields in structures on disk, and the occasional
35 Coff in all its varieties is implemented with a few common
36 files and a number of implementation specific files. For
37 example, The 88k bcs coff format is implemented in the file
38 @file{coff-m88k.c}. This file @code{#include}s
39 @file{coff/m88k.h} which defines the external structure of the
40 coff format for the 88k, and @file{coff/internal.h} which
41 defines the internal structure. @file{coff-m88k.c} also
42 defines the relocations used by the 88k format
45 The Intel i960 processor version of coff is implemented in
46 @file{coff-i960.c}. This file has the same structure as
47 @file{coff-m88k.c}, except that it includes @file{coff/i960.h}
48 rather than @file{coff-m88k.h}.
51 Porting to a new version of coff
53 The recommended method is to select from the existing
54 implementations the version of coff which is most like the one
55 you want to use. For example, we'll say that i386 coff is
56 the one you select, and that your coff flavour is called foo.
57 Copy @file{i386coff.c} to @file{foocoff.c}, copy
58 @file{../include/coff/i386.h} to @file{../include/coff/foo.h},
59 and add the lines to @file{targets.c} and @file{Makefile.in}
60 so that your new back end is used. Alter the shapes of the
61 structures in @file{../include/coff/foo.h} so that they match
62 what you need. You will probably also have to add
63 @code{#ifdef}s to the code in @file{coff/internal.h} and
64 @file{coffcode.h} if your version of coff is too wild.
66 You can verify that your new BFD backend works quite simply by
67 building @file{objdump} from the @file{binutils} directory,
68 and making sure that its version of what's going on and your
69 host system's idea (assuming it has the pretty standard coff
70 dump utility, usually called @code{att-dump} or just
71 @code{dump}) are the same. Then clean up your code, and send
72 what you've done to Cygnus. Then your stuff will be in the
73 next release, and you won't have to keep integrating it.
76 How the coff backend works
81 The Coff backend is split into generic routines that are
82 applicable to any Coff target and routines that are specific
83 to a particular target. The target-specific routines are
84 further split into ones which are basically the same for all
85 Coff targets except that they use the external symbol format
86 or use different values for certain constants.
88 The generic routines are in @file{coffgen.c}. These routines
89 work for any Coff target. They use some hooks into the target
90 specific code; the hooks are in a @code{bfd_coff_backend_data}
91 structure, one of which exists for each target.
93 The essentially similar target-specific routines are in
94 @file{coffcode.h}. This header file includes executable C code.
95 The various Coff targets first include the appropriate Coff
96 header file, make any special defines that are needed, and
97 then include @file{coffcode.h}.
99 Some of the Coff targets then also have additional routines in
100 the target source file itself.
102 For example, @file{coff-i960.c} includes
103 @file{coff/internal.h} and @file{coff/i960.h}. It then
104 defines a few constants, such as @code{I960}, and includes
105 @file{coffcode.h}. Since the i960 has complex relocation
106 types, @file{coff-i960.c} also includes some code to
107 manipulate the i960 relocs. This code is not in
108 @file{coffcode.h} because it would not be used by any other
114 Each flavour of coff supported in BFD has its own header file
115 describing the external layout of the structures. There is also
116 an internal description of the coff layout, in
117 @file{coff/internal.h}. A major function of the
118 coff backend is swapping the bytes and twiddling the bits to
119 translate the external form of the structures into the normal
120 internal form. This is all performed in the
121 @code{bfd_swap}_@i{thing}_@i{direction} routines. Some
122 elements are different sizes between different versions of
123 coff; it is the duty of the coff version specific include file
124 to override the definitions of various packing routines in
125 @file{coffcode.h}. E.g., the size of line number entry in coff is
126 sometimes 16 bits, and sometimes 32 bits. @code{#define}ing
127 @code{PUT_LNSZ_LNNO} and @code{GET_LNSZ_LNNO} will select the
128 correct one. No doubt, some day someone will find a version of
129 coff which has a varying field size not catered to at the
130 moment. To port BFD, that person will have to add more @code{#defines}.
131 Three of the bit twiddling routines are exported to
132 @code{gdb}; @code{coff_swap_aux_in}, @code{coff_swap_sym_in}
133 and @code{coff_swap_linno_in}. @code{GDB} reads the symbol
134 table on its own, but uses BFD to fix things up. More of the
135 bit twiddlers are exported for @code{gas};
136 @code{coff_swap_aux_out}, @code{coff_swap_sym_out},
137 @code{coff_swap_lineno_out}, @code{coff_swap_reloc_out},
138 @code{coff_swap_filehdr_out}, @code{coff_swap_aouthdr_out},
139 @code{coff_swap_scnhdr_out}. @code{Gas} currently keeps track
140 of all the symbol table and reloc drudgery itself, thereby
141 saving the internal BFD overhead, but uses BFD to swap things
142 on the way out, making cross ports much safer. Doing so also
143 allows BFD (and thus the linker) to use the same header files
144 as @code{gas}, which makes one avenue to disaster disappear.
149 The simple canonical form for symbols used by BFD is not rich
150 enough to keep all the information available in a coff symbol
151 table. The back end gets around this problem by keeping the original
152 symbol table around, "behind the scenes".
154 When a symbol table is requested (through a call to
155 @code{bfd_canonicalize_symtab}), a request gets through to
156 @code{coff_get_normalized_symtab}. This reads the symbol table from
157 the coff file and swaps all the structures inside into the
158 internal form. It also fixes up all the pointers in the table
159 (represented in the file by offsets from the first symbol in
160 the table) into physical pointers to elements in the new
161 internal table. This involves some work since the meanings of
162 fields change depending upon context: a field that is a
163 pointer to another structure in the symbol table at one moment
164 may be the size in bytes of a structure at the next. Another
165 pass is made over the table. All symbols which mark file names
166 (<<C_FILE>> symbols) are modified so that the internal
167 string points to the value in the auxent (the real filename)
168 rather than the normal text associated with the symbol
171 At this time the symbol names are moved around. Coff stores
172 all symbols less than nine characters long physically
173 within the symbol table; longer strings are kept at the end of
174 the file in the string table. This pass moves all strings
175 into memory and replaces them with pointers to the strings.
178 The symbol table is massaged once again, this time to create
179 the canonical table used by the BFD application. Each symbol
180 is inspected in turn, and a decision made (using the
181 @code{sclass} field) about the various flags to set in the
182 @code{asymbol}. @xref{Symbols}. The generated canonical table
183 shares strings with the hidden internal symbol table.
185 Any linenumbers are read from the coff file too, and attached
186 to the symbols which own the functions the linenumbers belong to.
191 Writing a symbol to a coff file which didn't come from a coff
192 file will lose any debugging information. The @code{asymbol}
193 structure remembers the BFD from which the symbol was taken, and on
194 output the back end makes sure that the same destination target as
195 source target is present.
197 When the symbols have come from a coff file then all the
198 debugging information is preserved.
200 Symbol tables are provided for writing to the back end in a
201 vector of pointers to pointers. This allows applications like
202 the linker to accumulate and output large symbol tables
203 without having to do too much byte copying.
205 This function runs through the provided symbol table and
206 patches each symbol marked as a file place holder
207 (@code{C_FILE}) to point to the next file place holder in the
208 list. It also marks each @code{offset} field in the list with
209 the offset from the first symbol of the current symbol.
211 Another function of this procedure is to turn the canonical
212 value form of BFD into the form used by coff. Internally, BFD
213 expects symbol values to be offsets from a section base; so a
214 symbol physically at 0x120, but in a section starting at
215 0x100, would have the value 0x20. Coff expects symbols to
216 contain their final value, so symbols have their values
217 changed at this point to reflect their sum with their owning
218 section. This transformation uses the
219 <<output_section>> field of the @code{asymbol}'s
220 @code{asection} @xref{Sections}.
222 o <<coff_mangle_symbols>>
224 This routine runs though the provided symbol table and uses
225 the offsets generated by the previous pass and the pointers
226 generated when the symbol table was read in to create the
227 structured hierachy required by coff. It changes each pointer
228 to a symbol into the index into the symbol table of the asymbol.
230 o <<coff_write_symbols>>
232 This routine runs through the symbol table and patches up the
233 symbols from their internal form into the coff way, calls the
234 bit twiddlers, and writes out the table to the file.
243 The hidden information for an <<asymbol>> is described in a
244 <<combined_entry_type>>:
248 .typedef struct coff_ptr_struct
251 . {* Remembers the offset from the first symbol in the file for
252 . this symbol. Generated by coff_renumber_symbols. *}
253 .unsigned int offset;
255 . {* Should the value of this symbol be renumbered. Used for
256 . XCOFF C_BSTAT symbols. Set by coff_slurp_symbol_table. *}
257 .unsigned int fix_value : 1;
259 . {* Should the tag field of this symbol be renumbered.
260 . Created by coff_pointerize_aux. *}
261 .unsigned int fix_tag : 1;
263 . {* Should the endidx field of this symbol be renumbered.
264 . Created by coff_pointerize_aux. *}
265 .unsigned int fix_end : 1;
267 . {* Should the x_csect.x_scnlen field be renumbered.
268 . Created by coff_slurp_symbol_table. *}
269 .unsigned int fix_scnlen : 1;
271 . {* The container for the symbol structure as read and translated
275 . union internal_auxent auxent;
276 . struct internal_syment syment;
278 .} combined_entry_type;
281 .{* Each canonical asymbol really looks like this: *}
283 .typedef struct coff_symbol_struct
285 . {* The actual symbol which the rest of BFD works with *}
288 . {* A pointer to the hidden information for this symbol *}
289 .combined_entry_type *native;
291 . {* A pointer to the linenumber information for this symbol *}
292 .struct lineno_cache_entry *lineno;
294 . {* Have the line numbers been relocated yet ? *}
295 .boolean done_lineno;
301 #include "coffswap.h"
303 /* void warning(); */
306 * Return a word with STYP_* (scnhdr.s_flags) flags set to represent the
307 * incoming SEC_* flags. The inverse of this function is styp_to_sec_flags().
308 * NOTE: If you add to/change this routine, you should mirror the changes
309 * in styp_to_sec_flags().
312 sec_to_styp_flags (sec_name
, sec_flags
)
313 CONST
char *sec_name
;
318 if (!strcmp (sec_name
, _TEXT
))
320 styp_flags
= STYP_TEXT
;
322 else if (!strcmp (sec_name
, _DATA
))
324 styp_flags
= STYP_DATA
;
327 else if (!strcmp (sec_name
, ".data2"))
329 styp_flags
= STYP_DATA
;
330 #endif /* TWO_DATA_SECS */
332 else if (!strcmp (sec_name
, _BSS
))
334 styp_flags
= STYP_BSS
;
337 else if (!strcmp (sec_name
, _COMMENT
))
339 styp_flags
= STYP_INFO
;
340 #endif /* _COMMENT */
343 else if (!strcmp (sec_name
, _LIB
))
345 styp_flags
= STYP_LIB
;
349 else if (!strcmp (sec_name
, _LIT
))
351 styp_flags
= STYP_LIT
;
354 else if (!strcmp (sec_name
, ".debug"))
357 styp_flags
= STYP_DEBUG
;
359 styp_flags
= STYP_INFO
;
362 else if (!strcmp (sec_name
, ".stab")
363 || !strncmp (sec_name
, ".stabstr", 8))
365 styp_flags
= STYP_INFO
;
367 /* Try and figure out what it should be */
368 else if (sec_flags
& SEC_CODE
)
370 styp_flags
= STYP_TEXT
;
372 else if (sec_flags
& SEC_DATA
)
374 styp_flags
= STYP_DATA
;
376 else if (sec_flags
& SEC_READONLY
)
378 #ifdef STYP_LIT /* 29k readonly text/data section */
379 styp_flags
= STYP_LIT
;
381 styp_flags
= STYP_TEXT
;
382 #endif /* STYP_LIT */
384 else if (sec_flags
& SEC_LOAD
)
386 styp_flags
= STYP_TEXT
;
388 else if (sec_flags
& SEC_ALLOC
)
390 styp_flags
= STYP_BSS
;
394 if ((sec_flags
& (SEC_NEVER_LOAD
| SEC_COFF_SHARED_LIBRARY
)) != 0)
395 styp_flags
|= STYP_NOLOAD
;
401 * Return a word with SEC_* flags set to represent the incoming
402 * STYP_* flags (from scnhdr.s_flags). The inverse of this
403 * function is sec_to_styp_flags().
404 * NOTE: If you add to/change this routine, you should mirror the changes
405 * in sec_to_styp_flags().
408 styp_to_sec_flags (abfd
, hdr
, name
)
413 struct internal_scnhdr
*internal_s
= (struct internal_scnhdr
*) hdr
;
414 long styp_flags
= internal_s
->s_flags
;
415 flagword sec_flags
= 0;
418 if (styp_flags
& STYP_NOLOAD
)
420 sec_flags
|= SEC_NEVER_LOAD
;
422 #endif /* STYP_NOLOAD */
424 /* For 386 COFF, at least, an unloadable text or data section is
425 actually a shared library section. */
426 if (styp_flags
& STYP_TEXT
)
428 if (sec_flags
& SEC_NEVER_LOAD
)
429 sec_flags
|= SEC_CODE
| SEC_COFF_SHARED_LIBRARY
;
431 sec_flags
|= SEC_CODE
| SEC_LOAD
| SEC_ALLOC
;
433 else if (styp_flags
& STYP_DATA
)
435 if (sec_flags
& SEC_NEVER_LOAD
)
436 sec_flags
|= SEC_DATA
| SEC_COFF_SHARED_LIBRARY
;
438 sec_flags
|= SEC_DATA
| SEC_LOAD
| SEC_ALLOC
;
440 else if (styp_flags
& STYP_BSS
)
442 #ifdef BSS_NOLOAD_IS_SHARED_LIBRARY
443 if (sec_flags
& SEC_NEVER_LOAD
)
444 sec_flags
|= SEC_ALLOC
| SEC_COFF_SHARED_LIBRARY
;
447 sec_flags
|= SEC_ALLOC
;
449 else if (styp_flags
& STYP_INFO
)
451 /* We mark these as SEC_DEBUGGING, but only if COFF_PAGE_SIZE is
452 defined. coff_compute_section_file_positions uses
453 COFF_PAGE_SIZE to ensure that the low order bits of the
454 section VMA and the file offset match. If we don't know
455 COFF_PAGE_SIZE, we can't ensure the correct correspondence,
456 and demand page loading of the file will fail. */
457 #ifdef COFF_PAGE_SIZE
458 sec_flags
|= SEC_DEBUGGING
;
461 else if (strcmp (name
, _TEXT
) == 0)
463 if (sec_flags
& SEC_NEVER_LOAD
)
464 sec_flags
|= SEC_CODE
| SEC_COFF_SHARED_LIBRARY
;
466 sec_flags
|= SEC_CODE
| SEC_LOAD
| SEC_ALLOC
;
468 else if (strcmp (name
, _DATA
) == 0
470 || strcmp (name
, ".data2") == 0
474 if (sec_flags
& SEC_NEVER_LOAD
)
475 sec_flags
|= SEC_DATA
| SEC_COFF_SHARED_LIBRARY
;
477 sec_flags
|= SEC_DATA
| SEC_LOAD
| SEC_ALLOC
;
479 else if (strcmp (name
, _BSS
) == 0)
481 #ifdef BSS_NOLOAD_IS_SHARED_LIBRARY
482 if (sec_flags
& SEC_NEVER_LOAD
)
483 sec_flags
|= SEC_ALLOC
| SEC_COFF_SHARED_LIBRARY
;
486 sec_flags
|= SEC_ALLOC
;
488 else if (strcmp (name
, ".debug") == 0
490 || strcmp (name
, _COMMENT
) == 0
492 || strcmp (name
, ".stab") == 0
493 || strcmp (name
, ".stabstr") == 0)
495 #ifdef COFF_PAGE_SIZE
496 sec_flags
|= SEC_DEBUGGING
;
500 else if (strcmp (name
, _LIB
) == 0)
504 else if (strcmp (name
, _LIT
) == 0)
506 sec_flags
= SEC_LOAD
| SEC_ALLOC
| SEC_READONLY
;
511 sec_flags
|= SEC_ALLOC
| SEC_LOAD
;
514 #ifdef STYP_LIT /* A29k readonly text/data section type */
515 if ((styp_flags
& STYP_LIT
) == STYP_LIT
)
517 sec_flags
= (SEC_LOAD
| SEC_ALLOC
| SEC_READONLY
);
519 #endif /* STYP_LIT */
520 #ifdef STYP_OTHER_LOAD /* Other loaded sections */
521 if (styp_flags
& STYP_OTHER_LOAD
)
523 sec_flags
= (SEC_LOAD
| SEC_ALLOC
);
525 #endif /* STYP_SDATA */
530 #define get_index(symbol) ((long) (symbol)->udata)
534 bfd_coff_backend_data
538 Special entry points for gdb to swap in coff symbol table parts:
541 . void (*_bfd_coff_swap_aux_in) PARAMS ((
550 . void (*_bfd_coff_swap_sym_in) PARAMS ((
555 . void (*_bfd_coff_swap_lineno_in) PARAMS ((
561 Special entry points for gas to swap out coff parts:
563 . unsigned int (*_bfd_coff_swap_aux_out) PARAMS ((
572 . unsigned int (*_bfd_coff_swap_sym_out) PARAMS ((
577 . unsigned int (*_bfd_coff_swap_lineno_out) PARAMS ((
582 . unsigned int (*_bfd_coff_swap_reloc_out) PARAMS ((
587 . unsigned int (*_bfd_coff_swap_filehdr_out) PARAMS ((
592 . unsigned int (*_bfd_coff_swap_aouthdr_out) PARAMS ((
597 . unsigned int (*_bfd_coff_swap_scnhdr_out) PARAMS ((
603 Special entry points for generic COFF routines to call target
604 dependent COFF routines:
606 . unsigned int _bfd_filhsz;
607 . unsigned int _bfd_aoutsz;
608 . unsigned int _bfd_scnhsz;
609 . unsigned int _bfd_symesz;
610 . unsigned int _bfd_auxesz;
611 . unsigned int _bfd_linesz;
612 . boolean _bfd_coff_long_filenames;
613 . void (*_bfd_coff_swap_filehdr_in) PARAMS ((
617 . void (*_bfd_coff_swap_aouthdr_in) PARAMS ((
621 . void (*_bfd_coff_swap_scnhdr_in) PARAMS ((
625 . boolean (*_bfd_coff_bad_format_hook) PARAMS ((
627 . PTR internal_filehdr));
628 . boolean (*_bfd_coff_set_arch_mach_hook) PARAMS ((
630 . PTR internal_filehdr));
631 . PTR (*_bfd_coff_mkobject_hook) PARAMS ((
633 . PTR internal_filehdr,
634 . PTR internal_aouthdr));
635 . flagword (*_bfd_styp_to_sec_flags_hook) PARAMS ((
637 . PTR internal_scnhdr,
638 . const char *name));
639 . asection *(*_bfd_make_section_hook) PARAMS ((
642 . void (*_bfd_set_alignment_hook) PARAMS ((
645 . PTR internal_scnhdr));
646 . boolean (*_bfd_coff_slurp_symbol_table) PARAMS ((
648 . boolean (*_bfd_coff_symname_in_debug) PARAMS ((
650 . struct internal_syment *sym));
651 . void (*_bfd_coff_reloc16_extra_cases) PARAMS ((
653 . struct bfd_link_info *link_info,
654 . struct bfd_link_order *link_order,
657 . unsigned int *src_ptr,
658 . unsigned int *dst_ptr));
659 . int (*_bfd_coff_reloc16_estimate) PARAMS ((
661 . asection *input_section,
663 . unsigned int shrink,
664 . struct bfd_link_info *link_info));
666 .} bfd_coff_backend_data;
668 .#define coff_backend_info(abfd) ((bfd_coff_backend_data *) (abfd)->xvec->backend_data)
670 .#define bfd_coff_swap_aux_in(a,e,t,c,ind,num,i) \
671 . ((coff_backend_info (a)->_bfd_coff_swap_aux_in) (a,e,t,c,ind,num,i))
673 .#define bfd_coff_swap_sym_in(a,e,i) \
674 . ((coff_backend_info (a)->_bfd_coff_swap_sym_in) (a,e,i))
676 .#define bfd_coff_swap_lineno_in(a,e,i) \
677 . ((coff_backend_info ( a)->_bfd_coff_swap_lineno_in) (a,e,i))
679 .#define bfd_coff_swap_reloc_out(abfd, i, o) \
680 . ((coff_backend_info (abfd)->_bfd_coff_swap_reloc_out) (abfd, i, o))
682 .#define bfd_coff_swap_lineno_out(abfd, i, o) \
683 . ((coff_backend_info (abfd)->_bfd_coff_swap_lineno_out) (abfd, i, o))
685 .#define bfd_coff_swap_aux_out(a,i,t,c,ind,num,o) \
686 . ((coff_backend_info (a)->_bfd_coff_swap_aux_out) (a,i,t,c,ind,num,o))
688 .#define bfd_coff_swap_sym_out(abfd, i,o) \
689 . ((coff_backend_info (abfd)->_bfd_coff_swap_sym_out) (abfd, i, o))
691 .#define bfd_coff_swap_scnhdr_out(abfd, i,o) \
692 . ((coff_backend_info (abfd)->_bfd_coff_swap_scnhdr_out) (abfd, i, o))
694 .#define bfd_coff_swap_filehdr_out(abfd, i,o) \
695 . ((coff_backend_info (abfd)->_bfd_coff_swap_filehdr_out) (abfd, i, o))
697 .#define bfd_coff_swap_aouthdr_out(abfd, i,o) \
698 . ((coff_backend_info (abfd)->_bfd_coff_swap_aouthdr_out) (abfd, i, o))
700 .#define bfd_coff_filhsz(abfd) (coff_backend_info (abfd)->_bfd_filhsz)
701 .#define bfd_coff_aoutsz(abfd) (coff_backend_info (abfd)->_bfd_aoutsz)
702 .#define bfd_coff_scnhsz(abfd) (coff_backend_info (abfd)->_bfd_scnhsz)
703 .#define bfd_coff_symesz(abfd) (coff_backend_info (abfd)->_bfd_symesz)
704 .#define bfd_coff_auxesz(abfd) (coff_backend_info (abfd)->_bfd_auxesz)
705 .#define bfd_coff_linesz(abfd) (coff_backend_info (abfd)->_bfd_linesz)
706 .#define bfd_coff_long_filenames(abfd) (coff_backend_info (abfd)->_bfd_coff_long_filenames)
707 .#define bfd_coff_swap_filehdr_in(abfd, i,o) \
708 . ((coff_backend_info (abfd)->_bfd_coff_swap_filehdr_in) (abfd, i, o))
710 .#define bfd_coff_swap_aouthdr_in(abfd, i,o) \
711 . ((coff_backend_info (abfd)->_bfd_coff_swap_aouthdr_in) (abfd, i, o))
713 .#define bfd_coff_swap_scnhdr_in(abfd, i,o) \
714 . ((coff_backend_info (abfd)->_bfd_coff_swap_scnhdr_in) (abfd, i, o))
716 .#define bfd_coff_bad_format_hook(abfd, filehdr) \
717 . ((coff_backend_info (abfd)->_bfd_coff_bad_format_hook) (abfd, filehdr))
719 .#define bfd_coff_set_arch_mach_hook(abfd, filehdr)\
720 . ((coff_backend_info (abfd)->_bfd_coff_set_arch_mach_hook) (abfd, filehdr))
721 .#define bfd_coff_mkobject_hook(abfd, filehdr, aouthdr)\
722 . ((coff_backend_info (abfd)->_bfd_coff_mkobject_hook) (abfd, filehdr, aouthdr))
724 .#define bfd_coff_styp_to_sec_flags_hook(abfd, scnhdr, name)\
725 . ((coff_backend_info (abfd)->_bfd_styp_to_sec_flags_hook) (abfd, scnhdr, name))
727 .#define bfd_coff_make_section_hook(abfd, name)\
728 . ((coff_backend_info (abfd)->_bfd_make_section_hook) (abfd, name))
730 .#define bfd_coff_set_alignment_hook(abfd, sec, scnhdr)\
731 . ((coff_backend_info (abfd)->_bfd_set_alignment_hook) (abfd, sec, scnhdr))
733 .#define bfd_coff_slurp_symbol_table(abfd)\
734 . ((coff_backend_info (abfd)->_bfd_coff_slurp_symbol_table) (abfd))
736 .#define bfd_coff_symname_in_debug(abfd, sym)\
737 . ((coff_backend_info (abfd)->_bfd_coff_symname_in_debug) (abfd, sym))
739 .#define bfd_coff_reloc16_extra_cases(abfd, link_info, link_order, reloc, data, src_ptr, dst_ptr)\
740 . ((coff_backend_info (abfd)->_bfd_coff_reloc16_extra_cases)\
741 . (abfd, link_info, link_order, reloc, data, src_ptr, dst_ptr))
743 .#define bfd_coff_reloc16_estimate(abfd, section, reloc, shrink, link_info)\
744 . ((coff_backend_info (abfd)->_bfd_coff_reloc16_estimate)\
745 . (abfd, section, reloc, shrink, link_info))
749 /* See whether the magic number matches. */
752 coff_bad_format_hook (abfd
, filehdr
)
756 struct internal_filehdr
*internal_f
= (struct internal_filehdr
*) filehdr
;
758 if (BADMAG (*internal_f
))
761 /* if the optional header is NULL or not the correct size then
762 quit; the only difference I can see between m88k dgux headers (MC88DMAGIC)
763 and Intel 960 readwrite headers (I960WRMAGIC) is that the
764 optional header is of a different size.
766 But the mips keeps extra stuff in it's opthdr, so dont check
770 #if defined(M88) || defined(I960)
771 if (internal_f
->f_opthdr
!= 0 && AOUTSZ
!= internal_f
->f_opthdr
)
779 coff_make_section_hook (abfd
, name
)
784 /* FIXME: This predates the call to bfd_make_section_anyway
785 in make_a_section_from_file, and can probably go away. */
786 /* On SCO a file created by the Microsoft assembler can have two
787 .data sections. We use .data2 for the second one. */
788 if (strcmp (name
, _DATA
) == 0)
789 return bfd_make_section (abfd
, ".data2");
791 return (asection
*) NULL
;
795 initialize a section structure with information peculiar to this
796 particular implementation of coff
800 coff_new_section_hook (abfd
, section
)
804 section
->alignment_power
= abfd
->xvec
->align_power_min
;
805 /* Allocate aux records for section symbols, to store size and
808 @@ Shouldn't use constant multiplier here! */
809 coffsymbol (section
->symbol
)->native
=
810 (combined_entry_type
*) bfd_zalloc (abfd
,
811 sizeof (combined_entry_type
) * 10);
814 /* This is to allow double-word operations on addresses in data or bss. */
815 if (strcmp (section
->name
, ".data") == 0
816 || strcmp (section
->name
, ".bss") == 0)
817 section
->alignment_power
= 3;
818 #endif /* COFF_SPARC */
826 /* Set the alignment of a BFD section. */
829 coff_set_alignment_hook (abfd
, section
, scnhdr
)
834 struct internal_scnhdr
*hdr
= (struct internal_scnhdr
*) scnhdr
;
837 for (i
= 0; i
< 32; i
++)
838 if ((1 << i
) >= hdr
->s_align
)
840 section
->alignment_power
= i
;
845 #define coff_set_alignment_hook \
846 ((void (*) PARAMS ((bfd *, asection *, PTR))) bfd_void)
854 coff_data_type
*coff
;
856 abfd
->tdata
.coff_obj_data
= (struct coff_tdata
*) bfd_zalloc (abfd
, sizeof (coff_data_type
));
857 if (abfd
->tdata
.coff_obj_data
== 0)
859 bfd_set_error (bfd_error_no_memory
);
862 coff
= coff_data (abfd
);
863 coff
->symbols
= (coff_symbol_type
*) NULL
;
864 coff
->conversion_table
= (unsigned int *) NULL
;
865 coff
->raw_syments
= (struct coff_ptr_struct
*) NULL
;
866 coff
->raw_linenos
= (struct lineno
*) NULL
;
868 /* make_abs_section(abfd);*/
872 /* Create the COFF backend specific information. */
875 coff_mkobject_hook (abfd
, filehdr
, aouthdr
)
880 struct internal_filehdr
*internal_f
= (struct internal_filehdr
*) filehdr
;
881 coff_data_type
*coff
;
883 if (coff_mkobject (abfd
) == false)
886 coff
= coff_data (abfd
);
888 coff
->sym_filepos
= internal_f
->f_symptr
;
889 coff
->flags
= internal_f
->f_flags
;
891 /* These members communicate important constants about the symbol
892 table to GDB's symbol-reading code. These `constants'
893 unfortunately vary among coff implementations... */
894 coff
->local_n_btmask
= N_BTMASK
;
895 coff
->local_n_btshft
= N_BTSHFT
;
896 coff
->local_n_tmask
= N_TMASK
;
897 coff
->local_n_tshift
= N_TSHIFT
;
898 coff
->local_symesz
= SYMESZ
;
899 coff
->local_auxesz
= AUXESZ
;
900 coff
->local_linesz
= LINESZ
;
905 /* Determine the machine architecture and type. FIXME: This is target
906 dependent because the magic numbers are defined in the target
907 dependent header files. But there is no particular need for this.
908 If the magic numbers were moved to a separate file, this function
909 would be target independent and would also be much more successful
910 at linking together COFF files for different architectures. */
913 coff_set_arch_mach_hook (abfd
, filehdr
)
918 enum bfd_architecture arch
;
919 struct internal_filehdr
*internal_f
= (struct internal_filehdr
*) filehdr
;
922 switch (internal_f
->f_magic
)
927 case I386AIXMAGIC
: /* Danbury PS/2 AIX C Compiler */
928 case LYNXCOFFMAGIC
: /* shadows the m68k Lynx number below, sigh */
929 arch
= bfd_arch_i386
;
934 #ifdef A29K_MAGIC_BIG
936 case A29K_MAGIC_LITTLE
:
937 arch
= bfd_arch_a29k
;
948 #ifdef APOLLOM68KMAGIC
949 case APOLLOM68KMAGIC
:
954 arch
= bfd_arch_m68k
;
962 arch
= bfd_arch_m88k
;
969 switch (internal_f
->f_flags
& F_MACHMASK
)
972 machine
= bfd_mach_z8001
;
975 machine
= bfd_mach_z8002
;
986 arch
= bfd_arch_i960
;
987 switch (F_I960TYPE
& internal_f
->f_flags
)
991 machine
= bfd_mach_i960_core
;
994 machine
= bfd_mach_i960_kb_sb
;
997 machine
= bfd_mach_i960_mc
;
1000 machine
= bfd_mach_i960_xa
;
1003 machine
= bfd_mach_i960_ca
;
1006 machine
= bfd_mach_i960_ka_sa
;
1008 /* start-sanitize-i960xl */
1010 machine
= bfd_mach_i960_xl
;
1012 /* end-sanitize-i960xl */
1022 arch
= bfd_arch_rs6000
;
1029 arch
= bfd_arch_we32k
;
1036 arch
= bfd_arch_h8300
;
1037 machine
= bfd_mach_h8300
;
1038 /* !! FIXME this probably isn't the right place for this */
1039 abfd
->flags
|= BFD_IS_RELAXABLE
;
1045 arch
= bfd_arch_h8300
;
1046 machine
= bfd_mach_h8300h
;
1047 /* !! FIXME this probably isn't the right place for this */
1048 abfd
->flags
|= BFD_IS_RELAXABLE
;
1052 #ifdef SH_ARCH_MAGIC
1061 arch
= bfd_arch_h8500
;
1068 #ifdef LYNXCOFFMAGIC
1071 arch
= bfd_arch_sparc
;
1076 default: /* Unreadable input file type */
1077 arch
= bfd_arch_obscure
;
1081 bfd_default_set_arch_mach (abfd
, arch
, machine
);
1085 #ifdef SYMNAME_IN_DEBUG
1088 symname_in_debug_hook (abfd
, sym
)
1090 struct internal_syment
*sym
;
1092 return SYMNAME_IN_DEBUG (sym
) ? true : false;
1097 #define symname_in_debug_hook \
1098 (boolean (*) PARAMS ((bfd *, struct internal_syment *))) bfd_false
1106 To write relocations, the back end steps though the
1107 canonical relocation table and create an
1108 @code{internal_reloc}. The symbol index to use is removed from
1109 the @code{offset} field in the symbol table supplied. The
1110 address comes directly from the sum of the section base
1111 address and the relocation offset; the type is dug directly
1112 from the howto field. Then the @code{internal_reloc} is
1113 swapped into the shape of an @code{external_reloc} and written
1119 coff_write_relocs (abfd
)
1123 for (s
= abfd
->sections
; s
!= (asection
*) NULL
; s
= s
->next
)
1126 struct external_reloc dst
;
1128 arelent
**p
= s
->orelocation
;
1129 if (bfd_seek (abfd
, s
->rel_filepos
, SEEK_SET
) != 0)
1131 for (i
= 0; i
< s
->reloc_count
; i
++)
1133 struct internal_reloc n
;
1135 memset ((PTR
) & n
, 0, sizeof (n
));
1137 n
.r_vaddr
= q
->address
+ s
->vma
;
1140 /* The 29k const/consth reloc pair is a real kludge. The consth
1141 part doesn't have a symbol; it has an offset. So rebuilt
1143 if (q
->howto
->type
== R_IHCONST
)
1144 n
.r_symndx
= q
->addend
;
1149 if (q
->sym_ptr_ptr
== bfd_abs_section_ptr
->symbol_ptr_ptr
)
1150 /* This is a relocation relative to the absolute symbol. */
1154 n
.r_symndx
= get_index ((*(q
->sym_ptr_ptr
)));
1155 /* Take notice if the symbol reloc points to a symbol
1156 we don't have in our symbol table. What should we
1158 if (n
.r_symndx
> obj_conv_table_size (abfd
))
1163 #ifdef SWAP_OUT_RELOC_OFFSET
1164 n
.r_offset
= q
->addend
;
1168 /* Work out reloc type from what is required */
1169 SELECT_RELOC (n
, q
->howto
);
1171 n
.r_type
= q
->howto
->type
;
1173 coff_swap_reloc_out (abfd
, &n
, &dst
);
1174 if (bfd_write ((PTR
) & dst
, 1, RELSZ
, abfd
) != RELSZ
)
1182 /* Set flags and magic number of a coff file from architecture and machine
1183 type. Result is true if we can represent the arch&type, false if not. */
1186 coff_set_flags (abfd
, magicp
, flagsp
)
1189 unsigned short *flagsp
;
1191 switch (bfd_get_arch (abfd
))
1196 switch (bfd_get_mach (abfd
))
1198 case bfd_mach_z8001
:
1201 case bfd_mach_z8002
:
1215 *magicp
= I960ROMAGIC
;
1217 ((bfd_get_file_flags(abfd) & WP_TEXT) ? I960ROMAGIC :
1218 I960RWMAGIC); FIXME???
1220 switch (bfd_get_mach (abfd
))
1222 case bfd_mach_i960_core
:
1225 case bfd_mach_i960_kb_sb
:
1228 case bfd_mach_i960_mc
:
1231 case bfd_mach_i960_xa
:
1234 case bfd_mach_i960_ca
:
1237 case bfd_mach_i960_ka_sa
:
1240 /* start-sanitize-i960xl */
1241 case bfd_mach_i960_xl
:
1244 /* end-sanitize-i960xl */
1255 *magicp
= I386MAGIC
;
1257 /* Just overwrite the usual value if we're doing Lynx. */
1258 *magicp
= LYNXCOFFMAGIC
;
1265 #ifdef APOLLOM68KMAGIC
1266 *magicp
= APOLLO_COFF_VERSION_NUMBER
;
1268 *magicp
= MC68MAGIC
;
1271 /* Just overwrite the usual value if we're doing Lynx. */
1272 *magicp
= LYNXCOFFMAGIC
;
1280 *magicp
= MC88OMAGIC
;
1285 case bfd_arch_h8300
:
1286 switch (bfd_get_mach (abfd
))
1288 case bfd_mach_h8300
:
1289 *magicp
= H8300MAGIC
;
1291 case bfd_mach_h8300h
:
1292 *magicp
= H8300HMAGIC
;
1298 #ifdef SH_ARCH_MAGIC
1300 *magicp
= SH_ARCH_MAGIC
;
1306 case bfd_arch_sparc
:
1307 *magicp
= SPARCMAGIC
;
1309 /* Just overwrite the usual value if we're doing Lynx. */
1310 *magicp
= LYNXCOFFMAGIC
;
1317 case bfd_arch_h8500
:
1318 *magicp
= H8500MAGIC
;
1322 #ifdef A29K_MAGIC_BIG
1324 if (abfd
->xvec
->byteorder_big_p
)
1325 *magicp
= A29K_MAGIC_BIG
;
1327 *magicp
= A29K_MAGIC_LITTLE
;
1333 case bfd_arch_we32k
:
1334 *magicp
= WE32KMAGIC
;
1340 case bfd_arch_rs6000
:
1341 case bfd_arch_powerpc
:
1342 *magicp
= U802TOCMAGIC
;
1347 default: /* Unknown architecture */
1348 /* return false; -- fall through to "return false" below, to avoid
1349 "statement never reached" errors on the one below. */
1358 coff_set_arch_mach (abfd
, arch
, machine
)
1360 enum bfd_architecture arch
;
1361 unsigned long machine
;
1364 unsigned short dummy2
;
1366 if (! bfd_default_set_arch_mach (abfd
, arch
, machine
))
1369 if (arch
!= bfd_arch_unknown
&&
1370 coff_set_flags (abfd
, &dummy1
, &dummy2
) != true)
1371 return false; /* We can't represent this type */
1373 return true; /* We're easy ... */
1377 /* Calculate the file position for each section. */
1380 coff_compute_section_file_positions (abfd
)
1384 asection
*previous
= (asection
*) NULL
;
1385 file_ptr sofar
= FILHSZ
;
1389 if (bfd_get_start_address (abfd
))
1391 /* A start address may have been added to the original file. In this
1392 case it will need an optional header to record it. */
1393 abfd
->flags
|= EXEC_P
;
1396 if (abfd
->flags
& EXEC_P
)
1399 sofar
+= abfd
->section_count
* SCNHSZ
;
1400 for (current
= abfd
->sections
;
1401 current
!= (asection
*) NULL
;
1402 current
= current
->next
)
1405 /* Only deal with sections which have contents */
1406 if (!(current
->flags
& SEC_HAS_CONTENTS
))
1409 /* Align the sections in the file to the same boundary on
1410 which they are aligned in virtual memory. I960 doesn't
1411 do this (FIXME) so we can stay in sync with Intel. 960
1412 doesn't yet page from files... */
1415 /* make sure this section is aligned on the right boundary - by
1416 padding the previous section up if necessary */
1419 sofar
= BFD_ALIGN (sofar
, 1 << current
->alignment_power
);
1420 if (previous
!= (asection
*) NULL
)
1422 previous
->_raw_size
+= sofar
- old_sofar
;
1428 #ifdef COFF_PAGE_SIZE
1429 /* In demand paged files the low order bits of the file offset
1430 must match the low order bits of the virtual address. */
1431 if ((abfd
->flags
& D_PAGED
) != 0
1432 && (current
->flags
& SEC_ALLOC
) != 0)
1433 sofar
+= (current
->vma
- sofar
) % COFF_PAGE_SIZE
;
1436 current
->filepos
= sofar
;
1438 sofar
+= current
->_raw_size
;
1440 /* make sure that this section is of the right size too */
1442 sofar
= BFD_ALIGN (sofar
, 1 << current
->alignment_power
);
1443 current
->_raw_size
+= sofar
- old_sofar
;
1447 /* Force .lib sections to start at zero. The vma is then
1448 incremented in coff_set_section_contents. This is right for
1450 if (strcmp (current
->name
, _LIB
) == 0)
1451 bfd_set_section_vma (abfd
, current
, 0);
1456 obj_relocbase (abfd
) = sofar
;
1459 #ifndef RS6000COFF_C
1461 /* If .file, .text, .data, .bss symbols are missing, add them. */
1462 /* @@ Should we only be adding missing symbols, or overriding the aux
1463 values for existing section symbols? */
1465 coff_add_missing_symbols (abfd
)
1468 unsigned int nsyms
= bfd_get_symcount (abfd
);
1469 asymbol
**sympp
= abfd
->outsymbols
;
1472 int need_text
= 1, need_data
= 1, need_bss
= 1, need_file
= 1;
1474 for (i
= 0; i
< nsyms
; i
++)
1476 coff_symbol_type
*csym
= coff_symbol_from (abfd
, sympp
[i
]);
1480 /* only do this if there is a coff representation of the input
1482 if (csym
->native
&& csym
->native
->u
.syment
.n_sclass
== C_FILE
)
1487 name
= csym
->symbol
.name
;
1490 if (!strcmp (name
, _TEXT
))
1493 else if (!strcmp (name
, ".wtext"))
1496 else if (!strcmp (name
, _DATA
))
1498 else if (!strcmp (name
, _BSS
))
1502 /* Now i == bfd_get_symcount (abfd). */
1503 /* @@ For now, don't deal with .file symbol. */
1506 if (!need_text
&& !need_data
&& !need_bss
&& !need_file
)
1508 nsyms
+= need_text
+ need_data
+ need_bss
+ need_file
;
1509 sympp2
= (asymbol
**) bfd_alloc_by_size_t (abfd
, nsyms
* sizeof (asymbol
*));
1512 bfd_set_error (bfd_error_no_memory
);
1515 memcpy (sympp2
, sympp
, i
* sizeof (asymbol
*));
1518 /* @@ Generate fake .file symbol, in sympp2[i], and increment i. */
1522 sympp2
[i
++] = coff_section_symbol (abfd
, _TEXT
);
1524 sympp2
[i
++] = coff_section_symbol (abfd
, _DATA
);
1526 sympp2
[i
++] = coff_section_symbol (abfd
, _BSS
);
1527 BFD_ASSERT (i
== nsyms
);
1528 bfd_set_symtab (abfd
, sympp2
, nsyms
);
1532 #endif /* ! defined (RS6000COFF_C) */
1537 coff_write_object_contents (abfd
)
1543 boolean hasrelocs
= false;
1544 boolean haslinno
= false;
1545 file_ptr reloc_base
;
1546 file_ptr lineno_base
;
1550 unsigned long reloc_size
= 0;
1551 unsigned long lnno_size
= 0;
1552 asection
*text_sec
= NULL
;
1553 asection
*data_sec
= NULL
;
1554 asection
*bss_sec
= NULL
;
1556 struct internal_filehdr internal_f
;
1557 struct internal_aouthdr internal_a
;
1560 bfd_set_error (bfd_error_system_call
);
1561 /* Number the output sections, starting from one on the first section
1562 with a name which doesn't start with a *.
1563 @@ The code doesn't make this check. Is it supposed to be done,
1566 for (current
= abfd
->sections
; current
!= (asection
*) NULL
;
1567 current
= current
->next
)
1569 current
->target_index
= count
;
1573 if (abfd
->output_has_begun
== false)
1575 coff_compute_section_file_positions (abfd
);
1578 if (abfd
->sections
!= (asection
*) NULL
)
1580 scn_base
= abfd
->sections
->filepos
;
1586 if (bfd_seek (abfd
, scn_base
, SEEK_SET
) != 0)
1588 reloc_base
= obj_relocbase (abfd
);
1590 /* Make a pass through the symbol table to count line number entries and
1591 put them into the correct asections */
1593 lnno_size
= coff_count_linenumbers (abfd
) * LINESZ
;
1594 data_base
= scn_base
;
1596 /* Work out the size of the reloc and linno areas */
1598 for (current
= abfd
->sections
; current
!= NULL
; current
=
1601 /* We give section headers to +ve indexes */
1602 if (current
->target_index
> 0)
1605 reloc_size
+= current
->reloc_count
* RELSZ
;
1606 data_base
+= SCNHSZ
;
1611 lineno_base
= reloc_base
+ reloc_size
;
1612 sym_base
= lineno_base
+ lnno_size
;
1614 /* Indicate in each section->line_filepos its actual file address */
1615 for (current
= abfd
->sections
; current
!= NULL
; current
=
1618 if (current
->target_index
> 0)
1621 if (current
->lineno_count
)
1623 current
->line_filepos
= lineno_base
;
1624 current
->moving_line_filepos
= lineno_base
;
1625 lineno_base
+= current
->lineno_count
* LINESZ
;
1629 current
->line_filepos
= 0;
1631 if (current
->reloc_count
)
1633 current
->rel_filepos
= reloc_base
;
1634 reloc_base
+= current
->reloc_count
* RELSZ
;
1638 current
->rel_filepos
= 0;
1645 /* Write section headers to the file. */
1646 internal_f
.f_nscns
= 0;
1648 (file_ptr
) ((abfd
->flags
& EXEC_P
) ?
1649 (FILHSZ
+ AOUTSZ
) : FILHSZ
),
1656 unsigned int pad
= abfd
->flags
& D_PAGED
? data_base
: 0;
1658 unsigned int pad
= 0;
1660 for (current
= abfd
->sections
;
1662 current
= current
->next
)
1664 struct internal_scnhdr section
;
1665 if (current
->target_index
> 0)
1667 internal_f
.f_nscns
++;
1668 strncpy (&(section
.s_name
[0]), current
->name
, 8);
1670 /* Always set s_vaddr of .lib to 0. This is right for SVR3.2
1671 Ian Taylor <ian@cygnus.com>. */
1672 if (strcmp (current
->name
, _LIB
) == 0)
1673 section
.s_vaddr
= 0;
1676 section
.s_vaddr
= current
->lma
+ pad
;
1677 section
.s_paddr
= current
->lma
+ pad
;
1678 section
.s_size
= current
->_raw_size
- pad
;
1680 If this section has no size or is unloadable then the scnptr
1683 if (current
->_raw_size
- pad
== 0 ||
1684 (current
->flags
& (SEC_LOAD
| SEC_HAS_CONTENTS
)) == 0)
1686 section
.s_scnptr
= 0;
1690 section
.s_scnptr
= current
->filepos
;
1692 section
.s_relptr
= current
->rel_filepos
;
1693 section
.s_lnnoptr
= current
->line_filepos
;
1694 section
.s_nreloc
= current
->reloc_count
;
1695 section
.s_nlnno
= current
->lineno_count
;
1696 if (current
->reloc_count
!= 0)
1698 if (current
->lineno_count
!= 0)
1701 section
.s_flags
= sec_to_styp_flags (current
->name
, current
->flags
);
1703 if (!strcmp (current
->name
, _TEXT
))
1707 else if (!strcmp (current
->name
, _DATA
))
1710 #ifdef TWO_DATA_SECS
1712 else if (!strcmp (current
->name
, ".data2"))
1715 #endif /* TWO_DATA_SECS */
1717 else if (!strcmp (current
->name
, _BSS
))
1723 section
.s_align
= (current
->alignment_power
1724 ? 1 << current
->alignment_power
1731 coff_swap_scnhdr_out (abfd
, §ion
, &buff
);
1732 if (bfd_write ((PTR
) (&buff
), 1, SCNHSZ
, abfd
) != SCNHSZ
)
1743 /* OK, now set up the filehdr... */
1745 /* Don't include the internal abs section in the section count */
1748 We will NOT put a fucking timestamp in the header here. Every time you
1749 put it back, I will come in and take it out again. I'm sorry. This
1750 field does not belong here. We fill it with a 0 so it compares the
1751 same but is not a reasonable time. -- gnu@cygnus.com
1753 internal_f
.f_timdat
= 0;
1755 if (bfd_get_symcount (abfd
) != 0)
1756 internal_f
.f_symptr
= sym_base
;
1758 internal_f
.f_symptr
= 0;
1760 internal_f
.f_flags
= 0;
1762 if (abfd
->flags
& EXEC_P
)
1763 internal_f
.f_opthdr
= AOUTSZ
;
1765 internal_f
.f_opthdr
= 0;
1768 internal_f
.f_flags
|= F_RELFLG
;
1770 internal_f
.f_flags
|= F_LNNO
;
1771 if (0 == bfd_get_symcount (abfd
))
1772 internal_f
.f_flags
|= F_LSYMS
;
1773 if (abfd
->flags
& EXEC_P
)
1774 internal_f
.f_flags
|= F_EXEC
;
1776 if (!abfd
->xvec
->byteorder_big_p
)
1777 internal_f
.f_flags
|= F_AR32WR
;
1779 internal_f
.f_flags
|= F_AR32W
;
1782 FIXME, should do something about the other byte orders and
1786 memset (&internal_a
, 0, sizeof internal_a
);
1788 /* Set up architecture-dependent stuff */
1791 unsigned int magic
= 0;
1792 unsigned short flags
= 0;
1793 coff_set_flags (abfd
, &magic
, &flags
);
1794 internal_f
.f_magic
= magic
;
1795 internal_f
.f_flags
|= flags
;
1796 /* ...and the "opt"hdr... */
1799 #ifdef ULTRA3 /* NYU's machine */
1800 /* FIXME: This is a bogus check. I really want to see if there
1801 * is a .shbss or a .shdata section, if so then set the magic
1802 * number to indicate a shared data executable.
1804 if (internal_f
.f_nscns
>= 7)
1805 internal_a
.magic
= SHMAGIC
; /* Shared magic */
1808 internal_a
.magic
= NMAGIC
;/* Assume separate i/d */
1809 #define __A_MAGIC_SET__
1812 internal_a
.magic
= (magic
== I960ROMAGIC
? NMAGIC
: OMAGIC
);
1813 #define __A_MAGIC_SET__
1816 #define __A_MAGIC_SET__
1817 internal_a
.magic
= PAGEMAGICBCS
;
1821 #define __A_MAGIC_SET__
1822 internal_a
.magic
= APOLLO_COFF_VERSION_NUMBER
;
1825 #if defined(M68) || defined(WE32K) || defined(M68K)
1826 #define __A_MAGIC_SET__
1828 internal_a
.magic
= LYNXCOFFMAGIC
;
1830 #endif /* M68 || WE32K || M68K */
1833 #define __A_MAGIC_SET__
1835 internal_a
.magic
= LYNXCOFFMAGIC
;
1837 internal_a
.magic
= ZMAGIC
;
1842 #define __A_MAGIC_SET__
1844 internal_a
.magic
= LYNXCOFFMAGIC
;
1849 #define __A_MAGIC_SET__
1850 internal_a
.magic
= (abfd
->flags
& D_PAGED
) ? RS6K_AOUTHDR_ZMAGIC
:
1851 (abfd
->flags
& WP_TEXT
) ? RS6K_AOUTHDR_NMAGIC
:
1852 RS6K_AOUTHDR_OMAGIC
;
1855 #ifndef __A_MAGIC_SET__
1856 #include "Your aouthdr magic number is not being set!"
1858 #undef __A_MAGIC_SET__
1861 /* Now should write relocs, strings, syms */
1862 obj_sym_filepos (abfd
) = sym_base
;
1864 if (bfd_get_symcount (abfd
) != 0)
1866 #ifndef RS6000COFF_C
1867 if (!coff_add_missing_symbols (abfd
))
1870 if (!coff_renumber_symbols (abfd
))
1872 coff_mangle_symbols (abfd
);
1873 if (! coff_write_symbols (abfd
))
1875 if (! coff_write_linenumbers (abfd
))
1877 if (! coff_write_relocs (abfd
))
1882 internal_a
.tsize
= bfd_get_section_size_before_reloc (text_sec
);
1883 internal_a
.text_start
= internal_a
.tsize
? text_sec
->vma
: 0;
1887 internal_a
.dsize
= bfd_get_section_size_before_reloc (data_sec
);
1888 internal_a
.data_start
= internal_a
.dsize
? data_sec
->vma
: 0;
1892 internal_a
.bsize
= bfd_get_section_size_before_reloc (bss_sec
);
1895 internal_a
.entry
= bfd_get_start_address (abfd
);
1896 internal_f
.f_nsyms
= bfd_get_symcount (abfd
);
1898 /* now write them */
1899 if (bfd_seek (abfd
, (file_ptr
) 0, SEEK_SET
) != 0)
1903 coff_swap_filehdr_out (abfd
, (PTR
) & internal_f
, (PTR
) & buff
);
1904 if (bfd_write ((PTR
) & buff
, 1, FILHSZ
, abfd
) != FILHSZ
)
1907 if (abfd
->flags
& EXEC_P
)
1910 coff_swap_aouthdr_out (abfd
, (PTR
) & internal_a
, (PTR
) & buff
);
1911 if (bfd_write ((PTR
) & buff
, 1, AOUTSZ
, abfd
) != AOUTSZ
)
1918 coff_set_section_contents (abfd
, section
, location
, offset
, count
)
1923 bfd_size_type count
;
1925 if (abfd
->output_has_begun
== false) /* set by bfd.c handler */
1926 coff_compute_section_file_positions (abfd
);
1929 /* If this is a .lib section, bump the vma address so that it
1930 winds up being the number of .lib sections output. This is
1931 right for SVR3.2. Shared libraries should probably get more
1932 generic support. Ian Taylor <ian@cygnus.com>. */
1933 if (strcmp (section
->name
, _LIB
) == 0)
1937 /* Don't write out bss sections - one way to do this is to
1938 see if the filepos has not been set. */
1939 if (section
->filepos
== 0)
1942 if (bfd_seek (abfd
, (file_ptr
) (section
->filepos
+ offset
), SEEK_SET
) != 0)
1947 return (bfd_write (location
, 1, count
, abfd
) == count
) ? true : false;
1953 coff_close_and_cleanup (abfd
)
1956 if (!bfd_read_p (abfd
))
1957 switch (abfd
->format
)
1960 if (!_bfd_write_archive_contents (abfd
))
1964 if (!coff_write_object_contents (abfd
))
1968 bfd_set_error (bfd_error_invalid_operation
);
1972 /* We depend on bfd_close to free all the memory on the obstack. */
1973 /* FIXME if bfd_release is not using obstacks! */
1980 buy_and_read (abfd
, where
, seek_direction
, size
)
1986 PTR area
= (PTR
) bfd_alloc (abfd
, size
);
1989 bfd_set_error (bfd_error_no_memory
);
1992 if (bfd_seek (abfd
, where
, seek_direction
) != 0
1993 || bfd_read (area
, 1, size
, abfd
) != size
)
1996 } /* buy_and_read() */
2002 Creating the linenumber table is done by reading in the entire
2003 coff linenumber table, and creating another table for internal use.
2005 A coff linenumber table is structured so that each function
2006 is marked as having a line number of 0. Each line within the
2007 function is an offset from the first line in the function. The
2008 base of the line number information for the table is stored in
2009 the symbol associated with the function.
2011 The information is copied from the external to the internal
2012 table, and each symbol which marks a function is marked by
2015 How does this work ?
2020 coff_slurp_line_table (abfd
, asect
)
2024 LINENO
*native_lineno
;
2025 alent
*lineno_cache
;
2027 BFD_ASSERT (asect
->lineno
== (alent
*) NULL
);
2029 native_lineno
= (LINENO
*) buy_and_read (abfd
,
2030 asect
->line_filepos
,
2033 asect
->lineno_count
));
2035 (alent
*) bfd_alloc (abfd
, (size_t) ((asect
->lineno_count
+ 1) * sizeof (alent
)));
2036 if (lineno_cache
== NULL
)
2038 bfd_set_error (bfd_error_no_memory
);
2043 unsigned int counter
= 0;
2044 alent
*cache_ptr
= lineno_cache
;
2045 LINENO
*src
= native_lineno
;
2047 while (counter
< asect
->lineno_count
)
2049 struct internal_lineno dst
;
2050 coff_swap_lineno_in (abfd
, src
, &dst
);
2051 cache_ptr
->line_number
= dst
.l_lnno
;
2053 if (cache_ptr
->line_number
== 0)
2055 coff_symbol_type
*sym
=
2056 (coff_symbol_type
*) (dst
.l_addr
.l_symndx
2057 + obj_raw_syments (abfd
))->u
.syment
._n
._n_n
._n_zeroes
;
2058 cache_ptr
->u
.sym
= (asymbol
*) sym
;
2059 sym
->lineno
= cache_ptr
;
2063 cache_ptr
->u
.offset
= dst
.l_addr
.l_paddr
2064 - bfd_section_vma (abfd
, asect
);
2065 } /* If no linenumber expect a symbol index */
2071 cache_ptr
->line_number
= 0;
2074 asect
->lineno
= lineno_cache
;
2075 /* FIXME, free native_lineno here, or use alloca or something. */
2080 coff_slurp_symbol_table (abfd
)
2083 combined_entry_type
*native_symbols
;
2084 coff_symbol_type
*cached_area
;
2085 unsigned int *table_ptr
;
2087 unsigned int number_of_symbols
= 0;
2088 if (obj_symbols (abfd
))
2090 if (bfd_seek (abfd
, obj_sym_filepos (abfd
), SEEK_SET
) != 0)
2093 /* Read in the symbol table */
2094 if ((native_symbols
= coff_get_normalized_symtab (abfd
)) == NULL
)
2099 /* Allocate enough room for all the symbols in cached form */
2101 (coff_symbol_type
*)
2102 bfd_alloc (abfd
, (size_t) (bfd_get_symcount (abfd
) * sizeof (coff_symbol_type
)));
2104 if (cached_area
== NULL
)
2106 bfd_set_error (bfd_error_no_memory
);
2111 bfd_alloc (abfd
, (size_t) (bfd_get_symcount (abfd
) * sizeof (unsigned int)));
2113 if (table_ptr
== NULL
)
2115 bfd_set_error (bfd_error_no_memory
);
2120 coff_symbol_type
*dst
= cached_area
;
2121 unsigned int last_native_index
= bfd_get_symcount (abfd
);
2122 unsigned int this_index
= 0;
2123 while (this_index
< last_native_index
)
2125 combined_entry_type
*src
= native_symbols
+ this_index
;
2126 table_ptr
[this_index
] = number_of_symbols
;
2127 dst
->symbol
.the_bfd
= abfd
;
2129 dst
->symbol
.name
= (char *) (src
->u
.syment
._n
._n_n
._n_offset
);
2130 /* We use the native name field to point to the cached field. */
2131 src
->u
.syment
._n
._n_n
._n_zeroes
= (long) dst
;
2132 dst
->symbol
.section
= coff_section_from_bfd_index (abfd
,
2133 src
->u
.syment
.n_scnum
);
2134 dst
->symbol
.flags
= 0;
2135 dst
->done_lineno
= false;
2137 switch (src
->u
.syment
.n_sclass
)
2142 dst
->symbol
.value
= src
->u
.syment
.n_value
- dst
->symbol
.section
->vma
;
2143 dst
->symbol
.flags
= BSF_EXPORT
| BSF_GLOBAL
;
2144 dst
->symbol
.flags
|= BSF_NOT_AT_END
;
2146 /* Fall through to next case */
2154 if ((src
->u
.syment
.n_scnum
) == 0)
2156 if ((src
->u
.syment
.n_value
) == 0)
2158 dst
->symbol
.section
= bfd_und_section_ptr
;
2159 dst
->symbol
.value
= 0;
2163 dst
->symbol
.section
= bfd_com_section_ptr
;
2164 dst
->symbol
.value
= (src
->u
.syment
.n_value
);
2170 Base the value as an index from the base of the
2174 dst
->symbol
.flags
= BSF_EXPORT
| BSF_GLOBAL
;
2175 dst
->symbol
.value
= src
->u
.syment
.n_value
- dst
->symbol
.section
->vma
;
2177 if (ISFCN ((src
->u
.syment
.n_type
)))
2180 A function ext does not go at the end of a file
2182 dst
->symbol
.flags
|= BSF_NOT_AT_END
;
2187 /* If this symbol has a csect aux of type LD, the scnlen field
2188 is actually the index of the containing csect symbol. We
2189 need to pointerize it. */
2190 if (src
->u
.syment
.n_numaux
> 0)
2192 combined_entry_type
*aux
;
2194 aux
= src
+ src
->u
.syment
.n_numaux
- 1;
2195 if (SMTYP_SMTYP (aux
->u
.auxent
.x_csect
.x_smtyp
) == XTY_LD
)
2197 aux
->u
.auxent
.x_csect
.x_scnlen
.p
=
2198 native_symbols
+ aux
->u
.auxent
.x_csect
.x_scnlen
.l
;
2199 aux
->fix_scnlen
= 1;
2206 case C_STAT
: /* static */
2208 case C_LEAFSTAT
: /* static leaf procedure */
2210 case C_LABEL
: /* label */
2211 if (src
->u
.syment
.n_scnum
== -2)
2212 dst
->symbol
.flags
= BSF_DEBUGGING
;
2214 dst
->symbol
.flags
= BSF_LOCAL
;
2216 Base the value as an index from the base of the section, if
2219 if (dst
->symbol
.section
)
2220 dst
->symbol
.value
= (src
->u
.syment
.n_value
) -
2221 dst
->symbol
.section
->vma
;
2223 dst
->symbol
.value
= (src
->u
.syment
.n_value
);
2226 case C_MOS
: /* member of structure */
2227 case C_EOS
: /* end of structure */
2228 #ifdef NOTDEF /* C_AUTOARG has the same value */
2230 case C_GLBLREG
: /* A29k-specific storage class */
2233 case C_REGPARM
: /* register parameter */
2234 case C_REG
: /* register variable */
2236 case C_AUTOARG
: /* 960-specific storage class */
2238 case C_TPDEF
: /* type definition */
2240 case C_AUTO
: /* automatic variable */
2241 case C_FIELD
: /* bit field */
2242 case C_ENTAG
: /* enumeration tag */
2243 case C_MOE
: /* member of enumeration */
2244 case C_MOU
: /* member of union */
2245 case C_UNTAG
: /* union tag */
2246 dst
->symbol
.flags
= BSF_DEBUGGING
;
2247 dst
->symbol
.value
= (src
->u
.syment
.n_value
);
2250 case C_FILE
: /* file name */
2251 case C_STRTAG
: /* structure tag */
2253 case C_BINCL
: /* beginning of include file */
2254 case C_EINCL
: /* ending of include file */
2266 dst
->symbol
.flags
= BSF_DEBUGGING
;
2267 dst
->symbol
.value
= (src
->u
.syment
.n_value
);
2272 dst
->symbol
.flags
= BSF_DEBUGGING
;
2273 dst
->symbol
.value
= src
->u
.syment
.n_value
;
2275 /* The value is actually a symbol index. Save a pointer to
2276 the symbol instead of the index. FIXME: This should use a
2278 src
->u
.syment
.n_value
=
2279 (long) (native_symbols
+ src
->u
.syment
.n_value
);
2284 case C_BLOCK
: /* ".bb" or ".eb" */
2285 case C_FCN
: /* ".bf" or ".ef" */
2286 case C_EFCN
: /* physical end of function */
2287 dst
->symbol
.flags
= BSF_LOCAL
;
2289 Base the value as an index from the base of the section
2291 dst
->symbol
.value
= (src
->u
.syment
.n_value
) - dst
->symbol
.section
->vma
;
2295 case C_EXTDEF
: /* external definition */
2296 case C_ULABEL
: /* undefined label */
2297 case C_USTATIC
: /* undefined static */
2298 case C_LINE
: /* line # reformatted as symbol table entry */
2299 case C_ALIAS
: /* duplicate tag */
2300 case C_HIDDEN
: /* ext symbol in dmert public lib */
2303 fprintf (stderr
, "Unrecognized storage class %d (assuming debugging)\n for %s symbol `%s'\n",
2304 src
->u
.syment
.n_sclass
, dst
->symbol
.section
->name
,
2307 dst
->symbol
.flags
= BSF_DEBUGGING
;
2308 dst
->symbol
.value
= (src
->u
.syment
.n_value
);
2312 /* BFD_ASSERT(dst->symbol.flags != 0);*/
2316 dst
->symbol
.udata
= 0;
2317 dst
->lineno
= (alent
*) NULL
;
2318 this_index
+= (src
->u
.syment
.n_numaux
) + 1;
2320 number_of_symbols
++;
2321 } /* walk the native symtab */
2322 } /* bfdize the native symtab */
2324 obj_symbols (abfd
) = cached_area
;
2325 obj_raw_syments (abfd
) = native_symbols
;
2327 obj_conv_table_size (abfd
) = bfd_get_symcount (abfd
);
2328 bfd_get_symcount (abfd
) = number_of_symbols
;
2329 obj_convert (abfd
) = table_ptr
;
2330 /* Slurp the line tables for each section too */
2336 coff_slurp_line_table (abfd
, p
);
2341 } /* coff_slurp_symbol_table() */
2347 Coff relocations are easily transformed into the internal BFD form
2350 Reading a coff relocation table is done in the following stages:
2352 o Read the entire coff relocation table into memory.
2354 o Process each relocation in turn; first swap it from the
2355 external to the internal form.
2357 o Turn the symbol referenced in the relocation's symbol index
2358 into a pointer into the canonical symbol table.
2359 This table is the same as the one returned by a call to
2360 @code{bfd_canonicalize_symtab}. The back end will call that
2361 routine and save the result if a canonicalization hasn't been done.
2363 o The reloc index is turned into a pointer to a howto
2364 structure, in a back end specific way. For instance, the 386
2365 and 960 use the @code{r_type} to directly produce an index
2366 into a howto table vector; the 88k subtracts a number from the
2367 @code{r_type} field and creates an addend field.
2373 #define CALC_ADDEND(abfd, ptr, reloc, cache_ptr) \
2375 coff_symbol_type *coffsym = (coff_symbol_type *) NULL; \
2376 if (ptr && bfd_asymbol_bfd (ptr) != abfd) \
2377 coffsym = (obj_symbols (abfd) \
2378 + (cache_ptr->sym_ptr_ptr - symbols)); \
2380 coffsym = coff_symbol_from (abfd, ptr); \
2381 if (coffsym != (coff_symbol_type *) NULL \
2382 && coffsym->native->u.syment.n_scnum == 0) \
2383 cache_ptr->addend = 0; \
2384 else if (ptr && bfd_asymbol_bfd (ptr) == abfd \
2385 && ptr->section != (asection *) NULL) \
2386 cache_ptr->addend = - (ptr->section->vma + ptr->value); \
2388 cache_ptr->addend = 0; \
2393 coff_slurp_reloc_table (abfd
, asect
, symbols
)
2398 RELOC
*native_relocs
;
2399 arelent
*reloc_cache
;
2404 if (asect
->relocation
)
2406 if (asect
->reloc_count
== 0)
2408 if (asect
->flags
& SEC_CONSTRUCTOR
)
2410 if (!coff_slurp_symbol_table (abfd
))
2413 (RELOC
*) buy_and_read (abfd
,
2417 asect
->reloc_count
));
2418 reloc_cache
= (arelent
*)
2419 bfd_alloc (abfd
, (size_t) (asect
->reloc_count
* sizeof (arelent
)));
2421 if (reloc_cache
== NULL
)
2423 bfd_set_error (bfd_error_no_memory
);
2428 for (idx
= 0; idx
< asect
->reloc_count
; idx
++)
2430 #ifdef RELOC_PROCESSING
2431 struct internal_reloc dst
;
2432 struct external_reloc
*src
;
2434 cache_ptr
= reloc_cache
+ idx
;
2435 src
= native_relocs
+ idx
;
2436 bfd_swap_reloc_in (abfd
, src
, &dst
);
2438 RELOC_PROCESSING (cache_ptr
, &dst
, symbols
, abfd
, asect
);
2440 struct internal_reloc dst
;
2442 struct external_reloc
*src
;
2444 cache_ptr
= reloc_cache
+ idx
;
2445 src
= native_relocs
+ idx
;
2447 bfd_swap_reloc_in (abfd
, src
, &dst
);
2450 cache_ptr
->address
= dst
.r_vaddr
;
2452 if (dst
.r_symndx
!= -1)
2454 /* @@ Should never be greater than count of symbols! */
2455 if (dst
.r_symndx
>= obj_conv_table_size (abfd
))
2457 cache_ptr
->sym_ptr_ptr
= symbols
+ obj_convert (abfd
)[dst
.r_symndx
];
2458 ptr
= *(cache_ptr
->sym_ptr_ptr
);
2462 cache_ptr
->sym_ptr_ptr
= bfd_abs_section_ptr
->symbol_ptr_ptr
;
2466 /* The symbols definitions that we have read in have been
2467 relocated as if their sections started at 0. But the offsets
2468 refering to the symbols in the raw data have not been
2469 modified, so we have to have a negative addend to compensate.
2471 Note that symbols which used to be common must be left alone */
2473 /* Calculate any reloc addend by looking at the symbol */
2474 CALC_ADDEND (abfd
, ptr
, dst
, cache_ptr
);
2476 cache_ptr
->address
-= asect
->vma
;
2477 /* !! cache_ptr->section = (asection *) NULL;*/
2479 /* Fill in the cache_ptr->howto field from dst.r_type */
2480 RTYPE2HOWTO (cache_ptr
, &dst
);
2485 asect
->relocation
= reloc_cache
;
2490 /* This is stupid. This function should be a boolean predicate. */
2492 coff_canonicalize_reloc (abfd
, section
, relptr
, symbols
)
2498 arelent
*tblptr
= section
->relocation
;
2499 unsigned int count
= 0;
2502 if (section
->flags
& SEC_CONSTRUCTOR
)
2504 /* this section has relocs made up by us, they are not in the
2505 file, so take them out of their chain and place them into
2506 the data area provided */
2507 arelent_chain
*chain
= section
->constructor_chain
;
2508 for (count
= 0; count
< section
->reloc_count
; count
++)
2510 *relptr
++ = &chain
->relent
;
2511 chain
= chain
->next
;
2517 if (! coff_slurp_reloc_table (abfd
, section
, symbols
))
2520 tblptr
= section
->relocation
;
2522 for (; count
++ < section
->reloc_count
;)
2523 *relptr
++ = tblptr
++;
2528 return section
->reloc_count
;
2533 coff_sym_filepos (abfd
)
2536 return obj_sym_filepos (abfd
);
2540 #ifndef coff_reloc16_estimate
2541 #define coff_reloc16_estimate dummy_reloc16_estimate
2544 dummy_reloc16_estimate (abfd
, input_section
, reloc
, shrink
, link_info
)
2546 asection
*input_section
;
2548 unsigned int shrink
;
2549 struct bfd_link_info
*link_info
;
2556 #ifndef coff_reloc16_extra_cases
2557 #define coff_reloc16_extra_cases dummy_reloc16_extra_cases
2558 /* This works even if abort is not declared in any header file. */
2560 dummy_reloc16_extra_cases (abfd
, link_info
, link_order
, reloc
, data
, src_ptr
,
2563 struct bfd_link_info
*link_info
;
2564 struct bfd_link_order
*link_order
;
2567 unsigned int *src_ptr
;
2568 unsigned int *dst_ptr
;
2570 fprintf (stderr
, "%s\n", reloc
->howto
->name
);
2575 static CONST bfd_coff_backend_data bfd_coff_std_swap_table
=
2577 coff_swap_aux_in
, coff_swap_sym_in
, coff_swap_lineno_in
,
2578 coff_swap_aux_out
, coff_swap_sym_out
,
2579 coff_swap_lineno_out
, coff_swap_reloc_out
,
2580 coff_swap_filehdr_out
, coff_swap_aouthdr_out
,
2581 coff_swap_scnhdr_out
,
2582 FILHSZ
, AOUTSZ
, SCNHSZ
, SYMESZ
, AUXESZ
, LINESZ
,
2583 #ifdef COFF_LONG_FILENAMES
2588 coff_swap_filehdr_in
, coff_swap_aouthdr_in
, coff_swap_scnhdr_in
,
2589 coff_bad_format_hook
, coff_set_arch_mach_hook
, coff_mkobject_hook
,
2590 styp_to_sec_flags
, coff_make_section_hook
, coff_set_alignment_hook
,
2591 coff_slurp_symbol_table
, symname_in_debug_hook
,
2592 coff_reloc16_extra_cases
, coff_reloc16_estimate
2595 #define coff_close_and_cleanup _bfd_generic_close_and_cleanup
2596 #define coff_bfd_free_cached_info _bfd_generic_bfd_free_cached_info
2597 #define coff_get_section_contents _bfd_generic_get_section_contents
2599 #define coff_bfd_copy_private_section_data \
2600 _bfd_generic_bfd_copy_private_section_data
2601 #define coff_bfd_copy_private_bfd_data _bfd_generic_bfd_copy_private_bfd_data
2603 #ifndef coff_bfd_is_local_label
2604 #define coff_bfd_is_local_label bfd_generic_is_local_label
2607 /* The reloc lookup routine must be supplied by each individual COFF
2609 #ifndef coff_bfd_reloc_type_lookup
2610 #define coff_bfd_reloc_type_lookup _bfd_norelocs_bfd_reloc_type_lookup
2613 #define coff_bfd_get_relocated_section_contents \
2614 bfd_generic_get_relocated_section_contents
2615 #define coff_bfd_relax_section bfd_generic_relax_section
2616 #define coff_bfd_link_hash_table_create _bfd_generic_link_hash_table_create
2617 #define coff_bfd_link_add_symbols _bfd_generic_link_add_symbols
2618 #define coff_bfd_final_link _bfd_generic_final_link