Home | History | Annotate | Download | only in elfcpp
      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 (at) 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
    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