include/coff/rs6000.h

   1 /* IBM RS/6000 "XCOFF" file definitions for BFD.
   2    Copyright (C) 1990, 1991, 2001, 2010 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         union {
 172                 char x_fname[E_FILNMLEN];
 173                 struct {
 174                         char x_zeroes[4];
 175                         char x_offset[4];
 176                 } x_n;
 177         } x_file;
 178
 179         struct {
 180                 char x_scnlen[4];                       /* section length */
 181                 char x_nreloc[2];       /* # relocation entries */
 182                 char x_nlinno[2];       /* # line numbers */
 183         } x_scn;
 184
 185         struct {
 186                 char x_tvfill[4];       /* tv fill value */
 187                 char x_tvlen[2];        /* length of .tv */
 188                 char x_tvran[2][2];     /* tv range */
 189         } x_tv;         /* info about .tv section (in auxent of symbol .tv)) */
 190
 191         struct {
 192                 unsigned char x_scnlen[4];
 193                 unsigned char x_parmhash[4];
 194                 unsigned char x_snhash[2];
 195                 unsigned char x_smtyp[1];
 196                 unsigned char x_smclas[1];
 197                 unsigned char x_stab[4];
 198                 unsigned char x_snstab[2];
 199         } x_csect;
 200
 201 };
 202
 203 #define SYMENT  struct external_syment
 204 #define SYMESZ  18
 205 #define AUXENT  union external_auxent
 206 #define AUXESZ  18
 207 #define DBXMASK 0x80            /* for dbx storage mask */
 208 #define SYMNAME_IN_DEBUG(symptr) ((symptr)->n_sclass & DBXMASK)
 209
 210
 211
 212 /********************** RELOCATION DIRECTIVES **********************/
 213
 214
 215 struct external_reloc {
 216   char r_vaddr[4];
 217   char r_symndx[4];
 218   char r_size[1];
 219   char r_type[1];
 220 };
 221
 222
 223 #define RELOC struct external_reloc
 224 #define RELSZ 10
 225
 226 #define DEFAULT_DATA_SECTION_ALIGNMENT 4
 227 #define DEFAULT_BSS_SECTION_ALIGNMENT 4
 228 #define DEFAULT_TEXT_SECTION_ALIGNMENT 4
 229 /* For new sections we havn't heard of before */
 230 #define DEFAULT_SECTION_ALIGNMENT 4
 231
 232 /* The ldhdr structure.  This appears at the start of the .loader
 233    section.  */
 234
 235 struct external_ldhdr
 236 {
 237   bfd_byte l_version[4];
 238   bfd_byte l_nsyms[4];
 239   bfd_byte l_nreloc[4];
 240   bfd_byte l_istlen[4];
 241   bfd_byte l_nimpid[4];
 242   bfd_byte l_impoff[4];
 243   bfd_byte l_stlen[4];
 244   bfd_byte l_stoff[4];
 245 };
 246
 247 #define LDHDRSZ (8 * 4)
 248
 249 struct external_ldsym
 250 {
 251   union
 252     {
 253       bfd_byte _l_name[SYMNMLEN];
 254       struct
 255         {
 256           bfd_byte _l_zeroes[4];
 257           bfd_byte _l_offset[4];
 258         } _l_l;
 259     } _l;
 260   bfd_byte l_value[4];
 261   bfd_byte l_scnum[2];
 262   bfd_byte l_smtype[1];
 263   bfd_byte l_smclas[1];
 264   bfd_byte l_ifile[4];
 265   bfd_byte l_parm[4];
 266 };
 267
 268 #define LDSYMSZ (8 + 3 * 4 + 2 + 2)
 269
 270 struct external_ldrel
 271 {
 272   bfd_byte l_vaddr[4];
 273   bfd_byte l_symndx[4];
 274   bfd_byte l_rtype[2];
 275   bfd_byte l_rsecnm[2];
 276 };
 277
 278 #define LDRELSZ (2 * 4 + 2 * 2)