1 //===--- Triple.cpp - Target triple helper class --------------------------===//
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 #include "llvm/ADT/Triple.h"
11 #include "llvm/ADT/STLExtras.h"
12 #include "llvm/ADT/SmallString.h"
13 #include "llvm/ADT/StringSwitch.h"
14 #include "llvm/Support/ErrorHandling.h"
18 const char *Triple::getArchTypeName(ArchType Kind) {
20 case UnknownArch: return "unknown";
22 case aarch64: return "aarch64";
23 case arm: return "arm";
24 case hexagon: return "hexagon";
25 case mips: return "mips";
26 case mipsel: return "mipsel";
27 case mips64: return "mips64";
28 case mips64el:return "mips64el";
29 case msp430: return "msp430";
30 case ppc64: return "powerpc64";
31 case ppc64le: return "powerpc64le";
32 case ppc: return "powerpc";
33 case r600: return "r600";
34 case sparc: return "sparc";
35 case sparcv9: return "sparcv9";
36 case systemz: return "s390x";
37 case tce: return "tce";
38 case thumb: return "thumb";
39 case x86: return "i386";
40 case x86_64: return "x86_64";
41 case xcore: return "xcore";
42 case nvptx: return "nvptx";
43 case nvptx64: return "nvptx64";
44 case le32: return "le32";
45 case amdil: return "amdil";
46 case spir: return "spir";
47 case spir64: return "spir64";
50 llvm_unreachable("Invalid ArchType!");
53 const char *Triple::getArchTypePrefix(ArchType Kind) {
58 case aarch64: return "aarch64";
61 case thumb: return "arm";
65 case ppc: return "ppc";
70 case mips64el:return "mips";
72 case hexagon: return "hexagon";
74 case r600: return "r600";
77 case sparc: return "sparc";
79 case systemz: return "systemz";
82 case x86_64: return "x86";
84 case xcore: return "xcore";
86 case nvptx: return "nvptx";
87 case nvptx64: return "nvptx";
88 case le32: return "le32";
89 case amdil: return "amdil";
90 case spir: return "spir";
91 case spir64: return "spir";
95 const char *Triple::getVendorTypeName(VendorType Kind) {
97 case UnknownVendor: return "unknown";
99 case Apple: return "apple";
100 case PC: return "pc";
101 case SCEI: return "scei";
102 case BGP: return "bgp";
103 case BGQ: return "bgq";
104 case Freescale: return "fsl";
105 case IBM: return "ibm";
106 case NVIDIA: return "nvidia";
109 llvm_unreachable("Invalid VendorType!");
112 const char *Triple::getOSTypeName(OSType Kind) {
114 case UnknownOS: return "unknown";
116 case AuroraUX: return "auroraux";
117 case Cygwin: return "cygwin";
118 case Darwin: return "darwin";
119 case DragonFly: return "dragonfly";
120 case FreeBSD: return "freebsd";
121 case IOS: return "ios";
122 case KFreeBSD: return "kfreebsd";
123 case Linux: return "linux";
124 case Lv2: return "lv2";
125 case MacOSX: return "macosx";
126 case MinGW32: return "mingw32";
127 case NetBSD: return "netbsd";
128 case OpenBSD: return "openbsd";
129 case Solaris: return "solaris";
130 case Win32: return "win32";
131 case Haiku: return "haiku";
132 case Minix: return "minix";
133 case RTEMS: return "rtems";
134 case NaCl: return "nacl";
135 case CNK: return "cnk";
136 case Bitrig: return "bitrig";
137 case AIX: return "aix";
138 case CUDA: return "cuda";
139 case NVCL: return "nvcl";
142 llvm_unreachable("Invalid OSType");
145 const char *Triple::getEnvironmentTypeName(EnvironmentType Kind) {
147 case UnknownEnvironment: return "unknown";
148 case GNU: return "gnu";
149 case GNUEABIHF: return "gnueabihf";
150 case GNUEABI: return "gnueabi";
151 case GNUX32: return "gnux32";
152 case EABI: return "eabi";
153 case MachO: return "macho";
154 case Android: return "android";
155 case ELF: return "elf";
158 llvm_unreachable("Invalid EnvironmentType!");
161 Triple::ArchType Triple::getArchTypeForLLVMName(StringRef Name) {
162 return StringSwitch<Triple::ArchType>(Name)
163 .Case("aarch64", aarch64)
166 .Case("mipsel", mipsel)
167 .Case("mips64", mips64)
168 .Case("mips64el", mips64el)
169 .Case("msp430", msp430)
170 .Case("ppc64", ppc64)
173 .Case("ppc64le", ppc64le)
175 .Case("hexagon", hexagon)
176 .Case("sparc", sparc)
177 .Case("sparcv9", sparcv9)
178 .Case("systemz", systemz)
180 .Case("thumb", thumb)
182 .Case("x86-64", x86_64)
183 .Case("xcore", xcore)
184 .Case("nvptx", nvptx)
185 .Case("nvptx64", nvptx64)
187 .Case("amdil", amdil)
189 .Case("spir64", spir64)
190 .Default(UnknownArch);
193 // Returns architecture name that is understood by the target assembler.
194 const char *Triple::getArchNameForAssembler() {
195 if (!isOSDarwin() && getVendor() != Triple::Apple)
198 return StringSwitch<const char*>(getArchName())
199 .Case("i386", "i386")
200 .Case("x86_64", "x86_64")
201 .Case("powerpc", "ppc")
202 .Case("powerpc64", "ppc64")
203 .Case("powerpc64le", "ppc64le")
205 .Cases("armv4t", "thumbv4t", "armv4t")
206 .Cases("armv5", "armv5e", "thumbv5", "thumbv5e", "armv5")
207 .Cases("armv6", "thumbv6", "armv6")
208 .Cases("armv7", "thumbv7", "armv7")
209 .Case("r600", "r600")
210 .Case("nvptx", "nvptx")
211 .Case("nvptx64", "nvptx64")
212 .Case("le32", "le32")
213 .Case("amdil", "amdil")
214 .Case("spir", "spir")
215 .Case("spir64", "spir64")
219 static Triple::ArchType parseArch(StringRef ArchName) {
220 return StringSwitch<Triple::ArchType>(ArchName)
221 .Cases("i386", "i486", "i586", "i686", Triple::x86)
222 // FIXME: Do we need to support these?
223 .Cases("i786", "i886", "i986", Triple::x86)
224 .Cases("amd64", "x86_64", Triple::x86_64)
225 .Case("powerpc", Triple::ppc)
226 .Cases("powerpc64", "ppu", Triple::ppc64)
227 .Case("powerpc64le", Triple::ppc64le)
228 .Case("aarch64", Triple::aarch64)
229 .Cases("arm", "xscale", Triple::arm)
230 // FIXME: It would be good to replace these with explicit names for all the
231 // various suffixes supported.
232 .StartsWith("armv", Triple::arm)
233 .Case("thumb", Triple::thumb)
234 .StartsWith("thumbv", Triple::thumb)
235 .Case("msp430", Triple::msp430)
236 .Cases("mips", "mipseb", "mipsallegrex", Triple::mips)
237 .Cases("mipsel", "mipsallegrexel", Triple::mipsel)
238 .Cases("mips64", "mips64eb", Triple::mips64)
239 .Case("mips64el", Triple::mips64el)
240 .Case("r600", Triple::r600)
241 .Case("hexagon", Triple::hexagon)
242 .Case("s390x", Triple::systemz)
243 .Case("sparc", Triple::sparc)
244 .Cases("sparcv9", "sparc64", Triple::sparcv9)
245 .Case("tce", Triple::tce)
246 .Case("xcore", Triple::xcore)
247 .Case("nvptx", Triple::nvptx)
248 .Case("nvptx64", Triple::nvptx64)
249 .Case("le32", Triple::le32)
250 .Case("amdil", Triple::amdil)
251 .Case("spir", Triple::spir)
252 .Case("spir64", Triple::spir64)
253 .Default(Triple::UnknownArch);
256 static Triple::VendorType parseVendor(StringRef VendorName) {
257 return StringSwitch<Triple::VendorType>(VendorName)
258 .Case("apple", Triple::Apple)
259 .Case("pc", Triple::PC)
260 .Case("scei", Triple::SCEI)
261 .Case("bgp", Triple::BGP)
262 .Case("bgq", Triple::BGQ)
263 .Case("fsl", Triple::Freescale)
264 .Case("ibm", Triple::IBM)
265 .Case("nvidia", Triple::NVIDIA)
266 .Default(Triple::UnknownVendor);
269 static Triple::OSType parseOS(StringRef OSName) {
270 return StringSwitch<Triple::OSType>(OSName)
271 .StartsWith("auroraux", Triple::AuroraUX)
272 .StartsWith("cygwin", Triple::Cygwin)
273 .StartsWith("darwin", Triple::Darwin)
274 .StartsWith("dragonfly", Triple::DragonFly)
275 .StartsWith("freebsd", Triple::FreeBSD)
276 .StartsWith("ios", Triple::IOS)
277 .StartsWith("kfreebsd", Triple::KFreeBSD)
278 .StartsWith("linux", Triple::Linux)
279 .StartsWith("lv2", Triple::Lv2)
280 .StartsWith("macosx", Triple::MacOSX)
281 .StartsWith("mingw32", Triple::MinGW32)
282 .StartsWith("netbsd", Triple::NetBSD)
283 .StartsWith("openbsd", Triple::OpenBSD)
284 .StartsWith("solaris", Triple::Solaris)
285 .StartsWith("win32", Triple::Win32)
286 .StartsWith("haiku", Triple::Haiku)
287 .StartsWith("minix", Triple::Minix)
288 .StartsWith("rtems", Triple::RTEMS)
289 .StartsWith("nacl", Triple::NaCl)
290 .StartsWith("cnk", Triple::CNK)
291 .StartsWith("bitrig", Triple::Bitrig)
292 .StartsWith("aix", Triple::AIX)
293 .StartsWith("cuda", Triple::CUDA)
294 .StartsWith("nvcl", Triple::NVCL)
295 .Default(Triple::UnknownOS);
298 static Triple::EnvironmentType parseEnvironment(StringRef EnvironmentName) {
299 return StringSwitch<Triple::EnvironmentType>(EnvironmentName)
300 .StartsWith("eabi", Triple::EABI)
301 .StartsWith("gnueabihf", Triple::GNUEABIHF)
302 .StartsWith("gnueabi", Triple::GNUEABI)
303 .StartsWith("gnux32", Triple::GNUX32)
304 .StartsWith("gnu", Triple::GNU)
305 .StartsWith("macho", Triple::MachO)
306 .StartsWith("android", Triple::Android)
307 .StartsWith("elf", Triple::ELF)
308 .Default(Triple::UnknownEnvironment);
311 /// \brief Construct a triple from the string representation provided.
313 /// This stores the string representation and parses the various pieces into
315 Triple::Triple(const Twine &Str)
317 Arch(parseArch(getArchName())),
318 Vendor(parseVendor(getVendorName())),
319 OS(parseOS(getOSName())),
320 Environment(parseEnvironment(getEnvironmentName())) {
323 /// \brief Construct a triple from string representations of the architecture,
326 /// This joins each argument into a canonical string representation and parses
327 /// them into enum members. It leaves the environment unknown and omits it from
328 /// the string representation.
329 Triple::Triple(const Twine &ArchStr, const Twine &VendorStr, const Twine &OSStr)
330 : Data((ArchStr + Twine('-') + VendorStr + Twine('-') + OSStr).str()),
331 Arch(parseArch(ArchStr.str())),
332 Vendor(parseVendor(VendorStr.str())),
333 OS(parseOS(OSStr.str())),
337 /// \brief Construct a triple from string representations of the architecture,
338 /// vendor, OS, and environment.
340 /// This joins each argument into a canonical string representation and parses
341 /// them into enum members.
342 Triple::Triple(const Twine &ArchStr, const Twine &VendorStr, const Twine &OSStr,
343 const Twine &EnvironmentStr)
344 : Data((ArchStr + Twine('-') + VendorStr + Twine('-') + OSStr + Twine('-') +
345 EnvironmentStr).str()),
346 Arch(parseArch(ArchStr.str())),
347 Vendor(parseVendor(VendorStr.str())),
348 OS(parseOS(OSStr.str())),
349 Environment(parseEnvironment(EnvironmentStr.str())) {
352 std::string Triple::normalize(StringRef Str) {
353 // Parse into components.
354 SmallVector<StringRef, 4> Components;
355 Str.split(Components, "-");
357 // If the first component corresponds to a known architecture, preferentially
358 // use it for the architecture. If the second component corresponds to a
359 // known vendor, preferentially use it for the vendor, etc. This avoids silly
360 // component movement when a component parses as (eg) both a valid arch and a
362 ArchType Arch = UnknownArch;
363 if (Components.size() > 0)
364 Arch = parseArch(Components[0]);
365 VendorType Vendor = UnknownVendor;
366 if (Components.size() > 1)
367 Vendor = parseVendor(Components[1]);
368 OSType OS = UnknownOS;
369 if (Components.size() > 2)
370 OS = parseOS(Components[2]);
371 EnvironmentType Environment = UnknownEnvironment;
372 if (Components.size() > 3)
373 Environment = parseEnvironment(Components[3]);
375 // Note which components are already in their final position. These will not
378 Found[0] = Arch != UnknownArch;
379 Found[1] = Vendor != UnknownVendor;
380 Found[2] = OS != UnknownOS;
381 Found[3] = Environment != UnknownEnvironment;
383 // If they are not there already, permute the components into their canonical
384 // positions by seeing if they parse as a valid architecture, and if so moving
385 // the component to the architecture position etc.
386 for (unsigned Pos = 0; Pos != array_lengthof(Found); ++Pos) {
388 continue; // Already in the canonical position.
390 for (unsigned Idx = 0; Idx != Components.size(); ++Idx) {
391 // Do not reparse any components that already matched.
392 if (Idx < array_lengthof(Found) && Found[Idx])
395 // Does this component parse as valid for the target position?
397 StringRef Comp = Components[Idx];
399 default: llvm_unreachable("unexpected component type!");
401 Arch = parseArch(Comp);
402 Valid = Arch != UnknownArch;
405 Vendor = parseVendor(Comp);
406 Valid = Vendor != UnknownVendor;
410 Valid = OS != UnknownOS;
413 Environment = parseEnvironment(Comp);
414 Valid = Environment != UnknownEnvironment;
418 continue; // Nope, try the next component.
420 // Move the component to the target position, pushing any non-fixed
421 // components that are in the way to the right. This tends to give
422 // good results in the common cases of a forgotten vendor component
423 // or a wrongly positioned environment.
425 // Insert left, pushing the existing components to the right. For
426 // example, a-b-i386 -> i386-a-b when moving i386 to the front.
427 StringRef CurrentComponent(""); // The empty component.
428 // Replace the component we are moving with an empty component.
429 std::swap(CurrentComponent, Components[Idx]);
430 // Insert the component being moved at Pos, displacing any existing
431 // components to the right.
432 for (unsigned i = Pos; !CurrentComponent.empty(); ++i) {
433 // Skip over any fixed components.
434 while (i < array_lengthof(Found) && Found[i])
436 // Place the component at the new position, getting the component
437 // that was at this position - it will be moved right.
438 std::swap(CurrentComponent, Components[i]);
440 } else if (Pos > Idx) {
441 // Push right by inserting empty components until the component at Idx
442 // reaches the target position Pos. For example, pc-a -> -pc-a when
443 // moving pc to the second position.
445 // Insert one empty component at Idx.
446 StringRef CurrentComponent(""); // The empty component.
447 for (unsigned i = Idx; i < Components.size();) {
448 // Place the component at the new position, getting the component
449 // that was at this position - it will be moved right.
450 std::swap(CurrentComponent, Components[i]);
451 // If it was placed on top of an empty component then we are done.
452 if (CurrentComponent.empty())
454 // Advance to the next component, skipping any fixed components.
455 while (++i < array_lengthof(Found) && Found[i])
458 // The last component was pushed off the end - append it.
459 if (!CurrentComponent.empty())
460 Components.push_back(CurrentComponent);
462 // Advance Idx to the component's new position.
463 while (++Idx < array_lengthof(Found) && Found[Idx])
465 } while (Idx < Pos); // Add more until the final position is reached.
467 assert(Pos < Components.size() && Components[Pos] == Comp &&
468 "Component moved wrong!");
474 // Special case logic goes here. At this point Arch, Vendor and OS have the
475 // correct values for the computed components.
477 // Stick the corrected components back together to form the normalized string.
478 std::string Normalized;
479 for (unsigned i = 0, e = Components.size(); i != e; ++i) {
480 if (i) Normalized += '-';
481 Normalized += Components[i];
486 StringRef Triple::getArchName() const {
487 return StringRef(Data).split('-').first; // Isolate first component
490 StringRef Triple::getVendorName() const {
491 StringRef Tmp = StringRef(Data).split('-').second; // Strip first component
492 return Tmp.split('-').first; // Isolate second component
495 StringRef Triple::getOSName() const {
496 StringRef Tmp = StringRef(Data).split('-').second; // Strip first component
497 Tmp = Tmp.split('-').second; // Strip second component
498 return Tmp.split('-').first; // Isolate third component
501 StringRef Triple::getEnvironmentName() const {
502 StringRef Tmp = StringRef(Data).split('-').second; // Strip first component
503 Tmp = Tmp.split('-').second; // Strip second component
504 return Tmp.split('-').second; // Strip third component
507 StringRef Triple::getOSAndEnvironmentName() const {
508 StringRef Tmp = StringRef(Data).split('-').second; // Strip first component
509 return Tmp.split('-').second; // Strip second component
512 static unsigned EatNumber(StringRef &Str) {
513 assert(!Str.empty() && Str[0] >= '0' && Str[0] <= '9' && "Not a number");
517 // Consume the leading digit.
518 Result = Result*10 + (Str[0] - '0');
522 } while (!Str.empty() && Str[0] >= '0' && Str[0] <= '9');
527 void Triple::getOSVersion(unsigned &Major, unsigned &Minor,
528 unsigned &Micro) const {
529 StringRef OSName = getOSName();
531 // Assume that the OS portion of the triple starts with the canonical name.
532 StringRef OSTypeName = getOSTypeName(getOS());
533 if (OSName.startswith(OSTypeName))
534 OSName = OSName.substr(OSTypeName.size());
536 // Any unset version defaults to 0.
537 Major = Minor = Micro = 0;
539 // Parse up to three components.
540 unsigned *Components[3] = { &Major, &Minor, &Micro };
541 for (unsigned i = 0; i != 3; ++i) {
542 if (OSName.empty() || OSName[0] < '0' || OSName[0] > '9')
545 // Consume the leading number.
546 *Components[i] = EatNumber(OSName);
548 // Consume the separator, if present.
549 if (OSName.startswith("."))
550 OSName = OSName.substr(1);
554 bool Triple::getMacOSXVersion(unsigned &Major, unsigned &Minor,
555 unsigned &Micro) const {
556 getOSVersion(Major, Minor, Micro);
559 default: llvm_unreachable("unexpected OS for Darwin triple");
561 // Default to darwin8, i.e., MacOSX 10.4.
564 // Darwin version numbers are skewed from OS X versions.
581 // Ignore the version from the triple. This is only handled because the
582 // the clang driver combines OS X and IOS support into a common Darwin
583 // toolchain that wants to know the OS X version number even when targeting
593 void Triple::getiOSVersion(unsigned &Major, unsigned &Minor,
594 unsigned &Micro) const {
596 default: llvm_unreachable("unexpected OS for Darwin triple");
599 // Ignore the version from the triple. This is only handled because the
600 // the clang driver combines OS X and IOS support into a common Darwin
601 // toolchain that wants to know the iOS version number even when targeting
608 getOSVersion(Major, Minor, Micro);
616 void Triple::setTriple(const Twine &Str) {
620 void Triple::setArch(ArchType Kind) {
621 setArchName(getArchTypeName(Kind));
624 void Triple::setVendor(VendorType Kind) {
625 setVendorName(getVendorTypeName(Kind));
628 void Triple::setOS(OSType Kind) {
629 setOSName(getOSTypeName(Kind));
632 void Triple::setEnvironment(EnvironmentType Kind) {
633 setEnvironmentName(getEnvironmentTypeName(Kind));
636 void Triple::setArchName(StringRef Str) {
637 // Work around a miscompilation bug for Twines in gcc 4.0.3.
638 SmallString<64> Triple;
641 Triple += getVendorName();
643 Triple += getOSAndEnvironmentName();
644 setTriple(Triple.str());
647 void Triple::setVendorName(StringRef Str) {
648 setTriple(getArchName() + "-" + Str + "-" + getOSAndEnvironmentName());
651 void Triple::setOSName(StringRef Str) {
652 if (hasEnvironment())
653 setTriple(getArchName() + "-" + getVendorName() + "-" + Str +
654 "-" + getEnvironmentName());
656 setTriple(getArchName() + "-" + getVendorName() + "-" + Str);
659 void Triple::setEnvironmentName(StringRef Str) {
660 setTriple(getArchName() + "-" + getVendorName() + "-" + getOSName() +
664 void Triple::setOSAndEnvironmentName(StringRef Str) {
665 setTriple(getArchName() + "-" + getVendorName() + "-" + Str);
668 static unsigned getArchPointerBitWidth(llvm::Triple::ArchType Arch) {
670 case llvm::Triple::UnknownArch:
673 case llvm::Triple::msp430:
676 case llvm::Triple::amdil:
677 case llvm::Triple::arm:
678 case llvm::Triple::hexagon:
679 case llvm::Triple::le32:
680 case llvm::Triple::mips:
681 case llvm::Triple::mipsel:
682 case llvm::Triple::nvptx:
683 case llvm::Triple::ppc:
684 case llvm::Triple::r600:
685 case llvm::Triple::sparc:
686 case llvm::Triple::tce:
687 case llvm::Triple::thumb:
688 case llvm::Triple::x86:
689 case llvm::Triple::xcore:
690 case llvm::Triple::spir:
693 case llvm::Triple::aarch64:
694 case llvm::Triple::mips64:
695 case llvm::Triple::mips64el:
696 case llvm::Triple::nvptx64:
697 case llvm::Triple::ppc64:
698 case llvm::Triple::ppc64le:
699 case llvm::Triple::sparcv9:
700 case llvm::Triple::systemz:
701 case llvm::Triple::x86_64:
702 case llvm::Triple::spir64:
705 llvm_unreachable("Invalid architecture value");
708 bool Triple::isArch64Bit() const {
709 return getArchPointerBitWidth(getArch()) == 64;
712 bool Triple::isArch32Bit() const {
713 return getArchPointerBitWidth(getArch()) == 32;
716 bool Triple::isArch16Bit() const {
717 return getArchPointerBitWidth(getArch()) == 16;
720 Triple Triple::get32BitArchVariant() const {
723 case Triple::UnknownArch:
724 case Triple::aarch64:
726 case Triple::systemz:
727 case Triple::ppc64le:
728 T.setArch(UnknownArch);
734 case Triple::hexagon:
749 case Triple::mips64: T.setArch(Triple::mips); break;
750 case Triple::mips64el: T.setArch(Triple::mipsel); break;
751 case Triple::nvptx64: T.setArch(Triple::nvptx); break;
752 case Triple::ppc64: T.setArch(Triple::ppc); break;
753 case Triple::sparcv9: T.setArch(Triple::sparc); break;
754 case Triple::x86_64: T.setArch(Triple::x86); break;
755 case Triple::spir64: T.setArch(Triple::spir); break;
760 Triple Triple::get64BitArchVariant() const {
763 case Triple::UnknownArch:
766 case Triple::hexagon:
773 T.setArch(UnknownArch);
776 case Triple::aarch64:
779 case Triple::mips64el:
780 case Triple::nvptx64:
782 case Triple::ppc64le:
783 case Triple::sparcv9:
784 case Triple::systemz:
789 case Triple::mips: T.setArch(Triple::mips64); break;
790 case Triple::mipsel: T.setArch(Triple::mips64el); break;
791 case Triple::nvptx: T.setArch(Triple::nvptx64); break;
792 case Triple::ppc: T.setArch(Triple::ppc64); break;
793 case Triple::sparc: T.setArch(Triple::sparcv9); break;
794 case Triple::x86: T.setArch(Triple::x86_64); break;
795 case Triple::spir: T.setArch(Triple::spir64); break;