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/Mips.h"
13 #include "Arch/PPC.h"
14 #include "Arch/SystemZ.h"
15 #include "Arch/VE.h"
16 #include "Arch/X86.h"
17 #include "HIP.h"
18 #include "Hexagon.h"
19 #include "InputInfo.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/Job.h"
30 #include "clang/Driver/Options.h"
31 #include "clang/Driver/SanitizerArgs.h"
32 #include "clang/Driver/ToolChain.h"
33 #include "clang/Driver/Util.h"
34 #include "clang/Driver/XRayArgs.h"
35 #include "llvm/ADT/STLExtras.h"
36 #include "llvm/ADT/SmallString.h"
37 #include "llvm/ADT/StringExtras.h"
38 #include "llvm/ADT/StringSwitch.h"
39 #include "llvm/ADT/Twine.h"
40 #include "llvm/Option/Arg.h"
41 #include "llvm/Option/ArgList.h"
42 #include "llvm/Option/Option.h"
43 #include "llvm/Support/CodeGen.h"
44 #include "llvm/Support/Compression.h"
45 #include "llvm/Support/Debug.h"
46 #include "llvm/Support/ErrorHandling.h"
47 #include "llvm/Support/FileSystem.h"
48 #include "llvm/Support/Host.h"
49 #include "llvm/Support/Path.h"
50 #include "llvm/Support/Process.h"
51 #include "llvm/Support/Program.h"
52 #include "llvm/Support/ScopedPrinter.h"
53 #include "llvm/Support/TargetParser.h"
54 #include "llvm/Support/Threading.h"
55 #include "llvm/Support/VirtualFileSystem.h"
56 #include "llvm/Support/YAMLParser.h"
57 
58 using namespace clang::driver;
59 using namespace clang::driver::tools;
60 using namespace clang;
61 using namespace llvm::opt;
62 
63 void tools::addPathIfExists(const Driver &D, const Twine &Path,
64                             ToolChain::path_list &Paths) {
65   if (D.getVFS().exists(Path))
66     Paths.push_back(Path.str());
67 }
68 
69 void tools::handleTargetFeaturesGroup(const ArgList &Args,
70                                       std::vector<StringRef> &Features,
71                                       OptSpecifier Group) {
72   for (const Arg *A : Args.filtered(Group)) {
73     StringRef Name = A->getOption().getName();
74     A->claim();
75 
76     // Skip over "-m".
77     assert(Name.startswith("m") && "Invalid feature name.");
78     Name = Name.substr(1);
79 
80     bool IsNegative = Name.startswith("no-");
81     if (IsNegative)
82       Name = Name.substr(3);
83     Features.push_back(Args.MakeArgString((IsNegative ? "-" : "+") + Name));
84   }
85 }
86 
87 std::vector<StringRef>
88 tools::unifyTargetFeatures(const std::vector<StringRef> &Features) {
89   std::vector<StringRef> UnifiedFeatures;
90   // Find the last of each feature.
91   llvm::StringMap<unsigned> LastOpt;
92   for (unsigned I = 0, N = Features.size(); I < N; ++I) {
93     StringRef Name = Features[I];
94     assert(Name[0] == '-' || Name[0] == '+');
95     LastOpt[Name.drop_front(1)] = I;
96   }
97 
98   for (unsigned I = 0, N = Features.size(); I < N; ++I) {
99     // If this feature was overridden, ignore it.
100     StringRef Name = Features[I];
101     llvm::StringMap<unsigned>::iterator LastI = LastOpt.find(Name.drop_front(1));
102     assert(LastI != LastOpt.end());
103     unsigned Last = LastI->second;
104     if (Last != I)
105       continue;
106 
107     UnifiedFeatures.push_back(Name);
108   }
109   return UnifiedFeatures;
110 }
111 
112 void tools::addDirectoryList(const ArgList &Args, ArgStringList &CmdArgs,
113                              const char *ArgName, const char *EnvVar) {
114   const char *DirList = ::getenv(EnvVar);
115   bool CombinedArg = false;
116 
117   if (!DirList)
118     return; // Nothing to do.
119 
120   StringRef Name(ArgName);
121   if (Name.equals("-I") || Name.equals("-L") || Name.empty())
122     CombinedArg = true;
123 
124   StringRef Dirs(DirList);
125   if (Dirs.empty()) // Empty string should not add '.'.
126     return;
127 
128   StringRef::size_type Delim;
129   while ((Delim = Dirs.find(llvm::sys::EnvPathSeparator)) != StringRef::npos) {
130     if (Delim == 0) { // Leading colon.
131       if (CombinedArg) {
132         CmdArgs.push_back(Args.MakeArgString(std::string(ArgName) + "."));
133       } else {
134         CmdArgs.push_back(ArgName);
135         CmdArgs.push_back(".");
136       }
137     } else {
138       if (CombinedArg) {
139         CmdArgs.push_back(
140             Args.MakeArgString(std::string(ArgName) + Dirs.substr(0, Delim)));
141       } else {
142         CmdArgs.push_back(ArgName);
143         CmdArgs.push_back(Args.MakeArgString(Dirs.substr(0, Delim)));
144       }
145     }
146     Dirs = Dirs.substr(Delim + 1);
147   }
148 
149   if (Dirs.empty()) { // Trailing colon.
150     if (CombinedArg) {
151       CmdArgs.push_back(Args.MakeArgString(std::string(ArgName) + "."));
152     } else {
153       CmdArgs.push_back(ArgName);
154       CmdArgs.push_back(".");
155     }
156   } else { // Add the last path.
157     if (CombinedArg) {
158       CmdArgs.push_back(Args.MakeArgString(std::string(ArgName) + Dirs));
159     } else {
160       CmdArgs.push_back(ArgName);
161       CmdArgs.push_back(Args.MakeArgString(Dirs));
162     }
163   }
164 }
165 
166 void tools::AddLinkerInputs(const ToolChain &TC, const InputInfoList &Inputs,
167                             const ArgList &Args, ArgStringList &CmdArgs,
168                             const JobAction &JA) {
169   const Driver &D = TC.getDriver();
170 
171   // Add extra linker input arguments which are not treated as inputs
172   // (constructed via -Xarch_).
173   Args.AddAllArgValues(CmdArgs, options::OPT_Zlinker_input);
174 
175   // LIBRARY_PATH are included before user inputs and only supported on native
176   // toolchains.
177   if (!TC.isCrossCompiling())
178     addDirectoryList(Args, CmdArgs, "-L", "LIBRARY_PATH");
179 
180   for (const auto &II : Inputs) {
181     // If the current tool chain refers to an OpenMP offloading host, we
182     // should ignore inputs that refer to OpenMP offloading devices -
183     // they will be embedded according to a proper linker script.
184     if (auto *IA = II.getAction())
185       if ((JA.isHostOffloading(Action::OFK_OpenMP) &&
186            IA->isDeviceOffloading(Action::OFK_OpenMP)))
187         continue;
188 
189     if (!TC.HasNativeLLVMSupport() && types::isLLVMIR(II.getType()))
190       // Don't try to pass LLVM inputs unless we have native support.
191       D.Diag(diag::err_drv_no_linker_llvm_support) << TC.getTripleString();
192 
193     // Add filenames immediately.
194     if (II.isFilename()) {
195       CmdArgs.push_back(II.getFilename());
196       continue;
197     }
198 
199     // Otherwise, this is a linker input argument.
200     const Arg &A = II.getInputArg();
201 
202     // Handle reserved library options.
203     if (A.getOption().matches(options::OPT_Z_reserved_lib_stdcxx))
204       TC.AddCXXStdlibLibArgs(Args, CmdArgs);
205     else if (A.getOption().matches(options::OPT_Z_reserved_lib_cckext))
206       TC.AddCCKextLibArgs(Args, CmdArgs);
207     else if (A.getOption().matches(options::OPT_z)) {
208       // Pass -z prefix for gcc linker compatibility.
209       A.claim();
210       A.render(Args, CmdArgs);
211     } else {
212       A.renderAsInput(Args, CmdArgs);
213     }
214   }
215 }
216 
217 void tools::AddTargetFeature(const ArgList &Args,
218                              std::vector<StringRef> &Features,
219                              OptSpecifier OnOpt, OptSpecifier OffOpt,
220                              StringRef FeatureName) {
221   if (Arg *A = Args.getLastArg(OnOpt, OffOpt)) {
222     if (A->getOption().matches(OnOpt))
223       Features.push_back(Args.MakeArgString("+" + FeatureName));
224     else
225       Features.push_back(Args.MakeArgString("-" + FeatureName));
226   }
227 }
228 
229 /// Get the (LLVM) name of the AMDGPU gpu we are targeting.
230 static std::string getAMDGPUTargetGPU(const llvm::Triple &T,
231                                       const ArgList &Args) {
232   if (Arg *A = Args.getLastArg(options::OPT_mcpu_EQ)) {
233     auto GPUName = getProcessorFromTargetID(T, A->getValue());
234     return llvm::StringSwitch<std::string>(GPUName)
235         .Cases("rv630", "rv635", "r600")
236         .Cases("rv610", "rv620", "rs780", "rs880")
237         .Case("rv740", "rv770")
238         .Case("palm", "cedar")
239         .Cases("sumo", "sumo2", "sumo")
240         .Case("hemlock", "cypress")
241         .Case("aruba", "cayman")
242         .Default(GPUName.str());
243   }
244   return "";
245 }
246 
247 static std::string getLanaiTargetCPU(const ArgList &Args) {
248   if (Arg *A = Args.getLastArg(options::OPT_mcpu_EQ)) {
249     return A->getValue();
250   }
251   return "";
252 }
253 
254 /// Get the (LLVM) name of the WebAssembly cpu we are targeting.
255 static StringRef getWebAssemblyTargetCPU(const ArgList &Args) {
256   // If we have -mcpu=, use that.
257   if (Arg *A = Args.getLastArg(options::OPT_mcpu_EQ)) {
258     StringRef CPU = A->getValue();
259 
260 #ifdef __wasm__
261     // Handle "native" by examining the host. "native" isn't meaningful when
262     // cross compiling, so only support this when the host is also WebAssembly.
263     if (CPU == "native")
264       return llvm::sys::getHostCPUName();
265 #endif
266 
267     return CPU;
268   }
269 
270   return "generic";
271 }
272 
273 std::string tools::getCPUName(const ArgList &Args, const llvm::Triple &T,
274                               bool FromAs) {
275   Arg *A;
276 
277   switch (T.getArch()) {
278   default:
279     return "";
280 
281   case llvm::Triple::aarch64:
282   case llvm::Triple::aarch64_32:
283   case llvm::Triple::aarch64_be:
284     return aarch64::getAArch64TargetCPU(Args, T, A);
285 
286   case llvm::Triple::arm:
287   case llvm::Triple::armeb:
288   case llvm::Triple::thumb:
289   case llvm::Triple::thumbeb: {
290     StringRef MArch, MCPU;
291     arm::getARMArchCPUFromArgs(Args, MArch, MCPU, FromAs);
292     return arm::getARMTargetCPU(MCPU, MArch, T);
293   }
294 
295   case llvm::Triple::avr:
296     if (const Arg *A = Args.getLastArg(options::OPT_mmcu_EQ))
297       return A->getValue();
298     return "";
299 
300   case llvm::Triple::mips:
301   case llvm::Triple::mipsel:
302   case llvm::Triple::mips64:
303   case llvm::Triple::mips64el: {
304     StringRef CPUName;
305     StringRef ABIName;
306     mips::getMipsCPUAndABI(Args, T, CPUName, ABIName);
307     return std::string(CPUName);
308   }
309 
310   case llvm::Triple::nvptx:
311   case llvm::Triple::nvptx64:
312     if (const Arg *A = Args.getLastArg(options::OPT_march_EQ))
313       return A->getValue();
314     return "";
315 
316   case llvm::Triple::ppc:
317   case llvm::Triple::ppc64:
318   case llvm::Triple::ppc64le: {
319     std::string TargetCPUName = ppc::getPPCTargetCPU(Args);
320     // LLVM may default to generating code for the native CPU,
321     // but, like gcc, we default to a more generic option for
322     // each architecture. (except on AIX)
323     if (!TargetCPUName.empty())
324       return TargetCPUName;
325 
326     if (T.isOSAIX())
327       TargetCPUName = "pwr4";
328     else if (T.getArch() == llvm::Triple::ppc64le)
329       TargetCPUName = "ppc64le";
330     else if (T.getArch() == llvm::Triple::ppc64)
331       TargetCPUName = "ppc64";
332     else
333       TargetCPUName = "ppc";
334 
335     return TargetCPUName;
336   }
337   case llvm::Triple::riscv32:
338   case llvm::Triple::riscv64:
339     if (const Arg *A = Args.getLastArg(options::OPT_mcpu_EQ))
340       return A->getValue();
341     return "";
342 
343   case llvm::Triple::bpfel:
344   case llvm::Triple::bpfeb:
345   case llvm::Triple::sparc:
346   case llvm::Triple::sparcel:
347   case llvm::Triple::sparcv9:
348     if (const Arg *A = Args.getLastArg(options::OPT_mcpu_EQ))
349       return A->getValue();
350     return "";
351 
352   case llvm::Triple::x86:
353   case llvm::Triple::x86_64:
354     return x86::getX86TargetCPU(Args, T);
355 
356   case llvm::Triple::hexagon:
357     return "hexagon" +
358            toolchains::HexagonToolChain::GetTargetCPUVersion(Args).str();
359 
360   case llvm::Triple::lanai:
361     return getLanaiTargetCPU(Args);
362 
363   case llvm::Triple::systemz:
364     return systemz::getSystemZTargetCPU(Args);
365 
366   case llvm::Triple::r600:
367   case llvm::Triple::amdgcn:
368     return getAMDGPUTargetGPU(T, Args);
369 
370   case llvm::Triple::wasm32:
371   case llvm::Triple::wasm64:
372     return std::string(getWebAssemblyTargetCPU(Args));
373   }
374 }
375 
376 llvm::StringRef tools::getLTOParallelism(const ArgList &Args, const Driver &D) {
377   Arg *LtoJobsArg = Args.getLastArg(options::OPT_flto_jobs_EQ);
378   if (!LtoJobsArg)
379     return {};
380   if (!llvm::get_threadpool_strategy(LtoJobsArg->getValue()))
381     D.Diag(diag::err_drv_invalid_int_value)
382         << LtoJobsArg->getAsString(Args) << LtoJobsArg->getValue();
383   return LtoJobsArg->getValue();
384 }
385 
386 // CloudABI uses -ffunction-sections and -fdata-sections by default.
387 bool tools::isUseSeparateSections(const llvm::Triple &Triple) {
388   return Triple.getOS() == llvm::Triple::CloudABI;
389 }
390 
391 void tools::addLTOOptions(const ToolChain &ToolChain, const ArgList &Args,
392                           ArgStringList &CmdArgs, const InputInfo &Output,
393                           const InputInfo &Input, bool IsThinLTO) {
394   const char *Linker = Args.MakeArgString(ToolChain.GetLinkerPath());
395   const Driver &D = ToolChain.getDriver();
396   if (llvm::sys::path::filename(Linker) != "ld.lld" &&
397       llvm::sys::path::stem(Linker) != "ld.lld") {
398     // Tell the linker to load the plugin. This has to come before
399     // AddLinkerInputs as gold requires -plugin to come before any -plugin-opt
400     // that -Wl might forward.
401     CmdArgs.push_back("-plugin");
402 
403 #if defined(_WIN32)
404     const char *Suffix = ".dll";
405 #elif defined(__APPLE__)
406     const char *Suffix = ".dylib";
407 #else
408     const char *Suffix = ".so";
409 #endif
410 
411     SmallString<1024> Plugin;
412     llvm::sys::path::native(
413         Twine(D.Dir) + "/../lib" CLANG_LIBDIR_SUFFIX "/LLVMgold" + Suffix,
414         Plugin);
415     CmdArgs.push_back(Args.MakeArgString(Plugin));
416   }
417 
418   // Try to pass driver level flags relevant to LTO code generation down to
419   // the plugin.
420 
421   // Handle flags for selecting CPU variants.
422   std::string CPU = getCPUName(Args, ToolChain.getTriple());
423   if (!CPU.empty())
424     CmdArgs.push_back(Args.MakeArgString(Twine("-plugin-opt=mcpu=") + CPU));
425 
426   if (Arg *A = Args.getLastArg(options::OPT_O_Group)) {
427     // The optimization level matches
428     // CompilerInvocation.cpp:getOptimizationLevel().
429     StringRef OOpt;
430     if (A->getOption().matches(options::OPT_O4) ||
431         A->getOption().matches(options::OPT_Ofast))
432       OOpt = "3";
433     else if (A->getOption().matches(options::OPT_O)) {
434       OOpt = A->getValue();
435       if (OOpt == "g")
436         OOpt = "1";
437       else if (OOpt == "s" || OOpt == "z")
438         OOpt = "2";
439     } else if (A->getOption().matches(options::OPT_O0))
440       OOpt = "0";
441     if (!OOpt.empty())
442       CmdArgs.push_back(Args.MakeArgString(Twine("-plugin-opt=O") + OOpt));
443   }
444 
445   if (Args.hasArg(options::OPT_gsplit_dwarf)) {
446     CmdArgs.push_back(
447         Args.MakeArgString(Twine("-plugin-opt=dwo_dir=") +
448             Output.getFilename() + "_dwo"));
449   }
450 
451   if (IsThinLTO)
452     CmdArgs.push_back("-plugin-opt=thinlto");
453 
454   StringRef Parallelism = getLTOParallelism(Args, D);
455   if (!Parallelism.empty())
456     CmdArgs.push_back(
457         Args.MakeArgString("-plugin-opt=jobs=" + Twine(Parallelism)));
458 
459   // If an explicit debugger tuning argument appeared, pass it along.
460   if (Arg *A = Args.getLastArg(options::OPT_gTune_Group,
461                                options::OPT_ggdbN_Group)) {
462     if (A->getOption().matches(options::OPT_glldb))
463       CmdArgs.push_back("-plugin-opt=-debugger-tune=lldb");
464     else if (A->getOption().matches(options::OPT_gsce))
465       CmdArgs.push_back("-plugin-opt=-debugger-tune=sce");
466     else
467       CmdArgs.push_back("-plugin-opt=-debugger-tune=gdb");
468   }
469 
470   bool UseSeparateSections =
471       isUseSeparateSections(ToolChain.getEffectiveTriple());
472 
473   if (Args.hasFlag(options::OPT_ffunction_sections,
474                    options::OPT_fno_function_sections, UseSeparateSections)) {
475     CmdArgs.push_back("-plugin-opt=-function-sections");
476   }
477 
478   if (Args.hasFlag(options::OPT_fdata_sections, options::OPT_fno_data_sections,
479                    UseSeparateSections)) {
480     CmdArgs.push_back("-plugin-opt=-data-sections");
481   }
482 
483   if (Arg *A = getLastProfileSampleUseArg(Args)) {
484     StringRef FName = A->getValue();
485     if (!llvm::sys::fs::exists(FName))
486       D.Diag(diag::err_drv_no_such_file) << FName;
487     else
488       CmdArgs.push_back(
489           Args.MakeArgString(Twine("-plugin-opt=sample-profile=") + FName));
490   }
491 
492   auto *CSPGOGenerateArg = Args.getLastArg(options::OPT_fcs_profile_generate,
493                                            options::OPT_fcs_profile_generate_EQ,
494                                            options::OPT_fno_profile_generate);
495   if (CSPGOGenerateArg &&
496       CSPGOGenerateArg->getOption().matches(options::OPT_fno_profile_generate))
497     CSPGOGenerateArg = nullptr;
498 
499   auto *ProfileUseArg = getLastProfileUseArg(Args);
500 
501   if (CSPGOGenerateArg) {
502     CmdArgs.push_back(Args.MakeArgString("-plugin-opt=cs-profile-generate"));
503     if (CSPGOGenerateArg->getOption().matches(
504             options::OPT_fcs_profile_generate_EQ)) {
505       SmallString<128> Path(CSPGOGenerateArg->getValue());
506       llvm::sys::path::append(Path, "default_%m.profraw");
507       CmdArgs.push_back(
508           Args.MakeArgString(Twine("-plugin-opt=cs-profile-path=") + Path));
509     } else
510       CmdArgs.push_back(
511           Args.MakeArgString("-plugin-opt=cs-profile-path=default_%m.profraw"));
512   } else if (ProfileUseArg) {
513     SmallString<128> Path(
514         ProfileUseArg->getNumValues() == 0 ? "" : ProfileUseArg->getValue());
515     if (Path.empty() || llvm::sys::fs::is_directory(Path))
516       llvm::sys::path::append(Path, "default.profdata");
517     CmdArgs.push_back(Args.MakeArgString(Twine("-plugin-opt=cs-profile-path=") +
518                                          Path));
519   }
520 
521   // Need this flag to turn on new pass manager via Gold plugin.
522   if (Args.hasFlag(options::OPT_fexperimental_new_pass_manager,
523                    options::OPT_fno_experimental_new_pass_manager,
524                    /* Default */ ENABLE_EXPERIMENTAL_NEW_PASS_MANAGER)) {
525     CmdArgs.push_back("-plugin-opt=new-pass-manager");
526   }
527 
528   // Setup statistics file output.
529   SmallString<128> StatsFile = getStatsFileName(Args, Output, Input, D);
530   if (!StatsFile.empty())
531     CmdArgs.push_back(
532         Args.MakeArgString(Twine("-plugin-opt=stats-file=") + StatsFile));
533 
534   addX86AlignBranchArgs(D, Args, CmdArgs, /*IsLTO=*/true);
535 }
536 
537 void tools::addArchSpecificRPath(const ToolChain &TC, const ArgList &Args,
538                                  ArgStringList &CmdArgs) {
539   // Enable -frtlib-add-rpath by default for the case of VE.
540   const bool IsVE = TC.getTriple().isVE();
541   bool DefaultValue = IsVE;
542   if (!Args.hasFlag(options::OPT_frtlib_add_rpath,
543                     options::OPT_fno_rtlib_add_rpath, DefaultValue))
544     return;
545 
546   std::string CandidateRPath = TC.getArchSpecificLibPath();
547   if (TC.getVFS().exists(CandidateRPath)) {
548     CmdArgs.push_back("-rpath");
549     CmdArgs.push_back(Args.MakeArgString(CandidateRPath.c_str()));
550   }
551 }
552 
553 bool tools::addOpenMPRuntime(ArgStringList &CmdArgs, const ToolChain &TC,
554                              const ArgList &Args, bool ForceStaticHostRuntime,
555                              bool IsOffloadingHost, bool GompNeedsRT) {
556   if (!Args.hasFlag(options::OPT_fopenmp, options::OPT_fopenmp_EQ,
557                     options::OPT_fno_openmp, false))
558     return false;
559 
560   Driver::OpenMPRuntimeKind RTKind = TC.getDriver().getOpenMPRuntime(Args);
561 
562   if (RTKind == Driver::OMPRT_Unknown)
563     // Already diagnosed.
564     return false;
565 
566   if (ForceStaticHostRuntime)
567     CmdArgs.push_back("-Bstatic");
568 
569   switch (RTKind) {
570   case Driver::OMPRT_OMP:
571     CmdArgs.push_back("-lomp");
572     break;
573   case Driver::OMPRT_GOMP:
574     CmdArgs.push_back("-lgomp");
575     break;
576   case Driver::OMPRT_IOMP5:
577     CmdArgs.push_back("-liomp5");
578     break;
579   case Driver::OMPRT_Unknown:
580     break;
581   }
582 
583   if (ForceStaticHostRuntime)
584     CmdArgs.push_back("-Bdynamic");
585 
586   if (RTKind == Driver::OMPRT_GOMP && GompNeedsRT)
587       CmdArgs.push_back("-lrt");
588 
589   if (IsOffloadingHost)
590     CmdArgs.push_back("-lomptarget");
591 
592   addArchSpecificRPath(TC, Args, CmdArgs);
593 
594   return true;
595 }
596 
597 static void addSanitizerRuntime(const ToolChain &TC, const ArgList &Args,
598                                 ArgStringList &CmdArgs, StringRef Sanitizer,
599                                 bool IsShared, bool IsWhole) {
600   // Wrap any static runtimes that must be forced into executable in
601   // whole-archive.
602   if (IsWhole) CmdArgs.push_back("--whole-archive");
603   CmdArgs.push_back(TC.getCompilerRTArgString(
604       Args, Sanitizer, IsShared ? ToolChain::FT_Shared : ToolChain::FT_Static));
605   if (IsWhole) CmdArgs.push_back("--no-whole-archive");
606 
607   if (IsShared) {
608     addArchSpecificRPath(TC, Args, CmdArgs);
609   }
610 }
611 
612 // Tries to use a file with the list of dynamic symbols that need to be exported
613 // from the runtime library. Returns true if the file was found.
614 static bool addSanitizerDynamicList(const ToolChain &TC, const ArgList &Args,
615                                     ArgStringList &CmdArgs,
616                                     StringRef Sanitizer) {
617   // Solaris ld defaults to --export-dynamic behaviour but doesn't support
618   // the option, so don't try to pass it.
619   if (TC.getTriple().getOS() == llvm::Triple::Solaris)
620     return true;
621   // Myriad is static linking only.  Furthermore, some versions of its
622   // linker have the bug where --export-dynamic overrides -static, so
623   // don't use --export-dynamic on that platform.
624   if (TC.getTriple().getVendor() == llvm::Triple::Myriad)
625     return true;
626   SmallString<128> SanRT(TC.getCompilerRT(Args, Sanitizer));
627   if (llvm::sys::fs::exists(SanRT + ".syms")) {
628     CmdArgs.push_back(Args.MakeArgString("--dynamic-list=" + SanRT + ".syms"));
629     return true;
630   }
631   return false;
632 }
633 
634 static const char *getAsNeededOption(const ToolChain &TC, bool as_needed) {
635   // While the Solaris 11.2 ld added --as-needed/--no-as-needed as aliases
636   // for the native forms -z ignore/-z record, they are missing in Illumos,
637   // so always use the native form.
638   if (TC.getTriple().isOSSolaris())
639     return as_needed ? "-zignore" : "-zrecord";
640   else
641     return as_needed ? "--as-needed" : "--no-as-needed";
642 }
643 
644 void tools::linkSanitizerRuntimeDeps(const ToolChain &TC,
645                                      ArgStringList &CmdArgs) {
646   // Fuchsia never needs these.  Any sanitizer runtimes with system
647   // dependencies use the `.deplibs` feature instead.
648   if (TC.getTriple().isOSFuchsia())
649     return;
650 
651   // Force linking against the system libraries sanitizers depends on
652   // (see PR15823 why this is necessary).
653   CmdArgs.push_back(getAsNeededOption(TC, false));
654   // There's no libpthread or librt on RTEMS & Android.
655   if (TC.getTriple().getOS() != llvm::Triple::RTEMS &&
656       !TC.getTriple().isAndroid()) {
657     CmdArgs.push_back("-lpthread");
658     if (!TC.getTriple().isOSOpenBSD())
659       CmdArgs.push_back("-lrt");
660   }
661   CmdArgs.push_back("-lm");
662   // There's no libdl on all OSes.
663   if (!TC.getTriple().isOSFreeBSD() &&
664       !TC.getTriple().isOSNetBSD() &&
665       !TC.getTriple().isOSOpenBSD() &&
666        TC.getTriple().getOS() != llvm::Triple::RTEMS)
667     CmdArgs.push_back("-ldl");
668   // Required for backtrace on some OSes
669   if (TC.getTriple().isOSFreeBSD() ||
670       TC.getTriple().isOSNetBSD())
671     CmdArgs.push_back("-lexecinfo");
672 }
673 
674 static void
675 collectSanitizerRuntimes(const ToolChain &TC, const ArgList &Args,
676                          SmallVectorImpl<StringRef> &SharedRuntimes,
677                          SmallVectorImpl<StringRef> &StaticRuntimes,
678                          SmallVectorImpl<StringRef> &NonWholeStaticRuntimes,
679                          SmallVectorImpl<StringRef> &HelperStaticRuntimes,
680                          SmallVectorImpl<StringRef> &RequiredSymbols) {
681   const SanitizerArgs &SanArgs = TC.getSanitizerArgs();
682   // Collect shared runtimes.
683   if (SanArgs.needsSharedRt()) {
684     if (SanArgs.needsAsanRt() && SanArgs.linkRuntimes()) {
685       SharedRuntimes.push_back("asan");
686       if (!Args.hasArg(options::OPT_shared) && !TC.getTriple().isAndroid())
687         HelperStaticRuntimes.push_back("asan-preinit");
688     }
689     if (SanArgs.needsHeapProfRt() && SanArgs.linkRuntimes()) {
690       SharedRuntimes.push_back("heapprof");
691       if (!Args.hasArg(options::OPT_shared) && !TC.getTriple().isAndroid())
692         HelperStaticRuntimes.push_back("heapprof-preinit");
693     }
694     if (SanArgs.needsUbsanRt() && SanArgs.linkRuntimes()) {
695       if (SanArgs.requiresMinimalRuntime())
696         SharedRuntimes.push_back("ubsan_minimal");
697       else
698         SharedRuntimes.push_back("ubsan_standalone");
699     }
700     if (SanArgs.needsScudoRt() && SanArgs.linkRuntimes()) {
701       if (SanArgs.requiresMinimalRuntime())
702         SharedRuntimes.push_back("scudo_minimal");
703       else
704         SharedRuntimes.push_back("scudo");
705     }
706     if (SanArgs.needsHwasanRt() && SanArgs.linkRuntimes())
707       SharedRuntimes.push_back("hwasan");
708   }
709 
710   // The stats_client library is also statically linked into DSOs.
711   if (SanArgs.needsStatsRt() && SanArgs.linkRuntimes())
712     StaticRuntimes.push_back("stats_client");
713 
714   // Collect static runtimes.
715   if (Args.hasArg(options::OPT_shared)) {
716     // Don't link static runtimes into DSOs.
717     return;
718   }
719 
720   // Each static runtime that has a DSO counterpart above is excluded below,
721   // but runtimes that exist only as static are not affected by needsSharedRt.
722 
723   if (!SanArgs.needsSharedRt() && SanArgs.needsAsanRt() && SanArgs.linkRuntimes()) {
724     StaticRuntimes.push_back("asan");
725     if (SanArgs.linkCXXRuntimes())
726       StaticRuntimes.push_back("asan_cxx");
727   }
728 
729   if (!SanArgs.needsSharedRt() && SanArgs.needsHeapProfRt() &&
730       SanArgs.linkRuntimes()) {
731     StaticRuntimes.push_back("heapprof");
732     if (SanArgs.linkCXXRuntimes())
733       StaticRuntimes.push_back("heapprof_cxx");
734   }
735 
736   if (!SanArgs.needsSharedRt() && SanArgs.needsHwasanRt() && SanArgs.linkRuntimes()) {
737     StaticRuntimes.push_back("hwasan");
738     if (SanArgs.linkCXXRuntimes())
739       StaticRuntimes.push_back("hwasan_cxx");
740   }
741   if (SanArgs.needsDfsanRt() && SanArgs.linkRuntimes())
742     StaticRuntimes.push_back("dfsan");
743   if (SanArgs.needsLsanRt() && SanArgs.linkRuntimes())
744     StaticRuntimes.push_back("lsan");
745   if (SanArgs.needsMsanRt() && SanArgs.linkRuntimes()) {
746     StaticRuntimes.push_back("msan");
747     if (SanArgs.linkCXXRuntimes())
748       StaticRuntimes.push_back("msan_cxx");
749   }
750   if (SanArgs.needsTsanRt() && SanArgs.linkRuntimes()) {
751     StaticRuntimes.push_back("tsan");
752     if (SanArgs.linkCXXRuntimes())
753       StaticRuntimes.push_back("tsan_cxx");
754   }
755   if (!SanArgs.needsSharedRt() && SanArgs.needsUbsanRt() && SanArgs.linkRuntimes()) {
756     if (SanArgs.requiresMinimalRuntime()) {
757       StaticRuntimes.push_back("ubsan_minimal");
758     } else {
759       StaticRuntimes.push_back("ubsan_standalone");
760       if (SanArgs.linkCXXRuntimes())
761         StaticRuntimes.push_back("ubsan_standalone_cxx");
762     }
763   }
764   if (SanArgs.needsSafeStackRt() && SanArgs.linkRuntimes()) {
765     NonWholeStaticRuntimes.push_back("safestack");
766     RequiredSymbols.push_back("__safestack_init");
767   }
768   if (!(SanArgs.needsSharedRt() && SanArgs.needsUbsanRt() && SanArgs.linkRuntimes())) {
769     if (SanArgs.needsCfiRt() && SanArgs.linkRuntimes())
770       StaticRuntimes.push_back("cfi");
771     if (SanArgs.needsCfiDiagRt() && SanArgs.linkRuntimes()) {
772       StaticRuntimes.push_back("cfi_diag");
773       if (SanArgs.linkCXXRuntimes())
774         StaticRuntimes.push_back("ubsan_standalone_cxx");
775     }
776   }
777   if (SanArgs.needsStatsRt() && SanArgs.linkRuntimes()) {
778     NonWholeStaticRuntimes.push_back("stats");
779     RequiredSymbols.push_back("__sanitizer_stats_register");
780   }
781   if (!SanArgs.needsSharedRt() && SanArgs.needsScudoRt() && SanArgs.linkRuntimes()) {
782     if (SanArgs.requiresMinimalRuntime()) {
783       StaticRuntimes.push_back("scudo_minimal");
784       if (SanArgs.linkCXXRuntimes())
785         StaticRuntimes.push_back("scudo_cxx_minimal");
786     } else {
787       StaticRuntimes.push_back("scudo");
788       if (SanArgs.linkCXXRuntimes())
789         StaticRuntimes.push_back("scudo_cxx");
790     }
791   }
792 }
793 
794 // Should be called before we add system libraries (C++ ABI, libstdc++/libc++,
795 // C runtime, etc). Returns true if sanitizer system deps need to be linked in.
796 bool tools::addSanitizerRuntimes(const ToolChain &TC, const ArgList &Args,
797                                  ArgStringList &CmdArgs) {
798   SmallVector<StringRef, 4> SharedRuntimes, StaticRuntimes,
799       NonWholeStaticRuntimes, HelperStaticRuntimes, RequiredSymbols;
800   collectSanitizerRuntimes(TC, Args, SharedRuntimes, StaticRuntimes,
801                            NonWholeStaticRuntimes, HelperStaticRuntimes,
802                            RequiredSymbols);
803 
804   const SanitizerArgs &SanArgs = TC.getSanitizerArgs();
805   // Inject libfuzzer dependencies.
806   if (SanArgs.needsFuzzer() && SanArgs.linkRuntimes() &&
807       !Args.hasArg(options::OPT_shared)) {
808 
809     addSanitizerRuntime(TC, Args, CmdArgs, "fuzzer", false, true);
810     if (SanArgs.needsFuzzerInterceptors())
811       addSanitizerRuntime(TC, Args, CmdArgs, "fuzzer_interceptors", false,
812                           true);
813     if (!Args.hasArg(clang::driver::options::OPT_nostdlibxx))
814       TC.AddCXXStdlibLibArgs(Args, CmdArgs);
815   }
816 
817   for (auto RT : SharedRuntimes)
818     addSanitizerRuntime(TC, Args, CmdArgs, RT, true, false);
819   for (auto RT : HelperStaticRuntimes)
820     addSanitizerRuntime(TC, Args, CmdArgs, RT, false, true);
821   bool AddExportDynamic = false;
822   for (auto RT : StaticRuntimes) {
823     addSanitizerRuntime(TC, Args, CmdArgs, RT, false, true);
824     AddExportDynamic |= !addSanitizerDynamicList(TC, Args, CmdArgs, RT);
825   }
826   for (auto RT : NonWholeStaticRuntimes) {
827     addSanitizerRuntime(TC, Args, CmdArgs, RT, false, false);
828     AddExportDynamic |= !addSanitizerDynamicList(TC, Args, CmdArgs, RT);
829   }
830   for (auto S : RequiredSymbols) {
831     CmdArgs.push_back("-u");
832     CmdArgs.push_back(Args.MakeArgString(S));
833   }
834   // If there is a static runtime with no dynamic list, force all the symbols
835   // to be dynamic to be sure we export sanitizer interface functions.
836   if (AddExportDynamic)
837     CmdArgs.push_back("--export-dynamic");
838 
839   if (SanArgs.hasCrossDsoCfi() && !AddExportDynamic)
840     CmdArgs.push_back("--export-dynamic-symbol=__cfi_check");
841 
842   return !StaticRuntimes.empty() || !NonWholeStaticRuntimes.empty();
843 }
844 
845 bool tools::addXRayRuntime(const ToolChain&TC, const ArgList &Args, ArgStringList &CmdArgs) {
846   if (Args.hasArg(options::OPT_shared))
847     return false;
848 
849   if (TC.getXRayArgs().needsXRayRt()) {
850     CmdArgs.push_back("-whole-archive");
851     CmdArgs.push_back(TC.getCompilerRTArgString(Args, "xray"));
852     for (const auto &Mode : TC.getXRayArgs().modeList())
853       CmdArgs.push_back(TC.getCompilerRTArgString(Args, Mode));
854     CmdArgs.push_back("-no-whole-archive");
855     return true;
856   }
857 
858   return false;
859 }
860 
861 void tools::linkXRayRuntimeDeps(const ToolChain &TC, ArgStringList &CmdArgs) {
862   CmdArgs.push_back(getAsNeededOption(TC, false));
863   CmdArgs.push_back("-lpthread");
864   if (!TC.getTriple().isOSOpenBSD())
865     CmdArgs.push_back("-lrt");
866   CmdArgs.push_back("-lm");
867 
868   if (!TC.getTriple().isOSFreeBSD() &&
869       !TC.getTriple().isOSNetBSD() &&
870       !TC.getTriple().isOSOpenBSD())
871     CmdArgs.push_back("-ldl");
872 }
873 
874 bool tools::areOptimizationsEnabled(const ArgList &Args) {
875   // Find the last -O arg and see if it is non-zero.
876   if (Arg *A = Args.getLastArg(options::OPT_O_Group))
877     return !A->getOption().matches(options::OPT_O0);
878   // Defaults to -O0.
879   return false;
880 }
881 
882 const char *tools::SplitDebugName(const ArgList &Args, const InputInfo &Input,
883                                   const InputInfo &Output) {
884   if (Arg *A = Args.getLastArg(options::OPT_gsplit_dwarf_EQ))
885     if (StringRef(A->getValue()) == "single")
886       return Args.MakeArgString(Output.getFilename());
887 
888   Arg *FinalOutput = Args.getLastArg(options::OPT_o);
889   if (FinalOutput && Args.hasArg(options::OPT_c)) {
890     SmallString<128> T(FinalOutput->getValue());
891     llvm::sys::path::replace_extension(T, "dwo");
892     return Args.MakeArgString(T);
893   } else {
894     // Use the compilation dir.
895     SmallString<128> T(
896         Args.getLastArgValue(options::OPT_fdebug_compilation_dir));
897     SmallString<128> F(llvm::sys::path::stem(Input.getBaseInput()));
898     llvm::sys::path::replace_extension(F, "dwo");
899     T += F;
900     return Args.MakeArgString(F);
901   }
902 }
903 
904 void tools::SplitDebugInfo(const ToolChain &TC, Compilation &C, const Tool &T,
905                            const JobAction &JA, const ArgList &Args,
906                            const InputInfo &Output, const char *OutFile) {
907   ArgStringList ExtractArgs;
908   ExtractArgs.push_back("--extract-dwo");
909 
910   ArgStringList StripArgs;
911   StripArgs.push_back("--strip-dwo");
912 
913   // Grabbing the output of the earlier compile step.
914   StripArgs.push_back(Output.getFilename());
915   ExtractArgs.push_back(Output.getFilename());
916   ExtractArgs.push_back(OutFile);
917 
918   const char *Exec =
919       Args.MakeArgString(TC.GetProgramPath(CLANG_DEFAULT_OBJCOPY));
920   InputInfo II(types::TY_Object, Output.getFilename(), Output.getFilename());
921 
922   // First extract the dwo sections.
923   C.addCommand(std::make_unique<Command>(
924       JA, T, ResponseFileSupport::AtFileCurCP(), Exec, ExtractArgs, II));
925 
926   // Then remove them from the original .o file.
927   C.addCommand(std::make_unique<Command>(
928       JA, T, ResponseFileSupport::AtFileCurCP(), Exec, StripArgs, II));
929 }
930 
931 // Claim options we don't want to warn if they are unused. We do this for
932 // options that build systems might add but are unused when assembling or only
933 // running the preprocessor for example.
934 void tools::claimNoWarnArgs(const ArgList &Args) {
935   // Don't warn about unused -f(no-)?lto.  This can happen when we're
936   // preprocessing, precompiling or assembling.
937   Args.ClaimAllArgs(options::OPT_flto_EQ);
938   Args.ClaimAllArgs(options::OPT_flto);
939   Args.ClaimAllArgs(options::OPT_fno_lto);
940 }
941 
942 Arg *tools::getLastProfileUseArg(const ArgList &Args) {
943   auto *ProfileUseArg = Args.getLastArg(
944       options::OPT_fprofile_instr_use, options::OPT_fprofile_instr_use_EQ,
945       options::OPT_fprofile_use, options::OPT_fprofile_use_EQ,
946       options::OPT_fno_profile_instr_use);
947 
948   if (ProfileUseArg &&
949       ProfileUseArg->getOption().matches(options::OPT_fno_profile_instr_use))
950     ProfileUseArg = nullptr;
951 
952   return ProfileUseArg;
953 }
954 
955 Arg *tools::getLastProfileSampleUseArg(const ArgList &Args) {
956   auto *ProfileSampleUseArg = Args.getLastArg(
957       options::OPT_fprofile_sample_use, options::OPT_fprofile_sample_use_EQ,
958       options::OPT_fauto_profile, options::OPT_fauto_profile_EQ,
959       options::OPT_fno_profile_sample_use, options::OPT_fno_auto_profile);
960 
961   if (ProfileSampleUseArg &&
962       (ProfileSampleUseArg->getOption().matches(
963            options::OPT_fno_profile_sample_use) ||
964        ProfileSampleUseArg->getOption().matches(options::OPT_fno_auto_profile)))
965     return nullptr;
966 
967   return Args.getLastArg(options::OPT_fprofile_sample_use_EQ,
968                          options::OPT_fauto_profile_EQ);
969 }
970 
971 /// Parses the various -fpic/-fPIC/-fpie/-fPIE arguments.  Then,
972 /// smooshes them together with platform defaults, to decide whether
973 /// this compile should be using PIC mode or not. Returns a tuple of
974 /// (RelocationModel, PICLevel, IsPIE).
975 std::tuple<llvm::Reloc::Model, unsigned, bool>
976 tools::ParsePICArgs(const ToolChain &ToolChain, const ArgList &Args) {
977   const llvm::Triple &EffectiveTriple = ToolChain.getEffectiveTriple();
978   const llvm::Triple &Triple = ToolChain.getTriple();
979 
980   bool PIE = ToolChain.isPIEDefault();
981   bool PIC = PIE || ToolChain.isPICDefault();
982   // The Darwin/MachO default to use PIC does not apply when using -static.
983   if (Triple.isOSBinFormatMachO() && Args.hasArg(options::OPT_static))
984     PIE = PIC = false;
985   bool IsPICLevelTwo = PIC;
986 
987   bool KernelOrKext =
988       Args.hasArg(options::OPT_mkernel, options::OPT_fapple_kext);
989 
990   // Android-specific defaults for PIC/PIE
991   if (Triple.isAndroid()) {
992     switch (Triple.getArch()) {
993     case llvm::Triple::arm:
994     case llvm::Triple::armeb:
995     case llvm::Triple::thumb:
996     case llvm::Triple::thumbeb:
997     case llvm::Triple::aarch64:
998     case llvm::Triple::mips:
999     case llvm::Triple::mipsel:
1000     case llvm::Triple::mips64:
1001     case llvm::Triple::mips64el:
1002       PIC = true; // "-fpic"
1003       break;
1004 
1005     case llvm::Triple::x86:
1006     case llvm::Triple::x86_64:
1007       PIC = true; // "-fPIC"
1008       IsPICLevelTwo = true;
1009       break;
1010 
1011     default:
1012       break;
1013     }
1014   }
1015 
1016   // OpenBSD-specific defaults for PIE
1017   if (Triple.isOSOpenBSD()) {
1018     switch (ToolChain.getArch()) {
1019     case llvm::Triple::arm:
1020     case llvm::Triple::aarch64:
1021     case llvm::Triple::mips64:
1022     case llvm::Triple::mips64el:
1023     case llvm::Triple::x86:
1024     case llvm::Triple::x86_64:
1025       IsPICLevelTwo = false; // "-fpie"
1026       break;
1027 
1028     case llvm::Triple::ppc:
1029     case llvm::Triple::sparc:
1030     case llvm::Triple::sparcel:
1031     case llvm::Triple::sparcv9:
1032       IsPICLevelTwo = true; // "-fPIE"
1033       break;
1034 
1035     default:
1036       break;
1037     }
1038   }
1039 
1040   // AMDGPU-specific defaults for PIC.
1041   if (Triple.getArch() == llvm::Triple::amdgcn)
1042     PIC = true;
1043 
1044   // The last argument relating to either PIC or PIE wins, and no
1045   // other argument is used. If the last argument is any flavor of the
1046   // '-fno-...' arguments, both PIC and PIE are disabled. Any PIE
1047   // option implicitly enables PIC at the same level.
1048   Arg *LastPICArg = Args.getLastArg(options::OPT_fPIC, options::OPT_fno_PIC,
1049                                     options::OPT_fpic, options::OPT_fno_pic,
1050                                     options::OPT_fPIE, options::OPT_fno_PIE,
1051                                     options::OPT_fpie, options::OPT_fno_pie);
1052   if (Triple.isOSWindows() && LastPICArg &&
1053       LastPICArg ==
1054           Args.getLastArg(options::OPT_fPIC, options::OPT_fpic,
1055                           options::OPT_fPIE, options::OPT_fpie)) {
1056     ToolChain.getDriver().Diag(diag::err_drv_unsupported_opt_for_target)
1057         << LastPICArg->getSpelling() << Triple.str();
1058     if (Triple.getArch() == llvm::Triple::x86_64)
1059       return std::make_tuple(llvm::Reloc::PIC_, 2U, false);
1060     return std::make_tuple(llvm::Reloc::Static, 0U, false);
1061   }
1062 
1063   // Check whether the tool chain trumps the PIC-ness decision. If the PIC-ness
1064   // is forced, then neither PIC nor PIE flags will have no effect.
1065   if (!ToolChain.isPICDefaultForced()) {
1066     if (LastPICArg) {
1067       Option O = LastPICArg->getOption();
1068       if (O.matches(options::OPT_fPIC) || O.matches(options::OPT_fpic) ||
1069           O.matches(options::OPT_fPIE) || O.matches(options::OPT_fpie)) {
1070         PIE = O.matches(options::OPT_fPIE) || O.matches(options::OPT_fpie);
1071         PIC =
1072             PIE || O.matches(options::OPT_fPIC) || O.matches(options::OPT_fpic);
1073         IsPICLevelTwo =
1074             O.matches(options::OPT_fPIE) || O.matches(options::OPT_fPIC);
1075       } else {
1076         PIE = PIC = false;
1077         if (EffectiveTriple.isPS4CPU()) {
1078           Arg *ModelArg = Args.getLastArg(options::OPT_mcmodel_EQ);
1079           StringRef Model = ModelArg ? ModelArg->getValue() : "";
1080           if (Model != "kernel") {
1081             PIC = true;
1082             ToolChain.getDriver().Diag(diag::warn_drv_ps4_force_pic)
1083                 << LastPICArg->getSpelling();
1084           }
1085         }
1086       }
1087     }
1088   }
1089 
1090   // Introduce a Darwin and PS4-specific hack. If the default is PIC, but the
1091   // PIC level would've been set to level 1, force it back to level 2 PIC
1092   // instead.
1093   if (PIC && (Triple.isOSDarwin() || EffectiveTriple.isPS4CPU()))
1094     IsPICLevelTwo |= ToolChain.isPICDefault();
1095 
1096   // This kernel flags are a trump-card: they will disable PIC/PIE
1097   // generation, independent of the argument order.
1098   if (KernelOrKext &&
1099       ((!EffectiveTriple.isiOS() || EffectiveTriple.isOSVersionLT(6)) &&
1100        !EffectiveTriple.isWatchOS()))
1101     PIC = PIE = false;
1102 
1103   if (Arg *A = Args.getLastArg(options::OPT_mdynamic_no_pic)) {
1104     // This is a very special mode. It trumps the other modes, almost no one
1105     // uses it, and it isn't even valid on any OS but Darwin.
1106     if (!Triple.isOSDarwin())
1107       ToolChain.getDriver().Diag(diag::err_drv_unsupported_opt_for_target)
1108           << A->getSpelling() << Triple.str();
1109 
1110     // FIXME: Warn when this flag trumps some other PIC or PIE flag.
1111 
1112     // Only a forced PIC mode can cause the actual compile to have PIC defines
1113     // etc., no flags are sufficient. This behavior was selected to closely
1114     // match that of llvm-gcc and Apple GCC before that.
1115     PIC = ToolChain.isPICDefault() && ToolChain.isPICDefaultForced();
1116 
1117     return std::make_tuple(llvm::Reloc::DynamicNoPIC, PIC ? 2U : 0U, false);
1118   }
1119 
1120   bool EmbeddedPISupported;
1121   switch (Triple.getArch()) {
1122     case llvm::Triple::arm:
1123     case llvm::Triple::armeb:
1124     case llvm::Triple::thumb:
1125     case llvm::Triple::thumbeb:
1126       EmbeddedPISupported = true;
1127       break;
1128     default:
1129       EmbeddedPISupported = false;
1130       break;
1131   }
1132 
1133   bool ROPI = false, RWPI = false;
1134   Arg* LastROPIArg = Args.getLastArg(options::OPT_fropi, options::OPT_fno_ropi);
1135   if (LastROPIArg && LastROPIArg->getOption().matches(options::OPT_fropi)) {
1136     if (!EmbeddedPISupported)
1137       ToolChain.getDriver().Diag(diag::err_drv_unsupported_opt_for_target)
1138           << LastROPIArg->getSpelling() << Triple.str();
1139     ROPI = true;
1140   }
1141   Arg *LastRWPIArg = Args.getLastArg(options::OPT_frwpi, options::OPT_fno_rwpi);
1142   if (LastRWPIArg && LastRWPIArg->getOption().matches(options::OPT_frwpi)) {
1143     if (!EmbeddedPISupported)
1144       ToolChain.getDriver().Diag(diag::err_drv_unsupported_opt_for_target)
1145           << LastRWPIArg->getSpelling() << Triple.str();
1146     RWPI = true;
1147   }
1148 
1149   // ROPI and RWPI are not compatible with PIC or PIE.
1150   if ((ROPI || RWPI) && (PIC || PIE))
1151     ToolChain.getDriver().Diag(diag::err_drv_ropi_rwpi_incompatible_with_pic);
1152 
1153   if (Triple.isMIPS()) {
1154     StringRef CPUName;
1155     StringRef ABIName;
1156     mips::getMipsCPUAndABI(Args, Triple, CPUName, ABIName);
1157     // When targeting the N64 ABI, PIC is the default, except in the case
1158     // when the -mno-abicalls option is used. In that case we exit
1159     // at next check regardless of PIC being set below.
1160     if (ABIName == "n64")
1161       PIC = true;
1162     // When targettng MIPS with -mno-abicalls, it's always static.
1163     if(Args.hasArg(options::OPT_mno_abicalls))
1164       return std::make_tuple(llvm::Reloc::Static, 0U, false);
1165     // Unlike other architectures, MIPS, even with -fPIC/-mxgot/multigot,
1166     // does not use PIC level 2 for historical reasons.
1167     IsPICLevelTwo = false;
1168   }
1169 
1170   if (PIC)
1171     return std::make_tuple(llvm::Reloc::PIC_, IsPICLevelTwo ? 2U : 1U, PIE);
1172 
1173   llvm::Reloc::Model RelocM = llvm::Reloc::Static;
1174   if (ROPI && RWPI)
1175     RelocM = llvm::Reloc::ROPI_RWPI;
1176   else if (ROPI)
1177     RelocM = llvm::Reloc::ROPI;
1178   else if (RWPI)
1179     RelocM = llvm::Reloc::RWPI;
1180 
1181   return std::make_tuple(RelocM, 0U, false);
1182 }
1183 
1184 // `-falign-functions` indicates that the functions should be aligned to a
1185 // 16-byte boundary.
1186 //
1187 // `-falign-functions=1` is the same as `-fno-align-functions`.
1188 //
1189 // The scalar `n` in `-falign-functions=n` must be an integral value between
1190 // [0, 65536].  If the value is not a power-of-two, it will be rounded up to
1191 // the nearest power-of-two.
1192 //
1193 // If we return `0`, the frontend will default to the backend's preferred
1194 // alignment.
1195 //
1196 // NOTE: icc only allows values between [0, 4096].  icc uses `-falign-functions`
1197 // to mean `-falign-functions=16`.  GCC defaults to the backend's preferred
1198 // alignment.  For unaligned functions, we default to the backend's preferred
1199 // alignment.
1200 unsigned tools::ParseFunctionAlignment(const ToolChain &TC,
1201                                        const ArgList &Args) {
1202   const Arg *A = Args.getLastArg(options::OPT_falign_functions,
1203                                  options::OPT_falign_functions_EQ,
1204                                  options::OPT_fno_align_functions);
1205   if (!A || A->getOption().matches(options::OPT_fno_align_functions))
1206     return 0;
1207 
1208   if (A->getOption().matches(options::OPT_falign_functions))
1209     return 0;
1210 
1211   unsigned Value = 0;
1212   if (StringRef(A->getValue()).getAsInteger(10, Value) || Value > 65536)
1213     TC.getDriver().Diag(diag::err_drv_invalid_int_value)
1214         << A->getAsString(Args) << A->getValue();
1215   return Value ? llvm::Log2_32_Ceil(std::min(Value, 65536u)) : Value;
1216 }
1217 
1218 unsigned tools::ParseDebugDefaultVersion(const ToolChain &TC,
1219                                          const ArgList &Args) {
1220   const Arg *A = Args.getLastArg(options::OPT_fdebug_default_version);
1221 
1222   if (!A)
1223     return 0;
1224 
1225   unsigned Value = 0;
1226   if (StringRef(A->getValue()).getAsInteger(10, Value) || Value > 5 ||
1227       Value < 2)
1228     TC.getDriver().Diag(diag::err_drv_invalid_int_value)
1229         << A->getAsString(Args) << A->getValue();
1230   return Value;
1231 }
1232 
1233 void tools::AddAssemblerKPIC(const ToolChain &ToolChain, const ArgList &Args,
1234                              ArgStringList &CmdArgs) {
1235   llvm::Reloc::Model RelocationModel;
1236   unsigned PICLevel;
1237   bool IsPIE;
1238   std::tie(RelocationModel, PICLevel, IsPIE) = ParsePICArgs(ToolChain, Args);
1239 
1240   if (RelocationModel != llvm::Reloc::Static)
1241     CmdArgs.push_back("-KPIC");
1242 }
1243 
1244 /// Determine whether Objective-C automated reference counting is
1245 /// enabled.
1246 bool tools::isObjCAutoRefCount(const ArgList &Args) {
1247   return Args.hasFlag(options::OPT_fobjc_arc, options::OPT_fno_objc_arc, false);
1248 }
1249 
1250 enum class LibGccType { UnspecifiedLibGcc, StaticLibGcc, SharedLibGcc };
1251 
1252 static LibGccType getLibGccType(const Driver &D, const ArgList &Args) {
1253   if (Args.hasArg(options::OPT_static_libgcc) ||
1254       Args.hasArg(options::OPT_static) || Args.hasArg(options::OPT_static_pie))
1255     return LibGccType::StaticLibGcc;
1256   if (Args.hasArg(options::OPT_shared_libgcc) || D.CCCIsCXX())
1257     return LibGccType::SharedLibGcc;
1258   return LibGccType::UnspecifiedLibGcc;
1259 }
1260 
1261 // Gcc adds libgcc arguments in various ways:
1262 //
1263 // gcc <none>:     -lgcc --as-needed -lgcc_s --no-as-needed
1264 // g++ <none>:                       -lgcc_s               -lgcc
1265 // gcc shared:                       -lgcc_s               -lgcc
1266 // g++ shared:                       -lgcc_s               -lgcc
1267 // gcc static:     -lgcc             -lgcc_eh
1268 // g++ static:     -lgcc             -lgcc_eh
1269 // gcc static-pie: -lgcc             -lgcc_eh
1270 // g++ static-pie: -lgcc             -lgcc_eh
1271 //
1272 // Also, certain targets need additional adjustments.
1273 
1274 static void AddUnwindLibrary(const ToolChain &TC, const Driver &D,
1275                              ArgStringList &CmdArgs, const ArgList &Args) {
1276   ToolChain::UnwindLibType UNW = TC.GetUnwindLibType(Args);
1277   // Targets that don't use unwind libraries.
1278   if (TC.getTriple().isAndroid() || TC.getTriple().isOSIAMCU() ||
1279       TC.getTriple().isOSBinFormatWasm() ||
1280       UNW == ToolChain::UNW_None)
1281     return;
1282 
1283   LibGccType LGT = getLibGccType(D, Args);
1284   bool AsNeeded = LGT == LibGccType::UnspecifiedLibGcc &&
1285                   !TC.getTriple().isAndroid() && !TC.getTriple().isOSCygMing();
1286   if (AsNeeded)
1287     CmdArgs.push_back(getAsNeededOption(TC, true));
1288 
1289   switch (UNW) {
1290   case ToolChain::UNW_None:
1291     return;
1292   case ToolChain::UNW_Libgcc: {
1293     if (LGT == LibGccType::StaticLibGcc)
1294       CmdArgs.push_back("-lgcc_eh");
1295     else
1296       CmdArgs.push_back("-lgcc_s");
1297     break;
1298   }
1299   case ToolChain::UNW_CompilerRT:
1300     if (LGT == LibGccType::StaticLibGcc)
1301       CmdArgs.push_back("-l:libunwind.a");
1302     else if (TC.getTriple().isOSCygMing()) {
1303       if (LGT == LibGccType::SharedLibGcc)
1304         CmdArgs.push_back("-l:libunwind.dll.a");
1305       else
1306         // Let the linker choose between libunwind.dll.a and libunwind.a
1307         // depending on what's available, and depending on the -static flag
1308         CmdArgs.push_back("-lunwind");
1309     } else
1310       CmdArgs.push_back("-l:libunwind.so");
1311     break;
1312   }
1313 
1314   if (AsNeeded)
1315     CmdArgs.push_back(getAsNeededOption(TC, false));
1316 }
1317 
1318 static void AddLibgcc(const ToolChain &TC, const Driver &D,
1319                       ArgStringList &CmdArgs, const ArgList &Args) {
1320   LibGccType LGT = getLibGccType(D, Args);
1321   if (LGT != LibGccType::SharedLibGcc)
1322     CmdArgs.push_back("-lgcc");
1323   AddUnwindLibrary(TC, D, CmdArgs, Args);
1324   if (LGT == LibGccType::SharedLibGcc)
1325     CmdArgs.push_back("-lgcc");
1326 
1327   // According to Android ABI, we have to link with libdl if we are
1328   // linking with non-static libgcc.
1329   //
1330   // NOTE: This fixes a link error on Android MIPS as well.  The non-static
1331   // libgcc for MIPS relies on _Unwind_Find_FDE and dl_iterate_phdr from libdl.
1332   if (TC.getTriple().isAndroid() && LGT != LibGccType::StaticLibGcc)
1333     CmdArgs.push_back("-ldl");
1334 }
1335 
1336 void tools::AddRunTimeLibs(const ToolChain &TC, const Driver &D,
1337                            ArgStringList &CmdArgs, const ArgList &Args) {
1338   // Make use of compiler-rt if --rtlib option is used
1339   ToolChain::RuntimeLibType RLT = TC.GetRuntimeLibType(Args);
1340 
1341   switch (RLT) {
1342   case ToolChain::RLT_CompilerRT:
1343     CmdArgs.push_back(TC.getCompilerRTArgString(Args, "builtins"));
1344     AddUnwindLibrary(TC, D, CmdArgs, Args);
1345     break;
1346   case ToolChain::RLT_Libgcc:
1347     // Make sure libgcc is not used under MSVC environment by default
1348     if (TC.getTriple().isKnownWindowsMSVCEnvironment()) {
1349       // Issue error diagnostic if libgcc is explicitly specified
1350       // through command line as --rtlib option argument.
1351       if (Args.hasArg(options::OPT_rtlib_EQ)) {
1352         TC.getDriver().Diag(diag::err_drv_unsupported_rtlib_for_platform)
1353             << Args.getLastArg(options::OPT_rtlib_EQ)->getValue() << "MSVC";
1354       }
1355     } else
1356       AddLibgcc(TC, D, CmdArgs, Args);
1357     break;
1358   }
1359 }
1360 
1361 SmallString<128> tools::getStatsFileName(const llvm::opt::ArgList &Args,
1362                                          const InputInfo &Output,
1363                                          const InputInfo &Input,
1364                                          const Driver &D) {
1365   const Arg *A = Args.getLastArg(options::OPT_save_stats_EQ);
1366   if (!A)
1367     return {};
1368 
1369   StringRef SaveStats = A->getValue();
1370   SmallString<128> StatsFile;
1371   if (SaveStats == "obj" && Output.isFilename()) {
1372     StatsFile.assign(Output.getFilename());
1373     llvm::sys::path::remove_filename(StatsFile);
1374   } else if (SaveStats != "cwd") {
1375     D.Diag(diag::err_drv_invalid_value) << A->getAsString(Args) << SaveStats;
1376     return {};
1377   }
1378 
1379   StringRef BaseName = llvm::sys::path::filename(Input.getBaseInput());
1380   llvm::sys::path::append(StatsFile, BaseName);
1381   llvm::sys::path::replace_extension(StatsFile, "stats");
1382   return StatsFile;
1383 }
1384 
1385 void tools::addMultilibFlag(bool Enabled, const char *const Flag,
1386                             Multilib::flags_list &Flags) {
1387   Flags.push_back(std::string(Enabled ? "+" : "-") + Flag);
1388 }
1389 
1390 void tools::addX86AlignBranchArgs(const Driver &D, const ArgList &Args,
1391                                   ArgStringList &CmdArgs, bool IsLTO) {
1392   auto addArg = [&, IsLTO](const Twine &Arg) {
1393     if (IsLTO) {
1394       CmdArgs.push_back(Args.MakeArgString("-plugin-opt=" + Arg));
1395     } else {
1396       CmdArgs.push_back("-mllvm");
1397       CmdArgs.push_back(Args.MakeArgString(Arg));
1398     }
1399   };
1400 
1401   if (Args.hasArg(options::OPT_mbranches_within_32B_boundaries)) {
1402     addArg(Twine("-x86-branches-within-32B-boundaries"));
1403   }
1404   if (const Arg *A = Args.getLastArg(options::OPT_malign_branch_boundary_EQ)) {
1405     StringRef Value = A->getValue();
1406     unsigned Boundary;
1407     if (Value.getAsInteger(10, Boundary) || Boundary < 16 ||
1408         !llvm::isPowerOf2_64(Boundary)) {
1409       D.Diag(diag::err_drv_invalid_argument_to_option)
1410           << Value << A->getOption().getName();
1411     } else {
1412       addArg("-x86-align-branch-boundary=" + Twine(Boundary));
1413     }
1414   }
1415   if (const Arg *A = Args.getLastArg(options::OPT_malign_branch_EQ)) {
1416     std::string AlignBranch;
1417     for (StringRef T : A->getValues()) {
1418       if (T != "fused" && T != "jcc" && T != "jmp" && T != "call" &&
1419           T != "ret" && T != "indirect")
1420         D.Diag(diag::err_drv_invalid_malign_branch_EQ)
1421             << T << "fused, jcc, jmp, call, ret, indirect";
1422       if (!AlignBranch.empty())
1423         AlignBranch += '+';
1424       AlignBranch += T;
1425     }
1426     addArg("-x86-align-branch=" + Twine(AlignBranch));
1427   }
1428   if (const Arg *A = Args.getLastArg(options::OPT_mpad_max_prefix_size_EQ)) {
1429     StringRef Value = A->getValue();
1430     unsigned PrefixSize;
1431     if (Value.getAsInteger(10, PrefixSize)) {
1432       D.Diag(diag::err_drv_invalid_argument_to_option)
1433           << Value << A->getOption().getName();
1434     } else {
1435       addArg("-x86-pad-max-prefix-size=" + Twine(PrefixSize));
1436     }
1437   }
1438 }
1439