1// arm.h -- ELF definitions specific to EM_ARM -*- C++ -*- 2 3// Copyright (C) 2009-2022 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 42namespace 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 61enum 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 210enum 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 227inline Elf_Word 228arm_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. 233enum 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. 240enum 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. 272enum 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. 337enum 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. 346enum 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. 355enum 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. 364enum 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. 373enum 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) 383enum 384{ 385 EXIDX_CANTUNWIND = 1, 386}; 387 388} // End namespace elfcpp. 389 390#endif // !defined(ELFCPP_ARM_H) 391