elfcpp/arm.h

   1 // arm.h -- ELF definitions specific to EM_ARM  -*- C++ -*-
   2
   3 // Copyright (C) 2009-2024 Free Software Foundation, Inc.
   4 // Written by Doug Kwan <dougkwan@google.com>.
   5
   6 // This file is part of elfcpp.
   7
   8 // This program is free software; you can redistribute it and/or
   9 // modify it under the terms of the GNU Library General Public License
  10 // as published by the Free Software Foundation; either version 2, or
  11 // (at your option) any later version.
  12
  13 // In addition to the permissions in the GNU Library General Public
  14 // License, the Free Software Foundation gives you unlimited
  15 // permission to link the compiled version of this file into
  16 // combinations with other programs, and to distribute those
  17 // combinations without any restriction coming from the use of this
  18 // file.  (The Library Public License restrictions do apply in other
  19 // respects; for example, they cover modification of the file, and
  20 // distribution when not linked into a combined executable.)
  21
  22 // This program is distributed in the hope that it will be useful, but
  23 // WITHOUT ANY WARRANTY; without even the implied warranty of
  24 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  25 // Library General Public License for more details.
  26
  27 // You should have received a copy of the GNU Library General Public
  28 // License along with this program; if not, write to the Free Software
  29 // Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston, MA
  30 // 02110-1301, USA.
  31
  32 #ifndef ELFCPP_ARM_H
  33 #define ELFCPP_ARM_H
  34
  35 // The relocation type information is taken from:
  36 //
  37 //   ELF for the ARM Architecture
  38 //   Document number: ARM IHI 0044C, current through ABI release 2.07
  39 //   Date of Issue: 10th October, 2008
  40 //
  41
  42 namespace elfcpp
  43 {
  44
  45 //
  46 // ARM Relocations Codes
  47 //
  48
  49 // Operation notes:
  50 //   S: Address of the symbol.
  51 //   A: Addend for relocation.
  52 //   P: Address of the place being relocated.
  53 //   Pa: Adjusted address of the place being relocated (P & 0xfffffffc)
  54 //   T: is 1 if S has type STT_FUNC and the symbol addresses a Thumb
  55 //      instruction.Thumb-bit; it is 0 otherwise.
  56 //   B(S): Addressing origin of the output segment defining S.
  57 //   GOT_ORG: Addressing origin of the Global Offset Table.
  58 //   GOT(S): Address of the GOT entry for S.
  59 //
  60
  61 enum
  62 {
  63                                 // Type         Class   Operation
  64                                 // ------------------------------
  65   R_ARM_NONE = 0,               // Static       Misc
  66   R_ARM_PC24 = 1,               // Deprecated   ARM     ((S + A) | T) - P
  67   R_ARM_ABS32 = 2,              // Static       Data    (S + A) | T
  68   R_ARM_REL32 = 3,              // Static       Data    ((S + A) | T) - P
  69   R_ARM_LDR_PC_G0 = 4,          // Static       ARM     S + A - P
  70   R_ARM_ABS16 = 5,              // Static       Data    S + A
  71   R_ARM_ABS12 = 6,              // Static       ARM     S + A
  72   R_ARM_THM_ABS5 = 7,           // Static       Thumb16 S + A
  73   R_ARM_ABS8 = 8,               // Static       Data    S + A
  74   R_ARM_SBREL32 = 9,            // Static       Data    ((S + A) | T) - B(S)
  75   R_ARM_THM_CALL = 10,          // Static       Thumb32 ((S + A) | T) - P
  76   R_ARM_THM_PC8 = 11,           // Static       Thumb16
  77   R_ARM_BREL_ADJ = 12,          // Dynamic      Data    DeltaB(S) + A
  78   R_ARM_TLS_DESC = 13,          // Dynamic      Data
  79   R_ARM_THM_SWI8 = 14,          // Obsolete
  80   R_ARM_XPC25 = 15,             // Obsolete
  81   R_ARM_THM_XPC22 = 16,         // Obsolete
  82   R_ARM_TLS_DTPMOD32 = 17,      // Dynamic      Data    Module(S)
  83   R_ARM_TLS_DTPOFF32 = 18,      // Dynamic      Data    S + A - TLS
  84   R_ARM_TLS_TPOFF32 = 19,       // Dynamic      Data    S + A - tp
  85   R_ARM_COPY = 20,              // Dynamic      Misc
  86   R_ARM_GLOB_DAT = 21,          // Dynamic      Data    (S + A) | T
  87   R_ARM_JUMP_SLOT = 22,         // Dynamic      Data    (S + A) | T
  88   R_ARM_RELATIVE = 23,          // Dynamic      Data    B(S) + A
  89   R_ARM_GOTOFF32 = 24,          // Static       Data    (((S + A) | T) - GOT_ORG
  90   R_ARM_BASE_PREL = 25,         // Static       Data    B(S) + A - P
  91   R_ARM_GOT_BREL = 26,          // Static       Data    GOT(S) + A - GOT_ORG
  92   R_ARM_PLT32 = 27,             // Deprecated   ARM     ((S + A) | T) - P
  93   R_ARM_CALL = 28,              // Static       ARM     ((S + A) | T) - P
  94   R_ARM_JUMP24 = 29,            // Static       ARM     ((S + A) | T) - P
  95   R_ARM_THM_JUMP24 = 30,        // Static       Thumb32 ((S + A) | T) - P
  96   R_ARM_BASE_ABS = 31,          // Static       Data    B(S) + A
  97   R_ARM_ALU_PCREL_7_0 = 32,     // Obsolete
  98   R_ARM_ALU_PCREL_15_8 = 33,    // Obsolete
  99   R_ARM_ALU_PCREL_23_15 = 34,   // Obsolete
 100   R_ARM_LDR_SBREL_11_0_NC = 35, // Deprecated   ARM     S + A - B(S)
 101   R_ARM_ALU_SBREL_19_12_NC = 36,// Deprecated   ARM     S + A - B(S)
 102   R_ARM_ALU_SBREL_27_20_CK = 37,// Deprecated   ARM     S + A - B(S)
 103   R_ARM_TARGET1 = 38,           // Data         Misc    (S + A) | T or
 104                                 //                      ((S + A) | T) - P
 105   R_ARM_SBREL31 = 39,           // Deprecated   Data    ((S + A) | T) - B(S)
 106   R_ARM_V4BX = 40,              // Static       Misc
 107   R_ARM_TARGET2 = 41,           // Static       Misc
 108   R_ARM_PREL31 = 42,            // Static       Data    ((S + A) | T) - P
 109   R_ARM_MOVW_ABS_NC = 43,       // Static       ARM     (S + A) | T
 110   R_ARM_MOVT_ABS = 44,          // Static       ARM     S + A
 111   R_ARM_MOVW_PREL_NC = 45,      // Static       ARM     ((S + A) | T) - P
 112   R_ARM_MOVT_PREL = 46,         // Static       ARM     S + A - P
 113   R_ARM_THM_MOVW_ABS_NC = 47,   // Static       Thumb32 (S + A) | T
 114   R_ARM_THM_MOVT_ABS = 48,      // Static       Thumb32 S + A - P
 115   R_ARM_THM_MOVW_PREL_NC =  49, // Static       Thumb32 ((S + A) | T) - P
 116   R_ARM_THM_MOVT_PREL = 50,     // Static       Thumb32 S + A - P
 117   R_ARM_THM_JUMP19 = 51,        // Static       Thumb32 ((S + A) | T) - P
 118   R_ARM_THM_JUMP6 = 52,         // Static       Thumb16 S + A - P
 119   R_ARM_THM_ALU_PREL_11_0 = 53, // Static       Thumb32 ((S + A) | T) - Pa
 120   R_ARM_THM_PC12 = 54,          // Static       Thumb32 S + A - Pa
 121   R_ARM_ABS32_NOI = 55,         // Static       Data    S + A
 122   R_ARM_REL32_NOI = 56,         // Static       Data    S + A - P
 123   R_ARM_ALU_PC_G0_NC = 57,      // Static       ARM     ((S + A) | T) - P
 124   R_ARM_ALU_PC_G0 = 58,         // Static       ARM     ((S + A) | T) - P
 125   R_ARM_ALU_PC_G1_NC = 59,      // Static       ARM     ((S + A) | T) - P
 126   R_ARM_ALU_PC_G1 = 60,         // Static       ARM     ((S + A) | T) - P
 127   R_ARM_ALU_PC_G2 = 61,         // Static       ARM     ((S + A) | T) - P
 128   R_ARM_LDR_PC_G1 = 62,         // Static       ARM     S + A - P
 129   R_ARM_LDR_PC_G2 = 63,         // Static       ARM     S + A - P
 130   R_ARM_LDRS_PC_G0 = 64,        // Static       ARM     S + A - P
 131   R_ARM_LDRS_PC_G1 = 65,        // Static       ARM     S + A - P
 132   R_ARM_LDRS_PC_G2 = 66,        // Static       ARM     S + A - P
 133   R_ARM_LDC_PC_G0 = 67,         // Static       ARM     S + A - P
 134   R_ARM_LDC_PC_G1 = 68,         // Static       ARM     S + A - P
 135   R_ARM_LDC_PC_G2 = 69,         // Static       ARM     S + A - P
 136   R_ARM_ALU_SB_G0_NC = 70,      // Static       ARM     ((S + A) | T) - B(S)
 137   R_ARM_ALU_SB_G0 = 71,         // Static       ARM     ((S + A) | T) - B(S)
 138   R_ARM_ALU_SB_G1_NC = 72,      // Static       ARM     ((S + A) | T) - B(S)
 139   R_ARM_ALU_SB_G1 = 73,         // Static       ARM     ((S + A) | T) - B(S)
 140   R_ARM_ALU_SB_G2 = 74,         // Static       ARM     ((S + A) | T) - B(S)
 141   R_ARM_LDR_SB_G0 = 75,         // Static       ARM     S + A - B(S)
 142   R_ARM_LDR_SB_G1 = 76,         // Static       ARM     S + A - B(S)
 143   R_ARM_LDR_SB_G2 = 77,         // Static       ARM     S + A - B(S)
 144   R_ARM_LDRS_SB_G0 = 78,        // Static       ARM     S + A - B(S)
 145   R_ARM_LDRS_SB_G1 = 79,        // Static       ARM     S + A - B(S)
 146   R_ARM_LDRS_SB_G2 = 80,        // Static       ARM     S + A - B(S)
 147   R_ARM_LDC_SB_G0 = 81,         // Static       ARM     S + A - B(S)
 148   R_ARM_LDC_SB_G1 = 82,         // Static       ARM     S + A - B(S)
 149   R_ARM_LDC_SB_G2 = 83,         // Static       ARM     S + A - B(S)
 150   R_ARM_MOVW_BREL_NC = 84,      // Static       ARM     ((S + A) | T) - B(S)
 151   R_ARM_MOVT_BREL = 85,         // Static       ARM     S + A - B(S)
 152   R_ARM_MOVW_BREL = 86,         // Static       ARM     ((S + A) | T) - B(S)
 153   R_ARM_THM_MOVW_BREL_NC = 87,  // Static       Thumb32 ((S + A) | T) - B(S)
 154   R_ARM_THM_MOVT_BREL = 88,     // Static       Thumb32 S + A - B(S)
 155   R_ARM_THM_MOVW_BREL = 89,     // Static       Thumb32 ((S + A) | T) - B(S)
 156   R_ARM_TLS_GOTDESC = 90,       // Static       Data
 157   R_ARM_TLS_CALL = 91,          // Static       ARM
 158   R_ARM_TLS_DESCSEQ = 92,       // Static       ARM     TLS relaxation
 159   R_ARM_THM_TLS_CALL = 93,      // Static       Thumb32
 160   R_ARM_PLT32_ABS =  94,        // Static       Data    PLT(S) + A
 161   R_ARM_GOT_ABS =  95,          // Static       Data    GOT(S) + A
 162   R_ARM_GOT_PREL = 96,          // Static       Data    GOT(S) + A - P
 163   R_ARM_GOT_BREL12 =  97,       // Static       ARM     GOT(S) + A - GOT_ORG
 164   R_ARM_GOTOFF12 =  98,         // Static       ARM     S + A - GOT_ROG
 165   R_ARM_GOTRELAX =  99,         // Static       Misc
 166   R_ARM_GNU_VTENTRY = 100,      // Deprecated   Data
 167   R_ARM_GNU_VTINHERIT = 101,    // Deprecated   Data
 168   R_ARM_THM_JUMP11 = 102,       // Static       Thumb16 S + A - P
 169   R_ARM_THM_JUMP8 = 103,        // Static       Thumb16 S + A - P
 170   R_ARM_TLS_GD32 = 104,         // Static       Data    GOT(S) + A - P
 171   R_ARM_TLS_LDM32 = 105,        // Static       Data    GOT(S) + A - P
 172   R_ARM_TLS_LDO32 = 106,        // Static       Data    S + A - TLS
 173   R_ARM_TLS_IE32 = 107,         // Static       Data    GOT(S) + A - P
 174   R_ARM_TLS_LE32 = 108,         // Static       Data    S + A - tp
 175   R_ARM_TLS_LDO12 = 109,        // Static       ARM     S + A - TLS
 176   R_ARM_TLS_LE12 = 110,         // Static       ARM     S + A - tp
 177   R_ARM_TLS_IE12GP = 111,       // Static       ARM     GOT(S) + A - GOT_ORG
 178   R_ARM_PRIVATE_0 = 112,        // Private (n = 0, 1, ... 15)
 179   R_ARM_PRIVATE_1 = 113,
 180   R_ARM_PRIVATE_2 = 114,
 181   R_ARM_PRIVATE_3 = 115,
 182   R_ARM_PRIVATE_4 = 116,
 183   R_ARM_PRIVATE_5 = 117,
 184   R_ARM_PRIVATE_6 = 118,
 185   R_ARM_PRIVATE_7 = 119,
 186   R_ARM_PRIVATE_8 = 120,
 187   R_ARM_PRIVATE_9 = 121,
 188   R_ARM_PRIVATE_10 = 122,
 189   R_ARM_PRIVATE_11 = 123,
 190   R_ARM_PRIVATE_12 = 124,
 191   R_ARM_PRIVATE_13 = 125,
 192   R_ARM_PRIVATE_14 = 126,
 193   R_ARM_PRIVATE_15 = 127,
 194   R_ARM_ME_TOO = 128,           // Obsolete
 195   R_ARM_THM_TLS_DESCSEQ16 = 129,// Static       Thumb16
 196   R_ARM_THM_TLS_DESCSEQ32 = 130,// Static       Thumb32
 197   // 131 - 135                  Unallocated
 198   // Relocations for Armv8.1-M Mainline (BF/BFL)
 199   R_ARM_THM_BF16 = 136,         // Static       Thumb32 ((S + A) | T) – P
 200   R_ARM_THM_BF12 = 137,         // Static       Thumb32 ((S + A) | T) – P
 201   R_ARM_THM_BF18 = 138,         // Static       Thumb32 ((S + A) | T) – P
 202   // 139                        Unallocated
 203   // 140 - 159                  Dynamic         Reserved for future allocation
 204   R_ARM_IRELATIVE = 160,        // Dynamic
 205   // 161 - 255                  Unallocated
 206 };
 207
 208 // e_flags values used for ARM.  We only support flags defined in AAELF.
 209
 210 enum
 211 {
 212   EF_ARM_BE8 = 0x00800000,
 213
 214   // Mask to extract EABI version, not really a flag value.
 215   EF_ARM_EABIMASK = 0xFF000000,
 216
 217   EF_ARM_EABI_UNKNOWN = 0x00000000,
 218   EF_ARM_EABI_VER1 = 0x01000000,
 219   EF_ARM_EABI_VER2 = 0x02000000,
 220   EF_ARM_EABI_VER3 = 0x03000000,
 221   EF_ARM_EABI_VER4 = 0x04000000,
 222   EF_ARM_EABI_VER5 = 0x05000000,
 223 };
 224
 225 // Extract EABI version from flags.
 226
 227 inline Elf_Word
 228 arm_eabi_version(Elf_Word flags)
 229 { return flags & EF_ARM_EABIMASK; }
 230
 231 // EABI_VER5 e_flags values for identifying soft- and hard-float ABI
 232 // choice.
 233 enum
 234 {
 235   EF_ARM_ABI_FLOAT_SOFT = 0x200,
 236   EF_ARM_ABI_FLOAT_HARD = 0x400,
 237 };
 238
 239 // Values for the Tag_CPU_arch EABI attribute.
 240 enum
 241 {
 242   TAG_CPU_ARCH_PRE_V4,
 243   TAG_CPU_ARCH_V4,
 244   TAG_CPU_ARCH_V4T,
 245   TAG_CPU_ARCH_V5T,
 246   TAG_CPU_ARCH_V5TE,
 247   TAG_CPU_ARCH_V5TEJ,
 248   TAG_CPU_ARCH_V6,
 249   TAG_CPU_ARCH_V6KZ,
 250   TAG_CPU_ARCH_V6T2,
 251   TAG_CPU_ARCH_V6K,
 252   TAG_CPU_ARCH_V7,
 253   TAG_CPU_ARCH_V6_M,
 254   TAG_CPU_ARCH_V6S_M,
 255   TAG_CPU_ARCH_V7E_M,
 256   TAG_CPU_ARCH_V8,
 257   TAG_CPU_ARCH_V8R,
 258   TAG_CPU_ARCH_V8M_BASE,
 259   TAG_CPU_ARCH_V8M_MAIN,
 260   TAG_CPU_ARCH_8_1A,
 261   TAG_CPU_ARCH_8_2A,
 262   TAG_CPU_ARCH_8_3A,
 263   TAG_CPU_ARCH_V8_1M_MAIN,
 264   TAG_CPU_ARCH_V9,
 265   MAX_TAG_CPU_ARCH = TAG_CPU_ARCH_V9,
 266   // Pseudo-architecture to allow objects to be compatible with the subset of
 267   // armv4t and armv6-m.  This value should never be stored in object files.
 268   TAG_CPU_ARCH_V4T_PLUS_V6_M = (MAX_TAG_CPU_ARCH + 1)
 269 };
 270
 271 // EABI object attributes.
 272 enum
 273 {
 274   // 0-3 are generic.
 275   Tag_CPU_raw_name = 4,
 276   Tag_CPU_name = 5,
 277   Tag_CPU_arch = 6,
 278   Tag_CPU_arch_profile = 7,
 279   Tag_ARM_ISA_use = 8,
 280   Tag_THUMB_ISA_use = 9,
 281   Tag_FP_arch = 10,
 282   Tag_WMMX_arch = 11,
 283   Tag_Advanced_SIMD_arch = 12,
 284   Tag_PCS_config = 13,
 285   Tag_ABI_PCS_R9_use = 14,
 286   Tag_ABI_PCS_RW_data = 15,
 287   Tag_ABI_PCS_RO_data = 16,
 288   Tag_ABI_PCS_GOT_use = 17,
 289   Tag_ABI_PCS_wchar_t = 18,
 290   Tag_ABI_FP_rounding = 19,
 291   Tag_ABI_FP_denormal = 20,
 292   Tag_ABI_FP_exceptions = 21,
 293   Tag_ABI_FP_user_exceptions = 22,
 294   Tag_ABI_FP_number_model = 23,
 295   Tag_ABI_align_needed = 24,
 296   Tag_ABI_align_preserved = 25,
 297   Tag_ABI_enum_size = 26,
 298   Tag_ABI_HardFP_use = 27,
 299   Tag_ABI_VFP_args = 28,
 300   Tag_ABI_WMMX_args = 29,
 301   Tag_ABI_optimization_goals = 30,
 302   Tag_ABI_FP_optimization_goals = 31,
 303   // 32 is generic (Tag_compatibility).
 304   Tag_undefined33 = 33,
 305   Tag_CPU_unaligned_access = 34,
 306   Tag_undefined35 = 35,
 307   Tag_FP_HP_extension = 36,
 308   Tag_undefined37 = 37,
 309   Tag_ABI_FP_16bit_format = 38,
 310   Tag_undefined39 = 39,
 311   Tag_undefined40 = 40,
 312   Tag_undefined41 = 41,
 313   Tag_MPextension_use = 42,
 314   Tag_undefined43 = 43,
 315   Tag_DIV_use = 44,
 316   Tag_MVE_arch = 48,
 317   Tag_PAC_extension = 50,
 318   Tag_BTI_extension = 52,
 319   Tag_BTI_use = 74,
 320   Tag_PACRET_use = 76,
 321   Tag_nodefaults = 64,
 322   Tag_also_compatible_with = 65,
 323   Tag_T2EE_use = 66,
 324   Tag_conformance = 67,
 325   Tag_Virtualization_use = 68,
 326   Tag_undefined69 = 69,
 327   Tag_MPextension_use_legacy = 70,
 328
 329   // The following tags are legacy names for other tags.
 330   Tag_VFP_arch = Tag_FP_arch,
 331   Tag_ABI_align8_needed = Tag_ABI_align_needed,
 332   Tag_ABI_align8_preserved = Tag_ABI_align_preserved,
 333   Tag_VFP_HP_extension = Tag_FP_HP_extension
 334 };
 335
 336 // Values for Tag_ABI_PCS_R9_use.
 337 enum
 338 {
 339   AEABI_R9_V6 = 0,
 340   AEABI_R9_SB = 1,
 341   AEABI_R9_TLS = 2,
 342   AEABI_R9_unused = 3
 343 };
 344
 345 // Values for Tag_ABI_PCS_RW_data.
 346 enum
 347 {
 348   AEABI_PCS_RW_data_absolute = 0,
 349   AEABI_PCS_RW_data_PCrel = 1,
 350   AEABI_PCS_RW_data_SBrel = 2,
 351   AEABI_PCS_RW_data_unused = 3
 352 };
 353
 354 // Values for Tag_ABI_enum_size.
 355 enum
 356 {
 357   AEABI_enum_unused = 0,
 358   AEABI_enum_short = 1,
 359   AEABI_enum_wide = 2,
 360   AEABI_enum_forced_wide = 3
 361 };
 362
 363 // Values for Tag_ABI_FP_number_model.
 364 enum
 365 {
 366   AEABI_FP_number_model_none = 0,
 367   AEABI_FP_number_model_ieee754_number = 1,
 368   AEABI_FP_number_model_rtabi = 2,
 369   AEABI_FP_number_model_ieee754_all = 3
 370 };
 371
 372 // Values for Tag_ABI_VFP_args.
 373 enum
 374 {
 375   AEABI_VFP_args_base = 0,
 376   AEABI_VFP_args_vfp = 1,
 377   AEABI_VFP_args_toolchain = 2,
 378   AEABI_VFP_args_compatible = 3
 379 };
 380
 381 // For Exception Index Table. (Exception handling ABI for the ARM
 382 // architectue, Section 5)
 383 enum
 384 {
 385   EXIDX_CANTUNWIND = 1,
 386 };
 387
 388 } // End namespace elfcpp.
 389
 390 #endif // !defined(ELFCPP_ARM_H)