1 /* ARM ELF support for BFD.
2 Copyright (C) 1998-2025 Free Software Foundation, Inc.
4 This file is part of BFD, the Binary File Descriptor library.
6 This program is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 3 of the License, or
9 (at your option) any later version.
11 This program is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with this program; if not, write to the Free Software Foundation,
18 Inc., 51 Franklin Street - Fifth Floor, Boston, MA 02110-1301, USA. */
23 #include "elf/reloc-macros.h"
25 /* Processor specific flags for the ELF header e_flags field. */
27 /* Old ABI (ie GNU pre EABI). These are deprecated. */
28 #define EF_ARM_RELEXEC 0x01
29 #define EF_ARM_INTERWORK 0x04
30 #define EF_ARM_APCS_26 0x08
31 #define EF_ARM_APCS_FLOAT 0x10
32 #define EF_ARM_PIC 0x20
33 #define EF_ARM_ALIGN8 0x40 /* 8-bit structure alignment is in use. */
34 #define EF_ARM_NEW_ABI 0x80
35 #define EF_ARM_OLD_ABI 0x100
36 #define EF_ARM_SOFT_FLOAT 0x200
37 #define EF_ARM_VFP_FLOAT 0x400
38 /* Removed, was EF_ARM_MAVERICK_FLOAT 0x800 */
40 #define PT_ARM_ARCHEXT (PT_LOPROC + 0)
41 /* Frame unwind information */
42 #define PT_ARM_EXIDX (PT_LOPROC + 1)
44 /* Old ARM ELF spec. version B-01. Mostly deprecated. */
45 #define EF_ARM_SYMSARESORTED 0x04 /* NB conflicts with EF_INTERWORK. */
46 #define EF_ARM_DYNSYMSUSESEGIDX 0x08 /* NB conflicts with EF_APCS26. */
47 #define EF_ARM_MAPSYMSFIRST 0x10 /* NB conflicts with EF_APCS_FLOAT. */
49 /* New constants defined in the ARM ELF spec. version XXX (AAELF).
50 Only valid in conjunction with EF_ARM_EABI_VER5. */
51 #define EF_ARM_ABI_FLOAT_SOFT 0x200 /* NB conflicts with EF_ARM_SOFT_FLOAT. */
52 #define EF_ARM_ABI_FLOAT_HARD 0x400 /* NB conflicts with EF_ARM_VFP_FLOAT. */
54 /* Constants defined in AAELF. */
55 #define EF_ARM_BE8 0x00800000
56 #define EF_ARM_LE8 0x00400000
58 #define EF_ARM_EABIMASK 0xFF000000
59 #define EF_ARM_EABI_VERSION(flags) ((flags) & EF_ARM_EABIMASK)
60 #define EF_ARM_EABI_UNKNOWN 0x00000000
61 #define EF_ARM_EABI_VER1 0x01000000
62 #define EF_ARM_EABI_VER2 0x02000000
63 #define EF_ARM_EABI_VER3 0x03000000
64 #define EF_ARM_EABI_VER4 0x04000000
65 #define EF_ARM_EABI_VER5 0x05000000
67 /* Local aliases for some flags to match names used by COFF port. */
68 #define F_INTERWORK EF_ARM_INTERWORK
69 #define F_APCS26 EF_ARM_APCS_26
70 #define F_APCS_FLOAT EF_ARM_APCS_FLOAT
71 #define F_PIC EF_ARM_PIC
72 #define F_SOFT_FLOAT EF_ARM_SOFT_FLOAT
73 #define F_VFP_FLOAT EF_ARM_VFP_FLOAT
75 /* Additional symbol types for Thumb. */
76 #define STT_ARM_TFUNC STT_LOPROC /* A Thumb function. */
77 #define STT_ARM_16BIT STT_HIPROC /* A Thumb label. */
79 /* Additional section types. */
80 #define SHT_ARM_EXIDX (SHT_LOPROC + 1) /* Section holds ARM unwind info. */
81 #define SHT_ARM_PREEMPTMAP (SHT_LOPROC + 2) /* Section pre-emption details. */
82 #define SHT_ARM_ATTRIBUTES (SHT_LOPROC + 3) /* Section holds attributes. */
83 #define SHT_ARM_DEBUGOVERLAY (SHT_LOPROC + 4) /* Section holds overlay debug info. */
84 #define SHT_ARM_OVERLAYSECTION (SHT_LOPROC + 5) /* Section holds GDB and overlay integration info. */
86 /* ARM-specific values for sh_flags. */
87 #define SHF_ENTRYSECT 0x10000000 /* Section contains an entry point. */
88 #define SHF_ARM_PURECODE 0x20000000 /* Section contains only code and no data. */
89 #define SHF_COMDEF 0x80000000 /* Section may be multiply defined in the input to a link step. */
91 /* ARM-specific program header flags. */
92 #define PF_ARM_SB 0x10000000 /* Segment contains the location addressed by the static base. */
93 #define PF_ARM_PI 0x20000000 /* Segment is position-independent. */
94 #define PF_ARM_ABS 0x40000000 /* Segment must be loaded at its base address. */
96 /* Values for the Tag_CPU_arch EABI attribute. */
97 #define TAG_CPU_ARCH_PRE_V4 0
98 #define TAG_CPU_ARCH_V4 1
99 #define TAG_CPU_ARCH_V4T 2
100 #define TAG_CPU_ARCH_V5T 3
101 #define TAG_CPU_ARCH_V5TE 4
102 #define TAG_CPU_ARCH_V5TEJ 5
103 #define TAG_CPU_ARCH_V6 6
104 #define TAG_CPU_ARCH_V6KZ 7
105 #define TAG_CPU_ARCH_V6T2 8
106 #define TAG_CPU_ARCH_V6K 9
107 #define TAG_CPU_ARCH_V7 10
108 #define TAG_CPU_ARCH_V6_M 11
109 #define TAG_CPU_ARCH_V6S_M 12
110 #define TAG_CPU_ARCH_V7E_M 13
111 #define TAG_CPU_ARCH_V8 14
112 #define TAG_CPU_ARCH_V8R 15
113 #define TAG_CPU_ARCH_V8M_BASE 16
114 #define TAG_CPU_ARCH_V8M_MAIN 17
115 #define TAG_CPU_ARCH_8_1A 18
116 #define TAG_CPU_ARCH_8_2A 19
117 #define TAG_CPU_ARCH_8_3A 20
118 #define TAG_CPU_ARCH_V8_1M_MAIN 21
119 #define TAG_CPU_ARCH_V9 22
120 #define MAX_TAG_CPU_ARCH TAG_CPU_ARCH_V9
121 /* Pseudo-architecture to allow objects to be compatible with the subset of
122 armv4t and armv6-m. This value should never be stored in object files. */
123 #define TAG_CPU_ARCH_V4T_PLUS_V6_M (MAX_TAG_CPU_ARCH + 1)
125 /* Relocation types. */
127 START_RELOC_NUMBERS (elf_arm_reloc_type
)
128 /* AAELF official names and numbers. */
129 RELOC_NUMBER (R_ARM_NONE
, 0)
130 RELOC_NUMBER (R_ARM_PC24
, 1) /* deprecated */
131 RELOC_NUMBER (R_ARM_ABS32
, 2)
132 RELOC_NUMBER (R_ARM_REL32
, 3)
133 RELOC_NUMBER (R_ARM_LDR_PC_G0
, 4)
134 RELOC_NUMBER (R_ARM_ABS16
, 5)
135 RELOC_NUMBER (R_ARM_ABS12
, 6)
136 RELOC_NUMBER (R_ARM_THM_ABS5
, 7)
137 RELOC_NUMBER (R_ARM_ABS8
, 8)
138 RELOC_NUMBER (R_ARM_SBREL32
, 9)
139 RELOC_NUMBER (R_ARM_THM_CALL
, 10)
140 RELOC_NUMBER (R_ARM_THM_PC8
, 11)
141 RELOC_NUMBER (R_ARM_BREL_ADJ
, 12)
142 RELOC_NUMBER (R_ARM_TLS_DESC
, 13)
143 RELOC_NUMBER (R_ARM_THM_SWI8
, 14) /* obsolete */
144 RELOC_NUMBER (R_ARM_XPC25
, 15) /* obsolete */
145 RELOC_NUMBER (R_ARM_THM_XPC22
, 16) /* obsolete */
146 RELOC_NUMBER (R_ARM_TLS_DTPMOD32
, 17)
147 RELOC_NUMBER (R_ARM_TLS_DTPOFF32
, 18)
148 RELOC_NUMBER (R_ARM_TLS_TPOFF32
, 19)
149 RELOC_NUMBER (R_ARM_COPY
, 20) /* Copy symbol at runtime. */
150 RELOC_NUMBER (R_ARM_GLOB_DAT
, 21) /* Create GOT entry. */
151 RELOC_NUMBER (R_ARM_JUMP_SLOT
, 22) /* Create PLT entry. */
152 RELOC_NUMBER (R_ARM_RELATIVE
, 23) /* Adjust by program base. */
153 RELOC_NUMBER (R_ARM_GOTOFF32
, 24) /* 32 bit offset to GOT. */
154 RELOC_NUMBER (R_ARM_BASE_PREL
, 25) /* 32 bit PC relative offset to GOT. */
155 RELOC_NUMBER (R_ARM_GOT_BREL
, 26) /* 32 bit GOT entry. */
156 RELOC_NUMBER (R_ARM_PLT32
, 27) /* deprecated - 32 bit PLT address. */
157 RELOC_NUMBER (R_ARM_CALL
, 28)
158 RELOC_NUMBER (R_ARM_JUMP24
, 29)
159 RELOC_NUMBER (R_ARM_THM_JUMP24
, 30)
160 RELOC_NUMBER (R_ARM_BASE_ABS
, 31)
161 RELOC_NUMBER (R_ARM_ALU_PCREL7_0
, 32) /* obsolete */
162 RELOC_NUMBER (R_ARM_ALU_PCREL15_8
, 33) /* obsolete */
163 RELOC_NUMBER (R_ARM_ALU_PCREL23_15
, 34) /* obsolete */
164 RELOC_NUMBER (R_ARM_LDR_SBREL_11_0
, 35) /* deprecated, should have _NC suffix */
165 RELOC_NUMBER (R_ARM_ALU_SBREL_19_12
, 36) /* deprecated, should have _NC suffix */
166 RELOC_NUMBER (R_ARM_ALU_SBREL_27_20
, 37) /* deprecated, should have _CK suffix */
167 RELOC_NUMBER (R_ARM_TARGET1
, 38)
168 RELOC_NUMBER (R_ARM_SBREL31
, 39) /* deprecated */
169 RELOC_NUMBER (R_ARM_V4BX
, 40)
170 RELOC_NUMBER (R_ARM_TARGET2
, 41)
171 RELOC_NUMBER (R_ARM_PREL31
, 42)
172 RELOC_NUMBER (R_ARM_MOVW_ABS_NC
, 43)
173 RELOC_NUMBER (R_ARM_MOVT_ABS
, 44)
174 RELOC_NUMBER (R_ARM_MOVW_PREL_NC
, 45)
175 RELOC_NUMBER (R_ARM_MOVT_PREL
, 46)
176 RELOC_NUMBER (R_ARM_THM_MOVW_ABS_NC
, 47)
177 RELOC_NUMBER (R_ARM_THM_MOVT_ABS
, 48)
178 RELOC_NUMBER (R_ARM_THM_MOVW_PREL_NC
, 49)
179 RELOC_NUMBER (R_ARM_THM_MOVT_PREL
, 50)
180 RELOC_NUMBER (R_ARM_THM_JUMP19
, 51)
181 RELOC_NUMBER (R_ARM_THM_JUMP6
, 52)
182 RELOC_NUMBER (R_ARM_THM_ALU_PREL_11_0
, 53)
183 RELOC_NUMBER (R_ARM_THM_PC12
, 54)
184 RELOC_NUMBER (R_ARM_ABS32_NOI
, 55)
185 RELOC_NUMBER (R_ARM_REL32_NOI
, 56)
186 RELOC_NUMBER (R_ARM_ALU_PC_G0_NC
, 57)
187 RELOC_NUMBER (R_ARM_ALU_PC_G0
, 58)
188 RELOC_NUMBER (R_ARM_ALU_PC_G1_NC
, 59)
189 RELOC_NUMBER (R_ARM_ALU_PC_G1
, 60)
190 RELOC_NUMBER (R_ARM_ALU_PC_G2
, 61)
191 RELOC_NUMBER (R_ARM_LDR_PC_G1
, 62)
192 RELOC_NUMBER (R_ARM_LDR_PC_G2
, 63)
193 RELOC_NUMBER (R_ARM_LDRS_PC_G0
, 64)
194 RELOC_NUMBER (R_ARM_LDRS_PC_G1
, 65)
195 RELOC_NUMBER (R_ARM_LDRS_PC_G2
, 66)
196 RELOC_NUMBER (R_ARM_LDC_PC_G0
, 67)
197 RELOC_NUMBER (R_ARM_LDC_PC_G1
, 68)
198 RELOC_NUMBER (R_ARM_LDC_PC_G2
, 69)
199 RELOC_NUMBER (R_ARM_ALU_SB_G0_NC
, 70)
200 RELOC_NUMBER (R_ARM_ALU_SB_G0
, 71)
201 RELOC_NUMBER (R_ARM_ALU_SB_G1_NC
, 72)
202 RELOC_NUMBER (R_ARM_ALU_SB_G1
, 73)
203 RELOC_NUMBER (R_ARM_ALU_SB_G2
, 74)
204 RELOC_NUMBER (R_ARM_LDR_SB_G0
, 75)
205 RELOC_NUMBER (R_ARM_LDR_SB_G1
, 76)
206 RELOC_NUMBER (R_ARM_LDR_SB_G2
, 77)
207 RELOC_NUMBER (R_ARM_LDRS_SB_G0
, 78)
208 RELOC_NUMBER (R_ARM_LDRS_SB_G1
, 79)
209 RELOC_NUMBER (R_ARM_LDRS_SB_G2
, 80)
210 RELOC_NUMBER (R_ARM_LDC_SB_G0
, 81)
211 RELOC_NUMBER (R_ARM_LDC_SB_G1
, 82)
212 RELOC_NUMBER (R_ARM_LDC_SB_G2
, 83)
213 RELOC_NUMBER (R_ARM_MOVW_BREL_NC
, 84)
214 RELOC_NUMBER (R_ARM_MOVT_BREL
, 85)
215 RELOC_NUMBER (R_ARM_MOVW_BREL
, 86)
216 RELOC_NUMBER (R_ARM_THM_MOVW_BREL_NC
, 87)
217 RELOC_NUMBER (R_ARM_THM_MOVT_BREL
, 88)
218 RELOC_NUMBER (R_ARM_THM_MOVW_BREL
, 89)
219 RELOC_NUMBER (R_ARM_TLS_GOTDESC
, 90)
220 RELOC_NUMBER (R_ARM_TLS_CALL
, 91)
221 RELOC_NUMBER (R_ARM_TLS_DESCSEQ
, 92)
222 RELOC_NUMBER (R_ARM_THM_TLS_CALL
, 93)
223 RELOC_NUMBER (R_ARM_PLT32_ABS
, 94)
224 RELOC_NUMBER (R_ARM_GOT_ABS
, 95)
225 RELOC_NUMBER (R_ARM_GOT_PREL
, 96)
226 RELOC_NUMBER (R_ARM_GOT_BREL12
, 97)
227 RELOC_NUMBER (R_ARM_GOTOFF12
, 98)
228 RELOC_NUMBER (R_ARM_GOTRELAX
, 99)
229 RELOC_NUMBER (R_ARM_GNU_VTENTRY
, 100) /* deprecated - old C++ abi */
230 RELOC_NUMBER (R_ARM_GNU_VTINHERIT
, 101) /* deprecated - old C++ abi */
231 RELOC_NUMBER (R_ARM_THM_JUMP11
, 102)
232 RELOC_NUMBER (R_ARM_THM_JUMP8
, 103)
233 RELOC_NUMBER (R_ARM_TLS_GD32
, 104)
234 RELOC_NUMBER (R_ARM_TLS_LDM32
, 105)
235 RELOC_NUMBER (R_ARM_TLS_LDO32
, 106)
236 RELOC_NUMBER (R_ARM_TLS_IE32
, 107)
237 RELOC_NUMBER (R_ARM_TLS_LE32
, 108)
238 RELOC_NUMBER (R_ARM_TLS_LDO12
, 109)
239 RELOC_NUMBER (R_ARM_TLS_LE12
, 110)
240 RELOC_NUMBER (R_ARM_TLS_IE12GP
, 111)
241 /* 112 - 127 private range */
242 RELOC_NUMBER (R_ARM_ME_TOO
, 128) /* obsolete */
243 RELOC_NUMBER (R_ARM_THM_TLS_DESCSEQ
,129)
245 RELOC_NUMBER (R_ARM_THM_ALU_ABS_G0_NC
,132)
246 RELOC_NUMBER (R_ARM_THM_ALU_ABS_G1_NC
,133)
247 RELOC_NUMBER (R_ARM_THM_ALU_ABS_G2_NC
,134)
248 RELOC_NUMBER (R_ARM_THM_ALU_ABS_G3_NC
,135)
249 RELOC_NUMBER (R_ARM_THM_BF16
, 136)
250 RELOC_NUMBER (R_ARM_THM_BF12
, 137)
251 RELOC_NUMBER (R_ARM_THM_BF18
, 138)
253 RELOC_NUMBER (R_ARM_IRELATIVE
, 160)
254 RELOC_NUMBER (R_ARM_GOTFUNCDESC
, 161)
255 RELOC_NUMBER (R_ARM_GOTOFFFUNCDESC
, 162)
256 RELOC_NUMBER (R_ARM_FUNCDESC
, 163)
257 RELOC_NUMBER (R_ARM_FUNCDESC_VALUE
, 164)
258 RELOC_NUMBER (R_ARM_TLS_GD32_FDPIC
, 165)
259 RELOC_NUMBER (R_ARM_TLS_LDM32_FDPIC
, 166)
260 RELOC_NUMBER (R_ARM_TLS_IE32_FDPIC
, 167)
262 /* Extensions? R=read-only? */
263 RELOC_NUMBER (R_ARM_RXPC25
, 249)
264 RELOC_NUMBER (R_ARM_RSBREL32
, 250)
265 RELOC_NUMBER (R_ARM_THM_RPC22
, 251)
266 RELOC_NUMBER (R_ARM_RREL32
, 252)
267 RELOC_NUMBER (R_ARM_RABS32
, 253)
268 RELOC_NUMBER (R_ARM_RPC24
, 254)
269 RELOC_NUMBER (R_ARM_RBASE
, 255)
271 /* Unofficial names for some of the relocs. */
272 FAKE_RELOC (R_ARM_GOTOFF
, R_ARM_GOTOFF32
) /* 32 bit offset to GOT. */
273 FAKE_RELOC (R_ARM_THM_PC22
, R_ARM_THM_CALL
)
274 FAKE_RELOC (R_ARM_THM_PC11
, R_ARM_THM_JUMP11
)
275 FAKE_RELOC (R_ARM_THM_PC9
, R_ARM_THM_JUMP8
)
277 /* Relocs with both a different name, and (apparently) different meaning in
279 FAKE_RELOC (R_ARM_GOTPC
, R_ARM_BASE_PREL
) /* 32 bit PC relative offset to GOT. */
280 FAKE_RELOC (R_ARM_GOT32
, R_ARM_GOT_BREL
) /* 32 bit GOT entry. */
281 FAKE_RELOC (R_ARM_ROSEGREL32
, R_ARM_SBREL31
) /* ??? */
282 FAKE_RELOC (R_ARM_AMP_VCALL9
, R_ARM_BREL_ADJ
) /* Thumb-something. Not used. */
284 END_RELOC_NUMBERS (R_ARM_max
= 256)
287 /* EABI object attributes. */
291 /* 0-3 are generic. */
292 Tag_CPU_raw_name
= 4,
295 Tag_CPU_arch_profile
,
300 Tag_Advanced_SIMD_arch
,
309 Tag_ABI_FP_exceptions
,
310 Tag_ABI_FP_user_exceptions
,
311 Tag_ABI_FP_number_model
,
312 Tag_ABI_align_needed
,
313 Tag_ABI_align_preserved
,
318 Tag_ABI_optimization_goals
,
319 Tag_ABI_FP_optimization_goals
,
320 /* 32 is generic (Tag_compatibility). */
321 Tag_undefined33
= 33,
322 Tag_CPU_unaligned_access
,
326 Tag_ABI_FP_16bit_format
,
333 Tag_DSP_extension
= 46,
335 Tag_PAC_extension
= 50,
336 Tag_BTI_extension
= 52,
340 Tag_also_compatible_with
,
343 Tag_Virtualization_use
,
345 Tag_MPextension_use_legacy
,
347 /* The following tags are legacy names for other tags. */
348 Tag_VFP_arch
= Tag_FP_arch
,
349 Tag_ABI_align8_needed
= Tag_ABI_align_needed
,
350 Tag_ABI_align8_preserved
= Tag_ABI_align_preserved
,
351 Tag_VFP_HP_extension
= Tag_FP_HP_extension
354 /* Values for Tag_ABI_FP_number_model. */
357 AEABI_FP_number_model_none
= 0,
358 AEABI_FP_number_model_ieee754_number
= 1,
359 AEABI_FP_number_model_rtabi
= 2,
360 AEABI_FP_number_model_ieee754_all
= 3
363 /* Values for Tag_ABI_VFP_args. */
366 AEABI_VFP_args_base
= 0,
367 AEABI_VFP_args_vfp
= 1,
368 AEABI_VFP_args_toolchain
= 2,
369 AEABI_VFP_args_compatible
= 3
373 /* The name of the note section used to identify arm variants. */
374 #define ARM_NOTE_SECTION ".note.gnu.arm.ident"
376 /* Special section names. */
377 #define ELF_STRING_ARM_unwind ".ARM.exidx"
378 #define ELF_STRING_ARM_unwind_info ".ARM.extab"
379 #define ELF_STRING_ARM_unwind_once ".gnu.linkonce.armexidx."
380 #define ELF_STRING_ARM_unwind_info_once ".gnu.linkonce.armextab."
382 enum arm_st_branch_type
{
390 #define NUM_ENUM_ARM_ST_BRANCH_TYPE_BITS 2
391 #define ENUM_ARM_ST_BRANCH_TYPE_BITMASK \
392 ((1 << NUM_ENUM_ARM_ST_BRANCH_TYPE_BITS) - 1)
394 #define ARM_GET_SYM_BRANCH_TYPE(STI) \
395 ((enum arm_st_branch_type) ((STI) & ENUM_ARM_ST_BRANCH_TYPE_BITMASK))
397 #define ARM_SET_SYM_BRANCH_TYPE(STI, TYPE) \
399 BFD_ASSERT (TYPE <= ST_BRANCH_ENUM_SIZE); \
400 BFD_ASSERT ((1 << NUM_ENUM_ARM_ST_BRANCH_TYPE_BITS) \
401 >= ST_BRANCH_ENUM_SIZE); \
402 (STI) = (((STI) & ~ENUM_ARM_ST_BRANCH_TYPE_BITMASK) \
403 | ((TYPE) & ENUM_ARM_ST_BRANCH_TYPE_BITMASK)); \
406 #define ARM_SET_SYM_BRANCH_TYPE(STI, TYPE) \
407 (STI) = (((STI) & ~ENUM_ARM_ST_BRANCH_TYPE_BITMASK) \
408 | ((TYPE) & ENUM_ARM_ST_BRANCH_TYPE_BITMASK))
411 #endif /* _ELF_ARM_H */