lib/Support/TargetParser.cpp

   1 //===-- TargetParser - Parser for target features ---------------*- C++ -*-===//
   2 //
   3 //                     The LLVM Compiler Infrastructure
   4 //
   5 // This file is distributed under the University of Illinois Open Source
   6 // License. See LICENSE.TXT for details.
   7 //
   8 //===----------------------------------------------------------------------===//
   9 //
  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.
  12 //
  13 //===----------------------------------------------------------------------===//
  14
  15 #include "llvm/Support/ARMBuildAttributes.h"
  16 #include "llvm/Support/TargetParser.h"
  17 #include "llvm/ADT/StringExtras.h"
  18 #include "llvm/ADT/StringSwitch.h"
  19
  20 using namespace llvm;
  21
  22 namespace {
  23
  24 // List of canonical FPU names (use getFPUSynonym)
  25 // FIXME: TableGen this.
  26 struct {
  27   const char * Name;
  28   ARM::FPUKind ID;
  29 } FPUNames[] = {
  30   { "invalid",              ARM::FK_INVALID },
  31   { "vfp",                  ARM::FK_VFP },
  32   { "vfpv2",                ARM::FK_VFPV2 },
  33   { "vfpv3",                ARM::FK_VFPV3 },
  34   { "vfpv3-d16",            ARM::FK_VFPV3_D16 },
  35   { "vfpv4",                ARM::FK_VFPV4 },
  36   { "vfpv4-d16",            ARM::FK_VFPV4_D16 },
  37   { "fpv5-d16",             ARM::FK_FPV5_D16 },
  38   { "fp-armv8",             ARM::FK_FP_ARMV8 },
  39   { "neon",                 ARM::FK_NEON },
  40   { "neon-vfpv4",           ARM::FK_NEON_VFPV4 },
  41   { "neon-fp-armv8",        ARM::FK_NEON_FP_ARMV8 },
  42   { "crypto-neon-fp-armv8", ARM::FK_CRYPTO_NEON_FP_ARMV8 },
  43   { "softvfp",              ARM::FK_SOFTVFP }
  44 };
  45 // List of canonical arch names (use getArchSynonym)
  46 // FIXME: TableGen this.
  47 struct {
  48   const char *Name;
  49   ARM::ArchKind ID;
  50   const char *DefaultCPU;
  51   ARMBuildAttrs::CPUArch DefaultArch;
  52 } ARCHNames[] = {
  53   { "invalid",   ARM::AK_INVALID,  nullptr,   ARMBuildAttrs::CPUArch::Pre_v4 },
  54   { "armv2",     ARM::AK_ARMV2,    "2",       ARMBuildAttrs::CPUArch::v4 },
  55   { "armv2a",    ARM::AK_ARMV2A,   "2A",      ARMBuildAttrs::CPUArch::v4 },
  56   { "armv3",     ARM::AK_ARMV3,    "3",       ARMBuildAttrs::CPUArch::v4 },
  57   { "armv3m",    ARM::AK_ARMV3M,   "3M",      ARMBuildAttrs::CPUArch::v4 },
  58   { "armv4",     ARM::AK_ARMV4,    "4",       ARMBuildAttrs::CPUArch::v4 },
  59   { "armv4t",    ARM::AK_ARMV4T,   "4T",      ARMBuildAttrs::CPUArch::v4T },
  60   { "armv5",     ARM::AK_ARMV5,    "5",       ARMBuildAttrs::CPUArch::v5T },
  61   { "armv5t",    ARM::AK_ARMV5T,   "5T",      ARMBuildAttrs::CPUArch::v5T },
  62   { "armv5te",   ARM::AK_ARMV5TE,  "5TE",     ARMBuildAttrs::CPUArch::v5TE },
  63   { "armv6",     ARM::AK_ARMV6,    "6",       ARMBuildAttrs::CPUArch::v6 },
  64   { "armv6j",    ARM::AK_ARMV6J,   "6J",      ARMBuildAttrs::CPUArch::v6 },
  65   { "armv6k",    ARM::AK_ARMV6K,   "6K",      ARMBuildAttrs::CPUArch::v6K },
  66   { "armv6t2",   ARM::AK_ARMV6T2,  "6T2",     ARMBuildAttrs::CPUArch::v6T2 },
  67   { "armv6z",    ARM::AK_ARMV6Z,   "6Z",      ARMBuildAttrs::CPUArch::v6KZ },
  68   { "armv6zk",   ARM::AK_ARMV6ZK,  "6ZK",     ARMBuildAttrs::CPUArch::v6KZ },
  69   { "armv6-m",   ARM::AK_ARMV6M,   "6-M",     ARMBuildAttrs::CPUArch::v6_M },
  70   { "armv7",     ARM::AK_ARMV7,    "7",       ARMBuildAttrs::CPUArch::v7 },
  71   { "armv7-a",   ARM::AK_ARMV7A,   "7-A",     ARMBuildAttrs::CPUArch::v7 },
  72   { "armv7-r",   ARM::AK_ARMV7R,   "7-R",     ARMBuildAttrs::CPUArch::v7 },
  73   { "armv7-m",   ARM::AK_ARMV7M,   "7-M",     ARMBuildAttrs::CPUArch::v7 },
  74   { "armv8-a",   ARM::AK_ARMV8A,   "8-A",     ARMBuildAttrs::CPUArch::v8 },
  75   { "armv8.1-a", ARM::AK_ARMV8_1A, "8.1-A",   ARMBuildAttrs::CPUArch::v8 },
  76   // Non-standard Arch names.
  77   { "iwmmxt",    ARM::AK_IWMMXT,   "iwmmxt",  ARMBuildAttrs::CPUArch::v5TE },
  78   { "iwmmxt2",   ARM::AK_IWMMXT2,  "iwmmxt2", ARMBuildAttrs::CPUArch::v5TE },
  79   { "xscale",    ARM::AK_XSCALE,   "xscale",  ARMBuildAttrs::CPUArch::v5TE },
  80   { "armv5e",    ARM::AK_ARMV5E,   "5E",      ARMBuildAttrs::CPUArch::v5TE },
  81   { "armv5tej",  ARM::AK_ARMV5TEJ, "5TE",     ARMBuildAttrs::CPUArch::v5TE },
  82   { "armv6sm",   ARM::AK_ARMV6SM,  "6-M",     ARMBuildAttrs::CPUArch::v6_M },
  83   { "armv7e-m",  ARM::AK_ARMV7EM,  "7E-M",    ARMBuildAttrs::CPUArch::v7E_M },
  84   { "armv7l",    ARM::AK_ARMV7L,   "7-L",     ARMBuildAttrs::CPUArch::v7 },
  85   { "armv7s",    ARM::AK_ARMV7S,   "7-S",     ARMBuildAttrs::CPUArch::v7 }
  86 };
  87 // List of canonical ARCH names (use getARCHSynonym)
  88 // FIXME: TableGen this.
  89 struct {
  90   const char *Name;
  91   ARM::ArchExtKind ID;
  92 } ARCHExtNames[] = {
  93   { "invalid",  ARM::AEK_INVALID },
  94   { "crc",      ARM::AEK_CRC },
  95   { "crypto",   ARM::AEK_CRYPTO },
  96   { "fp",       ARM::AEK_FP },
  97   { "idiv",     ARM::AEK_HWDIV },
  98   { "mp",       ARM::AEK_MP },
  99   { "sec",      ARM::AEK_SEC },
 100   { "virt",     ARM::AEK_VIRT }
 101 };
 102 // List of CPU names and their arches.
 103 // The same CPU can have multiple arches and can be default on multiple arches.
 104 // When finding the Arch for a CPU, first-found prevails. Sort them accordingly.
 105 // FIXME: TableGen this.
 106 struct {
 107   const char *Name;
 108   ARM::ArchKind ArchID;
 109   bool Default;
 110 } CPUNames[] = {
 111   { "arm2",          ARM::AK_ARMV2,    true },
 112   { "arm6",          ARM::AK_ARMV3,    true },
 113   { "arm7m",         ARM::AK_ARMV3M,   true },
 114   { "strongarm",     ARM::AK_ARMV4,    true },
 115   { "arm7tdmi",      ARM::AK_ARMV4T,   true },
 116   { "arm7tdmi-s",    ARM::AK_ARMV4T,   false },
 117   { "arm710t",       ARM::AK_ARMV4T,   false },
 118   { "arm720t",       ARM::AK_ARMV4T,   false },
 119   { "arm9",          ARM::AK_ARMV4T,   false },
 120   { "arm9tdmi",      ARM::AK_ARMV4T,   false },
 121   { "arm920",        ARM::AK_ARMV4T,   false },
 122   { "arm920t",       ARM::AK_ARMV4T,   false },
 123   { "arm922t",       ARM::AK_ARMV4T,   false },
 124   { "arm9312",       ARM::AK_ARMV4T,   false },
 125   { "arm940t",       ARM::AK_ARMV4T,   false },
 126   { "ep9312",        ARM::AK_ARMV4T,   false },
 127   { "arm10tdmi",     ARM::AK_ARMV5,    true },
 128   { "arm10tdmi",     ARM::AK_ARMV5T,   true },
 129   { "arm1020t",      ARM::AK_ARMV5T,   false },
 130   { "xscale",        ARM::AK_XSCALE,   true },
 131   { "xscale",        ARM::AK_ARMV5TE,  false },
 132   { "arm9e",         ARM::AK_ARMV5TE,  false },
 133   { "arm926ej-s",    ARM::AK_ARMV5TE,  false },
 134   { "arm946ej-s",    ARM::AK_ARMV5TE,  false },
 135   { "arm966e-s",     ARM::AK_ARMV5TE,  false },
 136   { "arm968e-s",     ARM::AK_ARMV5TE,  false },
 137   { "arm1020e",      ARM::AK_ARMV5TE,  false },
 138   { "arm1022e",      ARM::AK_ARMV5TE,  true },
 139   { "iwmmxt",        ARM::AK_ARMV5TE,  false },
 140   { "iwmmxt",        ARM::AK_IWMMXT,   true },
 141   { "arm1136jf-s",   ARM::AK_ARMV6,    true },
 142   { "arm1136j-s",    ARM::AK_ARMV6J,   true },
 143   { "arm1136jz-s",   ARM::AK_ARMV6J,   false },
 144   { "arm1176j-s",    ARM::AK_ARMV6K,   false },
 145   { "mpcore",        ARM::AK_ARMV6K,   false },
 146   { "mpcorenovfp",   ARM::AK_ARMV6K,   false },
 147   { "arm1176jzf-s",  ARM::AK_ARMV6K,   true },
 148   { "arm1176jzf-s",  ARM::AK_ARMV6Z,   true },
 149   { "arm1176jzf-s",  ARM::AK_ARMV6ZK,  true },
 150   { "arm1156t2-s",   ARM::AK_ARMV6T2,  true },
 151   { "arm1156t2f-s",  ARM::AK_ARMV6T2,  false },
 152   { "cortex-m0",     ARM::AK_ARMV6M,   true },
 153   { "cortex-m0plus", ARM::AK_ARMV6M,   false },
 154   { "cortex-m1",     ARM::AK_ARMV6M,   false },
 155   { "sc000",         ARM::AK_ARMV6M,   false },
 156   { "cortex-a8",     ARM::AK_ARMV7,    true },
 157   { "cortex-a5",     ARM::AK_ARMV7A,   false },
 158   { "cortex-a7",     ARM::AK_ARMV7A,   false },
 159   { "cortex-a8",     ARM::AK_ARMV7A,   true },
 160   { "cortex-a9",     ARM::AK_ARMV7A,   false },
 161   { "cortex-a12",    ARM::AK_ARMV7A,   false },
 162   { "cortex-a15",    ARM::AK_ARMV7A,   false },
 163   { "cortex-a17",    ARM::AK_ARMV7A,   false },
 164   { "krait",         ARM::AK_ARMV7A,   false },
 165   { "cortex-r4",     ARM::AK_ARMV7R,   true },
 166   { "cortex-r4f",    ARM::AK_ARMV7R,   false },
 167   { "cortex-r5",     ARM::AK_ARMV7R,   false },
 168   { "cortex-r7",     ARM::AK_ARMV7R,   false },
 169   { "sc300",         ARM::AK_ARMV7M,   false },
 170   { "cortex-m3",     ARM::AK_ARMV7M,   true },
 171   { "cortex-m4",     ARM::AK_ARMV7M,   false },
 172   { "cortex-m7",     ARM::AK_ARMV7M,   false },
 173   { "cortex-a53",    ARM::AK_ARMV8A,   true },
 174   { "cortex-a57",    ARM::AK_ARMV8A,   false },
 175   { "cortex-a72",    ARM::AK_ARMV8A,   false },
 176   { "cyclone",       ARM::AK_ARMV8A,   false },
 177   { "generic",       ARM::AK_ARMV8_1A, true },
 178   // Non-standard Arch names.
 179   { "arm1022e",      ARM::AK_ARMV5E,   true },
 180   { "arm926ej-s",    ARM::AK_ARMV5TEJ, true },
 181   { "cortex-m0",     ARM::AK_ARMV6SM,  true },
 182   { "cortex-a8",     ARM::AK_ARMV7L,   true },
 183   { "cortex-m4",     ARM::AK_ARMV7EM,  true },
 184   { "swift",         ARM::AK_ARMV7S,   true },
 185   // Invalid CPU
 186   { "invalid",       ARM::AK_INVALID,  true }
 187 };
 188
 189 } // namespace
 190
 191 namespace llvm {
 192
 193 // ======================================================= //
 194 // Information by ID
 195 // ======================================================= //
 196
 197 const char *ARMTargetParser::getFPUName(unsigned FPUKind) {
 198   if (FPUKind >= ARM::FK_LAST)
 199     return nullptr;
 200   return FPUNames[FPUKind].Name;
 201 }
 202
 203 const char *ARMTargetParser::getArchName(unsigned ArchKind) {
 204   if (ArchKind >= ARM::AK_LAST)
 205     return nullptr;
 206   return ARCHNames[ArchKind].Name;
 207 }
 208
 209 const char *ARMTargetParser::getArchDefaultCPUName(unsigned ArchKind) {
 210   if (ArchKind >= ARM::AK_LAST)
 211     return nullptr;
 212   return ARCHNames[ArchKind].DefaultCPU;
 213 }
 214
 215 unsigned ARMTargetParser::getArchDefaultCPUArch(unsigned ArchKind) {
 216   if (ArchKind >= ARM::AK_LAST)
 217     return ARMBuildAttrs::CPUArch::Pre_v4;
 218   return ARCHNames[ArchKind].DefaultArch;
 219 }
 220
 221 const char *ARMTargetParser::getArchExtName(unsigned ArchExtKind) {
 222   if (ArchExtKind >= ARM::AEK_LAST)
 223     return nullptr;
 224   return ARCHExtNames[ArchExtKind].Name;
 225 }
 226
 227 const char *ARMTargetParser::getDefaultCPU(StringRef Arch) {
 228   unsigned AK = parseArch(Arch);
 229   if (AK == ARM::AK_INVALID)
 230     return nullptr;
 231
 232   // Look for multiple AKs to find the default for pair AK+Name.
 233   for (const auto CPU : CPUNames) {
 234     if (CPU.ArchID == AK && CPU.Default)
 235       return CPU.Name;
 236   }
 237   return nullptr;
 238 }
 239
 240 // ======================================================= //
 241 // Parsers
 242 // ======================================================= //
 243
 244 StringRef ARMTargetParser::getFPUSynonym(StringRef FPU) {
 245   return StringSwitch<StringRef>(FPU)
 246     .Cases("fpa", "fpe2", "fpe3", "maverick", "invalid") // Unsupported
 247     .Case("vfp2", "vfpv2")
 248     .Case("vfp3", "vfpv3")
 249     .Case("vfp4", "vfpv4")
 250     .Case("vfp3-d16", "vfpv3-d16")
 251     .Case("vfp4-d16", "vfpv4-d16")
 252     // FIXME: sp-16 is NOT the same as d16
 253     .Cases("fp4-sp-d16", "fpv4-sp-d16", "vfpv4-d16")
 254     .Cases("fp4-dp-d16", "fpv4-dp-d16", "vfpv4-d16")
 255     .Cases("fp5-sp-d16", "fpv5-sp-d16", "fpv5-d16")
 256     .Cases("fp5-dp-d16", "fpv5-dp-d16", "fpv5-d16")
 257     // FIXME: Clang uses it, but it's bogus, since neon defaults to vfpv3.
 258     .Case("neon-vfpv3", "neon")
 259     .Default(FPU);
 260 }
 261
 262 StringRef ARMTargetParser::getArchSynonym(StringRef Arch) {
 263   return StringSwitch<StringRef>(Arch)
 264     .Cases("armv6m",   "v6m",   "armv6-m")
 265     .Cases("armv7a",   "v7a",   "armv7-a")
 266     .Cases("armv7r",   "v7r",   "armv7-r")
 267     .Cases("armv7m",   "v7m",   "armv7-m")
 268     .Cases("armv7em",  "v7em",  "armv7e-m")
 269     .Cases("armv8",    "v8",    "armv8-a")
 270     .Cases("armv8a",   "v8a",   "armv8-a")
 271     .Cases("armv8.1a", "v8.1a", "armv8.1-a")
 272     .Default(Arch);
 273 }
 274
 275 // MArch is expected to be of the form (arm|thumb)?(eb)?(v.+)?(eb)?, but
 276 // (iwmmxt|xscale)(eb)? is also permitted. If the former, return
 277 // "v.+", if the latter, return unmodified string. If invalid, return "".
 278 StringRef ARMTargetParser::getCanonicalArchName(StringRef Arch) {
 279   size_t offset = StringRef::npos;
 280   StringRef A = Arch;
 281
 282   // Begins with "arm" / "thumb", move past it.
 283   if (A.startswith("arm"))
 284     offset = 3;
 285   else if (A.startswith("thumb"))
 286     offset = 5;
 287   // Ex. "armebv7", move past the "eb".
 288   if (offset != StringRef::npos && A.substr(offset, 2) == "eb")
 289     offset += 2;
 290   // Or, if it ends with eb ("armv7eb"), chop it off.
 291   else if (A.endswith("eb"))
 292     A = A.substr(0, A.size() - 2);
 293   // Reached the end or a 'v', canonicalise.
 294   if (offset != StringRef::npos && (offset == A.size() || A[offset] == 'v'))
 295     A = A.substr(offset);
 296
 297   // Empty string mans offset reached the end. Although valid, this arch
 298   // will not have a match in the table. Return the original string.
 299   if (A.empty())
 300     return Arch;
 301
 302   // If can't find the arch, return an empty StringRef.
 303   if (parseArch(A) == ARM::AK_INVALID)
 304     A = A.substr(A.size());
 305
 306   // Arch will either be a 'v' name (v7a) or a marketing name (xscale)
 307   // or empty, if invalid.
 308   return A;
 309 }
 310
 311 unsigned ARMTargetParser::parseFPU(StringRef FPU) {
 312   StringRef Syn = getFPUSynonym(FPU);
 313   for (const auto F : FPUNames) {
 314     if (Syn == F.Name)
 315       return F.ID;
 316   }
 317   return ARM::FK_INVALID;
 318 }
 319
 320 // Allows partial match, ex. "v7a" matches "armv7a".
 321 unsigned ARMTargetParser::parseArch(StringRef Arch) {
 322   StringRef Syn = getArchSynonym(Arch);
 323   for (const auto A : ARCHNames) {
 324     if (StringRef(A.Name).endswith(Syn))
 325       return A.ID;
 326   }
 327   return ARM::AK_INVALID;
 328 }
 329
 330 unsigned ARMTargetParser::parseArchExt(StringRef ArchExt) {
 331   for (const auto A : ARCHExtNames) {
 332     if (ArchExt == A.Name)
 333       return A.ID;
 334   }
 335   return ARM::AEK_INVALID;
 336 }
 337
 338 unsigned ARMTargetParser::parseCPUArch(StringRef CPU) {
 339   for (const auto C : CPUNames) {
 340     if (CPU == C.Name)
 341       return C.ArchID;
 342   }
 343   return ARM::AK_INVALID;
 344 }
 345
 346 } // namespace llvm