include/coff/rs6000.h

   1 /* IBM RS/6000 "XCOFF" file definitions for BFD.
   2    Copyright (C) 1990-2017 Free Software Foundation, Inc.
   3    Written by Mimi Phuong-Thao Vo of IBM
   4    and John Gilmore of Cygnus Support.
   5
   6    This program is free software; you can redistribute it and/or modify
   7    it under the terms of the GNU General Public License as published by
   8    the Free Software Foundation; either version 3 of the License, or
   9    (at your option) any later version.
  10
  11    This program is distributed in the hope that it will be useful,
  12    but WITHOUT ANY WARRANTY; without even the implied warranty of
  13    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14    GNU General Public License for more details.
  15
  16    You should have received a copy of the GNU General Public License
  17    along with this program; if not, write to the Free Software
  18    Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston,
  19    MA 02110-1301, USA.  */
  20
  21 /********************** FILE HEADER **********************/
  22
  23 struct external_filehdr {
  24         char f_magic[2];        /* magic number                 */
  25         char f_nscns[2];        /* number of sections           */
  26         char f_timdat[4];       /* time & date stamp            */
  27         char f_symptr[4];       /* file pointer to symtab       */
  28         char f_nsyms[4];        /* number of symtab entries     */
  29         char f_opthdr[2];       /* sizeof(optional hdr)         */
  30         char f_flags[2];        /* flags                        */
  31 };
  32
  33         /* IBM RS/6000 */
  34 #define U802WRMAGIC     0730    /* writeable text segments **chh**      */
  35 #define U802ROMAGIC     0735    /* readonly sharable text segments      */
  36 #define U802TOCMAGIC    0737    /* readonly text segments and TOC       */
  37
  38 #define BADMAG(x)       \
  39         ((x).f_magic != U802ROMAGIC && (x).f_magic != U802WRMAGIC && \
  40          (x).f_magic != U802TOCMAGIC)
  41
  42 #define FILHDR  struct external_filehdr
  43 #define FILHSZ  20
  44
  45
  46 /********************** AOUT "OPTIONAL HEADER" **********************/
  47
  48
  49 typedef struct
  50 {
  51   unsigned char magic[2];       /* type of file                 */
  52   unsigned char vstamp[2];      /* version stamp                */
  53   unsigned char tsize[4];       /* text size in bytes, padded to FW bdry */
  54   unsigned char dsize[4];       /* initialized data "  "        */
  55   unsigned char bsize[4];       /* uninitialized data "   "     */
  56   unsigned char entry[4];       /* entry pt.                    */
  57   unsigned char text_start[4];  /* base of text used for this file */
  58   unsigned char data_start[4];  /* base of data used for this file */
  59   unsigned char o_toc[4];       /* address of TOC */
  60   unsigned char o_snentry[2];   /* section number of entry point */
  61   unsigned char o_sntext[2];    /* section number of .text section */
  62   unsigned char o_sndata[2];    /* section number of .data section */
  63   unsigned char o_sntoc[2];     /* section number of TOC */
  64   unsigned char o_snloader[2];  /* section number of .loader section */
  65   unsigned char o_snbss[2];     /* section number of .bss section */
  66   unsigned char o_algntext[2];  /* .text alignment */
  67   unsigned char o_algndata[2];  /* .data alignment */
  68   unsigned char o_modtype[2];   /* module type (??) */
  69   unsigned char o_cputype[2];   /* cpu type */
  70   unsigned char o_maxstack[4];  /* max stack size (??) */
  71   unsigned char o_maxdata[4];   /* max data size (??) */
  72   unsigned char o_resv2[12];    /* reserved */
  73 }
  74 AOUTHDR;
  75
  76 #define AOUTSZ 72
  77 #define SMALL_AOUTSZ (28)
  78 #define AOUTHDRSZ 72
  79
  80 /********************** SECTION HEADER **********************/
  81
  82
  83 struct external_scnhdr {
  84         char            s_name[8];      /* section name                 */
  85         char            s_paddr[4];     /* physical address, aliased s_nlib */
  86         char            s_vaddr[4];     /* virtual address              */
  87         char            s_size[4];      /* section size                 */
  88         char            s_scnptr[4];    /* file ptr to raw data for section */
  89         char            s_relptr[4];    /* file ptr to relocation       */
  90         char            s_lnnoptr[4];   /* file ptr to line numbers     */
  91         char            s_nreloc[2];    /* number of relocation entries */
  92         char            s_nlnno[2];     /* number of line number entries*/
  93         char            s_flags[4];     /* flags                        */
  94 };
  95
  96 #define SCNHDR  struct external_scnhdr
  97 #define SCNHSZ  40
  98
  99 /********************** LINE NUMBERS **********************/
 100
 101 /* 1 line number entry for every "breakpointable" source line in a section.
 102  * Line numbers are grouped on a per function basis; first entry in a function
 103  * grouping will have l_lnno = 0 and in place of physical address will be the
 104  * symbol table index of the function name.
 105  */
 106 struct external_lineno {
 107         union {
 108                 char l_symndx[4];       /* function name symbol index, iff l_lnno == 0*/
 109                 char l_paddr[4];        /* (physical) address of line number    */
 110         } l_addr;
 111         char l_lnno[2]; /* line number          */
 112 };
 113
 114
 115 #define LINENO  struct external_lineno
 116 #define LINESZ  6
 117
 118
 119 /********************** SYMBOLS **********************/
 120
 121 #define E_SYMNMLEN      8       /* # characters in a symbol name        */
 122 #define E_FILNMLEN      14      /* # characters in a file name          */
 123 #define E_DIMNUM        4       /* # array dimensions in auxiliary entry */
 124
 125 struct external_syment
 126 {
 127   union {
 128     char e_name[E_SYMNMLEN];
 129     struct {
 130       char e_zeroes[4];
 131       char e_offset[4];
 132     } e;
 133   } e;
 134   char e_value[4];
 135   char e_scnum[2];
 136   char e_type[2];
 137   char e_sclass[1];
 138   char e_numaux[1];
 139 };
 140
 141
 142
 143 #define N_BTMASK        (017)
 144 #define N_TMASK         (060)
 145 #define N_BTSHFT        (4)
 146 #define N_TSHIFT        (2)
 147
 148
 149 union external_auxent {
 150         struct {
 151                 char x_tagndx[4];       /* str, un, or enum tag indx */
 152                 union {
 153                         struct {
 154                             char  x_lnno[2]; /* declaration line number */
 155                             char  x_size[2]; /* str/union/array size */
 156                         } x_lnsz;
 157                         char x_fsize[4];        /* size of function */
 158                 } x_misc;
 159                 union {
 160                         struct {                /* if ISFCN, tag, or .bb */
 161                             char x_lnnoptr[4];  /* ptr to fcn line # */
 162                             char x_endndx[4];   /* entry ndx past block end */
 163                         } x_fcn;
 164                         struct {                /* if ISARY, up to 4 dimen. */
 165                             char x_dimen[E_DIMNUM][2];
 166                         } x_ary;
 167                 } x_fcnary;
 168                 char x_tvndx[2];                /* tv index */
 169         } x_sym;
 170
 171         struct {
 172                 union {
 173                         char x_fname[E_FILNMLEN];
 174                         struct {
 175                                 char x_zeroes[4];
 176                                 char x_offset[4];
 177                         } x_n;
 178                 } x_n;
 179                 char x_ftype[1];
 180         } x_file;
 181
 182         struct {
 183                 char x_scnlen[4];                       /* section length */
 184                 char x_nreloc[2];       /* # relocation entries */
 185                 char x_nlinno[2];       /* # line numbers */
 186         } x_scn;
 187
 188         struct {
 189                 char x_tvfill[4];       /* tv fill value */
 190                 char x_tvlen[2];        /* length of .tv */
 191                 char x_tvran[2][2];     /* tv range */
 192         } x_tv;         /* info about .tv section (in auxent of symbol .tv)) */
 193
 194         struct {
 195                 unsigned char x_scnlen[4];
 196                 unsigned char x_parmhash[4];
 197                 unsigned char x_snhash[2];
 198                 unsigned char x_smtyp[1];
 199                 unsigned char x_smclas[1];
 200                 unsigned char x_stab[4];
 201                 unsigned char x_snstab[2];
 202         } x_csect;
 203
 204 };
 205
 206 #define SYMENT  struct external_syment
 207 #define SYMESZ  18
 208 #define AUXENT  union external_auxent
 209 #define AUXESZ  18
 210 #define DBXMASK 0x80            /* for dbx storage mask */
 211 #define SYMNAME_IN_DEBUG(symptr) ((symptr)->n_sclass & DBXMASK)
 212
 213
 214
 215 /********************** RELOCATION DIRECTIVES **********************/
 216
 217
 218 struct external_reloc {
 219   char r_vaddr[4];
 220   char r_symndx[4];
 221   char r_size[1];
 222   char r_type[1];
 223 };
 224
 225
 226 #define RELOC struct external_reloc
 227 #define RELSZ 10
 228
 229 #define DEFAULT_DATA_SECTION_ALIGNMENT 4
 230 #define DEFAULT_BSS_SECTION_ALIGNMENT 4
 231 #define DEFAULT_TEXT_SECTION_ALIGNMENT 4
 232 /* For new sections we havn't heard of before */
 233 #define DEFAULT_SECTION_ALIGNMENT 4
 234
 235 /* The ldhdr structure.  This appears at the start of the .loader
 236    section.  */
 237
 238 struct external_ldhdr
 239 {
 240   bfd_byte l_version[4];
 241   bfd_byte l_nsyms[4];
 242   bfd_byte l_nreloc[4];
 243   bfd_byte l_istlen[4];
 244   bfd_byte l_nimpid[4];
 245   bfd_byte l_impoff[4];
 246   bfd_byte l_stlen[4];
 247   bfd_byte l_stoff[4];
 248 };
 249
 250 #define LDHDRSZ (8 * 4)
 251
 252 struct external_ldsym
 253 {
 254   union
 255     {
 256       bfd_byte _l_name[E_SYMNMLEN];
 257       struct
 258         {
 259           bfd_byte _l_zeroes[4];
 260           bfd_byte _l_offset[4];
 261         } _l_l;
 262     } _l;
 263   bfd_byte l_value[4];
 264   bfd_byte l_scnum[2];
 265   bfd_byte l_smtype[1];
 266   bfd_byte l_smclas[1];
 267   bfd_byte l_ifile[4];
 268   bfd_byte l_parm[4];
 269 };
 270
 271 #define LDSYMSZ (8 + 3 * 4 + 2 + 2)
 272
 273 struct external_ldrel
 274 {
 275   bfd_byte l_vaddr[4];
 276   bfd_byte l_symndx[4];
 277   bfd_byte l_rtype[2];
 278   bfd_byte l_rsecnm[2];
 279 };
 280
 281 #define LDRELSZ (2 * 4 + 2 * 2)
 282
 283 struct external_exceptab
 284 {
 285   union {
 286     bfd_byte e_symndx[4];
 287     bfd_byte e_paddr[4];
 288   } e_addr;
 289   bfd_byte e_lang[1];
 290   bfd_byte e_reason[1];
 291 };
 292
 293 #define EXCEPTSZ (4 + 2)
 294
 295 /******************** Core files *************************/
 296
 297 struct external_core_dumpx
 298 {
 299   unsigned char c_signo[1];
 300   unsigned char c_flag[1];
 301   unsigned char c_entries[2];
 302
 303   unsigned char c_version[4];
 304
 305   unsigned char c_fdsinfox[8];
 306   unsigned char c_loader[8];
 307   unsigned char c_lsize[8];
 308
 309   unsigned char c_n_thr[4];
 310   unsigned char c_reserved0[4];
 311   unsigned char c_thr[8];
 312
 313   unsigned char c_segs[8];
 314   unsigned char c_segregion[8];
 315
 316   unsigned char c_stack[8];
 317   unsigned char c_stackorg[8];
 318   unsigned char c_size[8];
 319
 320   unsigned char c_data[8];
 321   unsigned char c_dataorg[8];
 322   unsigned char c_datasize[8];
 323   unsigned char c_sdorg[8];
 324   unsigned char c_sdsize[8];
 325
 326   unsigned char c_vmmregions[8];
 327   unsigned char c_vmm[8];
 328
 329   unsigned char c_impl[4];
 330   unsigned char c_pad[4];
 331   unsigned char c_cprs[8];
 332   unsigned char c_reserved[7 * 8];
 333
 334   /* Followed by:
 335      - context of the faulting thread.
 336      - user structure.  */
 337 };
 338
 339
 340 /* Core file verion.  */
 341 #define CORE_DUMPX_VERSION 0x0feeddb1
 342 #define CORE_DUMPXX_VERSION 0x0feeddb2
 343
 344 struct external_ld_info32
 345 {
 346   unsigned char ldinfo_next[4];
 347   unsigned char core_offset[4];
 348   unsigned char ldinfo_textorg[4];
 349   unsigned char ldinfo_textsize[4];
 350   unsigned char ldinfo_dataorg[4];
 351   unsigned char ldinfo_datasize[4];
 352   unsigned char ldinfo_filename[2];
 353 };