1 // arm.h -- ELF definitions specific to EM_ARM -*- C++ -*-
3 // Copyright (C) 2009-2023 Free Software Foundation, Inc.
4 // Written by Doug Kwan <dougkwan@google.com>.
6 // This file is part of elfcpp.
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.
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.)
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.
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
35 // The relocation type information is taken from:
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
46 // ARM Relocations Codes
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.
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
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
203 // 140 - 159 Dynamic Reserved for future allocation
204 R_ARM_IRELATIVE
= 160, // Dynamic
205 // 161 - 255 Unallocated
208 // e_flags values used for ARM. We only support flags defined in AAELF.
212 EF_ARM_BE8
= 0x00800000,
214 // Mask to extract EABI version, not really a flag value.
215 EF_ARM_EABIMASK
= 0xFF000000,
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,
225 // Extract EABI version from flags.
228 arm_eabi_version(Elf_Word flags
)
229 { return flags
& EF_ARM_EABIMASK
; }
231 // EABI_VER5 e_flags values for identifying soft- and hard-float ABI
235 EF_ARM_ABI_FLOAT_SOFT
= 0x200,
236 EF_ARM_ABI_FLOAT_HARD
= 0x400,
239 // Values for the Tag_CPU_arch EABI attribute.
258 TAG_CPU_ARCH_V8M_BASE
,
259 TAG_CPU_ARCH_V8M_MAIN
,
263 TAG_CPU_ARCH_V8_1M_MAIN
,
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)
271 // EABI object attributes.
275 Tag_CPU_raw_name
= 4,
278 Tag_CPU_arch_profile
= 7,
280 Tag_THUMB_ISA_use
= 9,
283 Tag_Advanced_SIMD_arch
= 12,
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,
317 Tag_PAC_extension
= 50,
318 Tag_BTI_extension
= 52,
322 Tag_also_compatible_with
= 65,
324 Tag_conformance
= 67,
325 Tag_Virtualization_use
= 68,
326 Tag_undefined69
= 69,
327 Tag_MPextension_use_legacy
= 70,
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
336 // Values for Tag_ABI_PCS_R9_use.
345 // Values for Tag_ABI_PCS_RW_data.
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
354 // Values for Tag_ABI_enum_size.
357 AEABI_enum_unused
= 0,
358 AEABI_enum_short
= 1,
360 AEABI_enum_forced_wide
= 3
363 // Values for Tag_ABI_FP_number_model.
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
372 // Values for Tag_ABI_VFP_args.
375 AEABI_VFP_args_base
= 0,
376 AEABI_VFP_args_vfp
= 1,
377 AEABI_VFP_args_toolchain
= 2,
378 AEABI_VFP_args_compatible
= 3
381 // For Exception Index Table. (Exception handling ABI for the ARM
382 // architectue, Section 5)
385 EXIDX_CANTUNWIND
= 1,
388 } // End namespace elfcpp.
390 #endif // !defined(ELFCPP_ARM_H)