1 //===-- TargetParser - Parser for target features ---------------*- C++ -*-===//
3 // The LLVM Compiler Infrastructure
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
8 //===----------------------------------------------------------------------===//
10 // This file implements a target parser to recognise hardware features such as
11 // FPU/CPU/ARCH names as well as specific support such as HDIV, etc.
13 //===----------------------------------------------------------------------===//
15 #include "llvm/Support/ARMBuildAttributes.h"
16 #include "llvm/Support/TargetParser.h"
17 #include "llvm/ADT/StringExtras.h"
18 #include "llvm/ADT/StringSwitch.h"
25 // List of canonical FPU names (use getFPUSynonym) and which architectural
26 // features they correspond to (use getFPUFeatures).
27 // FIXME: TableGen this.
31 unsigned FPUVersion; //< Corresponds directly to the FP arch version number.
32 ARM::NeonSupportLevel NeonSupport;
33 ARM::FPURestriction Restriction;
35 { "invalid", ARM::FK_INVALID, 0, ARM::NS_None, ARM::FR_None},
36 { "vfp", ARM::FK_VFP, 2, ARM::NS_None, ARM::FR_None},
37 { "vfpv2", ARM::FK_VFPV2, 2, ARM::NS_None, ARM::FR_None},
38 { "vfpv3", ARM::FK_VFPV3, 3, ARM::NS_None, ARM::FR_None},
39 { "vfpv3-d16", ARM::FK_VFPV3_D16, 3, ARM::NS_None, ARM::FR_D16},
40 { "vfpv4", ARM::FK_VFPV4, 4, ARM::NS_None, ARM::FR_None},
41 { "vfpv4-d16", ARM::FK_VFPV4_D16, 4, ARM::NS_None, ARM::FR_D16},
42 { "fpv5-d16", ARM::FK_FPV5_D16, 5, ARM::NS_None, ARM::FR_D16},
43 { "fp-armv8", ARM::FK_FP_ARMV8, 5, ARM::NS_None, ARM::FR_None},
44 { "neon", ARM::FK_NEON, 3, ARM::NS_Neon, ARM::FR_None},
45 { "neon-vfpv4", ARM::FK_NEON_VFPV4, 4, ARM::NS_Neon, ARM::FR_None},
46 { "neon-fp-armv8", ARM::FK_NEON_FP_ARMV8, 5, ARM::NS_Neon, ARM::FR_None},
47 { "crypto-neon-fp-armv8",
48 ARM::FK_CRYPTO_NEON_FP_ARMV8, 5, ARM::NS_Crypto, ARM::FR_None},
49 { "softvfp", ARM::FK_SOFTVFP, 0, ARM::NS_None, ARM::FR_None},
52 // List of canonical arch names (use getArchSynonym).
53 // This table also provides the build attribute fields for CPU arch
54 // and Arch ID, according to the Addenda to the ARM ABI, chapters
55 // 2.4 and 2.3.5.2 respectively.
56 // FIXME: SubArch values were simplified to fit into the expectations
57 // of the triples and are not conforming with their official names.
58 // Check to see if the expectation should be changed.
59 // FIXME: TableGen this.
63 const char *CPUAttr; // CPU class in build attributes.
64 const char *SubArch; // Sub-Arch name.
65 ARMBuildAttrs::CPUArch ArchAttr; // Arch ID in build attributes.
67 { "invalid", ARM::AK_INVALID, nullptr, nullptr, ARMBuildAttrs::CPUArch::Pre_v4 },
68 { "armv2", ARM::AK_ARMV2, "2", "v2", ARMBuildAttrs::CPUArch::Pre_v4 },
69 { "armv2a", ARM::AK_ARMV2A, "2A", "v2a", ARMBuildAttrs::CPUArch::Pre_v4 },
70 { "armv3", ARM::AK_ARMV3, "3", "v3", ARMBuildAttrs::CPUArch::Pre_v4 },
71 { "armv3m", ARM::AK_ARMV3M, "3M", "v3m", ARMBuildAttrs::CPUArch::Pre_v4 },
72 { "armv4", ARM::AK_ARMV4, "4", "v4", ARMBuildAttrs::CPUArch::v4 },
73 { "armv4t", ARM::AK_ARMV4T, "4T", "v4t", ARMBuildAttrs::CPUArch::v4T },
74 { "armv5t", ARM::AK_ARMV5T, "5T", "v5", ARMBuildAttrs::CPUArch::v5T },
75 { "armv5te", ARM::AK_ARMV5TE, "5TE", "v5e", ARMBuildAttrs::CPUArch::v5TE },
76 { "armv5tej", ARM::AK_ARMV5TEJ, "5TEJ", "v5e", ARMBuildAttrs::CPUArch::v5TEJ },
77 { "armv6", ARM::AK_ARMV6, "6", "v6", ARMBuildAttrs::CPUArch::v6 },
78 { "armv6k", ARM::AK_ARMV6K, "6K", "v6k", ARMBuildAttrs::CPUArch::v6K },
79 { "armv6t2", ARM::AK_ARMV6T2, "6T2", "v6t2", ARMBuildAttrs::CPUArch::v6T2 },
80 { "armv6z", ARM::AK_ARMV6Z, "6Z", "v6z", ARMBuildAttrs::CPUArch::v6KZ },
81 { "armv6zk", ARM::AK_ARMV6ZK, "6ZK", "v6zk", ARMBuildAttrs::CPUArch::v6KZ },
82 { "armv6-m", ARM::AK_ARMV6M, "6-M", "v6m", ARMBuildAttrs::CPUArch::v6_M },
83 { "armv6s-m", ARM::AK_ARMV6SM, "6S-M", "v6sm", ARMBuildAttrs::CPUArch::v6S_M },
84 { "armv7-a", ARM::AK_ARMV7A, "7-A", "v7", ARMBuildAttrs::CPUArch::v7 },
85 { "armv7-r", ARM::AK_ARMV7R, "7-R", "v7r", ARMBuildAttrs::CPUArch::v7 },
86 { "armv7-m", ARM::AK_ARMV7M, "7-M", "v7m", ARMBuildAttrs::CPUArch::v7 },
87 { "armv7e-m", ARM::AK_ARMV7EM, "7E-M", "v7em", ARMBuildAttrs::CPUArch::v7E_M },
88 { "armv8-a", ARM::AK_ARMV8A, "8-A", "v8", ARMBuildAttrs::CPUArch::v8 },
89 { "armv8.1-a", ARM::AK_ARMV8_1A, "8.1-A", "v8.1a", ARMBuildAttrs::CPUArch::v8 },
90 // Non-standard Arch names.
91 { "iwmmxt", ARM::AK_IWMMXT, "iwmmxt", "", ARMBuildAttrs::CPUArch::v5TE },
92 { "iwmmxt2", ARM::AK_IWMMXT2, "iwmmxt2", "", ARMBuildAttrs::CPUArch::v5TE },
93 { "xscale", ARM::AK_XSCALE, "xscale", "", ARMBuildAttrs::CPUArch::v5TE },
94 { "armv5", ARM::AK_ARMV5, "5T", "v5", ARMBuildAttrs::CPUArch::v5T },
95 { "armv5e", ARM::AK_ARMV5E, "5TE", "v5e", ARMBuildAttrs::CPUArch::v5TE },
96 { "armv6j", ARM::AK_ARMV6J, "6J", "v6", ARMBuildAttrs::CPUArch::v6 },
97 { "armv6hl", ARM::AK_ARMV6HL, "6-M", "v6hl", ARMBuildAttrs::CPUArch::v6_M },
98 { "armv7", ARM::AK_ARMV7, "7", "v7", ARMBuildAttrs::CPUArch::v7 },
99 { "armv7l", ARM::AK_ARMV7L, "7-L", "v7l", ARMBuildAttrs::CPUArch::v7 },
100 { "armv7hl", ARM::AK_ARMV7HL, "7-L", "v7hl", ARMBuildAttrs::CPUArch::v7 },
101 { "armv7s", ARM::AK_ARMV7S, "7-S", "v7s", ARMBuildAttrs::CPUArch::v7 }
103 // List of Arch Extension names.
104 // FIXME: TableGen this.
109 { "invalid", ARM::AEK_INVALID },
110 { "crc", ARM::AEK_CRC },
111 { "crypto", ARM::AEK_CRYPTO },
112 { "fp", ARM::AEK_FP },
113 { "idiv", ARM::AEK_HWDIV },
114 { "mp", ARM::AEK_MP },
115 { "simd", ARM::AEK_SIMD },
116 { "sec", ARM::AEK_SEC },
117 { "virt", ARM::AEK_VIRT },
118 { "os", ARM::AEK_OS },
119 { "iwmmxt", ARM::AEK_IWMMXT },
120 { "iwmmxt2", ARM::AEK_IWMMXT2 },
121 { "maverick", ARM::AEK_MAVERICK },
122 { "xscale", ARM::AEK_XSCALE }
124 // List of CPU names and their arches.
125 // The same CPU can have multiple arches and can be default on multiple arches.
126 // When finding the Arch for a CPU, first-found prevails. Sort them accordingly.
127 // When this becomes table-generated, we'd probably need two tables.
128 // FIXME: TableGen this.
131 ARM::ArchKind ArchID;
134 { "arm2", ARM::AK_ARMV2, true },
135 { "arm3", ARM::AK_ARMV2A, true },
136 { "arm6", ARM::AK_ARMV3, true },
137 { "arm7m", ARM::AK_ARMV3M, true },
138 { "arm8", ARM::AK_ARMV4, false },
139 { "arm810", ARM::AK_ARMV4, false },
140 { "strongarm", ARM::AK_ARMV4, true },
141 { "strongarm110", ARM::AK_ARMV4, false },
142 { "strongarm1100", ARM::AK_ARMV4, false },
143 { "strongarm1110", ARM::AK_ARMV4, false },
144 { "arm7tdmi", ARM::AK_ARMV4T, true },
145 { "arm7tdmi-s", ARM::AK_ARMV4T, false },
146 { "arm710t", ARM::AK_ARMV4T, false },
147 { "arm720t", ARM::AK_ARMV4T, false },
148 { "arm9", ARM::AK_ARMV4T, false },
149 { "arm9tdmi", ARM::AK_ARMV4T, false },
150 { "arm920", ARM::AK_ARMV4T, false },
151 { "arm920t", ARM::AK_ARMV4T, false },
152 { "arm922t", ARM::AK_ARMV4T, false },
153 { "arm9312", ARM::AK_ARMV4T, false },
154 { "arm940t", ARM::AK_ARMV4T, false },
155 { "ep9312", ARM::AK_ARMV4T, false },
156 { "arm10tdmi", ARM::AK_ARMV5T, true },
157 { "arm1020t", ARM::AK_ARMV5T, false },
158 { "arm9e", ARM::AK_ARMV5TE, false },
159 { "arm946e-s", ARM::AK_ARMV5TE, false },
160 { "arm966e-s", ARM::AK_ARMV5TE, false },
161 { "arm968e-s", ARM::AK_ARMV5TE, false },
162 { "arm10e", ARM::AK_ARMV5TE, false },
163 { "arm1020e", ARM::AK_ARMV5TE, false },
164 { "arm1022e", ARM::AK_ARMV5TE, true },
165 { "iwmmxt", ARM::AK_ARMV5TE, false },
166 { "xscale", ARM::AK_ARMV5TE, false },
167 { "arm926ej-s", ARM::AK_ARMV5TEJ, true },
168 { "arm1136jf-s", ARM::AK_ARMV6, true },
169 { "arm1176j-s", ARM::AK_ARMV6K, false },
170 { "arm1176jz-s", ARM::AK_ARMV6K, false },
171 { "mpcore", ARM::AK_ARMV6K, false },
172 { "mpcorenovfp", ARM::AK_ARMV6K, false },
173 { "arm1176jzf-s", ARM::AK_ARMV6K, true },
174 { "arm1176jzf-s", ARM::AK_ARMV6Z, true },
175 { "arm1176jzf-s", ARM::AK_ARMV6ZK, true },
176 { "arm1156t2-s", ARM::AK_ARMV6T2, true },
177 { "arm1156t2f-s", ARM::AK_ARMV6T2, false },
178 { "cortex-m0", ARM::AK_ARMV6M, true },
179 { "cortex-m0plus", ARM::AK_ARMV6M, false },
180 { "cortex-m1", ARM::AK_ARMV6M, false },
181 { "sc000", ARM::AK_ARMV6M, false },
182 { "cortex-a5", ARM::AK_ARMV7A, false },
183 { "cortex-a7", ARM::AK_ARMV7A, false },
184 { "cortex-a8", ARM::AK_ARMV7A, true },
185 { "cortex-a9", ARM::AK_ARMV7A, false },
186 { "cortex-a12", ARM::AK_ARMV7A, false },
187 { "cortex-a15", ARM::AK_ARMV7A, false },
188 { "cortex-a17", ARM::AK_ARMV7A, false },
189 { "krait", ARM::AK_ARMV7A, false },
190 { "cortex-r4", ARM::AK_ARMV7R, true },
191 { "cortex-r4f", ARM::AK_ARMV7R, false },
192 { "cortex-r5", ARM::AK_ARMV7R, false },
193 { "cortex-r7", ARM::AK_ARMV7R, false },
194 { "sc300", ARM::AK_ARMV7M, false },
195 { "cortex-m3", ARM::AK_ARMV7M, true },
196 { "cortex-m4", ARM::AK_ARMV7EM, true },
197 { "cortex-m7", ARM::AK_ARMV7EM, false },
198 { "cortex-a53", ARM::AK_ARMV8A, true },
199 { "cortex-a57", ARM::AK_ARMV8A, false },
200 { "cortex-a72", ARM::AK_ARMV8A, false },
201 { "cyclone", ARM::AK_ARMV8A, false },
202 { "generic", ARM::AK_ARMV8_1A, true },
203 // Non-standard Arch names.
204 { "iwmmxt", ARM::AK_IWMMXT, true },
205 { "xscale", ARM::AK_XSCALE, true },
206 { "arm10tdmi", ARM::AK_ARMV5, true },
207 { "arm1022e", ARM::AK_ARMV5E, true },
208 { "arm1136j-s", ARM::AK_ARMV6J, true },
209 { "arm1136jz-s", ARM::AK_ARMV6J, false },
210 { "cortex-m0", ARM::AK_ARMV6SM, true },
211 { "arm1176jzf-s", ARM::AK_ARMV6HL, true },
212 { "cortex-a8", ARM::AK_ARMV7, true },
213 { "cortex-a8", ARM::AK_ARMV7L, true },
214 { "cortex-a8", ARM::AK_ARMV7HL, true },
215 { "cortex-m4", ARM::AK_ARMV7EM, true },
216 { "swift", ARM::AK_ARMV7S, true },
218 { "invalid", ARM::AK_INVALID, true }
225 // ======================================================= //
227 // ======================================================= //
229 const char *ARMTargetParser::getFPUName(unsigned FPUKind) {
230 if (FPUKind >= ARM::FK_LAST)
232 return FPUNames[FPUKind].Name;
235 unsigned ARMTargetParser::getFPUVersion(unsigned FPUKind) {
236 if (FPUKind >= ARM::FK_LAST)
238 return FPUNames[FPUKind].FPUVersion;
241 unsigned getFPUNeonSupportLevel(unsigned FPUKind) {
242 if (FPUKind >= ARM::FK_LAST)
244 return FPUNames[FPUKind].NeonSupport;
247 unsigned getFPURestriction(unsigned FPUKind) {
248 if (FPUKind >= ARM::FK_LAST)
250 return FPUNames[FPUKind].Restriction;
253 bool ARMTargetParser::getFPUFeatures(unsigned FPUKind,
254 std::vector<const char *> &Features) {
256 if (FPUKind >= ARM::FK_LAST || FPUKind == ARM::FK_INVALID)
259 // fp-only-sp and d16 subtarget features are independent of each other, so we
260 // must enable/disable both.
261 switch (FPUNames[FPUKind].Restriction) {
263 Features.push_back("+fp-only-sp");
264 Features.push_back("+d16");
267 Features.push_back("-fp-only-sp");
268 Features.push_back("+d16");
271 Features.push_back("-fp-only-sp");
272 Features.push_back("-d16");
276 // FPU version subtarget features are inclusive of lower-numbered ones, so
277 // enable the one corresponding to this version and disable all that are
279 switch (FPUNames[FPUKind].FPUVersion) {
281 Features.push_back("+fp-armv8");
284 Features.push_back("+vfp4");
285 Features.push_back("-fp-armv8");
288 Features.push_back("+vfp3");
289 Features.push_back("-vfp4");
290 Features.push_back("-fp-armv8");
293 Features.push_back("+vfp2");
294 Features.push_back("-vfp3");
295 Features.push_back("-vfp4");
296 Features.push_back("-fp-armv8");
299 Features.push_back("-vfp2");
300 Features.push_back("-vfp3");
301 Features.push_back("-vfp4");
302 Features.push_back("-fp-armv8");
306 // crypto includes neon, so we handle this similarly to FPU version.
307 switch (FPUNames[FPUKind].NeonSupport) {
309 Features.push_back("+crypto");
312 Features.push_back("+neon");
313 Features.push_back("-crypto");
316 Features.push_back("-neon");
317 Features.push_back("-crypto");
324 const char *ARMTargetParser::getArchName(unsigned ArchKind) {
325 if (ArchKind >= ARM::AK_LAST)
327 return ARCHNames[ArchKind].Name;
330 const char *ARMTargetParser::getCPUAttr(unsigned ArchKind) {
331 if (ArchKind >= ARM::AK_LAST)
333 return ARCHNames[ArchKind].CPUAttr;
336 const char *ARMTargetParser::getSubArch(unsigned ArchKind) {
337 if (ArchKind >= ARM::AK_LAST)
339 return ARCHNames[ArchKind].SubArch;
342 unsigned ARMTargetParser::getArchAttr(unsigned ArchKind) {
343 if (ArchKind >= ARM::AK_LAST)
344 return ARMBuildAttrs::CPUArch::Pre_v4;
345 return ARCHNames[ArchKind].ArchAttr;
348 const char *ARMTargetParser::getArchExtName(unsigned ArchExtKind) {
349 if (ArchExtKind >= ARM::AEK_LAST)
351 return ARCHExtNames[ArchExtKind].Name;
354 const char *ARMTargetParser::getDefaultCPU(StringRef Arch) {
355 unsigned AK = parseArch(Arch);
356 if (AK == ARM::AK_INVALID)
359 // Look for multiple AKs to find the default for pair AK+Name.
360 for (const auto CPU : CPUNames) {
361 if (CPU.ArchID == AK && CPU.Default)
367 // ======================================================= //
369 // ======================================================= //
371 StringRef ARMTargetParser::getFPUSynonym(StringRef FPU) {
372 return StringSwitch<StringRef>(FPU)
373 .Cases("fpa", "fpe2", "fpe3", "maverick", "invalid") // Unsupported
374 .Case("vfp2", "vfpv2")
375 .Case("vfp3", "vfpv3")
376 .Case("vfp4", "vfpv4")
377 .Case("vfp3-d16", "vfpv3-d16")
378 .Case("vfp4-d16", "vfpv4-d16")
379 // FIXME: sp-16 is NOT the same as d16
380 .Cases("fp4-sp-d16", "fpv4-sp-d16", "vfpv4-d16")
381 .Cases("fp4-dp-d16", "fpv4-dp-d16", "vfpv4-d16")
382 .Cases("fp5-sp-d16", "fpv5-sp-d16", "fpv5-d16")
383 .Cases("fp5-dp-d16", "fpv5-dp-d16", "fpv5-d16")
384 // FIXME: Clang uses it, but it's bogus, since neon defaults to vfpv3.
385 .Case("neon-vfpv3", "neon")
389 StringRef ARMTargetParser::getArchSynonym(StringRef Arch) {
390 return StringSwitch<StringRef>(Arch)
391 .Case("v6sm", "v6s-m")
396 .Case("v7em", "v7e-m")
397 .Cases("v8", "v8a", "aarch64", "arm64", "v8-a")
398 .Case("v8.1a", "v8.1-a")
402 // MArch is expected to be of the form (arm|thumb)?(eb)?(v.+)?(eb)?, but
403 // (iwmmxt|xscale)(eb)? is also permitted. If the former, return
404 // "v.+", if the latter, return unmodified string, minus 'eb'.
405 // If invalid, return empty string.
406 StringRef ARMTargetParser::getCanonicalArchName(StringRef Arch) {
407 size_t offset = StringRef::npos;
409 StringRef Error = "";
411 // Begins with "arm" / "thumb", move past it.
412 if (A.startswith("arm64"))
414 else if (A.startswith("arm"))
416 else if (A.startswith("thumb"))
418 else if (A.startswith("aarch64")) {
420 // AArch64 uses "_be", not "eb" suffix.
421 if (A.find("eb") != StringRef::npos)
423 if (A.substr(offset,3) == "_be")
427 // Ex. "armebv7", move past the "eb".
428 if (offset != StringRef::npos && A.substr(offset, 2) == "eb")
430 // Or, if it ends with eb ("armv7eb"), chop it off.
431 else if (A.endswith("eb"))
432 A = A.substr(0, A.size() - 2);
434 if (offset != StringRef::npos)
435 A = A.substr(offset);
437 // Empty string means offset reached the end, which means it's valid.
441 // Only match non-marketing names
442 if (offset != StringRef::npos) {
443 // Must start with 'vN'.
444 if (A[0] != 'v' || !std::isdigit(A[1]))
446 // Can't have an extra 'eb'.
447 if (A.find("eb") != StringRef::npos)
451 // Arch will either be a 'v' name (v7a) or a marketing name (xscale).
455 unsigned ARMTargetParser::parseFPU(StringRef FPU) {
456 StringRef Syn = getFPUSynonym(FPU);
457 for (const auto F : FPUNames) {
461 return ARM::FK_INVALID;
464 // Allows partial match, ex. "v7a" matches "armv7a".
465 unsigned ARMTargetParser::parseArch(StringRef Arch) {
466 Arch = getCanonicalArchName(Arch);
467 StringRef Syn = getArchSynonym(Arch);
468 for (const auto A : ARCHNames) {
469 if (StringRef(A.Name).endswith(Syn))
472 return ARM::AK_INVALID;
475 unsigned ARMTargetParser::parseArchExt(StringRef ArchExt) {
476 for (const auto A : ARCHExtNames) {
477 if (ArchExt == A.Name)
480 return ARM::AEK_INVALID;
483 unsigned ARMTargetParser::parseCPUArch(StringRef CPU) {
484 for (const auto C : CPUNames) {
488 return ARM::AK_INVALID;
491 // ARM, Thumb, AArch64
492 unsigned ARMTargetParser::parseArchISA(StringRef Arch) {
493 return StringSwitch<unsigned>(Arch)
494 .StartsWith("aarch64", ARM::IK_AARCH64)
495 .StartsWith("arm64", ARM::IK_AARCH64)
496 .StartsWith("thumb", ARM::IK_THUMB)
497 .StartsWith("arm", ARM::IK_ARM)
498 .Default(ARM::EK_INVALID);
502 unsigned ARMTargetParser::parseArchEndian(StringRef Arch) {
503 if (Arch.startswith("armeb") ||
504 Arch.startswith("thumbeb") ||
505 Arch.startswith("aarch64_be"))
508 if (Arch.startswith("arm") || Arch.startswith("thumb")) {
509 if (Arch.endswith("eb"))
512 return ARM::EK_LITTLE;
515 if (Arch.startswith("aarch64"))
516 return ARM::EK_LITTLE;
518 return ARM::EK_INVALID;
522 unsigned ARMTargetParser::parseArchProfile(StringRef Arch) {
523 Arch = getCanonicalArchName(Arch);
524 switch(parseArch(Arch)) {
527 case ARM::AK_ARMV6SM:
528 case ARM::AK_ARMV7EM:
535 case ARM::AK_ARMV8_1A:
538 return ARM::PK_INVALID;
541 // Version number (ex. v7 = 7).
542 unsigned ARMTargetParser::parseArchVersion(StringRef Arch) {
543 Arch = getCanonicalArchName(Arch);
544 switch(parseArch(Arch)) {
556 case ARM::AK_ARMV5TE:
558 case ARM::AK_IWMMXT2:
561 case ARM::AK_ARMV5TEJ:
566 case ARM::AK_ARMV6T2:
568 case ARM::AK_ARMV6ZK:
570 case ARM::AK_ARMV6SM:
571 case ARM::AK_ARMV6HL:
578 case ARM::AK_ARMV7HL:
580 case ARM::AK_ARMV7EM:
583 case ARM::AK_ARMV8_1A: