bfd/libcoff.h

   1 /* BFD COFF object file private structure.
   2    Copyright (C) 1990, 1991, 1992, 1993 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 unsigned int coff_get_symtab_upper_bound PARAMS ((bfd *));
  81 extern unsigned int 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 void coff_renumber_symbols PARAMS ((bfd *));
  85 extern void coff_mangle_symbols PARAMS ((bfd *));
  86 extern void coff_write_symbols PARAMS ((bfd *));
  87 extern void 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 unsigned int 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 PARAMS ((bfd *,
 108                                                        asection *,
 109                                                        struct bfd_link_info *,
 110                                                        asymbol **));
 111 extern bfd_byte *bfd_coff_reloc16_get_relocated_section_contents
 112   PARAMS ((bfd *, struct bfd_link_info *, struct bfd_link_order *,
 113            bfd_byte *, boolean relocateable, asymbol **));
 114 extern bfd_vma bfd_coff_reloc16_get_value PARAMS ((arelent *,
 115                                                    struct bfd_link_info *,
 116                                                    asection *));
 117 extern void bfd_perform_slip PARAMS ((asymbol **s, unsigned int slip,
 118                                       asection *input_section,
 119                                       bfd_vma value));
 120
 121 /* And more taken from the source .. */
 122
 123 typedef struct coff_ptr_struct
 124 {
 125
 126         /* Remembers the offset from the first symbol in the file for
 127           this symbol. Generated by coff_renumber_symbols. */
 128 unsigned int offset;
 129
 130         /* Should the tag field of this symbol be renumbered.
 131           Created by coff_pointerize_aux. */
 132 char fix_tag;
 133
 134         /* Should the endidx field of this symbol be renumbered.
 135           Created by coff_pointerize_aux. */
 136 char fix_end;
 137
 138         /* The container for the symbol structure as read and translated
 139            from the file. */
 140
 141 union {
 142    union internal_auxent auxent;
 143    struct internal_syment syment;
 144  } u;
 145 } combined_entry_type;
 146
 147
 148  /* Each canonical asymbol really looks like this: */
 149
 150 typedef struct coff_symbol_struct
 151 {
 152     /* The actual symbol which the rest of BFD works with */
 153 asymbol symbol;
 154
 155     /* A pointer to the hidden information for this symbol */
 156 combined_entry_type *native;
 157
 158     /* A pointer to the linenumber information for this symbol */
 159 struct lineno_cache_entry *lineno;
 160
 161     /* Have the line numbers been relocated yet ? */
 162 boolean done_lineno;
 163 } coff_symbol_type;
 164 typedef struct
 165 {
 166   void (*_bfd_coff_swap_aux_in) PARAMS ((
 167        bfd            *abfd,
 168        PTR             ext,
 169        int             type,
 170        int             class,
 171        int             indaux,
 172        int             numaux,
 173        PTR             in));
 174
 175   void (*_bfd_coff_swap_sym_in) PARAMS ((
 176        bfd            *abfd ,
 177        PTR             ext,
 178        PTR             in));
 179
 180   void (*_bfd_coff_swap_lineno_in) PARAMS ((
 181        bfd            *abfd,
 182        PTR            ext,
 183        PTR             in));
 184
 185  unsigned int (*_bfd_coff_swap_aux_out) PARAMS ((
 186        bfd      *abfd,
 187        PTR      in,
 188        int      type,
 189        int      class,
 190        int     indaux,
 191        int     numaux,
 192        PTR      ext));
 193
 194  unsigned int (*_bfd_coff_swap_sym_out) PARAMS ((
 195       bfd      *abfd,
 196       PTR       in,
 197       PTR       ext));
 198
 199  unsigned int (*_bfd_coff_swap_lineno_out) PARAMS ((
 200         bfd     *abfd,
 201         PTR     in,
 202         PTR     ext));
 203
 204  unsigned int (*_bfd_coff_swap_reloc_out) PARAMS ((
 205         bfd     *abfd,
 206         PTR     src,
 207         PTR     dst));
 208
 209  unsigned int (*_bfd_coff_swap_filehdr_out) PARAMS ((
 210         bfd     *abfd,
 211         PTR     in,
 212         PTR     out));
 213
 214  unsigned int (*_bfd_coff_swap_aouthdr_out) PARAMS ((
 215         bfd     *abfd,
 216         PTR     in,
 217         PTR     out));
 218
 219  unsigned int (*_bfd_coff_swap_scnhdr_out) PARAMS ((
 220         bfd     *abfd,
 221         PTR     in,
 222         PTR     out));
 223
 224  unsigned int _bfd_filhsz;
 225  unsigned int _bfd_aoutsz;
 226  unsigned int _bfd_scnhsz;
 227  unsigned int _bfd_symesz;
 228  unsigned int _bfd_auxesz;
 229  unsigned int _bfd_linesz;
 230  boolean _bfd_coff_long_filenames;
 231  void (*_bfd_coff_swap_filehdr_in) PARAMS ((
 232        bfd     *abfd,
 233        PTR     ext,
 234        PTR     in));
 235  void (*_bfd_coff_swap_aouthdr_in) PARAMS ((
 236        bfd     *abfd,
 237        PTR     ext,
 238        PTR     in));
 239  void (*_bfd_coff_swap_scnhdr_in) PARAMS ((
 240        bfd     *abfd,
 241        PTR     ext,
 242        PTR     in));
 243  boolean (*_bfd_coff_bad_format_hook) PARAMS ((
 244        bfd     *abfd,
 245        PTR     internal_filehdr));
 246  boolean (*_bfd_coff_set_arch_mach_hook) PARAMS ((
 247        bfd     *abfd,
 248        PTR     internal_filehdr));
 249  PTR (*_bfd_coff_mkobject_hook) PARAMS ((
 250        bfd     *abfd,
 251        PTR     internal_filehdr,
 252        PTR     internal_aouthdr));
 253  flagword (*_bfd_styp_to_sec_flags_hook) PARAMS ((
 254        bfd     *abfd,
 255        PTR     internal_scnhdr));
 256  asection *(*_bfd_make_section_hook) PARAMS ((
 257        bfd     *abfd,
 258        char    *name));
 259  void (*_bfd_set_alignment_hook) PARAMS ((
 260        bfd     *abfd,
 261        asection *sec,
 262        PTR     internal_scnhdr));
 263  boolean (*_bfd_coff_slurp_symbol_table) PARAMS ((
 264        bfd     *abfd));
 265  boolean (*_bfd_coff_symname_in_debug) PARAMS ((
 266        bfd     *abfd,
 267        struct internal_syment *sym));
 268  void (*_bfd_coff_reloc16_extra_cases) PARAMS ((
 269        bfd     *abfd,
 270        struct bfd_link_info *link_info,
 271        struct bfd_link_order *link_order,
 272        arelent *reloc,
 273        bfd_byte *data,
 274        unsigned int *src_ptr,
 275        unsigned int *dst_ptr));
 276  int (*_bfd_coff_reloc16_estimate) PARAMS ((
 277        asection *input_section,
 278        asymbol **symbols,
 279        arelent *r,
 280        unsigned int shrink,
 281        struct bfd_link_info *link_info));
 282
 283 } bfd_coff_backend_data;
 284
 285 #define coff_backend_info(abfd) ((bfd_coff_backend_data *) (abfd)->xvec->backend_data)
 286
 287 #define bfd_coff_swap_aux_in(a,e,t,c,ind,num,i) \
 288         ((coff_backend_info (a)->_bfd_coff_swap_aux_in) (a,e,t,c,ind,num,i))
 289
 290 #define bfd_coff_swap_sym_in(a,e,i) \
 291         ((coff_backend_info (a)->_bfd_coff_swap_sym_in) (a,e,i))
 292
 293 #define bfd_coff_swap_lineno_in(a,e,i) \
 294         ((coff_backend_info ( a)->_bfd_coff_swap_lineno_in) (a,e,i))
 295
 296 #define bfd_coff_swap_reloc_out(abfd, i, o) \
 297         ((coff_backend_info (abfd)->_bfd_coff_swap_reloc_out) (abfd, i, o))
 298
 299 #define bfd_coff_swap_lineno_out(abfd, i, o) \
 300         ((coff_backend_info (abfd)->_bfd_coff_swap_lineno_out) (abfd, i, o))
 301
 302 #define bfd_coff_swap_aux_out(a,i,t,c,ind,num,o) \
 303         ((coff_backend_info (a)->_bfd_coff_swap_aux_out) (a,i,t,c,ind,num,o))
 304
 305 #define bfd_coff_swap_sym_out(abfd, i,o) \
 306         ((coff_backend_info (abfd)->_bfd_coff_swap_sym_out) (abfd, i, o))
 307
 308 #define bfd_coff_swap_scnhdr_out(abfd, i,o) \
 309         ((coff_backend_info (abfd)->_bfd_coff_swap_scnhdr_out) (abfd, i, o))
 310
 311 #define bfd_coff_swap_filehdr_out(abfd, i,o) \
 312         ((coff_backend_info (abfd)->_bfd_coff_swap_filehdr_out) (abfd, i, o))
 313
 314 #define bfd_coff_swap_aouthdr_out(abfd, i,o) \
 315         ((coff_backend_info (abfd)->_bfd_coff_swap_aouthdr_out) (abfd, i, o))
 316
 317 #define bfd_coff_filhsz(abfd) (coff_backend_info (abfd)->_bfd_filhsz)
 318 #define bfd_coff_aoutsz(abfd) (coff_backend_info (abfd)->_bfd_aoutsz)
 319 #define bfd_coff_scnhsz(abfd) (coff_backend_info (abfd)->_bfd_scnhsz)
 320 #define bfd_coff_symesz(abfd) (coff_backend_info (abfd)->_bfd_symesz)
 321 #define bfd_coff_auxesz(abfd) (coff_backend_info (abfd)->_bfd_auxesz)
 322 #define bfd_coff_linesz(abfd) (coff_backend_info (abfd)->_bfd_linesz)
 323 #define bfd_coff_long_filenames(abfd) (coff_backend_info (abfd)->_bfd_coff_long_filenames)
 324 #define bfd_coff_swap_filehdr_in(abfd, i,o) \
 325         ((coff_backend_info (abfd)->_bfd_coff_swap_filehdr_in) (abfd, i, o))
 326
 327 #define bfd_coff_swap_aouthdr_in(abfd, i,o) \
 328         ((coff_backend_info (abfd)->_bfd_coff_swap_aouthdr_in) (abfd, i, o))
 329
 330 #define bfd_coff_swap_scnhdr_in(abfd, i,o) \
 331         ((coff_backend_info (abfd)->_bfd_coff_swap_scnhdr_in) (abfd, i, o))
 332
 333 #define bfd_coff_bad_format_hook(abfd, filehdr) \
 334         ((coff_backend_info (abfd)->_bfd_coff_bad_format_hook) (abfd, filehdr))
 335
 336 #define bfd_coff_set_arch_mach_hook(abfd, filehdr)\
 337         ((coff_backend_info (abfd)->_bfd_coff_set_arch_mach_hook) (abfd, filehdr))
 338 #define bfd_coff_mkobject_hook(abfd, filehdr, aouthdr)\
 339         ((coff_backend_info (abfd)->_bfd_coff_mkobject_hook) (abfd, filehdr, aouthdr))
 340
 341 #define bfd_coff_styp_to_sec_flags_hook(abfd, scnhdr)\
 342         ((coff_backend_info (abfd)->_bfd_styp_to_sec_flags_hook) (abfd, scnhdr))
 343
 344 #define bfd_coff_make_section_hook(abfd, name)\
 345         ((coff_backend_info (abfd)->_bfd_make_section_hook) (abfd, name))
 346
 347 #define bfd_coff_set_alignment_hook(abfd, sec, scnhdr)\
 348         ((coff_backend_info (abfd)->_bfd_set_alignment_hook) (abfd, sec, scnhdr))
 349
 350 #define bfd_coff_slurp_symbol_table(abfd)\
 351         ((coff_backend_info (abfd)->_bfd_coff_slurp_symbol_table) (abfd))
 352
 353 #define bfd_coff_symname_in_debug(abfd, sym)\
 354         ((coff_backend_info (abfd)->_bfd_coff_symname_in_debug) (abfd, sym))
 355
 356 #define bfd_coff_reloc16_extra_cases(abfd, link_info, link_order, reloc, data, src_ptr, dst_ptr)\
 357         ((coff_backend_info (abfd)->_bfd_coff_reloc16_extra_cases)\
 358          (abfd, link_info, link_order, reloc, data, src_ptr, dst_ptr))
 359
 360 #define bfd_coff_reloc16_estimate(abfd, section, symbols, reloc, shrink, link_info)\
 361         ((coff_backend_info (abfd)->_bfd_coff_reloc16_estimate)\
 362          (section, symbols, reloc, shrink, link_info))
 363