include/coff/internal.h

   1 /* Internal format of COFF object file data structures, for GNU BFD.
   2    This file is part of BFD, the Binary File Descriptor library.  */
   3
   4 /* First, make "signed char" work, even on old compilers. */
   5 #ifndef signed
   6 #ifndef __STDC__
   7 #define signed                  /**/
   8 #endif
   9 #endif
  10
  11 /********************** FILE HEADER **********************/
  12 struct internal_filehdr
  13 {
  14   unsigned short f_magic;       /* magic number                 */
  15   unsigned short f_nscns;       /* number of sections           */
  16   long f_timdat;                /* time & date stamp            */
  17   long f_symptr;                /* file pointer to symtab       */
  18   long f_nsyms;                 /* number of symtab entries     */
  19   unsigned short f_opthdr;      /* sizeof(optional hdr)         */
  20   unsigned short f_flags;       /* flags                        */
  21 };
  22
  23 /* Bits for f_flags:
  24  *      F_RELFLG        relocation info stripped from file
  25  *      F_EXEC          file is executable (no unresolved external references)
  26  *      F_LNNO          line numbers stripped from file
  27  *      F_LSYMS         local symbols stripped from file
  28  *      F_AR16WR        file is 16-bit little-endian
  29  *      F_AR32WR        file is 32-bit little-endian
  30  *      F_AR32W         file is 32-bit big-endian
  31  *      F_DYNLOAD       rs/6000 aix: dynamically loadable w/imports & exports
  32  *      F_SHROBJ        rs/6000 aix: file is a shared object
  33  */
  34
  35 #define F_RELFLG        (0x0001)
  36 #define F_EXEC          (0x0002)
  37 #define F_LNNO          (0x0004)
  38 #define F_LSYMS         (0x0008)
  39 #define F_AR16WR        (0x0080)
  40 #define F_AR32WR        (0x0100)
  41 #define F_AR32W         (0x0200)
  42 #define F_DYNLOAD       (0x1000)
  43 #define F_SHROBJ        (0x2000)
  44
  45 /********************** AOUT "OPTIONAL HEADER" **********************/
  46 struct internal_aouthdr
  47 {
  48   short magic;                  /* type of file                         */
  49   short vstamp;                 /* version stamp                        */
  50   unsigned long tsize;          /* text size in bytes, padded to FW bdry*/
  51   unsigned long dsize;          /* initialized data "  "                */
  52   unsigned long bsize;          /* uninitialized data "   "             */
  53   unsigned long entry;          /* entry pt.                            */
  54   unsigned long text_start;     /* base of text used for this file */
  55   unsigned long data_start;     /* base of data used for this file */
  56
  57   /* i960 stuff */
  58   unsigned long tagentries;     /* number of tag entries to follow */
  59
  60   /* RS/6000 stuff */
  61   unsigned long o_toc;          /* address of TOC                       */
  62   short o_snentry;              /* section number for entry point */
  63   short o_sntext;               /* section number for text      */
  64   short o_sndata;               /* section number for data      */
  65   short o_sntoc;                /* section number for toc       */
  66   short o_snloader;             /* section number for loader section */
  67   short o_snbss;                /* section number for bss       */
  68   short o_algntext;             /* max alignment for text       */
  69   short o_algndata;             /* max alignment for data       */
  70   short o_modtype;              /* Module type field, 1R,RE,RO  */
  71   unsigned long o_maxstack;     /* max stack size allowed.      */
  72
  73   /* MIPS ECOFF stuff */
  74   unsigned long bss_start;      /* Base of bss section.         */
  75   unsigned long gp_value;       /* GP register value.           */
  76   unsigned long gprmask;        /* General registers used.      */
  77   unsigned long cprmask[4];     /* Coprocessor registers used.  */
  78 };
  79
  80 /********************** STORAGE CLASSES **********************/
  81
  82 #define C_EFCN          -1      /* physical end of function     */
  83 #define C_NULL          0
  84 #define C_AUTO          1       /* automatic variable           */
  85 #define C_EXT           2       /* external symbol              */
  86 #define C_STAT          3       /* static                       */
  87 #define C_REG           4       /* register variable            */
  88 #define C_EXTDEF        5       /* external definition          */
  89 #define C_LABEL         6       /* label                        */
  90 #define C_ULABEL        7       /* undefined label              */
  91 #define C_MOS           8       /* member of structure          */
  92 #define C_ARG           9       /* function argument            */
  93 #define C_STRTAG        10      /* structure tag                */
  94 #define C_MOU           11      /* member of union              */
  95 #define C_UNTAG         12      /* union tag                    */
  96 #define C_TPDEF         13      /* type definition              */
  97 #define C_USTATIC       14      /* undefined static             */
  98 #define C_ENTAG         15      /* enumeration tag              */
  99 #define C_MOE           16      /* member of enumeration        */
 100 #define C_REGPARM       17      /* register parameter           */
 101 #define C_FIELD         18      /* bit field                    */
 102 #define C_AUTOARG       19      /* auto argument                */
 103 #define C_LASTENT       20      /* dummy entry (end of block)   */
 104 #define C_BLOCK         100     /* ".bb" or ".eb"               */
 105 #define C_FCN           101     /* ".bf" or ".ef"               */
 106 #define C_EOS           102     /* end of structure             */
 107 #define C_FILE          103     /* file name                    */
 108 #define C_LINE          104     /* line # reformatted as symbol table entry */
 109 #define C_ALIAS         105     /* duplicate tag                */
 110 #define C_HIDDEN        106     /* ext symbol in dmert public lib */
 111
 112  /* New storage classes for 80960 */
 113
 114 /* C_LEAFPROC is obsolete.  Use C_LEAFEXT or C_LEAFSTAT */
 115 #define C_LEAFPROC      108     /* Leaf procedure, "call" via BAL */
 116
 117 #define C_SCALL         107     /* Procedure reachable via system call */
 118 #define C_LEAFEXT       108     /* External leaf */
 119 #define C_LEAFSTAT      113     /* Static leaf */
 120 #define C_OPTVAR        109     /* Optimized variable           */
 121 #define C_DEFINE        110     /* Preprocessor #define         */
 122 #define C_PRAGMA        111     /* Advice to compiler or linker */
 123 #define C_SEGMENT       112     /* 80960 segment name           */
 124
 125  /* New storage classes for RS/6000 */
 126 #define C_HIDEXT        107     /* Un-named external symbol */
 127 #define C_BINCL         108     /* Marks beginning of include file */
 128 #define C_EINCL         109     /* Marks ending of include file */
 129
 130  /* storage classes for stab symbols for RS/6000 */
 131 #define C_GSYM          ((signed char)0x80)
 132 #define C_LSYM          ((signed char)0x81)
 133 #define C_PSYM          ((signed char)0x82)
 134 #define C_RSYM          ((signed char)0x83)
 135 #define C_RPSYM         ((signed char)0x84)
 136 #define C_STSYM         ((signed char)0x85)
 137 #define C_TCSYM         ((signed char)0x86)
 138 #define C_BCOMM         ((signed char)0x87)
 139 #define C_ECOML         ((signed char)0x88)
 140 #define C_ECOMM         ((signed char)0x89)
 141 #define C_DECL          ((signed char)0x8c)
 142 #define C_ENTRY         ((signed char)0x8d)
 143 #define C_FUN           ((signed char)0x8e)
 144 #define C_BSTAT         ((signed char)0x8f)
 145 #define C_ESTAT         ((signed char)0x90)
 146
 147 /********************** SECTION HEADER **********************/
 148 struct internal_scnhdr
 149 {
 150   char s_name[8];               /* section name                 */
 151   long s_paddr;                 /* physical address, aliased s_nlib */
 152   long s_vaddr;                 /* virtual address              */
 153   long s_size;                  /* section size                 */
 154   long s_scnptr;                /* file ptr to raw data for section */
 155   long s_relptr;                /* file ptr to relocation       */
 156   long s_lnnoptr;               /* file ptr to line numbers     */
 157   unsigned long s_nreloc;       /* number of relocation entries */
 158   unsigned long s_nlnno;        /* number of line number entries*/
 159   long s_flags;                 /* flags                        */
 160   long s_align;                 /* used on I960                 */
 161 };
 162
 163 /*
 164  * s_flags "type"
 165  */
 166 #define STYP_REG         (0x0000)       /* "regular": allocated, relocated, loaded */
 167 #define STYP_DSECT       (0x0001)       /* "dummy":  relocated only*/
 168 #define STYP_NOLOAD      (0x0002)       /* "noload": allocated, relocated, not loaded */
 169 #define STYP_GROUP       (0x0004)       /* "grouped": formed of input sections */
 170 #define STYP_PAD         (0x0008)       /* "padding": not allocated, not relocated, loaded */
 171 #define STYP_COPY        (0x0010)       /* "copy": for decision function used by field update;  not allocated, not relocated,
 172                                                                              loaded; reloc & lineno entries processed normally */
 173 #define STYP_TEXT        (0x0020)       /* section contains text only */
 174 #define S_SHRSEG         (0x0020)       /* In 3b Update files (output of ogen), sections which appear in SHARED segments of the Pfile
 175                                                                              will have the S_SHRSEG flag set by ogen, to inform dufr that updating 1 copy of the proc. will
 176                                                                              update all process invocations. */
 177 #define STYP_DATA        (0x0040)       /* section contains data only */
 178 #define STYP_BSS         (0x0080)       /* section contains bss only */
 179 #define S_NEWFCN         (0x0100)       /* In a minimal file or an update file, a new function (as compared with a replaced function) */
 180 #define STYP_INFO        (0x0200)       /* comment: not allocated not relocated, not loaded */
 181 #define STYP_OVER        (0x0400)       /* overlay: relocated not allocated or loaded */
 182 #define STYP_LIB         (0x0800)       /* for .lib: same as INFO */
 183 #define STYP_MERGE       (0x2000)       /* merge section -- combines with text, data or bss sections only */
 184 #define STYP_REVERSE_PAD (0x4000)       /* section will be padded with no-op instructions wherever padding is necessary and there is a
 185
 186                                                                              word of contiguous bytes
 187                                                                              beginning on a word boundary. */
 188
 189 #define STYP_LIT        0x8020  /* Literal data (like STYP_TEXT) */
 190 /********************** LINE NUMBERS **********************/
 191
 192 /* 1 line number entry for every "breakpointable" source line in a section.
 193  * Line numbers are grouped on a per function basis; first entry in a function
 194  * grouping will have l_lnno = 0 and in place of physical address will be the
 195  * symbol table index of the function name.
 196  */
 197
 198 struct internal_lineno
 199 {
 200   union
 201   {
 202     long l_symndx;              /* function name symbol index, iff l_lnno == 0*/
 203     long l_paddr;               /* (physical) address of line number    */
 204   }     l_addr;
 205   unsigned long l_lnno;         /* line number          */
 206 };
 207
 208 /********************** SYMBOLS **********************/
 209
 210 #define SYMNMLEN        8       /* # characters in a symbol name        */
 211 #define FILNMLEN        14      /* # characters in a file name          */
 212 #define DIMNUM          4       /* # array dimensions in auxiliary entry */
 213
 214 struct internal_syment
 215 {
 216   union
 217   {
 218     char _n_name[SYMNMLEN];     /* old COFF version     */
 219     struct
 220     {
 221       long _n_zeroes;           /* new == 0             */
 222       long _n_offset;           /* offset into string table */
 223     }      _n_n;
 224     char *_n_nptr[2];           /* allows for overlaying        */
 225   }     _n;
 226   long n_value;                 /* value of symbol              */
 227   short n_scnum;                /* section number               */
 228   unsigned short n_flags;       /* copy of flags from filhdr    */
 229   unsigned short n_type;        /* type and derived type        */
 230   signed char n_sclass;         /* storage class                */
 231   char n_numaux;                /* number of aux. entries       */
 232 };
 233
 234 #define n_name          _n._n_name
 235 #define n_zeroes        _n._n_n._n_zeroes
 236 #define n_offset        _n._n_n._n_offset
 237
 238
 239 /* Relocatable symbols have number of the section in which they are defined,
 240    or one of the following: */
 241
 242 #define N_UNDEF ((short)0)      /* undefined symbol */
 243 #define N_ABS   ((short)-1)     /* value of symbol is absolute */
 244 #define N_DEBUG ((short)-2)     /* debugging symbol -- value is meaningless */
 245 #define N_TV    ((short)-3)     /* indicates symbol needs preload transfer vector */
 246 #define P_TV    ((short)-4)     /* indicates symbol needs postload transfer vector*/
 247
 248 /*
 249  * Type of a symbol, in low N bits of the word
 250  */
 251 #define T_NULL          0
 252 #define T_VOID          1       /* function argument (only used by compiler) */
 253 #define T_CHAR          2       /* character            */
 254 #define T_SHORT         3       /* short integer        */
 255 #define T_INT           4       /* integer              */
 256 #define T_LONG          5       /* long integer         */
 257 #define T_FLOAT         6       /* floating point       */
 258 #define T_DOUBLE        7       /* double word          */
 259 #define T_STRUCT        8       /* structure            */
 260 #define T_UNION         9       /* union                */
 261 #define T_ENUM          10      /* enumeration          */
 262 #define T_MOE           11      /* member of enumeration*/
 263 #define T_UCHAR         12      /* unsigned character   */
 264 #define T_USHORT        13      /* unsigned short       */
 265 #define T_UINT          14      /* unsigned integer     */
 266 #define T_ULONG         15      /* unsigned long        */
 267 #define T_LNGDBL        16      /* long double          */
 268
 269 /*
 270  * derived types, in n_type
 271 */
 272 #define DT_NON          (0)     /* no derived type */
 273 #define DT_PTR          (1)     /* pointer */
 274 #define DT_FCN          (2)     /* function */
 275 #define DT_ARY          (3)     /* array */
 276
 277 #define BTYPE(x)        ((x) & N_BTMASK)
 278
 279 #define ISPTR(x)        (((x) & N_TMASK) == (DT_PTR << N_BTSHFT))
 280 #define ISFCN(x)        (((x) & N_TMASK) == (DT_FCN << N_BTSHFT))
 281 #define ISARY(x)        (((x) & N_TMASK) == (DT_ARY << N_BTSHFT))
 282 #define ISTAG(x)        ((x)==C_STRTAG||(x)==C_UNTAG||(x)==C_ENTAG)
 283 #define DECREF(x) ((((x)>>N_TSHIFT)&~N_BTMASK)|((x)&N_BTMASK))
 284
 285
 286 union internal_auxent
 287 {
 288   struct
 289   {
 290
 291     union
 292     {
 293       long l;                   /* str, un, or enum tag indx */
 294       struct coff_ptr_struct *p;
 295     }     x_tagndx;
 296
 297     union
 298     {
 299       struct
 300       {
 301         unsigned short x_lnno;  /* declaration line number */
 302         unsigned short x_size;  /* str/union/array size */
 303       }      x_lnsz;
 304       long x_fsize;             /* size of function */
 305     }     x_misc;
 306
 307     union
 308     {
 309       struct
 310       {                         /* if ISFCN, tag, or .bb */
 311         long x_lnnoptr;         /* ptr to fcn line # */
 312         union
 313         {                       /* entry ndx past block end */
 314           long l;
 315           struct coff_ptr_struct *p;
 316         }     x_endndx;
 317       }      x_fcn;
 318
 319       struct
 320       {                         /* if ISARY, up to 4 dimen. */
 321         unsigned short x_dimen[DIMNUM];
 322       }      x_ary;
 323     }     x_fcnary;
 324
 325     unsigned short x_tvndx;     /* tv index */
 326   }      x_sym;
 327
 328   union
 329   {
 330     char x_fname[FILNMLEN];
 331     struct
 332     {
 333       long x_zeroes;
 334       long x_offset;
 335     }      x_n;
 336   }     x_file;
 337
 338   struct
 339   {
 340     long x_scnlen;              /* section length */
 341     unsigned short x_nreloc;    /* # relocation entries */
 342     unsigned short x_nlinno;    /* # line numbers */
 343   }      x_scn;
 344
 345   struct
 346   {
 347     long x_tvfill;              /* tv fill value */
 348     unsigned short x_tvlen;     /* length of .tv */
 349     unsigned short x_tvran[2];  /* tv range */
 350   }      x_tv;                  /* info about .tv section (in auxent of symbol .tv)) */
 351
 352   /******************************************
 353    * RS/6000-specific auxent - last auxent for every external symbol
 354    ******************************************/
 355   struct
 356   {
 357     long x_scnlen;              /* csect length */
 358     long x_parmhash;            /* parm type hash index */
 359     unsigned short x_snhash;    /* sect num with parm hash */
 360     unsigned char x_smtyp;      /* symbol align and type */
 361     /* 0-4 - Log 2 of alignment */
 362     /* 5-7 - symbol type */
 363     unsigned char x_smclas;     /* storage mapping class */
 364     long x_stab;                /* dbx stab info index */
 365     unsigned short x_snstab;    /* sect num with dbx stab */
 366   }      x_csect;               /* csect definition information */
 367
 368 /* x_smtyp values:  */
 369
 370 #define SMTYP_ALIGN(x)  ((x) >> 3)      /* log2 of alignment */
 371 #define SMTYP_SMTYP(x)  ((x) & 0x7)     /* symbol type */
 372 /* Symbol type values:  */
 373 #define XTY_ER  0               /* External reference */
 374 #define XTY_SD  1               /* Csect definition */
 375 #define XTY_LD  2               /* Label definition */
 376 #define XTY_CM  3               /* .BSS */
 377 #define XTY_EM  4               /* Error message */
 378 #define XTY_US  5               /* "Reserved for internal use" */
 379
 380 /* x_smclas values:  */
 381
 382 #define XMC_PR  0               /* Read-only program code */
 383 #define XMC_RO  1               /* Read-only constant */
 384 #define XMC_DB  2               /* Read-only debug dictionary table */
 385 #define XMC_TC  3               /* Read-write general TOC entry */
 386 #define XMC_UA  4               /* Read-write unclassified */
 387 #define XMC_RW  5               /* Read-write data */
 388 #define XMC_GL  6               /* Read-only global linkage */
 389 #define XMC_XO  7               /* Read-only extended operation (simulated insn) */
 390 #define XMC_SV  8               /* Read-only supervisor call */
 391 #define XMC_BS  9               /* Read-write BSS */
 392 #define XMC_DS  10              /* Read-write descriptor csect */
 393 #define XMC_UC  11              /* Read-write unnamed Fortran common */
 394 #define XMC_TI  12              /* Read-only traceback index csect */
 395 #define XMC_TB  13              /* Read-only traceback table csect */
 396 /*              14      ??? */
 397 #define XMC_TC0 15              /* Read-write TOC anchor for TOC addressability */
 398
 399
 400   /******************************************
 401    *  I960-specific *2nd* aux. entry formats
 402    ******************************************/
 403   struct
 404   {
 405     /* This is a very old typo that keeps getting propagated. */
 406 #define x_stdindx x_stindx
 407     long x_stindx;              /* sys. table entry */
 408   }      x_sc;                  /* system call entry */
 409
 410   struct
 411   {
 412     unsigned long x_balntry;    /* BAL entry point */
 413   }      x_bal;                 /* BAL-callable function */
 414
 415   struct
 416   {
 417     unsigned long x_timestamp;  /* time stamp */
 418     char x_idstring[20];        /* producer identity string */
 419   }      x_ident;               /* Producer ident info */
 420
 421 };
 422
 423 /********************** RELOCATION DIRECTIVES **********************/
 424
 425 struct internal_reloc
 426 {
 427   long r_vaddr;                 /* Virtual address of reference */
 428   long r_symndx;                /* Index into symbol table      */
 429   unsigned short r_type;        /* Relocation type              */
 430   unsigned char r_size;         /* Used on RS/6000              */
 431   unsigned long r_offset;
 432
 433 };
 434
 435 #define R_RELBYTE       017
 436 #define R_RELWORD       020
 437 #define R_PCRBYTE       022
 438 #define R_PCRWORD       023
 439 #define R_PCRLONG       024
 440
 441 #define R_DIR32         06
 442 #define R_PCLONG        020
 443 #define R_RELBYTE       017
 444 #define R_RELWORD       020
 445
 446
 447
 448 #define R_PCR16L 128
 449 #define R_PCR26L 129
 450 #define R_VRT16  130
 451 #define R_HVRT16 131
 452 #define R_LVRT16 132
 453 #define R_VRT32  133
 454 #define R_RELLONG       (0x11)  /* Direct 32-bit relocation */
 455 #define R_IPRSHORT      (0x18)
 456 #define R_IPRMED        (0x19)  /* 24-bit ip-relative relocation */
 457 #define R_IPRLONG       (0x1a)
 458 #define R_OPTCALL       (0x1b)  /* 32-bit optimizable call (leafproc/sysproc) */
 459 #define R_OPTCALLX      (0x1c)  /* 64-bit optimizable call (leafproc/sysproc) */
 460 #define R_GETSEG        (0x1d)
 461 #define R_GETPA         (0x1e)
 462 #define R_TAGWORD       (0x1f)
 463 #define R_JUMPTARG      0x20    /* strange 29k 00xx00xx reloc */
 464 #define R_MOVB1    0x41         /* Special h8 16bit or 8 bit reloc for  mov.b */
 465 #define R_MOVB2    0x42         /* Special h8 opcode for 8bit which could
 466                                                               be 16 */
 467 #define R_JMP1     0x43         /* Special h8 16bit jmp which could be
 468                                                               pcrel */
 469 #define R_JMP2 0x44             /* a branch which used to be a jmp */
 470 #define R_RELLONG_NEG  0x45
 471
 472
 473 /* Z8k modes */
 474 #define R_IMM16   0x01          /* 16 bit abs */
 475 #define R_JR      0x02          /* jr  8 bit disp */
 476 #define R_IMM4L   0x23          /* low nibble */
 477 #define R_IMM8    0x22          /* 8 bit abs */
 478 #define R_IMM32   R_RELLONG     /* 32 bit abs */
 479 #define R_CALL    R_DA          /* Absolute address which could be a callr */
 480 #define R_JP      R_DA          /* Absolute address which could be a jp */
 481 #define R_REL16   0x04          /* 16 bit PC rel */
 482 #define R_CALLR   0x05          /* callr 12 bit disp */
 483 #define R_SEG     0x10          /* set if in segmented mode */
 484 #define R_IMM4H   0x24          /* high nibble */