1 //===--- Driver.cpp - Clang GCC Compatible Driver -------------------------===//
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 #include "clang/Driver/Driver.h"
11 #include "InputInfo.h"
12 #include "ToolChains.h"
13 #include "clang/Basic/Version.h"
14 #include "clang/Basic/VirtualFileSystem.h"
15 #include "clang/Config/config.h"
16 #include "clang/Driver/Action.h"
17 #include "clang/Driver/Compilation.h"
18 #include "clang/Driver/DriverDiagnostic.h"
19 #include "clang/Driver/Job.h"
20 #include "clang/Driver/Options.h"
21 #include "clang/Driver/SanitizerArgs.h"
22 #include "clang/Driver/Tool.h"
23 #include "clang/Driver/ToolChain.h"
24 #include "llvm/ADT/ArrayRef.h"
25 #include "llvm/ADT/STLExtras.h"
26 #include "llvm/ADT/SmallSet.h"
27 #include "llvm/ADT/StringExtras.h"
28 #include "llvm/ADT/StringSet.h"
29 #include "llvm/ADT/StringSwitch.h"
30 #include "llvm/Option/Arg.h"
31 #include "llvm/Option/ArgList.h"
32 #include "llvm/Option/OptSpecifier.h"
33 #include "llvm/Option/OptTable.h"
34 #include "llvm/Option/Option.h"
35 #include "llvm/Support/ErrorHandling.h"
36 #include "llvm/Support/FileSystem.h"
37 #include "llvm/Support/Path.h"
38 #include "llvm/Support/PrettyStackTrace.h"
39 #include "llvm/Support/Process.h"
40 #include "llvm/Support/Program.h"
41 #include "llvm/Support/raw_ostream.h"
42 #include <map>
43 #include <memory>
44 #include <utility>
45 
46 using namespace clang::driver;
47 using namespace clang;
48 using namespace llvm::opt;
49 
50 Driver::Driver(StringRef ClangExecutable, StringRef DefaultTargetTriple,
51                DiagnosticsEngine &Diags,
52                IntrusiveRefCntPtr<vfs::FileSystem> VFS)
53     : Opts(createDriverOptTable()), Diags(Diags), VFS(std::move(VFS)),
54       Mode(GCCMode), SaveTemps(SaveTempsNone), BitcodeEmbed(EmbedNone),
55       LTOMode(LTOK_None), ClangExecutable(ClangExecutable),
56       SysRoot(DEFAULT_SYSROOT), UseStdLib(true),
57       DriverTitle("clang LLVM compiler"), CCPrintOptionsFilename(nullptr),
58       CCPrintHeadersFilename(nullptr), CCLogDiagnosticsFilename(nullptr),
59       CCCPrintBindings(false), CCPrintHeaders(false), CCLogDiagnostics(false),
60       CCGenDiagnostics(false), DefaultTargetTriple(DefaultTargetTriple),
61       CCCGenericGCCName(""), CheckInputsExist(true), CCCUsePCH(true),
62       SuppressMissingInputWarning(false) {
63 
64   // Provide a sane fallback if no VFS is specified.
65   if (!this->VFS)
66     this->VFS = vfs::getRealFileSystem();
67 
68   Name = llvm::sys::path::filename(ClangExecutable);
69   Dir = llvm::sys::path::parent_path(ClangExecutable);
70   InstalledDir = Dir; // Provide a sensible default installed dir.
71 
72   // Compute the path to the resource directory.
73   StringRef ClangResourceDir(CLANG_RESOURCE_DIR);
74   SmallString<128> P(Dir);
75   if (ClangResourceDir != "") {
76     llvm::sys::path::append(P, ClangResourceDir);
77   } else {
78     StringRef ClangLibdirSuffix(CLANG_LIBDIR_SUFFIX);
79     llvm::sys::path::append(P, "..", Twine("lib") + ClangLibdirSuffix, "clang",
80                             CLANG_VERSION_STRING);
81   }
82   ResourceDir = P.str();
83 }
84 
85 Driver::~Driver() {
86   delete Opts;
87 
88   llvm::DeleteContainerSeconds(ToolChains);
89 }
90 
91 void Driver::ParseDriverMode(StringRef ProgramName,
92                              ArrayRef<const char *> Args) {
93   auto Default = ToolChain::getTargetAndModeFromProgramName(ProgramName);
94   StringRef DefaultMode(Default.second);
95   setDriverModeFromOption(DefaultMode);
96 
97   for (const char *ArgPtr : Args) {
98     // Ingore nullptrs, they are response file's EOL markers
99     if (ArgPtr == nullptr)
100       continue;
101     const StringRef Arg = ArgPtr;
102     setDriverModeFromOption(Arg);
103   }
104 }
105 
106 void Driver::setDriverModeFromOption(StringRef Opt) {
107   const std::string OptName =
108       getOpts().getOption(options::OPT_driver_mode).getPrefixedName();
109   if (!Opt.startswith(OptName))
110     return;
111   StringRef Value = Opt.drop_front(OptName.size());
112 
113   const unsigned M = llvm::StringSwitch<unsigned>(Value)
114                          .Case("gcc", GCCMode)
115                          .Case("g++", GXXMode)
116                          .Case("cpp", CPPMode)
117                          .Case("cl", CLMode)
118                          .Default(~0U);
119 
120   if (M != ~0U)
121     Mode = static_cast<DriverMode>(M);
122   else
123     Diag(diag::err_drv_unsupported_option_argument) << OptName << Value;
124 }
125 
126 InputArgList Driver::ParseArgStrings(ArrayRef<const char *> ArgStrings) {
127   llvm::PrettyStackTraceString CrashInfo("Command line argument parsing");
128 
129   unsigned IncludedFlagsBitmask;
130   unsigned ExcludedFlagsBitmask;
131   std::tie(IncludedFlagsBitmask, ExcludedFlagsBitmask) =
132       getIncludeExcludeOptionFlagMasks();
133 
134   unsigned MissingArgIndex, MissingArgCount;
135   InputArgList Args =
136       getOpts().ParseArgs(ArgStrings, MissingArgIndex, MissingArgCount,
137                           IncludedFlagsBitmask, ExcludedFlagsBitmask);
138 
139   // Check for missing argument error.
140   if (MissingArgCount)
141     Diag(clang::diag::err_drv_missing_argument)
142         << Args.getArgString(MissingArgIndex) << MissingArgCount;
143 
144   // Check for unsupported options.
145   for (const Arg *A : Args) {
146     if (A->getOption().hasFlag(options::Unsupported)) {
147       Diag(clang::diag::err_drv_unsupported_opt) << A->getAsString(Args);
148       continue;
149     }
150 
151     // Warn about -mcpu= without an argument.
152     if (A->getOption().matches(options::OPT_mcpu_EQ) && A->containsValue("")) {
153       Diag(clang::diag::warn_drv_empty_joined_argument) << A->getAsString(Args);
154     }
155   }
156 
157   for (const Arg *A : Args.filtered(options::OPT_UNKNOWN))
158     Diags.Report(IsCLMode() ? diag::warn_drv_unknown_argument_clang_cl :
159                               diag::err_drv_unknown_argument)
160       << A->getAsString(Args);
161 
162   return Args;
163 }
164 
165 // Determine which compilation mode we are in. We look for options which
166 // affect the phase, starting with the earliest phases, and record which
167 // option we used to determine the final phase.
168 phases::ID Driver::getFinalPhase(const DerivedArgList &DAL,
169                                  Arg **FinalPhaseArg) const {
170   Arg *PhaseArg = nullptr;
171   phases::ID FinalPhase;
172 
173   // -{E,EP,P,M,MM} only run the preprocessor.
174   if (CCCIsCPP() || (PhaseArg = DAL.getLastArg(options::OPT_E)) ||
175       (PhaseArg = DAL.getLastArg(options::OPT__SLASH_EP)) ||
176       (PhaseArg = DAL.getLastArg(options::OPT_M, options::OPT_MM)) ||
177       (PhaseArg = DAL.getLastArg(options::OPT__SLASH_P))) {
178     FinalPhase = phases::Preprocess;
179 
180     // --precompile only runs up to precompilation.
181   } else if ((PhaseArg = DAL.getLastArg(options::OPT__precompile))) {
182     FinalPhase = phases::Precompile;
183 
184     // -{fsyntax-only,-analyze,emit-ast} only run up to the compiler.
185   } else if ((PhaseArg = DAL.getLastArg(options::OPT_fsyntax_only)) ||
186              (PhaseArg = DAL.getLastArg(options::OPT_module_file_info)) ||
187              (PhaseArg = DAL.getLastArg(options::OPT_verify_pch)) ||
188              (PhaseArg = DAL.getLastArg(options::OPT_rewrite_objc)) ||
189              (PhaseArg = DAL.getLastArg(options::OPT_rewrite_legacy_objc)) ||
190              (PhaseArg = DAL.getLastArg(options::OPT__migrate)) ||
191              (PhaseArg = DAL.getLastArg(options::OPT__analyze,
192                                         options::OPT__analyze_auto)) ||
193              (PhaseArg = DAL.getLastArg(options::OPT_emit_ast))) {
194     FinalPhase = phases::Compile;
195 
196     // -S only runs up to the backend.
197   } else if ((PhaseArg = DAL.getLastArg(options::OPT_S))) {
198     FinalPhase = phases::Backend;
199 
200     // -c compilation only runs up to the assembler.
201   } else if ((PhaseArg = DAL.getLastArg(options::OPT_c))) {
202     FinalPhase = phases::Assemble;
203 
204     // Otherwise do everything.
205   } else
206     FinalPhase = phases::Link;
207 
208   if (FinalPhaseArg)
209     *FinalPhaseArg = PhaseArg;
210 
211   return FinalPhase;
212 }
213 
214 static Arg *MakeInputArg(DerivedArgList &Args, OptTable *Opts,
215                          StringRef Value) {
216   Arg *A = new Arg(Opts->getOption(options::OPT_INPUT), Value,
217                    Args.getBaseArgs().MakeIndex(Value), Value.data());
218   Args.AddSynthesizedArg(A);
219   A->claim();
220   return A;
221 }
222 
223 DerivedArgList *Driver::TranslateInputArgs(const InputArgList &Args) const {
224   DerivedArgList *DAL = new DerivedArgList(Args);
225 
226   bool HasNostdlib = Args.hasArg(options::OPT_nostdlib);
227   bool HasNodefaultlib = Args.hasArg(options::OPT_nodefaultlibs);
228   for (Arg *A : Args) {
229     // Unfortunately, we have to parse some forwarding options (-Xassembler,
230     // -Xlinker, -Xpreprocessor) because we either integrate their functionality
231     // (assembler and preprocessor), or bypass a previous driver ('collect2').
232 
233     // Rewrite linker options, to replace --no-demangle with a custom internal
234     // option.
235     if ((A->getOption().matches(options::OPT_Wl_COMMA) ||
236          A->getOption().matches(options::OPT_Xlinker)) &&
237         A->containsValue("--no-demangle")) {
238       // Add the rewritten no-demangle argument.
239       DAL->AddFlagArg(A, Opts->getOption(options::OPT_Z_Xlinker__no_demangle));
240 
241       // Add the remaining values as Xlinker arguments.
242       for (StringRef Val : A->getValues())
243         if (Val != "--no-demangle")
244           DAL->AddSeparateArg(A, Opts->getOption(options::OPT_Xlinker), Val);
245 
246       continue;
247     }
248 
249     // Rewrite preprocessor options, to replace -Wp,-MD,FOO which is used by
250     // some build systems. We don't try to be complete here because we don't
251     // care to encourage this usage model.
252     if (A->getOption().matches(options::OPT_Wp_COMMA) &&
253         (A->getValue(0) == StringRef("-MD") ||
254          A->getValue(0) == StringRef("-MMD"))) {
255       // Rewrite to -MD/-MMD along with -MF.
256       if (A->getValue(0) == StringRef("-MD"))
257         DAL->AddFlagArg(A, Opts->getOption(options::OPT_MD));
258       else
259         DAL->AddFlagArg(A, Opts->getOption(options::OPT_MMD));
260       if (A->getNumValues() == 2)
261         DAL->AddSeparateArg(A, Opts->getOption(options::OPT_MF),
262                             A->getValue(1));
263       continue;
264     }
265 
266     // Rewrite reserved library names.
267     if (A->getOption().matches(options::OPT_l)) {
268       StringRef Value = A->getValue();
269 
270       // Rewrite unless -nostdlib is present.
271       if (!HasNostdlib && !HasNodefaultlib && Value == "stdc++") {
272         DAL->AddFlagArg(A, Opts->getOption(options::OPT_Z_reserved_lib_stdcxx));
273         continue;
274       }
275 
276       // Rewrite unconditionally.
277       if (Value == "cc_kext") {
278         DAL->AddFlagArg(A, Opts->getOption(options::OPT_Z_reserved_lib_cckext));
279         continue;
280       }
281     }
282 
283     // Pick up inputs via the -- option.
284     if (A->getOption().matches(options::OPT__DASH_DASH)) {
285       A->claim();
286       for (StringRef Val : A->getValues())
287         DAL->append(MakeInputArg(*DAL, Opts, Val));
288       continue;
289     }
290 
291     DAL->append(A);
292   }
293 
294   // Enforce -static if -miamcu is present.
295   if (Args.hasFlag(options::OPT_miamcu, options::OPT_mno_iamcu, false))
296     DAL->AddFlagArg(0, Opts->getOption(options::OPT_static));
297 
298 // Add a default value of -mlinker-version=, if one was given and the user
299 // didn't specify one.
300 #if defined(HOST_LINK_VERSION)
301   if (!Args.hasArg(options::OPT_mlinker_version_EQ) &&
302       strlen(HOST_LINK_VERSION) > 0) {
303     DAL->AddJoinedArg(0, Opts->getOption(options::OPT_mlinker_version_EQ),
304                       HOST_LINK_VERSION);
305     DAL->getLastArg(options::OPT_mlinker_version_EQ)->claim();
306   }
307 #endif
308 
309   return DAL;
310 }
311 
312 /// \brief Compute target triple from args.
313 ///
314 /// This routine provides the logic to compute a target triple from various
315 /// args passed to the driver and the default triple string.
316 static llvm::Triple computeTargetTriple(const Driver &D,
317                                         StringRef DefaultTargetTriple,
318                                         const ArgList &Args,
319                                         StringRef DarwinArchName = "") {
320   // FIXME: Already done in Compilation *Driver::BuildCompilation
321   if (const Arg *A = Args.getLastArg(options::OPT_target))
322     DefaultTargetTriple = A->getValue();
323 
324   llvm::Triple Target(llvm::Triple::normalize(DefaultTargetTriple));
325 
326   // Handle Apple-specific options available here.
327   if (Target.isOSBinFormatMachO()) {
328     // If an explict Darwin arch name is given, that trumps all.
329     if (!DarwinArchName.empty()) {
330       tools::darwin::setTripleTypeForMachOArchName(Target, DarwinArchName);
331       return Target;
332     }
333 
334     // Handle the Darwin '-arch' flag.
335     if (Arg *A = Args.getLastArg(options::OPT_arch)) {
336       StringRef ArchName = A->getValue();
337       tools::darwin::setTripleTypeForMachOArchName(Target, ArchName);
338     }
339   }
340 
341   // Handle pseudo-target flags '-mlittle-endian'/'-EL' and
342   // '-mbig-endian'/'-EB'.
343   if (Arg *A = Args.getLastArg(options::OPT_mlittle_endian,
344                                options::OPT_mbig_endian)) {
345     if (A->getOption().matches(options::OPT_mlittle_endian)) {
346       llvm::Triple LE = Target.getLittleEndianArchVariant();
347       if (LE.getArch() != llvm::Triple::UnknownArch)
348         Target = std::move(LE);
349     } else {
350       llvm::Triple BE = Target.getBigEndianArchVariant();
351       if (BE.getArch() != llvm::Triple::UnknownArch)
352         Target = std::move(BE);
353     }
354   }
355 
356   // Skip further flag support on OSes which don't support '-m32' or '-m64'.
357   if (Target.getArch() == llvm::Triple::tce ||
358       Target.getOS() == llvm::Triple::Minix)
359     return Target;
360 
361   // Handle pseudo-target flags '-m64', '-mx32', '-m32' and '-m16'.
362   Arg *A = Args.getLastArg(options::OPT_m64, options::OPT_mx32,
363                            options::OPT_m32, options::OPT_m16);
364   if (A) {
365     llvm::Triple::ArchType AT = llvm::Triple::UnknownArch;
366 
367     if (A->getOption().matches(options::OPT_m64)) {
368       AT = Target.get64BitArchVariant().getArch();
369       if (Target.getEnvironment() == llvm::Triple::GNUX32)
370         Target.setEnvironment(llvm::Triple::GNU);
371     } else if (A->getOption().matches(options::OPT_mx32) &&
372                Target.get64BitArchVariant().getArch() == llvm::Triple::x86_64) {
373       AT = llvm::Triple::x86_64;
374       Target.setEnvironment(llvm::Triple::GNUX32);
375     } else if (A->getOption().matches(options::OPT_m32)) {
376       AT = Target.get32BitArchVariant().getArch();
377       if (Target.getEnvironment() == llvm::Triple::GNUX32)
378         Target.setEnvironment(llvm::Triple::GNU);
379     } else if (A->getOption().matches(options::OPT_m16) &&
380                Target.get32BitArchVariant().getArch() == llvm::Triple::x86) {
381       AT = llvm::Triple::x86;
382       Target.setEnvironment(llvm::Triple::CODE16);
383     }
384 
385     if (AT != llvm::Triple::UnknownArch && AT != Target.getArch())
386       Target.setArch(AT);
387   }
388 
389   // Handle -miamcu flag.
390   if (Args.hasFlag(options::OPT_miamcu, options::OPT_mno_iamcu, false)) {
391     if (Target.get32BitArchVariant().getArch() != llvm::Triple::x86)
392       D.Diag(diag::err_drv_unsupported_opt_for_target) << "-miamcu"
393                                                        << Target.str();
394 
395     if (A && !A->getOption().matches(options::OPT_m32))
396       D.Diag(diag::err_drv_argument_not_allowed_with)
397           << "-miamcu" << A->getBaseArg().getAsString(Args);
398 
399     Target.setArch(llvm::Triple::x86);
400     Target.setArchName("i586");
401     Target.setEnvironment(llvm::Triple::UnknownEnvironment);
402     Target.setEnvironmentName("");
403     Target.setOS(llvm::Triple::ELFIAMCU);
404     Target.setVendor(llvm::Triple::UnknownVendor);
405     Target.setVendorName("intel");
406   }
407 
408   return Target;
409 }
410 
411 // \brief Parse the LTO options and record the type of LTO compilation
412 // based on which -f(no-)?lto(=.*)? option occurs last.
413 void Driver::setLTOMode(const llvm::opt::ArgList &Args) {
414   LTOMode = LTOK_None;
415   if (!Args.hasFlag(options::OPT_flto, options::OPT_flto_EQ,
416                     options::OPT_fno_lto, false))
417     return;
418 
419   StringRef LTOName("full");
420 
421   const Arg *A = Args.getLastArg(options::OPT_flto_EQ);
422   if (A)
423     LTOName = A->getValue();
424 
425   LTOMode = llvm::StringSwitch<LTOKind>(LTOName)
426                 .Case("full", LTOK_Full)
427                 .Case("thin", LTOK_Thin)
428                 .Default(LTOK_Unknown);
429 
430   if (LTOMode == LTOK_Unknown) {
431     assert(A);
432     Diag(diag::err_drv_unsupported_option_argument) << A->getOption().getName()
433                                                     << A->getValue();
434   }
435 }
436 
437 void Driver::CreateOffloadingDeviceToolChains(Compilation &C,
438                                               InputList &Inputs) {
439 
440   //
441   // CUDA
442   //
443   // We need to generate a CUDA toolchain if any of the inputs has a CUDA type.
444   if (llvm::any_of(Inputs, [](std::pair<types::ID, const llvm::opt::Arg *> &I) {
445         return types::isCuda(I.first);
446       })) {
447     const ToolChain &TC = getToolChain(
448         C.getInputArgs(),
449         llvm::Triple(C.getSingleOffloadToolChain<Action::OFK_Host>()
450                              ->getTriple()
451                              .isArch64Bit()
452                          ? "nvptx64-nvidia-cuda"
453                          : "nvptx-nvidia-cuda"));
454     C.addOffloadDeviceToolChain(&TC, Action::OFK_Cuda);
455   }
456 
457   //
458   // TODO: Add support for other offloading programming models here.
459   //
460 
461   return;
462 }
463 
464 Compilation *Driver::BuildCompilation(ArrayRef<const char *> ArgList) {
465   llvm::PrettyStackTraceString CrashInfo("Compilation construction");
466 
467   // FIXME: Handle environment options which affect driver behavior, somewhere
468   // (client?). GCC_EXEC_PREFIX, LPATH, CC_PRINT_OPTIONS.
469 
470   if (Optional<std::string> CompilerPathValue =
471           llvm::sys::Process::GetEnv("COMPILER_PATH")) {
472     StringRef CompilerPath = *CompilerPathValue;
473     while (!CompilerPath.empty()) {
474       std::pair<StringRef, StringRef> Split =
475           CompilerPath.split(llvm::sys::EnvPathSeparator);
476       PrefixDirs.push_back(Split.first);
477       CompilerPath = Split.second;
478     }
479   }
480 
481   // We look for the driver mode option early, because the mode can affect
482   // how other options are parsed.
483   ParseDriverMode(ClangExecutable, ArgList.slice(1));
484 
485   // FIXME: What are we going to do with -V and -b?
486 
487   // FIXME: This stuff needs to go into the Compilation, not the driver.
488   bool CCCPrintPhases;
489 
490   InputArgList Args = ParseArgStrings(ArgList.slice(1));
491 
492   // Silence driver warnings if requested
493   Diags.setIgnoreAllWarnings(Args.hasArg(options::OPT_w));
494 
495   // -no-canonical-prefixes is used very early in main.
496   Args.ClaimAllArgs(options::OPT_no_canonical_prefixes);
497 
498   // Ignore -pipe.
499   Args.ClaimAllArgs(options::OPT_pipe);
500 
501   // Extract -ccc args.
502   //
503   // FIXME: We need to figure out where this behavior should live. Most of it
504   // should be outside in the client; the parts that aren't should have proper
505   // options, either by introducing new ones or by overloading gcc ones like -V
506   // or -b.
507   CCCPrintPhases = Args.hasArg(options::OPT_ccc_print_phases);
508   CCCPrintBindings = Args.hasArg(options::OPT_ccc_print_bindings);
509   if (const Arg *A = Args.getLastArg(options::OPT_ccc_gcc_name))
510     CCCGenericGCCName = A->getValue();
511   CCCUsePCH =
512       Args.hasFlag(options::OPT_ccc_pch_is_pch, options::OPT_ccc_pch_is_pth);
513   // FIXME: DefaultTargetTriple is used by the target-prefixed calls to as/ld
514   // and getToolChain is const.
515   if (IsCLMode()) {
516     // clang-cl targets MSVC-style Win32.
517     llvm::Triple T(DefaultTargetTriple);
518     T.setOS(llvm::Triple::Win32);
519     T.setVendor(llvm::Triple::PC);
520     T.setEnvironment(llvm::Triple::MSVC);
521     DefaultTargetTriple = T.str();
522   }
523   if (const Arg *A = Args.getLastArg(options::OPT_target))
524     DefaultTargetTriple = A->getValue();
525   if (const Arg *A = Args.getLastArg(options::OPT_ccc_install_dir))
526     Dir = InstalledDir = A->getValue();
527   for (const Arg *A : Args.filtered(options::OPT_B)) {
528     A->claim();
529     PrefixDirs.push_back(A->getValue(0));
530   }
531   if (const Arg *A = Args.getLastArg(options::OPT__sysroot_EQ))
532     SysRoot = A->getValue();
533   if (const Arg *A = Args.getLastArg(options::OPT__dyld_prefix_EQ))
534     DyldPrefix = A->getValue();
535   if (Args.hasArg(options::OPT_nostdlib))
536     UseStdLib = false;
537 
538   if (const Arg *A = Args.getLastArg(options::OPT_resource_dir))
539     ResourceDir = A->getValue();
540 
541   if (const Arg *A = Args.getLastArg(options::OPT_save_temps_EQ)) {
542     SaveTemps = llvm::StringSwitch<SaveTempsMode>(A->getValue())
543                     .Case("cwd", SaveTempsCwd)
544                     .Case("obj", SaveTempsObj)
545                     .Default(SaveTempsCwd);
546   }
547 
548   setLTOMode(Args);
549 
550   // Ignore -fembed-bitcode options with LTO
551   // since the output will be bitcode anyway.
552   if (getLTOMode() == LTOK_None) {
553     if (Arg *A = Args.getLastArg(options::OPT_fembed_bitcode_EQ)) {
554       StringRef Name = A->getValue();
555       unsigned Model = llvm::StringSwitch<unsigned>(Name)
556           .Case("off", EmbedNone)
557           .Case("all", EmbedBitcode)
558           .Case("bitcode", EmbedBitcode)
559           .Case("marker", EmbedMarker)
560           .Default(~0U);
561       if (Model == ~0U) {
562         Diags.Report(diag::err_drv_invalid_value) << A->getAsString(Args)
563                                                   << Name;
564       } else
565         BitcodeEmbed = static_cast<BitcodeEmbedMode>(Model);
566     }
567   } else {
568     // claim the bitcode option under LTO so no warning is issued.
569     Args.ClaimAllArgs(options::OPT_fembed_bitcode_EQ);
570   }
571 
572   std::unique_ptr<llvm::opt::InputArgList> UArgs =
573       llvm::make_unique<InputArgList>(std::move(Args));
574 
575   // Perform the default argument translations.
576   DerivedArgList *TranslatedArgs = TranslateInputArgs(*UArgs);
577 
578   // Owned by the host.
579   const ToolChain &TC = getToolChain(
580       *UArgs, computeTargetTriple(*this, DefaultTargetTriple, *UArgs));
581 
582   // The compilation takes ownership of Args.
583   Compilation *C = new Compilation(*this, TC, UArgs.release(), TranslatedArgs);
584 
585   if (!HandleImmediateArgs(*C))
586     return C;
587 
588   // Construct the list of inputs.
589   InputList Inputs;
590   BuildInputs(C->getDefaultToolChain(), *TranslatedArgs, Inputs);
591 
592   // Populate the tool chains for the offloading devices, if any.
593   CreateOffloadingDeviceToolChains(*C, Inputs);
594 
595   // Construct the list of abstract actions to perform for this compilation. On
596   // MachO targets this uses the driver-driver and universal actions.
597   if (TC.getTriple().isOSBinFormatMachO())
598     BuildUniversalActions(*C, C->getDefaultToolChain(), Inputs);
599   else
600     BuildActions(*C, C->getArgs(), Inputs, C->getActions());
601 
602   if (CCCPrintPhases) {
603     PrintActions(*C);
604     return C;
605   }
606 
607   BuildJobs(*C);
608 
609   return C;
610 }
611 
612 static void printArgList(raw_ostream &OS, const llvm::opt::ArgList &Args) {
613   llvm::opt::ArgStringList ASL;
614   for (const auto *A : Args)
615     A->render(Args, ASL);
616 
617   for (auto I = ASL.begin(), E = ASL.end(); I != E; ++I) {
618     if (I != ASL.begin())
619       OS << ' ';
620     Command::printArg(OS, *I, true);
621   }
622   OS << '\n';
623 }
624 
625 // When clang crashes, produce diagnostic information including the fully
626 // preprocessed source file(s).  Request that the developer attach the
627 // diagnostic information to a bug report.
628 void Driver::generateCompilationDiagnostics(Compilation &C,
629                                             const Command &FailingCommand) {
630   if (C.getArgs().hasArg(options::OPT_fno_crash_diagnostics))
631     return;
632 
633   // Don't try to generate diagnostics for link or dsymutil jobs.
634   if (FailingCommand.getCreator().isLinkJob() ||
635       FailingCommand.getCreator().isDsymutilJob())
636     return;
637 
638   // Print the version of the compiler.
639   PrintVersion(C, llvm::errs());
640 
641   Diag(clang::diag::note_drv_command_failed_diag_msg)
642       << "PLEASE submit a bug report to " BUG_REPORT_URL " and include the "
643          "crash backtrace, preprocessed source, and associated run script.";
644 
645   // Suppress driver output and emit preprocessor output to temp file.
646   Mode = CPPMode;
647   CCGenDiagnostics = true;
648 
649   // Save the original job command(s).
650   Command Cmd = FailingCommand;
651 
652   // Keep track of whether we produce any errors while trying to produce
653   // preprocessed sources.
654   DiagnosticErrorTrap Trap(Diags);
655 
656   // Suppress tool output.
657   C.initCompilationForDiagnostics();
658 
659   // Construct the list of inputs.
660   InputList Inputs;
661   BuildInputs(C.getDefaultToolChain(), C.getArgs(), Inputs);
662 
663   for (InputList::iterator it = Inputs.begin(), ie = Inputs.end(); it != ie;) {
664     bool IgnoreInput = false;
665 
666     // Ignore input from stdin or any inputs that cannot be preprocessed.
667     // Check type first as not all linker inputs have a value.
668     if (types::getPreprocessedType(it->first) == types::TY_INVALID) {
669       IgnoreInput = true;
670     } else if (!strcmp(it->second->getValue(), "-")) {
671       Diag(clang::diag::note_drv_command_failed_diag_msg)
672           << "Error generating preprocessed source(s) - "
673              "ignoring input from stdin.";
674       IgnoreInput = true;
675     }
676 
677     if (IgnoreInput) {
678       it = Inputs.erase(it);
679       ie = Inputs.end();
680     } else {
681       ++it;
682     }
683   }
684 
685   if (Inputs.empty()) {
686     Diag(clang::diag::note_drv_command_failed_diag_msg)
687         << "Error generating preprocessed source(s) - "
688            "no preprocessable inputs.";
689     return;
690   }
691 
692   // Don't attempt to generate preprocessed files if multiple -arch options are
693   // used, unless they're all duplicates.
694   llvm::StringSet<> ArchNames;
695   for (const Arg *A : C.getArgs()) {
696     if (A->getOption().matches(options::OPT_arch)) {
697       StringRef ArchName = A->getValue();
698       ArchNames.insert(ArchName);
699     }
700   }
701   if (ArchNames.size() > 1) {
702     Diag(clang::diag::note_drv_command_failed_diag_msg)
703         << "Error generating preprocessed source(s) - cannot generate "
704            "preprocessed source with multiple -arch options.";
705     return;
706   }
707 
708   // Construct the list of abstract actions to perform for this compilation. On
709   // Darwin OSes this uses the driver-driver and builds universal actions.
710   const ToolChain &TC = C.getDefaultToolChain();
711   if (TC.getTriple().isOSBinFormatMachO())
712     BuildUniversalActions(C, TC, Inputs);
713   else
714     BuildActions(C, C.getArgs(), Inputs, C.getActions());
715 
716   BuildJobs(C);
717 
718   // If there were errors building the compilation, quit now.
719   if (Trap.hasErrorOccurred()) {
720     Diag(clang::diag::note_drv_command_failed_diag_msg)
721         << "Error generating preprocessed source(s).";
722     return;
723   }
724 
725   // Generate preprocessed output.
726   SmallVector<std::pair<int, const Command *>, 4> FailingCommands;
727   C.ExecuteJobs(C.getJobs(), FailingCommands);
728 
729   // If any of the preprocessing commands failed, clean up and exit.
730   if (!FailingCommands.empty()) {
731     if (!isSaveTempsEnabled())
732       C.CleanupFileList(C.getTempFiles(), true);
733 
734     Diag(clang::diag::note_drv_command_failed_diag_msg)
735         << "Error generating preprocessed source(s).";
736     return;
737   }
738 
739   const ArgStringList &TempFiles = C.getTempFiles();
740   if (TempFiles.empty()) {
741     Diag(clang::diag::note_drv_command_failed_diag_msg)
742         << "Error generating preprocessed source(s).";
743     return;
744   }
745 
746   Diag(clang::diag::note_drv_command_failed_diag_msg)
747       << "\n********************\n\n"
748          "PLEASE ATTACH THE FOLLOWING FILES TO THE BUG REPORT:\n"
749          "Preprocessed source(s) and associated run script(s) are located at:";
750 
751   SmallString<128> VFS;
752   for (const char *TempFile : TempFiles) {
753     Diag(clang::diag::note_drv_command_failed_diag_msg) << TempFile;
754     if (StringRef(TempFile).endswith(".cache")) {
755       // In some cases (modules) we'll dump extra data to help with reproducing
756       // the crash into a directory next to the output.
757       VFS = llvm::sys::path::filename(TempFile);
758       llvm::sys::path::append(VFS, "vfs", "vfs.yaml");
759     }
760   }
761 
762   // Assume associated files are based off of the first temporary file.
763   CrashReportInfo CrashInfo(TempFiles[0], VFS);
764 
765   std::string Script = CrashInfo.Filename.rsplit('.').first.str() + ".sh";
766   std::error_code EC;
767   llvm::raw_fd_ostream ScriptOS(Script, EC, llvm::sys::fs::F_Excl);
768   if (EC) {
769     Diag(clang::diag::note_drv_command_failed_diag_msg)
770         << "Error generating run script: " + Script + " " + EC.message();
771   } else {
772     ScriptOS << "# Crash reproducer for " << getClangFullVersion() << "\n"
773              << "# Driver args: ";
774     printArgList(ScriptOS, C.getInputArgs());
775     ScriptOS << "# Original command: ";
776     Cmd.Print(ScriptOS, "\n", /*Quote=*/true);
777     Cmd.Print(ScriptOS, "\n", /*Quote=*/true, &CrashInfo);
778     Diag(clang::diag::note_drv_command_failed_diag_msg) << Script;
779   }
780 
781   for (const auto &A : C.getArgs().filtered(options::OPT_frewrite_map_file,
782                                             options::OPT_frewrite_map_file_EQ))
783     Diag(clang::diag::note_drv_command_failed_diag_msg) << A->getValue();
784 
785   Diag(clang::diag::note_drv_command_failed_diag_msg)
786       << "\n\n********************";
787 }
788 
789 void Driver::setUpResponseFiles(Compilation &C, Command &Cmd) {
790   // Since commandLineFitsWithinSystemLimits() may underestimate system's capacity
791   // if the tool does not support response files, there is a chance/ that things
792   // will just work without a response file, so we silently just skip it.
793   if (Cmd.getCreator().getResponseFilesSupport() == Tool::RF_None ||
794       llvm::sys::commandLineFitsWithinSystemLimits(Cmd.getExecutable(), Cmd.getArguments()))
795     return;
796 
797   std::string TmpName = GetTemporaryPath("response", "txt");
798   Cmd.setResponseFile(
799       C.addTempFile(C.getArgs().MakeArgString(TmpName.c_str())));
800 }
801 
802 int Driver::ExecuteCompilation(
803     Compilation &C,
804     SmallVectorImpl<std::pair<int, const Command *>> &FailingCommands) {
805   // Just print if -### was present.
806   if (C.getArgs().hasArg(options::OPT__HASH_HASH_HASH)) {
807     C.getJobs().Print(llvm::errs(), "\n", true);
808     return 0;
809   }
810 
811   // If there were errors building the compilation, quit now.
812   if (Diags.hasErrorOccurred())
813     return 1;
814 
815   // Set up response file names for each command, if necessary
816   for (auto &Job : C.getJobs())
817     setUpResponseFiles(C, Job);
818 
819   C.ExecuteJobs(C.getJobs(), FailingCommands);
820 
821   // Remove temp files.
822   C.CleanupFileList(C.getTempFiles());
823 
824   // If the command succeeded, we are done.
825   if (FailingCommands.empty())
826     return 0;
827 
828   // Otherwise, remove result files and print extra information about abnormal
829   // failures.
830   for (const auto &CmdPair : FailingCommands) {
831     int Res = CmdPair.first;
832     const Command *FailingCommand = CmdPair.second;
833 
834     // Remove result files if we're not saving temps.
835     if (!isSaveTempsEnabled()) {
836       const JobAction *JA = cast<JobAction>(&FailingCommand->getSource());
837       C.CleanupFileMap(C.getResultFiles(), JA, true);
838 
839       // Failure result files are valid unless we crashed.
840       if (Res < 0)
841         C.CleanupFileMap(C.getFailureResultFiles(), JA, true);
842     }
843 
844     // Print extra information about abnormal failures, if possible.
845     //
846     // This is ad-hoc, but we don't want to be excessively noisy. If the result
847     // status was 1, assume the command failed normally. In particular, if it
848     // was the compiler then assume it gave a reasonable error code. Failures
849     // in other tools are less common, and they generally have worse
850     // diagnostics, so always print the diagnostic there.
851     const Tool &FailingTool = FailingCommand->getCreator();
852 
853     if (!FailingCommand->getCreator().hasGoodDiagnostics() || Res != 1) {
854       // FIXME: See FIXME above regarding result code interpretation.
855       if (Res < 0)
856         Diag(clang::diag::err_drv_command_signalled)
857             << FailingTool.getShortName();
858       else
859         Diag(clang::diag::err_drv_command_failed) << FailingTool.getShortName()
860                                                   << Res;
861     }
862   }
863   return 0;
864 }
865 
866 void Driver::PrintHelp(bool ShowHidden) const {
867   unsigned IncludedFlagsBitmask;
868   unsigned ExcludedFlagsBitmask;
869   std::tie(IncludedFlagsBitmask, ExcludedFlagsBitmask) =
870       getIncludeExcludeOptionFlagMasks();
871 
872   ExcludedFlagsBitmask |= options::NoDriverOption;
873   if (!ShowHidden)
874     ExcludedFlagsBitmask |= HelpHidden;
875 
876   getOpts().PrintHelp(llvm::outs(), Name.c_str(), DriverTitle.c_str(),
877                       IncludedFlagsBitmask, ExcludedFlagsBitmask);
878 }
879 
880 void Driver::PrintVersion(const Compilation &C, raw_ostream &OS) const {
881   // FIXME: The following handlers should use a callback mechanism, we don't
882   // know what the client would like to do.
883   OS << getClangFullVersion() << '\n';
884   const ToolChain &TC = C.getDefaultToolChain();
885   OS << "Target: " << TC.getTripleString() << '\n';
886 
887   // Print the threading model.
888   if (Arg *A = C.getArgs().getLastArg(options::OPT_mthread_model)) {
889     // Don't print if the ToolChain would have barfed on it already
890     if (TC.isThreadModelSupported(A->getValue()))
891       OS << "Thread model: " << A->getValue();
892   } else
893     OS << "Thread model: " << TC.getThreadModel();
894   OS << '\n';
895 
896   // Print out the install directory.
897   OS << "InstalledDir: " << InstalledDir << '\n';
898 }
899 
900 /// PrintDiagnosticCategories - Implement the --print-diagnostic-categories
901 /// option.
902 static void PrintDiagnosticCategories(raw_ostream &OS) {
903   // Skip the empty category.
904   for (unsigned i = 1, max = DiagnosticIDs::getNumberOfCategories(); i != max;
905        ++i)
906     OS << i << ',' << DiagnosticIDs::getCategoryNameFromID(i) << '\n';
907 }
908 
909 bool Driver::HandleImmediateArgs(const Compilation &C) {
910   // The order these options are handled in gcc is all over the place, but we
911   // don't expect inconsistencies w.r.t. that to matter in practice.
912 
913   if (C.getArgs().hasArg(options::OPT_dumpmachine)) {
914     llvm::outs() << C.getDefaultToolChain().getTripleString() << '\n';
915     return false;
916   }
917 
918   if (C.getArgs().hasArg(options::OPT_dumpversion)) {
919     // Since -dumpversion is only implemented for pedantic GCC compatibility, we
920     // return an answer which matches our definition of __VERSION__.
921     //
922     // If we want to return a more correct answer some day, then we should
923     // introduce a non-pedantically GCC compatible mode to Clang in which we
924     // provide sensible definitions for -dumpversion, __VERSION__, etc.
925     llvm::outs() << "4.2.1\n";
926     return false;
927   }
928 
929   if (C.getArgs().hasArg(options::OPT__print_diagnostic_categories)) {
930     PrintDiagnosticCategories(llvm::outs());
931     return false;
932   }
933 
934   if (C.getArgs().hasArg(options::OPT_help) ||
935       C.getArgs().hasArg(options::OPT__help_hidden)) {
936     PrintHelp(C.getArgs().hasArg(options::OPT__help_hidden));
937     return false;
938   }
939 
940   if (C.getArgs().hasArg(options::OPT__version)) {
941     // Follow gcc behavior and use stdout for --version and stderr for -v.
942     PrintVersion(C, llvm::outs());
943     return false;
944   }
945 
946   if (C.getArgs().hasArg(options::OPT_v) ||
947       C.getArgs().hasArg(options::OPT__HASH_HASH_HASH)) {
948     PrintVersion(C, llvm::errs());
949     SuppressMissingInputWarning = true;
950   }
951 
952   const ToolChain &TC = C.getDefaultToolChain();
953 
954   if (C.getArgs().hasArg(options::OPT_v))
955     TC.printVerboseInfo(llvm::errs());
956 
957   if (C.getArgs().hasArg(options::OPT_print_search_dirs)) {
958     llvm::outs() << "programs: =";
959     bool separator = false;
960     for (const std::string &Path : TC.getProgramPaths()) {
961       if (separator)
962         llvm::outs() << ':';
963       llvm::outs() << Path;
964       separator = true;
965     }
966     llvm::outs() << "\n";
967     llvm::outs() << "libraries: =" << ResourceDir;
968 
969     StringRef sysroot = C.getSysRoot();
970 
971     for (const std::string &Path : TC.getFilePaths()) {
972       // Always print a separator. ResourceDir was the first item shown.
973       llvm::outs() << ':';
974       // Interpretation of leading '=' is needed only for NetBSD.
975       if (Path[0] == '=')
976         llvm::outs() << sysroot << Path.substr(1);
977       else
978         llvm::outs() << Path;
979     }
980     llvm::outs() << "\n";
981     return false;
982   }
983 
984   // FIXME: The following handlers should use a callback mechanism, we don't
985   // know what the client would like to do.
986   if (Arg *A = C.getArgs().getLastArg(options::OPT_print_file_name_EQ)) {
987     llvm::outs() << GetFilePath(A->getValue(), TC) << "\n";
988     return false;
989   }
990 
991   if (Arg *A = C.getArgs().getLastArg(options::OPT_print_prog_name_EQ)) {
992     llvm::outs() << GetProgramPath(A->getValue(), TC) << "\n";
993     return false;
994   }
995 
996   if (C.getArgs().hasArg(options::OPT_print_libgcc_file_name)) {
997     llvm::outs() << GetFilePath("libgcc.a", TC) << "\n";
998     return false;
999   }
1000 
1001   if (C.getArgs().hasArg(options::OPT_print_multi_lib)) {
1002     for (const Multilib &Multilib : TC.getMultilibs())
1003       llvm::outs() << Multilib << "\n";
1004     return false;
1005   }
1006 
1007   if (C.getArgs().hasArg(options::OPT_print_multi_directory)) {
1008     for (const Multilib &Multilib : TC.getMultilibs()) {
1009       if (Multilib.gccSuffix().empty())
1010         llvm::outs() << ".\n";
1011       else {
1012         StringRef Suffix(Multilib.gccSuffix());
1013         assert(Suffix.front() == '/');
1014         llvm::outs() << Suffix.substr(1) << "\n";
1015       }
1016     }
1017     return false;
1018   }
1019   return true;
1020 }
1021 
1022 // Display an action graph human-readably.  Action A is the "sink" node
1023 // and latest-occuring action. Traversal is in pre-order, visiting the
1024 // inputs to each action before printing the action itself.
1025 static unsigned PrintActions1(const Compilation &C, Action *A,
1026                               std::map<Action *, unsigned> &Ids) {
1027   if (Ids.count(A)) // A was already visited.
1028     return Ids[A];
1029 
1030   std::string str;
1031   llvm::raw_string_ostream os(str);
1032 
1033   os << Action::getClassName(A->getKind()) << ", ";
1034   if (InputAction *IA = dyn_cast<InputAction>(A)) {
1035     os << "\"" << IA->getInputArg().getValue() << "\"";
1036   } else if (BindArchAction *BIA = dyn_cast<BindArchAction>(A)) {
1037     os << '"' << BIA->getArchName() << '"' << ", {"
1038        << PrintActions1(C, *BIA->input_begin(), Ids) << "}";
1039   } else if (OffloadAction *OA = dyn_cast<OffloadAction>(A)) {
1040     bool IsFirst = true;
1041     OA->doOnEachDependence(
1042         [&](Action *A, const ToolChain *TC, const char *BoundArch) {
1043           // E.g. for two CUDA device dependences whose bound arch is sm_20 and
1044           // sm_35 this will generate:
1045           // "cuda-device" (nvptx64-nvidia-cuda:sm_20) {#ID}, "cuda-device"
1046           // (nvptx64-nvidia-cuda:sm_35) {#ID}
1047           if (!IsFirst)
1048             os << ", ";
1049           os << '"';
1050           if (TC)
1051             os << A->getOffloadingKindPrefix();
1052           else
1053             os << "host";
1054           os << " (";
1055           os << TC->getTriple().normalize();
1056 
1057           if (BoundArch)
1058             os << ":" << BoundArch;
1059           os << ")";
1060           os << '"';
1061           os << " {" << PrintActions1(C, A, Ids) << "}";
1062           IsFirst = false;
1063         });
1064   } else {
1065     const ActionList *AL = &A->getInputs();
1066 
1067     if (AL->size()) {
1068       const char *Prefix = "{";
1069       for (Action *PreRequisite : *AL) {
1070         os << Prefix << PrintActions1(C, PreRequisite, Ids);
1071         Prefix = ", ";
1072       }
1073       os << "}";
1074     } else
1075       os << "{}";
1076   }
1077 
1078   // Append offload info for all options other than the offloading action
1079   // itself (e.g. (cuda-device, sm_20) or (cuda-host)).
1080   std::string offload_str;
1081   llvm::raw_string_ostream offload_os(offload_str);
1082   if (!isa<OffloadAction>(A)) {
1083     auto S = A->getOffloadingKindPrefix();
1084     if (!S.empty()) {
1085       offload_os << ", (" << S;
1086       if (A->getOffloadingArch())
1087         offload_os << ", " << A->getOffloadingArch();
1088       offload_os << ")";
1089     }
1090   }
1091 
1092   unsigned Id = Ids.size();
1093   Ids[A] = Id;
1094   llvm::errs() << Id << ": " << os.str() << ", "
1095                << types::getTypeName(A->getType()) << offload_os.str() << "\n";
1096 
1097   return Id;
1098 }
1099 
1100 // Print the action graphs in a compilation C.
1101 // For example "clang -c file1.c file2.c" is composed of two subgraphs.
1102 void Driver::PrintActions(const Compilation &C) const {
1103   std::map<Action *, unsigned> Ids;
1104   for (Action *A : C.getActions())
1105     PrintActions1(C, A, Ids);
1106 }
1107 
1108 /// \brief Check whether the given input tree contains any compilation or
1109 /// assembly actions.
1110 static bool ContainsCompileOrAssembleAction(const Action *A) {
1111   if (isa<CompileJobAction>(A) || isa<BackendJobAction>(A) ||
1112       isa<AssembleJobAction>(A))
1113     return true;
1114 
1115   for (const Action *Input : A->inputs())
1116     if (ContainsCompileOrAssembleAction(Input))
1117       return true;
1118 
1119   return false;
1120 }
1121 
1122 void Driver::BuildUniversalActions(Compilation &C, const ToolChain &TC,
1123                                    const InputList &BAInputs) const {
1124   DerivedArgList &Args = C.getArgs();
1125   ActionList &Actions = C.getActions();
1126   llvm::PrettyStackTraceString CrashInfo("Building universal build actions");
1127   // Collect the list of architectures. Duplicates are allowed, but should only
1128   // be handled once (in the order seen).
1129   llvm::StringSet<> ArchNames;
1130   SmallVector<const char *, 4> Archs;
1131   for (Arg *A : Args) {
1132     if (A->getOption().matches(options::OPT_arch)) {
1133       // Validate the option here; we don't save the type here because its
1134       // particular spelling may participate in other driver choices.
1135       llvm::Triple::ArchType Arch =
1136           tools::darwin::getArchTypeForMachOArchName(A->getValue());
1137       if (Arch == llvm::Triple::UnknownArch) {
1138         Diag(clang::diag::err_drv_invalid_arch_name) << A->getAsString(Args);
1139         continue;
1140       }
1141 
1142       A->claim();
1143       if (ArchNames.insert(A->getValue()).second)
1144         Archs.push_back(A->getValue());
1145     }
1146   }
1147 
1148   // When there is no explicit arch for this platform, make sure we still bind
1149   // the architecture (to the default) so that -Xarch_ is handled correctly.
1150   if (!Archs.size())
1151     Archs.push_back(Args.MakeArgString(TC.getDefaultUniversalArchName()));
1152 
1153   ActionList SingleActions;
1154   BuildActions(C, Args, BAInputs, SingleActions);
1155 
1156   // Add in arch bindings for every top level action, as well as lipo and
1157   // dsymutil steps if needed.
1158   for (Action* Act : SingleActions) {
1159     // Make sure we can lipo this kind of output. If not (and it is an actual
1160     // output) then we disallow, since we can't create an output file with the
1161     // right name without overwriting it. We could remove this oddity by just
1162     // changing the output names to include the arch, which would also fix
1163     // -save-temps. Compatibility wins for now.
1164 
1165     if (Archs.size() > 1 && !types::canLipoType(Act->getType()))
1166       Diag(clang::diag::err_drv_invalid_output_with_multiple_archs)
1167           << types::getTypeName(Act->getType());
1168 
1169     ActionList Inputs;
1170     for (unsigned i = 0, e = Archs.size(); i != e; ++i)
1171       Inputs.push_back(C.MakeAction<BindArchAction>(Act, Archs[i]));
1172 
1173     // Lipo if necessary, we do it this way because we need to set the arch flag
1174     // so that -Xarch_ gets overwritten.
1175     if (Inputs.size() == 1 || Act->getType() == types::TY_Nothing)
1176       Actions.append(Inputs.begin(), Inputs.end());
1177     else
1178       Actions.push_back(C.MakeAction<LipoJobAction>(Inputs, Act->getType()));
1179 
1180     // Handle debug info queries.
1181     Arg *A = Args.getLastArg(options::OPT_g_Group);
1182     if (A && !A->getOption().matches(options::OPT_g0) &&
1183         !A->getOption().matches(options::OPT_gstabs) &&
1184         ContainsCompileOrAssembleAction(Actions.back())) {
1185 
1186       // Add a 'dsymutil' step if necessary, when debug info is enabled and we
1187       // have a compile input. We need to run 'dsymutil' ourselves in such cases
1188       // because the debug info will refer to a temporary object file which
1189       // will be removed at the end of the compilation process.
1190       if (Act->getType() == types::TY_Image) {
1191         ActionList Inputs;
1192         Inputs.push_back(Actions.back());
1193         Actions.pop_back();
1194         Actions.push_back(
1195             C.MakeAction<DsymutilJobAction>(Inputs, types::TY_dSYM));
1196       }
1197 
1198       // Verify the debug info output.
1199       if (Args.hasArg(options::OPT_verify_debug_info)) {
1200         Action* LastAction = Actions.back();
1201         Actions.pop_back();
1202         Actions.push_back(C.MakeAction<VerifyDebugInfoJobAction>(
1203             LastAction, types::TY_Nothing));
1204       }
1205     }
1206   }
1207 }
1208 
1209 /// \brief Check that the file referenced by Value exists. If it doesn't,
1210 /// issue a diagnostic and return false.
1211 static bool DiagnoseInputExistence(const Driver &D, const DerivedArgList &Args,
1212                                    StringRef Value, types::ID Ty) {
1213   if (!D.getCheckInputsExist())
1214     return true;
1215 
1216   // stdin always exists.
1217   if (Value == "-")
1218     return true;
1219 
1220   SmallString<64> Path(Value);
1221   if (Arg *WorkDir = Args.getLastArg(options::OPT_working_directory)) {
1222     if (!llvm::sys::path::is_absolute(Path)) {
1223       SmallString<64> Directory(WorkDir->getValue());
1224       llvm::sys::path::append(Directory, Value);
1225       Path.assign(Directory);
1226     }
1227   }
1228 
1229   if (llvm::sys::fs::exists(Twine(Path)))
1230     return true;
1231 
1232   if (D.IsCLMode()) {
1233     if (!llvm::sys::path::is_absolute(Twine(Path)) &&
1234         llvm::sys::Process::FindInEnvPath("LIB", Value))
1235       return true;
1236 
1237     if (Args.hasArg(options::OPT__SLASH_link) && Ty == types::TY_Object) {
1238       // Arguments to the /link flag might cause the linker to search for object
1239       // and library files in paths we don't know about. Don't error in such
1240       // cases.
1241       return true;
1242     }
1243   }
1244 
1245   D.Diag(clang::diag::err_drv_no_such_file) << Path;
1246   return false;
1247 }
1248 
1249 // Construct a the list of inputs and their types.
1250 void Driver::BuildInputs(const ToolChain &TC, DerivedArgList &Args,
1251                          InputList &Inputs) const {
1252   // Track the current user specified (-x) input. We also explicitly track the
1253   // argument used to set the type; we only want to claim the type when we
1254   // actually use it, so we warn about unused -x arguments.
1255   types::ID InputType = types::TY_Nothing;
1256   Arg *InputTypeArg = nullptr;
1257 
1258   // The last /TC or /TP option sets the input type to C or C++ globally.
1259   if (Arg *TCTP = Args.getLastArgNoClaim(options::OPT__SLASH_TC,
1260                                          options::OPT__SLASH_TP)) {
1261     InputTypeArg = TCTP;
1262     InputType = TCTP->getOption().matches(options::OPT__SLASH_TC)
1263                     ? types::TY_C
1264                     : types::TY_CXX;
1265 
1266     arg_iterator it =
1267         Args.filtered_begin(options::OPT__SLASH_TC, options::OPT__SLASH_TP);
1268     const arg_iterator ie = Args.filtered_end();
1269     Arg *Previous = *it++;
1270     bool ShowNote = false;
1271     while (it != ie) {
1272       Diag(clang::diag::warn_drv_overriding_flag_option)
1273           << Previous->getSpelling() << (*it)->getSpelling();
1274       Previous = *it++;
1275       ShowNote = true;
1276     }
1277     if (ShowNote)
1278       Diag(clang::diag::note_drv_t_option_is_global);
1279 
1280     // No driver mode exposes -x and /TC or /TP; we don't support mixing them.
1281     assert(!Args.hasArg(options::OPT_x) && "-x and /TC or /TP is not allowed");
1282   }
1283 
1284   for (Arg *A : Args) {
1285     if (A->getOption().getKind() == Option::InputClass) {
1286       const char *Value = A->getValue();
1287       types::ID Ty = types::TY_INVALID;
1288 
1289       // Infer the input type if necessary.
1290       if (InputType == types::TY_Nothing) {
1291         // If there was an explicit arg for this, claim it.
1292         if (InputTypeArg)
1293           InputTypeArg->claim();
1294 
1295         // stdin must be handled specially.
1296         if (memcmp(Value, "-", 2) == 0) {
1297           // If running with -E, treat as a C input (this changes the builtin
1298           // macros, for example). This may be overridden by -ObjC below.
1299           //
1300           // Otherwise emit an error but still use a valid type to avoid
1301           // spurious errors (e.g., no inputs).
1302           if (!Args.hasArgNoClaim(options::OPT_E) && !CCCIsCPP())
1303             Diag(IsCLMode() ? clang::diag::err_drv_unknown_stdin_type_clang_cl
1304                             : clang::diag::err_drv_unknown_stdin_type);
1305           Ty = types::TY_C;
1306         } else {
1307           // Otherwise lookup by extension.
1308           // Fallback is C if invoked as C preprocessor or Object otherwise.
1309           // We use a host hook here because Darwin at least has its own
1310           // idea of what .s is.
1311           if (const char *Ext = strrchr(Value, '.'))
1312             Ty = TC.LookupTypeForExtension(Ext + 1);
1313 
1314           if (Ty == types::TY_INVALID) {
1315             if (CCCIsCPP())
1316               Ty = types::TY_C;
1317             else
1318               Ty = types::TY_Object;
1319           }
1320 
1321           // If the driver is invoked as C++ compiler (like clang++ or c++) it
1322           // should autodetect some input files as C++ for g++ compatibility.
1323           if (CCCIsCXX()) {
1324             types::ID OldTy = Ty;
1325             Ty = types::lookupCXXTypeForCType(Ty);
1326 
1327             if (Ty != OldTy)
1328               Diag(clang::diag::warn_drv_treating_input_as_cxx)
1329                   << getTypeName(OldTy) << getTypeName(Ty);
1330           }
1331         }
1332 
1333         // -ObjC and -ObjC++ override the default language, but only for "source
1334         // files". We just treat everything that isn't a linker input as a
1335         // source file.
1336         //
1337         // FIXME: Clean this up if we move the phase sequence into the type.
1338         if (Ty != types::TY_Object) {
1339           if (Args.hasArg(options::OPT_ObjC))
1340             Ty = types::TY_ObjC;
1341           else if (Args.hasArg(options::OPT_ObjCXX))
1342             Ty = types::TY_ObjCXX;
1343         }
1344       } else {
1345         assert(InputTypeArg && "InputType set w/o InputTypeArg");
1346         if (!InputTypeArg->getOption().matches(options::OPT_x)) {
1347           // If emulating cl.exe, make sure that /TC and /TP don't affect input
1348           // object files.
1349           const char *Ext = strrchr(Value, '.');
1350           if (Ext && TC.LookupTypeForExtension(Ext + 1) == types::TY_Object)
1351             Ty = types::TY_Object;
1352         }
1353         if (Ty == types::TY_INVALID) {
1354           Ty = InputType;
1355           InputTypeArg->claim();
1356         }
1357       }
1358 
1359       if (DiagnoseInputExistence(*this, Args, Value, Ty))
1360         Inputs.push_back(std::make_pair(Ty, A));
1361 
1362     } else if (A->getOption().matches(options::OPT__SLASH_Tc)) {
1363       StringRef Value = A->getValue();
1364       if (DiagnoseInputExistence(*this, Args, Value, types::TY_C)) {
1365         Arg *InputArg = MakeInputArg(Args, Opts, A->getValue());
1366         Inputs.push_back(std::make_pair(types::TY_C, InputArg));
1367       }
1368       A->claim();
1369     } else if (A->getOption().matches(options::OPT__SLASH_Tp)) {
1370       StringRef Value = A->getValue();
1371       if (DiagnoseInputExistence(*this, Args, Value, types::TY_CXX)) {
1372         Arg *InputArg = MakeInputArg(Args, Opts, A->getValue());
1373         Inputs.push_back(std::make_pair(types::TY_CXX, InputArg));
1374       }
1375       A->claim();
1376     } else if (A->getOption().hasFlag(options::LinkerInput)) {
1377       // Just treat as object type, we could make a special type for this if
1378       // necessary.
1379       Inputs.push_back(std::make_pair(types::TY_Object, A));
1380 
1381     } else if (A->getOption().matches(options::OPT_x)) {
1382       InputTypeArg = A;
1383       InputType = types::lookupTypeForTypeSpecifier(A->getValue());
1384       A->claim();
1385 
1386       // Follow gcc behavior and treat as linker input for invalid -x
1387       // options. Its not clear why we shouldn't just revert to unknown; but
1388       // this isn't very important, we might as well be bug compatible.
1389       if (!InputType) {
1390         Diag(clang::diag::err_drv_unknown_language) << A->getValue();
1391         InputType = types::TY_Object;
1392       }
1393     }
1394   }
1395   if (CCCIsCPP() && Inputs.empty()) {
1396     // If called as standalone preprocessor, stdin is processed
1397     // if no other input is present.
1398     Arg *A = MakeInputArg(Args, Opts, "-");
1399     Inputs.push_back(std::make_pair(types::TY_C, A));
1400   }
1401 }
1402 
1403 // For each unique --cuda-gpu-arch= argument creates a TY_CUDA_DEVICE
1404 // input action and then wraps each in CudaDeviceAction paired with
1405 // appropriate GPU arch name. In case of partial (i.e preprocessing
1406 // only) or device-only compilation, each device action is added to /p
1407 // Actions and /p Current is released. Otherwise the function creates
1408 // and returns a new CudaHostAction which wraps /p Current and device
1409 // side actions.
1410 static Action *buildCudaActions(Compilation &C, DerivedArgList &Args,
1411                                 const Arg *InputArg, Action *HostAction,
1412                                 ActionList &Actions) {
1413   Arg *PartialCompilationArg = Args.getLastArg(
1414       options::OPT_cuda_host_only, options::OPT_cuda_device_only,
1415       options::OPT_cuda_compile_host_device);
1416   bool CompileHostOnly =
1417       PartialCompilationArg &&
1418       PartialCompilationArg->getOption().matches(options::OPT_cuda_host_only);
1419   bool CompileDeviceOnly =
1420       PartialCompilationArg &&
1421       PartialCompilationArg->getOption().matches(options::OPT_cuda_device_only);
1422   const ToolChain *HostTC = C.getSingleOffloadToolChain<Action::OFK_Host>();
1423   assert(HostTC && "No toolchain for host compilation.");
1424   if (HostTC->getTriple().isNVPTX()) {
1425     // We do not support targeting NVPTX for host compilation. Throw
1426     // an error and abort pipeline construction early so we don't trip
1427     // asserts that assume device-side compilation.
1428     C.getDriver().Diag(diag::err_drv_cuda_nvptx_host);
1429     return nullptr;
1430   }
1431 
1432   if (CompileHostOnly) {
1433     OffloadAction::HostDependence HDep(*HostAction, *HostTC,
1434                                        /*BoundArch=*/nullptr, Action::OFK_Cuda);
1435     return C.MakeAction<OffloadAction>(HDep);
1436   }
1437 
1438   // Collect all cuda_gpu_arch parameters, removing duplicates.
1439   SmallVector<CudaArch, 4> GpuArchList;
1440   llvm::SmallSet<CudaArch, 4> GpuArchs;
1441   for (Arg *A : Args) {
1442     if (!A->getOption().matches(options::OPT_cuda_gpu_arch_EQ))
1443       continue;
1444     A->claim();
1445 
1446     const auto &ArchStr = A->getValue();
1447     CudaArch Arch = StringToCudaArch(ArchStr);
1448     if (Arch == CudaArch::UNKNOWN)
1449       C.getDriver().Diag(clang::diag::err_drv_cuda_bad_gpu_arch) << ArchStr;
1450     else if (GpuArchs.insert(Arch).second)
1451       GpuArchList.push_back(Arch);
1452   }
1453 
1454   // Default to sm_20 which is the lowest common denominator for supported GPUs.
1455   // sm_20 code should work correctly, if suboptimally, on all newer GPUs.
1456   if (GpuArchList.empty())
1457     GpuArchList.push_back(CudaArch::SM_20);
1458 
1459   // Replicate inputs for each GPU architecture.
1460   Driver::InputList CudaDeviceInputs;
1461   for (unsigned I = 0, E = GpuArchList.size(); I != E; ++I)
1462     CudaDeviceInputs.push_back(std::make_pair(types::TY_CUDA_DEVICE, InputArg));
1463 
1464   // Build actions for all device inputs.
1465   ActionList CudaDeviceActions;
1466   C.getDriver().BuildActions(C, Args, CudaDeviceInputs, CudaDeviceActions);
1467   assert(GpuArchList.size() == CudaDeviceActions.size() &&
1468          "Failed to create actions for all devices");
1469 
1470   // Check whether any of device actions stopped before they could generate PTX.
1471   bool PartialCompilation =
1472       llvm::any_of(CudaDeviceActions, [](const Action *a) {
1473         return a->getKind() != Action::AssembleJobClass;
1474       });
1475 
1476   const ToolChain *CudaTC = C.getSingleOffloadToolChain<Action::OFK_Cuda>();
1477 
1478   // Figure out what to do with device actions -- pass them as inputs to the
1479   // host action or run each of them independently.
1480   if (PartialCompilation || CompileDeviceOnly) {
1481     // In case of partial or device-only compilation results of device actions
1482     // are not consumed by the host action device actions have to be added to
1483     // top-level actions list with AtTopLevel=true and run independently.
1484 
1485     // -o is ambiguous if we have more than one top-level action.
1486     if (Args.hasArg(options::OPT_o) &&
1487         (!CompileDeviceOnly || GpuArchList.size() > 1)) {
1488       C.getDriver().Diag(
1489           clang::diag::err_drv_output_argument_with_multiple_files);
1490       return nullptr;
1491     }
1492 
1493     for (unsigned I = 0, E = GpuArchList.size(); I != E; ++I) {
1494       OffloadAction::DeviceDependences DDep;
1495       DDep.add(*CudaDeviceActions[I], *CudaTC, CudaArchToString(GpuArchList[I]),
1496                Action::OFK_Cuda);
1497       Actions.push_back(
1498           C.MakeAction<OffloadAction>(DDep, CudaDeviceActions[I]->getType()));
1499     }
1500     // Kill host action in case of device-only compilation.
1501     if (CompileDeviceOnly)
1502       return nullptr;
1503     return HostAction;
1504   }
1505 
1506   // If we're not a partial or device-only compilation, we compile each arch to
1507   // ptx and assemble to cubin, then feed the cubin *and* the ptx into a device
1508   // "link" action, which uses fatbinary to combine these cubins into one
1509   // fatbin.  The fatbin is then an input to the host compilation.
1510   ActionList DeviceActions;
1511   for (unsigned I = 0, E = GpuArchList.size(); I != E; ++I) {
1512     Action* AssembleAction = CudaDeviceActions[I];
1513     assert(AssembleAction->getType() == types::TY_Object);
1514     assert(AssembleAction->getInputs().size() == 1);
1515 
1516     Action* BackendAction = AssembleAction->getInputs()[0];
1517     assert(BackendAction->getType() == types::TY_PP_Asm);
1518 
1519     for (auto &A : {AssembleAction, BackendAction}) {
1520       OffloadAction::DeviceDependences DDep;
1521       DDep.add(*A, *CudaTC, CudaArchToString(GpuArchList[I]), Action::OFK_Cuda);
1522       DeviceActions.push_back(C.MakeAction<OffloadAction>(DDep, A->getType()));
1523     }
1524   }
1525   auto FatbinAction =
1526       C.MakeAction<LinkJobAction>(DeviceActions, types::TY_CUDA_FATBIN);
1527 
1528   // Return a new host action that incorporates original host action and all
1529   // device actions.
1530   OffloadAction::HostDependence HDep(*HostAction, *HostTC,
1531                                      /*BoundArch=*/nullptr, Action::OFK_Cuda);
1532   OffloadAction::DeviceDependences DDep;
1533   DDep.add(*FatbinAction, *CudaTC, /*BoundArch=*/nullptr, Action::OFK_Cuda);
1534   return C.MakeAction<OffloadAction>(HDep, DDep);
1535 }
1536 
1537 void Driver::BuildActions(Compilation &C, DerivedArgList &Args,
1538                           const InputList &Inputs, ActionList &Actions) const {
1539   llvm::PrettyStackTraceString CrashInfo("Building compilation actions");
1540 
1541   if (!SuppressMissingInputWarning && Inputs.empty()) {
1542     Diag(clang::diag::err_drv_no_input_files);
1543     return;
1544   }
1545 
1546   Arg *FinalPhaseArg;
1547   phases::ID FinalPhase = getFinalPhase(Args, &FinalPhaseArg);
1548 
1549   if (FinalPhase == phases::Link && Args.hasArg(options::OPT_emit_llvm)) {
1550     Diag(clang::diag::err_drv_emit_llvm_link);
1551   }
1552 
1553   // Reject -Z* at the top level, these options should never have been exposed
1554   // by gcc.
1555   if (Arg *A = Args.getLastArg(options::OPT_Z_Joined))
1556     Diag(clang::diag::err_drv_use_of_Z_option) << A->getAsString(Args);
1557 
1558   // Diagnose misuse of /Fo.
1559   if (Arg *A = Args.getLastArg(options::OPT__SLASH_Fo)) {
1560     StringRef V = A->getValue();
1561     if (Inputs.size() > 1 && !V.empty() &&
1562         !llvm::sys::path::is_separator(V.back())) {
1563       // Check whether /Fo tries to name an output file for multiple inputs.
1564       Diag(clang::diag::err_drv_out_file_argument_with_multiple_sources)
1565           << A->getSpelling() << V;
1566       Args.eraseArg(options::OPT__SLASH_Fo);
1567     }
1568   }
1569 
1570   // Diagnose misuse of /Fa.
1571   if (Arg *A = Args.getLastArg(options::OPT__SLASH_Fa)) {
1572     StringRef V = A->getValue();
1573     if (Inputs.size() > 1 && !V.empty() &&
1574         !llvm::sys::path::is_separator(V.back())) {
1575       // Check whether /Fa tries to name an asm file for multiple inputs.
1576       Diag(clang::diag::err_drv_out_file_argument_with_multiple_sources)
1577           << A->getSpelling() << V;
1578       Args.eraseArg(options::OPT__SLASH_Fa);
1579     }
1580   }
1581 
1582   // Diagnose misuse of /o.
1583   if (Arg *A = Args.getLastArg(options::OPT__SLASH_o)) {
1584     if (A->getValue()[0] == '\0') {
1585       // It has to have a value.
1586       Diag(clang::diag::err_drv_missing_argument) << A->getSpelling() << 1;
1587       Args.eraseArg(options::OPT__SLASH_o);
1588     }
1589   }
1590 
1591   // Diagnose unsupported forms of /Yc /Yu. Ignore /Yc/Yu for now if:
1592   // * no filename after it
1593   // * both /Yc and /Yu passed but with different filenames
1594   // * corresponding file not also passed as /FI
1595   Arg *YcArg = Args.getLastArg(options::OPT__SLASH_Yc);
1596   Arg *YuArg = Args.getLastArg(options::OPT__SLASH_Yu);
1597   if (YcArg && YcArg->getValue()[0] == '\0') {
1598     Diag(clang::diag::warn_drv_ycyu_no_arg_clang_cl) << YcArg->getSpelling();
1599     Args.eraseArg(options::OPT__SLASH_Yc);
1600     YcArg = nullptr;
1601   }
1602   if (YuArg && YuArg->getValue()[0] == '\0') {
1603     Diag(clang::diag::warn_drv_ycyu_no_arg_clang_cl) << YuArg->getSpelling();
1604     Args.eraseArg(options::OPT__SLASH_Yu);
1605     YuArg = nullptr;
1606   }
1607   if (YcArg && YuArg && strcmp(YcArg->getValue(), YuArg->getValue()) != 0) {
1608     Diag(clang::diag::warn_drv_ycyu_different_arg_clang_cl);
1609     Args.eraseArg(options::OPT__SLASH_Yc);
1610     Args.eraseArg(options::OPT__SLASH_Yu);
1611     YcArg = YuArg = nullptr;
1612   }
1613   if (YcArg || YuArg) {
1614     StringRef Val = YcArg ? YcArg->getValue() : YuArg->getValue();
1615     bool FoundMatchingInclude = false;
1616     for (const Arg *Inc : Args.filtered(options::OPT_include)) {
1617       // FIXME: Do case-insensitive matching and consider / and \ as equal.
1618       if (Inc->getValue() == Val)
1619         FoundMatchingInclude = true;
1620     }
1621     if (!FoundMatchingInclude) {
1622       Diag(clang::diag::warn_drv_ycyu_no_fi_arg_clang_cl)
1623           << (YcArg ? YcArg : YuArg)->getSpelling();
1624       Args.eraseArg(options::OPT__SLASH_Yc);
1625       Args.eraseArg(options::OPT__SLASH_Yu);
1626       YcArg = YuArg = nullptr;
1627     }
1628   }
1629   if (YcArg && Inputs.size() > 1) {
1630     Diag(clang::diag::warn_drv_yc_multiple_inputs_clang_cl);
1631     Args.eraseArg(options::OPT__SLASH_Yc);
1632     YcArg = nullptr;
1633   }
1634   if (Args.hasArg(options::OPT__SLASH_Y_)) {
1635     // /Y- disables all pch handling.  Rather than check for it everywhere,
1636     // just remove clang-cl pch-related flags here.
1637     Args.eraseArg(options::OPT__SLASH_Fp);
1638     Args.eraseArg(options::OPT__SLASH_Yc);
1639     Args.eraseArg(options::OPT__SLASH_Yu);
1640     YcArg = YuArg = nullptr;
1641   }
1642 
1643   // Track the host offload kinds used on this compilation.
1644   unsigned CompilationActiveOffloadHostKinds = 0u;
1645 
1646   // Construct the actions to perform.
1647   ActionList LinkerInputs;
1648 
1649   llvm::SmallVector<phases::ID, phases::MaxNumberOfPhases> PL;
1650   for (auto &I : Inputs) {
1651     types::ID InputType = I.first;
1652     const Arg *InputArg = I.second;
1653 
1654     PL.clear();
1655     types::getCompilationPhases(InputType, PL);
1656 
1657     // If the first step comes after the final phase we are doing as part of
1658     // this compilation, warn the user about it.
1659     phases::ID InitialPhase = PL[0];
1660     if (InitialPhase > FinalPhase) {
1661       // Claim here to avoid the more general unused warning.
1662       InputArg->claim();
1663 
1664       // Suppress all unused style warnings with -Qunused-arguments
1665       if (Args.hasArg(options::OPT_Qunused_arguments))
1666         continue;
1667 
1668       // Special case when final phase determined by binary name, rather than
1669       // by a command-line argument with a corresponding Arg.
1670       if (CCCIsCPP())
1671         Diag(clang::diag::warn_drv_input_file_unused_by_cpp)
1672             << InputArg->getAsString(Args) << getPhaseName(InitialPhase);
1673       // Special case '-E' warning on a previously preprocessed file to make
1674       // more sense.
1675       else if (InitialPhase == phases::Compile &&
1676                FinalPhase == phases::Preprocess &&
1677                getPreprocessedType(InputType) == types::TY_INVALID)
1678         Diag(clang::diag::warn_drv_preprocessed_input_file_unused)
1679             << InputArg->getAsString(Args) << !!FinalPhaseArg
1680             << (FinalPhaseArg ? FinalPhaseArg->getOption().getName() : "");
1681       else
1682         Diag(clang::diag::warn_drv_input_file_unused)
1683             << InputArg->getAsString(Args) << getPhaseName(InitialPhase)
1684             << !!FinalPhaseArg
1685             << (FinalPhaseArg ? FinalPhaseArg->getOption().getName() : "");
1686       continue;
1687     }
1688 
1689     if (YcArg) {
1690       // Add a separate precompile phase for the compile phase.
1691       if (FinalPhase >= phases::Compile) {
1692         const types::ID HeaderType = lookupHeaderTypeForSourceType(InputType);
1693         llvm::SmallVector<phases::ID, phases::MaxNumberOfPhases> PCHPL;
1694         types::getCompilationPhases(HeaderType, PCHPL);
1695         Arg *PchInputArg = MakeInputArg(Args, Opts, YcArg->getValue());
1696 
1697         // Build the pipeline for the pch file.
1698         Action *ClangClPch =
1699             C.MakeAction<InputAction>(*PchInputArg, HeaderType);
1700         for (phases::ID Phase : PCHPL)
1701           ClangClPch = ConstructPhaseAction(C, Args, Phase, ClangClPch);
1702         assert(ClangClPch);
1703         Actions.push_back(ClangClPch);
1704         // The driver currently exits after the first failed command.  This
1705         // relies on that behavior, to make sure if the pch generation fails,
1706         // the main compilation won't run.
1707       }
1708     }
1709 
1710     phases::ID CudaInjectionPhase =
1711         (phases::Compile < FinalPhase &&
1712          llvm::find(PL, phases::Compile) != PL.end())
1713             ? phases::Compile
1714             : FinalPhase;
1715 
1716     // Track the host offload kinds used on this input.
1717     unsigned InputActiveOffloadHostKinds = 0u;
1718 
1719     // Build the pipeline for this file.
1720     Action *Current = C.MakeAction<InputAction>(*InputArg, InputType);
1721     for (SmallVectorImpl<phases::ID>::iterator i = PL.begin(), e = PL.end();
1722          i != e; ++i) {
1723       phases::ID Phase = *i;
1724 
1725       // We are done if this step is past what the user requested.
1726       if (Phase > FinalPhase)
1727         break;
1728 
1729       // Queue linker inputs.
1730       if (Phase == phases::Link) {
1731         assert((i + 1) == e && "linking must be final compilation step.");
1732         LinkerInputs.push_back(Current);
1733         Current = nullptr;
1734         break;
1735       }
1736 
1737       // Some types skip the assembler phase (e.g., llvm-bc), but we can't
1738       // encode this in the steps because the intermediate type depends on
1739       // arguments. Just special case here.
1740       if (Phase == phases::Assemble && Current->getType() != types::TY_PP_Asm)
1741         continue;
1742 
1743       // Otherwise construct the appropriate action.
1744       Current = ConstructPhaseAction(C, Args, Phase, Current);
1745 
1746       if (InputType == types::TY_CUDA && Phase == CudaInjectionPhase) {
1747         Current = buildCudaActions(C, Args, InputArg, Current, Actions);
1748         if (!Current)
1749           break;
1750 
1751         // We produced a CUDA action for this input, so the host has to support
1752         // CUDA.
1753         InputActiveOffloadHostKinds |= Action::OFK_Cuda;
1754         CompilationActiveOffloadHostKinds |= Action::OFK_Cuda;
1755       }
1756 
1757       if (Current->getType() == types::TY_Nothing)
1758         break;
1759     }
1760 
1761     // If we ended with something, add to the output list. Also, propagate the
1762     // offload information to the top-level host action related with the current
1763     // input.
1764     if (Current) {
1765       if (InputActiveOffloadHostKinds)
1766         Current->propagateHostOffloadInfo(InputActiveOffloadHostKinds,
1767                                           /*BoundArch=*/nullptr);
1768       Actions.push_back(Current);
1769     }
1770   }
1771 
1772   // Add a link action if necessary and propagate the offload information for
1773   // the current compilation.
1774   if (!LinkerInputs.empty()) {
1775     Actions.push_back(
1776         C.MakeAction<LinkJobAction>(LinkerInputs, types::TY_Image));
1777     Actions.back()->propagateHostOffloadInfo(CompilationActiveOffloadHostKinds,
1778                                              /*BoundArch=*/nullptr);
1779   }
1780 
1781   // If we are linking, claim any options which are obviously only used for
1782   // compilation.
1783   if (FinalPhase == phases::Link && PL.size() == 1) {
1784     Args.ClaimAllArgs(options::OPT_CompileOnly_Group);
1785     Args.ClaimAllArgs(options::OPT_cl_compile_Group);
1786   }
1787 
1788   // Claim ignored clang-cl options.
1789   Args.ClaimAllArgs(options::OPT_cl_ignored_Group);
1790 
1791   // Claim --cuda-host-only and --cuda-compile-host-device, which may be passed
1792   // to non-CUDA compilations and should not trigger warnings there.
1793   Args.ClaimAllArgs(options::OPT_cuda_host_only);
1794   Args.ClaimAllArgs(options::OPT_cuda_compile_host_device);
1795 }
1796 
1797 Action *Driver::ConstructPhaseAction(Compilation &C, const ArgList &Args,
1798                                      phases::ID Phase, Action *Input) const {
1799   llvm::PrettyStackTraceString CrashInfo("Constructing phase actions");
1800   // Build the appropriate action.
1801   switch (Phase) {
1802   case phases::Link:
1803     llvm_unreachable("link action invalid here.");
1804   case phases::Preprocess: {
1805     types::ID OutputTy;
1806     // -{M, MM} alter the output type.
1807     if (Args.hasArg(options::OPT_M, options::OPT_MM)) {
1808       OutputTy = types::TY_Dependencies;
1809     } else {
1810       OutputTy = Input->getType();
1811       if (!Args.hasFlag(options::OPT_frewrite_includes,
1812                         options::OPT_fno_rewrite_includes, false) &&
1813           !CCGenDiagnostics)
1814         OutputTy = types::getPreprocessedType(OutputTy);
1815       assert(OutputTy != types::TY_INVALID &&
1816              "Cannot preprocess this input type!");
1817     }
1818     return C.MakeAction<PreprocessJobAction>(Input, OutputTy);
1819   }
1820   case phases::Precompile: {
1821     types::ID OutputTy = getPrecompiledType(Input->getType());
1822     assert(OutputTy != types::TY_INVALID &&
1823            "Cannot precompile this input type!");
1824     if (Args.hasArg(options::OPT_fsyntax_only)) {
1825       // Syntax checks should not emit a PCH file
1826       OutputTy = types::TY_Nothing;
1827     }
1828     return C.MakeAction<PrecompileJobAction>(Input, OutputTy);
1829   }
1830   case phases::Compile: {
1831     if (Args.hasArg(options::OPT_fsyntax_only))
1832       return C.MakeAction<CompileJobAction>(Input, types::TY_Nothing);
1833     if (Args.hasArg(options::OPT_rewrite_objc))
1834       return C.MakeAction<CompileJobAction>(Input, types::TY_RewrittenObjC);
1835     if (Args.hasArg(options::OPT_rewrite_legacy_objc))
1836       return C.MakeAction<CompileJobAction>(Input,
1837                                             types::TY_RewrittenLegacyObjC);
1838     if (Args.hasArg(options::OPT__analyze, options::OPT__analyze_auto))
1839       return C.MakeAction<AnalyzeJobAction>(Input, types::TY_Plist);
1840     if (Args.hasArg(options::OPT__migrate))
1841       return C.MakeAction<MigrateJobAction>(Input, types::TY_Remap);
1842     if (Args.hasArg(options::OPT_emit_ast))
1843       return C.MakeAction<CompileJobAction>(Input, types::TY_AST);
1844     if (Args.hasArg(options::OPT_module_file_info))
1845       return C.MakeAction<CompileJobAction>(Input, types::TY_ModuleFile);
1846     if (Args.hasArg(options::OPT_verify_pch))
1847       return C.MakeAction<VerifyPCHJobAction>(Input, types::TY_Nothing);
1848     return C.MakeAction<CompileJobAction>(Input, types::TY_LLVM_BC);
1849   }
1850   case phases::Backend: {
1851     if (isUsingLTO()) {
1852       types::ID Output =
1853           Args.hasArg(options::OPT_S) ? types::TY_LTO_IR : types::TY_LTO_BC;
1854       return C.MakeAction<BackendJobAction>(Input, Output);
1855     }
1856     if (Args.hasArg(options::OPT_emit_llvm)) {
1857       types::ID Output =
1858           Args.hasArg(options::OPT_S) ? types::TY_LLVM_IR : types::TY_LLVM_BC;
1859       return C.MakeAction<BackendJobAction>(Input, Output);
1860     }
1861     return C.MakeAction<BackendJobAction>(Input, types::TY_PP_Asm);
1862   }
1863   case phases::Assemble:
1864     return C.MakeAction<AssembleJobAction>(std::move(Input), types::TY_Object);
1865   }
1866 
1867   llvm_unreachable("invalid phase in ConstructPhaseAction");
1868 }
1869 
1870 void Driver::BuildJobs(Compilation &C) const {
1871   llvm::PrettyStackTraceString CrashInfo("Building compilation jobs");
1872 
1873   Arg *FinalOutput = C.getArgs().getLastArg(options::OPT_o);
1874 
1875   // It is an error to provide a -o option if we are making multiple output
1876   // files.
1877   if (FinalOutput) {
1878     unsigned NumOutputs = 0;
1879     for (const Action *A : C.getActions())
1880       if (A->getType() != types::TY_Nothing)
1881         ++NumOutputs;
1882 
1883     if (NumOutputs > 1) {
1884       Diag(clang::diag::err_drv_output_argument_with_multiple_files);
1885       FinalOutput = nullptr;
1886     }
1887   }
1888 
1889   // Collect the list of architectures.
1890   llvm::StringSet<> ArchNames;
1891   if (C.getDefaultToolChain().getTriple().isOSBinFormatMachO())
1892     for (const Arg *A : C.getArgs())
1893       if (A->getOption().matches(options::OPT_arch))
1894         ArchNames.insert(A->getValue());
1895 
1896   // Set of (Action, canonical ToolChain triple) pairs we've built jobs for.
1897   std::map<std::pair<const Action *, std::string>, InputInfo> CachedResults;
1898   for (Action *A : C.getActions()) {
1899     // If we are linking an image for multiple archs then the linker wants
1900     // -arch_multiple and -final_output <final image name>. Unfortunately, this
1901     // doesn't fit in cleanly because we have to pass this information down.
1902     //
1903     // FIXME: This is a hack; find a cleaner way to integrate this into the
1904     // process.
1905     const char *LinkingOutput = nullptr;
1906     if (isa<LipoJobAction>(A)) {
1907       if (FinalOutput)
1908         LinkingOutput = FinalOutput->getValue();
1909       else
1910         LinkingOutput = getDefaultImageName();
1911     }
1912 
1913     BuildJobsForAction(C, A, &C.getDefaultToolChain(),
1914                        /*BoundArch*/ nullptr,
1915                        /*AtTopLevel*/ true,
1916                        /*MultipleArchs*/ ArchNames.size() > 1,
1917                        /*LinkingOutput*/ LinkingOutput, CachedResults,
1918                        /*BuildForOffloadDevice*/ false);
1919   }
1920 
1921   // If the user passed -Qunused-arguments or there were errors, don't warn
1922   // about any unused arguments.
1923   if (Diags.hasErrorOccurred() ||
1924       C.getArgs().hasArg(options::OPT_Qunused_arguments))
1925     return;
1926 
1927   // Claim -### here.
1928   (void)C.getArgs().hasArg(options::OPT__HASH_HASH_HASH);
1929 
1930   // Claim --driver-mode, --rsp-quoting, it was handled earlier.
1931   (void)C.getArgs().hasArg(options::OPT_driver_mode);
1932   (void)C.getArgs().hasArg(options::OPT_rsp_quoting);
1933 
1934   for (Arg *A : C.getArgs()) {
1935     // FIXME: It would be nice to be able to send the argument to the
1936     // DiagnosticsEngine, so that extra values, position, and so on could be
1937     // printed.
1938     if (!A->isClaimed()) {
1939       if (A->getOption().hasFlag(options::NoArgumentUnused))
1940         continue;
1941 
1942       // Suppress the warning automatically if this is just a flag, and it is an
1943       // instance of an argument we already claimed.
1944       const Option &Opt = A->getOption();
1945       if (Opt.getKind() == Option::FlagClass) {
1946         bool DuplicateClaimed = false;
1947 
1948         for (const Arg *AA : C.getArgs().filtered(&Opt)) {
1949           if (AA->isClaimed()) {
1950             DuplicateClaimed = true;
1951             break;
1952           }
1953         }
1954 
1955         if (DuplicateClaimed)
1956           continue;
1957       }
1958 
1959       // In clang-cl, don't mention unknown arguments here since they have
1960       // already been warned about.
1961       if (!IsCLMode() || !A->getOption().matches(options::OPT_UNKNOWN))
1962         Diag(clang::diag::warn_drv_unused_argument)
1963             << A->getAsString(C.getArgs());
1964     }
1965   }
1966 }
1967 /// Collapse an offloading action looking for a job of the given type. The input
1968 /// action is changed to the input of the collapsed sequence. If we effectively
1969 /// had a collapse return the corresponding offloading action, otherwise return
1970 /// null.
1971 template <typename T>
1972 static OffloadAction *collapseOffloadingAction(Action *&CurAction) {
1973   if (!CurAction)
1974     return nullptr;
1975   if (auto *OA = dyn_cast<OffloadAction>(CurAction)) {
1976     if (OA->hasHostDependence())
1977       if (auto *HDep = dyn_cast<T>(OA->getHostDependence())) {
1978         CurAction = HDep;
1979         return OA;
1980       }
1981     if (OA->hasSingleDeviceDependence())
1982       if (auto *DDep = dyn_cast<T>(OA->getSingleDeviceDependence())) {
1983         CurAction = DDep;
1984         return OA;
1985       }
1986   }
1987   return nullptr;
1988 }
1989 // Returns a Tool for a given JobAction.  In case the action and its
1990 // predecessors can be combined, updates Inputs with the inputs of the
1991 // first combined action. If one of the collapsed actions is a
1992 // CudaHostAction, updates CollapsedCHA with the pointer to it so the
1993 // caller can deal with extra handling such action requires.
1994 static const Tool *selectToolForJob(Compilation &C, bool SaveTemps,
1995                                     bool EmbedBitcode, const ToolChain *TC,
1996                                     const JobAction *JA,
1997                                     const ActionList *&Inputs,
1998                                     ActionList &CollapsedOffloadAction) {
1999   const Tool *ToolForJob = nullptr;
2000   CollapsedOffloadAction.clear();
2001 
2002   // See if we should look for a compiler with an integrated assembler. We match
2003   // bottom up, so what we are actually looking for is an assembler job with a
2004   // compiler input.
2005 
2006   // Look through offload actions between assembler and backend actions.
2007   Action *BackendJA = (isa<AssembleJobAction>(JA) && Inputs->size() == 1)
2008                           ? *Inputs->begin()
2009                           : nullptr;
2010   auto *BackendOA = collapseOffloadingAction<BackendJobAction>(BackendJA);
2011 
2012   if (TC->useIntegratedAs() && !SaveTemps &&
2013       !C.getArgs().hasArg(options::OPT_via_file_asm) &&
2014       !C.getArgs().hasArg(options::OPT__SLASH_FA) &&
2015       !C.getArgs().hasArg(options::OPT__SLASH_Fa) && BackendJA &&
2016       isa<BackendJobAction>(BackendJA)) {
2017     // A BackendJob is always preceded by a CompileJob, and without -save-temps
2018     // or -fembed-bitcode, they will always get combined together, so instead of
2019     // checking the backend tool, check if the tool for the CompileJob has an
2020     // integrated assembler. For -fembed-bitcode, CompileJob is still used to
2021     // look up tools for BackendJob, but they need to match before we can split
2022     // them.
2023 
2024     // Look through offload actions between backend and compile actions.
2025     Action *CompileJA = *BackendJA->getInputs().begin();
2026     auto *CompileOA = collapseOffloadingAction<CompileJobAction>(CompileJA);
2027 
2028     assert(CompileJA && isa<CompileJobAction>(CompileJA) &&
2029            "Backend job is not preceeded by compile job.");
2030     const Tool *Compiler = TC->SelectTool(*cast<CompileJobAction>(CompileJA));
2031     if (!Compiler)
2032       return nullptr;
2033     // When using -fembed-bitcode, it is required to have the same tool (clang)
2034     // for both CompilerJA and BackendJA. Otherwise, combine two stages.
2035     if (EmbedBitcode) {
2036       JobAction *InputJA = cast<JobAction>(*Inputs->begin());
2037       const Tool *BackendTool = TC->SelectTool(*InputJA);
2038       if (BackendTool == Compiler)
2039         CompileJA = InputJA;
2040     }
2041     if (Compiler->hasIntegratedAssembler()) {
2042       Inputs = &CompileJA->getInputs();
2043       ToolForJob = Compiler;
2044       // Save the collapsed offload actions because they may still contain
2045       // device actions.
2046       if (CompileOA)
2047         CollapsedOffloadAction.push_back(CompileOA);
2048       if (BackendOA)
2049         CollapsedOffloadAction.push_back(BackendOA);
2050     }
2051   }
2052 
2053   // A backend job should always be combined with the preceding compile job
2054   // unless OPT_save_temps or OPT_fembed_bitcode is enabled and the compiler is
2055   // capable of emitting LLVM IR as an intermediate output.
2056   if (isa<BackendJobAction>(JA)) {
2057     // Check if the compiler supports emitting LLVM IR.
2058     assert(Inputs->size() == 1);
2059 
2060     // Look through offload actions between backend and compile actions.
2061     Action *CompileJA = *JA->getInputs().begin();
2062     auto *CompileOA = collapseOffloadingAction<CompileJobAction>(CompileJA);
2063 
2064     assert(CompileJA && isa<CompileJobAction>(CompileJA) &&
2065            "Backend job is not preceeded by compile job.");
2066     const Tool *Compiler = TC->SelectTool(*cast<CompileJobAction>(CompileJA));
2067     if (!Compiler)
2068       return nullptr;
2069     if (!Compiler->canEmitIR() ||
2070         (!SaveTemps && !EmbedBitcode)) {
2071       Inputs = &CompileJA->getInputs();
2072       ToolForJob = Compiler;
2073 
2074       if (CompileOA)
2075         CollapsedOffloadAction.push_back(CompileOA);
2076     }
2077   }
2078 
2079   // Otherwise use the tool for the current job.
2080   if (!ToolForJob)
2081     ToolForJob = TC->SelectTool(*JA);
2082 
2083   // See if we should use an integrated preprocessor. We do so when we have
2084   // exactly one input, since this is the only use case we care about
2085   // (irrelevant since we don't support combine yet).
2086 
2087   // Look through offload actions after preprocessing.
2088   Action *PreprocessJA = (Inputs->size() == 1) ? *Inputs->begin() : nullptr;
2089   auto *PreprocessOA =
2090       collapseOffloadingAction<PreprocessJobAction>(PreprocessJA);
2091 
2092   if (PreprocessJA && isa<PreprocessJobAction>(PreprocessJA) &&
2093       !C.getArgs().hasArg(options::OPT_no_integrated_cpp) &&
2094       !C.getArgs().hasArg(options::OPT_traditional_cpp) && !SaveTemps &&
2095       !C.getArgs().hasArg(options::OPT_rewrite_objc) &&
2096       ToolForJob->hasIntegratedCPP()) {
2097     Inputs = &PreprocessJA->getInputs();
2098     if (PreprocessOA)
2099       CollapsedOffloadAction.push_back(PreprocessOA);
2100   }
2101 
2102   return ToolForJob;
2103 }
2104 
2105 InputInfo Driver::BuildJobsForAction(
2106     Compilation &C, const Action *A, const ToolChain *TC, const char *BoundArch,
2107     bool AtTopLevel, bool MultipleArchs, const char *LinkingOutput,
2108     std::map<std::pair<const Action *, std::string>, InputInfo> &CachedResults,
2109     bool BuildForOffloadDevice) const {
2110   // The bound arch is not necessarily represented in the toolchain's triple --
2111   // for example, armv7 and armv7s both map to the same triple -- so we need
2112   // both in our map.
2113   std::string TriplePlusArch = TC->getTriple().normalize();
2114   if (BoundArch) {
2115     TriplePlusArch += "-";
2116     TriplePlusArch += BoundArch;
2117   }
2118   std::pair<const Action *, std::string> ActionTC = {A, TriplePlusArch};
2119   auto CachedResult = CachedResults.find(ActionTC);
2120   if (CachedResult != CachedResults.end()) {
2121     return CachedResult->second;
2122   }
2123   InputInfo Result = BuildJobsForActionNoCache(
2124       C, A, TC, BoundArch, AtTopLevel, MultipleArchs, LinkingOutput,
2125       CachedResults, BuildForOffloadDevice);
2126   CachedResults[ActionTC] = Result;
2127   return Result;
2128 }
2129 
2130 InputInfo Driver::BuildJobsForActionNoCache(
2131     Compilation &C, const Action *A, const ToolChain *TC, const char *BoundArch,
2132     bool AtTopLevel, bool MultipleArchs, const char *LinkingOutput,
2133     std::map<std::pair<const Action *, std::string>, InputInfo> &CachedResults,
2134     bool BuildForOffloadDevice) const {
2135   llvm::PrettyStackTraceString CrashInfo("Building compilation jobs");
2136 
2137   InputInfoList OffloadDependencesInputInfo;
2138   if (const OffloadAction *OA = dyn_cast<OffloadAction>(A)) {
2139     // The offload action is expected to be used in four different situations.
2140     //
2141     // a) Set a toolchain/architecture/kind for a host action:
2142     //    Host Action 1 -> OffloadAction -> Host Action 2
2143     //
2144     // b) Set a toolchain/architecture/kind for a device action;
2145     //    Device Action 1 -> OffloadAction -> Device Action 2
2146     //
2147     // c) Specify a device dependences to a host action;
2148     //    Device Action 1  _
2149     //                      \
2150     //      Host Action 1  ---> OffloadAction -> Host Action 2
2151     //
2152     // d) Specify a host dependence to a device action.
2153     //      Host Action 1  _
2154     //                      \
2155     //    Device Action 1  ---> OffloadAction -> Device Action 2
2156     //
2157     // For a) and b), we just return the job generated for the dependence. For
2158     // c) and d) we override the current action with the host/device dependence
2159     // if the current toolchain is host/device and set the offload dependences
2160     // info with the jobs obtained from the device/host dependence(s).
2161 
2162     // If there is a single device option, just generate the job for it.
2163     if (OA->hasSingleDeviceDependence()) {
2164       InputInfo DevA;
2165       OA->doOnEachDeviceDependence([&](Action *DepA, const ToolChain *DepTC,
2166                                        const char *DepBoundArch) {
2167         DevA =
2168             BuildJobsForAction(C, DepA, DepTC, DepBoundArch, AtTopLevel,
2169                                /*MultipleArchs*/ !!DepBoundArch, LinkingOutput,
2170                                CachedResults, /*BuildForOffloadDevice=*/true);
2171       });
2172       return DevA;
2173     }
2174 
2175     // If 'Action 2' is host, we generate jobs for the device dependences and
2176     // override the current action with the host dependence. Otherwise, we
2177     // generate the host dependences and override the action with the device
2178     // dependence. The dependences can't therefore be a top-level action.
2179     OA->doOnEachDependence(
2180         /*IsHostDependence=*/BuildForOffloadDevice,
2181         [&](Action *DepA, const ToolChain *DepTC, const char *DepBoundArch) {
2182           OffloadDependencesInputInfo.push_back(BuildJobsForAction(
2183               C, DepA, DepTC, DepBoundArch, /*AtTopLevel=*/false,
2184               /*MultipleArchs*/ !!DepBoundArch, LinkingOutput, CachedResults,
2185               /*BuildForOffloadDevice=*/DepA->getOffloadingDeviceKind() !=
2186                   Action::OFK_None));
2187         });
2188 
2189     A = BuildForOffloadDevice
2190             ? OA->getSingleDeviceDependence(/*DoNotConsiderHostActions=*/true)
2191             : OA->getHostDependence();
2192   }
2193 
2194   if (const InputAction *IA = dyn_cast<InputAction>(A)) {
2195     // FIXME: It would be nice to not claim this here; maybe the old scheme of
2196     // just using Args was better?
2197     const Arg &Input = IA->getInputArg();
2198     Input.claim();
2199     if (Input.getOption().matches(options::OPT_INPUT)) {
2200       const char *Name = Input.getValue();
2201       return InputInfo(A, Name, /* BaseInput = */ Name);
2202     }
2203     return InputInfo(A, &Input, /* BaseInput = */ "");
2204   }
2205 
2206   if (const BindArchAction *BAA = dyn_cast<BindArchAction>(A)) {
2207     const ToolChain *TC;
2208     const char *ArchName = BAA->getArchName();
2209 
2210     if (ArchName)
2211       TC = &getToolChain(C.getArgs(),
2212                          computeTargetTriple(*this, DefaultTargetTriple,
2213                                              C.getArgs(), ArchName));
2214     else
2215       TC = &C.getDefaultToolChain();
2216 
2217     return BuildJobsForAction(C, *BAA->input_begin(), TC, ArchName, AtTopLevel,
2218                               MultipleArchs, LinkingOutput, CachedResults,
2219                               BuildForOffloadDevice);
2220   }
2221 
2222 
2223   const ActionList *Inputs = &A->getInputs();
2224 
2225   const JobAction *JA = cast<JobAction>(A);
2226   ActionList CollapsedOffloadActions;
2227 
2228   const Tool *T =
2229       selectToolForJob(C, isSaveTempsEnabled(), embedBitcodeEnabled(), TC, JA,
2230                        Inputs, CollapsedOffloadActions);
2231   if (!T)
2232     return InputInfo();
2233 
2234   // If we've collapsed action list that contained OffloadAction we
2235   // need to build jobs for host/device-side inputs it may have held.
2236   for (const auto *OA : CollapsedOffloadActions)
2237     cast<OffloadAction>(OA)->doOnEachDependence(
2238         /*IsHostDependence=*/BuildForOffloadDevice,
2239         [&](Action *DepA, const ToolChain *DepTC, const char *DepBoundArch) {
2240           OffloadDependencesInputInfo.push_back(BuildJobsForAction(
2241               C, DepA, DepTC, DepBoundArch, /* AtTopLevel */ false,
2242               /*MultipleArchs=*/!!DepBoundArch, LinkingOutput, CachedResults,
2243               /*BuildForOffloadDevice=*/DepA->getOffloadingDeviceKind() !=
2244                   Action::OFK_None));
2245         });
2246 
2247   // Only use pipes when there is exactly one input.
2248   InputInfoList InputInfos;
2249   for (const Action *Input : *Inputs) {
2250     // Treat dsymutil and verify sub-jobs as being at the top-level too, they
2251     // shouldn't get temporary output names.
2252     // FIXME: Clean this up.
2253     bool SubJobAtTopLevel =
2254         AtTopLevel && (isa<DsymutilJobAction>(A) || isa<VerifyJobAction>(A));
2255     InputInfos.push_back(BuildJobsForAction(
2256         C, Input, TC, BoundArch, SubJobAtTopLevel, MultipleArchs, LinkingOutput,
2257         CachedResults, BuildForOffloadDevice));
2258   }
2259 
2260   // Always use the first input as the base input.
2261   const char *BaseInput = InputInfos[0].getBaseInput();
2262 
2263   // ... except dsymutil actions, which use their actual input as the base
2264   // input.
2265   if (JA->getType() == types::TY_dSYM)
2266     BaseInput = InputInfos[0].getFilename();
2267 
2268   // Append outputs of offload device jobs to the input list
2269   if (!OffloadDependencesInputInfo.empty())
2270     InputInfos.append(OffloadDependencesInputInfo.begin(),
2271                       OffloadDependencesInputInfo.end());
2272 
2273   // Set the effective triple of the toolchain for the duration of this job.
2274   llvm::Triple EffectiveTriple;
2275   const ToolChain &ToolTC = T->getToolChain();
2276   const ArgList &Args = C.getArgsForToolChain(TC, BoundArch);
2277   if (InputInfos.size() != 1) {
2278     EffectiveTriple = llvm::Triple(ToolTC.ComputeEffectiveClangTriple(Args));
2279   } else {
2280     // Pass along the input type if it can be unambiguously determined.
2281     EffectiveTriple = llvm::Triple(
2282         ToolTC.ComputeEffectiveClangTriple(Args, InputInfos[0].getType()));
2283   }
2284   RegisterEffectiveTriple TripleRAII(ToolTC, EffectiveTriple);
2285 
2286   // Determine the place to write output to, if any.
2287   InputInfo Result;
2288   if (JA->getType() == types::TY_Nothing)
2289     Result = InputInfo(A, BaseInput);
2290   else
2291     Result = InputInfo(A, GetNamedOutputPath(C, *JA, BaseInput, BoundArch,
2292                                              AtTopLevel, MultipleArchs,
2293                                              TC->getTriple().normalize()),
2294                        BaseInput);
2295 
2296   if (CCCPrintBindings && !CCGenDiagnostics) {
2297     llvm::errs() << "# \"" << T->getToolChain().getTripleString() << '"'
2298                  << " - \"" << T->getName() << "\", inputs: [";
2299     for (unsigned i = 0, e = InputInfos.size(); i != e; ++i) {
2300       llvm::errs() << InputInfos[i].getAsString();
2301       if (i + 1 != e)
2302         llvm::errs() << ", ";
2303     }
2304     llvm::errs() << "], output: " << Result.getAsString() << "\n";
2305   } else {
2306     T->ConstructJob(C, *JA, Result, InputInfos,
2307                     C.getArgsForToolChain(TC, BoundArch), LinkingOutput);
2308   }
2309   return Result;
2310 }
2311 
2312 const char *Driver::getDefaultImageName() const {
2313   llvm::Triple Target(llvm::Triple::normalize(DefaultTargetTriple));
2314   return Target.isOSWindows() ? "a.exe" : "a.out";
2315 }
2316 
2317 /// \brief Create output filename based on ArgValue, which could either be a
2318 /// full filename, filename without extension, or a directory. If ArgValue
2319 /// does not provide a filename, then use BaseName, and use the extension
2320 /// suitable for FileType.
2321 static const char *MakeCLOutputFilename(const ArgList &Args, StringRef ArgValue,
2322                                         StringRef BaseName,
2323                                         types::ID FileType) {
2324   SmallString<128> Filename = ArgValue;
2325 
2326   if (ArgValue.empty()) {
2327     // If the argument is empty, output to BaseName in the current dir.
2328     Filename = BaseName;
2329   } else if (llvm::sys::path::is_separator(Filename.back())) {
2330     // If the argument is a directory, output to BaseName in that dir.
2331     llvm::sys::path::append(Filename, BaseName);
2332   }
2333 
2334   if (!llvm::sys::path::has_extension(ArgValue)) {
2335     // If the argument didn't provide an extension, then set it.
2336     const char *Extension = types::getTypeTempSuffix(FileType, true);
2337 
2338     if (FileType == types::TY_Image &&
2339         Args.hasArg(options::OPT__SLASH_LD, options::OPT__SLASH_LDd)) {
2340       // The output file is a dll.
2341       Extension = "dll";
2342     }
2343 
2344     llvm::sys::path::replace_extension(Filename, Extension);
2345   }
2346 
2347   return Args.MakeArgString(Filename.c_str());
2348 }
2349 
2350 const char *Driver::GetNamedOutputPath(Compilation &C, const JobAction &JA,
2351                                        const char *BaseInput,
2352                                        const char *BoundArch, bool AtTopLevel,
2353                                        bool MultipleArchs,
2354                                        StringRef NormalizedTriple) const {
2355   llvm::PrettyStackTraceString CrashInfo("Computing output path");
2356   // Output to a user requested destination?
2357   if (AtTopLevel && !isa<DsymutilJobAction>(JA) && !isa<VerifyJobAction>(JA)) {
2358     if (Arg *FinalOutput = C.getArgs().getLastArg(options::OPT_o))
2359       return C.addResultFile(FinalOutput->getValue(), &JA);
2360   }
2361 
2362   // For /P, preprocess to file named after BaseInput.
2363   if (C.getArgs().hasArg(options::OPT__SLASH_P)) {
2364     assert(AtTopLevel && isa<PreprocessJobAction>(JA));
2365     StringRef BaseName = llvm::sys::path::filename(BaseInput);
2366     StringRef NameArg;
2367     if (Arg *A = C.getArgs().getLastArg(options::OPT__SLASH_Fi))
2368       NameArg = A->getValue();
2369     return C.addResultFile(
2370         MakeCLOutputFilename(C.getArgs(), NameArg, BaseName, types::TY_PP_C),
2371         &JA);
2372   }
2373 
2374   // Default to writing to stdout?
2375   if (AtTopLevel && !CCGenDiagnostics &&
2376       (isa<PreprocessJobAction>(JA) || JA.getType() == types::TY_ModuleFile))
2377     return "-";
2378 
2379   // Is this the assembly listing for /FA?
2380   if (JA.getType() == types::TY_PP_Asm &&
2381       (C.getArgs().hasArg(options::OPT__SLASH_FA) ||
2382        C.getArgs().hasArg(options::OPT__SLASH_Fa))) {
2383     // Use /Fa and the input filename to determine the asm file name.
2384     StringRef BaseName = llvm::sys::path::filename(BaseInput);
2385     StringRef FaValue = C.getArgs().getLastArgValue(options::OPT__SLASH_Fa);
2386     return C.addResultFile(
2387         MakeCLOutputFilename(C.getArgs(), FaValue, BaseName, JA.getType()),
2388         &JA);
2389   }
2390 
2391   // Output to a temporary file?
2392   if ((!AtTopLevel && !isSaveTempsEnabled() &&
2393        !C.getArgs().hasArg(options::OPT__SLASH_Fo)) ||
2394       CCGenDiagnostics) {
2395     StringRef Name = llvm::sys::path::filename(BaseInput);
2396     std::pair<StringRef, StringRef> Split = Name.split('.');
2397     std::string TmpName = GetTemporaryPath(
2398         Split.first, types::getTypeTempSuffix(JA.getType(), IsCLMode()));
2399     return C.addTempFile(C.getArgs().MakeArgString(TmpName.c_str()));
2400   }
2401 
2402   SmallString<128> BasePath(BaseInput);
2403   StringRef BaseName;
2404 
2405   // Dsymutil actions should use the full path.
2406   if (isa<DsymutilJobAction>(JA) || isa<VerifyJobAction>(JA))
2407     BaseName = BasePath;
2408   else
2409     BaseName = llvm::sys::path::filename(BasePath);
2410 
2411   // Determine what the derived output name should be.
2412   const char *NamedOutput;
2413 
2414   if (JA.getType() == types::TY_Object &&
2415       C.getArgs().hasArg(options::OPT__SLASH_Fo, options::OPT__SLASH_o)) {
2416     // The /Fo or /o flag decides the object filename.
2417     StringRef Val =
2418         C.getArgs()
2419             .getLastArg(options::OPT__SLASH_Fo, options::OPT__SLASH_o)
2420             ->getValue();
2421     NamedOutput =
2422         MakeCLOutputFilename(C.getArgs(), Val, BaseName, types::TY_Object);
2423   } else if (JA.getType() == types::TY_Image &&
2424              C.getArgs().hasArg(options::OPT__SLASH_Fe,
2425                                 options::OPT__SLASH_o)) {
2426     // The /Fe or /o flag names the linked file.
2427     StringRef Val =
2428         C.getArgs()
2429             .getLastArg(options::OPT__SLASH_Fe, options::OPT__SLASH_o)
2430             ->getValue();
2431     NamedOutput =
2432         MakeCLOutputFilename(C.getArgs(), Val, BaseName, types::TY_Image);
2433   } else if (JA.getType() == types::TY_Image) {
2434     if (IsCLMode()) {
2435       // clang-cl uses BaseName for the executable name.
2436       NamedOutput =
2437           MakeCLOutputFilename(C.getArgs(), "", BaseName, types::TY_Image);
2438     } else if (MultipleArchs && BoundArch) {
2439       SmallString<128> Output(getDefaultImageName());
2440       Output += JA.getOffloadingFileNamePrefix(NormalizedTriple);
2441       Output += "-";
2442       Output.append(BoundArch);
2443       NamedOutput = C.getArgs().MakeArgString(Output.c_str());
2444     } else {
2445       NamedOutput = getDefaultImageName();
2446     }
2447   } else if (JA.getType() == types::TY_PCH && IsCLMode()) {
2448     NamedOutput = C.getArgs().MakeArgString(GetClPchPath(C, BaseName).c_str());
2449   } else {
2450     const char *Suffix = types::getTypeTempSuffix(JA.getType(), IsCLMode());
2451     assert(Suffix && "All types used for output should have a suffix.");
2452 
2453     std::string::size_type End = std::string::npos;
2454     if (!types::appendSuffixForType(JA.getType()))
2455       End = BaseName.rfind('.');
2456     SmallString<128> Suffixed(BaseName.substr(0, End));
2457     Suffixed += JA.getOffloadingFileNamePrefix(NormalizedTriple);
2458     if (MultipleArchs && BoundArch) {
2459       Suffixed += "-";
2460       Suffixed.append(BoundArch);
2461     }
2462     // When using both -save-temps and -emit-llvm, use a ".tmp.bc" suffix for
2463     // the unoptimized bitcode so that it does not get overwritten by the ".bc"
2464     // optimized bitcode output.
2465     if (!AtTopLevel && C.getArgs().hasArg(options::OPT_emit_llvm) &&
2466         JA.getType() == types::TY_LLVM_BC)
2467       Suffixed += ".tmp";
2468     Suffixed += '.';
2469     Suffixed += Suffix;
2470     NamedOutput = C.getArgs().MakeArgString(Suffixed.c_str());
2471   }
2472 
2473   // Prepend object file path if -save-temps=obj
2474   if (!AtTopLevel && isSaveTempsObj() && C.getArgs().hasArg(options::OPT_o) &&
2475       JA.getType() != types::TY_PCH) {
2476     Arg *FinalOutput = C.getArgs().getLastArg(options::OPT_o);
2477     SmallString<128> TempPath(FinalOutput->getValue());
2478     llvm::sys::path::remove_filename(TempPath);
2479     StringRef OutputFileName = llvm::sys::path::filename(NamedOutput);
2480     llvm::sys::path::append(TempPath, OutputFileName);
2481     NamedOutput = C.getArgs().MakeArgString(TempPath.c_str());
2482   }
2483 
2484   // If we're saving temps and the temp file conflicts with the input file,
2485   // then avoid overwriting input file.
2486   if (!AtTopLevel && isSaveTempsEnabled() && NamedOutput == BaseName) {
2487     bool SameFile = false;
2488     SmallString<256> Result;
2489     llvm::sys::fs::current_path(Result);
2490     llvm::sys::path::append(Result, BaseName);
2491     llvm::sys::fs::equivalent(BaseInput, Result.c_str(), SameFile);
2492     // Must share the same path to conflict.
2493     if (SameFile) {
2494       StringRef Name = llvm::sys::path::filename(BaseInput);
2495       std::pair<StringRef, StringRef> Split = Name.split('.');
2496       std::string TmpName = GetTemporaryPath(
2497           Split.first, types::getTypeTempSuffix(JA.getType(), IsCLMode()));
2498       return C.addTempFile(C.getArgs().MakeArgString(TmpName.c_str()));
2499     }
2500   }
2501 
2502   // As an annoying special case, PCH generation doesn't strip the pathname.
2503   if (JA.getType() == types::TY_PCH && !IsCLMode()) {
2504     llvm::sys::path::remove_filename(BasePath);
2505     if (BasePath.empty())
2506       BasePath = NamedOutput;
2507     else
2508       llvm::sys::path::append(BasePath, NamedOutput);
2509     return C.addResultFile(C.getArgs().MakeArgString(BasePath.c_str()), &JA);
2510   } else {
2511     return C.addResultFile(NamedOutput, &JA);
2512   }
2513 }
2514 
2515 std::string Driver::GetFilePath(const char *Name, const ToolChain &TC) const {
2516   // Respect a limited subset of the '-Bprefix' functionality in GCC by
2517   // attempting to use this prefix when looking for file paths.
2518   for (const std::string &Dir : PrefixDirs) {
2519     if (Dir.empty())
2520       continue;
2521     SmallString<128> P(Dir[0] == '=' ? SysRoot + Dir.substr(1) : Dir);
2522     llvm::sys::path::append(P, Name);
2523     if (llvm::sys::fs::exists(Twine(P)))
2524       return P.str();
2525   }
2526 
2527   SmallString<128> P(ResourceDir);
2528   llvm::sys::path::append(P, Name);
2529   if (llvm::sys::fs::exists(Twine(P)))
2530     return P.str();
2531 
2532   for (const std::string &Dir : TC.getFilePaths()) {
2533     if (Dir.empty())
2534       continue;
2535     SmallString<128> P(Dir[0] == '=' ? SysRoot + Dir.substr(1) : Dir);
2536     llvm::sys::path::append(P, Name);
2537     if (llvm::sys::fs::exists(Twine(P)))
2538       return P.str();
2539   }
2540 
2541   return Name;
2542 }
2543 
2544 void Driver::generatePrefixedToolNames(
2545     const char *Tool, const ToolChain &TC,
2546     SmallVectorImpl<std::string> &Names) const {
2547   // FIXME: Needs a better variable than DefaultTargetTriple
2548   Names.emplace_back(DefaultTargetTriple + "-" + Tool);
2549   Names.emplace_back(Tool);
2550 
2551   // Allow the discovery of tools prefixed with LLVM's default target triple.
2552   std::string LLVMDefaultTargetTriple = llvm::sys::getDefaultTargetTriple();
2553   if (LLVMDefaultTargetTriple != DefaultTargetTriple)
2554     Names.emplace_back(LLVMDefaultTargetTriple + "-" + Tool);
2555 }
2556 
2557 static bool ScanDirForExecutable(SmallString<128> &Dir,
2558                                  ArrayRef<std::string> Names) {
2559   for (const auto &Name : Names) {
2560     llvm::sys::path::append(Dir, Name);
2561     if (llvm::sys::fs::can_execute(Twine(Dir)))
2562       return true;
2563     llvm::sys::path::remove_filename(Dir);
2564   }
2565   return false;
2566 }
2567 
2568 std::string Driver::GetProgramPath(const char *Name,
2569                                    const ToolChain &TC) const {
2570   SmallVector<std::string, 2> TargetSpecificExecutables;
2571   generatePrefixedToolNames(Name, TC, TargetSpecificExecutables);
2572 
2573   // Respect a limited subset of the '-Bprefix' functionality in GCC by
2574   // attempting to use this prefix when looking for program paths.
2575   for (const auto &PrefixDir : PrefixDirs) {
2576     if (llvm::sys::fs::is_directory(PrefixDir)) {
2577       SmallString<128> P(PrefixDir);
2578       if (ScanDirForExecutable(P, TargetSpecificExecutables))
2579         return P.str();
2580     } else {
2581       SmallString<128> P(PrefixDir + Name);
2582       if (llvm::sys::fs::can_execute(Twine(P)))
2583         return P.str();
2584     }
2585   }
2586 
2587   const ToolChain::path_list &List = TC.getProgramPaths();
2588   for (const auto &Path : List) {
2589     SmallString<128> P(Path);
2590     if (ScanDirForExecutable(P, TargetSpecificExecutables))
2591       return P.str();
2592   }
2593 
2594   // If all else failed, search the path.
2595   for (const auto &TargetSpecificExecutable : TargetSpecificExecutables)
2596     if (llvm::ErrorOr<std::string> P =
2597             llvm::sys::findProgramByName(TargetSpecificExecutable))
2598       return *P;
2599 
2600   return Name;
2601 }
2602 
2603 std::string Driver::GetTemporaryPath(StringRef Prefix,
2604                                      const char *Suffix) const {
2605   SmallString<128> Path;
2606   std::error_code EC = llvm::sys::fs::createTemporaryFile(Prefix, Suffix, Path);
2607   if (EC) {
2608     Diag(clang::diag::err_unable_to_make_temp) << EC.message();
2609     return "";
2610   }
2611 
2612   return Path.str();
2613 }
2614 
2615 std::string Driver::GetClPchPath(Compilation &C, StringRef BaseName) const {
2616   SmallString<128> Output;
2617   if (Arg *FpArg = C.getArgs().getLastArg(options::OPT__SLASH_Fp)) {
2618     // FIXME: If anybody needs it, implement this obscure rule:
2619     // "If you specify a directory without a file name, the default file name
2620     // is VCx0.pch., where x is the major version of Visual C++ in use."
2621     Output = FpArg->getValue();
2622 
2623     // "If you do not specify an extension as part of the path name, an
2624     // extension of .pch is assumed. "
2625     if (!llvm::sys::path::has_extension(Output))
2626       Output += ".pch";
2627   } else {
2628     Output = BaseName;
2629     llvm::sys::path::replace_extension(Output, ".pch");
2630   }
2631   return Output.str();
2632 }
2633 
2634 const ToolChain &Driver::getToolChain(const ArgList &Args,
2635                                       const llvm::Triple &Target) const {
2636 
2637   ToolChain *&TC = ToolChains[Target.str()];
2638   if (!TC) {
2639     switch (Target.getOS()) {
2640     case llvm::Triple::Haiku:
2641       TC = new toolchains::Haiku(*this, Target, Args);
2642       break;
2643     case llvm::Triple::CloudABI:
2644       TC = new toolchains::CloudABI(*this, Target, Args);
2645       break;
2646     case llvm::Triple::Darwin:
2647     case llvm::Triple::MacOSX:
2648     case llvm::Triple::IOS:
2649     case llvm::Triple::TvOS:
2650     case llvm::Triple::WatchOS:
2651       TC = new toolchains::DarwinClang(*this, Target, Args);
2652       break;
2653     case llvm::Triple::DragonFly:
2654       TC = new toolchains::DragonFly(*this, Target, Args);
2655       break;
2656     case llvm::Triple::OpenBSD:
2657       TC = new toolchains::OpenBSD(*this, Target, Args);
2658       break;
2659     case llvm::Triple::Bitrig:
2660       TC = new toolchains::Bitrig(*this, Target, Args);
2661       break;
2662     case llvm::Triple::NetBSD:
2663       TC = new toolchains::NetBSD(*this, Target, Args);
2664       break;
2665     case llvm::Triple::FreeBSD:
2666       TC = new toolchains::FreeBSD(*this, Target, Args);
2667       break;
2668     case llvm::Triple::Minix:
2669       TC = new toolchains::Minix(*this, Target, Args);
2670       break;
2671     case llvm::Triple::Linux:
2672     case llvm::Triple::ELFIAMCU:
2673       if (Target.getArch() == llvm::Triple::hexagon)
2674         TC = new toolchains::HexagonToolChain(*this, Target, Args);
2675       else if ((Target.getVendor() == llvm::Triple::MipsTechnologies) &&
2676                !Target.hasEnvironment())
2677         TC = new toolchains::MipsLLVMToolChain(*this, Target, Args);
2678       else
2679         TC = new toolchains::Linux(*this, Target, Args);
2680       break;
2681     case llvm::Triple::NaCl:
2682       TC = new toolchains::NaClToolChain(*this, Target, Args);
2683       break;
2684     case llvm::Triple::Solaris:
2685       TC = new toolchains::Solaris(*this, Target, Args);
2686       break;
2687     case llvm::Triple::AMDHSA:
2688       TC = new toolchains::AMDGPUToolChain(*this, Target, Args);
2689       break;
2690     case llvm::Triple::Win32:
2691       switch (Target.getEnvironment()) {
2692       default:
2693         if (Target.isOSBinFormatELF())
2694           TC = new toolchains::Generic_ELF(*this, Target, Args);
2695         else if (Target.isOSBinFormatMachO())
2696           TC = new toolchains::MachO(*this, Target, Args);
2697         else
2698           TC = new toolchains::Generic_GCC(*this, Target, Args);
2699         break;
2700       case llvm::Triple::GNU:
2701         TC = new toolchains::MinGW(*this, Target, Args);
2702         break;
2703       case llvm::Triple::Itanium:
2704         TC = new toolchains::CrossWindowsToolChain(*this, Target, Args);
2705         break;
2706       case llvm::Triple::MSVC:
2707       case llvm::Triple::UnknownEnvironment:
2708         TC = new toolchains::MSVCToolChain(*this, Target, Args);
2709         break;
2710       }
2711       break;
2712     case llvm::Triple::CUDA:
2713       TC = new toolchains::CudaToolChain(*this, Target, Args);
2714       break;
2715     case llvm::Triple::PS4:
2716       TC = new toolchains::PS4CPU(*this, Target, Args);
2717       break;
2718     default:
2719       // Of these targets, Hexagon is the only one that might have
2720       // an OS of Linux, in which case it got handled above already.
2721       switch (Target.getArch()) {
2722       case llvm::Triple::tce:
2723         TC = new toolchains::TCEToolChain(*this, Target, Args);
2724         break;
2725       case llvm::Triple::hexagon:
2726         TC = new toolchains::HexagonToolChain(*this, Target, Args);
2727         break;
2728       case llvm::Triple::lanai:
2729         TC = new toolchains::LanaiToolChain(*this, Target, Args);
2730         break;
2731       case llvm::Triple::xcore:
2732         TC = new toolchains::XCoreToolChain(*this, Target, Args);
2733         break;
2734       case llvm::Triple::wasm32:
2735       case llvm::Triple::wasm64:
2736         TC = new toolchains::WebAssembly(*this, Target, Args);
2737         break;
2738       default:
2739         if (Target.getVendor() == llvm::Triple::Myriad)
2740           TC = new toolchains::MyriadToolChain(*this, Target, Args);
2741         else if (Target.isOSBinFormatELF())
2742           TC = new toolchains::Generic_ELF(*this, Target, Args);
2743         else if (Target.isOSBinFormatMachO())
2744           TC = new toolchains::MachO(*this, Target, Args);
2745         else
2746           TC = new toolchains::Generic_GCC(*this, Target, Args);
2747       }
2748     }
2749   }
2750   return *TC;
2751 }
2752 
2753 bool Driver::ShouldUseClangCompiler(const JobAction &JA) const {
2754   // Say "no" if there is not exactly one input of a type clang understands.
2755   if (JA.size() != 1 ||
2756       !types::isAcceptedByClang((*JA.input_begin())->getType()))
2757     return false;
2758 
2759   // And say "no" if this is not a kind of action clang understands.
2760   if (!isa<PreprocessJobAction>(JA) && !isa<PrecompileJobAction>(JA) &&
2761       !isa<CompileJobAction>(JA) && !isa<BackendJobAction>(JA))
2762     return false;
2763 
2764   return true;
2765 }
2766 
2767 /// GetReleaseVersion - Parse (([0-9]+)(.([0-9]+)(.([0-9]+)?))?)? and return the
2768 /// grouped values as integers. Numbers which are not provided are set to 0.
2769 ///
2770 /// \return True if the entire string was parsed (9.2), or all groups were
2771 /// parsed (10.3.5extrastuff).
2772 bool Driver::GetReleaseVersion(const char *Str, unsigned &Major,
2773                                unsigned &Minor, unsigned &Micro,
2774                                bool &HadExtra) {
2775   HadExtra = false;
2776 
2777   Major = Minor = Micro = 0;
2778   if (*Str == '\0')
2779     return false;
2780 
2781   char *End;
2782   Major = (unsigned)strtol(Str, &End, 10);
2783   if (*Str != '\0' && *End == '\0')
2784     return true;
2785   if (*End != '.')
2786     return false;
2787 
2788   Str = End + 1;
2789   Minor = (unsigned)strtol(Str, &End, 10);
2790   if (*Str != '\0' && *End == '\0')
2791     return true;
2792   if (*End != '.')
2793     return false;
2794 
2795   Str = End + 1;
2796   Micro = (unsigned)strtol(Str, &End, 10);
2797   if (*Str != '\0' && *End == '\0')
2798     return true;
2799   if (Str == End)
2800     return false;
2801   HadExtra = true;
2802   return true;
2803 }
2804 
2805 /// Parse digits from a string \p Str and fulfill \p Digits with
2806 /// the parsed numbers. This method assumes that the max number of
2807 /// digits to look for is equal to Digits.size().
2808 ///
2809 /// \return True if the entire string was parsed and there are
2810 /// no extra characters remaining at the end.
2811 bool Driver::GetReleaseVersion(const char *Str,
2812                                MutableArrayRef<unsigned> Digits) {
2813   if (*Str == '\0')
2814     return false;
2815 
2816   char *End;
2817   unsigned CurDigit = 0;
2818   while (CurDigit < Digits.size()) {
2819     unsigned Digit = (unsigned)strtol(Str, &End, 10);
2820     Digits[CurDigit] = Digit;
2821     if (*Str != '\0' && *End == '\0')
2822       return true;
2823     if (*End != '.' || Str == End)
2824       return false;
2825     Str = End + 1;
2826     CurDigit++;
2827   }
2828 
2829   // More digits than requested, bail out...
2830   return false;
2831 }
2832 
2833 std::pair<unsigned, unsigned> Driver::getIncludeExcludeOptionFlagMasks() const {
2834   unsigned IncludedFlagsBitmask = 0;
2835   unsigned ExcludedFlagsBitmask = options::NoDriverOption;
2836 
2837   if (Mode == CLMode) {
2838     // Include CL and Core options.
2839     IncludedFlagsBitmask |= options::CLOption;
2840     IncludedFlagsBitmask |= options::CoreOption;
2841   } else {
2842     ExcludedFlagsBitmask |= options::CLOption;
2843   }
2844 
2845   return std::make_pair(IncludedFlagsBitmask, ExcludedFlagsBitmask);
2846 }
2847 
2848 bool clang::driver::isOptimizationLevelFast(const ArgList &Args) {
2849   return Args.hasFlag(options::OPT_Ofast, options::OPT_O_Group, false);
2850 }
2851