1 // arm.h -- ELF definitions specific to EM_ARM -*- C++ -*-
2
3 // Copyright (C) 2009-2016 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 - 139 Unallocated
198 // 140 - 159 Dynamic Reserved for future allocation
199 R_ARM_IRELATIVE = 160, // Dynamic
200 // 161 - 255 Unallocated
201 };
202
203 // e_flags values used for ARM. We only support flags defined in AAELF.
204
205 enum
206 {
207 EF_ARM_BE8 = 0x00800000,
208
209 // Mask to extract EABI version, not really a flag value.
210 EF_ARM_EABIMASK = 0xFF000000,
211
212 EF_ARM_EABI_UNKNOWN = 0x00000000,
213 EF_ARM_EABI_VER1 = 0x01000000,
214 EF_ARM_EABI_VER2 = 0x02000000,
215 EF_ARM_EABI_VER3 = 0x03000000,
216 EF_ARM_EABI_VER4 = 0x04000000,
217 EF_ARM_EABI_VER5 = 0x05000000,
218 };
219
220 // Extract EABI version from flags.
221
222 inline Elf_Word
arm_eabi_version(Elf_Word flags)223 arm_eabi_version(Elf_Word flags)
224 { return flags & EF_ARM_EABIMASK; }
225
226 // EABI_VER5 e_flags values for identifying soft- and hard-float ABI
227 // choice.
228 enum
229 {
230 EF_ARM_ABI_FLOAT_SOFT = 0x200,
231 EF_ARM_ABI_FLOAT_HARD = 0x400,
232 };
233
234 // Values for the Tag_CPU_arch EABI attribute.
235 enum
236 {
237 TAG_CPU_ARCH_PRE_V4,
238 TAG_CPU_ARCH_V4,
239 TAG_CPU_ARCH_V4T,
240 TAG_CPU_ARCH_V5T,
241 TAG_CPU_ARCH_V5TE,
242 TAG_CPU_ARCH_V5TEJ,
243 TAG_CPU_ARCH_V6,
244 TAG_CPU_ARCH_V6KZ,
245 TAG_CPU_ARCH_V6T2,
246 TAG_CPU_ARCH_V6K,
247 TAG_CPU_ARCH_V7,
248 TAG_CPU_ARCH_V6_M,
249 TAG_CPU_ARCH_V6S_M,
250 TAG_CPU_ARCH_V7E_M,
251 TAG_CPU_ARCH_V8,
252 MAX_TAG_CPU_ARCH = TAG_CPU_ARCH_V8,
253 // Pseudo-architecture to allow objects to be compatible with the subset of
254 // armv4t and armv6-m. This value should never be stored in object files.
255 TAG_CPU_ARCH_V4T_PLUS_V6_M = (MAX_TAG_CPU_ARCH + 1)
256 };
257
258 // EABI object attributes.
259 enum
260 {
261 // 0-3 are generic.
262 Tag_CPU_raw_name = 4,
263 Tag_CPU_name = 5,
264 Tag_CPU_arch = 6,
265 Tag_CPU_arch_profile = 7,
266 Tag_ARM_ISA_use = 8,
267 Tag_THUMB_ISA_use = 9,
268 Tag_FP_arch = 10,
269 Tag_WMMX_arch = 11,
270 Tag_Advanced_SIMD_arch = 12,
271 Tag_PCS_config = 13,
272 Tag_ABI_PCS_R9_use = 14,
273 Tag_ABI_PCS_RW_data = 15,
274 Tag_ABI_PCS_RO_data = 16,
275 Tag_ABI_PCS_GOT_use = 17,
276 Tag_ABI_PCS_wchar_t = 18,
277 Tag_ABI_FP_rounding = 19,
278 Tag_ABI_FP_denormal = 20,
279 Tag_ABI_FP_exceptions = 21,
280 Tag_ABI_FP_user_exceptions = 22,
281 Tag_ABI_FP_number_model = 23,
282 Tag_ABI_align_needed = 24,
283 Tag_ABI_align_preserved = 25,
284 Tag_ABI_enum_size = 26,
285 Tag_ABI_HardFP_use = 27,
286 Tag_ABI_VFP_args = 28,
287 Tag_ABI_WMMX_args = 29,
288 Tag_ABI_optimization_goals = 30,
289 Tag_ABI_FP_optimization_goals = 31,
290 // 32 is generic (Tag_compatibility).
291 Tag_undefined33 = 33,
292 Tag_CPU_unaligned_access = 34,
293 Tag_undefined35 = 35,
294 Tag_FP_HP_extension = 36,
295 Tag_undefined37 = 37,
296 Tag_ABI_FP_16bit_format = 38,
297 Tag_undefined39 = 39,
298 Tag_undefined40 = 40,
299 Tag_undefined41 = 41,
300 Tag_MPextension_use = 42,
301 Tag_undefined43 = 43,
302 Tag_DIV_use = 44,
303 Tag_nodefaults = 64,
304 Tag_also_compatible_with = 65,
305 Tag_T2EE_use = 66,
306 Tag_conformance = 67,
307 Tag_Virtualization_use = 68,
308 Tag_undefined69 = 69,
309 Tag_MPextension_use_legacy = 70,
310
311 // The following tags are legacy names for other tags.
312 Tag_VFP_arch = Tag_FP_arch,
313 Tag_ABI_align8_needed = Tag_ABI_align_needed,
314 Tag_ABI_align8_preserved = Tag_ABI_align_preserved,
315 Tag_VFP_HP_extension = Tag_FP_HP_extension
316 };
317
318 // Values for Tag_ABI_PCS_R9_use.
319 enum
320 {
321 AEABI_R9_V6 = 0,
322 AEABI_R9_SB = 1,
323 AEABI_R9_TLS = 2,
324 AEABI_R9_unused = 3
325 };
326
327 // Values for Tag_ABI_PCS_RW_data.
328 enum
329 {
330 AEABI_PCS_RW_data_absolute = 0,
331 AEABI_PCS_RW_data_PCrel = 1,
332 AEABI_PCS_RW_data_SBrel = 2,
333 AEABI_PCS_RW_data_unused = 3
334 };
335
336 // Values for Tag_ABI_enum_size.
337 enum
338 {
339 AEABI_enum_unused = 0,
340 AEABI_enum_short = 1,
341 AEABI_enum_wide = 2,
342 AEABI_enum_forced_wide = 3
343 };
344
345 // Values for Tag_ABI_FP_number_model.
346 enum
347 {
348 AEABI_FP_number_model_none = 0,
349 AEABI_FP_number_model_ieee754_number = 1,
350 AEABI_FP_number_model_rtabi = 2,
351 AEABI_FP_number_model_ieee754_all = 3
352 };
353
354 // Values for Tag_ABI_VFP_args.
355 enum
356 {
357 AEABI_VFP_args_base = 0,
358 AEABI_VFP_args_vfp = 1,
359 AEABI_VFP_args_toolchain = 2,
360 AEABI_VFP_args_compatible = 3
361 };
362
363 // For Exception Index Table. (Exception handling ABI for the ARM
364 // architectue, Section 5)
365 enum
366 {
367 EXIDX_CANTUNWIND = 1,
368 };
369
370 } // End namespace elfcpp.
371
372 #endif // !defined(ELFCPP_ARM_H)
373