arch/powerpc/boot/rs6000.h

   1 /* SPDX-License-Identifier: GPL-2.0 */
   2 /* IBM RS/6000 "XCOFF" file definitions for BFD.
   3    Copyright (C) 1990, 1991 Free Software Foundation, Inc.
   4    FIXME: Can someone provide a transliteration of this name into ASCII?
   5    Using the following chars caused a compiler warning on HIUX (so I replaced
   6    them with octal escapes), and isn't useful without an understanding of what
   7    character set it is.
   8    Written by Mimi Ph\373\364ng-Th\345o V\365 of IBM
   9    and John Gilmore of Cygnus Support.  */
  10
  11 /********************** FILE HEADER **********************/
  12
  13 struct external_filehdr {
  14         char f_magic[2];        /* magic number                 */
  15         char f_nscns[2];        /* number of sections           */
  16         char f_timdat[4];       /* time & date stamp            */
  17         char f_symptr[4];       /* file pointer to symtab       */
  18         char f_nsyms[4];        /* number of symtab entries     */
  19         char f_opthdr[2];       /* sizeof(optional hdr)         */
  20         char f_flags[2];        /* flags                        */
  21 };
  22
  23         /* IBM RS/6000 */
  24 #define U802WRMAGIC     0730    /* writeable text segments **chh**      */
  25 #define U802ROMAGIC     0735    /* readonly sharable text segments      */
  26 #define U802TOCMAGIC    0737    /* readonly text segments and TOC       */
  27
  28 #define BADMAG(x)       \
  29         ((x).f_magic != U802ROMAGIC && (x).f_magic != U802WRMAGIC && \
  30          (x).f_magic != U802TOCMAGIC)
  31
  32 #define FILHDR  struct external_filehdr
  33 #define FILHSZ  20
  34
  35
  36 /********************** AOUT "OPTIONAL HEADER" **********************/
  37
  38
  39 typedef struct
  40 {
  41   unsigned char magic[2];       /* type of file                 */
  42   unsigned char vstamp[2];      /* version stamp                */
  43   unsigned char tsize[4];       /* text size in bytes, padded to FW bdry */
  44   unsigned char dsize[4];       /* initialized data "  "        */
  45   unsigned char bsize[4];       /* uninitialized data "   "     */
  46   unsigned char entry[4];       /* entry pt.                    */
  47   unsigned char text_start[4];  /* base of text used for this file */
  48   unsigned char data_start[4];  /* base of data used for this file */
  49   unsigned char o_toc[4];       /* address of TOC */
  50   unsigned char o_snentry[2];   /* section number of entry point */
  51   unsigned char o_sntext[2];    /* section number of .text section */
  52   unsigned char o_sndata[2];    /* section number of .data section */
  53   unsigned char o_sntoc[2];     /* section number of TOC */
  54   unsigned char o_snloader[2];  /* section number of .loader section */
  55   unsigned char o_snbss[2];     /* section number of .bss section */
  56   unsigned char o_algntext[2];  /* .text alignment */
  57   unsigned char o_algndata[2];  /* .data alignment */
  58   unsigned char o_modtype[2];   /* module type (??) */
  59   unsigned char o_cputype[2];   /* cpu type */
  60   unsigned char o_maxstack[4];  /* max stack size (??) */
  61   unsigned char o_maxdata[4];   /* max data size (??) */
  62   unsigned char o_resv2[12];    /* reserved */
  63 }
  64 AOUTHDR;
  65
  66 #define AOUTSZ 72
  67 #define SMALL_AOUTSZ (28)
  68 #define AOUTHDRSZ 72
  69
  70 #define RS6K_AOUTHDR_OMAGIC     0x0107  /* old: text & data writeable */
  71 #define RS6K_AOUTHDR_NMAGIC     0x0108  /* new: text r/o, data r/w */
  72 #define RS6K_AOUTHDR_ZMAGIC     0x010B  /* paged: text r/o, both page-aligned */
  73
  74
  75 /********************** SECTION HEADER **********************/
  76
  77
  78 struct external_scnhdr {
  79         char            s_name[8];      /* section name                 */
  80         char            s_paddr[4];     /* physical address, aliased s_nlib */
  81         char            s_vaddr[4];     /* virtual address              */
  82         char            s_size[4];      /* section size                 */
  83         char            s_scnptr[4];    /* file ptr to raw data for section */
  84         char            s_relptr[4];    /* file ptr to relocation       */
  85         char            s_lnnoptr[4];   /* file ptr to line numbers     */
  86         char            s_nreloc[2];    /* number of relocation entries */
  87         char            s_nlnno[2];     /* number of line number entries*/
  88         char            s_flags[4];     /* flags                        */
  89 };
  90
  91 /*
  92  * names of "special" sections
  93  */
  94 #define _TEXT   ".text"
  95 #define _DATA   ".data"
  96 #define _BSS    ".bss"
  97 #define _PAD    ".pad"
  98 #define _LOADER ".loader"
  99
 100 #define SCNHDR  struct external_scnhdr
 101 #define SCNHSZ  40
 102
 103 /* XCOFF uses a special .loader section with type STYP_LOADER.  */
 104 #define STYP_LOADER 0x1000
 105
 106 /* XCOFF uses a special .debug section with type STYP_DEBUG.  */
 107 #define STYP_DEBUG 0x2000
 108
 109 /* XCOFF handles line number or relocation overflow by creating
 110    another section header with STYP_OVRFLO set.  */
 111 #define STYP_OVRFLO 0x8000
 112
 113 /********************** LINE NUMBERS **********************/
 114
 115 /* 1 line number entry for every "breakpointable" source line in a section.
 116  * Line numbers are grouped on a per function basis; first entry in a function
 117  * grouping will have l_lnno = 0 and in place of physical address will be the
 118  * symbol table index of the function name.
 119  */
 120 struct external_lineno {
 121         union {
 122                 char l_symndx[4];       /* function name symbol index, iff l_lnno == 0*/
 123                 char l_paddr[4];        /* (physical) address of line number    */
 124         } l_addr;
 125         char l_lnno[2]; /* line number          */
 126 };
 127
 128
 129 #define LINENO  struct external_lineno
 130 #define LINESZ  6
 131
 132
 133 /********************** SYMBOLS **********************/
 134
 135 #define E_SYMNMLEN      8       /* # characters in a symbol name        */
 136 #define E_FILNMLEN      14      /* # characters in a file name          */
 137 #define E_DIMNUM        4       /* # array dimensions in auxiliary entry */
 138
 139 struct external_syment
 140 {
 141   union {
 142     char e_name[E_SYMNMLEN];
 143     struct {
 144       char e_zeroes[4];
 145       char e_offset[4];
 146     } e;
 147   } e;
 148   char e_value[4];
 149   char e_scnum[2];
 150   char e_type[2];
 151   char e_sclass[1];
 152   char e_numaux[1];
 153 };
 154
 155
 156
 157 #define N_BTMASK        (017)
 158 #define N_TMASK         (060)
 159 #define N_BTSHFT        (4)
 160 #define N_TSHIFT        (2)
 161
 162
 163 union external_auxent {
 164         struct {
 165                 char x_tagndx[4];       /* str, un, or enum tag indx */
 166                 union {
 167                         struct {
 168                             char  x_lnno[2]; /* declaration line number */
 169                             char  x_size[2]; /* str/union/array size */
 170                         } x_lnsz;
 171                         char x_fsize[4];        /* size of function */
 172                 } x_misc;
 173                 union {
 174                         struct {                /* if ISFCN, tag, or .bb */
 175                             char x_lnnoptr[4];  /* ptr to fcn line # */
 176                             char x_endndx[4];   /* entry ndx past block end */
 177                         } x_fcn;
 178                         struct {                /* if ISARY, up to 4 dimen. */
 179                             char x_dimen[E_DIMNUM][2];
 180                         } x_ary;
 181                 } x_fcnary;
 182                 char x_tvndx[2];                /* tv index */
 183         } x_sym;
 184
 185         union {
 186                 char x_fname[E_FILNMLEN];
 187                 struct {
 188                         char x_zeroes[4];
 189                         char x_offset[4];
 190                 } x_n;
 191         } x_file;
 192
 193         struct {
 194                 char x_scnlen[4];                       /* section length */
 195                 char x_nreloc[2];       /* # relocation entries */
 196                 char x_nlinno[2];       /* # line numbers */
 197         } x_scn;
 198
 199         struct {
 200                 char x_tvfill[4];       /* tv fill value */
 201                 char x_tvlen[2];        /* length of .tv */
 202                 char x_tvran[2][2];     /* tv range */
 203         } x_tv;         /* info about .tv section (in auxent of symbol .tv)) */
 204
 205         struct {
 206                 unsigned char x_scnlen[4];
 207                 unsigned char x_parmhash[4];
 208                 unsigned char x_snhash[2];
 209                 unsigned char x_smtyp[1];
 210                 unsigned char x_smclas[1];
 211                 unsigned char x_stab[4];
 212                 unsigned char x_snstab[2];
 213         } x_csect;
 214
 215 };
 216
 217 #define SYMENT  struct external_syment
 218 #define SYMESZ  18
 219 #define AUXENT  union external_auxent
 220 #define AUXESZ  18
 221 #define DBXMASK 0x80            /* for dbx storage mask */
 222 #define SYMNAME_IN_DEBUG(symptr) ((symptr)->n_sclass & DBXMASK)
 223
 224
 225
 226 /********************** RELOCATION DIRECTIVES **********************/
 227
 228
 229 struct external_reloc {
 230   char r_vaddr[4];
 231   char r_symndx[4];
 232   char r_size[1];
 233   char r_type[1];
 234 };
 235
 236
 237 #define RELOC struct external_reloc
 238 #define RELSZ 10
 239
 240 #define DEFAULT_DATA_SECTION_ALIGNMENT 4
 241 #define DEFAULT_BSS_SECTION_ALIGNMENT 4
 242 #define DEFAULT_TEXT_SECTION_ALIGNMENT 4
 243 /* For new sections we haven't heard of before */
 244 #define DEFAULT_SECTION_ALIGNMENT 4