aboutsummaryrefslogtreecommitdiffstats
path: root/contrib/libs/llvm16/include/llvm/Support/ARMBuildAttributes.h
blob: b0b793bf2c70f8df62c1ce1eccbacd2bb643239d (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
#pragma once

#ifdef __GNUC__
#pragma GCC diagnostic push
#pragma GCC diagnostic ignored "-Wunused-parameter"
#endif

//===-- ARMBuildAttributes.h - ARM Build Attributes -------------*- C++ -*-===//
//
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
// See https://llvm.org/LICENSE.txt for license information.
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
//
//===----------------------------------------------------------------------===//
//
// This file contains enumerations and support routines for ARM build attributes
// as defined in ARM ABI addenda document (ABI release 2.08).
//
// ELF for the ARM Architecture r2.09 - November 30, 2012
//
// http://infocenter.arm.com/help/topic/com.arm.doc.ihi0044e/IHI0044E_aaelf.pdf
//
//===----------------------------------------------------------------------===//

#ifndef LLVM_SUPPORT_ARMBUILDATTRIBUTES_H
#define LLVM_SUPPORT_ARMBUILDATTRIBUTES_H

#include "llvm/Support/ELFAttributes.h"

namespace llvm {
namespace ARMBuildAttrs {

const TagNameMap &getARMAttributeTags();

enum SpecialAttr {
  // This is for the .cpu asm attr. It translates into one or more
  // AttrType (below) entries in the .ARM.attributes section in the ELF.
  SEL_CPU
};

enum AttrType : unsigned {
  // Rest correspond to ELF/.ARM.attributes
  File = 1,
  CPU_raw_name = 4,
  CPU_name = 5,
  CPU_arch = 6,
  CPU_arch_profile = 7,
  ARM_ISA_use = 8,
  THUMB_ISA_use = 9,
  FP_arch = 10,
  WMMX_arch = 11,
  Advanced_SIMD_arch = 12,
  PCS_config = 13,
  ABI_PCS_R9_use = 14,
  ABI_PCS_RW_data = 15,
  ABI_PCS_RO_data = 16,
  ABI_PCS_GOT_use = 17,
  ABI_PCS_wchar_t = 18,
  ABI_FP_rounding = 19,
  ABI_FP_denormal = 20,
  ABI_FP_exceptions = 21,
  ABI_FP_user_exceptions = 22,
  ABI_FP_number_model = 23,
  ABI_align_needed = 24,
  ABI_align_preserved = 25,
  ABI_enum_size = 26,
  ABI_HardFP_use = 27,
  ABI_VFP_args = 28,
  ABI_WMMX_args = 29,
  ABI_optimization_goals = 30,
  ABI_FP_optimization_goals = 31,
  compatibility = 32,
  CPU_unaligned_access = 34,
  FP_HP_extension = 36,
  ABI_FP_16bit_format = 38,
  MPextension_use = 42, // recoded from 70 (ABI r2.08)
  DIV_use = 44,
  DSP_extension = 46,
  MVE_arch = 48,
  PAC_extension = 50,
  BTI_extension = 52,
  also_compatible_with = 65,
  conformance = 67,
  Virtualization_use = 68,
  BTI_use = 74,
  PACRET_use = 76,

  /// Legacy Tags
  Section = 2,               // deprecated (ABI r2.09)
  Symbol = 3,                // deprecated (ABI r2.09)
  ABI_align8_needed = 24,    // renamed to ABI_align_needed (ABI r2.09)
  ABI_align8_preserved = 25, // renamed to ABI_align_preserved (ABI r2.09)
  nodefaults = 64,           // deprecated (ABI r2.09)
  T2EE_use = 66,             // deprecated (ABI r2.09)
  MPextension_use_old = 70   // recoded to MPextension_use (ABI r2.08)
};

// Legal Values for CPU_arch, (=6), uleb128
enum CPUArch {
  Pre_v4 = 0,
  v4 = 1,           // e.g. SA110
  v4T = 2,          // e.g. ARM7TDMI
  v5T = 3,          // e.g. ARM9TDMI
  v5TE = 4,         // e.g. ARM946E_S
  v5TEJ = 5,        // e.g. ARM926EJ_S
  v6 = 6,           // e.g. ARM1136J_S
  v6KZ = 7,         // e.g. ARM1176JZ_S
  v6T2 = 8,         // e.g. ARM1156T2_S
  v6K = 9,          // e.g. ARM1176JZ_S
  v7 = 10,          // e.g. Cortex A8, Cortex M3
  v6_M = 11,        // e.g. Cortex M1
  v6S_M = 12,       // v6_M with the System extensions
  v7E_M = 13,       // v7_M with DSP extensions
  v8_A = 14,        // v8_A AArch32
  v8_R = 15,        // e.g. Cortex R52
  v8_M_Base = 16,   // v8_M_Base AArch32
  v8_M_Main = 17,   // v8_M_Main AArch32
  v8_1_M_Main = 21, // v8_1_M_Main AArch32
  v9_A = 22,        // v9_A AArch32
};

enum CPUArchProfile {               // (=7), uleb128
  Not_Applicable          = 0,      // pre v7, or cross-profile code
  ApplicationProfile      = (0x41), // 'A' (e.g. for Cortex A8)
  RealTimeProfile         = (0x52), // 'R' (e.g. for Cortex R4)
  MicroControllerProfile  = (0x4D), // 'M' (e.g. for Cortex M3)
  SystemProfile           = (0x53)  // 'S' Application or real-time profile
};

// The following have a lot of common use cases
enum {
  Not_Allowed = 0,
  Allowed = 1,

  // Tag_ARM_ISA_use (=8), uleb128

  // Tag_THUMB_ISA_use, (=9), uleb128
  AllowThumb32 = 2, // 32-bit Thumb (implies 16-bit instructions)
  AllowThumbDerived = 3, // Thumb allowed, derived from arch/profile

  // Tag_FP_arch (=10), uleb128 (formerly Tag_VFP_arch = 10)
  AllowFPv2  = 2,     // v2 FP ISA permitted (implies use of the v1 FP ISA)
  AllowFPv3A = 3,     // v3 FP ISA permitted (implies use of the v2 FP ISA)
  AllowFPv3B = 4,     // v3 FP ISA permitted, but only D0-D15, S0-S31
  AllowFPv4A = 5,     // v4 FP ISA permitted (implies use of v3 FP ISA)
  AllowFPv4B = 6,     // v4 FP ISA was permitted, but only D0-D15, S0-S31
  AllowFPARMv8A = 7,  // Use of the ARM v8-A FP ISA was permitted
  AllowFPARMv8B = 8,  // Use of the ARM v8-A FP ISA was permitted, but only
                      // D0-D15, S0-S31

  // Tag_WMMX_arch, (=11), uleb128
  AllowWMMXv1 = 1,  // The user permitted this entity to use WMMX v1
  AllowWMMXv2 = 2,  // The user permitted this entity to use WMMX v2

  // Tag_Advanced_SIMD_arch, (=12), uleb128
  AllowNeon = 1,      // SIMDv1 was permitted
  AllowNeon2 = 2,     // SIMDv2 was permitted (Half-precision FP, MAC operations)
  AllowNeonARMv8 = 3, // ARM v8-A SIMD was permitted
  AllowNeonARMv8_1a = 4,// ARM v8.1-A SIMD was permitted (RDMA)

  // Tag_MVE_arch, (=48), uleb128
  AllowMVEInteger = 1, // integer-only MVE was permitted
  AllowMVEIntegerAndFloat = 2, // both integer and floating point MVE were permitted

  // Tag_ABI_PCS_R9_use, (=14), uleb128
  R9IsGPR = 0,        // R9 used as v6 (just another callee-saved register)
  R9IsSB = 1,         // R9 used as a global static base rgister
  R9IsTLSPointer = 2, // R9 used as a thread local storage pointer
  R9Reserved = 3,     // R9 not used by code associated with attributed entity

  // Tag_ABI_PCS_RW_data, (=15), uleb128
  AddressRWPCRel = 1, // Address RW static data PC-relative
  AddressRWSBRel = 2, // Address RW static data SB-relative
  AddressRWNone = 3, // No RW static data permitted

  // Tag_ABI_PCS_RO_data, (=14), uleb128
  AddressROPCRel = 1, // Address RO static data PC-relative
  AddressRONone = 2, // No RO static data permitted

  // Tag_ABI_PCS_GOT_use, (=17), uleb128
  AddressDirect = 1, // Address imported data directly
  AddressGOT = 2, // Address imported data indirectly (via GOT)

  // Tag_ABI_PCS_wchar_t, (=18), uleb128
  WCharProhibited = 0,  // wchar_t is not used
  WCharWidth2Bytes = 2, // sizeof(wchar_t) == 2
  WCharWidth4Bytes = 4, // sizeof(wchar_t) == 4

  // Tag_ABI_align_needed, (=24), uleb128
  Align8Byte = 1,
  Align4Byte = 2,
  AlignReserved = 3,

  // Tag_ABI_align_needed, (=25), uleb128
  AlignNotPreserved = 0,
  AlignPreserve8Byte = 1,
  AlignPreserveAll = 2,

  // Tag_ABI_FP_denormal, (=20), uleb128
  PositiveZero = 0,
  IEEEDenormals = 1,
  PreserveFPSign = 2, // sign when flushed-to-zero is preserved

  // Tag_ABI_FP_number_model, (=23), uleb128
  AllowIEEENormal = 1,
  AllowRTABI = 2,  // numbers, infinities, and one quiet NaN (see [RTABI])
  AllowIEEE754 = 3, // this code to use all the IEEE 754-defined FP encodings

  // Tag_ABI_enum_size, (=26), uleb128
  EnumProhibited = 0, // The user prohibited the use of enums when building
                      // this entity.
  EnumSmallest = 1,   // Enum is smallest container big enough to hold all
                      // values.
  Enum32Bit = 2,      // Enum is at least 32 bits.
  Enum32BitABI = 3,   // Every enumeration visible across an ABI-complying
                      // interface contains a value needing 32 bits to encode
                      // it; other enums can be containerized.

  // Tag_ABI_HardFP_use, (=27), uleb128
  HardFPImplied = 0,          // FP use should be implied by Tag_FP_arch
  HardFPSinglePrecision = 1,  // Single-precision only

  // Tag_ABI_VFP_args, (=28), uleb128
  BaseAAPCS = 0,
  HardFPAAPCS = 1,
  ToolChainFPPCS = 2,
  CompatibleFPAAPCS = 3,

  // Tag_FP_HP_extension, (=36), uleb128
  AllowHPFP = 1, // Allow use of Half Precision FP

  // Tag_FP_16bit_format, (=38), uleb128
  FP16FormatIEEE = 1,
  FP16VFP3 = 2,

  // Tag_MPextension_use, (=42), uleb128
  AllowMP = 1, // Allow use of MP extensions

  // Tag_DIV_use, (=44), uleb128
  // Note: AllowDIVExt must be emitted if and only if the permission to use
  // hardware divide cannot be conveyed using AllowDIVIfExists or DisallowDIV
  AllowDIVIfExists = 0, // Allow hardware divide if available in arch, or no
                        // info exists.
  DisallowDIV = 1,      // Hardware divide explicitly disallowed.
  AllowDIVExt = 2,      // Allow hardware divide as optional architecture
                        // extension above the base arch specified by
                        // Tag_CPU_arch and Tag_CPU_arch_profile.

  // Tag_Virtualization_use, (=68), uleb128
  AllowTZ = 1,
  AllowVirtualization = 2,
  AllowTZVirtualization = 3,

  // Tag_PAC_extension, (=50), uleb128
  DisallowPAC = 0,
  AllowPACInNOPSpace = 1,
  AllowPAC = 2,

  // Tag_BTI_extension, (=52), uleb128
  DisallowBTI = 0,
  AllowBTIInNOPSpace = 1,
  AllowBTI = 2,

  // Tag_BTI_use, (=74), uleb128
  BTINotUsed = 0,
  BTIUsed = 1,

  // Tag_PACRET_use, (=76), uleb128
  PACRETNotUsed = 0,
  PACRETUsed = 1
};

} // namespace ARMBuildAttrs
} // namespace llvm

#endif

#ifdef __GNUC__
#pragma GCC diagnostic pop
#endif