bfd/libcoff.h

   1 /* BFD COFF object file private structure.
   2    Copyright (C) 1990, 1991, 1992, 1993, 1994 Free Software Foundation, Inc.
   3    Written by Cygnus Support.
   4
   5 This file is part of BFD, the Binary File Descriptor library.
   6
   7 This program is free software; you can redistribute it and/or modify
   8 it under the terms of the GNU General Public License as published by
   9 the Free Software Foundation; either version 2 of the License, or
  10 (at your option) any later version.
  11
  12 This program is distributed in the hope that it will be useful,
  13 but WITHOUT ANY WARRANTY; without even the implied warranty of
  14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15 GNU General Public License for more details.
  16
  17 You should have received a copy of the GNU General Public License
  18 along with this program; if not, write to the Free Software
  19 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.  */
  20
  21
  22 /* Object file tdata; access macros */
  23
  24 #define coff_data(bfd)          ((bfd)->tdata.coff_obj_data)
  25 #define exec_hdr(bfd)           (coff_data(bfd)->hdr)
  26 #define obj_symbols(bfd)        (coff_data(bfd)->symbols)
  27 #define obj_sym_filepos(bfd)    (coff_data(bfd)->sym_filepos)
  28
  29 #define obj_relocbase(bfd)      (coff_data(bfd)->relocbase)
  30 #define obj_raw_syments(bfd)    (coff_data(bfd)->raw_syments)
  31 #define obj_raw_syment_count(bfd)       (coff_data(bfd)->raw_syment_count)
  32 #define obj_convert(bfd)        (coff_data(bfd)->conversion_table)
  33 #define obj_conv_table_size(bfd) (coff_data(bfd)->conv_table_size)
  34 #if CFILE_STUFF
  35 #define obj_symbol_slew(bfd)    (coff_data(bfd)->symbol_index_slew)
  36 #else
  37 #define obj_symbol_slew(bfd) 0
  38 #endif
  39
  40
  41 /* `Tdata' information kept for COFF files.  */
  42
  43 typedef struct coff_tdata
  44 {
  45   struct   coff_symbol_struct *symbols; /* symtab for input bfd */
  46   unsigned int *conversion_table;
  47   int conv_table_size;
  48   file_ptr sym_filepos;
  49
  50   long symbol_index_slew;       /* used during read to mark whether a
  51                                    C_FILE symbol as been added. */
  52
  53   struct coff_ptr_struct *raw_syments;
  54   struct lineno *raw_linenos;
  55   unsigned int raw_syment_count;
  56   unsigned short flags;
  57
  58   /* These are only valid once writing has begun */
  59   long int relocbase;
  60
  61   /* These members communicate important constants about the symbol table
  62      to GDB's symbol-reading code.  These `constants' unfortunately vary
  63      from coff implementation to implementation...  */
  64   unsigned local_n_btmask;
  65   unsigned local_n_btshft;
  66   unsigned local_n_tmask;
  67   unsigned local_n_tshift;
  68   unsigned local_symesz;
  69   unsigned local_auxesz;
  70   unsigned local_linesz;
  71 } coff_data_type;
  72
  73 /* We take the address of the first element of a asymbol to ensure that the
  74  * macro is only ever applied to an asymbol.  */
  75 #define coffsymbol(asymbol) ((coff_symbol_type *)(&((asymbol)->the_bfd)))
  76
  77 /* Functions in coffgen.c.  */
  78 extern bfd_target *coff_object_p PARAMS ((bfd *));
  79 extern struct sec *coff_section_from_bfd_index PARAMS ((bfd *, int));
  80 extern long coff_get_symtab_upper_bound PARAMS ((bfd *));
  81 extern long coff_get_symtab PARAMS ((bfd *, asymbol **));
  82 extern int coff_count_linenumbers PARAMS ((bfd *));
  83 extern struct coff_symbol_struct *coff_symbol_from PARAMS ((bfd *, asymbol *));
  84 extern boolean coff_renumber_symbols PARAMS ((bfd *));
  85 extern void coff_mangle_symbols PARAMS ((bfd *));
  86 extern void coff_write_symbols PARAMS ((bfd *));
  87 extern boolean coff_write_linenumbers PARAMS ((bfd *));
  88 extern alent *coff_get_lineno PARAMS ((bfd *, asymbol *));
  89 extern asymbol *coff_section_symbol PARAMS ((bfd *, char *));
  90 extern struct coff_ptr_struct *coff_get_normalized_symtab PARAMS ((bfd *));
  91 extern long coff_get_reloc_upper_bound PARAMS ((bfd *, sec_ptr));
  92 extern asymbol *coff_make_empty_symbol PARAMS ((bfd *));
  93 extern void coff_print_symbol PARAMS ((bfd *, PTR filep, asymbol *,
  94                                        bfd_print_symbol_type how));
  95 extern void coff_get_symbol_info PARAMS ((bfd *, asymbol *,
  96                                           symbol_info *ret));
  97 extern asymbol *coff_bfd_make_debug_symbol PARAMS ((bfd *, PTR,
  98                                                     unsigned long));
  99 extern boolean coff_find_nearest_line PARAMS ((bfd *,
 100                                                asection *,
 101                                                asymbol **,
 102                                                bfd_vma offset,
 103                                                CONST char **filename_ptr,
 104                                                CONST char **functionname_ptr,
 105                                                unsigned int *line_ptr));
 106 extern int coff_sizeof_headers PARAMS ((bfd *, boolean reloc));
 107 extern boolean bfd_coff_reloc16_relax_section
 108   PARAMS ((bfd *, asection *, struct bfd_link_info *, boolean *));
 109 extern bfd_byte *bfd_coff_reloc16_get_relocated_section_contents
 110   PARAMS ((bfd *, struct bfd_link_info *, struct bfd_link_order *,
 111            bfd_byte *, boolean relocateable, asymbol **));
 112 extern bfd_vma bfd_coff_reloc16_get_value PARAMS ((arelent *,
 113                                                    struct bfd_link_info *,
 114                                                    asection *));
 115 extern void bfd_perform_slip PARAMS ((bfd *abfd, unsigned int slip,
 116                                       asection *input_section,
 117                                       bfd_vma val));
 118
 119 /* And more taken from the source .. */
 120
 121 typedef struct coff_ptr_struct
 122 {
 123
 124         /* Remembers the offset from the first symbol in the file for
 125           this symbol. Generated by coff_renumber_symbols. */
 126 unsigned int offset;
 127
 128         /* Should the value of this symbol be renumbered.  Used for
 129           XCOFF C_BSTAT symbols.  Set by coff_slurp_symbol_table.  */
 130 unsigned int fix_value : 1;
 131
 132         /* Should the tag field of this symbol be renumbered.
 133           Created by coff_pointerize_aux. */
 134 unsigned int fix_tag : 1;
 135
 136         /* Should the endidx field of this symbol be renumbered.
 137           Created by coff_pointerize_aux. */
 138 unsigned int fix_end : 1;
 139
 140         /* Should the x_csect.x_scnlen field be renumbered.
 141           Created by coff_slurp_symbol_table. */
 142 unsigned int fix_scnlen : 1;
 143
 144         /* The container for the symbol structure as read and translated
 145            from the file. */
 146
 147 union {
 148    union internal_auxent auxent;
 149    struct internal_syment syment;
 150  } u;
 151 } combined_entry_type;
 152
 153
 154  /* Each canonical asymbol really looks like this: */
 155
 156 typedef struct coff_symbol_struct
 157 {
 158     /* The actual symbol which the rest of BFD works with */
 159 asymbol symbol;
 160
 161     /* A pointer to the hidden information for this symbol */
 162 combined_entry_type *native;
 163
 164     /* A pointer to the linenumber information for this symbol */
 165 struct lineno_cache_entry *lineno;
 166
 167     /* Have the line numbers been relocated yet ? */
 168 boolean done_lineno;
 169 } coff_symbol_type;
 170 typedef struct
 171 {
 172   void (*_bfd_coff_swap_aux_in) PARAMS ((
 173        bfd            *abfd,
 174        PTR             ext,
 175        int             type,
 176        int             class,
 177        int             indaux,
 178        int             numaux,
 179        PTR             in));
 180
 181   void (*_bfd_coff_swap_sym_in) PARAMS ((
 182        bfd            *abfd ,
 183        PTR             ext,
 184        PTR             in));
 185
 186   void (*_bfd_coff_swap_lineno_in) PARAMS ((
 187        bfd            *abfd,
 188        PTR            ext,
 189        PTR             in));
 190
 191  unsigned int (*_bfd_coff_swap_aux_out) PARAMS ((
 192        bfd      *abfd,
 193        PTR      in,
 194        int      type,
 195        int      class,
 196        int     indaux,
 197        int     numaux,
 198        PTR      ext));
 199
 200  unsigned int (*_bfd_coff_swap_sym_out) PARAMS ((
 201       bfd      *abfd,
 202       PTR       in,
 203       PTR       ext));
 204
 205  unsigned int (*_bfd_coff_swap_lineno_out) PARAMS ((
 206         bfd     *abfd,
 207         PTR     in,
 208         PTR     ext));
 209
 210  unsigned int (*_bfd_coff_swap_reloc_out) PARAMS ((
 211         bfd     *abfd,
 212         PTR     src,
 213         PTR     dst));
 214
 215  unsigned int (*_bfd_coff_swap_filehdr_out) PARAMS ((
 216         bfd     *abfd,
 217         PTR     in,
 218         PTR     out));
 219
 220  unsigned int (*_bfd_coff_swap_aouthdr_out) PARAMS ((
 221         bfd     *abfd,
 222         PTR     in,
 223         PTR     out));
 224
 225  unsigned int (*_bfd_coff_swap_scnhdr_out) PARAMS ((
 226         bfd     *abfd,
 227         PTR     in,
 228         PTR     out));
 229
 230  unsigned int _bfd_filhsz;
 231  unsigned int _bfd_aoutsz;
 232  unsigned int _bfd_scnhsz;
 233  unsigned int _bfd_symesz;
 234  unsigned int _bfd_auxesz;
 235  unsigned int _bfd_linesz;
 236  boolean _bfd_coff_long_filenames;
 237  void (*_bfd_coff_swap_filehdr_in) PARAMS ((
 238        bfd     *abfd,
 239        PTR     ext,
 240        PTR     in));
 241  void (*_bfd_coff_swap_aouthdr_in) PARAMS ((
 242        bfd     *abfd,
 243        PTR     ext,
 244        PTR     in));
 245  void (*_bfd_coff_swap_scnhdr_in) PARAMS ((
 246        bfd     *abfd,
 247        PTR     ext,
 248        PTR     in));
 249  boolean (*_bfd_coff_bad_format_hook) PARAMS ((
 250        bfd     *abfd,
 251        PTR     internal_filehdr));
 252  boolean (*_bfd_coff_set_arch_mach_hook) PARAMS ((
 253        bfd     *abfd,
 254        PTR     internal_filehdr));
 255  PTR (*_bfd_coff_mkobject_hook) PARAMS ((
 256        bfd     *abfd,
 257        PTR     internal_filehdr,
 258        PTR     internal_aouthdr));
 259  flagword (*_bfd_styp_to_sec_flags_hook) PARAMS ((
 260        bfd     *abfd,
 261        PTR     internal_scnhdr));
 262  asection *(*_bfd_make_section_hook) PARAMS ((
 263        bfd     *abfd,
 264        char    *name));
 265  void (*_bfd_set_alignment_hook) PARAMS ((
 266        bfd     *abfd,
 267        asection *sec,
 268        PTR     internal_scnhdr));
 269  boolean (*_bfd_coff_slurp_symbol_table) PARAMS ((
 270        bfd     *abfd));
 271  boolean (*_bfd_coff_symname_in_debug) PARAMS ((
 272        bfd     *abfd,
 273        struct internal_syment *sym));
 274  void (*_bfd_coff_reloc16_extra_cases) PARAMS ((
 275        bfd     *abfd,
 276        struct bfd_link_info *link_info,
 277        struct bfd_link_order *link_order,
 278        arelent *reloc,
 279        bfd_byte *data,
 280        unsigned int *src_ptr,
 281        unsigned int *dst_ptr));
 282  int (*_bfd_coff_reloc16_estimate) PARAMS ((
 283        bfd *abfd,
 284        asection *input_section,
 285        arelent *r,
 286        unsigned int shrink,
 287        struct bfd_link_info *link_info));
 288
 289 } bfd_coff_backend_data;
 290
 291 #define coff_backend_info(abfd) ((bfd_coff_backend_data *) (abfd)->xvec->backend_data)
 292
 293 #define bfd_coff_swap_aux_in(a,e,t,c,ind,num,i) \
 294         ((coff_backend_info (a)->_bfd_coff_swap_aux_in) (a,e,t,c,ind,num,i))
 295
 296 #define bfd_coff_swap_sym_in(a,e,i) \
 297         ((coff_backend_info (a)->_bfd_coff_swap_sym_in) (a,e,i))
 298
 299 #define bfd_coff_swap_lineno_in(a,e,i) \
 300         ((coff_backend_info ( a)->_bfd_coff_swap_lineno_in) (a,e,i))
 301
 302 #define bfd_coff_swap_reloc_out(abfd, i, o) \
 303         ((coff_backend_info (abfd)->_bfd_coff_swap_reloc_out) (abfd, i, o))
 304
 305 #define bfd_coff_swap_lineno_out(abfd, i, o) \
 306         ((coff_backend_info (abfd)->_bfd_coff_swap_lineno_out) (abfd, i, o))
 307
 308 #define bfd_coff_swap_aux_out(a,i,t,c,ind,num,o) \
 309         ((coff_backend_info (a)->_bfd_coff_swap_aux_out) (a,i,t,c,ind,num,o))
 310
 311 #define bfd_coff_swap_sym_out(abfd, i,o) \
 312         ((coff_backend_info (abfd)->_bfd_coff_swap_sym_out) (abfd, i, o))
 313
 314 #define bfd_coff_swap_scnhdr_out(abfd, i,o) \
 315         ((coff_backend_info (abfd)->_bfd_coff_swap_scnhdr_out) (abfd, i, o))
 316
 317 #define bfd_coff_swap_filehdr_out(abfd, i,o) \
 318         ((coff_backend_info (abfd)->_bfd_coff_swap_filehdr_out) (abfd, i, o))
 319
 320 #define bfd_coff_swap_aouthdr_out(abfd, i,o) \
 321         ((coff_backend_info (abfd)->_bfd_coff_swap_aouthdr_out) (abfd, i, o))
 322
 323 #define bfd_coff_filhsz(abfd) (coff_backend_info (abfd)->_bfd_filhsz)
 324 #define bfd_coff_aoutsz(abfd) (coff_backend_info (abfd)->_bfd_aoutsz)
 325 #define bfd_coff_scnhsz(abfd) (coff_backend_info (abfd)->_bfd_scnhsz)
 326 #define bfd_coff_symesz(abfd) (coff_backend_info (abfd)->_bfd_symesz)
 327 #define bfd_coff_auxesz(abfd) (coff_backend_info (abfd)->_bfd_auxesz)
 328 #define bfd_coff_linesz(abfd) (coff_backend_info (abfd)->_bfd_linesz)
 329 #define bfd_coff_long_filenames(abfd) (coff_backend_info (abfd)->_bfd_coff_long_filenames)
 330 #define bfd_coff_swap_filehdr_in(abfd, i,o) \
 331         ((coff_backend_info (abfd)->_bfd_coff_swap_filehdr_in) (abfd, i, o))
 332
 333 #define bfd_coff_swap_aouthdr_in(abfd, i,o) \
 334         ((coff_backend_info (abfd)->_bfd_coff_swap_aouthdr_in) (abfd, i, o))
 335
 336 #define bfd_coff_swap_scnhdr_in(abfd, i,o) \
 337         ((coff_backend_info (abfd)->_bfd_coff_swap_scnhdr_in) (abfd, i, o))
 338
 339 #define bfd_coff_bad_format_hook(abfd, filehdr) \
 340         ((coff_backend_info (abfd)->_bfd_coff_bad_format_hook) (abfd, filehdr))
 341
 342 #define bfd_coff_set_arch_mach_hook(abfd, filehdr)\
 343         ((coff_backend_info (abfd)->_bfd_coff_set_arch_mach_hook) (abfd, filehdr))
 344 #define bfd_coff_mkobject_hook(abfd, filehdr, aouthdr)\
 345         ((coff_backend_info (abfd)->_bfd_coff_mkobject_hook) (abfd, filehdr, aouthdr))
 346
 347 #define bfd_coff_styp_to_sec_flags_hook(abfd, scnhdr)\
 348         ((coff_backend_info (abfd)->_bfd_styp_to_sec_flags_hook) (abfd, scnhdr))
 349
 350 #define bfd_coff_make_section_hook(abfd, name)\
 351         ((coff_backend_info (abfd)->_bfd_make_section_hook) (abfd, name))
 352
 353 #define bfd_coff_set_alignment_hook(abfd, sec, scnhdr)\
 354         ((coff_backend_info (abfd)->_bfd_set_alignment_hook) (abfd, sec, scnhdr))
 355
 356 #define bfd_coff_slurp_symbol_table(abfd)\
 357         ((coff_backend_info (abfd)->_bfd_coff_slurp_symbol_table) (abfd))
 358
 359 #define bfd_coff_symname_in_debug(abfd, sym)\
 360         ((coff_backend_info (abfd)->_bfd_coff_symname_in_debug) (abfd, sym))
 361
 362 #define bfd_coff_reloc16_extra_cases(abfd, link_info, link_order, reloc, data, src_ptr, dst_ptr)\
 363         ((coff_backend_info (abfd)->_bfd_coff_reloc16_extra_cases)\
 364          (abfd, link_info, link_order, reloc, data, src_ptr, dst_ptr))
 365
 366 #define bfd_coff_reloc16_estimate(abfd, section, reloc, shrink, link_info)\
 367         ((coff_backend_info (abfd)->_bfd_coff_reloc16_estimate)\
 368          (abfd, section, reloc, shrink, link_info))
 369