1 //===--- CommonArgs.cpp - Args handling for multiple toolchains -*- C++ -*-===//
2 //
3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4 // See https://llvm.org/LICENSE.txt for license information.
5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6 //
7 //===----------------------------------------------------------------------===//
8 
9 #include "CommonArgs.h"
10 #include "Arch/AArch64.h"
11 #include "Arch/ARM.h"
12 #include "Arch/M68k.h"
13 #include "Arch/Mips.h"
14 #include "Arch/PPC.h"
15 #include "Arch/SystemZ.h"
16 #include "Arch/VE.h"
17 #include "Arch/X86.h"
18 #include "HIPAMD.h"
19 #include "Hexagon.h"
20 #include "clang/Basic/CharInfo.h"
21 #include "clang/Basic/LangOptions.h"
22 #include "clang/Basic/ObjCRuntime.h"
23 #include "clang/Basic/Version.h"
24 #include "clang/Config/config.h"
25 #include "clang/Driver/Action.h"
26 #include "clang/Driver/Compilation.h"
27 #include "clang/Driver/Driver.h"
28 #include "clang/Driver/DriverDiagnostic.h"
29 #include "clang/Driver/InputInfo.h"
30 #include "clang/Driver/Job.h"
31 #include "clang/Driver/Options.h"
32 #include "clang/Driver/SanitizerArgs.h"
33 #include "clang/Driver/ToolChain.h"
34 #include "clang/Driver/Util.h"
35 #include "clang/Driver/XRayArgs.h"
36 #include "llvm/ADT/STLExtras.h"
37 #include "llvm/ADT/SmallSet.h"
38 #include "llvm/ADT/SmallString.h"
39 #include "llvm/ADT/StringExtras.h"
40 #include "llvm/ADT/StringSwitch.h"
41 #include "llvm/ADT/Twine.h"
42 #include "llvm/Config/llvm-config.h"
43 #include "llvm/Option/Arg.h"
44 #include "llvm/Option/ArgList.h"
45 #include "llvm/Option/Option.h"
46 #include "llvm/Support/CodeGen.h"
47 #include "llvm/Support/Compression.h"
48 #include "llvm/Support/Debug.h"
49 #include "llvm/Support/ErrorHandling.h"
50 #include "llvm/Support/FileSystem.h"
51 #include "llvm/Support/Host.h"
52 #include "llvm/Support/Path.h"
53 #include "llvm/Support/Process.h"
54 #include "llvm/Support/Program.h"
55 #include "llvm/Support/ScopedPrinter.h"
56 #include "llvm/Support/TargetParser.h"
57 #include "llvm/Support/Threading.h"
58 #include "llvm/Support/VirtualFileSystem.h"
59 #include "llvm/Support/YAMLParser.h"
60 
61 using namespace clang::driver;
62 using namespace clang::driver::tools;
63 using namespace clang;
64 using namespace llvm::opt;
65 
66 static void renderRpassOptions(const ArgList &Args, ArgStringList &CmdArgs) {
67   if (const Arg *A = Args.getLastArg(options::OPT_Rpass_EQ))
68     CmdArgs.push_back(Args.MakeArgString(Twine("--plugin-opt=-pass-remarks=") +
69                                          A->getValue()));
70 
71   if (const Arg *A = Args.getLastArg(options::OPT_Rpass_missed_EQ))
72     CmdArgs.push_back(Args.MakeArgString(
73         Twine("--plugin-opt=-pass-remarks-missed=") + A->getValue()));
74 
75   if (const Arg *A = Args.getLastArg(options::OPT_Rpass_analysis_EQ))
76     CmdArgs.push_back(Args.MakeArgString(
77         Twine("--plugin-opt=-pass-remarks-analysis=") + A->getValue()));
78 }
79 
80 static void renderRemarksOptions(const ArgList &Args, ArgStringList &CmdArgs,
81                                  const llvm::Triple &Triple,
82                                  const InputInfo &Input,
83                                  const InputInfo &Output) {
84   StringRef Format = "yaml";
85   if (const Arg *A = Args.getLastArg(options::OPT_fsave_optimization_record_EQ))
86     Format = A->getValue();
87 
88   SmallString<128> F;
89   const Arg *A = Args.getLastArg(options::OPT_foptimization_record_file_EQ);
90   if (A)
91     F = A->getValue();
92   else if (Output.isFilename())
93     F = Output.getFilename();
94 
95   assert(!F.empty() && "Cannot determine remarks output name.");
96   // Append "opt.ld.<format>" to the end of the file name.
97   CmdArgs.push_back(
98       Args.MakeArgString(Twine("--plugin-opt=opt-remarks-filename=") + F +
99                          Twine(".opt.ld.") + Format));
100 
101   if (const Arg *A =
102           Args.getLastArg(options::OPT_foptimization_record_passes_EQ))
103     CmdArgs.push_back(Args.MakeArgString(
104         Twine("--plugin-opt=opt-remarks-passes=") + A->getValue()));
105 
106   CmdArgs.push_back(Args.MakeArgString(
107       Twine("--plugin-opt=opt-remarks-format=") + Format.data()));
108 }
109 
110 static void renderRemarksHotnessOptions(const ArgList &Args,
111                                         ArgStringList &CmdArgs) {
112   if (Args.hasFlag(options::OPT_fdiagnostics_show_hotness,
113                    options::OPT_fno_diagnostics_show_hotness, false))
114     CmdArgs.push_back("--plugin-opt=opt-remarks-with-hotness");
115 
116   if (const Arg *A =
117           Args.getLastArg(options::OPT_fdiagnostics_hotness_threshold_EQ))
118     CmdArgs.push_back(Args.MakeArgString(
119         Twine("--plugin-opt=opt-remarks-hotness-threshold=") + A->getValue()));
120 }
121 
122 void tools::addPathIfExists(const Driver &D, const Twine &Path,
123                             ToolChain::path_list &Paths) {
124   if (D.getVFS().exists(Path))
125     Paths.push_back(Path.str());
126 }
127 
128 void tools::handleTargetFeaturesGroup(const ArgList &Args,
129                                       std::vector<StringRef> &Features,
130                                       OptSpecifier Group) {
131   for (const Arg *A : Args.filtered(Group)) {
132     StringRef Name = A->getOption().getName();
133     A->claim();
134 
135     // Skip over "-m".
136     assert(Name.startswith("m") && "Invalid feature name.");
137     Name = Name.substr(1);
138 
139     bool IsNegative = Name.startswith("no-");
140     if (IsNegative)
141       Name = Name.substr(3);
142     Features.push_back(Args.MakeArgString((IsNegative ? "-" : "+") + Name));
143   }
144 }
145 
146 std::vector<StringRef>
147 tools::unifyTargetFeatures(const std::vector<StringRef> &Features) {
148   std::vector<StringRef> UnifiedFeatures;
149   // Find the last of each feature.
150   llvm::StringMap<unsigned> LastOpt;
151   for (unsigned I = 0, N = Features.size(); I < N; ++I) {
152     StringRef Name = Features[I];
153     assert(Name[0] == '-' || Name[0] == '+');
154     LastOpt[Name.drop_front(1)] = I;
155   }
156 
157   for (unsigned I = 0, N = Features.size(); I < N; ++I) {
158     // If this feature was overridden, ignore it.
159     StringRef Name = Features[I];
160     llvm::StringMap<unsigned>::iterator LastI = LastOpt.find(Name.drop_front(1));
161     assert(LastI != LastOpt.end());
162     unsigned Last = LastI->second;
163     if (Last != I)
164       continue;
165 
166     UnifiedFeatures.push_back(Name);
167   }
168   return UnifiedFeatures;
169 }
170 
171 void tools::addDirectoryList(const ArgList &Args, ArgStringList &CmdArgs,
172                              const char *ArgName, const char *EnvVar) {
173   const char *DirList = ::getenv(EnvVar);
174   bool CombinedArg = false;
175 
176   if (!DirList)
177     return; // Nothing to do.
178 
179   StringRef Name(ArgName);
180   if (Name.equals("-I") || Name.equals("-L") || Name.empty())
181     CombinedArg = true;
182 
183   StringRef Dirs(DirList);
184   if (Dirs.empty()) // Empty string should not add '.'.
185     return;
186 
187   StringRef::size_type Delim;
188   while ((Delim = Dirs.find(llvm::sys::EnvPathSeparator)) != StringRef::npos) {
189     if (Delim == 0) { // Leading colon.
190       if (CombinedArg) {
191         CmdArgs.push_back(Args.MakeArgString(std::string(ArgName) + "."));
192       } else {
193         CmdArgs.push_back(ArgName);
194         CmdArgs.push_back(".");
195       }
196     } else {
197       if (CombinedArg) {
198         CmdArgs.push_back(
199             Args.MakeArgString(std::string(ArgName) + Dirs.substr(0, Delim)));
200       } else {
201         CmdArgs.push_back(ArgName);
202         CmdArgs.push_back(Args.MakeArgString(Dirs.substr(0, Delim)));
203       }
204     }
205     Dirs = Dirs.substr(Delim + 1);
206   }
207 
208   if (Dirs.empty()) { // Trailing colon.
209     if (CombinedArg) {
210       CmdArgs.push_back(Args.MakeArgString(std::string(ArgName) + "."));
211     } else {
212       CmdArgs.push_back(ArgName);
213       CmdArgs.push_back(".");
214     }
215   } else { // Add the last path.
216     if (CombinedArg) {
217       CmdArgs.push_back(Args.MakeArgString(std::string(ArgName) + Dirs));
218     } else {
219       CmdArgs.push_back(ArgName);
220       CmdArgs.push_back(Args.MakeArgString(Dirs));
221     }
222   }
223 }
224 
225 void tools::AddLinkerInputs(const ToolChain &TC, const InputInfoList &Inputs,
226                             const ArgList &Args, ArgStringList &CmdArgs,
227                             const JobAction &JA) {
228   const Driver &D = TC.getDriver();
229 
230   // Add extra linker input arguments which are not treated as inputs
231   // (constructed via -Xarch_).
232   Args.AddAllArgValues(CmdArgs, options::OPT_Zlinker_input);
233 
234   // LIBRARY_PATH are included before user inputs and only supported on native
235   // toolchains.
236   if (!TC.isCrossCompiling())
237     addDirectoryList(Args, CmdArgs, "-L", "LIBRARY_PATH");
238 
239   for (const auto &II : Inputs) {
240     // If the current tool chain refers to an OpenMP offloading host, we
241     // should ignore inputs that refer to OpenMP offloading devices -
242     // they will be embedded according to a proper linker script.
243     if (auto *IA = II.getAction())
244       if ((JA.isHostOffloading(Action::OFK_OpenMP) &&
245            IA->isDeviceOffloading(Action::OFK_OpenMP)))
246         continue;
247 
248     if (!TC.HasNativeLLVMSupport() && types::isLLVMIR(II.getType()))
249       // Don't try to pass LLVM inputs unless we have native support.
250       D.Diag(diag::err_drv_no_linker_llvm_support) << TC.getTripleString();
251 
252     // Add filenames immediately.
253     if (II.isFilename()) {
254       CmdArgs.push_back(II.getFilename());
255       continue;
256     }
257 
258     // Otherwise, this is a linker input argument.
259     const Arg &A = II.getInputArg();
260 
261     // Handle reserved library options.
262     if (A.getOption().matches(options::OPT_Z_reserved_lib_stdcxx))
263       TC.AddCXXStdlibLibArgs(Args, CmdArgs);
264     else if (A.getOption().matches(options::OPT_Z_reserved_lib_cckext))
265       TC.AddCCKextLibArgs(Args, CmdArgs);
266     else if (A.getOption().matches(options::OPT_z)) {
267       // Pass -z prefix for gcc linker compatibility.
268       A.claim();
269       A.render(Args, CmdArgs);
270     } else if (A.getOption().matches(options::OPT_b)) {
271       const llvm::Triple &T = TC.getTriple();
272       if (!T.isOSAIX()) {
273         TC.getDriver().Diag(diag::err_drv_unsupported_opt_for_target)
274             << A.getSpelling() << T.str();
275       }
276       // Pass -b prefix for AIX linker.
277       A.claim();
278       A.render(Args, CmdArgs);
279     } else {
280       A.renderAsInput(Args, CmdArgs);
281     }
282   }
283 }
284 
285 void tools::addLinkerCompressDebugSectionsOption(
286     const ToolChain &TC, const llvm::opt::ArgList &Args,
287     llvm::opt::ArgStringList &CmdArgs) {
288   // GNU ld supports --compress-debug-sections=none|zlib|zlib-gnu|zlib-gabi
289   // whereas zlib is an alias to zlib-gabi and zlib-gnu is obsoleted. Therefore
290   // -gz=none|zlib are translated to --compress-debug-sections=none|zlib. -gz
291   // is not translated since ld --compress-debug-sections option requires an
292   // argument.
293   if (const Arg *A = Args.getLastArg(options::OPT_gz_EQ)) {
294     StringRef V = A->getValue();
295     if (V == "none" || V == "zlib")
296       CmdArgs.push_back(Args.MakeArgString("--compress-debug-sections=" + V));
297     else
298       TC.getDriver().Diag(diag::err_drv_unsupported_option_argument)
299           << A->getOption().getName() << V;
300   }
301 }
302 
303 void tools::AddTargetFeature(const ArgList &Args,
304                              std::vector<StringRef> &Features,
305                              OptSpecifier OnOpt, OptSpecifier OffOpt,
306                              StringRef FeatureName) {
307   if (Arg *A = Args.getLastArg(OnOpt, OffOpt)) {
308     if (A->getOption().matches(OnOpt))
309       Features.push_back(Args.MakeArgString("+" + FeatureName));
310     else
311       Features.push_back(Args.MakeArgString("-" + FeatureName));
312   }
313 }
314 
315 /// Get the (LLVM) name of the AMDGPU gpu we are targeting.
316 static std::string getAMDGPUTargetGPU(const llvm::Triple &T,
317                                       const ArgList &Args) {
318   if (Arg *A = Args.getLastArg(options::OPT_mcpu_EQ)) {
319     auto GPUName = getProcessorFromTargetID(T, A->getValue());
320     return llvm::StringSwitch<std::string>(GPUName)
321         .Cases("rv630", "rv635", "r600")
322         .Cases("rv610", "rv620", "rs780", "rs880")
323         .Case("rv740", "rv770")
324         .Case("palm", "cedar")
325         .Cases("sumo", "sumo2", "sumo")
326         .Case("hemlock", "cypress")
327         .Case("aruba", "cayman")
328         .Default(GPUName.str());
329   }
330   return "";
331 }
332 
333 static std::string getLanaiTargetCPU(const ArgList &Args) {
334   if (Arg *A = Args.getLastArg(options::OPT_mcpu_EQ)) {
335     return A->getValue();
336   }
337   return "";
338 }
339 
340 /// Get the (LLVM) name of the WebAssembly cpu we are targeting.
341 static StringRef getWebAssemblyTargetCPU(const ArgList &Args) {
342   // If we have -mcpu=, use that.
343   if (Arg *A = Args.getLastArg(options::OPT_mcpu_EQ)) {
344     StringRef CPU = A->getValue();
345 
346 #ifdef __wasm__
347     // Handle "native" by examining the host. "native" isn't meaningful when
348     // cross compiling, so only support this when the host is also WebAssembly.
349     if (CPU == "native")
350       return llvm::sys::getHostCPUName();
351 #endif
352 
353     return CPU;
354   }
355 
356   return "generic";
357 }
358 
359 std::string tools::getCPUName(const Driver &D, const ArgList &Args,
360                               const llvm::Triple &T, bool FromAs) {
361   Arg *A;
362 
363   switch (T.getArch()) {
364   default:
365     return "";
366 
367   case llvm::Triple::aarch64:
368   case llvm::Triple::aarch64_32:
369   case llvm::Triple::aarch64_be:
370     return aarch64::getAArch64TargetCPU(Args, T, A);
371 
372   case llvm::Triple::arm:
373   case llvm::Triple::armeb:
374   case llvm::Triple::thumb:
375   case llvm::Triple::thumbeb: {
376     StringRef MArch, MCPU;
377     arm::getARMArchCPUFromArgs(Args, MArch, MCPU, FromAs);
378     return arm::getARMTargetCPU(MCPU, MArch, T);
379   }
380 
381   case llvm::Triple::avr:
382     if (const Arg *A = Args.getLastArg(options::OPT_mmcu_EQ))
383       return A->getValue();
384     return "";
385 
386   case llvm::Triple::m68k:
387     return m68k::getM68kTargetCPU(Args);
388 
389   case llvm::Triple::mips:
390   case llvm::Triple::mipsel:
391   case llvm::Triple::mips64:
392   case llvm::Triple::mips64el: {
393     StringRef CPUName;
394     StringRef ABIName;
395     mips::getMipsCPUAndABI(Args, T, CPUName, ABIName);
396     return std::string(CPUName);
397   }
398 
399   case llvm::Triple::nvptx:
400   case llvm::Triple::nvptx64:
401     if (const Arg *A = Args.getLastArg(options::OPT_march_EQ))
402       return A->getValue();
403     return "";
404 
405   case llvm::Triple::ppc:
406   case llvm::Triple::ppcle:
407   case llvm::Triple::ppc64:
408   case llvm::Triple::ppc64le: {
409     std::string TargetCPUName = ppc::getPPCTargetCPU(Args);
410     // LLVM may default to generating code for the native CPU,
411     // but, like gcc, we default to a more generic option for
412     // each architecture. (except on AIX)
413     if (!TargetCPUName.empty())
414       return TargetCPUName;
415 
416     if (T.isOSAIX())
417       TargetCPUName = "pwr7";
418     else if (T.getArch() == llvm::Triple::ppc64le)
419       TargetCPUName = "ppc64le";
420     else if (T.getArch() == llvm::Triple::ppc64)
421       TargetCPUName = "ppc64";
422     else
423       TargetCPUName = "ppc";
424 
425     return TargetCPUName;
426   }
427   case llvm::Triple::riscv32:
428   case llvm::Triple::riscv64:
429     if (const Arg *A = Args.getLastArg(options::OPT_mcpu_EQ))
430       return A->getValue();
431     return "";
432 
433   case llvm::Triple::bpfel:
434   case llvm::Triple::bpfeb:
435   case llvm::Triple::sparc:
436   case llvm::Triple::sparcel:
437   case llvm::Triple::sparcv9:
438     if (const Arg *A = Args.getLastArg(options::OPT_mcpu_EQ))
439       return A->getValue();
440     if (T.getArch() == llvm::Triple::sparc && T.isOSSolaris())
441       return "v9";
442     return "";
443 
444   case llvm::Triple::x86:
445   case llvm::Triple::x86_64:
446     return x86::getX86TargetCPU(D, Args, T);
447 
448   case llvm::Triple::hexagon:
449     return "hexagon" +
450            toolchains::HexagonToolChain::GetTargetCPUVersion(Args).str();
451 
452   case llvm::Triple::lanai:
453     return getLanaiTargetCPU(Args);
454 
455   case llvm::Triple::systemz:
456     return systemz::getSystemZTargetCPU(Args);
457 
458   case llvm::Triple::r600:
459   case llvm::Triple::amdgcn:
460     return getAMDGPUTargetGPU(T, Args);
461 
462   case llvm::Triple::wasm32:
463   case llvm::Triple::wasm64:
464     return std::string(getWebAssemblyTargetCPU(Args));
465   }
466 }
467 
468 llvm::StringRef tools::getLTOParallelism(const ArgList &Args, const Driver &D) {
469   Arg *LtoJobsArg = Args.getLastArg(options::OPT_flto_jobs_EQ);
470   if (!LtoJobsArg)
471     return {};
472   if (!llvm::get_threadpool_strategy(LtoJobsArg->getValue()))
473     D.Diag(diag::err_drv_invalid_int_value)
474         << LtoJobsArg->getAsString(Args) << LtoJobsArg->getValue();
475   return LtoJobsArg->getValue();
476 }
477 
478 // CloudABI uses -ffunction-sections and -fdata-sections by default.
479 bool tools::isUseSeparateSections(const llvm::Triple &Triple) {
480   return Triple.getOS() == llvm::Triple::CloudABI;
481 }
482 
483 void tools::addLTOOptions(const ToolChain &ToolChain, const ArgList &Args,
484                           ArgStringList &CmdArgs, const InputInfo &Output,
485                           const InputInfo &Input, bool IsThinLTO) {
486   const char *Linker = Args.MakeArgString(ToolChain.GetLinkerPath());
487   const Driver &D = ToolChain.getDriver();
488   if (llvm::sys::path::filename(Linker) != "ld.lld" &&
489       llvm::sys::path::stem(Linker) != "ld.lld") {
490     // Tell the linker to load the plugin. This has to come before
491     // AddLinkerInputs as gold requires -plugin to come before any -plugin-opt
492     // that -Wl might forward.
493     CmdArgs.push_back("-plugin");
494 
495 #if defined(_WIN32)
496     const char *Suffix = ".dll";
497 #elif defined(__APPLE__)
498     const char *Suffix = ".dylib";
499 #else
500     const char *Suffix = ".so";
501 #endif
502 
503     SmallString<1024> Plugin;
504     llvm::sys::path::native(
505         Twine(D.Dir) + "/../lib" CLANG_LIBDIR_SUFFIX "/LLVMgold" + Suffix,
506         Plugin);
507     CmdArgs.push_back(Args.MakeArgString(Plugin));
508   }
509 
510   // Try to pass driver level flags relevant to LTO code generation down to
511   // the plugin.
512 
513   // Handle flags for selecting CPU variants.
514   std::string CPU = getCPUName(D, Args, ToolChain.getTriple());
515   if (!CPU.empty())
516     CmdArgs.push_back(Args.MakeArgString(Twine("-plugin-opt=mcpu=") + CPU));
517 
518   if (Arg *A = Args.getLastArg(options::OPT_O_Group)) {
519     // The optimization level matches
520     // CompilerInvocation.cpp:getOptimizationLevel().
521     StringRef OOpt;
522     if (A->getOption().matches(options::OPT_O4) ||
523         A->getOption().matches(options::OPT_Ofast))
524       OOpt = "3";
525     else if (A->getOption().matches(options::OPT_O)) {
526       OOpt = A->getValue();
527       if (OOpt == "g")
528         OOpt = "1";
529       else if (OOpt == "s" || OOpt == "z")
530         OOpt = "2";
531     } else if (A->getOption().matches(options::OPT_O0))
532       OOpt = "0";
533     if (!OOpt.empty())
534       CmdArgs.push_back(Args.MakeArgString(Twine("-plugin-opt=O") + OOpt));
535   }
536 
537   if (Args.hasArg(options::OPT_gsplit_dwarf)) {
538     CmdArgs.push_back(
539         Args.MakeArgString(Twine("-plugin-opt=dwo_dir=") +
540             Output.getFilename() + "_dwo"));
541   }
542 
543   if (IsThinLTO)
544     CmdArgs.push_back("-plugin-opt=thinlto");
545 
546   StringRef Parallelism = getLTOParallelism(Args, D);
547   if (!Parallelism.empty())
548     CmdArgs.push_back(
549         Args.MakeArgString("-plugin-opt=jobs=" + Twine(Parallelism)));
550 
551   // If an explicit debugger tuning argument appeared, pass it along.
552   if (Arg *A = Args.getLastArg(options::OPT_gTune_Group,
553                                options::OPT_ggdbN_Group)) {
554     if (A->getOption().matches(options::OPT_glldb))
555       CmdArgs.push_back("-plugin-opt=-debugger-tune=lldb");
556     else if (A->getOption().matches(options::OPT_gsce))
557       CmdArgs.push_back("-plugin-opt=-debugger-tune=sce");
558     else if (A->getOption().matches(options::OPT_gdbx))
559       CmdArgs.push_back("-plugin-opt=-debugger-tune=dbx");
560     else
561       CmdArgs.push_back("-plugin-opt=-debugger-tune=gdb");
562   }
563 
564   bool UseSeparateSections =
565       isUseSeparateSections(ToolChain.getEffectiveTriple());
566 
567   if (Args.hasFlag(options::OPT_ffunction_sections,
568                    options::OPT_fno_function_sections, UseSeparateSections)) {
569     CmdArgs.push_back("-plugin-opt=-function-sections");
570   }
571 
572   if (Args.hasFlag(options::OPT_fdata_sections, options::OPT_fno_data_sections,
573                    UseSeparateSections)) {
574     CmdArgs.push_back("-plugin-opt=-data-sections");
575   }
576 
577   if (Arg *A = getLastProfileSampleUseArg(Args)) {
578     StringRef FName = A->getValue();
579     if (!llvm::sys::fs::exists(FName))
580       D.Diag(diag::err_drv_no_such_file) << FName;
581     else
582       CmdArgs.push_back(
583           Args.MakeArgString(Twine("-plugin-opt=sample-profile=") + FName));
584   }
585 
586   auto *CSPGOGenerateArg = Args.getLastArg(options::OPT_fcs_profile_generate,
587                                            options::OPT_fcs_profile_generate_EQ,
588                                            options::OPT_fno_profile_generate);
589   if (CSPGOGenerateArg &&
590       CSPGOGenerateArg->getOption().matches(options::OPT_fno_profile_generate))
591     CSPGOGenerateArg = nullptr;
592 
593   auto *ProfileUseArg = getLastProfileUseArg(Args);
594 
595   if (CSPGOGenerateArg) {
596     CmdArgs.push_back(Args.MakeArgString("-plugin-opt=cs-profile-generate"));
597     if (CSPGOGenerateArg->getOption().matches(
598             options::OPT_fcs_profile_generate_EQ)) {
599       SmallString<128> Path(CSPGOGenerateArg->getValue());
600       llvm::sys::path::append(Path, "default_%m.profraw");
601       CmdArgs.push_back(
602           Args.MakeArgString(Twine("-plugin-opt=cs-profile-path=") + Path));
603     } else
604       CmdArgs.push_back(
605           Args.MakeArgString("-plugin-opt=cs-profile-path=default_%m.profraw"));
606   } else if (ProfileUseArg) {
607     SmallString<128> Path(
608         ProfileUseArg->getNumValues() == 0 ? "" : ProfileUseArg->getValue());
609     if (Path.empty() || llvm::sys::fs::is_directory(Path))
610       llvm::sys::path::append(Path, "default.profdata");
611     CmdArgs.push_back(Args.MakeArgString(Twine("-plugin-opt=cs-profile-path=") +
612                                          Path));
613   }
614 
615   // Pass an option to enable/disable the new pass manager.
616   if (auto *A = Args.getLastArg(options::OPT_flegacy_pass_manager,
617                                 options::OPT_fno_legacy_pass_manager)) {
618     if (A->getOption().matches(options::OPT_flegacy_pass_manager))
619       CmdArgs.push_back("-plugin-opt=legacy-pass-manager");
620     else
621       CmdArgs.push_back("-plugin-opt=new-pass-manager");
622   }
623 
624   // Setup statistics file output.
625   SmallString<128> StatsFile = getStatsFileName(Args, Output, Input, D);
626   if (!StatsFile.empty())
627     CmdArgs.push_back(
628         Args.MakeArgString(Twine("-plugin-opt=stats-file=") + StatsFile));
629 
630   addX86AlignBranchArgs(D, Args, CmdArgs, /*IsLTO=*/true);
631 
632   // Handle remark diagnostics on screen options: '-Rpass-*'.
633   renderRpassOptions(Args, CmdArgs);
634 
635   // Handle serialized remarks options: '-fsave-optimization-record'
636   // and '-foptimization-record-*'.
637   if (willEmitRemarks(Args))
638     renderRemarksOptions(Args, CmdArgs, ToolChain.getEffectiveTriple(), Input,
639                          Output);
640 
641   // Handle remarks hotness/threshold related options.
642   renderRemarksHotnessOptions(Args, CmdArgs);
643 
644   addMachineOutlinerArgs(D, Args, CmdArgs, ToolChain.getEffectiveTriple(),
645                          /*IsLTO=*/true);
646 }
647 
648 void tools::addOpenMPRuntimeSpecificRPath(const ToolChain &TC,
649                                           const ArgList &Args,
650                                           ArgStringList &CmdArgs) {
651 
652   if (Args.hasFlag(options::OPT_fopenmp_implicit_rpath,
653                    options::OPT_fno_openmp_implicit_rpath, true)) {
654     // Default to clang lib / lib64 folder, i.e. the same location as device
655     // runtime
656     SmallString<256> DefaultLibPath =
657         llvm::sys::path::parent_path(TC.getDriver().Dir);
658     llvm::sys::path::append(DefaultLibPath, Twine("lib") + CLANG_LIBDIR_SUFFIX);
659     CmdArgs.push_back("-rpath");
660     CmdArgs.push_back(Args.MakeArgString(DefaultLibPath));
661   }
662 }
663 
664 void tools::addArchSpecificRPath(const ToolChain &TC, const ArgList &Args,
665                                  ArgStringList &CmdArgs) {
666   // Enable -frtlib-add-rpath by default for the case of VE.
667   const bool IsVE = TC.getTriple().isVE();
668   bool DefaultValue = IsVE;
669   if (!Args.hasFlag(options::OPT_frtlib_add_rpath,
670                     options::OPT_fno_rtlib_add_rpath, DefaultValue))
671     return;
672 
673   std::string CandidateRPath = TC.getArchSpecificLibPath();
674   if (TC.getVFS().exists(CandidateRPath)) {
675     CmdArgs.push_back("-rpath");
676     CmdArgs.push_back(Args.MakeArgString(CandidateRPath));
677   }
678 }
679 
680 bool tools::addOpenMPRuntime(ArgStringList &CmdArgs, const ToolChain &TC,
681                              const ArgList &Args, bool ForceStaticHostRuntime,
682                              bool IsOffloadingHost, bool GompNeedsRT) {
683   if (!Args.hasFlag(options::OPT_fopenmp, options::OPT_fopenmp_EQ,
684                     options::OPT_fno_openmp, false))
685     return false;
686 
687   Driver::OpenMPRuntimeKind RTKind = TC.getDriver().getOpenMPRuntime(Args);
688 
689   if (RTKind == Driver::OMPRT_Unknown)
690     // Already diagnosed.
691     return false;
692 
693   if (ForceStaticHostRuntime)
694     CmdArgs.push_back("-Bstatic");
695 
696   switch (RTKind) {
697   case Driver::OMPRT_OMP:
698     CmdArgs.push_back("-lomp");
699     break;
700   case Driver::OMPRT_GOMP:
701     CmdArgs.push_back("-lgomp");
702     break;
703   case Driver::OMPRT_IOMP5:
704     CmdArgs.push_back("-liomp5");
705     break;
706   case Driver::OMPRT_Unknown:
707     break;
708   }
709 
710   if (ForceStaticHostRuntime)
711     CmdArgs.push_back("-Bdynamic");
712 
713   if (RTKind == Driver::OMPRT_GOMP && GompNeedsRT)
714       CmdArgs.push_back("-lrt");
715 
716   if (IsOffloadingHost)
717     CmdArgs.push_back("-lomptarget");
718 
719   addArchSpecificRPath(TC, Args, CmdArgs);
720 
721   if (RTKind == Driver::OMPRT_OMP)
722     addOpenMPRuntimeSpecificRPath(TC, Args, CmdArgs);
723 
724   return true;
725 }
726 
727 static void addSanitizerRuntime(const ToolChain &TC, const ArgList &Args,
728                                 ArgStringList &CmdArgs, StringRef Sanitizer,
729                                 bool IsShared, bool IsWhole) {
730   // Wrap any static runtimes that must be forced into executable in
731   // whole-archive.
732   if (IsWhole) CmdArgs.push_back("--whole-archive");
733   CmdArgs.push_back(TC.getCompilerRTArgString(
734       Args, Sanitizer, IsShared ? ToolChain::FT_Shared : ToolChain::FT_Static));
735   if (IsWhole) CmdArgs.push_back("--no-whole-archive");
736 
737   if (IsShared) {
738     addArchSpecificRPath(TC, Args, CmdArgs);
739   }
740 }
741 
742 // Tries to use a file with the list of dynamic symbols that need to be exported
743 // from the runtime library. Returns true if the file was found.
744 static bool addSanitizerDynamicList(const ToolChain &TC, const ArgList &Args,
745                                     ArgStringList &CmdArgs,
746                                     StringRef Sanitizer) {
747   // Solaris ld defaults to --export-dynamic behaviour but doesn't support
748   // the option, so don't try to pass it.
749   if (TC.getTriple().getOS() == llvm::Triple::Solaris)
750     return true;
751   SmallString<128> SanRT(TC.getCompilerRT(Args, Sanitizer));
752   if (llvm::sys::fs::exists(SanRT + ".syms")) {
753     CmdArgs.push_back(Args.MakeArgString("--dynamic-list=" + SanRT + ".syms"));
754     return true;
755   }
756   return false;
757 }
758 
759 const char *tools::getAsNeededOption(const ToolChain &TC, bool as_needed) {
760   assert(!TC.getTriple().isOSAIX() &&
761          "AIX linker does not support any form of --as-needed option yet.");
762 
763   // While the Solaris 11.2 ld added --as-needed/--no-as-needed as aliases
764   // for the native forms -z ignore/-z record, they are missing in Illumos,
765   // so always use the native form.
766   if (TC.getTriple().isOSSolaris())
767     return as_needed ? "-zignore" : "-zrecord";
768   else
769     return as_needed ? "--as-needed" : "--no-as-needed";
770 }
771 
772 void tools::linkSanitizerRuntimeDeps(const ToolChain &TC,
773                                      ArgStringList &CmdArgs) {
774   // Fuchsia never needs these.  Any sanitizer runtimes with system
775   // dependencies use the `.deplibs` feature instead.
776   if (TC.getTriple().isOSFuchsia())
777     return;
778 
779   // Force linking against the system libraries sanitizers depends on
780   // (see PR15823 why this is necessary).
781   CmdArgs.push_back(getAsNeededOption(TC, false));
782   // There's no libpthread or librt on RTEMS & Android.
783   if (TC.getTriple().getOS() != llvm::Triple::RTEMS &&
784       !TC.getTriple().isAndroid()) {
785     CmdArgs.push_back("-lpthread");
786     if (!TC.getTriple().isOSOpenBSD())
787       CmdArgs.push_back("-lrt");
788   }
789   CmdArgs.push_back("-lm");
790   // There's no libdl on all OSes.
791   if (!TC.getTriple().isOSFreeBSD() && !TC.getTriple().isOSNetBSD() &&
792       !TC.getTriple().isOSOpenBSD() &&
793       TC.getTriple().getOS() != llvm::Triple::RTEMS)
794     CmdArgs.push_back("-ldl");
795   // Required for backtrace on some OSes
796   if (TC.getTriple().isOSFreeBSD() ||
797       TC.getTriple().isOSNetBSD() ||
798       TC.getTriple().isOSOpenBSD())
799     CmdArgs.push_back("-lexecinfo");
800 }
801 
802 static void
803 collectSanitizerRuntimes(const ToolChain &TC, const ArgList &Args,
804                          SmallVectorImpl<StringRef> &SharedRuntimes,
805                          SmallVectorImpl<StringRef> &StaticRuntimes,
806                          SmallVectorImpl<StringRef> &NonWholeStaticRuntimes,
807                          SmallVectorImpl<StringRef> &HelperStaticRuntimes,
808                          SmallVectorImpl<StringRef> &RequiredSymbols) {
809   const SanitizerArgs &SanArgs = TC.getSanitizerArgs(Args);
810   // Collect shared runtimes.
811   if (SanArgs.needsSharedRt()) {
812     if (SanArgs.needsAsanRt() && SanArgs.linkRuntimes()) {
813       SharedRuntimes.push_back("asan");
814       if (!Args.hasArg(options::OPT_shared) && !TC.getTriple().isAndroid())
815         HelperStaticRuntimes.push_back("asan-preinit");
816     }
817     if (SanArgs.needsMemProfRt() && SanArgs.linkRuntimes()) {
818       SharedRuntimes.push_back("memprof");
819       if (!Args.hasArg(options::OPT_shared) && !TC.getTriple().isAndroid())
820         HelperStaticRuntimes.push_back("memprof-preinit");
821     }
822     if (SanArgs.needsUbsanRt() && SanArgs.linkRuntimes()) {
823       if (SanArgs.requiresMinimalRuntime())
824         SharedRuntimes.push_back("ubsan_minimal");
825       else
826         SharedRuntimes.push_back("ubsan_standalone");
827     }
828     if (SanArgs.needsScudoRt() && SanArgs.linkRuntimes()) {
829       if (SanArgs.requiresMinimalRuntime())
830         SharedRuntimes.push_back("scudo_minimal");
831       else
832         SharedRuntimes.push_back("scudo");
833     }
834     if (SanArgs.needsTsanRt() && SanArgs.linkRuntimes())
835       SharedRuntimes.push_back("tsan");
836     if (SanArgs.needsHwasanRt() && SanArgs.linkRuntimes()) {
837       if (SanArgs.needsHwasanAliasesRt())
838         SharedRuntimes.push_back("hwasan_aliases");
839       else
840         SharedRuntimes.push_back("hwasan");
841     }
842   }
843 
844   // The stats_client library is also statically linked into DSOs.
845   if (SanArgs.needsStatsRt() && SanArgs.linkRuntimes())
846     StaticRuntimes.push_back("stats_client");
847 
848   // Always link the static runtime regardless of DSO or executable.
849   if (SanArgs.needsAsanRt())
850     HelperStaticRuntimes.push_back("asan_static");
851 
852   // Collect static runtimes.
853   if (Args.hasArg(options::OPT_shared)) {
854     // Don't link static runtimes into DSOs.
855     return;
856   }
857 
858   // Each static runtime that has a DSO counterpart above is excluded below,
859   // but runtimes that exist only as static are not affected by needsSharedRt.
860 
861   if (!SanArgs.needsSharedRt() && SanArgs.needsAsanRt() && SanArgs.linkRuntimes()) {
862     StaticRuntimes.push_back("asan");
863     if (SanArgs.linkCXXRuntimes())
864       StaticRuntimes.push_back("asan_cxx");
865   }
866 
867   if (!SanArgs.needsSharedRt() && SanArgs.needsMemProfRt() &&
868       SanArgs.linkRuntimes()) {
869     StaticRuntimes.push_back("memprof");
870     if (SanArgs.linkCXXRuntimes())
871       StaticRuntimes.push_back("memprof_cxx");
872   }
873 
874   if (!SanArgs.needsSharedRt() && SanArgs.needsHwasanRt() && SanArgs.linkRuntimes()) {
875     if (SanArgs.needsHwasanAliasesRt()) {
876       StaticRuntimes.push_back("hwasan_aliases");
877       if (SanArgs.linkCXXRuntimes())
878         StaticRuntimes.push_back("hwasan_aliases_cxx");
879     } else {
880       StaticRuntimes.push_back("hwasan");
881       if (SanArgs.linkCXXRuntimes())
882         StaticRuntimes.push_back("hwasan_cxx");
883     }
884   }
885   if (SanArgs.needsDfsanRt() && SanArgs.linkRuntimes())
886     StaticRuntimes.push_back("dfsan");
887   if (SanArgs.needsLsanRt() && SanArgs.linkRuntimes())
888     StaticRuntimes.push_back("lsan");
889   if (SanArgs.needsMsanRt() && SanArgs.linkRuntimes()) {
890     StaticRuntimes.push_back("msan");
891     if (SanArgs.linkCXXRuntimes())
892       StaticRuntimes.push_back("msan_cxx");
893   }
894   if (!SanArgs.needsSharedRt() && SanArgs.needsTsanRt() &&
895       SanArgs.linkRuntimes()) {
896     StaticRuntimes.push_back("tsan");
897     if (SanArgs.linkCXXRuntimes())
898       StaticRuntimes.push_back("tsan_cxx");
899   }
900   if (!SanArgs.needsSharedRt() && SanArgs.needsUbsanRt() && SanArgs.linkRuntimes()) {
901     if (SanArgs.requiresMinimalRuntime()) {
902       StaticRuntimes.push_back("ubsan_minimal");
903     } else {
904       StaticRuntimes.push_back("ubsan_standalone");
905       if (SanArgs.linkCXXRuntimes())
906         StaticRuntimes.push_back("ubsan_standalone_cxx");
907     }
908   }
909   if (SanArgs.needsSafeStackRt() && SanArgs.linkRuntimes()) {
910     NonWholeStaticRuntimes.push_back("safestack");
911     RequiredSymbols.push_back("__safestack_init");
912   }
913   if (!(SanArgs.needsSharedRt() && SanArgs.needsUbsanRt() && SanArgs.linkRuntimes())) {
914     if (SanArgs.needsCfiRt() && SanArgs.linkRuntimes())
915       StaticRuntimes.push_back("cfi");
916     if (SanArgs.needsCfiDiagRt() && SanArgs.linkRuntimes()) {
917       StaticRuntimes.push_back("cfi_diag");
918       if (SanArgs.linkCXXRuntimes())
919         StaticRuntimes.push_back("ubsan_standalone_cxx");
920     }
921   }
922   if (SanArgs.needsStatsRt() && SanArgs.linkRuntimes()) {
923     NonWholeStaticRuntimes.push_back("stats");
924     RequiredSymbols.push_back("__sanitizer_stats_register");
925   }
926   if (!SanArgs.needsSharedRt() && SanArgs.needsScudoRt() && SanArgs.linkRuntimes()) {
927     if (SanArgs.requiresMinimalRuntime()) {
928       StaticRuntimes.push_back("scudo_minimal");
929       if (SanArgs.linkCXXRuntimes())
930         StaticRuntimes.push_back("scudo_cxx_minimal");
931     } else {
932       StaticRuntimes.push_back("scudo");
933       if (SanArgs.linkCXXRuntimes())
934         StaticRuntimes.push_back("scudo_cxx");
935     }
936   }
937 }
938 
939 // Should be called before we add system libraries (C++ ABI, libstdc++/libc++,
940 // C runtime, etc). Returns true if sanitizer system deps need to be linked in.
941 bool tools::addSanitizerRuntimes(const ToolChain &TC, const ArgList &Args,
942                                  ArgStringList &CmdArgs) {
943   SmallVector<StringRef, 4> SharedRuntimes, StaticRuntimes,
944       NonWholeStaticRuntimes, HelperStaticRuntimes, RequiredSymbols;
945   collectSanitizerRuntimes(TC, Args, SharedRuntimes, StaticRuntimes,
946                            NonWholeStaticRuntimes, HelperStaticRuntimes,
947                            RequiredSymbols);
948 
949   const SanitizerArgs &SanArgs = TC.getSanitizerArgs(Args);
950   // Inject libfuzzer dependencies.
951   if (SanArgs.needsFuzzer() && SanArgs.linkRuntimes() &&
952       !Args.hasArg(options::OPT_shared)) {
953 
954     addSanitizerRuntime(TC, Args, CmdArgs, "fuzzer", false, true);
955     if (SanArgs.needsFuzzerInterceptors())
956       addSanitizerRuntime(TC, Args, CmdArgs, "fuzzer_interceptors", false,
957                           true);
958     if (!Args.hasArg(clang::driver::options::OPT_nostdlibxx)) {
959       bool OnlyLibstdcxxStatic = Args.hasArg(options::OPT_static_libstdcxx) &&
960                                  !Args.hasArg(options::OPT_static);
961       if (OnlyLibstdcxxStatic)
962         CmdArgs.push_back("-Bstatic");
963       TC.AddCXXStdlibLibArgs(Args, CmdArgs);
964       if (OnlyLibstdcxxStatic)
965         CmdArgs.push_back("-Bdynamic");
966     }
967   }
968 
969   for (auto RT : SharedRuntimes)
970     addSanitizerRuntime(TC, Args, CmdArgs, RT, true, false);
971   for (auto RT : HelperStaticRuntimes)
972     addSanitizerRuntime(TC, Args, CmdArgs, RT, false, true);
973   bool AddExportDynamic = false;
974   for (auto RT : StaticRuntimes) {
975     addSanitizerRuntime(TC, Args, CmdArgs, RT, false, true);
976     AddExportDynamic |= !addSanitizerDynamicList(TC, Args, CmdArgs, RT);
977   }
978   for (auto RT : NonWholeStaticRuntimes) {
979     addSanitizerRuntime(TC, Args, CmdArgs, RT, false, false);
980     AddExportDynamic |= !addSanitizerDynamicList(TC, Args, CmdArgs, RT);
981   }
982   for (auto S : RequiredSymbols) {
983     CmdArgs.push_back("-u");
984     CmdArgs.push_back(Args.MakeArgString(S));
985   }
986   // If there is a static runtime with no dynamic list, force all the symbols
987   // to be dynamic to be sure we export sanitizer interface functions.
988   if (AddExportDynamic)
989     CmdArgs.push_back("--export-dynamic");
990 
991   if (SanArgs.hasCrossDsoCfi() && !AddExportDynamic)
992     CmdArgs.push_back("--export-dynamic-symbol=__cfi_check");
993 
994   return !StaticRuntimes.empty() || !NonWholeStaticRuntimes.empty();
995 }
996 
997 bool tools::addXRayRuntime(const ToolChain&TC, const ArgList &Args, ArgStringList &CmdArgs) {
998   if (Args.hasArg(options::OPT_shared))
999     return false;
1000 
1001   if (TC.getXRayArgs().needsXRayRt()) {
1002     CmdArgs.push_back("-whole-archive");
1003     CmdArgs.push_back(TC.getCompilerRTArgString(Args, "xray"));
1004     for (const auto &Mode : TC.getXRayArgs().modeList())
1005       CmdArgs.push_back(TC.getCompilerRTArgString(Args, Mode));
1006     CmdArgs.push_back("-no-whole-archive");
1007     return true;
1008   }
1009 
1010   return false;
1011 }
1012 
1013 void tools::linkXRayRuntimeDeps(const ToolChain &TC, ArgStringList &CmdArgs) {
1014   CmdArgs.push_back(getAsNeededOption(TC, false));
1015   CmdArgs.push_back("-lpthread");
1016   if (!TC.getTriple().isOSOpenBSD())
1017     CmdArgs.push_back("-lrt");
1018   CmdArgs.push_back("-lm");
1019 
1020   if (!TC.getTriple().isOSFreeBSD() &&
1021       !TC.getTriple().isOSNetBSD() &&
1022       !TC.getTriple().isOSOpenBSD())
1023     CmdArgs.push_back("-ldl");
1024 }
1025 
1026 bool tools::areOptimizationsEnabled(const ArgList &Args) {
1027   // Find the last -O arg and see if it is non-zero.
1028   if (Arg *A = Args.getLastArg(options::OPT_O_Group))
1029     return !A->getOption().matches(options::OPT_O0);
1030   // Defaults to -O0.
1031   return false;
1032 }
1033 
1034 const char *tools::SplitDebugName(const JobAction &JA, const ArgList &Args,
1035                                   const InputInfo &Input,
1036                                   const InputInfo &Output) {
1037   auto AddPostfix = [JA](auto &F) {
1038     if (JA.getOffloadingDeviceKind() == Action::OFK_HIP)
1039       F += (Twine("_") + JA.getOffloadingArch()).str();
1040     F += ".dwo";
1041   };
1042   if (Arg *A = Args.getLastArg(options::OPT_gsplit_dwarf_EQ))
1043     if (StringRef(A->getValue()) == "single")
1044       return Args.MakeArgString(Output.getFilename());
1045 
1046   Arg *FinalOutput = Args.getLastArg(options::OPT_o);
1047   if (FinalOutput && Args.hasArg(options::OPT_c)) {
1048     SmallString<128> T(FinalOutput->getValue());
1049     llvm::sys::path::remove_filename(T);
1050     llvm::sys::path::append(T, llvm::sys::path::stem(FinalOutput->getValue()));
1051     AddPostfix(T);
1052     return Args.MakeArgString(T);
1053   } else {
1054     // Use the compilation dir.
1055     Arg *A = Args.getLastArg(options::OPT_ffile_compilation_dir_EQ,
1056                              options::OPT_fdebug_compilation_dir_EQ);
1057     SmallString<128> T(A ? A->getValue() : "");
1058     SmallString<128> F(llvm::sys::path::stem(Input.getBaseInput()));
1059     AddPostfix(F);
1060     T += F;
1061     return Args.MakeArgString(T);
1062   }
1063 }
1064 
1065 void tools::SplitDebugInfo(const ToolChain &TC, Compilation &C, const Tool &T,
1066                            const JobAction &JA, const ArgList &Args,
1067                            const InputInfo &Output, const char *OutFile) {
1068   ArgStringList ExtractArgs;
1069   ExtractArgs.push_back("--extract-dwo");
1070 
1071   ArgStringList StripArgs;
1072   StripArgs.push_back("--strip-dwo");
1073 
1074   // Grabbing the output of the earlier compile step.
1075   StripArgs.push_back(Output.getFilename());
1076   ExtractArgs.push_back(Output.getFilename());
1077   ExtractArgs.push_back(OutFile);
1078 
1079   const char *Exec =
1080       Args.MakeArgString(TC.GetProgramPath(CLANG_DEFAULT_OBJCOPY));
1081   InputInfo II(types::TY_Object, Output.getFilename(), Output.getFilename());
1082 
1083   // First extract the dwo sections.
1084   C.addCommand(std::make_unique<Command>(JA, T,
1085                                          ResponseFileSupport::AtFileCurCP(),
1086                                          Exec, ExtractArgs, II, Output));
1087 
1088   // Then remove them from the original .o file.
1089   C.addCommand(std::make_unique<Command>(
1090       JA, T, ResponseFileSupport::AtFileCurCP(), Exec, StripArgs, II, Output));
1091 }
1092 
1093 // Claim options we don't want to warn if they are unused. We do this for
1094 // options that build systems might add but are unused when assembling or only
1095 // running the preprocessor for example.
1096 void tools::claimNoWarnArgs(const ArgList &Args) {
1097   // Don't warn about unused -f(no-)?lto.  This can happen when we're
1098   // preprocessing, precompiling or assembling.
1099   Args.ClaimAllArgs(options::OPT_flto_EQ);
1100   Args.ClaimAllArgs(options::OPT_flto);
1101   Args.ClaimAllArgs(options::OPT_fno_lto);
1102 }
1103 
1104 Arg *tools::getLastProfileUseArg(const ArgList &Args) {
1105   auto *ProfileUseArg = Args.getLastArg(
1106       options::OPT_fprofile_instr_use, options::OPT_fprofile_instr_use_EQ,
1107       options::OPT_fprofile_use, options::OPT_fprofile_use_EQ,
1108       options::OPT_fno_profile_instr_use);
1109 
1110   if (ProfileUseArg &&
1111       ProfileUseArg->getOption().matches(options::OPT_fno_profile_instr_use))
1112     ProfileUseArg = nullptr;
1113 
1114   return ProfileUseArg;
1115 }
1116 
1117 Arg *tools::getLastProfileSampleUseArg(const ArgList &Args) {
1118   auto *ProfileSampleUseArg = Args.getLastArg(
1119       options::OPT_fprofile_sample_use, options::OPT_fprofile_sample_use_EQ,
1120       options::OPT_fauto_profile, options::OPT_fauto_profile_EQ,
1121       options::OPT_fno_profile_sample_use, options::OPT_fno_auto_profile);
1122 
1123   if (ProfileSampleUseArg &&
1124       (ProfileSampleUseArg->getOption().matches(
1125            options::OPT_fno_profile_sample_use) ||
1126        ProfileSampleUseArg->getOption().matches(options::OPT_fno_auto_profile)))
1127     return nullptr;
1128 
1129   return Args.getLastArg(options::OPT_fprofile_sample_use_EQ,
1130                          options::OPT_fauto_profile_EQ);
1131 }
1132 
1133 /// Parses the various -fpic/-fPIC/-fpie/-fPIE arguments.  Then,
1134 /// smooshes them together with platform defaults, to decide whether
1135 /// this compile should be using PIC mode or not. Returns a tuple of
1136 /// (RelocationModel, PICLevel, IsPIE).
1137 std::tuple<llvm::Reloc::Model, unsigned, bool>
1138 tools::ParsePICArgs(const ToolChain &ToolChain, const ArgList &Args) {
1139   const llvm::Triple &EffectiveTriple = ToolChain.getEffectiveTriple();
1140   const llvm::Triple &Triple = ToolChain.getTriple();
1141 
1142   bool PIE = ToolChain.isPIEDefault(Args);
1143   bool PIC = PIE || ToolChain.isPICDefault();
1144   // The Darwin/MachO default to use PIC does not apply when using -static.
1145   if (Triple.isOSBinFormatMachO() && Args.hasArg(options::OPT_static))
1146     PIE = PIC = false;
1147   bool IsPICLevelTwo = PIC;
1148 
1149   bool KernelOrKext =
1150       Args.hasArg(options::OPT_mkernel, options::OPT_fapple_kext);
1151 
1152   // Android-specific defaults for PIC/PIE
1153   if (Triple.isAndroid()) {
1154     switch (Triple.getArch()) {
1155     case llvm::Triple::arm:
1156     case llvm::Triple::armeb:
1157     case llvm::Triple::thumb:
1158     case llvm::Triple::thumbeb:
1159     case llvm::Triple::aarch64:
1160     case llvm::Triple::mips:
1161     case llvm::Triple::mipsel:
1162     case llvm::Triple::mips64:
1163     case llvm::Triple::mips64el:
1164       PIC = true; // "-fpic"
1165       break;
1166 
1167     case llvm::Triple::x86:
1168     case llvm::Triple::x86_64:
1169       PIC = true; // "-fPIC"
1170       IsPICLevelTwo = true;
1171       break;
1172 
1173     default:
1174       break;
1175     }
1176   }
1177 
1178   // OpenBSD-specific defaults for PIE
1179   if (Triple.isOSOpenBSD()) {
1180     switch (ToolChain.getArch()) {
1181     case llvm::Triple::arm:
1182     case llvm::Triple::aarch64:
1183     case llvm::Triple::mips64:
1184     case llvm::Triple::mips64el:
1185     case llvm::Triple::x86:
1186     case llvm::Triple::x86_64:
1187       IsPICLevelTwo = false; // "-fpie"
1188       break;
1189 
1190     case llvm::Triple::ppc:
1191     case llvm::Triple::sparcv9:
1192       IsPICLevelTwo = true; // "-fPIE"
1193       break;
1194 
1195     default:
1196       break;
1197     }
1198   }
1199 
1200   // AMDGPU-specific defaults for PIC.
1201   if (Triple.getArch() == llvm::Triple::amdgcn)
1202     PIC = true;
1203 
1204   // The last argument relating to either PIC or PIE wins, and no
1205   // other argument is used. If the last argument is any flavor of the
1206   // '-fno-...' arguments, both PIC and PIE are disabled. Any PIE
1207   // option implicitly enables PIC at the same level.
1208   Arg *LastPICArg = Args.getLastArg(options::OPT_fPIC, options::OPT_fno_PIC,
1209                                     options::OPT_fpic, options::OPT_fno_pic,
1210                                     options::OPT_fPIE, options::OPT_fno_PIE,
1211                                     options::OPT_fpie, options::OPT_fno_pie);
1212   if (Triple.isOSWindows() && !Triple.isOSCygMing() && LastPICArg &&
1213       LastPICArg == Args.getLastArg(options::OPT_fPIC, options::OPT_fpic,
1214                                     options::OPT_fPIE, options::OPT_fpie)) {
1215     ToolChain.getDriver().Diag(diag::err_drv_unsupported_opt_for_target)
1216         << LastPICArg->getSpelling() << Triple.str();
1217     if (Triple.getArch() == llvm::Triple::x86_64)
1218       return std::make_tuple(llvm::Reloc::PIC_, 2U, false);
1219     return std::make_tuple(llvm::Reloc::Static, 0U, false);
1220   }
1221 
1222   // Check whether the tool chain trumps the PIC-ness decision. If the PIC-ness
1223   // is forced, then neither PIC nor PIE flags will have no effect.
1224   if (!ToolChain.isPICDefaultForced()) {
1225     if (LastPICArg) {
1226       Option O = LastPICArg->getOption();
1227       if (O.matches(options::OPT_fPIC) || O.matches(options::OPT_fpic) ||
1228           O.matches(options::OPT_fPIE) || O.matches(options::OPT_fpie)) {
1229         PIE = O.matches(options::OPT_fPIE) || O.matches(options::OPT_fpie);
1230         PIC =
1231             PIE || O.matches(options::OPT_fPIC) || O.matches(options::OPT_fpic);
1232         IsPICLevelTwo =
1233             O.matches(options::OPT_fPIE) || O.matches(options::OPT_fPIC);
1234       } else {
1235         PIE = PIC = false;
1236         if (EffectiveTriple.isPS4CPU()) {
1237           Arg *ModelArg = Args.getLastArg(options::OPT_mcmodel_EQ);
1238           StringRef Model = ModelArg ? ModelArg->getValue() : "";
1239           if (Model != "kernel") {
1240             PIC = true;
1241             ToolChain.getDriver().Diag(diag::warn_drv_ps4_force_pic)
1242                 << LastPICArg->getSpelling();
1243           }
1244         }
1245       }
1246     }
1247   }
1248 
1249   // Introduce a Darwin and PS4-specific hack. If the default is PIC, but the
1250   // PIC level would've been set to level 1, force it back to level 2 PIC
1251   // instead.
1252   if (PIC && (Triple.isOSDarwin() || EffectiveTriple.isPS4CPU()))
1253     IsPICLevelTwo |= ToolChain.isPICDefault();
1254 
1255   // This kernel flags are a trump-card: they will disable PIC/PIE
1256   // generation, independent of the argument order.
1257   if (KernelOrKext &&
1258       ((!EffectiveTriple.isiOS() || EffectiveTriple.isOSVersionLT(6)) &&
1259        !EffectiveTriple.isWatchOS()))
1260     PIC = PIE = false;
1261 
1262   if (Arg *A = Args.getLastArg(options::OPT_mdynamic_no_pic)) {
1263     // This is a very special mode. It trumps the other modes, almost no one
1264     // uses it, and it isn't even valid on any OS but Darwin.
1265     if (!Triple.isOSDarwin())
1266       ToolChain.getDriver().Diag(diag::err_drv_unsupported_opt_for_target)
1267           << A->getSpelling() << Triple.str();
1268 
1269     // FIXME: Warn when this flag trumps some other PIC or PIE flag.
1270 
1271     // Only a forced PIC mode can cause the actual compile to have PIC defines
1272     // etc., no flags are sufficient. This behavior was selected to closely
1273     // match that of llvm-gcc and Apple GCC before that.
1274     PIC = ToolChain.isPICDefault() && ToolChain.isPICDefaultForced();
1275 
1276     return std::make_tuple(llvm::Reloc::DynamicNoPIC, PIC ? 2U : 0U, false);
1277   }
1278 
1279   bool EmbeddedPISupported;
1280   switch (Triple.getArch()) {
1281     case llvm::Triple::arm:
1282     case llvm::Triple::armeb:
1283     case llvm::Triple::thumb:
1284     case llvm::Triple::thumbeb:
1285       EmbeddedPISupported = true;
1286       break;
1287     default:
1288       EmbeddedPISupported = false;
1289       break;
1290   }
1291 
1292   bool ROPI = false, RWPI = false;
1293   Arg* LastROPIArg = Args.getLastArg(options::OPT_fropi, options::OPT_fno_ropi);
1294   if (LastROPIArg && LastROPIArg->getOption().matches(options::OPT_fropi)) {
1295     if (!EmbeddedPISupported)
1296       ToolChain.getDriver().Diag(diag::err_drv_unsupported_opt_for_target)
1297           << LastROPIArg->getSpelling() << Triple.str();
1298     ROPI = true;
1299   }
1300   Arg *LastRWPIArg = Args.getLastArg(options::OPT_frwpi, options::OPT_fno_rwpi);
1301   if (LastRWPIArg && LastRWPIArg->getOption().matches(options::OPT_frwpi)) {
1302     if (!EmbeddedPISupported)
1303       ToolChain.getDriver().Diag(diag::err_drv_unsupported_opt_for_target)
1304           << LastRWPIArg->getSpelling() << Triple.str();
1305     RWPI = true;
1306   }
1307 
1308   // ROPI and RWPI are not compatible with PIC or PIE.
1309   if ((ROPI || RWPI) && (PIC || PIE))
1310     ToolChain.getDriver().Diag(diag::err_drv_ropi_rwpi_incompatible_with_pic);
1311 
1312   if (Triple.isMIPS()) {
1313     StringRef CPUName;
1314     StringRef ABIName;
1315     mips::getMipsCPUAndABI(Args, Triple, CPUName, ABIName);
1316     // When targeting the N64 ABI, PIC is the default, except in the case
1317     // when the -mno-abicalls option is used. In that case we exit
1318     // at next check regardless of PIC being set below.
1319     if (ABIName == "n64")
1320       PIC = true;
1321     // When targettng MIPS with -mno-abicalls, it's always static.
1322     if(Args.hasArg(options::OPT_mno_abicalls))
1323       return std::make_tuple(llvm::Reloc::Static, 0U, false);
1324     // Unlike other architectures, MIPS, even with -fPIC/-mxgot/multigot,
1325     // does not use PIC level 2 for historical reasons.
1326     IsPICLevelTwo = false;
1327   }
1328 
1329   if (PIC)
1330     return std::make_tuple(llvm::Reloc::PIC_, IsPICLevelTwo ? 2U : 1U, PIE);
1331 
1332   llvm::Reloc::Model RelocM = llvm::Reloc::Static;
1333   if (ROPI && RWPI)
1334     RelocM = llvm::Reloc::ROPI_RWPI;
1335   else if (ROPI)
1336     RelocM = llvm::Reloc::ROPI;
1337   else if (RWPI)
1338     RelocM = llvm::Reloc::RWPI;
1339 
1340   return std::make_tuple(RelocM, 0U, false);
1341 }
1342 
1343 // `-falign-functions` indicates that the functions should be aligned to a
1344 // 16-byte boundary.
1345 //
1346 // `-falign-functions=1` is the same as `-fno-align-functions`.
1347 //
1348 // The scalar `n` in `-falign-functions=n` must be an integral value between
1349 // [0, 65536].  If the value is not a power-of-two, it will be rounded up to
1350 // the nearest power-of-two.
1351 //
1352 // If we return `0`, the frontend will default to the backend's preferred
1353 // alignment.
1354 //
1355 // NOTE: icc only allows values between [0, 4096].  icc uses `-falign-functions`
1356 // to mean `-falign-functions=16`.  GCC defaults to the backend's preferred
1357 // alignment.  For unaligned functions, we default to the backend's preferred
1358 // alignment.
1359 unsigned tools::ParseFunctionAlignment(const ToolChain &TC,
1360                                        const ArgList &Args) {
1361   const Arg *A = Args.getLastArg(options::OPT_falign_functions,
1362                                  options::OPT_falign_functions_EQ,
1363                                  options::OPT_fno_align_functions);
1364   if (!A || A->getOption().matches(options::OPT_fno_align_functions))
1365     return 0;
1366 
1367   if (A->getOption().matches(options::OPT_falign_functions))
1368     return 0;
1369 
1370   unsigned Value = 0;
1371   if (StringRef(A->getValue()).getAsInteger(10, Value) || Value > 65536)
1372     TC.getDriver().Diag(diag::err_drv_invalid_int_value)
1373         << A->getAsString(Args) << A->getValue();
1374   return Value ? llvm::Log2_32_Ceil(std::min(Value, 65536u)) : Value;
1375 }
1376 
1377 unsigned tools::ParseDebugDefaultVersion(const ToolChain &TC,
1378                                          const ArgList &Args) {
1379   const Arg *A = Args.getLastArg(options::OPT_fdebug_default_version);
1380 
1381   if (!A)
1382     return 0;
1383 
1384   unsigned Value = 0;
1385   if (StringRef(A->getValue()).getAsInteger(10, Value) || Value > 5 ||
1386       Value < 2)
1387     TC.getDriver().Diag(diag::err_drv_invalid_int_value)
1388         << A->getAsString(Args) << A->getValue();
1389   return Value;
1390 }
1391 
1392 void tools::AddAssemblerKPIC(const ToolChain &ToolChain, const ArgList &Args,
1393                              ArgStringList &CmdArgs) {
1394   llvm::Reloc::Model RelocationModel;
1395   unsigned PICLevel;
1396   bool IsPIE;
1397   std::tie(RelocationModel, PICLevel, IsPIE) = ParsePICArgs(ToolChain, Args);
1398 
1399   if (RelocationModel != llvm::Reloc::Static)
1400     CmdArgs.push_back("-KPIC");
1401 }
1402 
1403 /// Determine whether Objective-C automated reference counting is
1404 /// enabled.
1405 bool tools::isObjCAutoRefCount(const ArgList &Args) {
1406   return Args.hasFlag(options::OPT_fobjc_arc, options::OPT_fno_objc_arc, false);
1407 }
1408 
1409 enum class LibGccType { UnspecifiedLibGcc, StaticLibGcc, SharedLibGcc };
1410 
1411 static LibGccType getLibGccType(const ToolChain &TC, const Driver &D,
1412                                 const ArgList &Args) {
1413   if (Args.hasArg(options::OPT_static_libgcc) ||
1414       Args.hasArg(options::OPT_static) || Args.hasArg(options::OPT_static_pie))
1415     return LibGccType::StaticLibGcc;
1416   if (Args.hasArg(options::OPT_shared_libgcc))
1417     return LibGccType::SharedLibGcc;
1418   // The Android NDK only provides libunwind.a, not libunwind.so.
1419   if (TC.getTriple().isAndroid())
1420     return LibGccType::StaticLibGcc;
1421   // For MinGW, don't imply a shared libgcc here, we only want to return
1422   // SharedLibGcc if that was explicitly requested.
1423   if (D.CCCIsCXX() && !TC.getTriple().isOSCygMing())
1424     return LibGccType::SharedLibGcc;
1425   return LibGccType::UnspecifiedLibGcc;
1426 }
1427 
1428 // Gcc adds libgcc arguments in various ways:
1429 //
1430 // gcc <none>:     -lgcc --as-needed -lgcc_s --no-as-needed
1431 // g++ <none>:                       -lgcc_s               -lgcc
1432 // gcc shared:                       -lgcc_s               -lgcc
1433 // g++ shared:                       -lgcc_s               -lgcc
1434 // gcc static:     -lgcc             -lgcc_eh
1435 // g++ static:     -lgcc             -lgcc_eh
1436 // gcc static-pie: -lgcc             -lgcc_eh
1437 // g++ static-pie: -lgcc             -lgcc_eh
1438 //
1439 // Also, certain targets need additional adjustments.
1440 
1441 static void AddUnwindLibrary(const ToolChain &TC, const Driver &D,
1442                              ArgStringList &CmdArgs, const ArgList &Args) {
1443   ToolChain::UnwindLibType UNW = TC.GetUnwindLibType(Args);
1444   // Targets that don't use unwind libraries.
1445   if ((TC.getTriple().isAndroid() && UNW == ToolChain::UNW_Libgcc) ||
1446       TC.getTriple().isOSIAMCU() || TC.getTriple().isOSBinFormatWasm() ||
1447       UNW == ToolChain::UNW_None)
1448     return;
1449 
1450   LibGccType LGT = getLibGccType(TC, D, Args);
1451   bool AsNeeded = LGT == LibGccType::UnspecifiedLibGcc &&
1452                   !TC.getTriple().isAndroid() &&
1453                   !TC.getTriple().isOSCygMing() && !TC.getTriple().isOSAIX();
1454   if (AsNeeded)
1455     CmdArgs.push_back(getAsNeededOption(TC, true));
1456 
1457   switch (UNW) {
1458   case ToolChain::UNW_None:
1459     return;
1460   case ToolChain::UNW_Libgcc: {
1461     if (LGT == LibGccType::StaticLibGcc)
1462       CmdArgs.push_back("-lgcc_eh");
1463     else
1464       CmdArgs.push_back("-lgcc_s");
1465     break;
1466   }
1467   case ToolChain::UNW_CompilerRT:
1468     if (TC.getTriple().isOSAIX()) {
1469       // AIX only has libunwind as a shared library. So do not pass
1470       // anything in if -static is specified.
1471       if (LGT != LibGccType::StaticLibGcc)
1472         CmdArgs.push_back("-lunwind");
1473     } else if (LGT == LibGccType::StaticLibGcc) {
1474       CmdArgs.push_back("-l:libunwind.a");
1475     } else if (TC.getTriple().isOSCygMing()) {
1476       if (LGT == LibGccType::SharedLibGcc)
1477         CmdArgs.push_back("-l:libunwind.dll.a");
1478       else
1479         // Let the linker choose between libunwind.dll.a and libunwind.a
1480         // depending on what's available, and depending on the -static flag
1481         CmdArgs.push_back("-lunwind");
1482     } else {
1483       CmdArgs.push_back("-l:libunwind.so");
1484     }
1485     break;
1486   }
1487 
1488   if (AsNeeded)
1489     CmdArgs.push_back(getAsNeededOption(TC, false));
1490 }
1491 
1492 static void AddLibgcc(const ToolChain &TC, const Driver &D,
1493                       ArgStringList &CmdArgs, const ArgList &Args) {
1494   LibGccType LGT = getLibGccType(TC, D, Args);
1495   if (LGT != LibGccType::SharedLibGcc)
1496     CmdArgs.push_back("-lgcc");
1497   AddUnwindLibrary(TC, D, CmdArgs, Args);
1498   if (LGT == LibGccType::SharedLibGcc)
1499     CmdArgs.push_back("-lgcc");
1500 }
1501 
1502 void tools::AddRunTimeLibs(const ToolChain &TC, const Driver &D,
1503                            ArgStringList &CmdArgs, const ArgList &Args) {
1504   // Make use of compiler-rt if --rtlib option is used
1505   ToolChain::RuntimeLibType RLT = TC.GetRuntimeLibType(Args);
1506 
1507   switch (RLT) {
1508   case ToolChain::RLT_CompilerRT:
1509     CmdArgs.push_back(TC.getCompilerRTArgString(Args, "builtins"));
1510     AddUnwindLibrary(TC, D, CmdArgs, Args);
1511     break;
1512   case ToolChain::RLT_Libgcc:
1513     // Make sure libgcc is not used under MSVC environment by default
1514     if (TC.getTriple().isKnownWindowsMSVCEnvironment()) {
1515       // Issue error diagnostic if libgcc is explicitly specified
1516       // through command line as --rtlib option argument.
1517       if (Args.hasArg(options::OPT_rtlib_EQ)) {
1518         TC.getDriver().Diag(diag::err_drv_unsupported_rtlib_for_platform)
1519             << Args.getLastArg(options::OPT_rtlib_EQ)->getValue() << "MSVC";
1520       }
1521     } else
1522       AddLibgcc(TC, D, CmdArgs, Args);
1523     break;
1524   }
1525 
1526   // On Android, the unwinder uses dl_iterate_phdr (or one of
1527   // dl_unwind_find_exidx/__gnu_Unwind_Find_exidx on arm32) from libdl.so. For
1528   // statically-linked executables, these functions come from libc.a instead.
1529   if (TC.getTriple().isAndroid() && !Args.hasArg(options::OPT_static) &&
1530       !Args.hasArg(options::OPT_static_pie))
1531     CmdArgs.push_back("-ldl");
1532 }
1533 
1534 SmallString<128> tools::getStatsFileName(const llvm::opt::ArgList &Args,
1535                                          const InputInfo &Output,
1536                                          const InputInfo &Input,
1537                                          const Driver &D) {
1538   const Arg *A = Args.getLastArg(options::OPT_save_stats_EQ);
1539   if (!A)
1540     return {};
1541 
1542   StringRef SaveStats = A->getValue();
1543   SmallString<128> StatsFile;
1544   if (SaveStats == "obj" && Output.isFilename()) {
1545     StatsFile.assign(Output.getFilename());
1546     llvm::sys::path::remove_filename(StatsFile);
1547   } else if (SaveStats != "cwd") {
1548     D.Diag(diag::err_drv_invalid_value) << A->getAsString(Args) << SaveStats;
1549     return {};
1550   }
1551 
1552   StringRef BaseName = llvm::sys::path::filename(Input.getBaseInput());
1553   llvm::sys::path::append(StatsFile, BaseName);
1554   llvm::sys::path::replace_extension(StatsFile, "stats");
1555   return StatsFile;
1556 }
1557 
1558 void tools::addMultilibFlag(bool Enabled, const char *const Flag,
1559                             Multilib::flags_list &Flags) {
1560   Flags.push_back(std::string(Enabled ? "+" : "-") + Flag);
1561 }
1562 
1563 void tools::addX86AlignBranchArgs(const Driver &D, const ArgList &Args,
1564                                   ArgStringList &CmdArgs, bool IsLTO) {
1565   auto addArg = [&, IsLTO](const Twine &Arg) {
1566     if (IsLTO) {
1567       CmdArgs.push_back(Args.MakeArgString("-plugin-opt=" + Arg));
1568     } else {
1569       CmdArgs.push_back("-mllvm");
1570       CmdArgs.push_back(Args.MakeArgString(Arg));
1571     }
1572   };
1573 
1574   if (Args.hasArg(options::OPT_mbranches_within_32B_boundaries)) {
1575     addArg(Twine("-x86-branches-within-32B-boundaries"));
1576   }
1577   if (const Arg *A = Args.getLastArg(options::OPT_malign_branch_boundary_EQ)) {
1578     StringRef Value = A->getValue();
1579     unsigned Boundary;
1580     if (Value.getAsInteger(10, Boundary) || Boundary < 16 ||
1581         !llvm::isPowerOf2_64(Boundary)) {
1582       D.Diag(diag::err_drv_invalid_argument_to_option)
1583           << Value << A->getOption().getName();
1584     } else {
1585       addArg("-x86-align-branch-boundary=" + Twine(Boundary));
1586     }
1587   }
1588   if (const Arg *A = Args.getLastArg(options::OPT_malign_branch_EQ)) {
1589     std::string AlignBranch;
1590     for (StringRef T : A->getValues()) {
1591       if (T != "fused" && T != "jcc" && T != "jmp" && T != "call" &&
1592           T != "ret" && T != "indirect")
1593         D.Diag(diag::err_drv_invalid_malign_branch_EQ)
1594             << T << "fused, jcc, jmp, call, ret, indirect";
1595       if (!AlignBranch.empty())
1596         AlignBranch += '+';
1597       AlignBranch += T;
1598     }
1599     addArg("-x86-align-branch=" + Twine(AlignBranch));
1600   }
1601   if (const Arg *A = Args.getLastArg(options::OPT_mpad_max_prefix_size_EQ)) {
1602     StringRef Value = A->getValue();
1603     unsigned PrefixSize;
1604     if (Value.getAsInteger(10, PrefixSize)) {
1605       D.Diag(diag::err_drv_invalid_argument_to_option)
1606           << Value << A->getOption().getName();
1607     } else {
1608       addArg("-x86-pad-max-prefix-size=" + Twine(PrefixSize));
1609     }
1610   }
1611 }
1612 
1613 /// SDLSearch: Search for Static Device Library
1614 /// The search for SDL bitcode files is consistent with how static host
1615 /// libraries are discovered. That is, the -l option triggers a search for
1616 /// files in a set of directories called the LINKPATH. The host library search
1617 /// procedure looks for a specific filename in the LINKPATH.  The filename for
1618 /// a host library is lib<libname>.a or lib<libname>.so. For SDLs, there is an
1619 /// ordered-set of filenames that are searched. We call this ordered-set of
1620 /// filenames as SEARCH-ORDER. Since an SDL can either be device-type specific,
1621 /// architecture specific, or generic across all architectures, a naming
1622 /// convention and search order is used where the file name embeds the
1623 /// architecture name <arch-name> (nvptx or amdgcn) and the GPU device type
1624 /// <device-name> such as sm_30 and gfx906. <device-name> is absent in case of
1625 /// device-independent SDLs. To reduce congestion in host library directories,
1626 /// the search first looks for files in the “libdevice” subdirectory. SDLs that
1627 /// are bc files begin with the prefix “lib”.
1628 ///
1629 /// Machine-code SDLs can also be managed as an archive (*.a file). The
1630 /// convention has been to use the prefix “lib”. To avoid confusion with host
1631 /// archive libraries, we use prefix "libbc-" for the bitcode SDL archives.
1632 ///
1633 bool tools::SDLSearch(const Driver &D, const llvm::opt::ArgList &DriverArgs,
1634                       llvm::opt::ArgStringList &CC1Args,
1635                       SmallVector<std::string, 8> LibraryPaths, std::string Lib,
1636                       StringRef Arch, StringRef Target, bool isBitCodeSDL,
1637                       bool postClangLink) {
1638   SmallVector<std::string, 12> SDLs;
1639 
1640   std::string LibDeviceLoc = "/libdevice";
1641   std::string LibBcPrefix = "/libbc-";
1642   std::string LibPrefix = "/lib";
1643 
1644   if (isBitCodeSDL) {
1645     // SEARCH-ORDER for Bitcode SDLs:
1646     //       libdevice/libbc-<libname>-<arch-name>-<device-type>.a
1647     //       libbc-<libname>-<arch-name>-<device-type>.a
1648     //       libdevice/libbc-<libname>-<arch-name>.a
1649     //       libbc-<libname>-<arch-name>.a
1650     //       libdevice/libbc-<libname>.a
1651     //       libbc-<libname>.a
1652     //       libdevice/lib<libname>-<arch-name>-<device-type>.bc
1653     //       lib<libname>-<arch-name>-<device-type>.bc
1654     //       libdevice/lib<libname>-<arch-name>.bc
1655     //       lib<libname>-<arch-name>.bc
1656     //       libdevice/lib<libname>.bc
1657     //       lib<libname>.bc
1658 
1659     for (StringRef Base : {LibBcPrefix, LibPrefix}) {
1660       const auto *Ext = Base.contains(LibBcPrefix) ? ".a" : ".bc";
1661 
1662       for (auto Suffix : {Twine(Lib + "-" + Arch + "-" + Target).str(),
1663                           Twine(Lib + "-" + Arch).str(), Twine(Lib).str()}) {
1664         SDLs.push_back(Twine(LibDeviceLoc + Base + Suffix + Ext).str());
1665         SDLs.push_back(Twine(Base + Suffix + Ext).str());
1666       }
1667     }
1668   } else {
1669     // SEARCH-ORDER for Machine-code SDLs:
1670     //    libdevice/lib<libname>-<arch-name>-<device-type>.a
1671     //    lib<libname>-<arch-name>-<device-type>.a
1672     //    libdevice/lib<libname>-<arch-name>.a
1673     //    lib<libname>-<arch-name>.a
1674 
1675     const auto *Ext = ".a";
1676 
1677     for (auto Suffix : {Twine(Lib + "-" + Arch + "-" + Target).str(),
1678                         Twine(Lib + "-" + Arch).str()}) {
1679       SDLs.push_back(Twine(LibDeviceLoc + LibPrefix + Suffix + Ext).str());
1680       SDLs.push_back(Twine(LibPrefix + Suffix + Ext).str());
1681     }
1682   }
1683 
1684   // The CUDA toolchain does not use a global device llvm-link before the LLVM
1685   // backend generates ptx. So currently, the use of bitcode SDL for nvptx is
1686   // only possible with post-clang-cc1 linking. Clang cc1 has a feature that
1687   // will link libraries after clang compilation while the LLVM IR is still in
1688   // memory. This utilizes a clang cc1 option called “-mlink-builtin-bitcode”.
1689   // This is a clang -cc1 option that is generated by the clang driver. The
1690   // option value must a full path to an existing file.
1691   bool FoundSDL = false;
1692   for (auto LPath : LibraryPaths) {
1693     for (auto SDL : SDLs) {
1694       auto FullName = Twine(LPath + SDL).str();
1695       if (llvm::sys::fs::exists(FullName)) {
1696         if (postClangLink)
1697           CC1Args.push_back("-mlink-builtin-bitcode");
1698         CC1Args.push_back(DriverArgs.MakeArgString(FullName));
1699         FoundSDL = true;
1700         break;
1701       }
1702     }
1703     if (FoundSDL)
1704       break;
1705   }
1706   return FoundSDL;
1707 }
1708 
1709 /// Search if a user provided archive file lib<libname>.a exists in any of
1710 /// the library paths. If so, add a new command to clang-offload-bundler to
1711 /// unbundle this archive and create a temporary device specific archive. Name
1712 /// of this SDL is passed to the llvm-link (for amdgcn) or to the
1713 /// clang-nvlink-wrapper (for nvptx) commands by the driver.
1714 bool tools::GetSDLFromOffloadArchive(
1715     Compilation &C, const Driver &D, const Tool &T, const JobAction &JA,
1716     const InputInfoList &Inputs, const llvm::opt::ArgList &DriverArgs,
1717     llvm::opt::ArgStringList &CC1Args, SmallVector<std::string, 8> LibraryPaths,
1718     StringRef Lib, StringRef Arch, StringRef Target, bool isBitCodeSDL,
1719     bool postClangLink) {
1720 
1721   // We don't support bitcode archive bundles for nvptx
1722   if (isBitCodeSDL && Arch.contains("nvptx"))
1723     return false;
1724 
1725   bool FoundAOB = false;
1726   SmallVector<std::string, 2> AOBFileNames;
1727   std::string ArchiveOfBundles;
1728   for (auto LPath : LibraryPaths) {
1729     ArchiveOfBundles.clear();
1730 
1731     AOBFileNames.push_back(Twine(LPath + "/libdevice/lib" + Lib + ".a").str());
1732     AOBFileNames.push_back(Twine(LPath + "/lib" + Lib + ".a").str());
1733 
1734     for (auto AOB : AOBFileNames) {
1735       if (llvm::sys::fs::exists(AOB)) {
1736         ArchiveOfBundles = AOB;
1737         FoundAOB = true;
1738         break;
1739       }
1740     }
1741 
1742     if (!FoundAOB)
1743       continue;
1744 
1745     StringRef Prefix = isBitCodeSDL ? "libbc-" : "lib";
1746     std::string OutputLib = D.GetTemporaryPath(
1747         Twine(Prefix + Lib + "-" + Arch + "-" + Target).str(), "a");
1748 
1749     C.addTempFile(C.getArgs().MakeArgString(OutputLib));
1750 
1751     ArgStringList CmdArgs;
1752     SmallString<128> DeviceTriple;
1753     DeviceTriple += Action::GetOffloadKindName(JA.getOffloadingDeviceKind());
1754     DeviceTriple += '-';
1755     std::string NormalizedTriple = T.getToolChain().getTriple().normalize();
1756     DeviceTriple += NormalizedTriple;
1757     if (!Target.empty()) {
1758       DeviceTriple += '-';
1759       DeviceTriple += Target;
1760     }
1761 
1762     std::string UnbundleArg("-unbundle");
1763     std::string TypeArg("-type=a");
1764     std::string InputArg("-inputs=" + ArchiveOfBundles);
1765     std::string OffloadArg("-targets=" + std::string(DeviceTriple));
1766     std::string OutputArg("-outputs=" + OutputLib);
1767 
1768     const char *UBProgram = DriverArgs.MakeArgString(
1769         T.getToolChain().GetProgramPath("clang-offload-bundler"));
1770 
1771     ArgStringList UBArgs;
1772     UBArgs.push_back(C.getArgs().MakeArgString(UnbundleArg));
1773     UBArgs.push_back(C.getArgs().MakeArgString(TypeArg));
1774     UBArgs.push_back(C.getArgs().MakeArgString(InputArg));
1775     UBArgs.push_back(C.getArgs().MakeArgString(OffloadArg));
1776     UBArgs.push_back(C.getArgs().MakeArgString(OutputArg));
1777 
1778     // Add this flag to not exit from clang-offload-bundler if no compatible
1779     // code object is found in heterogenous archive library.
1780     std::string AdditionalArgs("-allow-missing-bundles");
1781     UBArgs.push_back(C.getArgs().MakeArgString(AdditionalArgs));
1782 
1783     C.addCommand(std::make_unique<Command>(
1784         JA, T, ResponseFileSupport::AtFileCurCP(), UBProgram, UBArgs, Inputs,
1785         InputInfo(&JA, C.getArgs().MakeArgString(OutputLib))));
1786     if (postClangLink)
1787       CC1Args.push_back("-mlink-builtin-bitcode");
1788 
1789     CC1Args.push_back(DriverArgs.MakeArgString(OutputLib));
1790     break;
1791   }
1792 
1793   return FoundAOB;
1794 }
1795 
1796 // Wrapper function used by driver for adding SDLs during link phase.
1797 void tools::AddStaticDeviceLibsLinking(Compilation &C, const Tool &T,
1798                                 const JobAction &JA,
1799                                 const InputInfoList &Inputs,
1800                                 const llvm::opt::ArgList &DriverArgs,
1801                                 llvm::opt::ArgStringList &CC1Args,
1802                                 StringRef Arch, StringRef Target,
1803                                 bool isBitCodeSDL, bool postClangLink) {
1804   AddStaticDeviceLibs(&C, &T, &JA, &Inputs, C.getDriver(), DriverArgs, CC1Args,
1805                       Arch, Target, isBitCodeSDL, postClangLink);
1806 }
1807 
1808 // Wrapper function used for post clang linking of bitcode SDLS for nvptx by
1809 // the CUDA toolchain.
1810 void tools::AddStaticDeviceLibsPostLinking(const Driver &D,
1811                                 const llvm::opt::ArgList &DriverArgs,
1812                                 llvm::opt::ArgStringList &CC1Args,
1813                                 StringRef Arch, StringRef Target,
1814                                 bool isBitCodeSDL, bool postClangLink) {
1815   AddStaticDeviceLibs(nullptr, nullptr, nullptr, nullptr, D, DriverArgs,
1816                       CC1Args, Arch, Target, isBitCodeSDL, postClangLink);
1817 }
1818 
1819 // User defined Static Device Libraries(SDLs) can be passed to clang for
1820 // offloading GPU compilers. Like static host libraries, the use of a SDL is
1821 // specified with the -l command line option. The primary difference between
1822 // host and SDLs is the filenames for SDLs (refer SEARCH-ORDER for Bitcode SDLs
1823 // and SEARCH-ORDER for Machine-code SDLs for the naming convention).
1824 // SDLs are of following types:
1825 //
1826 // * Bitcode SDLs: They can either be a *.bc file or an archive of *.bc files.
1827 //           For NVPTX, these libraries are post-clang linked following each
1828 //           compilation. For AMDGPU, these libraries are linked one time
1829 //           during the application link phase.
1830 //
1831 // * Machine-code SDLs: They are archive files. For NVPTX, the archive members
1832 //           contain cubin for Nvidia GPUs and are linked one time during the
1833 //           link phase by the CUDA SDK linker called nvlink.	For AMDGPU, the
1834 //           process for machine code SDLs is still in development. But they
1835 //           will be linked by the LLVM tool lld.
1836 //
1837 // * Bundled objects that contain both host and device codes: Bundled objects
1838 //           may also contain library code compiled from source. For NVPTX, the
1839 //           bundle contains cubin. For AMDGPU, the bundle contains bitcode.
1840 //
1841 // For Bitcode and Machine-code SDLs, current compiler toolchains hardcode the
1842 // inclusion of specific SDLs such as math libraries and the OpenMP device
1843 // library libomptarget.
1844 void tools::AddStaticDeviceLibs(Compilation *C, const Tool *T,
1845                                 const JobAction *JA,
1846                                 const InputInfoList *Inputs, const Driver &D,
1847                                 const llvm::opt::ArgList &DriverArgs,
1848                                 llvm::opt::ArgStringList &CC1Args,
1849                                 StringRef Arch, StringRef Target,
1850                                 bool isBitCodeSDL, bool postClangLink) {
1851 
1852   SmallVector<std::string, 8> LibraryPaths;
1853   // Add search directories from LIBRARY_PATH env variable
1854   llvm::Optional<std::string> LibPath =
1855       llvm::sys::Process::GetEnv("LIBRARY_PATH");
1856   if (LibPath) {
1857     SmallVector<StringRef, 8> Frags;
1858     const char EnvPathSeparatorStr[] = {llvm::sys::EnvPathSeparator, '\0'};
1859     llvm::SplitString(*LibPath, Frags, EnvPathSeparatorStr);
1860     for (StringRef Path : Frags)
1861       LibraryPaths.emplace_back(Path.trim());
1862   }
1863 
1864   // Add directories from user-specified -L options
1865   for (std::string Search_Dir : DriverArgs.getAllArgValues(options::OPT_L))
1866     LibraryPaths.emplace_back(Search_Dir);
1867 
1868   // Add path to lib-debug folders
1869   SmallString<256> DefaultLibPath = llvm::sys::path::parent_path(D.Dir);
1870   llvm::sys::path::append(DefaultLibPath, Twine("lib") + CLANG_LIBDIR_SUFFIX);
1871   LibraryPaths.emplace_back(DefaultLibPath.c_str());
1872 
1873   // Build list of Static Device Libraries SDLs specified by -l option
1874   llvm::SmallSet<std::string, 16> SDLNames;
1875   static const StringRef HostOnlyArchives[] = {
1876       "omp", "cudart", "m", "gcc", "gcc_s", "pthread", "hip_hcc"};
1877   for (auto SDLName : DriverArgs.getAllArgValues(options::OPT_l)) {
1878     if (!HostOnlyArchives->contains(SDLName)) {
1879       SDLNames.insert(SDLName);
1880     }
1881   }
1882 
1883   // The search stops as soon as an SDL file is found. The driver then provides
1884   // the full filename of the SDL to the llvm-link or clang-nvlink-wrapper
1885   // command. If no SDL is found after searching each LINKPATH with
1886   // SEARCH-ORDER, it is possible that an archive file lib<libname>.a exists
1887   // and may contain bundled object files.
1888   for (auto SDLName : SDLNames) {
1889     // This is the only call to SDLSearch
1890     if (!SDLSearch(D, DriverArgs, CC1Args, LibraryPaths, SDLName, Arch, Target,
1891                    isBitCodeSDL, postClangLink)) {
1892       GetSDLFromOffloadArchive(*C, D, *T, *JA, *Inputs, DriverArgs, CC1Args,
1893                                LibraryPaths, SDLName, Arch, Target,
1894                                isBitCodeSDL, postClangLink);
1895     }
1896   }
1897 }
1898 
1899 static llvm::opt::Arg *
1900 getAMDGPUCodeObjectArgument(const Driver &D, const llvm::opt::ArgList &Args) {
1901   // The last of -mcode-object-v3, -mno-code-object-v3 and
1902   // -mcode-object-version=<version> wins.
1903   return Args.getLastArg(options::OPT_mcode_object_v3_legacy,
1904                          options::OPT_mno_code_object_v3_legacy,
1905                          options::OPT_mcode_object_version_EQ);
1906 }
1907 
1908 void tools::checkAMDGPUCodeObjectVersion(const Driver &D,
1909                                          const llvm::opt::ArgList &Args) {
1910   const unsigned MinCodeObjVer = 2;
1911   const unsigned MaxCodeObjVer = 4;
1912 
1913   // Emit warnings for legacy options even if they are overridden.
1914   if (Args.hasArg(options::OPT_mno_code_object_v3_legacy))
1915     D.Diag(diag::warn_drv_deprecated_arg) << "-mno-code-object-v3"
1916                                           << "-mcode-object-version=2";
1917 
1918   if (Args.hasArg(options::OPT_mcode_object_v3_legacy))
1919     D.Diag(diag::warn_drv_deprecated_arg) << "-mcode-object-v3"
1920                                           << "-mcode-object-version=3";
1921 
1922   if (auto *CodeObjArg = getAMDGPUCodeObjectArgument(D, Args)) {
1923     if (CodeObjArg->getOption().getID() ==
1924         options::OPT_mcode_object_version_EQ) {
1925       unsigned CodeObjVer = MaxCodeObjVer;
1926       auto Remnant =
1927           StringRef(CodeObjArg->getValue()).getAsInteger(0, CodeObjVer);
1928       if (Remnant || CodeObjVer < MinCodeObjVer || CodeObjVer > MaxCodeObjVer)
1929         D.Diag(diag::err_drv_invalid_int_value)
1930             << CodeObjArg->getAsString(Args) << CodeObjArg->getValue();
1931     }
1932   }
1933 }
1934 
1935 unsigned tools::getAMDGPUCodeObjectVersion(const Driver &D,
1936                                            const llvm::opt::ArgList &Args) {
1937   unsigned CodeObjVer = 4; // default
1938   if (auto *CodeObjArg = getAMDGPUCodeObjectArgument(D, Args)) {
1939     if (CodeObjArg->getOption().getID() ==
1940         options::OPT_mno_code_object_v3_legacy) {
1941       CodeObjVer = 2;
1942     } else if (CodeObjArg->getOption().getID() ==
1943                options::OPT_mcode_object_v3_legacy) {
1944       CodeObjVer = 3;
1945     } else {
1946       StringRef(CodeObjArg->getValue()).getAsInteger(0, CodeObjVer);
1947     }
1948   }
1949   return CodeObjVer;
1950 }
1951 
1952 bool tools::haveAMDGPUCodeObjectVersionArgument(
1953     const Driver &D, const llvm::opt::ArgList &Args) {
1954   return getAMDGPUCodeObjectArgument(D, Args) != nullptr;
1955 }
1956 
1957 void tools::addMachineOutlinerArgs(const Driver &D,
1958                                    const llvm::opt::ArgList &Args,
1959                                    llvm::opt::ArgStringList &CmdArgs,
1960                                    const llvm::Triple &Triple, bool IsLTO) {
1961   auto addArg = [&, IsLTO](const Twine &Arg) {
1962     if (IsLTO) {
1963       CmdArgs.push_back(Args.MakeArgString("-plugin-opt=" + Arg));
1964     } else {
1965       CmdArgs.push_back("-mllvm");
1966       CmdArgs.push_back(Args.MakeArgString(Arg));
1967     }
1968   };
1969 
1970   if (Arg *A = Args.getLastArg(options::OPT_moutline,
1971                                options::OPT_mno_outline)) {
1972     if (A->getOption().matches(options::OPT_moutline)) {
1973       // We only support -moutline in AArch64 and ARM targets right now. If
1974       // we're not compiling for these, emit a warning and ignore the flag.
1975       // Otherwise, add the proper mllvm flags.
1976       if (!(Triple.isARM() || Triple.isThumb() ||
1977             Triple.getArch() == llvm::Triple::aarch64 ||
1978             Triple.getArch() == llvm::Triple::aarch64_32)) {
1979         D.Diag(diag::warn_drv_moutline_unsupported_opt) << Triple.getArchName();
1980       } else {
1981         addArg(Twine("-enable-machine-outliner"));
1982       }
1983     } else {
1984       // Disable all outlining behaviour.
1985       addArg(Twine("-enable-machine-outliner=never"));
1986     }
1987   }
1988 }
1989 
1990 void tools::addOpenMPDeviceRTL(const Driver &D,
1991                                const llvm::opt::ArgList &DriverArgs,
1992                                llvm::opt::ArgStringList &CC1Args,
1993                                StringRef BitcodeSuffix,
1994                                const llvm::Triple &Triple) {
1995   SmallVector<StringRef, 8> LibraryPaths;
1996 
1997   // Add path to clang lib / lib64 folder.
1998   SmallString<256> DefaultLibPath = llvm::sys::path::parent_path(D.Dir);
1999   llvm::sys::path::append(DefaultLibPath, Twine("lib") + CLANG_LIBDIR_SUFFIX);
2000   LibraryPaths.emplace_back(DefaultLibPath.c_str());
2001 
2002   // Add user defined library paths from LIBRARY_PATH.
2003   llvm::Optional<std::string> LibPath =
2004       llvm::sys::Process::GetEnv("LIBRARY_PATH");
2005   if (LibPath) {
2006     SmallVector<StringRef, 8> Frags;
2007     const char EnvPathSeparatorStr[] = {llvm::sys::EnvPathSeparator, '\0'};
2008     llvm::SplitString(*LibPath, Frags, EnvPathSeparatorStr);
2009     for (StringRef Path : Frags)
2010       LibraryPaths.emplace_back(Path.trim());
2011   }
2012 
2013   OptSpecifier LibomptargetBCPathOpt =
2014       Triple.isAMDGCN() ? options::OPT_libomptarget_amdgcn_bc_path_EQ
2015                         : options::OPT_libomptarget_nvptx_bc_path_EQ;
2016 
2017   StringRef ArchPrefix = Triple.isAMDGCN() ? "amdgcn" : "nvptx";
2018   std::string LibOmpTargetName = "libomptarget-" + BitcodeSuffix.str() + ".bc";
2019 
2020   // First check whether user specifies bc library
2021   if (const Arg *A = DriverArgs.getLastArg(LibomptargetBCPathOpt)) {
2022     SmallString<128> LibOmpTargetFile(A->getValue());
2023     if (llvm::sys::fs::exists(LibOmpTargetFile) &&
2024         llvm::sys::fs::is_directory(LibOmpTargetFile)) {
2025       llvm::sys::path::append(LibOmpTargetFile, LibOmpTargetName);
2026     }
2027 
2028     if (llvm::sys::fs::exists(LibOmpTargetFile)) {
2029       CC1Args.push_back("-mlink-builtin-bitcode");
2030       CC1Args.push_back(DriverArgs.MakeArgString(LibOmpTargetFile));
2031     } else {
2032       D.Diag(diag::err_drv_omp_offload_target_bcruntime_not_found)
2033           << LibOmpTargetFile;
2034     }
2035   } else {
2036     bool FoundBCLibrary = false;
2037 
2038     for (StringRef LibraryPath : LibraryPaths) {
2039       SmallString<128> LibOmpTargetFile(LibraryPath);
2040       llvm::sys::path::append(LibOmpTargetFile, LibOmpTargetName);
2041       if (llvm::sys::fs::exists(LibOmpTargetFile)) {
2042         CC1Args.push_back("-mlink-builtin-bitcode");
2043         CC1Args.push_back(DriverArgs.MakeArgString(LibOmpTargetFile));
2044         FoundBCLibrary = true;
2045         break;
2046       }
2047     }
2048 
2049     if (!FoundBCLibrary)
2050       D.Diag(diag::err_drv_omp_offload_target_missingbcruntime)
2051           << LibOmpTargetName << ArchPrefix;
2052   }
2053 }
2054