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_relsz;
612 . unsigned int _bfd_linesz;
613 . boolean _bfd_coff_long_filenames;
614 . void (*_bfd_coff_swap_filehdr_in) PARAMS ((
618 . void (*_bfd_coff_swap_aouthdr_in) PARAMS ((
622 . void (*_bfd_coff_swap_scnhdr_in) PARAMS ((
626 . void (*_bfd_coff_swap_reloc_in) PARAMS ((
630 . boolean (*_bfd_coff_bad_format_hook) PARAMS ((
632 . PTR internal_filehdr));
633 . boolean (*_bfd_coff_set_arch_mach_hook) PARAMS ((
635 . PTR internal_filehdr));
636 . PTR (*_bfd_coff_mkobject_hook) PARAMS ((
638 . PTR internal_filehdr,
639 . PTR internal_aouthdr));
640 . flagword (*_bfd_styp_to_sec_flags_hook) PARAMS ((
642 . PTR internal_scnhdr,
643 . const char *name));
644 . asection *(*_bfd_make_section_hook) PARAMS ((
647 . void (*_bfd_set_alignment_hook) PARAMS ((
650 . PTR internal_scnhdr));
651 . boolean (*_bfd_coff_slurp_symbol_table) PARAMS ((
653 . boolean (*_bfd_coff_symname_in_debug) PARAMS ((
655 . struct internal_syment *sym));
656 . void (*_bfd_coff_reloc16_extra_cases) PARAMS ((
658 . struct bfd_link_info *link_info,
659 . struct bfd_link_order *link_order,
662 . unsigned int *src_ptr,
663 . unsigned int *dst_ptr));
664 . int (*_bfd_coff_reloc16_estimate) PARAMS ((
666 . asection *input_section,
668 . unsigned int shrink,
669 . struct bfd_link_info *link_info));
670 . boolean (*_bfd_coff_sym_is_global) PARAMS ((
672 . struct internal_syment *));
673 . void (*_bfd_coff_compute_section_file_positions) PARAMS ((
675 . boolean (*_bfd_coff_relocate_section) PARAMS ((
677 . struct bfd_link_info *info,
679 . asection *input_section,
680 . bfd_byte *contents,
681 . struct internal_reloc *relocs,
682 . struct internal_syment *syms,
683 . asection **sections));
685 .} bfd_coff_backend_data;
687 .#define coff_backend_info(abfd) ((bfd_coff_backend_data *) (abfd)->xvec->backend_data)
689 .#define bfd_coff_swap_aux_in(a,e,t,c,ind,num,i) \
690 . ((coff_backend_info (a)->_bfd_coff_swap_aux_in) (a,e,t,c,ind,num,i))
692 .#define bfd_coff_swap_sym_in(a,e,i) \
693 . ((coff_backend_info (a)->_bfd_coff_swap_sym_in) (a,e,i))
695 .#define bfd_coff_swap_lineno_in(a,e,i) \
696 . ((coff_backend_info ( a)->_bfd_coff_swap_lineno_in) (a,e,i))
698 .#define bfd_coff_swap_reloc_out(abfd, i, o) \
699 . ((coff_backend_info (abfd)->_bfd_coff_swap_reloc_out) (abfd, i, o))
701 .#define bfd_coff_swap_lineno_out(abfd, i, o) \
702 . ((coff_backend_info (abfd)->_bfd_coff_swap_lineno_out) (abfd, i, o))
704 .#define bfd_coff_swap_aux_out(a,i,t,c,ind,num,o) \
705 . ((coff_backend_info (a)->_bfd_coff_swap_aux_out) (a,i,t,c,ind,num,o))
707 .#define bfd_coff_swap_sym_out(abfd, i,o) \
708 . ((coff_backend_info (abfd)->_bfd_coff_swap_sym_out) (abfd, i, o))
710 .#define bfd_coff_swap_scnhdr_out(abfd, i,o) \
711 . ((coff_backend_info (abfd)->_bfd_coff_swap_scnhdr_out) (abfd, i, o))
713 .#define bfd_coff_swap_filehdr_out(abfd, i,o) \
714 . ((coff_backend_info (abfd)->_bfd_coff_swap_filehdr_out) (abfd, i, o))
716 .#define bfd_coff_swap_aouthdr_out(abfd, i,o) \
717 . ((coff_backend_info (abfd)->_bfd_coff_swap_aouthdr_out) (abfd, i, o))
719 .#define bfd_coff_filhsz(abfd) (coff_backend_info (abfd)->_bfd_filhsz)
720 .#define bfd_coff_aoutsz(abfd) (coff_backend_info (abfd)->_bfd_aoutsz)
721 .#define bfd_coff_scnhsz(abfd) (coff_backend_info (abfd)->_bfd_scnhsz)
722 .#define bfd_coff_symesz(abfd) (coff_backend_info (abfd)->_bfd_symesz)
723 .#define bfd_coff_auxesz(abfd) (coff_backend_info (abfd)->_bfd_auxesz)
724 .#define bfd_coff_relsz(abfd) (coff_backend_info (abfd)->_bfd_relsz)
725 .#define bfd_coff_linesz(abfd) (coff_backend_info (abfd)->_bfd_linesz)
726 .#define bfd_coff_long_filenames(abfd) (coff_backend_info (abfd)->_bfd_coff_long_filenames)
727 .#define bfd_coff_swap_filehdr_in(abfd, i,o) \
728 . ((coff_backend_info (abfd)->_bfd_coff_swap_filehdr_in) (abfd, i, o))
730 .#define bfd_coff_swap_aouthdr_in(abfd, i,o) \
731 . ((coff_backend_info (abfd)->_bfd_coff_swap_aouthdr_in) (abfd, i, o))
733 .#define bfd_coff_swap_scnhdr_in(abfd, i,o) \
734 . ((coff_backend_info (abfd)->_bfd_coff_swap_scnhdr_in) (abfd, i, o))
736 .#define bfd_coff_swap_reloc_in(abfd, i, o) \
737 . ((coff_backend_info (abfd)->_bfd_coff_swap_reloc_in) (abfd, i, o))
739 .#define bfd_coff_bad_format_hook(abfd, filehdr) \
740 . ((coff_backend_info (abfd)->_bfd_coff_bad_format_hook) (abfd, filehdr))
742 .#define bfd_coff_set_arch_mach_hook(abfd, filehdr)\
743 . ((coff_backend_info (abfd)->_bfd_coff_set_arch_mach_hook) (abfd, filehdr))
744 .#define bfd_coff_mkobject_hook(abfd, filehdr, aouthdr)\
745 . ((coff_backend_info (abfd)->_bfd_coff_mkobject_hook) (abfd, filehdr, aouthdr))
747 .#define bfd_coff_styp_to_sec_flags_hook(abfd, scnhdr, name)\
748 . ((coff_backend_info (abfd)->_bfd_styp_to_sec_flags_hook) (abfd, scnhdr, name))
750 .#define bfd_coff_make_section_hook(abfd, name)\
751 . ((coff_backend_info (abfd)->_bfd_make_section_hook) (abfd, name))
753 .#define bfd_coff_set_alignment_hook(abfd, sec, scnhdr)\
754 . ((coff_backend_info (abfd)->_bfd_set_alignment_hook) (abfd, sec, scnhdr))
756 .#define bfd_coff_slurp_symbol_table(abfd)\
757 . ((coff_backend_info (abfd)->_bfd_coff_slurp_symbol_table) (abfd))
759 .#define bfd_coff_symname_in_debug(abfd, sym)\
760 . ((coff_backend_info (abfd)->_bfd_coff_symname_in_debug) (abfd, sym))
762 .#define bfd_coff_reloc16_extra_cases(abfd, link_info, link_order, reloc, data, src_ptr, dst_ptr)\
763 . ((coff_backend_info (abfd)->_bfd_coff_reloc16_extra_cases)\
764 . (abfd, link_info, link_order, reloc, data, src_ptr, dst_ptr))
766 .#define bfd_coff_reloc16_estimate(abfd, section, reloc, shrink, link_info)\
767 . ((coff_backend_info (abfd)->_bfd_coff_reloc16_estimate)\
768 . (abfd, section, reloc, shrink, link_info))
770 .#define bfd_coff_sym_is_global(abfd, sym)\
771 . ((coff_backend_info (abfd)->_bfd_coff_sym_is_global)\
774 .#define bfd_coff_compute_section_file_positions(abfd)\
775 . ((coff_backend_info (abfd)->_bfd_coff_compute_section_file_positions)\
778 .#define bfd_coff_relocate_section(obfd,info,ibfd,o,con,rel,isyms,secs)\
779 . ((coff_backend_info (ibfd)->_bfd_coff_relocate_section)\
780 . (obfd, info, ibfd, o, con, rel, isyms, secs))
784 /* See whether the magic number matches. */
787 coff_bad_format_hook (abfd, filehdr)
791 struct internal_filehdr *internal_f = (struct internal_filehdr *) filehdr;
793 if (BADMAG (*internal_f))
796 /* if the optional header is NULL or not the correct size then
797 quit; the only difference I can see between m88k dgux headers (MC88DMAGIC)
798 and Intel 960 readwrite headers (I960WRMAGIC) is that the
799 optional header is of a different size.
801 But the mips keeps extra stuff in it's opthdr, so dont check
805 #if defined(M88) || defined(I960)
806 if (internal_f->f_opthdr != 0 && AOUTSZ != internal_f->f_opthdr)
814 coff_make_section_hook (abfd, name)
819 /* FIXME: This predates the call to bfd_make_section_anyway
820 in make_a_section_from_file, and can probably go away. */
821 /* On SCO a file created by the Microsoft assembler can have two
822 .data sections. We use .data2 for the second one. */
823 if (strcmp (name, _DATA) == 0)
824 return bfd_make_section (abfd, ".data2");
826 return (asection *) NULL;
830 initialize a section structure with information peculiar to this
831 particular implementation of coff
835 coff_new_section_hook (abfd, section)
839 section->alignment_power = abfd->xvec->align_power_min;
840 /* Allocate aux records for section symbols, to store size and
843 @@ Shouldn't use constant multiplier here! */
844 coffsymbol (section->symbol)->native =
845 (combined_entry_type *) bfd_zalloc (abfd,
846 sizeof (combined_entry_type) * 10);
849 /* This is to allow double-word operations on addresses in data or bss. */
850 if (strcmp (section->name, ".data") == 0
851 || strcmp (section->name, ".bss") == 0)
852 section->alignment_power = 3;
853 #endif /* COFF_SPARC */
861 /* Set the alignment of a BFD section. */
864 coff_set_alignment_hook (abfd, section, scnhdr)
869 struct internal_scnhdr *hdr = (struct internal_scnhdr *) scnhdr;
872 for (i = 0; i < 32; i++)
873 if ((1 << i) >= hdr->s_align)
875 section->alignment_power = i;
880 #define coff_set_alignment_hook \
881 ((void (*) PARAMS ((bfd *, asection *, PTR))) bfd_void)
889 coff_data_type *coff;
891 abfd->tdata.coff_obj_data = (struct coff_tdata *) bfd_zalloc (abfd, sizeof (coff_data_type));
892 if (abfd->tdata.coff_obj_data == 0)
894 bfd_set_error (bfd_error_no_memory);
897 coff = coff_data (abfd);
898 coff->symbols = (coff_symbol_type *) NULL;
899 coff->conversion_table = (unsigned int *) NULL;
900 coff->raw_syments = (struct coff_ptr_struct *) NULL;
902 /* make_abs_section(abfd);*/
906 /* Create the COFF backend specific information. */
909 coff_mkobject_hook (abfd, filehdr, aouthdr)
914 struct internal_filehdr *internal_f = (struct internal_filehdr *) filehdr;
915 coff_data_type *coff;
917 if (coff_mkobject (abfd) == false)
920 coff = coff_data (abfd);
922 coff->sym_filepos = internal_f->f_symptr;
924 /* These members communicate important constants about the symbol
925 table to GDB's symbol-reading code. These `constants'
926 unfortunately vary among coff implementations... */
927 coff->local_n_btmask = N_BTMASK;
928 coff->local_n_btshft = N_BTSHFT;
929 coff->local_n_tmask = N_TMASK;
930 coff->local_n_tshift = N_TSHIFT;
931 coff->local_symesz = SYMESZ;
932 coff->local_auxesz = AUXESZ;
933 coff->local_linesz = LINESZ;
935 obj_raw_syment_count (abfd) =
936 obj_conv_table_size (abfd) =
942 /* Determine the machine architecture and type. FIXME: This is target
943 dependent because the magic numbers are defined in the target
944 dependent header files. But there is no particular need for this.
945 If the magic numbers were moved to a separate file, this function
946 would be target independent and would also be much more successful
947 at linking together COFF files for different architectures. */
950 coff_set_arch_mach_hook (abfd, filehdr)
955 enum bfd_architecture arch;
956 struct internal_filehdr *internal_f = (struct internal_filehdr *) filehdr;
959 switch (internal_f->f_magic)
964 case I386AIXMAGIC: /* Danbury PS/2 AIX C Compiler */
965 case LYNXCOFFMAGIC: /* shadows the m68k Lynx number below, sigh */
966 arch = bfd_arch_i386;
971 #ifdef A29K_MAGIC_BIG
973 case A29K_MAGIC_LITTLE:
974 arch = bfd_arch_a29k;
985 #ifdef APOLLOM68KMAGIC
986 case APOLLOM68KMAGIC:
991 arch = bfd_arch_m68k;
999 arch = bfd_arch_m88k;
1005 arch = bfd_arch_z8k;
1006 switch (internal_f->f_flags & F_MACHMASK)
1009 machine = bfd_mach_z8001;
1012 machine = bfd_mach_z8002;
1023 arch = bfd_arch_i960;
1024 switch (F_I960TYPE & internal_f->f_flags)
1028 machine = bfd_mach_i960_core;
1031 machine = bfd_mach_i960_kb_sb;
1034 machine = bfd_mach_i960_mc;
1037 machine = bfd_mach_i960_xa;
1040 machine = bfd_mach_i960_ca;
1043 machine = bfd_mach_i960_ka_sa;
1045 /* start-sanitize-i960xl */
1047 machine = bfd_mach_i960_xl;
1049 /* end-sanitize-i960xl */
1059 arch = bfd_arch_rs6000;
1066 arch = bfd_arch_we32k;
1073 arch = bfd_arch_h8300;
1074 machine = bfd_mach_h8300;
1075 /* !! FIXME this probably isn't the right place for this */
1076 abfd->flags |= BFD_IS_RELAXABLE;
1082 arch = bfd_arch_h8300;
1083 machine = bfd_mach_h8300h;
1084 /* !! FIXME this probably isn't the right place for this */
1085 abfd->flags |= BFD_IS_RELAXABLE;
1089 #ifdef SH_ARCH_MAGIC
1098 arch = bfd_arch_h8500;
1105 #ifdef LYNXCOFFMAGIC
1108 arch = bfd_arch_sparc;
1113 default: /* Unreadable input file type */
1114 arch = bfd_arch_obscure;
1118 bfd_default_set_arch_mach (abfd, arch, machine);
1122 #ifdef SYMNAME_IN_DEBUG
1125 symname_in_debug_hook (abfd, sym)
1127 struct internal_syment *sym;
1129 return SYMNAME_IN_DEBUG (sym) ? true : false;
1134 #define symname_in_debug_hook \
1135 (boolean (*) PARAMS ((bfd *, struct internal_syment *))) bfd_false
1143 To write relocations, the back end steps though the
1144 canonical relocation table and create an
1145 @code{internal_reloc}. The symbol index to use is removed from
1146 the @code{offset} field in the symbol table supplied. The
1147 address comes directly from the sum of the section base
1148 address and the relocation offset; the type is dug directly
1149 from the howto field. Then the @code{internal_reloc} is
1150 swapped into the shape of an @code{external_reloc} and written
1156 coff_write_relocs (abfd)
1160 for (s = abfd->sections; s != (asection *) NULL; s = s->next)
1163 struct external_reloc dst;
1165 arelent **p = s->orelocation;
1166 if (bfd_seek (abfd, s->rel_filepos, SEEK_SET) != 0)
1168 for (i = 0; i < s->reloc_count; i++)
1170 struct internal_reloc n;
1172 memset ((PTR) & n, 0, sizeof (n));
1174 n.r_vaddr = q->address + s->vma;
1177 /* The 29k const/consth reloc pair is a real kludge. The consth
1178 part doesn't have a symbol; it has an offset. So rebuilt
1180 if (q->howto->type == R_IHCONST)
1181 n.r_symndx = q->addend;
1186 if (q->sym_ptr_ptr == bfd_abs_section_ptr->symbol_ptr_ptr)
1187 /* This is a relocation relative to the absolute symbol. */
1191 n.r_symndx = get_index ((*(q->sym_ptr_ptr)));
1192 /* Take notice if the symbol reloc points to a symbol
1193 we don't have in our symbol table. What should we
1195 if (n.r_symndx > obj_conv_table_size (abfd))
1200 #ifdef SWAP_OUT_RELOC_OFFSET
1201 n.r_offset = q->addend;
1205 /* Work out reloc type from what is required */
1206 SELECT_RELOC (n, q->howto);
1208 n.r_type = q->howto->type;
1210 coff_swap_reloc_out (abfd, &n, &dst);
1211 if (bfd_write ((PTR) & dst, 1, RELSZ, abfd) != RELSZ)
1219 /* Set flags and magic number of a coff file from architecture and machine
1220 type. Result is true if we can represent the arch&type, false if not. */
1223 coff_set_flags (abfd, magicp, flagsp)
1226 unsigned short *flagsp;
1228 switch (bfd_get_arch (abfd))
1233 switch (bfd_get_mach (abfd))
1235 case bfd_mach_z8001:
1238 case bfd_mach_z8002:
1252 *magicp = I960ROMAGIC;
1254 ((bfd_get_file_flags(abfd) & WP_TEXT) ? I960ROMAGIC :
1255 I960RWMAGIC); FIXME???
1257 switch (bfd_get_mach (abfd))
1259 case bfd_mach_i960_core:
1262 case bfd_mach_i960_kb_sb:
1265 case bfd_mach_i960_mc:
1268 case bfd_mach_i960_xa:
1271 case bfd_mach_i960_ca:
1274 case bfd_mach_i960_ka_sa:
1277 /* start-sanitize-i960xl */
1278 case bfd_mach_i960_xl:
1281 /* end-sanitize-i960xl */
1292 *magicp = I386MAGIC;
1294 /* Just overwrite the usual value if we're doing Lynx. */
1295 *magicp = LYNXCOFFMAGIC;
1302 #ifdef APOLLOM68KMAGIC
1303 *magicp = APOLLO_COFF_VERSION_NUMBER;
1305 *magicp = MC68MAGIC;
1308 /* Just overwrite the usual value if we're doing Lynx. */
1309 *magicp = LYNXCOFFMAGIC;
1317 *magicp = MC88OMAGIC;
1322 case bfd_arch_h8300:
1323 switch (bfd_get_mach (abfd))
1325 case bfd_mach_h8300:
1326 *magicp = H8300MAGIC;
1328 case bfd_mach_h8300h:
1329 *magicp = H8300HMAGIC;
1335 #ifdef SH_ARCH_MAGIC
1337 *magicp = SH_ARCH_MAGIC;
1343 case bfd_arch_sparc:
1344 *magicp = SPARCMAGIC;
1346 /* Just overwrite the usual value if we're doing Lynx. */
1347 *magicp = LYNXCOFFMAGIC;
1354 case bfd_arch_h8500:
1355 *magicp = H8500MAGIC;
1359 #ifdef A29K_MAGIC_BIG
1361 if (abfd->xvec->byteorder_big_p)
1362 *magicp = A29K_MAGIC_BIG;
1364 *magicp = A29K_MAGIC_LITTLE;
1370 case bfd_arch_we32k:
1371 *magicp = WE32KMAGIC;
1377 case bfd_arch_rs6000:
1378 case bfd_arch_powerpc:
1379 *magicp = U802TOCMAGIC;
1384 default: /* Unknown architecture */
1385 /* return false; -- fall through to "return false" below, to avoid
1386 "statement never reached" errors on the one below. */
1395 coff_set_arch_mach (abfd, arch, machine)
1397 enum bfd_architecture arch;
1398 unsigned long machine;
1401 unsigned short dummy2;
1403 if (! bfd_default_set_arch_mach (abfd, arch, machine))
1406 if (arch != bfd_arch_unknown &&
1407 coff_set_flags (abfd, &dummy1, &dummy2) != true)
1408 return false; /* We can't represent this type */
1410 return true; /* We're easy ... */
1414 /* Calculate the file position for each section. */
1417 coff_compute_section_file_positions (abfd)
1421 asection *previous = (asection *) NULL;
1422 file_ptr sofar = FILHSZ;
1428 if (bfd_get_start_address (abfd))
1430 /* A start address may have been added to the original file. In this
1431 case it will need an optional header to record it. */
1432 abfd->flags |= EXEC_P;
1435 if (abfd->flags & EXEC_P)
1438 sofar += abfd->section_count * SCNHSZ;
1439 for (current = abfd->sections, count = 1;
1440 current != (asection *) NULL;
1441 current = current->next, ++count)
1443 current->target_index = count;
1445 /* Only deal with sections which have contents */
1446 if (!(current->flags & SEC_HAS_CONTENTS))
1449 /* Align the sections in the file to the same boundary on
1450 which they are aligned in virtual memory. I960 doesn't
1451 do this (FIXME) so we can stay in sync with Intel. 960
1452 doesn't yet page from files... */
1455 /* make sure this section is aligned on the right boundary - by
1456 padding the previous section up if necessary */
1459 sofar = BFD_ALIGN (sofar, 1 << current->alignment_power);
1460 if (previous != (asection *) NULL)
1462 previous->_raw_size += sofar - old_sofar;
1468 #ifdef COFF_PAGE_SIZE
1469 /* In demand paged files the low order bits of the file offset
1470 must match the low order bits of the virtual address. */
1471 if ((abfd->flags & D_PAGED) != 0
1472 && (current->flags & SEC_ALLOC) != 0)
1473 sofar += (current->vma - sofar) % COFF_PAGE_SIZE;
1476 current->filepos = sofar;
1478 sofar += current->_raw_size;
1480 /* make sure that this section is of the right size too */
1482 sofar = BFD_ALIGN (sofar, 1 << current->alignment_power);
1483 current->_raw_size += sofar - old_sofar;
1487 /* Force .lib sections to start at zero. The vma is then
1488 incremented in coff_set_section_contents. This is right for
1490 if (strcmp (current->name, _LIB) == 0)
1491 bfd_set_section_vma (abfd, current, 0);
1496 obj_relocbase (abfd) = sofar;
1497 abfd->output_has_begun = true;
1500 #ifndef RS6000COFF_C
1502 /* If .file, .text, .data, .bss symbols are missing, add them. */
1503 /* @@ Should we only be adding missing symbols, or overriding the aux
1504 values for existing section symbols? */
1506 coff_add_missing_symbols (abfd)
1509 unsigned int nsyms = bfd_get_symcount (abfd);
1510 asymbol **sympp = abfd->outsymbols;
1513 int need_text = 1, need_data = 1, need_bss = 1, need_file = 1;
1515 for (i = 0; i < nsyms; i++)
1517 coff_symbol_type *csym = coff_symbol_from (abfd, sympp[i]);
1521 /* only do this if there is a coff representation of the input
1523 if (csym->native && csym->native->u.syment.n_sclass == C_FILE)
1528 name = csym->symbol.name;
1531 if (!strcmp (name, _TEXT))
1534 else if (!strcmp (name, ".wtext"))
1537 else if (!strcmp (name, _DATA))
1539 else if (!strcmp (name, _BSS))
1543 /* Now i == bfd_get_symcount (abfd). */
1544 /* @@ For now, don't deal with .file symbol. */
1547 if (!need_text && !need_data && !need_bss && !need_file)
1549 nsyms += need_text + need_data + need_bss + need_file;
1550 sympp2 = (asymbol **) bfd_alloc_by_size_t (abfd, nsyms * sizeof (asymbol *));
1553 bfd_set_error (bfd_error_no_memory);
1556 memcpy (sympp2, sympp, i * sizeof (asymbol *));
1559 /* @@ Generate fake .file symbol, in sympp2[i], and increment i. */
1563 sympp2[i++] = coff_section_symbol (abfd, _TEXT);
1565 sympp2[i++] = coff_section_symbol (abfd, _DATA);
1567 sympp2[i++] = coff_section_symbol (abfd, _BSS);
1568 BFD_ASSERT (i == nsyms);
1569 bfd_set_symtab (abfd, sympp2, nsyms);
1573 #endif /* ! defined (RS6000COFF_C) */
1578 coff_write_object_contents (abfd)
1582 boolean hasrelocs = false;
1583 boolean haslinno = false;
1584 file_ptr reloc_base;
1585 file_ptr lineno_base;
1587 unsigned long reloc_size = 0;
1588 unsigned long lnno_size = 0;
1589 asection *text_sec = NULL;
1590 asection *data_sec = NULL;
1591 asection *bss_sec = NULL;
1593 struct internal_filehdr internal_f;
1594 struct internal_aouthdr internal_a;
1597 bfd_set_error (bfd_error_system_call);
1599 if (abfd->output_has_begun == false)
1600 coff_compute_section_file_positions (abfd);
1602 reloc_base = obj_relocbase (abfd);
1604 /* Make a pass through the symbol table to count line number entries and
1605 put them into the correct asections */
1607 lnno_size = coff_count_linenumbers (abfd) * LINESZ;
1609 /* Work out the size of the reloc and linno areas */
1611 for (current = abfd->sections; current != NULL; current =
1613 reloc_size += current->reloc_count * RELSZ;
1615 lineno_base = reloc_base + reloc_size;
1616 sym_base = lineno_base + lnno_size;
1618 /* Indicate in each section->line_filepos its actual file address */
1619 for (current = abfd->sections; current != NULL; current =
1622 if (current->lineno_count)
1624 current->line_filepos = lineno_base;
1625 current->moving_line_filepos = lineno_base;
1626 lineno_base += current->lineno_count * LINESZ;
1630 current->line_filepos = 0;
1632 if (current->reloc_count)
1634 current->rel_filepos = reloc_base;
1635 reloc_base += current->reloc_count * RELSZ;
1639 current->rel_filepos = 0;
1643 /* Write section headers to the file. */
1644 internal_f.f_nscns = 0;
1646 (file_ptr) ((abfd->flags & EXEC_P) ?
1647 (FILHSZ + AOUTSZ) : FILHSZ),
1653 for (current = abfd->sections;
1655 current = current->next)
1657 struct internal_scnhdr section;
1659 internal_f.f_nscns++;
1660 strncpy (&(section.s_name[0]), current->name, 8);
1662 /* Always set s_vaddr of .lib to 0. This is right for SVR3.2
1664 if (strcmp (current->name, _LIB) == 0)
1665 section.s_vaddr = 0;
1668 section.s_vaddr = current->lma;
1669 section.s_paddr = current->lma;
1670 section.s_size = current->_raw_size;
1672 If this section has no size or is unloadable then the scnptr
1675 if (current->_raw_size == 0 ||
1676 (current->flags & (SEC_LOAD | SEC_HAS_CONTENTS)) == 0)
1678 section.s_scnptr = 0;
1682 section.s_scnptr = current->filepos;
1684 section.s_relptr = current->rel_filepos;
1685 section.s_lnnoptr = current->line_filepos;
1686 section.s_nreloc = current->reloc_count;
1687 section.s_nlnno = current->lineno_count;
1688 if (current->reloc_count != 0)
1690 if (current->lineno_count != 0)
1693 section.s_flags = sec_to_styp_flags (current->name, current->flags);
1695 if (!strcmp (current->name, _TEXT))
1699 else if (!strcmp (current->name, _DATA))
1702 #ifdef TWO_DATA_SECS
1704 else if (!strcmp (current->name, ".data2"))
1707 #endif /* TWO_DATA_SECS */
1709 else if (!strcmp (current->name, _BSS))
1715 section.s_align = (current->alignment_power
1716 ? 1 << current->alignment_power
1723 coff_swap_scnhdr_out (abfd, §ion, &buff);
1724 if (bfd_write ((PTR) (&buff), 1, SCNHSZ, abfd) != SCNHSZ)
1732 /* OK, now set up the filehdr... */
1734 /* Don't include the internal abs section in the section count */
1737 We will NOT put a fucking timestamp in the header here. Every time you
1738 put it back, I will come in and take it out again. I'm sorry. This
1739 field does not belong here. We fill it with a 0 so it compares the
1742 internal_f.f_timdat = 0;
1744 internal_f.f_flags = 0;
1746 if (abfd->flags & EXEC_P)
1747 internal_f.f_opthdr = AOUTSZ;
1749 internal_f.f_opthdr = 0;
1752 internal_f.f_flags |= F_RELFLG;
1754 internal_f.f_flags |= F_LNNO;
1755 if (abfd->flags & EXEC_P)
1756 internal_f.f_flags |= F_EXEC;
1758 if (!abfd->xvec->byteorder_big_p)
1759 internal_f.f_flags |= F_AR32WR;
1761 internal_f.f_flags |= F_AR32W;
1764 FIXME, should do something about the other byte orders and
1768 memset (&internal_a, 0, sizeof internal_a);
1770 /* Set up architecture-dependent stuff */
1773 unsigned int magic = 0;
1774 unsigned short flags = 0;
1775 coff_set_flags (abfd, &magic, &flags);
1776 internal_f.f_magic = magic;
1777 internal_f.f_flags |= flags;
1778 /* ...and the "opt"hdr... */
1781 #ifdef ULTRA3 /* NYU's machine */
1782 /* FIXME: This is a bogus check. I really want to see if there
1783 * is a .shbss or a .shdata section, if so then set the magic
1784 * number to indicate a shared data executable.
1786 if (internal_f.f_nscns >= 7)
1787 internal_a.magic = SHMAGIC; /* Shared magic */
1790 internal_a.magic = NMAGIC;/* Assume separate i/d */
1791 #define __A_MAGIC_SET__
1794 internal_a.magic = (magic == I960ROMAGIC ? NMAGIC : OMAGIC);
1795 #define __A_MAGIC_SET__
1798 #define __A_MAGIC_SET__
1799 internal_a.magic = PAGEMAGICBCS;
1803 #define __A_MAGIC_SET__
1804 internal_a.magic = APOLLO_COFF_VERSION_NUMBER;
1807 #if defined(M68) || defined(WE32K) || defined(M68K)
1808 #define __A_MAGIC_SET__
1810 internal_a.magic = LYNXCOFFMAGIC;
1812 #endif /* M68 || WE32K || M68K */
1815 #define __A_MAGIC_SET__
1817 internal_a.magic = LYNXCOFFMAGIC;
1819 internal_a.magic = ZMAGIC;
1824 #define __A_MAGIC_SET__
1826 internal_a.magic = LYNXCOFFMAGIC;
1831 #define __A_MAGIC_SET__
1832 internal_a.magic = (abfd->flags & D_PAGED) ? RS6K_AOUTHDR_ZMAGIC :
1833 (abfd->flags & WP_TEXT) ? RS6K_AOUTHDR_NMAGIC :
1834 RS6K_AOUTHDR_OMAGIC;
1837 #ifndef __A_MAGIC_SET__
1838 #include "Your aouthdr magic number is not being set!"
1840 #undef __A_MAGIC_SET__
1843 /* Now should write relocs, strings, syms */
1844 obj_sym_filepos (abfd) = sym_base;
1846 if (bfd_get_symcount (abfd) != 0)
1848 #ifndef RS6000COFF_C
1849 if (!coff_add_missing_symbols (abfd))
1852 if (!coff_renumber_symbols (abfd))
1854 coff_mangle_symbols (abfd);
1855 if (! coff_write_symbols (abfd))
1857 if (! coff_write_linenumbers (abfd))
1859 if (! coff_write_relocs (abfd))
1863 /* If bfd_get_symcount (abfd) != 0, then we are not using the COFF
1864 backend linker, and obj_raw_syment_count is not valid until after
1865 coff_write_symbols is called. */
1866 if (obj_raw_syment_count (abfd) != 0)
1867 internal_f.f_symptr = sym_base;
1870 internal_f.f_symptr = 0;
1871 internal_f.f_flags |= F_LSYMS;
1876 internal_a.tsize = bfd_get_section_size_before_reloc (text_sec);
1877 internal_a.text_start = internal_a.tsize ? text_sec->vma : 0;
1881 internal_a.dsize = bfd_get_section_size_before_reloc (data_sec);
1882 internal_a.data_start = internal_a.dsize ? data_sec->vma : 0;
1886 internal_a.bsize = bfd_get_section_size_before_reloc (bss_sec);
1889 internal_a.entry = bfd_get_start_address (abfd);
1890 internal_f.f_nsyms = obj_raw_syment_count (abfd);
1892 /* now write them */
1893 if (bfd_seek (abfd, (file_ptr) 0, SEEK_SET) != 0)
1897 coff_swap_filehdr_out (abfd, (PTR) & internal_f, (PTR) & buff);
1898 if (bfd_write ((PTR) & buff, 1, FILHSZ, abfd) != FILHSZ)
1901 if (abfd->flags & EXEC_P)
1904 coff_swap_aouthdr_out (abfd, (PTR) & internal_a, (PTR) & buff);
1905 if (bfd_write ((PTR) & buff, 1, AOUTSZ, abfd) != AOUTSZ)
1912 coff_set_section_contents (abfd, section, location, offset, count)
1917 bfd_size_type count;
1919 if (abfd->output_has_begun == false) /* set by bfd.c handler */
1920 coff_compute_section_file_positions (abfd);
1923 /* If this is a .lib section, bump the vma address so that it
1924 winds up being the number of .lib sections output. This is
1925 right for SVR3.2. Shared libraries should probably get more
1927 if (strcmp (section->name, _LIB) == 0)
1931 /* Don't write out bss sections - one way to do this is to
1932 see if the filepos has not been set. */
1933 if (section->filepos == 0)
1936 if (bfd_seek (abfd, (file_ptr) (section->filepos + offset), SEEK_SET) != 0)
1941 return (bfd_write (location, 1, count, abfd) == count) ? true : false;
1947 coff_close_and_cleanup (abfd)
1950 if (!bfd_read_p (abfd))
1951 switch (abfd->format)
1954 if (!_bfd_write_archive_contents (abfd))
1958 if (!coff_write_object_contents (abfd))
1962 bfd_set_error (bfd_error_invalid_operation);
1966 /* We depend on bfd_close to free all the memory on the obstack. */
1967 /* FIXME if bfd_release is not using obstacks! */
1974 buy_and_read (abfd, where, seek_direction, size)
1980 PTR area = (PTR) bfd_alloc (abfd, size);
1983 bfd_set_error (bfd_error_no_memory);
1986 if (bfd_seek (abfd, where, seek_direction) != 0
1987 || bfd_read (area, 1, size, abfd) != size)
1990 } /* buy_and_read() */
1996 Creating the linenumber table is done by reading in the entire
1997 coff linenumber table, and creating another table for internal use.
1999 A coff linenumber table is structured so that each function
2000 is marked as having a line number of 0. Each line within the
2001 function is an offset from the first line in the function. The
2002 base of the line number information for the table is stored in
2003 the symbol associated with the function.
2005 The information is copied from the external to the internal
2006 table, and each symbol which marks a function is marked by
2009 How does this work ?
2014 coff_slurp_line_table (abfd, asect)
2018 LINENO *native_lineno;
2019 alent *lineno_cache;
2021 BFD_ASSERT (asect->lineno == (alent *) NULL);
2023 native_lineno = (LINENO *) buy_and_read (abfd,
2024 asect->line_filepos,
2027 asect->lineno_count));
2029 (alent *) bfd_alloc (abfd, (size_t) ((asect->lineno_count + 1) * sizeof (alent)));
2030 if (lineno_cache == NULL)
2032 bfd_set_error (bfd_error_no_memory);
2037 unsigned int counter = 0;
2038 alent *cache_ptr = lineno_cache;
2039 LINENO *src = native_lineno;
2041 while (counter < asect->lineno_count)
2043 struct internal_lineno dst;
2044 coff_swap_lineno_in (abfd, src, &dst);
2045 cache_ptr->line_number = dst.l_lnno;
2047 if (cache_ptr->line_number == 0)
2049 coff_symbol_type *sym =
2050 (coff_symbol_type *) (dst.l_addr.l_symndx
2051 + obj_raw_syments (abfd))->u.syment._n._n_n._n_zeroes;
2052 cache_ptr->u.sym = (asymbol *) sym;
2053 sym->lineno = cache_ptr;
2057 cache_ptr->u.offset = dst.l_addr.l_paddr
2058 - bfd_section_vma (abfd, asect);
2059 } /* If no linenumber expect a symbol index */
2065 cache_ptr->line_number = 0;
2068 asect->lineno = lineno_cache;
2069 /* FIXME, free native_lineno here, or use alloca or something. */
2074 coff_slurp_symbol_table (abfd)
2077 combined_entry_type *native_symbols;
2078 coff_symbol_type *cached_area;
2079 unsigned int *table_ptr;
2081 unsigned int number_of_symbols = 0;
2082 if (obj_symbols (abfd))
2084 if (bfd_seek (abfd, obj_sym_filepos (abfd), SEEK_SET) != 0)
2087 /* Read in the symbol table */
2088 if ((native_symbols = coff_get_normalized_symtab (abfd)) == NULL)
2093 /* Allocate enough room for all the symbols in cached form */
2094 cached_area = ((coff_symbol_type *)
2096 (obj_raw_syment_count (abfd)
2097 * sizeof (coff_symbol_type))));
2099 if (cached_area == NULL)
2101 bfd_set_error (bfd_error_no_memory);
2104 table_ptr = ((unsigned int *)
2106 (obj_raw_syment_count (abfd)
2107 * sizeof (unsigned int))));
2109 if (table_ptr == NULL)
2111 bfd_set_error (bfd_error_no_memory);
2116 coff_symbol_type *dst = cached_area;
2117 unsigned int last_native_index = obj_raw_syment_count (abfd);
2118 unsigned int this_index = 0;
2119 while (this_index < last_native_index)
2121 combined_entry_type *src = native_symbols + this_index;
2122 table_ptr[this_index] = number_of_symbols;
2123 dst->symbol.the_bfd = abfd;
2125 dst->symbol.name = (char *) (src->u.syment._n._n_n._n_offset);
2126 /* We use the native name field to point to the cached field. */
2127 src->u.syment._n._n_n._n_zeroes = (long) dst;
2128 dst->symbol.section = coff_section_from_bfd_index (abfd,
2129 src->u.syment.n_scnum);
2130 dst->symbol.flags = 0;
2131 dst->done_lineno = false;
2133 switch (src->u.syment.n_sclass)
2138 dst->symbol.value = src->u.syment.n_value - dst->symbol.section->vma;
2139 dst->symbol.flags = BSF_EXPORT | BSF_GLOBAL;
2140 dst->symbol.flags |= BSF_NOT_AT_END;
2142 /* Fall through to next case */
2150 if ((src->u.syment.n_scnum) == 0)
2152 if ((src->u.syment.n_value) == 0)
2154 dst->symbol.section = bfd_und_section_ptr;
2155 dst->symbol.value = 0;
2159 dst->symbol.section = bfd_com_section_ptr;
2160 dst->symbol.value = (src->u.syment.n_value);
2166 Base the value as an index from the base of the
2170 dst->symbol.flags = BSF_EXPORT | BSF_GLOBAL;
2171 dst->symbol.value = src->u.syment.n_value - dst->symbol.section->vma;
2173 if (ISFCN ((src->u.syment.n_type)))
2176 A function ext does not go at the end of a file
2178 dst->symbol.flags |= BSF_NOT_AT_END;
2183 /* If this symbol has a csect aux of type LD, the scnlen field
2184 is actually the index of the containing csect symbol. We
2185 need to pointerize it. */
2186 if (src->u.syment.n_numaux > 0)
2188 combined_entry_type *aux;
2190 aux = src + src->u.syment.n_numaux - 1;
2191 if (SMTYP_SMTYP (aux->u.auxent.x_csect.x_smtyp) == XTY_LD)
2193 aux->u.auxent.x_csect.x_scnlen.p =
2194 native_symbols + aux->u.auxent.x_csect.x_scnlen.l;
2195 aux->fix_scnlen = 1;
2202 case C_STAT: /* static */
2204 case C_LEAFSTAT: /* static leaf procedure */
2206 case C_LABEL: /* label */
2207 if (src->u.syment.n_scnum == -2)
2208 dst->symbol.flags = BSF_DEBUGGING;
2210 dst->symbol.flags = BSF_LOCAL;
2212 Base the value as an index from the base of the section, if
2215 if (dst->symbol.section)
2216 dst->symbol.value = (src->u.syment.n_value) -
2217 dst->symbol.section->vma;
2219 dst->symbol.value = (src->u.syment.n_value);
2222 case C_MOS: /* member of structure */
2223 case C_EOS: /* end of structure */
2224 #ifdef NOTDEF /* C_AUTOARG has the same value */
2226 case C_GLBLREG: /* A29k-specific storage class */
2229 case C_REGPARM: /* register parameter */
2230 case C_REG: /* register variable */
2232 case C_AUTOARG: /* 960-specific storage class */
2234 case C_TPDEF: /* type definition */
2236 case C_AUTO: /* automatic variable */
2237 case C_FIELD: /* bit field */
2238 case C_ENTAG: /* enumeration tag */
2239 case C_MOE: /* member of enumeration */
2240 case C_MOU: /* member of union */
2241 case C_UNTAG: /* union tag */
2242 dst->symbol.flags = BSF_DEBUGGING;
2243 dst->symbol.value = (src->u.syment.n_value);
2246 case C_FILE: /* file name */
2247 case C_STRTAG: /* structure tag */
2249 case C_BINCL: /* beginning of include file */
2250 case C_EINCL: /* ending of include file */
2262 dst->symbol.flags = BSF_DEBUGGING;
2263 dst->symbol.value = (src->u.syment.n_value);
2268 dst->symbol.flags = BSF_DEBUGGING;
2269 dst->symbol.value = src->u.syment.n_value;
2271 /* The value is actually a symbol index. Save a pointer to
2272 the symbol instead of the index. FIXME: This should use a
2274 src->u.syment.n_value =
2275 (long) (native_symbols + src->u.syment.n_value);
2280 case C_BLOCK: /* ".bb" or ".eb" */
2281 case C_FCN: /* ".bf" or ".ef" */
2282 case C_EFCN: /* physical end of function */
2283 dst->symbol.flags = BSF_LOCAL;
2285 Base the value as an index from the base of the section
2287 dst->symbol.value = (src->u.syment.n_value) - dst->symbol.section->vma;
2291 case C_EXTDEF: /* external definition */
2292 case C_ULABEL: /* undefined label */
2293 case C_USTATIC: /* undefined static */
2294 case C_LINE: /* line # reformatted as symbol table entry */
2295 case C_ALIAS: /* duplicate tag */
2296 case C_HIDDEN: /* ext symbol in dmert public lib */
2299 fprintf (stderr, "Unrecognized storage class %d (assuming debugging)\n for %s symbol `%s'\n",
2300 src->u.syment.n_sclass, dst->symbol.section->name,
2303 dst->symbol.flags = BSF_DEBUGGING;
2304 dst->symbol.value = (src->u.syment.n_value);
2308 /* BFD_ASSERT(dst->symbol.flags != 0);*/
2312 dst->symbol.udata = 0;
2313 dst->lineno = (alent *) NULL;
2314 this_index += (src->u.syment.n_numaux) + 1;
2316 number_of_symbols++;
2317 } /* walk the native symtab */
2318 } /* bfdize the native symtab */
2320 obj_symbols (abfd) = cached_area;
2321 obj_raw_syments (abfd) = native_symbols;
2323 bfd_get_symcount (abfd) = number_of_symbols;
2324 obj_convert (abfd) = table_ptr;
2325 /* Slurp the line tables for each section too */
2331 coff_slurp_line_table (abfd, p);
2336 } /* coff_slurp_symbol_table() */
2338 /* Check whether a symbol is globally visible. This is used by the
2339 COFF backend linker code in cofflink.c, since a couple of targets
2340 have globally visible symbols which are not class C_EXT. This
2341 function need not handle the case of n_class == C_EXT. */
2343 #undef OTHER_GLOBAL_CLASS
2346 #define OTHER_GLOBAL_CLASS C_LEAFEXT
2350 #define OTHER_GLOBAL_CLASS C_HIDEXT
2353 #ifdef OTHER_GLOBAL_CLASS
2356 coff_sym_is_global (abfd, syment)
2358 struct internal_syment *syment;
2360 if (syment->n_sclass == OTHER_GLOBAL_CLASS)
2365 #undef OTHER_GLOBAL_CLASS
2367 #else /* ! defined (OTHER_GLOBAL_CLASS) */
2369 /* sym_is_global should not be defined if it has nothing to do. */
2371 #define coff_sym_is_global 0
2373 #endif /* ! defined (OTHER_GLOBAL_CLASS) */
2379 Coff relocations are easily transformed into the internal BFD form
2382 Reading a coff relocation table is done in the following stages:
2384 o Read the entire coff relocation table into memory.
2386 o Process each relocation in turn; first swap it from the
2387 external to the internal form.
2389 o Turn the symbol referenced in the relocation's symbol index
2390 into a pointer into the canonical symbol table.
2391 This table is the same as the one returned by a call to
2392 @code{bfd_canonicalize_symtab}. The back end will call that
2393 routine and save the result if a canonicalization hasn't been done.
2395 o The reloc index is turned into a pointer to a howto
2396 structure, in a back end specific way. For instance, the 386
2397 and 960 use the @code{r_type} to directly produce an index
2398 into a howto table vector; the 88k subtracts a number from the
2399 @code{r_type} field and creates an addend field.
2405 #define CALC_ADDEND(abfd, ptr, reloc, cache_ptr) \
2407 coff_symbol_type *coffsym = (coff_symbol_type *) NULL; \
2408 if (ptr && bfd_asymbol_bfd (ptr) != abfd) \
2409 coffsym = (obj_symbols (abfd) \
2410 + (cache_ptr->sym_ptr_ptr - symbols)); \
2412 coffsym = coff_symbol_from (abfd, ptr); \
2413 if (coffsym != (coff_symbol_type *) NULL \
2414 && coffsym->native->u.syment.n_scnum == 0) \
2415 cache_ptr->addend = 0; \
2416 else if (ptr && bfd_asymbol_bfd (ptr) == abfd \
2417 && ptr->section != (asection *) NULL) \
2418 cache_ptr->addend = - (ptr->section->vma + ptr->value); \
2420 cache_ptr->addend = 0; \
2425 coff_slurp_reloc_table (abfd, asect, symbols)
2430 RELOC *native_relocs;
2431 arelent *reloc_cache;
2436 if (asect->relocation)
2438 if (asect->reloc_count == 0)
2440 if (asect->flags & SEC_CONSTRUCTOR)
2442 if (!coff_slurp_symbol_table (abfd))
2445 (RELOC *) buy_and_read (abfd,
2449 asect->reloc_count));
2450 reloc_cache = (arelent *)
2451 bfd_alloc (abfd, (size_t) (asect->reloc_count * sizeof (arelent)));
2453 if (reloc_cache == NULL)
2455 bfd_set_error (bfd_error_no_memory);
2460 for (idx = 0; idx < asect->reloc_count; idx++)
2462 #ifdef RELOC_PROCESSING
2463 struct internal_reloc dst;
2464 struct external_reloc *src;
2466 cache_ptr = reloc_cache + idx;
2467 src = native_relocs + idx;
2468 coff_swap_reloc_in (abfd, src, &dst);
2470 RELOC_PROCESSING (cache_ptr, &dst, symbols, abfd, asect);
2472 struct internal_reloc dst;
2474 struct external_reloc *src;
2476 cache_ptr = reloc_cache + idx;
2477 src = native_relocs + idx;
2479 coff_swap_reloc_in (abfd, src, &dst);
2482 cache_ptr->address = dst.r_vaddr;
2484 if (dst.r_symndx != -1)
2486 /* @@ Should never be greater than count of symbols! */
2487 if (dst.r_symndx >= obj_conv_table_size (abfd))
2489 cache_ptr->sym_ptr_ptr = symbols + obj_convert (abfd)[dst.r_symndx];
2490 ptr = *(cache_ptr->sym_ptr_ptr);
2494 cache_ptr->sym_ptr_ptr = bfd_abs_section_ptr->symbol_ptr_ptr;
2498 /* The symbols definitions that we have read in have been
2499 relocated as if their sections started at 0. But the offsets
2500 refering to the symbols in the raw data have not been
2501 modified, so we have to have a negative addend to compensate.
2503 Note that symbols which used to be common must be left alone */
2505 /* Calculate any reloc addend by looking at the symbol */
2506 CALC_ADDEND (abfd, ptr, dst, cache_ptr);
2508 cache_ptr->address -= asect->vma;
2509 /* !! cache_ptr->section = (asection *) NULL;*/
2511 /* Fill in the cache_ptr->howto field from dst.r_type */
2512 RTYPE2HOWTO (cache_ptr, &dst);
2517 asect->relocation = reloc_cache;
2522 /* This is stupid. This function should be a boolean predicate. */
2524 coff_canonicalize_reloc (abfd, section, relptr, symbols)
2530 arelent *tblptr = section->relocation;
2531 unsigned int count = 0;
2534 if (section->flags & SEC_CONSTRUCTOR)
2536 /* this section has relocs made up by us, they are not in the
2537 file, so take them out of their chain and place them into
2538 the data area provided */
2539 arelent_chain *chain = section->constructor_chain;
2540 for (count = 0; count < section->reloc_count; count++)
2542 *relptr++ = &chain->relent;
2543 chain = chain->next;
2549 if (! coff_slurp_reloc_table (abfd, section, symbols))
2552 tblptr = section->relocation;
2554 for (; count++ < section->reloc_count;)
2555 *relptr++ = tblptr++;
2560 return section->reloc_count;
2565 coff_sym_filepos (abfd)
2568 return obj_sym_filepos (abfd);
2572 #ifndef coff_reloc16_estimate
2573 #define coff_reloc16_estimate dummy_reloc16_estimate
2576 dummy_reloc16_estimate (abfd, input_section, reloc, shrink, link_info)
2578 asection *input_section;
2580 unsigned int shrink;
2581 struct bfd_link_info *link_info;
2588 #ifndef coff_reloc16_extra_cases
2589 #define coff_reloc16_extra_cases dummy_reloc16_extra_cases
2590 /* This works even if abort is not declared in any header file. */
2592 dummy_reloc16_extra_cases (abfd, link_info, link_order, reloc, data, src_ptr,
2595 struct bfd_link_info *link_info;
2596 struct bfd_link_order *link_order;
2599 unsigned int *src_ptr;
2600 unsigned int *dst_ptr;
2602 fprintf (stderr, "%s\n", reloc->howto->name);
2607 /* If coff_relocate_section is defined, we can use the optimized COFF
2608 backend linker. Otherwise we must continue to use the old linker. */
2609 #ifdef coff_relocate_section
2610 #define coff_bfd_link_hash_table_create _bfd_coff_link_hash_table_create
2611 #define coff_bfd_link_add_symbols _bfd_coff_link_add_symbols
2612 #define coff_bfd_final_link _bfd_coff_final_link
2613 #else /* ! defined (coff_relocate_section) */
2614 #define coff_relocate_section NULL
2615 #define coff_bfd_link_hash_table_create _bfd_generic_link_hash_table_create
2616 #define coff_bfd_link_add_symbols _bfd_generic_link_add_symbols
2617 #define coff_bfd_final_link _bfd_generic_final_link
2618 #endif /* ! defined (coff_relocate_section) */
2620 static CONST bfd_coff_backend_data bfd_coff_std_swap_table =
2622 coff_swap_aux_in, coff_swap_sym_in, coff_swap_lineno_in,
2623 coff_swap_aux_out, coff_swap_sym_out,
2624 coff_swap_lineno_out, coff_swap_reloc_out,
2625 coff_swap_filehdr_out, coff_swap_aouthdr_out,
2626 coff_swap_scnhdr_out,
2627 FILHSZ, AOUTSZ, SCNHSZ, SYMESZ, AUXESZ, RELSZ, LINESZ,
2628 #ifdef COFF_LONG_FILENAMES
2633 coff_swap_filehdr_in, coff_swap_aouthdr_in, coff_swap_scnhdr_in,
2634 coff_swap_reloc_in, coff_bad_format_hook, coff_set_arch_mach_hook,
2635 coff_mkobject_hook, styp_to_sec_flags, coff_make_section_hook,
2636 coff_set_alignment_hook, coff_slurp_symbol_table, symname_in_debug_hook,
2637 coff_reloc16_extra_cases, coff_reloc16_estimate,
2638 coff_sym_is_global, coff_compute_section_file_positions,
2639 coff_relocate_section
2642 #define coff_close_and_cleanup _bfd_generic_close_and_cleanup
2643 #define coff_bfd_free_cached_info _bfd_generic_bfd_free_cached_info
2644 #define coff_get_section_contents _bfd_generic_get_section_contents
2646 #define coff_bfd_copy_private_section_data \
2647 _bfd_generic_bfd_copy_private_section_data
2648 #define coff_bfd_copy_private_bfd_data _bfd_generic_bfd_copy_private_bfd_data
2650 #ifndef coff_bfd_is_local_label
2651 #define coff_bfd_is_local_label bfd_generic_is_local_label
2654 /* The reloc lookup routine must be supplied by each individual COFF
2656 #ifndef coff_bfd_reloc_type_lookup
2657 #define coff_bfd_reloc_type_lookup _bfd_norelocs_bfd_reloc_type_lookup
2660 #define coff_bfd_get_relocated_section_contents \
2661 bfd_generic_get_relocated_section_contents
2662 #define coff_bfd_relax_section bfd_generic_relax_section