1 /* Support for the generic parts of most COFF variants, for BFD.
2 Copyright 1990, 1991, 1992, 1993 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 difference between formats are the sizes and
32 alignments of fields in structures on disk, and the occasional
35 Coff in all its varieties is implimented 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 @code{coff-m88k.c}. This file @code{#include}s
39 @code{coff/m88k.h} which defines the external structure of the
40 coff format for the 88k, and @code{coff/internal.h} which
41 defines the internal structure. @code{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 @code{coff-i960.c}. This file has the same structure as
47 @code{coff-m88k.c}, except that it includes @code{coff/i960.h}
48 rather than @code{coff-m88k.h}.
51 Porting To A New Version of Coff
53 The recommended method is to select from the existing
54 implimentations the version of coff which is most like the one
55 you want to use, for our purposes, we'll say that i386 coff is
56 the one you select, and that your coff flavour is called foo.
57 Copy the @code{i386coff.c} to @code{foocoff.c}, copy
58 @code{../include/coff/i386.h} to @code{../include/coff/foo.h}
59 and add the lines to @code{targets.c} and @code{Makefile.in}
60 so that your new back end is used. Alter the shapes of the
61 structures in @code{../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 @code{coff/internal.h} and
64 @code{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 @code{objdump} from the @code{binutils} directory,
68 and making sure that its version of what's going on at your
69 host systems 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 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 descibing the external layout of the structures. There is also
116 an internal description of the coff layout (in
117 @code{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 @code{coffcode.h}. Eg 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 for 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. This 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 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 changes 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 in 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 was born, and on output
194 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. Note that 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 to an index into the symbol table of the symbol
233 This routine runs through the symbol table and patches up the
234 symbols from their internal form into the coff way, calls the
235 bit twiddlers and writes out the tabel to the file.
244 The hidden information for an asymbol is described in a
245 coff_ptr_struct, which is typedefed to a combined_entry_type
249 .typedef struct coff_ptr_struct
252 . {* Remembers the offset from the first symbol in the file for
253 . this symbol. Generated by coff_renumber_symbols. *}
254 .unsigned int offset;
256 . {* Should the tag field of this symbol be renumbered.
257 . Created by coff_pointerize_aux. *}
260 . {* Should the endidx field of this symbol be renumbered.
261 . Created by coff_pointerize_aux. *}
264 . {* The container for the symbol structure as read and translated
268 . union internal_auxent auxent;
269 . struct internal_syment syment;
271 .} combined_entry_type;
274 .{* Each canonical asymbol really looks like this: *}
276 .typedef struct coff_symbol_struct
278 . {* The actual symbol which the rest of BFD works with *}
281 . {* A pointer to the hidden information for this symbol *}
282 .combined_entry_type *native;
284 . {* A pointer to the linenumber information for this symbol *}
285 .struct lineno_cache_entry *lineno;
287 . {* Have the line numbers been relocated yet ? *}
288 .boolean done_lineno;
295 #include "coffswap.h"
297 /* void warning(); */
300 * Return a word with STYP_* (scnhdr.s_flags) flags set to represent the
301 * incoming SEC_* flags. The inverse of this function is styp_to_sec_flags().
302 * NOTE: If you add to/change this routine, you should mirror the changes
303 * in styp_to_sec_flags().
306 sec_to_styp_flags (sec_name
, sec_flags
)
307 CONST
char *sec_name
;
312 if (!strcmp(sec_name
, _TEXT
))
314 styp_flags
= STYP_TEXT
;
316 else if (!strcmp(sec_name
, _DATA
))
318 styp_flags
= STYP_DATA
;
321 else if (!strcmp(sec_name
, ".data2"))
323 styp_flags
= STYP_DATA
;
324 #endif /* TWO_DATA_SECS */
326 else if (!strcmp(sec_name
, _BSS
))
328 styp_flags
= STYP_BSS
;
331 else if (!strcmp(sec_name
, _COMMENT
))
333 styp_flags
= STYP_INFO
;
334 #endif /* _COMMENT */
337 else if (!strcmp(sec_name
, _LIB
))
339 styp_flags
= STYP_LIB
;
343 else if (!strcmp (sec_name
, _LIT
))
345 styp_flags
= STYP_LIT
;
348 else if (!strcmp(sec_name
, ".debug"))
350 styp_flags
= STYP_INFO
;
352 else if (!strcmp(sec_name
, ".stab")
353 || !strncmp(sec_name
, ".stabstr", 8))
355 styp_flags
= STYP_INFO
;
357 /* Try and figure out what it should be */
358 else if (sec_flags
& SEC_CODE
)
360 styp_flags
= STYP_TEXT
;
362 else if (sec_flags
& SEC_DATA
)
364 styp_flags
= STYP_DATA
;
366 else if (sec_flags
& SEC_READONLY
)
368 #ifdef STYP_LIT /* 29k readonly text/data section */
369 styp_flags
= STYP_LIT
;
371 styp_flags
= STYP_TEXT
;
372 #endif /* STYP_LIT */
374 else if (sec_flags
& SEC_LOAD
)
376 styp_flags
= STYP_TEXT
;
378 else if (sec_flags
& SEC_ALLOC
)
380 styp_flags
= STYP_BSS
;
384 if (sec_flags
& SEC_NEVER_LOAD
)
385 styp_flags
|= STYP_NOLOAD
;
391 * Return a word with SEC_* flags set to represent the incoming
392 * STYP_* flags (from scnhdr.s_flags). The inverse of this
393 * function is sec_to_styp_flags().
394 * NOTE: If you add to/change this routine, you should mirror the changes
395 * in sec_to_styp_flags().
398 DEFUN(styp_to_sec_flags
, (abfd
, hdr
),
402 struct internal_scnhdr
*internal_s
= (struct internal_scnhdr
*) hdr
;
403 long styp_flags
= internal_s
->s_flags
;
404 flagword sec_flags
=0;
407 if (styp_flags
& STYP_NOLOAD
)
409 sec_flags
|= SEC_NEVER_LOAD
;
411 #endif /* STYP_NOLOAD */
413 /* For 386 COFF, at least, an unloadable text or data section is
414 actually a shared library section. */
415 if (styp_flags
& STYP_TEXT
)
417 if (sec_flags
& SEC_NEVER_LOAD
)
418 sec_flags
|= SEC_CODE
| SEC_SHARED_LIBRARY
;
420 sec_flags
|= SEC_CODE
| SEC_LOAD
| SEC_ALLOC
;
422 else if (styp_flags
& STYP_DATA
)
424 if (sec_flags
& SEC_NEVER_LOAD
)
425 sec_flags
|= SEC_DATA
| SEC_SHARED_LIBRARY
;
427 sec_flags
|= SEC_DATA
| SEC_LOAD
| SEC_ALLOC
;
429 else if (styp_flags
& STYP_BSS
)
431 #ifdef BSS_NOLOAD_IS_SHARED_LIBRARY
432 if (sec_flags
& SEC_NEVER_LOAD
)
433 sec_flags
|= SEC_ALLOC
| SEC_SHARED_LIBRARY
;
436 sec_flags
|= SEC_ALLOC
;
438 else if (styp_flags
& STYP_INFO
)
440 /* Assume that any informational section is primarily for debugging
441 and therefore a prime candidate for stripping. */
442 sec_flags
|= SEC_DEBUGGING
;
446 sec_flags
|= SEC_ALLOC
| SEC_LOAD
;
449 #ifdef STYP_LIT /* A29k readonly text/data section type */
450 if ((styp_flags
& STYP_LIT
) == STYP_LIT
)
452 sec_flags
= (SEC_LOAD
| SEC_ALLOC
| SEC_READONLY
);
454 #endif /* STYP_LIT */
455 #ifdef STYP_OTHER_LOAD /* Other loaded sections */
456 if (styp_flags
& STYP_OTHER_LOAD
)
458 sec_flags
= (SEC_LOAD
| SEC_ALLOC
);
460 #endif /* STYP_SDATA */
465 #define get_index(symbol) ((long) (symbol)->udata)
469 bfd_coff_backend_data
473 Special entry points for gdb to swap in coff symbol table parts
476 . void (*_bfd_coff_swap_aux_in) PARAMS ((
483 . void (*_bfd_coff_swap_sym_in) PARAMS ((
488 . void (*_bfd_coff_swap_lineno_in) PARAMS ((
494 Special entry points for gas to swap coff parts
496 . unsigned int (*_bfd_coff_swap_aux_out) PARAMS ((
503 . unsigned int (*_bfd_coff_swap_sym_out) PARAMS ((
508 . unsigned int (*_bfd_coff_swap_lineno_out) PARAMS ((
513 . unsigned int (*_bfd_coff_swap_reloc_out) PARAMS ((
518 . unsigned int (*_bfd_coff_swap_filehdr_out) PARAMS ((
523 . unsigned int (*_bfd_coff_swap_aouthdr_out) PARAMS ((
528 . unsigned int (*_bfd_coff_swap_scnhdr_out) PARAMS ((
534 Special entry points for generic COFF routines to call target
535 dependent COFF routines
537 . unsigned int _bfd_filhsz;
538 . unsigned int _bfd_aoutsz;
539 . unsigned int _bfd_scnhsz;
540 . unsigned int _bfd_symesz;
541 . unsigned int _bfd_auxesz;
542 . unsigned int _bfd_linesz;
543 . boolean _bfd_coff_long_filenames;
544 . void (*_bfd_coff_swap_filehdr_in) PARAMS ((
548 . void (*_bfd_coff_swap_aouthdr_in) PARAMS ((
552 . void (*_bfd_coff_swap_scnhdr_in) PARAMS ((
556 . boolean (*_bfd_coff_bad_format_hook) PARAMS ((
558 . PTR internal_filehdr));
559 . boolean (*_bfd_coff_set_arch_mach_hook) PARAMS ((
561 . PTR internal_filehdr));
562 . PTR (*_bfd_coff_mkobject_hook) PARAMS ((
564 . PTR internal_filehdr,
565 . PTR internal_aouthdr));
566 . flagword (*_bfd_styp_to_sec_flags_hook) PARAMS ((
568 . PTR internal_scnhdr));
569 . asection *(*_bfd_make_section_hook) PARAMS ((
572 . void (*_bfd_set_alignment_hook) PARAMS ((
575 . PTR internal_scnhdr));
576 . boolean (*_bfd_coff_slurp_symbol_table) PARAMS ((
578 . boolean (*_bfd_coff_symname_in_debug) PARAMS ((
580 . struct internal_syment *sym));
581 . void (*_bfd_coff_reloc16_extra_cases) PARAMS ((
583 . struct bfd_seclet *seclet,
586 . unsigned int *src_ptr,
587 . unsigned int *dst_ptr));
588 . int (*_bfd_coff_reloc16_estimate) PARAMS ((
589 . asection *input_section,
592 . unsigned int shrink));
594 .} bfd_coff_backend_data;
596 .#define coff_backend_info(abfd) ((bfd_coff_backend_data *) (abfd)->xvec->backend_data)
598 .#define bfd_coff_swap_aux_in(a,e,t,c,i) \
599 . ((coff_backend_info (a)->_bfd_coff_swap_aux_in) (a,e,t,c,i))
601 .#define bfd_coff_swap_sym_in(a,e,i) \
602 . ((coff_backend_info (a)->_bfd_coff_swap_sym_in) (a,e,i))
604 .#define bfd_coff_swap_lineno_in(a,e,i) \
605 . ((coff_backend_info ( a)->_bfd_coff_swap_lineno_in) (a,e,i))
607 .#define bfd_coff_swap_reloc_out(abfd, i, o) \
608 . ((coff_backend_info (abfd)->_bfd_coff_swap_reloc_out) (abfd, i, o))
610 .#define bfd_coff_swap_lineno_out(abfd, i, o) \
611 . ((coff_backend_info (abfd)->_bfd_coff_swap_lineno_out) (abfd, i, o))
613 .#define bfd_coff_swap_aux_out(abfd, i, t,c,o) \
614 . ((coff_backend_info (abfd)->_bfd_coff_swap_aux_out) (abfd, i,t,c, o))
616 .#define bfd_coff_swap_sym_out(abfd, i,o) \
617 . ((coff_backend_info (abfd)->_bfd_coff_swap_sym_out) (abfd, i, o))
619 .#define bfd_coff_swap_scnhdr_out(abfd, i,o) \
620 . ((coff_backend_info (abfd)->_bfd_coff_swap_scnhdr_out) (abfd, i, o))
622 .#define bfd_coff_swap_filehdr_out(abfd, i,o) \
623 . ((coff_backend_info (abfd)->_bfd_coff_swap_filehdr_out) (abfd, i, o))
625 .#define bfd_coff_swap_aouthdr_out(abfd, i,o) \
626 . ((coff_backend_info (abfd)->_bfd_coff_swap_aouthdr_out) (abfd, i, o))
628 .#define bfd_coff_filhsz(abfd) (coff_backend_info (abfd)->_bfd_filhsz)
629 .#define bfd_coff_aoutsz(abfd) (coff_backend_info (abfd)->_bfd_aoutsz)
630 .#define bfd_coff_scnhsz(abfd) (coff_backend_info (abfd)->_bfd_scnhsz)
631 .#define bfd_coff_symesz(abfd) (coff_backend_info (abfd)->_bfd_symesz)
632 .#define bfd_coff_auxesz(abfd) (coff_backend_info (abfd)->_bfd_auxesz)
633 .#define bfd_coff_linesz(abfd) (coff_backend_info (abfd)->_bfd_linesz)
634 .#define bfd_coff_long_filenames(abfd) (coff_backend_info (abfd)->_bfd_coff_long_filenames)
635 .#define bfd_coff_swap_filehdr_in(abfd, i,o) \
636 . ((coff_backend_info (abfd)->_bfd_coff_swap_filehdr_in) (abfd, i, o))
638 .#define bfd_coff_swap_aouthdr_in(abfd, i,o) \
639 . ((coff_backend_info (abfd)->_bfd_coff_swap_aouthdr_in) (abfd, i, o))
641 .#define bfd_coff_swap_scnhdr_in(abfd, i,o) \
642 . ((coff_backend_info (abfd)->_bfd_coff_swap_scnhdr_in) (abfd, i, o))
644 .#define bfd_coff_bad_format_hook(abfd, filehdr) \
645 . ((coff_backend_info (abfd)->_bfd_coff_bad_format_hook) (abfd, filehdr))
647 .#define bfd_coff_set_arch_mach_hook(abfd, filehdr)\
648 . ((coff_backend_info (abfd)->_bfd_coff_set_arch_mach_hook) (abfd, filehdr))
649 .#define bfd_coff_mkobject_hook(abfd, filehdr, aouthdr)\
650 . ((coff_backend_info (abfd)->_bfd_coff_mkobject_hook) (abfd, filehdr, aouthdr))
652 .#define bfd_coff_styp_to_sec_flags_hook(abfd, scnhdr)\
653 . ((coff_backend_info (abfd)->_bfd_styp_to_sec_flags_hook) (abfd, scnhdr))
655 .#define bfd_coff_make_section_hook(abfd, name)\
656 . ((coff_backend_info (abfd)->_bfd_make_section_hook) (abfd, name))
658 .#define bfd_coff_set_alignment_hook(abfd, sec, scnhdr)\
659 . ((coff_backend_info (abfd)->_bfd_set_alignment_hook) (abfd, sec, scnhdr))
661 .#define bfd_coff_slurp_symbol_table(abfd)\
662 . ((coff_backend_info (abfd)->_bfd_coff_slurp_symbol_table) (abfd))
664 .#define bfd_coff_symname_in_debug(abfd, sym)\
665 . ((coff_backend_info (abfd)->_bfd_coff_symname_in_debug) (abfd, sym))
667 .#define bfd_coff_reloc16_extra_cases(abfd, seclet, reloc, data, src_ptr, dst_ptr)\
668 . ((coff_backend_info (abfd)->_bfd_coff_reloc16_extra_cases)\
669 . (abfd, seclet, reloc, data, src_ptr, dst_ptr))
671 .#define bfd_coff_reloc16_estimate(abfd, section, symbols, reloc, shrink)\
672 . ((coff_backend_info (abfd)->_bfd_coff_reloc16_estimate)\
673 . (section, symbols, reloc, shrink))
677 /* See whether the magic number matches. */
680 DEFUN(coff_bad_format_hook
, (abfd
, filehdr
),
684 struct internal_filehdr
*internal_f
= (struct internal_filehdr
*) filehdr
;
686 if (BADMAG (*internal_f
))
689 /* if the optional header is NULL or not the correct size then
690 quit; the only difference I can see between m88k dgux headers (MC88DMAGIC)
691 and Intel 960 readwrite headers (I960WRMAGIC) is that the
692 optional header is of a different size.
694 But the mips keeps extra stuff in it's opthdr, so dont check
698 #if defined(M88) || defined(I960)
699 if (internal_f
->f_opthdr
!= 0 && AOUTSZ
!= internal_f
->f_opthdr
)
707 DEFUN (coff_make_section_hook
, (abfd
, name
),
712 /* FIXME: This predates the call to bfd_make_section_anyway
713 in make_a_section_from_file, and can probably go away. */
714 /* On SCO a file created by the Microsoft assembler can have two
715 .data sections. We use .data2 for the second one. */
716 if (strcmp (name
, _DATA
) == 0)
717 return bfd_make_section (abfd
, ".data2");
719 return (asection
*) NULL
;
723 initialize a section structure with information peculiar to this
724 particular implementation of coff
728 DEFUN(coff_new_section_hook
,(abfd
, section
),
732 section
->alignment_power
= abfd
->xvec
->align_power_min
;
733 /* Allocate aux records for section symbols, to store size and
736 @@ Shouldn't use constant multiplier here! */
737 coffsymbol (section
->symbol
)->native
=
738 (combined_entry_type
*) bfd_zalloc (abfd
,
739 sizeof (combined_entry_type
) * 10);
746 /* Set the alignment of a BFD section. */
749 DEFUN (coff_set_alignment_hook
, (abfd
, section
, scnhdr
),
751 asection
*section AND
754 struct internal_scnhdr
*hdr
= (struct internal_scnhdr
*) scnhdr
;
757 for (i
= 0; i
< 32; i
++)
758 if ((1 << i
) >= hdr
->s_align
)
760 section
->alignment_power
= i
;
765 #define coff_set_alignment_hook \
766 ((void (*) PARAMS ((bfd *, asection *, PTR))) bfd_void)
771 DEFUN(coff_mkobject
,(abfd
),
774 coff_data_type
*coff
;
776 abfd
->tdata
.coff_obj_data
= (struct coff_tdata
*)bfd_zalloc (abfd
,sizeof(coff_data_type
));
777 if (abfd
->tdata
.coff_obj_data
== 0){
778 bfd_error
= no_memory
;
781 coff
= coff_data (abfd
);
782 coff
->symbols
= (coff_symbol_type
*) NULL
;
783 coff
->conversion_table
= (unsigned int *) NULL
;
784 coff
->raw_syments
= (struct coff_ptr_struct
*) NULL
;
785 coff
->raw_linenos
= (struct lineno
*) NULL
;
787 /* make_abs_section(abfd);*/
791 /* Create the COFF backend specific information. */
794 DEFUN(coff_mkobject_hook
,(abfd
, filehdr
, aouthdr
),
799 struct internal_filehdr
*internal_f
= (struct internal_filehdr
*) filehdr
;
800 coff_data_type
*coff
;
802 if (coff_mkobject (abfd
) == false)
805 coff
= coff_data (abfd
);
807 coff
->sym_filepos
= internal_f
->f_symptr
;
808 coff
->flags
= internal_f
->f_flags
;
810 /* These members communicate important constants about the symbol
811 table to GDB's symbol-reading code. These `constants'
812 unfortunately vary among coff implementations... */
813 coff
->local_n_btmask
= N_BTMASK
;
814 coff
->local_n_btshft
= N_BTSHFT
;
815 coff
->local_n_tmask
= N_TMASK
;
816 coff
->local_n_tshift
= N_TSHIFT
;
817 coff
->local_symesz
= SYMESZ
;
818 coff
->local_auxesz
= AUXESZ
;
819 coff
->local_linesz
= LINESZ
;
824 /* Determine the machine architecture and type. FIXME: This is target
825 dependent because the magic numbers are defined in the target
826 dependent header files. But there is no particular need for this.
827 If the magic numbers were moved to a separate file, this function
828 would be target independent and would also be much more successful
829 at linking together COFF files for different architectures. */
832 coff_set_arch_mach_hook(abfd
, filehdr
)
837 enum bfd_architecture arch
;
838 struct internal_filehdr
*internal_f
= (struct internal_filehdr
*) filehdr
;
841 switch (internal_f
->f_magic
) {
845 case I386AIXMAGIC
: /* Danbury PS/2 AIX C Compiler */
847 arch
= bfd_arch_i386
;
852 #ifdef A29K_MAGIC_BIG
854 case A29K_MAGIC_LITTLE
:
855 arch
= bfd_arch_a29k
;
864 arch
= bfd_arch_m68k
;
872 arch
= bfd_arch_m88k
;
879 switch (internal_f
->f_flags
& F_MACHMASK
)
882 machine
= bfd_mach_z8001
;
885 machine
= bfd_mach_z8002
;
896 arch
= bfd_arch_i960
;
897 switch (F_I960TYPE
& internal_f
->f_flags
)
901 machine
= bfd_mach_i960_core
;
904 machine
= bfd_mach_i960_kb_sb
;
907 machine
= bfd_mach_i960_mc
;
910 machine
= bfd_mach_i960_xa
;
913 machine
= bfd_mach_i960_ca
;
916 machine
= bfd_mach_i960_ka_sa
;
927 arch
= bfd_arch_rs6000
;
934 arch
= bfd_arch_we32k
;
941 arch
= bfd_arch_h8300
;
942 machine
= bfd_mach_h8300
;
943 /* !! FIXME this probably isn't the right place for this */
944 abfd
->flags
|= BFD_IS_RELAXABLE
;
950 arch
= bfd_arch_h8300
;
951 machine
= bfd_mach_h8300h
;
952 /* !! FIXME this probably isn't the right place for this */
953 abfd
->flags
|= BFD_IS_RELAXABLE
;
966 arch
= bfd_arch_h8500
;
971 default: /* Unreadable input file type */
972 arch
= bfd_arch_obscure
;
976 bfd_default_set_arch_mach(abfd
, arch
, machine
);
980 #ifdef SYMNAME_IN_DEBUG
983 DEFUN (symname_in_debug_hook
, (abfd
, sym
),
985 struct internal_syment
*sym
)
987 return SYMNAME_IN_DEBUG (sym
) ? true : false;
992 #define symname_in_debug_hook \
993 (boolean (*) PARAMS ((bfd *, struct internal_syment *))) bfd_false
1001 To write relocations, all the back end does is step though the
1002 canonical relocation table, and create an
1003 @code{internal_reloc}. The symbol index to use is removed from
1004 the @code{offset} field in the symbol table supplied, the
1005 address comes directly from the sum of the section base
1006 address and the relocation offset and the type is dug directly
1007 from the howto field. Then the @code{internal_reloc} is
1008 swapped into the shape of an @code{external_reloc} and written
1014 DEFUN(coff_write_relocs
,(abfd
),
1018 for (s
= abfd
->sections
; s
!= (asection
*) NULL
; s
= s
->next
) {
1020 struct external_reloc dst
;
1022 arelent
**p
= s
->orelocation
;
1023 bfd_seek(abfd
, s
->rel_filepos
, SEEK_SET
);
1024 for (i
= 0; i
< s
->reloc_count
; i
++) {
1025 struct internal_reloc n
;
1027 memset((PTR
)&n
, 0, sizeof(n
));
1029 n
.r_vaddr
= q
->address
+ s
->vma
;
1030 /* The 29k const/consth reloc pair is a real kludge - the consth
1031 part doesn't have a symbol - it has an offset. So rebuilt
1034 if (q
->howto
->type
== R_IHCONST
)
1035 n
.r_symndx
= q
->addend
;
1042 if (q
->sym_ptr_ptr
== bfd_abs_section
.symbol_ptr_ptr
)
1044 /* This is a relocation relative to the absolute symbol */
1049 n
.r_symndx
= get_index((*(q
->sym_ptr_ptr
)));
1050 /* Take notice if the symbol reloc points to a symbol we don't have
1051 in our symbol table. What should we do for this?? */
1052 if (n
.r_symndx
> obj_conv_table_size (abfd
))
1060 /* Work out reloc type from what is required */
1061 SELECT_RELOC(n
.r_type
, q
->howto
);
1063 n
.r_type
= q
->howto
->type
;
1065 coff_swap_reloc_out(abfd
, &n
, &dst
);
1066 bfd_write((PTR
) &dst
, 1, RELSZ
, abfd
);
1071 /* Set flags and magic number of a coff file from architecture and machine
1072 type. Result is true if we can represent the arch&type, false if not. */
1075 DEFUN(coff_set_flags
,(abfd
, magicp
, flagsp
),
1077 unsigned *magicp AND
1078 unsigned short *flagsp
)
1080 switch (bfd_get_arch(abfd
)) {
1084 switch (bfd_get_mach(abfd
))
1086 case bfd_mach_z8001
:
1089 case bfd_mach_z8002
:
1103 *magicp
= I960ROMAGIC
;
1105 ((bfd_get_file_flags(abfd) & WP_TEXT) ? I960ROMAGIC :
1106 I960RWMAGIC); FIXME???
1108 switch (bfd_get_mach(abfd
)) {
1109 case bfd_mach_i960_core
:
1112 case bfd_mach_i960_kb_sb
:
1115 case bfd_mach_i960_mc
:
1118 case bfd_mach_i960_xa
:
1121 case bfd_mach_i960_ca
:
1124 case bfd_mach_i960_ka_sa
:
1137 *magicp
= I386MAGIC
;
1143 *magicp
= MC68MAGIC
;
1150 *magicp
= MC88OMAGIC
;
1155 case bfd_arch_h8300
:
1156 switch (bfd_get_mach (abfd
))
1158 case bfd_mach_h8300
:
1159 *magicp
= H8300MAGIC
;
1161 case bfd_mach_h8300h
:
1162 *magicp
= H8300HMAGIC
;
1176 case bfd_arch_h8500
:
1177 *magicp
= H8500MAGIC
;
1181 #ifdef A29K_MAGIC_BIG
1183 if (abfd
->xvec
->byteorder_big_p
)
1184 *magicp
= A29K_MAGIC_BIG
;
1186 *magicp
= A29K_MAGIC_LITTLE
;
1192 case bfd_arch_we32k
:
1193 *magicp
= WE32KMAGIC
;
1199 case bfd_arch_rs6000
:
1200 *magicp
= U802TOCMAGIC
;
1205 default: /* Unknown architecture */
1206 /* return false; -- fall through to "return false" below, to avoid
1207 "statement never reached" errors on the one below. */
1216 DEFUN(coff_set_arch_mach
,(abfd
, arch
, machine
),
1218 enum bfd_architecture arch AND
1219 unsigned long machine
)
1222 unsigned short dummy2
;
1223 bfd_default_set_arch_mach(abfd
, arch
, machine
);
1225 if (arch
!= bfd_arch_unknown
&&
1226 coff_set_flags(abfd
, &dummy1
, &dummy2
) != true)
1227 return false; /* We can't represent this type */
1228 return true; /* We're easy ... */
1232 /* Calculate the file position for each section. */
1235 DEFUN(coff_compute_section_file_positions
,(abfd
),
1239 asection
*previous
= (asection
*)NULL
;
1240 file_ptr sofar
= FILHSZ
;
1244 if (bfd_get_start_address(abfd
))
1246 /* A start address may have been added to the original file. In this
1247 case it will need an optional header to record it. */
1248 abfd
->flags
|= EXEC_P
;
1251 if (abfd
->flags
& EXEC_P
)
1254 sofar
+= abfd
->section_count
* SCNHSZ
;
1255 #ifdef USE_DISCARDED_SECTIONS_COUNT
1256 /* Count any sections that were removed, so overall size doesn't change. */
1257 sofar
+= discarded_sections_count
* SCNHSZ
;
1259 for (current
= abfd
->sections
;
1260 current
!= (asection
*)NULL
;
1261 current
= current
->next
) {
1263 /* Only deal with sections which have contents */
1264 if (!(current
->flags
& SEC_HAS_CONTENTS
))
1267 /* Align the sections in the file to the same boundary on
1268 which they are aligned in virtual memory. I960 doesn't
1269 do this (FIXME) so we can stay in sync with Intel. 960
1270 doesn't yet page from files... */
1273 /* make sure this section is aligned on the right boundary - by
1274 padding the previous section up if necessary */
1277 sofar
= BFD_ALIGN(sofar
, 1 << current
->alignment_power
);
1278 if (previous
!= (asection
*)NULL
) {
1279 previous
->_raw_size
+= sofar
- old_sofar
;
1284 /* FIXME, in demand paged files, the low order bits of the file
1285 offset must match the low order bits of the virtual address.
1286 "Low order" is apparently implementation defined. Add code
1287 here to round sofar up to match the virtual address. */
1289 current
->filepos
= sofar
;
1291 sofar
+= current
->_raw_size
;
1293 /* make sure that this section is of the right size too */
1295 sofar
= BFD_ALIGN(sofar
, 1 << current
->alignment_power
);
1296 current
->_raw_size
+= sofar
- old_sofar
;
1300 /* Force .lib sections to start at zero. The vma is then
1301 incremented in coff_set_section_contents. This is right for
1303 if (strcmp (current
->name
, _LIB
) == 0)
1304 bfd_set_section_vma (abfd
, current
, 0);
1309 obj_relocbase(abfd
) = sofar
;
1312 /* If .file, .text, .data, .bss symbols are missing, add them. */
1313 /* @@ Should we only be adding missing symbols, or overriding the aux
1314 values for existing section symbols? */
1316 coff_add_missing_symbols (abfd
)
1319 unsigned int nsyms
= bfd_get_symcount (abfd
);
1320 asymbol
**sympp
= abfd
->outsymbols
;
1323 int need_text
= 1, need_data
= 1, need_bss
= 1, need_file
= 1;
1325 for (i
= 0; i
< nsyms
; i
++)
1327 coff_symbol_type
*csym
= coff_symbol_from (abfd
, sympp
[i
]);
1331 /* only do this if there is a coff representation of the input
1333 if (csym
->native
&& csym
->native
->u
.syment
.n_sclass
== C_FILE
)
1338 name
= csym
->symbol
.name
;
1341 if (!strcmp (name
, _TEXT
))
1343 else if (!strcmp (name
, _DATA
))
1345 else if (!strcmp (name
, _BSS
))
1349 /* Now i == bfd_get_symcount (abfd). */
1350 /* @@ For now, don't deal with .file symbol. */
1353 if (!need_text
&& !need_data
&& !need_bss
&& !need_file
)
1355 nsyms
+= need_text
+ need_data
+ need_bss
+ need_file
;
1356 sympp2
= (asymbol
**) bfd_alloc_by_size_t (abfd
, nsyms
* sizeof (asymbol
*));
1357 memcpy (sympp2
, sympp
, i
* sizeof (asymbol
*));
1360 /* @@ Generate fake .file symbol, in sympp2[i], and increment i. */
1364 sympp2
[i
++] = coff_section_symbol (abfd
, _TEXT
);
1366 sympp2
[i
++] = coff_section_symbol (abfd
, _DATA
);
1368 sympp2
[i
++] = coff_section_symbol (abfd
, _BSS
);
1369 BFD_ASSERT (i
== nsyms
);
1370 bfd_set_symtab (abfd
, sympp2
, nsyms
);
1376 DEFUN(coff_write_object_contents
,(abfd
),
1382 boolean hasrelocs
= false;
1383 boolean haslinno
= false;
1384 file_ptr reloc_base
;
1385 file_ptr lineno_base
;
1389 unsigned long reloc_size
= 0;
1390 unsigned long lnno_size
= 0;
1391 asection
*text_sec
= NULL
;
1392 asection
*data_sec
= NULL
;
1393 asection
*bss_sec
= NULL
;
1395 struct internal_filehdr internal_f
;
1396 struct internal_aouthdr internal_a
;
1399 bfd_error
= system_call_error
;
1400 /* Number the output sections, starting from one on the first section
1401 with a name which doesn't start with a *.
1402 @@ The code doesn't make this check. Is it supposed to be done,
1405 for (current
= abfd
->sections
; current
!= (asection
*)NULL
;
1406 current
= current
->next
)
1408 current
->target_index
= count
;
1412 if(abfd
->output_has_begun
== false) {
1413 coff_compute_section_file_positions(abfd
);
1416 if (abfd
->sections
!= (asection
*)NULL
) {
1417 scn_base
= abfd
->sections
->filepos
;
1422 if (bfd_seek(abfd
, scn_base
, SEEK_SET
) != 0)
1424 reloc_base
= obj_relocbase(abfd
);
1426 /* Make a pass through the symbol table to count line number entries and
1427 put them into the correct asections */
1429 lnno_size
= coff_count_linenumbers(abfd
) * LINESZ
;
1430 data_base
= scn_base
;
1432 /* Work out the size of the reloc and linno areas */
1434 for (current
= abfd
->sections
; current
!= NULL
; current
=
1437 /* We give section headers to +ve indexes */
1438 if (current
->target_index
> 0)
1441 reloc_size
+= current
->reloc_count
* RELSZ
;
1442 data_base
+= SCNHSZ
;
1447 lineno_base
= reloc_base
+ reloc_size
;
1448 sym_base
= lineno_base
+ lnno_size
;
1450 /* Indicate in each section->line_filepos its actual file address */
1451 for (current
= abfd
->sections
; current
!= NULL
; current
=
1454 if (current
->target_index
> 0)
1457 if (current
->lineno_count
) {
1458 current
->line_filepos
= lineno_base
;
1459 current
->moving_line_filepos
= lineno_base
;
1460 lineno_base
+= current
->lineno_count
* LINESZ
;
1463 current
->line_filepos
= 0;
1465 if (current
->reloc_count
) {
1466 current
->rel_filepos
= reloc_base
;
1467 reloc_base
+= current
->reloc_count
* RELSZ
;
1470 current
->rel_filepos
= 0;
1477 /* Write section headers to the file. */
1478 internal_f
.f_nscns
= 0;
1480 (file_ptr
) ((abfd
->flags
& EXEC_P
) ?
1481 (FILHSZ
+ AOUTSZ
) : FILHSZ
),
1486 unsigned int pad
= abfd
->flags
& D_PAGED
? data_base
: 0;
1488 unsigned int pad
= 0;
1490 for (current
= abfd
->sections
;
1492 current
= current
->next
) {
1493 struct internal_scnhdr section
;
1494 if (current
->target_index
> 0)
1496 internal_f
.f_nscns
++;
1497 strncpy(&(section
.s_name
[0]), current
->name
, 8);
1499 /* Always set s_vaddr of .lib to 0. This is right for SVR3.2
1500 Ian Taylor <ian@cygnus.com>. */
1501 if (strcmp (current
->name
, _LIB
) == 0)
1502 section
.s_vaddr
= 0;
1505 section
.s_vaddr
= current
->lma
+ pad
;
1506 section
.s_paddr
= current
->lma
+ pad
;
1507 section
.s_size
= current
->_raw_size
- pad
;
1509 If this section has no size or is unloadable then the scnptr
1512 if (current
->_raw_size
- pad
== 0 ||
1513 (current
->flags
& (SEC_LOAD
| SEC_HAS_CONTENTS
)) == 0) {
1514 section
.s_scnptr
= 0;
1517 section
.s_scnptr
= current
->filepos
;
1519 section
.s_relptr
= current
->rel_filepos
;
1520 section
.s_lnnoptr
= current
->line_filepos
;
1521 section
.s_nreloc
= current
->reloc_count
;
1522 section
.s_nlnno
= current
->lineno_count
;
1523 if (current
->reloc_count
!= 0)
1525 if (current
->lineno_count
!= 0)
1528 section
.s_flags
= sec_to_styp_flags(current
->name
,current
->flags
);
1530 if (!strcmp(current
->name
, _TEXT
)) {
1532 } else if (!strcmp(current
->name
, _DATA
)) {
1534 #ifdef TWO_DATA_SECS
1535 } else if (!strcmp(current
->name
, ".data2")) {
1537 #endif /* TWO_DATA_SECS */
1538 } else if (!strcmp(current
->name
, _BSS
)) {
1543 section
.s_align
= (current
->alignment_power
1544 ? 1 << current
->alignment_power
1551 coff_swap_scnhdr_out(abfd
, §ion
, &buff
);
1552 bfd_write((PTR
) (&buff
), 1, SCNHSZ
, abfd
);
1562 /* OK, now set up the filehdr... */
1564 /* Don't include the internal abs section in the section count */
1567 We will NOT put a fucking timestamp in the header here. Every time you
1568 put it back, I will come in and take it out again. I'm sorry. This
1569 field does not belong here. We fill it with a 0 so it compares the
1570 same but is not a reasonable time. -- gnu@cygnus.com
1572 internal_f
.f_timdat
= 0;
1574 if (bfd_get_symcount(abfd
) != 0)
1575 internal_f
.f_symptr
= sym_base
;
1577 internal_f
.f_symptr
= 0;
1579 internal_f
.f_flags
= 0;
1581 if (abfd
->flags
& EXEC_P
)
1582 internal_f
.f_opthdr
= AOUTSZ
;
1584 internal_f
.f_opthdr
= 0;
1587 internal_f
.f_flags
|= F_RELFLG
;
1589 internal_f
.f_flags
|= F_LNNO
;
1590 if (0 == bfd_get_symcount(abfd
))
1591 internal_f
.f_flags
|= F_LSYMS
;
1592 if (abfd
->flags
& EXEC_P
)
1593 internal_f
.f_flags
|= F_EXEC
;
1595 if (!abfd
->xvec
->byteorder_big_p
)
1596 internal_f
.f_flags
|= F_AR32WR
;
1598 internal_f
.f_flags
|= F_AR32W
;
1601 FIXME, should do something about the other byte orders and
1605 /* Set up architecture-dependent stuff */
1607 { unsigned int magic
= 0;
1608 unsigned short flags
= 0;
1609 coff_set_flags(abfd
, &magic
, &flags
);
1610 internal_f
.f_magic
= magic
;
1611 internal_f
.f_flags
|= flags
;
1612 /* ...and the "opt"hdr... */
1615 # ifdef ULTRA3 /* NYU's machine */
1616 /* FIXME: This is a bogus check. I really want to see if there
1617 * is a .shbss or a .shdata section, if so then set the magic
1618 * number to indicate a shared data executable.
1620 if (internal_f
.f_nscns
>= 7)
1621 internal_a
.magic
= SHMAGIC
; /* Shared magic */
1623 # endif /* ULTRA3 */
1624 internal_a
.magic
= NMAGIC
; /* Assume separate i/d */
1625 #define __A_MAGIC_SET__
1628 internal_a
.magic
= (magic
== I960ROMAGIC
? NMAGIC
: OMAGIC
);
1629 #define __A_MAGIC_SET__
1632 #define __A_MAGIC_SET__
1633 internal_a
.magic
= PAGEMAGICBCS
;
1637 #define __A_MAGIC_SET__
1638 /* Never was anything here for the 68k */
1639 #endif /* M68 || WE32K */
1642 # define __A_MAGIC_SET__
1643 internal_a
.magic
= ZMAGIC
;
1647 #define __A_MAGIC_SET__
1648 internal_a
.magic
= (abfd
->flags
& D_PAGED
)? RS6K_AOUTHDR_ZMAGIC
:
1649 (abfd
->flags
& WP_TEXT
)? RS6K_AOUTHDR_NMAGIC
:
1650 RS6K_AOUTHDR_OMAGIC
;
1653 #ifndef __A_MAGIC_SET__
1654 # include "Your aouthdr magic number is not being set!"
1656 # undef __A_MAGIC_SET__
1659 /* Now should write relocs, strings, syms */
1660 obj_sym_filepos(abfd
) = sym_base
;
1662 if (bfd_get_symcount(abfd
) != 0) {
1663 coff_add_missing_symbols (abfd
);
1664 coff_renumber_symbols(abfd
);
1665 coff_mangle_symbols(abfd
);
1666 coff_write_symbols(abfd
);
1667 coff_write_linenumbers(abfd
);
1668 coff_write_relocs(abfd
);
1671 internal_a
.tsize
= bfd_get_section_size_before_reloc(text_sec
);
1672 internal_a
.text_start
= internal_a
.tsize
? text_sec
->vma
: 0;
1675 internal_a
.dsize
= bfd_get_section_size_before_reloc(data_sec
);
1676 internal_a
.data_start
= internal_a
.dsize
? data_sec
->vma
: 0;
1679 internal_a
.bsize
= bfd_get_section_size_before_reloc(bss_sec
);
1682 internal_a
.entry
= bfd_get_start_address(abfd
);
1683 internal_f
.f_nsyms
= bfd_get_symcount(abfd
);
1685 /* now write them */
1686 if (bfd_seek(abfd
, (file_ptr
) 0, SEEK_SET
) != 0)
1690 coff_swap_filehdr_out(abfd
, (PTR
)&internal_f
, (PTR
)&buff
);
1691 bfd_write((PTR
) &buff
, 1, FILHSZ
, abfd
);
1693 if (abfd
->flags
& EXEC_P
) {
1695 coff_swap_aouthdr_out(abfd
, (PTR
)&internal_a
, (PTR
)&buff
);
1696 bfd_write((PTR
) &buff
, 1, AOUTSZ
, abfd
);
1702 DEFUN(coff_set_section_contents
,(abfd
, section
, location
, offset
, count
),
1707 bfd_size_type count
)
1709 if (abfd
->output_has_begun
== false) /* set by bfd.c handler */
1710 coff_compute_section_file_positions(abfd
);
1713 /* If this is a .lib section, bump the vma address so that it
1714 winds up being the number of .lib sections output. This is
1715 right for SVR3.2. Shared libraries should probably get more
1716 generic support. Ian Taylor <ian@cygnus.com>. */
1717 if (strcmp (section
->name
, _LIB
) == 0)
1721 /* Don't write out bss sections - one way to do this is to
1722 see if the filepos has not been set. */
1723 if (section
->filepos
== 0)
1726 bfd_seek(abfd
, (file_ptr
) (section
->filepos
+ offset
), SEEK_SET
);
1729 return (bfd_write(location
, 1, count
, abfd
) == count
) ? true : false;
1735 coff_close_and_cleanup(abfd
)
1738 if (!bfd_read_p(abfd
))
1739 switch (abfd
->format
) {
1741 if (!_bfd_write_archive_contents(abfd
))
1745 if (!coff_write_object_contents(abfd
))
1749 bfd_error
= invalid_operation
;
1753 /* We depend on bfd_close to free all the memory on the obstack. */
1754 /* FIXME if bfd_release is not using obstacks! */
1761 buy_and_read(abfd
, where
, seek_direction
, size
)
1767 PTR area
= (PTR
) bfd_alloc(abfd
, size
);
1769 bfd_error
= no_memory
;
1772 bfd_seek(abfd
, where
, seek_direction
);
1773 if (bfd_read(area
, 1, size
, abfd
) != size
) {
1774 bfd_error
= system_call_error
;
1778 } /* buy_and_read() */
1784 Creating the linenumber table is done by reading in the entire
1785 coff linenumber table, and creating another table for internal use.
1787 A coff line number table is structured so that each function
1788 is marked as having a line number of 0. Each line within the
1789 function is an offset from the first line in the function. The
1790 base of the line number information for the table is stored in
1791 the symbol associated with the function.
1793 The information is copied from the external to the internal
1794 table, and each symbol which marks a function is marked by
1797 How does this work ?
1802 coff_slurp_line_table(abfd
, asect
)
1806 LINENO
*native_lineno
;
1807 alent
*lineno_cache
;
1809 BFD_ASSERT(asect
->lineno
== (alent
*) NULL
);
1811 native_lineno
= (LINENO
*) buy_and_read(abfd
,
1812 asect
->line_filepos
,
1815 asect
->lineno_count
));
1817 (alent
*) bfd_alloc(abfd
, (size_t) ((asect
->lineno_count
+ 1) * sizeof(alent
)));
1818 if (lineno_cache
== NULL
) {
1819 bfd_error
= no_memory
;
1822 unsigned int counter
= 0;
1823 alent
*cache_ptr
= lineno_cache
;
1824 LINENO
*src
= native_lineno
;
1826 while (counter
< asect
->lineno_count
) {
1827 struct internal_lineno dst
;
1828 coff_swap_lineno_in(abfd
, src
, &dst
);
1829 cache_ptr
->line_number
= dst
.l_lnno
;
1831 if (cache_ptr
->line_number
== 0) {
1832 coff_symbol_type
*sym
=
1833 (coff_symbol_type
*) (dst
.l_addr
.l_symndx
1834 + obj_raw_syments(abfd
))->u
.syment
._n
._n_n
._n_zeroes
;
1835 cache_ptr
->u
.sym
= (asymbol
*) sym
;
1836 sym
->lineno
= cache_ptr
;
1839 cache_ptr
->u
.offset
= dst
.l_addr
.l_paddr
1840 - bfd_section_vma(abfd
, asect
);
1841 } /* If no linenumber expect a symbol index */
1847 cache_ptr
->line_number
= 0;
1850 asect
->lineno
= lineno_cache
;
1851 /* FIXME, free native_lineno here, or use alloca or something. */
1853 } /* coff_slurp_line_table() */
1856 DEFUN(coff_slurp_symbol_table
,(abfd
),
1859 combined_entry_type
*native_symbols
;
1860 coff_symbol_type
*cached_area
;
1861 unsigned int *table_ptr
;
1863 unsigned int number_of_symbols
= 0;
1864 if (obj_symbols(abfd
))
1866 bfd_seek(abfd
, obj_sym_filepos(abfd
), SEEK_SET
);
1868 /* Read in the symbol table */
1869 if ((native_symbols
= coff_get_normalized_symtab(abfd
)) == NULL
) {
1873 /* Allocate enough room for all the symbols in cached form */
1875 (coff_symbol_type
*)
1876 bfd_alloc(abfd
, (size_t) (bfd_get_symcount(abfd
) * sizeof(coff_symbol_type
)));
1878 if (cached_area
== NULL
) {
1879 bfd_error
= no_memory
;
1884 bfd_alloc(abfd
, (size_t) (bfd_get_symcount(abfd
) * sizeof(unsigned int)));
1886 if (table_ptr
== NULL
) {
1887 bfd_error
= no_memory
;
1892 coff_symbol_type
*dst
= cached_area
;
1893 unsigned int last_native_index
= bfd_get_symcount(abfd
);
1894 unsigned int this_index
= 0;
1895 while (this_index
< last_native_index
) {
1896 combined_entry_type
*src
= native_symbols
+ this_index
;
1897 table_ptr
[this_index
] = number_of_symbols
;
1898 dst
->symbol
.the_bfd
= abfd
;
1900 dst
->symbol
.name
= (char *)(src
->u
.syment
._n
._n_n
._n_offset
);
1902 We use the native name field to point to the cached field
1904 src
->u
.syment
._n
._n_n
._n_zeroes
= (long) dst
;
1905 dst
->symbol
.section
= coff_section_from_bfd_index(abfd
,
1906 src
->u
.syment
.n_scnum
);
1907 dst
->symbol
.flags
= 0;
1908 dst
->done_lineno
= false;
1910 switch (src
->u
.syment
.n_sclass
) {
1914 dst
->symbol
.value
= src
->u
.syment
.n_value
- dst
->symbol
.section
->vma
;
1915 dst
->symbol
.flags
= BSF_EXPORT
| BSF_GLOBAL
;
1916 dst
->symbol
.flags
|= BSF_NOT_AT_END
;
1918 /* Fall through to next case */
1926 if ((src
->u
.syment
.n_scnum
) == 0) {
1927 if ((src
->u
.syment
.n_value
) == 0) {
1928 dst
->symbol
.section
= &bfd_und_section
;
1929 dst
->symbol
.value
= 0;
1932 dst
->symbol
.section
= &bfd_com_section
;
1933 dst
->symbol
.value
= (src
->u
.syment
.n_value
);
1938 Base the value as an index from the base of the
1942 dst
->symbol
.flags
= BSF_EXPORT
| BSF_GLOBAL
;
1943 dst
->symbol
.value
= src
->u
.syment
.n_value
- dst
->symbol
.section
->vma
;
1945 if (ISFCN((src
->u
.syment
.n_type
))) {
1947 A function ext does not go at the end of a file
1949 dst
->symbol
.flags
|= BSF_NOT_AT_END
;
1956 case C_STAT
: /* static */
1958 case C_LEAFSTAT
: /* static leaf procedure */
1960 case C_LABEL
: /* label */
1961 if (src
->u
.syment
.n_scnum
== -2)
1962 dst
->symbol
.flags
= BSF_DEBUGGING
;
1964 dst
->symbol
.flags
= BSF_LOCAL
;
1966 Base the value as an index from the base of the section, if
1969 if (dst
->symbol
.section
)
1970 dst
->symbol
.value
= (src
->u
.syment
.n_value
) -
1971 dst
->symbol
.section
->vma
;
1973 dst
->symbol
.value
= (src
->u
.syment
.n_value
) ;
1976 case C_MOS
: /* member of structure */
1977 case C_EOS
: /* end of structure */
1978 #ifdef NOTDEF /* C_AUTOARG has the same value */
1980 case C_GLBLREG
: /* A29k-specific storage class */
1983 case C_REGPARM
: /* register parameter */
1984 case C_REG
: /* register variable */
1986 case C_AUTOARG
: /* 960-specific storage class */
1988 case C_TPDEF
: /* type definition */
1990 case C_AUTO
: /* automatic variable */
1991 case C_FIELD
: /* bit field */
1992 case C_ENTAG
: /* enumeration tag */
1993 case C_MOE
: /* member of enumeration */
1994 case C_MOU
: /* member of union */
1995 case C_UNTAG
: /* union tag */
1996 dst
->symbol
.flags
= BSF_DEBUGGING
;
1997 dst
->symbol
.value
= (src
->u
.syment
.n_value
);
2000 case C_FILE
: /* file name */
2001 case C_STRTAG
: /* structure tag */
2003 case C_BINCL
: /* beginning of include file */
2004 case C_EINCL
: /* ending of include file */
2017 dst
->symbol
.flags
= BSF_DEBUGGING
;
2018 dst
->symbol
.value
= (src
->u
.syment
.n_value
);
2021 case C_BLOCK
: /* ".bb" or ".eb" */
2022 case C_FCN
: /* ".bf" or ".ef" */
2023 case C_EFCN
: /* physical end of function */
2024 dst
->symbol
.flags
= BSF_LOCAL
;
2026 Base the value as an index from the base of the section
2028 dst
->symbol
.value
= (src
->u
.syment
.n_value
) - dst
->symbol
.section
->vma
;
2032 case C_EXTDEF
: /* external definition */
2033 case C_ULABEL
: /* undefined label */
2034 case C_USTATIC
: /* undefined static */
2035 case C_LINE
: /* line # reformatted as symbol table entry */
2036 case C_ALIAS
: /* duplicate tag */
2037 case C_HIDDEN
: /* ext symbol in dmert public lib */
2040 fprintf(stderr
,"Unrecognized storage class %d\n",
2041 src
->u
.syment
.n_sclass
);
2043 dst
->symbol
.flags
= BSF_DEBUGGING
;
2044 dst
->symbol
.value
= (src
->u
.syment
.n_value
);
2048 /* BFD_ASSERT(dst->symbol.flags != 0);*/
2052 dst
->symbol
.udata
= 0;
2053 dst
->lineno
= (alent
*) NULL
;
2054 this_index
+= (src
->u
.syment
.n_numaux
) + 1;
2056 number_of_symbols
++;
2057 } /* walk the native symtab */
2058 } /* bfdize the native symtab */
2060 obj_symbols(abfd
) = cached_area
;
2061 obj_raw_syments(abfd
) = native_symbols
;
2063 obj_conv_table_size (abfd
) = bfd_get_symcount (abfd
);
2064 bfd_get_symcount(abfd
) = number_of_symbols
;
2065 obj_convert(abfd
) = table_ptr
;
2066 /* Slurp the line tables for each section too */
2071 coff_slurp_line_table(abfd
, p
);
2076 } /* coff_slurp_symbol_table() */
2082 Coff relocations are easily transformed into the internal BFD form
2085 Reading a coff relocation table is done in the following stages:
2087 o The entire coff relocation table is read into memory.
2089 o Each relocation is processed in turn, first it is swapped from the
2090 external to the internal form.
2092 o The symbol referenced in the relocation's symbol index is
2093 turned intoa pointer into the canonical symbol table. Note
2094 that this table is the same as the one returned by a call to
2095 @code{bfd_canonicalize_symtab}. The back end will call the
2096 routine and save the result if a canonicalization hasn't been done.
2098 o The reloc index is turned into a pointer to a howto
2099 structure, in a back end specific way. For instance, the 386
2100 and 960 use the @code{r_type} to directly produce an index
2101 into a howto table vector; the 88k subtracts a number from the
2102 @code{r_type} field and creates an addend field.
2108 #define CALC_ADDEND(abfd, ptr, reloc, cache_ptr) \
2109 if (ptr && bfd_asymbol_bfd(ptr) == abfd \
2110 && !bfd_is_com_section(ptr->section) \
2111 && !(ptr->flags & BSF_OLD_COMMON)) \
2113 cache_ptr->addend = -(ptr->section->vma + ptr->value); \
2116 cache_ptr->addend = 0; \
2121 DEFUN(coff_slurp_reloc_table
,(abfd
, asect
, symbols
),
2126 RELOC
*native_relocs
;
2127 arelent
*reloc_cache
;
2132 if (asect
->relocation
)
2134 if (asect
->reloc_count
== 0)
2136 if (asect
->flags
& SEC_CONSTRUCTOR
)
2138 if (!coff_slurp_symbol_table(abfd
))
2141 (RELOC
*) buy_and_read(abfd
,
2145 asect
->reloc_count
));
2146 reloc_cache
= (arelent
*)
2147 bfd_alloc(abfd
, (size_t) (asect
->reloc_count
* sizeof(arelent
)));
2149 if (reloc_cache
== NULL
) {
2150 bfd_error
= no_memory
;
2155 for (idx
= 0; idx
< asect
->reloc_count
; idx
++)
2157 #ifdef RELOC_PROCESSING
2158 struct internal_reloc dst
;
2159 struct external_reloc
*src
;
2161 cache_ptr
= reloc_cache
+ idx
;
2162 src
= native_relocs
+ idx
;
2163 bfd_swap_reloc_in(abfd
, src
, &dst
);
2165 RELOC_PROCESSING(cache_ptr
, &dst
, symbols
, abfd
, asect
);
2167 struct internal_reloc dst
;
2169 struct external_reloc
*src
;
2171 cache_ptr
= reloc_cache
+ idx
;
2172 src
= native_relocs
+ idx
;
2174 bfd_swap_reloc_in(abfd
, src
, &dst
);
2177 cache_ptr
->address
= dst
.r_vaddr
;
2179 if (dst
.r_symndx
!= -1)
2181 /* @@ Should never be greater than count of symbols! */
2182 if (dst
.r_symndx
>= obj_conv_table_size (abfd
))
2184 cache_ptr
->sym_ptr_ptr
= symbols
+ obj_convert(abfd
)[dst
.r_symndx
];
2185 ptr
= *(cache_ptr
->sym_ptr_ptr
);
2189 cache_ptr
->sym_ptr_ptr
= bfd_abs_section
.symbol_ptr_ptr
;
2194 The symbols definitions that we have read in have been
2195 relocated as if their sections started at 0. But the offsets
2196 refering to the symbols in the raw data have not been
2197 modified, so we have to have a negative addend to compensate.
2199 Note that symbols which used to be common must be left alone */
2201 /* Calculate any reloc addend by looking at the symbol */
2202 CALC_ADDEND(abfd
, ptr
, dst
, cache_ptr
);
2204 cache_ptr
->address
-= asect
->vma
;
2205 /* !! cache_ptr->section = (asection *) NULL;*/
2207 /* Fill in the cache_ptr->howto field from dst.r_type */
2208 RTYPE2HOWTO(cache_ptr
, &dst
);
2213 asect
->relocation
= reloc_cache
;
2218 /* This is stupid. This function should be a boolean predicate */
2220 DEFUN(coff_canonicalize_reloc
, (abfd
, section
, relptr
, symbols
),
2223 arelent
**relptr AND
2226 arelent
*tblptr
= section
->relocation
;
2227 unsigned int count
= 0;
2230 if (section
->flags
& SEC_CONSTRUCTOR
)
2232 /* this section has relocs made up by us, they are not in the
2233 file, so take them out of their chain and place them into
2234 the data area provided */
2235 arelent_chain
*chain
= section
->constructor_chain
;
2236 for (count
= 0; count
< section
->reloc_count
; count
++)
2238 *relptr
++ = &chain
->relent
;
2239 chain
= chain
->next
;
2245 coff_slurp_reloc_table(abfd
, section
, symbols
);
2248 tblptr
= section
->relocation
;
2252 for (; count
++ < section
->reloc_count
;)
2253 *relptr
++ = tblptr
++;
2258 return section
->reloc_count
;
2263 coff_sym_filepos(abfd
)
2266 return obj_sym_filepos(abfd
);
2270 #ifndef coff_reloc16_estimate
2271 #define coff_reloc16_estimate dummy_reloc16_estimate
2273 static dummy_reloc16_estimate(input_section
, symbols
, reloc
, shrink
)
2274 asection
*input_section
;
2285 #ifndef coff_reloc16_extra_cases
2286 #define coff_reloc16_extra_cases dummy_reloc16_extra_cases
2287 /* This works even if abort is not declared in any header file. */
2289 dummy_reloc16_extra_cases (abfd
, seclet
, reloc
, data
, src_ptr
, dst_ptr
)
2291 struct bfd_seclet
*seclet
;
2294 unsigned int *src_ptr
;
2295 unsigned int *dst_ptr
;
2297 fprintf(stderr
, "%s\n", reloc
->howto
->name
);
2302 static CONST bfd_coff_backend_data bfd_coff_std_swap_table
= {
2303 coff_swap_aux_in
, coff_swap_sym_in
, coff_swap_lineno_in
,
2304 coff_swap_aux_out
, coff_swap_sym_out
,
2305 coff_swap_lineno_out
, coff_swap_reloc_out
,
2306 coff_swap_filehdr_out
, coff_swap_aouthdr_out
,
2307 coff_swap_scnhdr_out
,
2308 FILHSZ
, AOUTSZ
, SCNHSZ
, SYMESZ
, AUXESZ
, LINESZ
,
2309 #ifdef COFF_LONG_FILENAMES
2314 coff_swap_filehdr_in
, coff_swap_aouthdr_in
, coff_swap_scnhdr_in
,
2315 coff_bad_format_hook
, coff_set_arch_mach_hook
, coff_mkobject_hook
,
2316 styp_to_sec_flags
, coff_make_section_hook
, coff_set_alignment_hook
,
2317 coff_slurp_symbol_table
, symname_in_debug_hook
,
2318 coff_reloc16_extra_cases
, coff_reloc16_estimate
2321 #define coff_core_file_failing_command _bfd_dummy_core_file_failing_command
2322 #define coff_core_file_failing_signal _bfd_dummy_core_file_failing_signal
2323 #define coff_core_file_matches_executable_p _bfd_dummy_core_file_matches_executable_p
2324 #define coff_slurp_armap bfd_slurp_coff_armap
2325 #define coff_slurp_extended_name_table _bfd_slurp_extended_name_table
2326 #define coff_truncate_arname bfd_dont_truncate_arname
2327 #define coff_openr_next_archived_file bfd_generic_openr_next_archived_file
2328 #define coff_generic_stat_arch_elt bfd_generic_stat_arch_elt
2329 #define coff_get_section_contents bfd_generic_get_section_contents
2330 #define coff_close_and_cleanup bfd_generic_close_and_cleanup
2332 #define coff_bfd_debug_info_start bfd_void
2333 #define coff_bfd_debug_info_end bfd_void
2334 #define coff_bfd_debug_info_accumulate \
2335 (void (*) PARAMS ((bfd *, struct sec *))) bfd_void
2336 #define coff_bfd_get_relocated_section_contents bfd_generic_get_relocated_section_contents
2337 #define coff_bfd_relax_section bfd_generic_relax_section
2338 #define coff_bfd_seclet_link bfd_generic_seclet_link
2339 #define coff_bfd_reloc_type_lookup \
2340 ((CONST struct reloc_howto_struct *(*) PARAMS ((bfd *, bfd_reloc_code_real_type))) bfd_nullvoidptr)