include/elf/ppc.h

   1 /* PPC ELF support for BFD.
   2    Copyright (C) 1995-2024 Free Software Foundation, Inc.
   3
   4    By Michael Meissner, Cygnus Support, <meissner@cygnus.com>,
   5    from information in the System V Application Binary Interface,
   6    PowerPC Processor Supplement and the PowerPC Embedded Application
   7    Binary Interface (eabi).
   8
   9    This file is part of BFD, the Binary File Descriptor library.
  10
  11    This program is free software; you can redistribute it and/or modify
  12    it under the terms of the GNU General Public License as published by
  13    the Free Software Foundation; either version 3 of the License, or
  14    (at your option) any later version.
  15
  16    This program is distributed in the hope that it will be useful,
  17    but WITHOUT ANY WARRANTY; without even the implied warranty of
  18    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  19    GNU General Public License for more details.
  20
  21    You should have received a copy of the GNU General Public License
  22    along with this program; if not, write to the Free Software
  23    Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston,
  24    MA 02110-1301, USA.  */
  25
  26 /* This file holds definitions specific to the PPC ELF ABI.  Note
  27    that most of this is not actually implemented by BFD.  */
  28
  29 #ifndef _ELF_PPC_H
  30 #define _ELF_PPC_H
  31
  32 #include "elf/reloc-macros.h"
  33
  34 /* Relocations.  */
  35 START_RELOC_NUMBERS (elf_ppc_reloc_type)
  36   RELOC_NUMBER (R_PPC_NONE,               0)
  37   RELOC_NUMBER (R_PPC_ADDR32,             1)
  38   RELOC_NUMBER (R_PPC_ADDR24,             2)
  39   RELOC_NUMBER (R_PPC_ADDR16,             3)
  40   RELOC_NUMBER (R_PPC_ADDR16_LO,          4)
  41   RELOC_NUMBER (R_PPC_ADDR16_HI,          5)
  42   RELOC_NUMBER (R_PPC_ADDR16_HA,          6)
  43   RELOC_NUMBER (R_PPC_ADDR14,             7)
  44   RELOC_NUMBER (R_PPC_ADDR14_BRTAKEN,     8)
  45   RELOC_NUMBER (R_PPC_ADDR14_BRNTAKEN,    9)
  46   RELOC_NUMBER (R_PPC_REL24,             10)
  47   RELOC_NUMBER (R_PPC_REL14,             11)
  48   RELOC_NUMBER (R_PPC_REL14_BRTAKEN,     12)
  49   RELOC_NUMBER (R_PPC_REL14_BRNTAKEN,    13)
  50   RELOC_NUMBER (R_PPC_GOT16,             14)
  51   RELOC_NUMBER (R_PPC_GOT16_LO,          15)
  52   RELOC_NUMBER (R_PPC_GOT16_HI,          16)
  53   RELOC_NUMBER (R_PPC_GOT16_HA,          17)
  54   RELOC_NUMBER (R_PPC_PLTREL24,          18)
  55   RELOC_NUMBER (R_PPC_COPY,              19)
  56   RELOC_NUMBER (R_PPC_GLOB_DAT,          20)
  57   RELOC_NUMBER (R_PPC_JMP_SLOT,          21)
  58   RELOC_NUMBER (R_PPC_RELATIVE,          22)
  59   RELOC_NUMBER (R_PPC_LOCAL24PC,         23)
  60   RELOC_NUMBER (R_PPC_UADDR32,           24)
  61   RELOC_NUMBER (R_PPC_UADDR16,           25)
  62   RELOC_NUMBER (R_PPC_REL32,             26)
  63   RELOC_NUMBER (R_PPC_PLT32,             27)
  64   RELOC_NUMBER (R_PPC_PLTREL32,          28)
  65   RELOC_NUMBER (R_PPC_PLT16_LO,          29)
  66   RELOC_NUMBER (R_PPC_PLT16_HI,          30)
  67   RELOC_NUMBER (R_PPC_PLT16_HA,          31)
  68   RELOC_NUMBER (R_PPC_SDAREL16,          32)
  69   RELOC_NUMBER (R_PPC_SECTOFF,           33)
  70   RELOC_NUMBER (R_PPC_SECTOFF_LO,        34)
  71   RELOC_NUMBER (R_PPC_SECTOFF_HI,        35)
  72   RELOC_NUMBER (R_PPC_SECTOFF_HA,        36)
  73   RELOC_NUMBER (R_PPC_ADDR30,            37)
  74
  75 #ifndef RELOC_MACROS_GEN_FUNC
  76 /* Relocations only used internally by ld.  If you need to use these
  77    reloc numbers, you can change them to some other unused value
  78    without affecting the ABI.  They will never appear in object files.  */
  79   RELOC_NUMBER (R_PPC_RELAX,             48)
  80   RELOC_NUMBER (R_PPC_RELAX_PLT,         49)
  81   RELOC_NUMBER (R_PPC_RELAX_PLTREL24,    50)
  82 /* Reloc only used internally by gas.  As above, value is unimportant.  */
  83   RELOC_NUMBER (R_PPC_16DX_HA,           51)
  84 #endif
  85
  86   /* Relocs added to support TLS.  */
  87   RELOC_NUMBER (R_PPC_TLS,               67)
  88   RELOC_NUMBER (R_PPC_DTPMOD32,          68)
  89   RELOC_NUMBER (R_PPC_TPREL16,           69)
  90   RELOC_NUMBER (R_PPC_TPREL16_LO,        70)
  91   RELOC_NUMBER (R_PPC_TPREL16_HI,        71)
  92   RELOC_NUMBER (R_PPC_TPREL16_HA,        72)
  93   RELOC_NUMBER (R_PPC_TPREL32,           73)
  94   RELOC_NUMBER (R_PPC_DTPREL16,          74)
  95   RELOC_NUMBER (R_PPC_DTPREL16_LO,       75)
  96   RELOC_NUMBER (R_PPC_DTPREL16_HI,       76)
  97   RELOC_NUMBER (R_PPC_DTPREL16_HA,       77)
  98   RELOC_NUMBER (R_PPC_DTPREL32,          78)
  99   RELOC_NUMBER (R_PPC_GOT_TLSGD16,       79)
 100   RELOC_NUMBER (R_PPC_GOT_TLSGD16_LO,    80)
 101   RELOC_NUMBER (R_PPC_GOT_TLSGD16_HI,    81)
 102   RELOC_NUMBER (R_PPC_GOT_TLSGD16_HA,    82)
 103   RELOC_NUMBER (R_PPC_GOT_TLSLD16,       83)
 104   RELOC_NUMBER (R_PPC_GOT_TLSLD16_LO,    84)
 105   RELOC_NUMBER (R_PPC_GOT_TLSLD16_HI,    85)
 106   RELOC_NUMBER (R_PPC_GOT_TLSLD16_HA,    86)
 107   RELOC_NUMBER (R_PPC_GOT_TPREL16,       87)
 108   RELOC_NUMBER (R_PPC_GOT_TPREL16_LO,    88)
 109   RELOC_NUMBER (R_PPC_GOT_TPREL16_HI,    89)
 110   RELOC_NUMBER (R_PPC_GOT_TPREL16_HA,    90)
 111   RELOC_NUMBER (R_PPC_GOT_DTPREL16,      91)
 112   RELOC_NUMBER (R_PPC_GOT_DTPREL16_LO,   92)
 113   RELOC_NUMBER (R_PPC_GOT_DTPREL16_HI,   93)
 114   RELOC_NUMBER (R_PPC_GOT_DTPREL16_HA,   94)
 115   RELOC_NUMBER (R_PPC_TLSGD,             95)
 116   RELOC_NUMBER (R_PPC_TLSLD,             96)
 117
 118 /* The remaining relocs are from the Embedded ELF ABI, and are not
 119    in the SVR4 ELF ABI.  */
 120   RELOC_NUMBER (R_PPC_EMB_NADDR32,      101)
 121   RELOC_NUMBER (R_PPC_EMB_NADDR16,      102)
 122   RELOC_NUMBER (R_PPC_EMB_NADDR16_LO,   103)
 123   RELOC_NUMBER (R_PPC_EMB_NADDR16_HI,   104)
 124   RELOC_NUMBER (R_PPC_EMB_NADDR16_HA,   105)
 125   RELOC_NUMBER (R_PPC_EMB_SDAI16,       106)
 126   RELOC_NUMBER (R_PPC_EMB_SDA2I16,      107)
 127   RELOC_NUMBER (R_PPC_EMB_SDA2REL,      108)
 128   RELOC_NUMBER (R_PPC_EMB_SDA21,        109)
 129   RELOC_NUMBER (R_PPC_EMB_MRKREF,       110)
 130   RELOC_NUMBER (R_PPC_EMB_RELSEC16,     111)
 131   RELOC_NUMBER (R_PPC_EMB_RELST_LO,     112)
 132   RELOC_NUMBER (R_PPC_EMB_RELST_HI,     113)
 133   RELOC_NUMBER (R_PPC_EMB_RELST_HA,     114)
 134   RELOC_NUMBER (R_PPC_EMB_BIT_FLD,      115)
 135   RELOC_NUMBER (R_PPC_EMB_RELSDA,       116)
 136
 137 /* Marker reloc for inline plt call insns.  */
 138   RELOC_NUMBER (R_PPC_PLTSEQ,           119)
 139   RELOC_NUMBER (R_PPC_PLTCALL,          120)
 140
 141 /* PowerPC VLE relocations.  */
 142   RELOC_NUMBER (R_PPC_VLE_REL8,         216)
 143   RELOC_NUMBER (R_PPC_VLE_REL15,        217)
 144   RELOC_NUMBER (R_PPC_VLE_REL24,        218)
 145   RELOC_NUMBER (R_PPC_VLE_LO16A,        219)
 146   RELOC_NUMBER (R_PPC_VLE_LO16D,        220)
 147   RELOC_NUMBER (R_PPC_VLE_HI16A,        221)
 148   RELOC_NUMBER (R_PPC_VLE_HI16D,        222)
 149   RELOC_NUMBER (R_PPC_VLE_HA16A,        223)
 150   RELOC_NUMBER (R_PPC_VLE_HA16D,        224)
 151   RELOC_NUMBER (R_PPC_VLE_SDA21,        225)
 152   RELOC_NUMBER (R_PPC_VLE_SDA21_LO,     226)
 153   RELOC_NUMBER (R_PPC_VLE_SDAREL_LO16A, 227)
 154   RELOC_NUMBER (R_PPC_VLE_SDAREL_LO16D, 228)
 155   RELOC_NUMBER (R_PPC_VLE_SDAREL_HI16A, 229)
 156   RELOC_NUMBER (R_PPC_VLE_SDAREL_HI16D, 230)
 157   RELOC_NUMBER (R_PPC_VLE_SDAREL_HA16A, 231)
 158   RELOC_NUMBER (R_PPC_VLE_SDAREL_HA16D, 232)
 159   RELOC_NUMBER (R_PPC_VLE_ADDR20,       233)
 160
 161 /* Power9 split rel16 for addpcis.  */
 162   RELOC_NUMBER (R_PPC_REL16DX_HA,       246)
 163
 164 /* Support STT_GNU_IFUNC plt calls.  */
 165   RELOC_NUMBER (R_PPC_IRELATIVE,        248)
 166
 167 /* These are GNU extensions used in PIC code sequences.  */
 168   RELOC_NUMBER (R_PPC_REL16,            249)
 169   RELOC_NUMBER (R_PPC_REL16_LO,         250)
 170   RELOC_NUMBER (R_PPC_REL16_HI,         251)
 171   RELOC_NUMBER (R_PPC_REL16_HA,         252)
 172
 173 /* These are GNU extensions to enable C++ vtable garbage collection.  */
 174   RELOC_NUMBER (R_PPC_GNU_VTINHERIT,    253)
 175   RELOC_NUMBER (R_PPC_GNU_VTENTRY,      254)
 176
 177 /* This is a phony reloc to handle any old fashioned TOC16 references
 178    that may still be in object files.  */
 179   RELOC_NUMBER (R_PPC_TOC16,            255)
 180
 181 END_RELOC_NUMBERS (R_PPC_max)
 182
 183 #define IS_PPC_TLS_RELOC(R) \
 184   ((R) >= R_PPC_TLS && (R) <= R_PPC_GOT_DTPREL16_HA)
 185
 186 /* Specify the value of _GLOBAL_OFFSET_TABLE_.  */
 187 #define DT_PPC_GOT              (DT_LOPROC)
 188
 189 /* Specify that tls descriptors should be optimized.  */
 190 #define DT_PPC_OPT              (DT_LOPROC + 1)
 191 #define PPC_OPT_TLS             1
 192
 193 /* Processor specific flags for the ELF header e_flags field.  */
 194
 195 #define EF_PPC_EMB              0x80000000      /* PowerPC embedded flag.  */
 196
 197 #define EF_PPC_RELOCATABLE      0x00010000      /* PowerPC -mrelocatable flag.  */
 198 #define EF_PPC_RELOCATABLE_LIB  0x00008000      /* PowerPC -mrelocatable-lib flag.  */
 199
 200 /* Processor specific program headers, p_flags field.  */
 201 #define PF_PPC_VLE              0x10000000      /* PowerPC VLE.  */
 202
 203 /* Processor specific section headers, sh_flags field.  */
 204 #define SHF_PPC_VLE             0x10000000      /* PowerPC VLE text section.  */
 205
 206 /* Processor specific section headers, sh_type field.  */
 207
 208 #define SHT_ORDERED             SHT_HIPROC      /* Link editor is to sort the \
 209                                                    entries in this section \
 210                                                    based on the address \
 211                                                    specified in the associated \
 212                                                    symbol table entry.  */
 213
 214 /* APUinfo note section.  */
 215 #define APUINFO_SECTION_NAME    ".PPC.EMB.apuinfo"
 216 #define APUINFO_LABEL           "APUinfo"
 217
 218 #define PPC_APUINFO_ISEL        0x40
 219 #define PPC_APUINFO_PMR         0x41
 220 #define PPC_APUINFO_RFMCI       0x42
 221 #define PPC_APUINFO_CACHELCK    0x43
 222 #define PPC_APUINFO_SPE         0x100
 223 #define PPC_APUINFO_EFS         0x101
 224 #define PPC_APUINFO_BRLOCK      0x102
 225 #define PPC_APUINFO_VLE         0x104
 226
 227 /* Object attribute tags.  */
 228 enum
 229 {
 230   /* 0-3 are generic.  */
 231
 232   /* FP ABI, low 2 bits:
 233      1 for double precision hard-float,
 234      2 for soft-float,
 235      3 for single precision hard-float.
 236      0 for not tagged or not using any ABIs affected by the differences.
 237      Next 2 bits:
 238      1 for ibm long double
 239      2 for 64-bit long double
 240      3 for IEEE long double.
 241      0 for not tagged or not using any ABIs affected by the differences.  */
 242   Tag_GNU_Power_ABI_FP = 4,
 243
 244   /* Value 1 for general purpose registers only, 2 for AltiVec
 245      registers, 3 for SPE registers; 0 for not tagged or not using any
 246      ABIs affected by the differences.  */
 247   Tag_GNU_Power_ABI_Vector = 8,
 248
 249   /* Value 1 for ABIs using r3/r4 for returning structures <= 8 bytes,
 250      2 for ABIs using memory; 0 for not tagged or not using any ABIs
 251      affected by the differences.  */
 252   Tag_GNU_Power_ABI_Struct_Return = 12
 253 };
 254
 255 #endif /* _ELF_PPC_H */