clang 23.0.0git
CommonArgs.cpp
Go to the documentation of this file.
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
10#include "Arch/AArch64.h"
11#include "Arch/ARM.h"
12#include "Arch/CSKY.h"
13#include "Arch/LoongArch.h"
14#include "Arch/M68k.h"
15#include "Arch/Mips.h"
16#include "Arch/PPC.h"
17#include "Arch/RISCV.h"
18#include "Arch/Sparc.h"
19#include "Arch/SystemZ.h"
20#include "Arch/VE.h"
21#include "Arch/X86.h"
22#include "HIPAMD.h"
23#include "Hexagon.h"
24#include "MSP430.h"
25#include "Solaris.h"
26#include "ToolChains/Cuda.h"
28#include "clang/Config/config.h"
29#include "clang/Driver/Action.h"
31#include "clang/Driver/Driver.h"
33#include "clang/Driver/Job.h"
36#include "clang/Driver/Util.h"
40#include "llvm/ADT/STLExtras.h"
41#include "llvm/ADT/SmallSet.h"
42#include "llvm/ADT/SmallString.h"
43#include "llvm/ADT/StringExtras.h"
44#include "llvm/ADT/StringSwitch.h"
45#include "llvm/ADT/Twine.h"
46#include "llvm/BinaryFormat/Magic.h"
47#include "llvm/Config/llvm-config.h"
48#include "llvm/Option/Arg.h"
49#include "llvm/Option/ArgList.h"
50#include "llvm/Option/Option.h"
51#include "llvm/Support/CodeGen.h"
52#include "llvm/Support/Compression.h"
53#include "llvm/Support/ErrorHandling.h"
54#include "llvm/Support/FileSystem.h"
55#include "llvm/Support/Path.h"
56#include "llvm/Support/Process.h"
57#include "llvm/Support/Program.h"
58#include "llvm/Support/Threading.h"
59#include "llvm/Support/VirtualFileSystem.h"
60#include "llvm/Support/YAMLParser.h"
61#include "llvm/TargetParser/AMDGPUTargetParser.h"
62#include "llvm/TargetParser/Host.h"
63#include "llvm/TargetParser/PPCTargetParser.h"
64#include <optional>
65
66using namespace clang::driver;
67using namespace clang::driver::tools;
68using namespace clang;
69using namespace llvm::opt;
70
71static bool useFramePointerForTargetByDefault(const llvm::opt::ArgList &Args,
72 const llvm::Triple &Triple) {
73 if (Args.hasArg(options::OPT_pg) && !Args.hasArg(options::OPT_mfentry))
74 return true;
75
76 if (Triple.isAndroid())
77 return true;
78
79 switch (Triple.getArch()) {
80 case llvm::Triple::xcore:
81 case llvm::Triple::wasm32:
82 case llvm::Triple::wasm64:
83 case llvm::Triple::msp430:
84 // XCore never wants frame pointers, regardless of OS.
85 // WebAssembly never wants frame pointers.
86 return false;
87 case llvm::Triple::ppc:
88 case llvm::Triple::ppcle:
89 case llvm::Triple::ppc64:
90 case llvm::Triple::ppc64le:
91 case llvm::Triple::riscv32:
92 case llvm::Triple::riscv64:
93 case llvm::Triple::riscv32be:
94 case llvm::Triple::riscv64be:
95 case llvm::Triple::sparc:
96 case llvm::Triple::sparcel:
97 case llvm::Triple::sparcv9:
98 case llvm::Triple::amdgpu:
99 case llvm::Triple::r600:
100 case llvm::Triple::csky:
101 case llvm::Triple::loongarch32:
102 case llvm::Triple::loongarch64:
103 case llvm::Triple::m68k:
104 case llvm::Triple::mips64:
105 case llvm::Triple::mips64el:
106 case llvm::Triple::mips:
107 case llvm::Triple::mipsel:
109 default:
110 break;
111 }
112
113 if (Triple.isOSFuchsia() || Triple.isOSNetBSD()) {
115 }
116
117 if (Triple.isOSLinux() || Triple.isOSHurd()) {
118 switch (Triple.getArch()) {
119 // Don't use a frame pointer on linux if optimizing for certain targets.
120 case llvm::Triple::arm:
121 case llvm::Triple::armeb:
122 case llvm::Triple::thumb:
123 case llvm::Triple::thumbeb:
124 case llvm::Triple::systemz:
125 case llvm::Triple::x86:
126 case llvm::Triple::x86_64:
128 default:
129 return true;
130 }
131 }
132
133 if (Triple.isOSWindows()) {
134 switch (Triple.getArch()) {
135 case llvm::Triple::x86:
137 case llvm::Triple::x86_64:
138 return Triple.isOSBinFormatMachO();
139 case llvm::Triple::arm:
140 case llvm::Triple::thumb:
141 // Windows on ARM builds with FPO disabled to aid fast stack walking
142 return true;
143 default:
144 // All other supported Windows ISAs use xdata unwind information, so frame
145 // pointers are not generally useful.
146 return false;
147 }
148 }
149
150 if (arm::isARMEABIBareMetal(Triple))
151 return false;
152
153 return true;
154}
155
156static bool useLeafFramePointerForTargetByDefault(const llvm::Triple &Triple) {
157 if (Triple.isAArch64() || Triple.isPS() || Triple.isVE() ||
158 (Triple.isAndroid() && !Triple.isARM()))
159 return false;
160
161 if ((Triple.isARM() || Triple.isThumb()) && Triple.isOSBinFormatMachO())
162 return false;
163
164 return true;
165}
166
167static bool mustUseNonLeafFramePointerForTarget(const llvm::Triple &Triple) {
168 switch (Triple.getArch()) {
169 default:
170 return false;
171 case llvm::Triple::arm:
172 case llvm::Triple::thumb:
173 // ARM Darwin targets require a frame pointer to be always present to aid
174 // offline debugging via backtraces.
175 return Triple.isOSDarwin();
176 }
177}
178
179// True if a target-specific option requires the frame chain to be preserved,
180// even if new frame records are not created.
181static bool mustMaintainValidFrameChain(const llvm::opt::ArgList &Args,
182 const llvm::Triple &Triple) {
183 switch (Triple.getArch()) {
184 default:
185 return false;
186 case llvm::Triple::arm:
187 case llvm::Triple::armeb:
188 case llvm::Triple::thumb:
189 case llvm::Triple::thumbeb:
190 // For 32-bit Arm, the -mframe-chain=aapcs and -mframe-chain=aapcs+leaf
191 // options require the frame pointer register to be reserved (or point to a
192 // new AAPCS-compilant frame record), even with -fno-omit-frame-pointer.
193 if (Arg *A = Args.getLastArg(options::OPT_mframe_chain)) {
194 StringRef V = A->getValue();
195 return V != "none";
196 }
197 return false;
198
199 case llvm::Triple::aarch64:
200 // Arm64 Windows requires that the frame chain is valid, as there is no
201 // way to indicate during a stack walk that a frame has used the frame
202 // pointer as a general purpose register.
203 return Triple.isOSWindows();
204 }
205}
206
207// True if a target-specific option causes -fno-omit-frame-pointer to also
208// cause frame records to be created in leaf functions.
209static bool framePointerImpliesLeafFramePointer(const llvm::opt::ArgList &Args,
210 const llvm::Triple &Triple) {
211 if (Triple.isARM() || Triple.isThumb()) {
212 // For 32-bit Arm, the -mframe-chain=aapcs+leaf option causes the
213 // -fno-omit-frame-pointer optiion to imply -mno-omit-leaf-frame-pointer,
214 // but does not by itself imply either option.
215 if (Arg *A = Args.getLastArg(options::OPT_mframe_chain)) {
216 StringRef V = A->getValue();
217 return V == "aapcs+leaf";
218 }
219 return false;
220 }
221 return false;
222}
223
225getFramePointerKind(const llvm::opt::ArgList &Args,
226 const llvm::Triple &Triple) {
227 // There are four things to consider here:
228 // * Should a frame record be created for non-leaf functions?
229 // * Should a frame record be created for leaf functions?
230 // * Is the frame pointer register reserved in non-leaf functions?
231 // i.e. must it always point to either a new, valid frame record or be
232 // un-modified?
233 // * Is the frame pointer register reserved in leaf functions?
234 //
235 // Not all combinations of these are valid:
236 // * It's not useful to have leaf frame records without non-leaf ones.
237 // * It's not useful to have frame records without reserving the frame
238 // pointer.
239 //
240 // | Frame Setup | Reg Reserved |
241 // |-----------------|-----------------|
242 // | Non-leaf | Leaf | Non-Leaf | Leaf |
243 // |----------|------|----------|------|
244 // | N | N | N | N | FramePointerKind::None
245 // | N | N | N | Y | Invalid
246 // | N | N | Y | N | Invalid
247 // | N | N | Y | Y | FramePointerKind::Reserved
248 // | N | Y | N | N | Invalid
249 // | N | Y | N | Y | Invalid
250 // | N | Y | Y | N | Invalid
251 // | N | Y | Y | Y | Invalid
252 // | Y | N | N | N | Invalid
253 // | Y | N | N | Y | Invalid
254 // | Y | N | Y | N | FramePointerKind::NonLeafNoReserve
255 // | Y | N | Y | Y | FramePointerKind::NonLeaf
256 // | Y | Y | N | N | Invalid
257 // | Y | Y | N | Y | Invalid
258 // | Y | Y | Y | N | Invalid
259 // | Y | Y | Y | Y | FramePointerKind::All
260 //
261 // The FramePointerKind::Reserved case is currently only reachable for Arm,
262 // which has the -mframe-chain= option which can (in combination with
263 // -fno-omit-frame-pointer) specify that the frame chain must be valid,
264 // without requiring new frame records to be created.
265
266 bool DefaultFP = useFramePointerForTargetByDefault(Args, Triple);
267 bool EnableFP = mustUseNonLeafFramePointerForTarget(Triple) ||
268 Args.hasFlag(options::OPT_fno_omit_frame_pointer,
269 options::OPT_fomit_frame_pointer, DefaultFP);
270
271 bool DefaultLeafFP =
273 (EnableFP && framePointerImpliesLeafFramePointer(Args, Triple));
274 bool EnableLeafFP =
275 Args.hasFlag(options::OPT_mno_omit_leaf_frame_pointer,
276 options::OPT_momit_leaf_frame_pointer, DefaultLeafFP);
277
278 bool FPRegReserved = Args.hasFlag(options::OPT_mreserve_frame_pointer_reg,
279 options::OPT_mno_reserve_frame_pointer_reg,
280 mustMaintainValidFrameChain(Args, Triple));
281
282 if (EnableFP) {
283 if (EnableLeafFP)
285
286 if (FPRegReserved)
288
290 }
291 if (FPRegReserved)
294}
295
296static void renderRpassOptions(const ArgList &Args, ArgStringList &CmdArgs,
297 const StringRef PluginOptPrefix) {
298 if (const Arg *A = Args.getLastArg(options::OPT_Rpass_EQ))
299 CmdArgs.push_back(Args.MakeArgString(Twine(PluginOptPrefix) +
300 "-pass-remarks=" + A->getValue()));
301
302 if (const Arg *A = Args.getLastArg(options::OPT_Rpass_missed_EQ))
303 CmdArgs.push_back(Args.MakeArgString(
304 Twine(PluginOptPrefix) + "-pass-remarks-missed=" + A->getValue()));
305
306 if (const Arg *A = Args.getLastArg(options::OPT_Rpass_analysis_EQ))
307 CmdArgs.push_back(Args.MakeArgString(
308 Twine(PluginOptPrefix) + "-pass-remarks-analysis=" + A->getValue()));
309}
310
311static void renderRemarksOptions(const ArgList &Args, ArgStringList &CmdArgs,
312 const llvm::Triple &Triple,
313 const InputInfo &Input,
314 const InputInfo &Output,
315 const StringRef PluginOptPrefix) {
316 StringRef Format = "yaml";
317 if (const Arg *A = Args.getLastArg(options::OPT_fsave_optimization_record_EQ))
318 Format = A->getValue();
319
321 if (const Arg *A =
322 Args.getLastArg(options::OPT_foptimization_record_file_EQ)) {
323 F = A->getValue();
324 F += ".";
325 } else if (const Arg *A = Args.getLastArg(options::OPT_dumpdir)) {
326 F = A->getValue();
327 } else if (Output.isFilename()) {
328 F = Output.getFilename();
329 F += ".";
330 }
331
332 assert(!F.empty() && "Cannot determine remarks output name.");
333 // Append "opt.ld.<format>" to the end of the file name.
334 CmdArgs.push_back(Args.MakeArgString(Twine(PluginOptPrefix) +
335 "opt-remarks-filename=" + F + "opt.ld." +
336 Format));
337
338 if (const Arg *A =
339 Args.getLastArg(options::OPT_foptimization_record_passes_EQ))
340 CmdArgs.push_back(Args.MakeArgString(
341 Twine(PluginOptPrefix) + "opt-remarks-passes=" + A->getValue()));
342
343 CmdArgs.push_back(Args.MakeArgString(Twine(PluginOptPrefix) +
344 "opt-remarks-format=" + Format.data()));
345}
346
347static void renderRemarksHotnessOptions(const ArgList &Args,
348 ArgStringList &CmdArgs,
349 const StringRef PluginOptPrefix) {
350 if (Args.hasFlag(options::OPT_fdiagnostics_show_hotness,
351 options::OPT_fno_diagnostics_show_hotness, false))
352 CmdArgs.push_back(Args.MakeArgString(Twine(PluginOptPrefix) +
353 "opt-remarks-with-hotness"));
354
355 if (const Arg *A =
356 Args.getLastArg(options::OPT_fdiagnostics_hotness_threshold_EQ))
357 CmdArgs.push_back(
358 Args.MakeArgString(Twine(PluginOptPrefix) +
359 "opt-remarks-hotness-threshold=" + A->getValue()));
360}
361
362static bool shouldIgnoreUnsupportedTargetFeature(const Arg &TargetFeatureArg,
363 llvm::Triple T,
364 StringRef Processor) {
365 // Warn no-cumode for AMDGCN processors not supporing WGP mode.
366 if (!T.isAMDGPU())
367 return false;
368 auto GPUKind = T.isAMDGCN() ? llvm::AMDGPU::parseArchAMDGCN(Processor)
369 : llvm::AMDGPU::parseArchR600(Processor);
370 auto GPUFeatures = T.isAMDGCN() ? llvm::AMDGPU::getArchAttrAMDGCN(GPUKind)
371 : llvm::AMDGPU::getArchAttrR600(GPUKind);
372 if (GPUFeatures & llvm::AMDGPU::FEATURE_WGP)
373 return false;
374 return TargetFeatureArg.getOption().matches(options::OPT_mno_cumode);
375}
376
377void tools::addPathIfExists(const Driver &D, const Twine &Path,
378 ToolChain::path_list &Paths) {
379 if (D.getVFS().exists(Path))
380 Paths.push_back(Path.str());
381}
382
384 const llvm::Triple &Triple,
385 const ArgList &Args,
386 std::vector<StringRef> &Features,
387 OptSpecifier Group) {
388 std::set<StringRef> Warned;
389 for (const Arg *A : Args.filtered(Group)) {
390 StringRef Name = A->getOption().getName();
391 A->claim();
392
393 // Skip over "-m".
394 assert(Name.starts_with("m") && "Invalid feature name.");
395 Name = Name.substr(1);
396
397 auto Proc = getCPUName(D, Args, Triple);
398 if (shouldIgnoreUnsupportedTargetFeature(*A, Triple, Proc)) {
399 if (Warned.count(Name) == 0) {
400 D.getDiags().Report(
401 clang::diag::warn_drv_unsupported_option_for_processor)
402 << A->getAsString(Args) << Proc;
403 Warned.insert(Name);
404 }
405 continue;
406 }
407
408 bool IsNegative = Name.consume_front("no-");
409
410 Features.push_back(Args.MakeArgString((IsNegative ? "-" : "+") + Name));
411 }
412}
413
416 // Only add a feature if it hasn't been seen before starting from the end.
417 SmallVector<StringRef> UnifiedFeatures;
418 llvm::DenseSet<StringRef> UsedFeatures;
419 for (StringRef Feature : llvm::reverse(Features)) {
420 if (UsedFeatures.insert(Feature.drop_front()).second)
421 UnifiedFeatures.insert(UnifiedFeatures.begin(), Feature);
422 }
423
424 return UnifiedFeatures;
425}
426
427void tools::addDirectoryList(const ArgList &Args, ArgStringList &CmdArgs,
428 const char *ArgName, const char *EnvVar) {
429 const char *DirList = ::getenv(EnvVar);
430 bool CombinedArg = false;
431
432 if (!DirList)
433 return; // Nothing to do.
434
435 StringRef Name(ArgName);
436 if (Name == "-I" || Name == "-L" || Name.empty())
437 CombinedArg = true;
438
439 StringRef Dirs(DirList);
440 if (Dirs.empty()) // Empty string should not add '.'.
441 return;
442
443 StringRef::size_type Delim;
444 while ((Delim = Dirs.find(llvm::sys::EnvPathSeparator)) != StringRef::npos) {
445 if (Delim == 0) { // Leading colon.
446 if (CombinedArg) {
447 CmdArgs.push_back(Args.MakeArgString(std::string(ArgName) + "."));
448 } else {
449 CmdArgs.push_back(ArgName);
450 CmdArgs.push_back(".");
451 }
452 } else {
453 if (CombinedArg) {
454 CmdArgs.push_back(
455 Args.MakeArgString(std::string(ArgName) + Dirs.substr(0, Delim)));
456 } else {
457 CmdArgs.push_back(ArgName);
458 CmdArgs.push_back(Args.MakeArgString(Dirs.substr(0, Delim)));
459 }
460 }
461 Dirs = Dirs.substr(Delim + 1);
462 }
463
464 if (Dirs.empty()) { // Trailing colon.
465 if (CombinedArg) {
466 CmdArgs.push_back(Args.MakeArgString(std::string(ArgName) + "."));
467 } else {
468 CmdArgs.push_back(ArgName);
469 CmdArgs.push_back(".");
470 }
471 } else { // Add the last path.
472 if (CombinedArg) {
473 CmdArgs.push_back(Args.MakeArgString(std::string(ArgName) + Dirs));
474 } else {
475 CmdArgs.push_back(ArgName);
476 CmdArgs.push_back(Args.MakeArgString(Dirs));
477 }
478 }
479}
480
481void tools::AddLinkerInputs(const ToolChain &TC, const InputInfoList &Inputs,
482 const ArgList &Args, ArgStringList &CmdArgs,
483 const JobAction &JA) {
484 const Driver &D = TC.getDriver();
485
486 // Add extra linker input arguments which are not treated as inputs
487 // (constructed via -Xarch_).
488 Args.AddAllArgValues(CmdArgs, options::OPT_Zlinker_input);
489
490 // LIBRARY_PATH are included before user inputs and only supported on native
491 // toolchains.
492 if (!TC.isCrossCompiling())
493 addDirectoryList(Args, CmdArgs, "-L", "LIBRARY_PATH");
494
495 for (const auto &II : Inputs) {
496 // If the current tool chain refers to an OpenMP offloading host, we
497 // should ignore inputs that refer to OpenMP offloading devices -
498 // they will be embedded according to a proper linker script.
499 if (auto *IA = II.getAction())
501 IA->isDeviceOffloading(Action::OFK_OpenMP)))
502 continue;
503
504 if (!TC.HasNativeLLVMSupport() && types::isLLVMIR(II.getType()))
505 // Don't try to pass LLVM inputs unless we have native support.
506 D.Diag(diag::err_drv_no_linker_llvm_support) << TC.getTripleString();
507
508 // Add filenames immediately.
509 if (II.isFilename()) {
510 CmdArgs.push_back(II.getFilename());
511 continue;
512 }
513
514 // In some error cases, the input could be Nothing; skip those.
515 if (II.isNothing())
516 continue;
517
518 // Otherwise, this is a linker input argument.
519 const Arg &A = II.getInputArg();
520
521 // Handle reserved library options.
522 if (A.getOption().matches(options::OPT_Z_reserved_lib_stdcxx))
523 TC.AddCXXStdlibLibArgs(Args, CmdArgs);
524 else if (A.getOption().matches(options::OPT_Z_reserved_lib_cckext))
525 TC.AddCCKextLibArgs(Args, CmdArgs);
526 // Do not pass OPT_rpath to linker in AIX
527 else if (A.getOption().matches(options::OPT_rpath) &&
528 TC.getTriple().isOSAIX())
529 continue;
530 else
531 A.renderAsInput(Args, CmdArgs);
532 }
533 if (const Arg *A = Args.getLastArg(options::OPT_fveclib)) {
534 const llvm::Triple &Triple = TC.getTriple();
535 StringRef V = A->getValue();
536 if (V == "ArmPL" && (Triple.isOSLinux() || Triple.isOSDarwin())) {
537 // To support -fveclib=ArmPL we need to link against libamath. Some of the
538 // libamath functions depend on libm, at the same time, libamath exports
539 // its own implementation of some of the libm functions. These are faster
540 // and potentially less accurate implementations, hence we need to be
541 // careful what is being linked in. Since here we are interested only in
542 // the subset of libamath functions that is covered by the veclib
543 // mappings, we need to prioritize libm functions by putting -lm before
544 // -lamath (and then -lm again, to fulfill libamath requirements).
545 //
546 // Therefore we need to do the following:
547 //
548 // 1. On Linux, link only when actually needed.
549 //
550 // 2. Prefer libm functions over libamath (when no -nostdlib in use).
551 //
552 // 3. Link against libm to resolve libamath dependencies.
553 //
554 if (Triple.isOSLinux()) {
555 CmdArgs.push_back(Args.MakeArgString("--push-state"));
556 CmdArgs.push_back(Args.MakeArgString("--as-needed"));
557 }
558 if (!Args.hasArg(options::OPT_nostdlib))
559 CmdArgs.push_back(Args.MakeArgString("-lm"));
560 CmdArgs.push_back(Args.MakeArgString("-lamath"));
561 if (!Args.hasArg(options::OPT_nostdlib))
562 CmdArgs.push_back(Args.MakeArgString("-lm"));
563 if (Triple.isOSLinux())
564 CmdArgs.push_back(Args.MakeArgString("--pop-state"));
565 addArchSpecificRPath(TC, Args, CmdArgs);
566 }
567 }
568}
569
570const char *tools::getLDMOption(const llvm::Triple &T, const ArgList &Args) {
571 switch (T.getArch()) {
572 case llvm::Triple::x86:
573 if (T.isOSIAMCU())
574 return "elf_iamcu";
575 return "elf_i386";
576 case llvm::Triple::aarch64:
577 if (T.isOSManagarm())
578 return "aarch64managarm";
579 else if (aarch64::isAArch64BareMetal(T))
580 return "aarch64elf";
581 return "aarch64linux";
582 case llvm::Triple::aarch64_be:
584 return "aarch64elfb";
585 return "aarch64linuxb";
586 case llvm::Triple::arm:
587 case llvm::Triple::thumb:
588 case llvm::Triple::armeb:
589 case llvm::Triple::thumbeb: {
590 bool IsBigEndian = tools::arm::isARMBigEndian(T, Args);
592 return IsBigEndian ? "armelfb" : "armelf";
593 return IsBigEndian ? "armelfb_linux_eabi" : "armelf_linux_eabi";
594 }
595 case llvm::Triple::m68k:
596 return "m68kelf";
597 case llvm::Triple::ppc:
598 if (T.isOSLinux())
599 return "elf32ppclinux";
600 return "elf32ppc";
601 case llvm::Triple::ppcle:
602 if (T.isOSLinux())
603 return "elf32lppclinux";
604 return "elf32lppc";
605 case llvm::Triple::ppc64:
606 return "elf64ppc";
607 case llvm::Triple::ppc64le:
608 return "elf64lppc";
609 case llvm::Triple::riscv32:
610 return "elf32lriscv";
611 case llvm::Triple::riscv64:
612 return "elf64lriscv";
613 case llvm::Triple::riscv32be:
614 return "elf32briscv";
615 case llvm::Triple::riscv64be:
616 return "elf64briscv";
617 case llvm::Triple::sparc:
618 case llvm::Triple::sparcel:
619 return "elf32_sparc";
620 case llvm::Triple::sparcv9:
621 return "elf64_sparc";
622 case llvm::Triple::loongarch32:
623 return "elf32loongarch";
624 case llvm::Triple::loongarch64:
625 return "elf64loongarch";
626 case llvm::Triple::mips:
627 return "elf32btsmip";
628 case llvm::Triple::mipsel:
629 return "elf32ltsmip";
630 case llvm::Triple::mips64:
631 if (tools::mips::hasMipsAbiArg(Args, "n32") || T.isABIN32())
632 return "elf32btsmipn32";
633 return "elf64btsmip";
634 case llvm::Triple::mips64el:
635 if (tools::mips::hasMipsAbiArg(Args, "n32") || T.isABIN32())
636 return "elf32ltsmipn32";
637 return "elf64ltsmip";
638 case llvm::Triple::systemz:
639 return "elf64_s390";
640 case llvm::Triple::x86_64:
641 if (T.isX32())
642 return "elf32_x86_64";
643 return "elf_x86_64";
644 case llvm::Triple::ve:
645 return "elf64ve";
646 case llvm::Triple::csky:
647 return "cskyelf_linux";
648 default:
649 return nullptr;
650 }
651}
652
654 const ToolChain &TC, const llvm::opt::ArgList &Args,
655 llvm::opt::ArgStringList &CmdArgs) {
656 // GNU ld supports --compress-debug-sections=none|zlib|zlib-gnu|zlib-gabi
657 // whereas zlib is an alias to zlib-gabi and zlib-gnu is obsoleted. Therefore
658 // -gz=none|zlib are translated to --compress-debug-sections=none|zlib. -gz
659 // is not translated since ld --compress-debug-sections option requires an
660 // argument.
661 if (const Arg *A = Args.getLastArg(options::OPT_gz_EQ)) {
662 StringRef V = A->getValue();
663 if (V == "none" || V == "zlib" || V == "zstd")
664 CmdArgs.push_back(Args.MakeArgString("--compress-debug-sections=" + V));
665 else
666 TC.getDriver().Diag(diag::err_drv_unsupported_option_argument)
667 << A->getSpelling() << V;
668 }
669}
670
671void tools::AddTargetFeature(const ArgList &Args,
672 std::vector<StringRef> &Features,
673 OptSpecifier OnOpt, OptSpecifier OffOpt,
674 StringRef FeatureName) {
675 if (Arg *A = Args.getLastArg(OnOpt, OffOpt)) {
676 if (A->getOption().matches(OnOpt))
677 Features.push_back(Args.MakeArgString("+" + FeatureName));
678 else
679 Features.push_back(Args.MakeArgString("-" + FeatureName));
680 }
681}
682
683/// Get the (LLVM) name of the AMDGPU gpu we are targeting.
684static std::string getAMDGPUTargetGPU(const llvm::Triple &T,
685 const ArgList &Args) {
686 if (Arg *A = Args.getLastArg(options::OPT_mcpu_EQ)) {
687 auto GPUName = getProcessorFromTargetID(T, A->getValue());
688 return llvm::StringSwitch<std::string>(GPUName)
689 .Cases({"rv630", "rv635"}, "r600")
690 .Cases({"rv610", "rv620", "rs780"}, "rs880")
691 .Case("rv740", "rv770")
692 .Case("palm", "cedar")
693 .Cases({"sumo", "sumo2"}, "sumo")
694 .Case("hemlock", "cypress")
695 .Case("aruba", "cayman")
696 .Default(GPUName.str());
697 }
698 return "";
699}
700
701static std::string getLanaiTargetCPU(const ArgList &Args) {
702 if (Arg *A = Args.getLastArg(options::OPT_mcpu_EQ)) {
703 return A->getValue();
704 }
705 return "";
706}
707
708/// Get the (LLVM) name of the WebAssembly cpu we are targeting.
709static StringRef getWebAssemblyTargetCPU(const ArgList &Args) {
710 // If we have -mcpu=, use that.
711 if (Arg *A = Args.getLastArg(options::OPT_mcpu_EQ)) {
712 StringRef CPU = A->getValue();
713
714#ifdef __wasm__
715 // Handle "native" by examining the host. "native" isn't meaningful when
716 // cross compiling, so only support this when the host is also WebAssembly.
717 if (CPU == "native")
718 return llvm::sys::getHostCPUName();
719#endif
720
721 return CPU;
722 }
723
724 return "generic";
725}
726
727std::string tools::getCPUName(const Driver &D, const ArgList &Args,
728 const llvm::Triple &T, bool FromAs) {
729 Arg *A;
730
731 switch (T.getArch()) {
732 default:
733 return "";
734
735 case llvm::Triple::aarch64:
736 case llvm::Triple::aarch64_32:
737 case llvm::Triple::aarch64_be:
738 return aarch64::getAArch64TargetCPU(Args, T, A);
739
740 case llvm::Triple::arm:
741 case llvm::Triple::armeb:
742 case llvm::Triple::thumb:
743 case llvm::Triple::thumbeb: {
744 StringRef MArch, MCPU;
745 arm::getARMArchCPUFromArgs(Args, MArch, MCPU, FromAs);
746 return arm::getARMTargetCPU(MCPU, MArch, T);
747 }
748
749 case llvm::Triple::avr:
750 if (const Arg *A = Args.getLastArg(options::OPT_mmcu_EQ))
751 return A->getValue();
752 return "";
753
754 case llvm::Triple::m68k:
755 return m68k::getM68kTargetCPU(Args);
756
757 case llvm::Triple::mips:
758 case llvm::Triple::mipsel:
759 case llvm::Triple::mips64:
760 case llvm::Triple::mips64el: {
761 StringRef CPUName;
762 StringRef ABIName;
763 mips::getMipsCPUAndABI(Args, T, CPUName, ABIName);
764 return std::string(CPUName);
765 }
766
767 case llvm::Triple::nvptx:
768 case llvm::Triple::nvptx64:
769 if (const Arg *A = Args.getLastArg(options::OPT_march_EQ))
770 return A->getValue();
771 return "";
772
773 case llvm::Triple::ppc:
774 case llvm::Triple::ppcle:
775 case llvm::Triple::ppc64:
776 case llvm::Triple::ppc64le:
777 if (Arg *A = Args.getLastArg(options::OPT_mcpu_EQ))
778 return std::string(
779 llvm::PPC::getNormalizedPPCTargetCPU(T, A->getValue()));
780 return std::string(llvm::PPC::getNormalizedPPCTargetCPU(T));
781
782 case llvm::Triple::csky:
783 if (const Arg *A = Args.getLastArg(options::OPT_mcpu_EQ))
784 return A->getValue();
785 else if (const Arg *A = Args.getLastArg(options::OPT_march_EQ))
786 return A->getValue();
787 else
788 return "ck810";
789 case llvm::Triple::riscv32:
790 case llvm::Triple::riscv64:
791 case llvm::Triple::riscv32be:
792 case llvm::Triple::riscv64be:
793 return riscv::getRISCVTargetCPU(Args, T);
794
795 case llvm::Triple::bpfel:
796 case llvm::Triple::bpfeb:
797 if (const Arg *A = Args.getLastArg(options::OPT_mcpu_EQ))
798 return A->getValue();
799 return "";
800
801 case llvm::Triple::sparc:
802 case llvm::Triple::sparcel:
803 case llvm::Triple::sparcv9:
804 return sparc::getSparcTargetCPU(D, Args, T);
805
806 case llvm::Triple::x86:
807 case llvm::Triple::x86_64:
808 return x86::getX86TargetCPU(D, Args, T);
809
810 case llvm::Triple::hexagon:
811 return "hexagon" +
813
814 case llvm::Triple::lanai:
815 return getLanaiTargetCPU(Args);
816
817 case llvm::Triple::systemz:
818 return systemz::getSystemZTargetCPU(Args, T);
819
820 case llvm::Triple::amdgpu:
821 case llvm::Triple::r600:
822 return getAMDGPUTargetGPU(T, Args);
823
824 case llvm::Triple::wasm32:
825 case llvm::Triple::wasm64:
826 return std::string(getWebAssemblyTargetCPU(Args));
827
828 case llvm::Triple::loongarch32:
829 case llvm::Triple::loongarch64:
830 return loongarch::getLoongArchTargetCPU(Args, T);
831
832 case llvm::Triple::xtensa:
833 if (const Arg *A = Args.getLastArg(options::OPT_mcpu_EQ))
834 return A->getValue();
835 return "";
836 }
837}
838
840 const llvm::Triple &Triple,
841 const ArgList &Args,
842 std::vector<StringRef> &Features) {
843 handleTargetFeaturesGroup(D, Triple, Args, Features,
844 options::OPT_m_wasm_Features_Group);
845}
846
847void tools::getTargetFeatures(const Driver &D, const llvm::Triple &Triple,
848 const ArgList &Args, ArgStringList &CmdArgs,
849 bool ForAS, bool IsAux) {
850 std::vector<StringRef> Features;
851 switch (Triple.getArch()) {
852 default:
853 break;
854 case llvm::Triple::mips:
855 case llvm::Triple::mipsel:
856 case llvm::Triple::mips64:
857 case llvm::Triple::mips64el:
858 mips::getMIPSTargetFeatures(D, Triple, Args, Features);
859 break;
860 case llvm::Triple::arm:
861 case llvm::Triple::armeb:
862 case llvm::Triple::thumb:
863 case llvm::Triple::thumbeb:
864 arm::getARMTargetFeatures(D, Triple, Args, Features, ForAS);
865 break;
866 case llvm::Triple::ppc:
867 case llvm::Triple::ppcle:
868 case llvm::Triple::ppc64:
869 case llvm::Triple::ppc64le:
870 ppc::getPPCTargetFeatures(D, Triple, Args, Features);
871 break;
872 case llvm::Triple::riscv32:
873 case llvm::Triple::riscv64:
874 case llvm::Triple::riscv32be:
875 case llvm::Triple::riscv64be:
876 riscv::getRISCVTargetFeatures(D, Triple, Args, Features);
877 break;
878 case llvm::Triple::systemz:
879 systemz::getSystemZTargetFeatures(D, Args, Features);
880 break;
881 case llvm::Triple::aarch64:
882 case llvm::Triple::aarch64_32:
883 case llvm::Triple::aarch64_be:
884 aarch64::getAArch64TargetFeatures(D, Triple, Args, Features, ForAS);
885 break;
886 case llvm::Triple::x86:
887 case llvm::Triple::x86_64:
888 x86::getX86TargetFeatures(D, Triple, Args, Features);
889 break;
890 case llvm::Triple::hexagon:
891 hexagon::getHexagonTargetFeatures(D, Triple, Args, Features);
892 break;
893 case llvm::Triple::wasm32:
894 case llvm::Triple::wasm64:
895 getWebAssemblyTargetFeatures(D, Triple, Args, Features);
896 break;
897 case llvm::Triple::sparc:
898 case llvm::Triple::sparcel:
899 case llvm::Triple::sparcv9:
900 sparc::getSparcTargetFeatures(D, Triple, Args, Features);
901 break;
902 case llvm::Triple::amdgpu:
903 case llvm::Triple::r600:
904 amdgpu::getAMDGPUTargetFeatures(D, Triple, Args, Features);
905 break;
906 case llvm::Triple::nvptx:
907 case llvm::Triple::nvptx64:
908 NVPTX::getNVPTXTargetFeatures(D, Triple, Args, Features);
909 break;
910 case llvm::Triple::m68k:
911 m68k::getM68kTargetFeatures(D, Triple, Args, Features);
912 break;
913 case llvm::Triple::msp430:
914 msp430::getMSP430TargetFeatures(D, Args, Features);
915 break;
916 case llvm::Triple::ve:
917 ve::getVETargetFeatures(D, Args, Features);
918 break;
919 case llvm::Triple::csky:
920 csky::getCSKYTargetFeatures(D, Triple, Args, CmdArgs, Features);
921 break;
922 case llvm::Triple::loongarch32:
923 case llvm::Triple::loongarch64:
924 loongarch::getLoongArchTargetFeatures(D, Triple, Args, Features);
925 break;
926 }
927
928 for (auto Feature : unifyTargetFeatures(Features)) {
929 CmdArgs.push_back(IsAux ? "-aux-target-feature" : "-target-feature");
930 CmdArgs.push_back(Feature.data());
931 }
932}
933
934llvm::StringRef tools::getLTOParallelism(const ArgList &Args, const Driver &D) {
935 Arg *LtoJobsArg = Args.getLastArg(options::OPT_flto_jobs_EQ);
936 if (!LtoJobsArg)
937 return {};
938 if (!llvm::get_threadpool_strategy(LtoJobsArg->getValue()))
939 D.Diag(diag::err_drv_invalid_int_value)
940 << LtoJobsArg->getAsString(Args) << LtoJobsArg->getValue();
941 return LtoJobsArg->getValue();
942}
943
944// PS4/PS5 uses -ffunction-sections and -fdata-sections by default.
945bool tools::isUseSeparateSections(const llvm::Triple &Triple) {
946 return Triple.isPS();
947}
948
949void tools::addSeparateSectionFlags(const llvm::Triple &Triple,
950 const ArgList &Args,
951 ArgStringList &CmdArgs) {
952 bool UseSeparateSections = isUseSeparateSections(Triple);
953 if (Args.hasFlag(options::OPT_ffunction_sections,
954 options::OPT_fno_function_sections, UseSeparateSections))
955 CmdArgs.push_back("-ffunction-sections");
956
957 bool HasDefaultDataSections = Triple.isOSBinFormatXCOFF();
958 if (Args.hasFlag(options::OPT_fdata_sections, options::OPT_fno_data_sections,
959 UseSeparateSections || HasDefaultDataSections))
960 CmdArgs.push_back("-fdata-sections");
961}
962
964 const llvm::opt::ArgList &Args) {
965 const llvm::Triple &Triple = TC.getEffectiveTriple();
966 Arg *A = Args.getLastArg(options::OPT_mtls_dialect_EQ);
967 if (!A)
968 return Triple.hasDefaultTLSDESC();
969 StringRef V = A->getValue();
970 bool SupportedArgument = false, EnableTLSDESC = false;
971 bool Unsupported = !Triple.isOSBinFormatELF();
972 if (Triple.isLoongArch() || Triple.isRISCV()) {
973 SupportedArgument = V == "desc" || V == "trad";
974 EnableTLSDESC = V == "desc";
975 } else if (Triple.isX86()) {
976 SupportedArgument = V == "gnu" || V == "gnu2";
977 EnableTLSDESC = V == "gnu2";
978 } else {
979 Unsupported = true;
980 }
981 if (Unsupported) {
982 TC.getDriver().Diag(diag::err_drv_unsupported_opt_for_target)
983 << A->getSpelling() << Triple.getTriple();
984 } else if (!SupportedArgument) {
985 TC.getDriver().Diag(diag::err_drv_unsupported_option_argument_for_target)
986 << A->getSpelling() << V << Triple.getTriple();
987 }
988 return EnableTLSDESC;
989}
990
991void tools::addDTLTOOptions(const ToolChain &ToolChain, const ArgList &Args,
992 llvm::opt::ArgStringList &CmdArgs) {
993 if (Arg *A = Args.getLastArg(options::OPT_fthinlto_distributor_EQ)) {
994 CmdArgs.push_back(
995 Args.MakeArgString("--thinlto-distributor=" + Twine(A->getValue())));
996 const Driver &D = ToolChain.getDriver();
997 CmdArgs.push_back(Args.MakeArgString("--thinlto-remote-compiler=" +
998 Twine(D.getDriverProgramPath())));
999 if (auto *PA = D.getPrependArg())
1000 CmdArgs.push_back(Args.MakeArgString(
1001 "--thinlto-remote-compiler-prepend-arg=" + Twine(PA)));
1002
1003 for (const auto &A :
1004 Args.getAllArgValues(options::OPT_Xthinlto_distributor_EQ))
1005 CmdArgs.push_back(Args.MakeArgString("--thinlto-distributor-arg=" + A));
1006 }
1007}
1008
1009void tools::addLTOOptions(const ToolChain &ToolChain, const ArgList &Args,
1010 ArgStringList &CmdArgs, const InputInfo &Output,
1011 const InputInfoList &Inputs, bool IsThinLTO) {
1012 const llvm::Triple &Triple = ToolChain.getTriple();
1013 const bool IsOSAIX = Triple.isOSAIX();
1014 const bool IsAMDGCN = Triple.isAMDGCN();
1015 StringRef Linker = Args.getLastArgValue(options::OPT_fuse_ld_EQ);
1016 const char *LinkerPath = Args.MakeArgString(ToolChain.GetLinkerPath());
1017 const Driver &D = ToolChain.getDriver();
1018 const bool IsFatLTO = Args.hasFlag(options::OPT_ffat_lto_objects,
1019 options::OPT_fno_fat_lto_objects, false);
1020 const bool IsUnifiedLTO = Args.hasArg(options::OPT_funified_lto);
1021
1022 assert(!Inputs.empty() && "Must have at least one input.");
1023
1024 auto Input = llvm::find_if(
1025 Inputs, [](const InputInfo &II) -> bool { return II.isFilename(); });
1026 if (Input == Inputs.end()) {
1027 // For a very rare case, all of the inputs to the linker are
1028 // InputArg. If that happens, just use the first InputInfo.
1029 Input = Inputs.begin();
1030 }
1031
1032 if (Linker != "lld" && Linker != "lld-link" &&
1033 llvm::sys::path::filename(LinkerPath) != "ld.lld" &&
1034 llvm::sys::path::stem(LinkerPath) != "ld.lld" && !Triple.isOSOpenBSD()) {
1035 // Tell the linker to load the plugin. This has to come before
1036 // AddLinkerInputs as gold requires -plugin and AIX ld requires -bplugin to
1037 // come before any -plugin-opt/-bplugin_opt that -Wl might forward.
1038 const char *PluginPrefix = IsOSAIX ? "-bplugin:" : "";
1039 const char *PluginName = IsOSAIX ? "/libLTO" : "/LLVMgold";
1040
1041 if (!IsOSAIX)
1042 CmdArgs.push_back("-plugin");
1043
1044#if defined(_WIN32)
1045 const char *Suffix = ".dll";
1046#elif defined(__APPLE__)
1047 const char *Suffix = ".dylib";
1048#else
1049 const char *Suffix = ".so";
1050#endif
1051
1052 SmallString<1024> Plugin;
1053 llvm::sys::path::native(Twine(D.Dir) +
1054 "/../" CLANG_INSTALL_LIBDIR_BASENAME +
1055 PluginName + Suffix,
1056 Plugin);
1057 CmdArgs.push_back(Args.MakeArgString(Twine(PluginPrefix) + Plugin));
1058 } else {
1059 // Tell LLD to find and use .llvm.lto section in regular relocatable object
1060 // files
1061 if (IsFatLTO)
1062 CmdArgs.push_back("--fat-lto-objects");
1063
1064 if (Args.hasArg(options::OPT_flto_partitions_EQ)) {
1065 int Value = 0;
1066 StringRef A = Args.getLastArgValue(options::OPT_flto_partitions_EQ, "8");
1067 if (A.getAsInteger(10, Value) || (Value < 1)) {
1068 Arg *Arg = Args.getLastArg(options::OPT_flto_partitions_EQ);
1069 D.Diag(diag::err_drv_invalid_int_value)
1070 << Arg->getAsString(Args) << Arg->getValue();
1071 }
1072 CmdArgs.push_back(Args.MakeArgString("--lto-partitions=" + A));
1073 }
1074 }
1075
1076 const char *PluginOptPrefix = IsOSAIX ? "-bplugin_opt:" : "-plugin-opt=";
1077 const char *ExtraDash = IsOSAIX ? "-" : "";
1078 const char *ParallelismOpt = IsOSAIX ? "-threads=" : "jobs=";
1079
1080 // Note, this solution is far from perfect, better to encode it into IR
1081 // metadata, but this may not be worth it, since it looks like aranges is on
1082 // the way out.
1083 if (Args.hasArg(options::OPT_gdwarf_aranges)) {
1084 CmdArgs.push_back(Args.MakeArgString(Twine(PluginOptPrefix) +
1085 "-generate-arange-section"));
1086 }
1087
1088 // Pass vector library arguments to LTO.
1089 Arg *ArgVecLib = Args.getLastArg(options::OPT_fveclib);
1090 if (ArgVecLib && ArgVecLib->getNumValues() == 1) {
1091 // Map the vector library names from clang front-end to opt front-end. The
1092 // values are taken from the TargetLibraryInfo class command line options.
1093 std::optional<StringRef> OptVal =
1094 llvm::StringSwitch<std::optional<StringRef>>(ArgVecLib->getValue())
1095 .Case("Accelerate", "Accelerate")
1096 .Case("libmvec", "LIBMVEC")
1097 .Case("AMDLIBM", "AMDLIBM")
1098 .Case("MASSV", "MASSV")
1099 .Case("SVML", "SVML")
1100 .Case("SLEEF", "sleefgnuabi")
1101 .Case("Darwin_libsystem_m", "Darwin_libsystem_m")
1102 .Case("ArmPL", "ArmPL")
1103 .Case("none", "none")
1104 .Default(std::nullopt);
1105
1106 if (OptVal)
1107 CmdArgs.push_back(Args.MakeArgString(
1108 Twine(PluginOptPrefix) + "-vector-library=" + OptVal.value()));
1109 }
1110
1111 // Try to pass driver level flags relevant to LTO code generation down to
1112 // the plugin.
1113
1114 // Handle flags for selecting CPU variants.
1115 std::string CPU = getCPUName(D, Args, Triple);
1116 if (!CPU.empty())
1117 CmdArgs.push_back(
1118 Args.MakeArgString(Twine(PluginOptPrefix) + ExtraDash + "mcpu=" + CPU));
1119
1120 if (Args.getLastArg(options::OPT_O_Group)) {
1121 unsigned OptimizationLevel =
1123 CmdArgs.push_back(Args.MakeArgString(Twine(PluginOptPrefix) + ExtraDash +
1124 "O" + Twine(OptimizationLevel)));
1125 if (IsAMDGCN)
1126 CmdArgs.push_back(
1127 Args.MakeArgString(Twine("--lto-CGO") + Twine(OptimizationLevel)));
1128 }
1129
1130 if (Args.hasArg(options::OPT_gsplit_dwarf)) {
1132 if (const Arg *A = Args.getLastArg(options::OPT_dumpdir)) {
1133 F = A->getValue();
1134 } else {
1135 F = Output.getFilename();
1136 F += "_";
1137 }
1138 CmdArgs.push_back(
1139 Args.MakeArgString(Twine(PluginOptPrefix) + "dwo_dir=" + F + "dwo"));
1140 }
1141
1142 if (IsThinLTO && !IsOSAIX)
1143 CmdArgs.push_back(Args.MakeArgString(Twine(PluginOptPrefix) + "thinlto"));
1144 else if (IsThinLTO && IsOSAIX)
1145 CmdArgs.push_back(Args.MakeArgString(Twine("-bdbg:thinlto")));
1146
1147 // Matrix intrinsic lowering happens at link time with ThinLTO. Enable
1148 // LowerMatrixIntrinsicsPass, which is transitively called by
1149 // buildThinLTODefaultPipeline under EnableMatrix.
1150 if ((IsThinLTO || IsFatLTO || IsUnifiedLTO) &&
1151 Args.hasArg(options::OPT_fenable_matrix))
1152 CmdArgs.push_back(
1153 Args.MakeArgString(Twine(PluginOptPrefix) + "-enable-matrix"));
1154
1155 StringRef Parallelism = getLTOParallelism(Args, D);
1156 if (!Parallelism.empty())
1157 CmdArgs.push_back(Args.MakeArgString(Twine(PluginOptPrefix) +
1158 ParallelismOpt + Parallelism));
1159
1160 // Forward the SLP vectorization preference to the LTO backend by toggling
1161 // the existing -vectorize-slp cl::opt, which the pass honors directly. This
1162 // avoids minting dedicated linker options for what is only pipeline tuning.
1163 if (Arg *A = Args.getLastArg(options::OPT_fslp_vectorize,
1164 options::OPT_fno_slp_vectorize))
1165 CmdArgs.push_back(Args.MakeArgString(
1166 Twine(PluginOptPrefix) + "-vectorize-slp=" +
1167 (A->getOption().matches(options::OPT_fslp_vectorize) ? "1" : "0")));
1168
1169 // Pass down GlobalISel options.
1170 if (Arg *A = Args.getLastArg(options::OPT_fglobal_isel,
1171 options::OPT_fno_global_isel)) {
1172 // Parsing -fno-global-isel explicitly gives architectures that enable GISel
1173 // by default a chance to disable it.
1174 CmdArgs.push_back(Args.MakeArgString(
1175 Twine(PluginOptPrefix) + "-global-isel=" +
1176 (A->getOption().matches(options::OPT_fglobal_isel) ? "1" : "0")));
1177 }
1178
1179 // If an explicit debugger tuning argument appeared, pass it along.
1180 if (Arg *A =
1181 Args.getLastArg(options::OPT_gTune_Group, options::OPT_ggdbN_Group)) {
1182 if (A->getOption().matches(options::OPT_glldb))
1183 CmdArgs.push_back(
1184 Args.MakeArgString(Twine(PluginOptPrefix) + "-debugger-tune=lldb"));
1185 else if (A->getOption().matches(options::OPT_gsce))
1186 CmdArgs.push_back(
1187 Args.MakeArgString(Twine(PluginOptPrefix) + "-debugger-tune=sce"));
1188 else if (A->getOption().matches(options::OPT_gdbx))
1189 CmdArgs.push_back(
1190 Args.MakeArgString(Twine(PluginOptPrefix) + "-debugger-tune=dbx"));
1191 else
1192 CmdArgs.push_back(
1193 Args.MakeArgString(Twine(PluginOptPrefix) + "-debugger-tune=gdb"));
1194 }
1195
1196 if (IsOSAIX) {
1198 CmdArgs.push_back(
1199 Args.MakeArgString(Twine(PluginOptPrefix) + "-no-integrated-as=1"));
1200
1201 // On AIX, clang assumes strict-dwarf is true if any debug option is
1202 // specified, unless it is told explicitly not to assume so.
1203 Arg *A = Args.getLastArg(options::OPT_g_Group);
1204 bool EnableDebugInfo = A && !A->getOption().matches(options::OPT_g0) &&
1205 !A->getOption().matches(options::OPT_ggdb0);
1206 if (EnableDebugInfo && Args.hasFlag(options::OPT_gstrict_dwarf,
1207 options::OPT_gno_strict_dwarf, true))
1208 CmdArgs.push_back(
1209 Args.MakeArgString(Twine(PluginOptPrefix) + "-strict-dwarf=true"));
1210
1211 for (const Arg *A : Args.filtered_reverse(options::OPT_mabi_EQ)) {
1212 StringRef V = A->getValue();
1213 if (V == "vec-default")
1214 break;
1215 if (V == "vec-extabi") {
1216 CmdArgs.push_back(
1217 Args.MakeArgString(Twine(PluginOptPrefix) + "-vec-extabi"));
1218 break;
1219 }
1220 }
1221 }
1222
1223 bool UseSeparateSections =
1225
1226 if (Args.hasFlag(options::OPT_ffunction_sections,
1227 options::OPT_fno_function_sections, UseSeparateSections))
1228 CmdArgs.push_back(
1229 Args.MakeArgString(Twine(PluginOptPrefix) + "-function-sections=1"));
1230 else if (Args.hasArg(options::OPT_fno_function_sections))
1231 CmdArgs.push_back(
1232 Args.MakeArgString(Twine(PluginOptPrefix) + "-function-sections=0"));
1233
1234 bool DataSectionsTurnedOff = false;
1235 if (Args.hasFlag(options::OPT_fdata_sections, options::OPT_fno_data_sections,
1236 UseSeparateSections)) {
1237 CmdArgs.push_back(
1238 Args.MakeArgString(Twine(PluginOptPrefix) + "-data-sections=1"));
1239 } else if (Args.hasArg(options::OPT_fno_data_sections)) {
1240 DataSectionsTurnedOff = true;
1241 CmdArgs.push_back(
1242 Args.MakeArgString(Twine(PluginOptPrefix) + "-data-sections=0"));
1243 }
1244
1245 if (Args.hasArg(options::OPT_mxcoff_roptr) ||
1246 Args.hasArg(options::OPT_mno_xcoff_roptr)) {
1247 bool HasRoptr = Args.hasFlag(options::OPT_mxcoff_roptr,
1248 options::OPT_mno_xcoff_roptr, false);
1249 StringRef OptStr = HasRoptr ? "-mxcoff-roptr" : "-mno-xcoff-roptr";
1250 if (!IsOSAIX)
1251 D.Diag(diag::err_drv_unsupported_opt_for_target)
1252 << OptStr << Triple.str();
1253
1254 if (HasRoptr) {
1255 // The data sections option is on by default on AIX. We only need to error
1256 // out when -fno-data-sections is specified explicitly to turn off data
1257 // sections.
1258 if (DataSectionsTurnedOff)
1259 D.Diag(diag::err_roptr_requires_data_sections);
1260
1261 CmdArgs.push_back(
1262 Args.MakeArgString(Twine(PluginOptPrefix) + "-mxcoff-roptr"));
1263 }
1264 }
1265
1266 // Pass an option to enable split machine functions.
1267 if (auto *A = Args.getLastArg(options::OPT_fsplit_machine_functions,
1268 options::OPT_fno_split_machine_functions)) {
1269 if (A->getOption().matches(options::OPT_fsplit_machine_functions))
1270 CmdArgs.push_back(Args.MakeArgString(Twine(PluginOptPrefix) +
1271 "-split-machine-functions"));
1272 }
1273
1274 if (auto *A =
1275 Args.getLastArg(options::OPT_fpartition_static_data_sections,
1276 options::OPT_fno_partition_static_data_sections)) {
1277 if (A->getOption().matches(options::OPT_fpartition_static_data_sections)) {
1278 CmdArgs.push_back(Args.MakeArgString(Twine(PluginOptPrefix) +
1279 "-partition-static-data-sections"));
1280 }
1281 }
1282
1283 if (Arg *A = getLastProfileSampleUseArg(Args)) {
1284 StringRef FName = A->getValue();
1285 if (!llvm::sys::fs::exists(FName))
1286 D.Diag(diag::err_drv_no_such_file) << FName;
1287 else
1288 CmdArgs.push_back(Args.MakeArgString(Twine(PluginOptPrefix) +
1289 "sample-profile=" + FName));
1290 }
1291
1292 if (auto *CSPGOGenerateArg = getLastCSProfileGenerateArg(Args)) {
1293 CmdArgs.push_back(Args.MakeArgString(Twine(PluginOptPrefix) + ExtraDash +
1294 "cs-profile-generate"));
1295 if (CSPGOGenerateArg->getOption().matches(
1296 options::OPT_fcs_profile_generate_EQ)) {
1297 SmallString<128> Path(CSPGOGenerateArg->getValue());
1298 llvm::sys::path::append(Path, "default_%m.profraw");
1299 CmdArgs.push_back(Args.MakeArgString(Twine(PluginOptPrefix) + ExtraDash +
1300 "cs-profile-path=" + Path));
1301 } else
1302 CmdArgs.push_back(
1303 Args.MakeArgString(Twine(PluginOptPrefix) + ExtraDash +
1304 "cs-profile-path=default_%m.profraw"));
1305 } else if (auto *ProfileUseArg = getLastProfileUseArg(Args)) {
1306 SmallString<128> Path(
1307 ProfileUseArg->getNumValues() == 0 ? "" : ProfileUseArg->getValue());
1308 if (Path.empty() || llvm::sys::fs::is_directory(Path))
1309 llvm::sys::path::append(Path, "default.profdata");
1310 CmdArgs.push_back(Args.MakeArgString(Twine(PluginOptPrefix) + ExtraDash +
1311 "cs-profile-path=" + Path));
1312 }
1313
1314 // This controls whether or not we perform JustMyCode instrumentation.
1315 if (Args.hasFlag(options::OPT_fjmc, options::OPT_fno_jmc, false)) {
1316 if (ToolChain.getEffectiveTriple().isOSBinFormatELF())
1317 CmdArgs.push_back(Args.MakeArgString(Twine(PluginOptPrefix) +
1318 "-enable-jmc-instrument"));
1319 else
1320 D.Diag(clang::diag::warn_drv_fjmc_for_elf_only);
1321 }
1322
1323 if (Args.hasFlag(options::OPT_femulated_tls, options::OPT_fno_emulated_tls,
1324 Triple.hasDefaultEmulatedTLS())) {
1325 CmdArgs.push_back(
1326 Args.MakeArgString(Twine(PluginOptPrefix) + "-emulated-tls"));
1327 }
1328 if (isTLSDESCEnabled(ToolChain, Args))
1329 CmdArgs.push_back(
1330 Args.MakeArgString(Twine(PluginOptPrefix) + "-enable-tlsdesc"));
1331
1332 if (Args.hasFlag(options::OPT_fstack_size_section,
1333 options::OPT_fno_stack_size_section, false))
1334 CmdArgs.push_back(
1335 Args.MakeArgString(Twine(PluginOptPrefix) + "-stack-size-section"));
1336
1337 if (Args.hasFlag(options::OPT_fexperimental_call_graph_section,
1338 options::OPT_fno_experimental_call_graph_section, false))
1339 CmdArgs.push_back(
1340 Args.MakeArgString(Twine(PluginOptPrefix) + "-call-graph-section"));
1341
1342 // Setup statistics file output.
1343 SmallString<128> StatsFile = getStatsFileName(Args, Output, *Input, D);
1344 if (!StatsFile.empty())
1345 CmdArgs.push_back(
1346 Args.MakeArgString(Twine(PluginOptPrefix) + "stats-file=" + StatsFile));
1347
1348 // Setup crash diagnostics dir.
1349 if (Arg *A = Args.getLastArg(options::OPT_fcrash_diagnostics_dir))
1350 CmdArgs.push_back(Args.MakeArgString(
1351 Twine(PluginOptPrefix) + "-crash-diagnostics-dir=" + A->getValue()));
1352
1353 addX86AlignBranchArgs(D, Args, CmdArgs, /*IsLTO=*/true, PluginOptPrefix);
1354
1355 // Handle remark diagnostics on screen options: '-Rpass-*'.
1356 renderRpassOptions(Args, CmdArgs, PluginOptPrefix);
1357
1358 // Handle serialized remarks options: '-fsave-optimization-record'
1359 // and '-foptimization-record-*'.
1360 if (willEmitRemarks(Args))
1361 renderRemarksOptions(Args, CmdArgs, ToolChain.getEffectiveTriple(), *Input,
1362 Output, PluginOptPrefix);
1363
1364 // Handle remarks hotness/threshold related options.
1365 renderRemarksHotnessOptions(Args, CmdArgs, PluginOptPrefix);
1366
1368 /*IsLTO=*/true, PluginOptPrefix);
1369
1370 bool IsELF = Triple.isOSBinFormatELF();
1371 bool Crel = false;
1372 bool ImplicitMapSyms = false;
1373 for (const Arg *A : Args.filtered(options::OPT_Wa_COMMA)) {
1374 for (StringRef V : A->getValues()) {
1375 auto Equal = V.split('=');
1376 auto checkArg = [&](bool ValidTarget,
1377 std::initializer_list<const char *> Set) {
1378 if (!ValidTarget) {
1379 D.Diag(diag::err_drv_unsupported_opt_for_target)
1380 << (Twine("-Wa,") + Equal.first + "=").str()
1381 << Triple.getTriple();
1382 } else if (!llvm::is_contained(Set, Equal.second)) {
1383 D.Diag(diag::err_drv_unsupported_option_argument)
1384 << (Twine("-Wa,") + Equal.first + "=").str() << Equal.second;
1385 }
1386 };
1387 if (Equal.first == "-mmapsyms") {
1388 ImplicitMapSyms = Equal.second == "implicit";
1389 checkArg(IsELF && Triple.isAArch64(), {"default", "implicit"});
1390 } else if (V == "--crel")
1391 Crel = true;
1392 else if (V == "--no-crel")
1393 Crel = false;
1394 else
1395 continue;
1396 A->claim();
1397 }
1398 }
1399 if (Crel) {
1400 if (IsELF && !Triple.isMIPS()) {
1401 CmdArgs.push_back(Args.MakeArgString(Twine(PluginOptPrefix) + "-crel"));
1402 } else {
1403 D.Diag(diag::err_drv_unsupported_opt_for_target)
1404 << "-Wa,--crel" << D.getTargetTriple();
1405 }
1406 }
1407 if (ImplicitMapSyms)
1408 CmdArgs.push_back(
1409 Args.MakeArgString(Twine(PluginOptPrefix) + "-implicit-mapsyms"));
1410
1411 if (Args.hasArg(options::OPT_ftime_report))
1412 CmdArgs.push_back(
1413 Args.MakeArgString(Twine(PluginOptPrefix) + "-time-passes"));
1414
1415 addDTLTOOptions(ToolChain, Args, CmdArgs);
1416}
1417
1419 const ArgList &Args,
1420 ArgStringList &CmdArgs) {
1421 // Default to clang lib / lib64 folder, i.e. the same location as device
1422 // runtime.
1423 SmallString<256> DefaultLibPath =
1424 llvm::sys::path::parent_path(TC.getDriver().Dir);
1425 llvm::sys::path::append(DefaultLibPath, CLANG_INSTALL_LIBDIR_BASENAME);
1426 CmdArgs.push_back(Args.MakeArgString("-L" + DefaultLibPath));
1427}
1428
1429void tools::addArchSpecificRPath(const ToolChain &TC, const ArgList &Args,
1430 ArgStringList &CmdArgs) {
1431 if (!Args.hasFlag(options::OPT_frtlib_add_rpath,
1432 options::OPT_fno_rtlib_add_rpath, false))
1433 return;
1434
1435 if (TC.getTriple().isOSAIX()) // TODO: AIX doesn't support -rpath option.
1436 return;
1437
1439 if (const auto StdlibPath = TC.getStdlibPath()) {
1440 for (const Multilib &M : llvm::reverse(TC.getSelectedMultilibs())) {
1441 if (M.isDefault())
1442 continue;
1443 SmallString<128> P(*StdlibPath);
1444 llvm::sys::path::append(P, M.gccSuffix());
1445 CandidateRPaths.emplace_back(std::string(P));
1446 }
1447 CandidateRPaths.emplace_back(*StdlibPath);
1448 }
1449 for (const auto &CandidateRPath : CandidateRPaths) {
1450 if (TC.getVFS().exists(CandidateRPath)) {
1451 CmdArgs.push_back("-rpath");
1452 CmdArgs.push_back(Args.MakeArgString(CandidateRPath));
1453 }
1454 }
1455}
1456
1457bool tools::addOpenMPRuntime(const Compilation &C, ArgStringList &CmdArgs,
1458 const ToolChain &TC, const ArgList &Args,
1459 bool ForceStaticHostRuntime, bool IsOffloadingHost,
1460 bool GompNeedsRT) {
1461 if (!Args.hasFlag(options::OPT_fopenmp, options::OPT_fopenmp_EQ,
1462 options::OPT_fno_openmp, false)) {
1463 // We need libomptarget (liboffload) if it's the choosen offloading runtime.
1464 if (Args.hasFlag(options::OPT_foffload_via_llvm,
1465 options::OPT_fno_offload_via_llvm, false))
1466 CmdArgs.push_back("-lomptarget");
1467 return false;
1468 }
1469
1471
1472 if (RTKind == Driver::OMPRT_Unknown)
1473 // Already diagnosed.
1474 return false;
1475
1476 if (ForceStaticHostRuntime)
1477 CmdArgs.push_back("-Bstatic");
1478
1479 switch (RTKind) {
1480 case Driver::OMPRT_OMP:
1481 CmdArgs.push_back("-lomp");
1482 break;
1483 case Driver::OMPRT_GOMP:
1484 CmdArgs.push_back("-lgomp");
1485 break;
1487 CmdArgs.push_back("-liomp5");
1488 break;
1490 break;
1491 }
1492
1493 if (ForceStaticHostRuntime)
1494 CmdArgs.push_back("-Bdynamic");
1495
1496 if (RTKind == Driver::OMPRT_GOMP && GompNeedsRT)
1497 CmdArgs.push_back("-lrt");
1498
1499 if (IsOffloadingHost)
1500 CmdArgs.push_back("-lomptarget");
1501
1502 addArchSpecificRPath(TC, Args, CmdArgs);
1503
1504 addOpenMPRuntimeLibraryPath(TC, Args, CmdArgs);
1505
1506 return true;
1507}
1508
1510 const JobAction &JA,
1511 const llvm::opt::ArgList &Args,
1512 llvm::opt::ArgStringList &CmdArgs) {
1514 return;
1515
1516 // For all the host OpenMP offloading compile jobs we need to pass the targets
1517 // information using -fopenmp-targets= option.
1518 constexpr llvm::StringLiteral Targets("--offload-targets=");
1519
1520 SmallVector<StringRef> Triples;
1521 auto TCRange = C.getOffloadToolChains<Action::OFK_OpenMP>();
1522 std::transform(TCRange.first, TCRange.second, std::back_inserter(Triples),
1523 [](auto TC) { return TC.second->getTripleString(); });
1524 CmdArgs.push_back(
1525 Args.MakeArgString(Twine(Targets) + llvm::join(Triples, ",")));
1526}
1527
1528static void addSanitizerRuntime(const ToolChain &TC, const ArgList &Args,
1529 ArgStringList &CmdArgs, StringRef Sanitizer,
1530 bool IsShared, bool IsWhole) {
1531 // Wrap any static runtimes that must be forced into executable in
1532 // whole-archive.
1533 if (IsWhole) CmdArgs.push_back("--whole-archive");
1534 CmdArgs.push_back(TC.getCompilerRTArgString(
1535 Args, Sanitizer, IsShared ? ToolChain::FT_Shared : ToolChain::FT_Static));
1536 if (IsWhole) CmdArgs.push_back("--no-whole-archive");
1537
1538 if (IsShared) {
1539 addArchSpecificRPath(TC, Args, CmdArgs);
1540 }
1541}
1542
1543// Tries to use a file with the list of dynamic symbols that need to be exported
1544// from the runtime library. Returns true if the file was found.
1545static bool addSanitizerDynamicList(const ToolChain &TC, const ArgList &Args,
1546 ArgStringList &CmdArgs,
1547 StringRef Sanitizer) {
1548 bool LinkerIsGnuLd = solaris::isLinkerGnuLd(TC, Args);
1549
1550 // Solaris ld defaults to --export-dynamic behaviour but doesn't support
1551 // the option, so don't try to pass it.
1552 if (TC.getTriple().isOSSolaris() && !LinkerIsGnuLd)
1553 return true;
1554 SmallString<128> SanRT(TC.getCompilerRT(Args, Sanitizer));
1555 if (llvm::sys::fs::exists(SanRT + ".syms")) {
1556 CmdArgs.push_back(Args.MakeArgString("--dynamic-list=" + SanRT + ".syms"));
1557 return true;
1558 }
1559 return false;
1560}
1561
1563 const llvm::opt::ArgList &Args,
1564 llvm::opt::ArgStringList &CmdArgs,
1565 bool as_needed) {
1566 assert(!TC.getTriple().isOSAIX() &&
1567 "AIX linker does not support any form of --as-needed option yet.");
1568 bool LinkerIsGnuLd = solaris::isLinkerGnuLd(TC, Args);
1569
1570 // While the Solaris 11.2 ld added --as-needed/--no-as-needed as aliases
1571 // for the native forms -z ignore/-z record, they are missing in Illumos,
1572 // so always use the native form.
1573 // GNU ld doesn't support -z ignore/-z record, so don't use them even on
1574 // Solaris.
1575 if (TC.getTriple().isOSSolaris() && !LinkerIsGnuLd) {
1576 CmdArgs.push_back("-z");
1577 CmdArgs.push_back(as_needed ? "ignore" : "record");
1578 } else {
1579 CmdArgs.push_back(as_needed ? "--as-needed" : "--no-as-needed");
1580 }
1581}
1582
1584 const llvm::opt::ArgList &Args,
1585 ArgStringList &CmdArgs) {
1586 // Force linking against the system libraries sanitizers depends on
1587 // (see PR15823 why this is necessary).
1588 addAsNeededOption(TC, Args, CmdArgs, false);
1589 // There's no libpthread or librt on RTEMS & Android.
1590 if (TC.getTriple().getOS() != llvm::Triple::RTEMS &&
1591 !TC.getTriple().isAndroid() && !TC.getTriple().isOHOSFamily()) {
1592 CmdArgs.push_back("-lpthread");
1593 if (!TC.getTriple().isOSOpenBSD() && !TC.getTriple().isOSHaiku())
1594 CmdArgs.push_back("-lrt");
1595 }
1596 CmdArgs.push_back("-lm");
1597 // There's no libdl on all OSes.
1598 if (!TC.getTriple().isOSFreeBSD() && !TC.getTriple().isOSNetBSD() &&
1599 !TC.getTriple().isOSOpenBSD() && !TC.getTriple().isOSDragonFly() &&
1600 !TC.getTriple().isOSHaiku() &&
1601 TC.getTriple().getOS() != llvm::Triple::RTEMS)
1602 CmdArgs.push_back("-ldl");
1603 // Required for backtrace on some OSes
1604 if (TC.getTriple().isOSFreeBSD() || TC.getTriple().isOSNetBSD() ||
1605 TC.getTriple().isOSOpenBSD() || TC.getTriple().isOSDragonFly())
1606 CmdArgs.push_back("-lexecinfo");
1607 if (TC.getTriple().isOSHaiku())
1608 CmdArgs.push_back("-lbsd");
1609 // There is no libresolv on Android, FreeBSD, OpenBSD, etc. On musl
1610 // libresolv.a, even if exists, is an empty archive to satisfy POSIX -lresolv
1611 // requirement.
1612 if (TC.getTriple().isOSLinux() && !TC.getTriple().isAndroid() &&
1613 !TC.getTriple().isMusl())
1614 CmdArgs.push_back("-lresolv");
1615}
1616
1617static void
1618collectSanitizerRuntimes(const ToolChain &TC, const ArgList &Args,
1619 SmallVectorImpl<StringRef> &SharedRuntimes,
1620 SmallVectorImpl<StringRef> &StaticRuntimes,
1621 SmallVectorImpl<StringRef> &NonWholeStaticRuntimes,
1622 SmallVectorImpl<StringRef> &HelperStaticRuntimes,
1623 SmallVectorImpl<StringRef> &RequiredSymbols) {
1624 assert(!TC.getTriple().isOSDarwin() && "it's not used by Darwin");
1625 const SanitizerArgs &SanArgs = TC.getSanitizerArgs(Args);
1626 // Collect shared runtimes.
1627 if (SanArgs.needsSharedRt()) {
1628 if (SanArgs.needsAsanRt()) {
1629 SharedRuntimes.push_back("asan");
1630 if (!Args.hasArg(options::OPT_shared) && !TC.getTriple().isAndroid())
1631 HelperStaticRuntimes.push_back("asan-preinit");
1632 }
1633 if (SanArgs.needsMemProfRt()) {
1634 SharedRuntimes.push_back("memprof");
1635 if (!Args.hasArg(options::OPT_shared) && !TC.getTriple().isAndroid())
1636 HelperStaticRuntimes.push_back("memprof-preinit");
1637 }
1638 if (SanArgs.needsNsanRt())
1639 SharedRuntimes.push_back("nsan");
1640 if (SanArgs.needsUbsanRt()) {
1641 if (SanArgs.requiresMinimalRuntime())
1642 SharedRuntimes.push_back("ubsan_minimal");
1643 else
1644 SharedRuntimes.push_back("ubsan_standalone");
1645 }
1646 if (SanArgs.needsScudoRt()) {
1647 SharedRuntimes.push_back("scudo_standalone");
1648 }
1649 if (SanArgs.needsTsanRt())
1650 SharedRuntimes.push_back("tsan");
1651 if (SanArgs.needsTysanRt())
1652 SharedRuntimes.push_back("tysan");
1653 if (SanArgs.needsHwasanRt()) {
1654 if (SanArgs.needsHwasanAliasesRt())
1655 SharedRuntimes.push_back("hwasan_aliases");
1656 else
1657 SharedRuntimes.push_back("hwasan");
1658 if (!Args.hasArg(options::OPT_shared))
1659 HelperStaticRuntimes.push_back("hwasan-preinit");
1660 }
1661 if (SanArgs.needsRtsanRt() && SanArgs.linkRuntimes())
1662 SharedRuntimes.push_back("rtsan");
1663 }
1664
1665 // The stats_client library is also statically linked into DSOs.
1666 if (SanArgs.needsStatsRt())
1667 StaticRuntimes.push_back("stats_client");
1668
1669 // Always link the static runtime regardless of DSO or executable.
1670 if (SanArgs.needsAsanRt())
1671 HelperStaticRuntimes.push_back("asan_static");
1672
1673 // Collect static runtimes.
1674 if (Args.hasArg(options::OPT_shared)) {
1675 // Don't link static runtimes into DSOs.
1676 return;
1677 }
1678
1679 // Each static runtime that has a DSO counterpart above is excluded below,
1680 // but runtimes that exist only as static are not affected by needsSharedRt.
1681
1682 if (!SanArgs.needsSharedRt() && SanArgs.needsAsanRt()) {
1683 StaticRuntimes.push_back("asan");
1684 if (SanArgs.linkCXXRuntimes())
1685 StaticRuntimes.push_back("asan_cxx");
1686 }
1687
1688 if (!SanArgs.needsSharedRt() && SanArgs.needsRtsanRt() &&
1689 SanArgs.linkRuntimes())
1690 StaticRuntimes.push_back("rtsan");
1691
1692 if (!SanArgs.needsSharedRt() && SanArgs.needsMemProfRt()) {
1693 StaticRuntimes.push_back("memprof");
1694 if (SanArgs.linkCXXRuntimes())
1695 StaticRuntimes.push_back("memprof_cxx");
1696 }
1697
1698 if (!SanArgs.needsSharedRt() && SanArgs.needsHwasanRt()) {
1699 if (SanArgs.needsHwasanAliasesRt()) {
1700 StaticRuntimes.push_back("hwasan_aliases");
1701 if (SanArgs.linkCXXRuntimes())
1702 StaticRuntimes.push_back("hwasan_aliases_cxx");
1703 } else {
1704 StaticRuntimes.push_back("hwasan");
1705 if (SanArgs.linkCXXRuntimes())
1706 StaticRuntimes.push_back("hwasan_cxx");
1707 }
1708 }
1709 if (SanArgs.needsDfsanRt())
1710 StaticRuntimes.push_back("dfsan");
1711 if (SanArgs.needsLsanRt())
1712 StaticRuntimes.push_back("lsan");
1713 if (SanArgs.needsMsanRt()) {
1714 StaticRuntimes.push_back("msan");
1715 if (SanArgs.linkCXXRuntimes())
1716 StaticRuntimes.push_back("msan_cxx");
1717 }
1718 if (!SanArgs.needsSharedRt() && SanArgs.needsNsanRt())
1719 StaticRuntimes.push_back("nsan");
1720 if (!SanArgs.needsSharedRt() && SanArgs.needsTsanRt()) {
1721 StaticRuntimes.push_back("tsan");
1722 if (SanArgs.linkCXXRuntimes())
1723 StaticRuntimes.push_back("tsan_cxx");
1724 }
1725 if (!SanArgs.needsSharedRt() && SanArgs.needsTysanRt())
1726 StaticRuntimes.push_back("tysan");
1727 if (!SanArgs.needsSharedRt() && SanArgs.needsUbsanRt()) {
1728 if (SanArgs.requiresMinimalRuntime()) {
1729 StaticRuntimes.push_back("ubsan_minimal");
1730 } else {
1731 StaticRuntimes.push_back("ubsan_standalone");
1732 }
1733 }
1734 if (SanArgs.needsSafeStackRt()) {
1735 NonWholeStaticRuntimes.push_back("safestack");
1736 RequiredSymbols.push_back("__safestack_init");
1737 }
1738 if (!(SanArgs.needsSharedRt() && SanArgs.needsUbsanRt())) {
1739 if (SanArgs.needsCfiCrossDsoRt())
1740 StaticRuntimes.push_back("cfi");
1741 if (SanArgs.needsCfiCrossDsoDiagRt())
1742 StaticRuntimes.push_back("cfi_diag");
1743 }
1744 if (SanArgs.linkCXXRuntimes() && !SanArgs.requiresMinimalRuntime() &&
1745 ((!SanArgs.needsSharedRt() && SanArgs.needsUbsanCXXRt()) ||
1746 SanArgs.needsCfiCrossDsoDiagRt())) {
1747 StaticRuntimes.push_back("ubsan_standalone_cxx");
1748 }
1749 if (SanArgs.needsStatsRt()) {
1750 NonWholeStaticRuntimes.push_back("stats");
1751 RequiredSymbols.push_back("__sanitizer_stats_register");
1752 }
1753 if (!SanArgs.needsSharedRt() && SanArgs.needsScudoRt()) {
1754 StaticRuntimes.push_back("scudo_standalone");
1755 if (SanArgs.linkCXXRuntimes())
1756 StaticRuntimes.push_back("scudo_standalone_cxx");
1757 }
1758 if (SanArgs.needsUbsanLoopDetectRt())
1759 NonWholeStaticRuntimes.push_back("ubsan_loop_detect");
1760}
1761
1762// Should be called before we add system libraries (C++ ABI, libstdc++/libc++,
1763// C runtime, etc). Returns true if sanitizer system deps need to be linked in.
1764bool tools::addSanitizerRuntimes(const ToolChain &TC, const ArgList &Args,
1765 ArgStringList &CmdArgs) {
1766 const SanitizerArgs &SanArgs = TC.getSanitizerArgs(Args);
1767 SmallVector<StringRef, 4> SharedRuntimes, StaticRuntimes,
1768 NonWholeStaticRuntimes, HelperStaticRuntimes, RequiredSymbols;
1769 if (SanArgs.linkRuntimes()) {
1770 collectSanitizerRuntimes(TC, Args, SharedRuntimes, StaticRuntimes,
1771 NonWholeStaticRuntimes, HelperStaticRuntimes,
1772 RequiredSymbols);
1773 }
1774
1775 // -u options must be added before the runtime libs that resolve them.
1776 for (auto S : RequiredSymbols) {
1777 CmdArgs.push_back("-u");
1778 CmdArgs.push_back(Args.MakeArgString(S));
1779 }
1780
1781 // Add shared runtimes before adding fuzzer and its dependencies.
1782 for (auto RT : SharedRuntimes)
1783 addSanitizerRuntime(TC, Args, CmdArgs, RT, true, false);
1784
1785 // Inject libfuzzer dependencies.
1786 bool FuzzerNeedsSanitizerDeps = false;
1787 if (SanArgs.needsFuzzer() && SanArgs.linkRuntimes() &&
1788 !Args.hasArg(options::OPT_shared)) {
1789
1790 addSanitizerRuntime(TC, Args, CmdArgs, "fuzzer", false, true);
1791 FuzzerNeedsSanitizerDeps = true;
1792 if (SanArgs.needsFuzzerInterceptors())
1793 addSanitizerRuntime(TC, Args, CmdArgs, "fuzzer_interceptors", false,
1794 true);
1795 if (!Args.hasArg(options::OPT_nostdlibxx)) {
1796 bool OnlyLibstdcxxStatic = Args.hasArg(options::OPT_static_libstdcxx) &&
1797 !Args.hasArg(options::OPT_static);
1798 if (OnlyLibstdcxxStatic)
1799 CmdArgs.push_back("-Bstatic");
1800 TC.AddCXXStdlibLibArgs(Args, CmdArgs);
1801 if (OnlyLibstdcxxStatic)
1802 CmdArgs.push_back("-Bdynamic");
1803 }
1804 }
1805
1806 for (auto RT : HelperStaticRuntimes)
1807 addSanitizerRuntime(TC, Args, CmdArgs, RT, false, true);
1808 bool AddExportDynamic = false;
1809 for (auto RT : StaticRuntimes) {
1810 addSanitizerRuntime(TC, Args, CmdArgs, RT, false, true);
1811 AddExportDynamic |= !addSanitizerDynamicList(TC, Args, CmdArgs, RT);
1812 }
1813 for (auto RT : NonWholeStaticRuntimes) {
1814 addSanitizerRuntime(TC, Args, CmdArgs, RT, false, false);
1815 AddExportDynamic |= !addSanitizerDynamicList(TC, Args, CmdArgs, RT);
1816 }
1817 // If there is a static runtime with no dynamic list, force all the symbols
1818 // to be dynamic to be sure we export sanitizer interface functions.
1819 if (AddExportDynamic && !TC.getTriple().isNVPTX())
1820 CmdArgs.push_back("--export-dynamic");
1821
1822 if (SanArgs.hasCrossDsoCfi() && !AddExportDynamic)
1823 CmdArgs.push_back("--export-dynamic-symbol=__cfi_check");
1824
1825 if (SanArgs.hasMemTag()) {
1826 CmdArgs.push_back("-z");
1827 CmdArgs.push_back(
1828 Args.MakeArgString("memtag-mode=" + SanArgs.getMemtagMode()));
1829
1830 if (SanArgs.hasMemtagHeap()) {
1831 CmdArgs.push_back("-z");
1832 CmdArgs.push_back("memtag-heap");
1833 }
1834
1835 if (SanArgs.hasMemtagStack()) {
1836 CmdArgs.push_back("-z");
1837 CmdArgs.push_back("memtag-stack");
1838 }
1839
1840 if (TC.getTriple().isAndroid())
1841 CmdArgs.push_back("--android-memtag-note");
1842 }
1843
1844 return !StaticRuntimes.empty() || !NonWholeStaticRuntimes.empty() ||
1845 FuzzerNeedsSanitizerDeps;
1846}
1847
1848bool tools::addXRayRuntime(const ToolChain&TC, const ArgList &Args, ArgStringList &CmdArgs) {
1849 const XRayArgs &XRay = TC.getXRayArgs(Args);
1850 if (Args.hasArg(options::OPT_shared)) {
1851 if (XRay.needsXRayDSORt()) {
1852 CmdArgs.push_back("--whole-archive");
1853 CmdArgs.push_back(TC.getCompilerRTArgString(Args, "xray-dso"));
1854 CmdArgs.push_back("--no-whole-archive");
1855 return true;
1856 }
1857 } else if (XRay.needsXRayRt()) {
1858 CmdArgs.push_back("--whole-archive");
1859 CmdArgs.push_back(TC.getCompilerRTArgString(Args, "xray"));
1860 for (const auto &Mode : XRay.modeList())
1861 CmdArgs.push_back(TC.getCompilerRTArgString(Args, Mode));
1862 CmdArgs.push_back("--no-whole-archive");
1863 return true;
1864 }
1865
1866 return false;
1867}
1868
1870 const llvm::opt::ArgList &Args,
1871 ArgStringList &CmdArgs) {
1872 addAsNeededOption(TC, Args, CmdArgs, false);
1873 CmdArgs.push_back("-lpthread");
1874 if (!TC.getTriple().isOSOpenBSD())
1875 CmdArgs.push_back("-lrt");
1876 CmdArgs.push_back("-lm");
1877
1878 if (!TC.getTriple().isOSFreeBSD() &&
1879 !TC.getTriple().isOSNetBSD() &&
1880 !TC.getTriple().isOSOpenBSD())
1881 CmdArgs.push_back("-ldl");
1882}
1883
1884bool tools::areOptimizationsEnabled(const ArgList &Args) {
1885 // Find the last -O arg and see if it is non-zero.
1886 if (Arg *A = Args.getLastArg(options::OPT_O_Group))
1887 return !A->getOption().matches(options::OPT_O0);
1888 // Defaults to -O0.
1889 return false;
1890}
1891
1892const char *tools::SplitDebugName(const JobAction &JA, const ArgList &Args,
1893 const InputInfo &Input,
1894 const InputInfo &Output) {
1895 auto AddPostfix = [JA](auto &F) {
1897 F += (Twine("_") + JA.getOffloadingArch().ArchName).str();
1898 F += ".dwo";
1899 };
1900 if (Arg *A = Args.getLastArg(options::OPT_gsplit_dwarf_EQ))
1901 if (StringRef(A->getValue()) == "single" && Output.isFilename())
1902 return Args.MakeArgString(Output.getFilename());
1903
1905 if (const Arg *A = Args.getLastArg(options::OPT_dumpdir)) {
1906 T = A->getValue();
1907 } else {
1908 if (Args.hasArg(options::OPT_o, options::OPT__SLASH_o,
1909 options::OPT__SLASH_Fo) &&
1910 Args.hasArg(options::OPT_c) && Output.isFilename()) {
1911 // The driver has resolved /Fo<dir>/ into a concrete obj path in Output.
1912 StringRef Obj = Output.getFilename();
1913 T = Obj;
1914 llvm::sys::path::remove_filename(T);
1915 llvm::sys::path::append(T, llvm::sys::path::stem(Obj));
1916 AddPostfix(T);
1917 return Args.MakeArgString(T);
1918 }
1919 }
1920
1921 T += llvm::sys::path::stem(Input.getBaseInput());
1922 AddPostfix(T);
1923 return Args.MakeArgString(T);
1924}
1925
1926void tools::SplitDebugInfo(const ToolChain &TC, Compilation &C, const Tool &T,
1927 const JobAction &JA, const ArgList &Args,
1928 const InputInfo &Output, const char *OutFile) {
1929 ArgStringList ExtractArgs;
1930 ExtractArgs.push_back("--extract-dwo");
1931
1932 ArgStringList StripArgs;
1933 StripArgs.push_back("--strip-dwo");
1934
1935 // Grabbing the output of the earlier compile step.
1936 StripArgs.push_back(Output.getFilename());
1937 ExtractArgs.push_back(Output.getFilename());
1938 ExtractArgs.push_back(OutFile);
1939
1940 const char *Exec =
1941 Args.MakeArgString(TC.GetProgramPath(CLANG_DEFAULT_OBJCOPY));
1942 InputInfo II(types::TY_Object, Output.getFilename(), Output.getFilename());
1943
1944 // First extract the dwo sections.
1945 C.addCommand(std::make_unique<Command>(JA, T,
1947 Exec, ExtractArgs, II, Output));
1948
1949 // Then remove them from the original .o file.
1950 C.addCommand(std::make_unique<Command>(
1951 JA, T, ResponseFileSupport::AtFileCurCP(), Exec, StripArgs, II, Output));
1952}
1953
1954// Claim options we don't want to warn if they are unused. We do this for
1955// options that build systems might add but are unused when assembling or only
1956// running the preprocessor for example.
1957void tools::claimNoWarnArgs(const ArgList &Args) {
1958 // Don't warn about unused -f(no-)?lto. This can happen when we're
1959 // preprocessing, precompiling or assembling.
1960 Args.ClaimAllArgs(options::OPT_flto_EQ);
1961 Args.ClaimAllArgs(options::OPT_flto);
1962 Args.ClaimAllArgs(options::OPT_fno_lto);
1963}
1964
1965Arg *tools::getLastCSProfileGenerateArg(const ArgList &Args) {
1966 auto *CSPGOGenerateArg = Args.getLastArg(options::OPT_fcs_profile_generate,
1967 options::OPT_fcs_profile_generate_EQ,
1968 options::OPT_fno_profile_generate);
1969 if (CSPGOGenerateArg &&
1970 CSPGOGenerateArg->getOption().matches(options::OPT_fno_profile_generate))
1971 CSPGOGenerateArg = nullptr;
1972
1973 return CSPGOGenerateArg;
1974}
1975
1976Arg *tools::getLastProfileUseArg(const ArgList &Args) {
1977 auto *ProfileUseArg = Args.getLastArg(
1978 options::OPT_fprofile_instr_use, options::OPT_fprofile_instr_use_EQ,
1979 options::OPT_fprofile_use, options::OPT_fprofile_use_EQ,
1980 options::OPT_fno_profile_instr_use);
1981
1982 if (ProfileUseArg &&
1983 ProfileUseArg->getOption().matches(options::OPT_fno_profile_instr_use))
1984 ProfileUseArg = nullptr;
1985
1986 return ProfileUseArg;
1987}
1988
1989Arg *tools::getLastProfileSampleUseArg(const ArgList &Args) {
1990 auto *ProfileSampleUseArg = Args.getLastArg(
1991 options::OPT_fprofile_sample_use_EQ, options::OPT_fno_profile_sample_use);
1992
1993 if (ProfileSampleUseArg && (ProfileSampleUseArg->getOption().matches(
1994 options::OPT_fno_profile_sample_use)))
1995 return nullptr;
1996
1997 return Args.getLastArg(options::OPT_fprofile_sample_use_EQ);
1998}
1999
2000const char *tools::RelocationModelName(llvm::Reloc::Model Model) {
2001 switch (Model) {
2002 case llvm::Reloc::Static:
2003 return "static";
2004 case llvm::Reloc::PIC_:
2005 return "pic";
2006 case llvm::Reloc::DynamicNoPIC:
2007 return "dynamic-no-pic";
2008 case llvm::Reloc::ROPI:
2009 return "ropi";
2010 case llvm::Reloc::RWPI:
2011 return "rwpi";
2012 case llvm::Reloc::ROPI_RWPI:
2013 return "ropi-rwpi";
2014 }
2015 llvm_unreachable("Unknown Reloc::Model kind");
2016}
2017
2018/// Parses the various -fpic/-fPIC/-fpie/-fPIE arguments. Then,
2019/// smooshes them together with platform defaults, to decide whether
2020/// this compile should be using PIC mode or not. Returns a tuple of
2021/// (RelocationModel, PICLevel, IsPIE).
2022std::tuple<llvm::Reloc::Model, unsigned, bool>
2023tools::ParsePICArgs(const ToolChain &ToolChain, const ArgList &Args) {
2024 const llvm::Triple &EffectiveTriple = ToolChain.getEffectiveTriple();
2025 const llvm::Triple &Triple = ToolChain.getTriple();
2026
2027 bool PIE = ToolChain.isPIEDefault(Args);
2028 bool PIC = PIE || ToolChain.isPICDefault();
2029 // The Darwin/MachO default to use PIC does not apply when using -static.
2030 if (Triple.isOSBinFormatMachO() && Args.hasArg(options::OPT_static))
2031 PIE = PIC = false;
2032 bool IsPICLevelTwo = PIC;
2033
2034 bool KernelOrKext =
2035 Args.hasArg(options::OPT_mkernel, options::OPT_fapple_kext);
2036
2037 // Android-specific defaults for PIC/PIE
2038 if (Triple.isAndroid()) {
2039 switch (Triple.getArch()) {
2040 case llvm::Triple::x86:
2041 case llvm::Triple::x86_64:
2042 PIC = true; // "-fPIC"
2043 IsPICLevelTwo = true;
2044 break;
2045
2046 default:
2047 PIC = true; // "-fpic"
2048 break;
2049 }
2050 }
2051
2052 // OHOS-specific defaults for PIC/PIE
2053 if (Triple.isOHOSFamily() && Triple.getArch() == llvm::Triple::aarch64)
2054 PIC = true;
2055
2056 // OpenBSD-specific defaults for PIE
2057 if (Triple.isOSOpenBSD()) {
2058 switch (ToolChain.getArch()) {
2059 case llvm::Triple::arm:
2060 case llvm::Triple::aarch64:
2061 case llvm::Triple::mips64:
2062 case llvm::Triple::mips64el:
2063 case llvm::Triple::x86:
2064 case llvm::Triple::x86_64:
2065 IsPICLevelTwo = false; // "-fpie"
2066 break;
2067
2068 case llvm::Triple::ppc:
2069 case llvm::Triple::sparcv9:
2070 IsPICLevelTwo = true; // "-fPIE"
2071 break;
2072
2073 default:
2074 break;
2075 }
2076 }
2077
2078 // The last argument relating to either PIC or PIE wins, and no
2079 // other argument is used. If the last argument is any flavor of the
2080 // '-fno-...' arguments, both PIC and PIE are disabled. Any PIE
2081 // option implicitly enables PIC at the same level.
2082 Arg *LastPICArg = Args.getLastArg(options::OPT_fPIC, options::OPT_fno_PIC,
2083 options::OPT_fpic, options::OPT_fno_pic,
2084 options::OPT_fPIE, options::OPT_fno_PIE,
2085 options::OPT_fpie, options::OPT_fno_pie);
2086 if (Triple.isOSWindows() && !Triple.isOSCygMing() && LastPICArg &&
2087 LastPICArg == Args.getLastArg(options::OPT_fPIC, options::OPT_fpic,
2088 options::OPT_fPIE, options::OPT_fpie)) {
2089 ToolChain.getDriver().Diag(diag::err_drv_unsupported_opt_for_target)
2090 << LastPICArg->getSpelling() << Triple.str();
2091 if (Triple.getArch() == llvm::Triple::x86_64)
2092 return std::make_tuple(llvm::Reloc::PIC_, 2U, false);
2093 return std::make_tuple(llvm::Reloc::Static, 0U, false);
2094 }
2095
2096 // Check whether the tool chain trumps the PIC-ness decision. If the PIC-ness
2097 // is forced, then neither PIC nor PIE flags will have no effect.
2099 if (LastPICArg) {
2100 Option O = LastPICArg->getOption();
2101 if (O.matches(options::OPT_fPIC) || O.matches(options::OPT_fpic) ||
2102 O.matches(options::OPT_fPIE) || O.matches(options::OPT_fpie)) {
2103 PIE = O.matches(options::OPT_fPIE) || O.matches(options::OPT_fpie);
2104 PIC =
2105 PIE || O.matches(options::OPT_fPIC) || O.matches(options::OPT_fpic);
2106 IsPICLevelTwo =
2107 O.matches(options::OPT_fPIE) || O.matches(options::OPT_fPIC);
2108 } else {
2109 PIE = PIC = false;
2110 if (EffectiveTriple.isPS()) {
2111 Arg *ModelArg = Args.getLastArg(options::OPT_mcmodel_EQ);
2112 StringRef Model = ModelArg ? ModelArg->getValue() : "";
2113 if (Model != "kernel") {
2114 PIC = true;
2115 ToolChain.getDriver().Diag(diag::warn_drv_ps_force_pic)
2116 << LastPICArg->getSpelling()
2117 << (EffectiveTriple.isPS4() ? "PS4" : "PS5");
2118 }
2119 }
2120 }
2121 }
2122 }
2123
2124 // Introduce a Darwin and PS4/PS5-specific hack. If the default is PIC, but
2125 // the PIC level would've been set to level 1, force it back to level 2 PIC
2126 // instead.
2127 if (PIC && (Triple.isOSDarwin() || EffectiveTriple.isPS()))
2128 IsPICLevelTwo |= ToolChain.isPICDefault();
2129
2130 // This kernel flags are a trump-card: they will disable PIC/PIE
2131 // generation, independent of the argument order.
2132 if (KernelOrKext &&
2133 ((!EffectiveTriple.isiOS() || EffectiveTriple.isOSVersionLT(6)) &&
2134 !EffectiveTriple.isWatchOS() && !EffectiveTriple.isDriverKit()))
2135 PIC = PIE = false;
2136
2137 if (Arg *A = Args.getLastArg(options::OPT_mdynamic_no_pic)) {
2138 // This is a very special mode. It trumps the other modes, almost no one
2139 // uses it, and it isn't even valid on any OS but Darwin.
2140 if (!Triple.isOSDarwin())
2141 ToolChain.getDriver().Diag(diag::err_drv_unsupported_opt_for_target)
2142 << A->getSpelling() << Triple.str();
2143
2144 // FIXME: Warn when this flag trumps some other PIC or PIE flag.
2145
2146 // Only a forced PIC mode can cause the actual compile to have PIC defines
2147 // etc., no flags are sufficient. This behavior was selected to closely
2148 // match that of llvm-gcc and Apple GCC before that.
2150
2151 return std::make_tuple(llvm::Reloc::DynamicNoPIC, PIC ? 2U : 0U, false);
2152 }
2153
2154 bool EmbeddedPISupported;
2155 switch (Triple.getArch()) {
2156 case llvm::Triple::arm:
2157 case llvm::Triple::armeb:
2158 case llvm::Triple::thumb:
2159 case llvm::Triple::thumbeb:
2160 EmbeddedPISupported = true;
2161 break;
2162 default:
2163 EmbeddedPISupported = false;
2164 break;
2165 }
2166
2167 bool ROPI = false, RWPI = false;
2168 Arg* LastROPIArg = Args.getLastArg(options::OPT_fropi, options::OPT_fno_ropi);
2169 if (LastROPIArg && LastROPIArg->getOption().matches(options::OPT_fropi)) {
2170 if (!EmbeddedPISupported)
2171 ToolChain.getDriver().Diag(diag::err_drv_unsupported_opt_for_target)
2172 << LastROPIArg->getSpelling() << Triple.str();
2173 ROPI = true;
2174 }
2175 Arg *LastRWPIArg = Args.getLastArg(options::OPT_frwpi, options::OPT_fno_rwpi);
2176 if (LastRWPIArg && LastRWPIArg->getOption().matches(options::OPT_frwpi)) {
2177 if (!EmbeddedPISupported)
2178 ToolChain.getDriver().Diag(diag::err_drv_unsupported_opt_for_target)
2179 << LastRWPIArg->getSpelling() << Triple.str();
2180 RWPI = true;
2181 }
2182
2183 // ROPI and RWPI are not compatible with PIC or PIE.
2184 if ((ROPI || RWPI) && (PIC || PIE))
2185 ToolChain.getDriver().Diag(diag::err_drv_ropi_rwpi_incompatible_with_pic);
2186
2187 if (Triple.isMIPS()) {
2188 StringRef CPUName;
2189 StringRef ABIName;
2190 mips::getMipsCPUAndABI(Args, Triple, CPUName, ABIName);
2191 // When targeting the N64 ABI, PIC is the default, except in the case
2192 // when the -mno-abicalls option is used. In that case we exit
2193 // at next check regardless of PIC being set below.
2194 if (ABIName == "n64")
2195 PIC = true;
2196 // When targettng MIPS with -mno-abicalls, it's always static.
2197 if(Args.hasArg(options::OPT_mno_abicalls))
2198 return std::make_tuple(llvm::Reloc::Static, 0U, false);
2199 // Unlike other architectures, MIPS, even with -fPIC/-mxgot/multigot,
2200 // does not use PIC level 2 for historical reasons.
2201 IsPICLevelTwo = false;
2202 }
2203
2204 if (PIC)
2205 return std::make_tuple(llvm::Reloc::PIC_, IsPICLevelTwo ? 2U : 1U, PIE);
2206
2207 llvm::Reloc::Model RelocM = llvm::Reloc::Static;
2208 if (ROPI && RWPI)
2209 RelocM = llvm::Reloc::ROPI_RWPI;
2210 else if (ROPI)
2211 RelocM = llvm::Reloc::ROPI;
2212 else if (RWPI)
2213 RelocM = llvm::Reloc::RWPI;
2214
2215 return std::make_tuple(RelocM, 0U, false);
2216}
2217
2218bool tools::getStaticPIE(const ArgList &Args, const ToolChain &TC) {
2219 bool HasStaticPIE = Args.hasArg(options::OPT_static_pie);
2220 if (HasStaticPIE && Args.hasArg(options::OPT_no_pie)) {
2221 const Driver &D = TC.getDriver();
2222 const llvm::opt::OptTable &Opts = D.getOpts();
2223 StringRef StaticPIEName = Opts.getOptionName(options::OPT_static_pie);
2224 StringRef NoPIEName = Opts.getOptionName(options::OPT_nopie);
2225 D.Diag(diag::err_drv_cannot_mix_options) << StaticPIEName << NoPIEName;
2226 }
2227 return HasStaticPIE;
2228}
2229
2230// `-falign-functions` indicates that the functions should be aligned to the
2231// backend's preferred alignment.
2232//
2233// `-falign-functions=1` is the same as `-fno-align-functions`.
2234//
2235// The scalar `n` in `-falign-functions=n` must be an integral value between
2236// [0, 65536]. If the value is not a power-of-two, it will be rounded up to
2237// the nearest power-of-two.
2238//
2239// If we return `0`, the frontend will default to the backend's preferred
2240// alignment.
2241//
2242// NOTE: icc only allows values between [0, 4096]. icc uses `-falign-functions`
2243// to mean `-falign-functions=16`. GCC defaults to the backend's preferred
2244// alignment. For unaligned functions, we default to the backend's preferred
2245// alignment.
2246unsigned tools::ParseFunctionAlignment(const ToolChain &TC,
2247 const ArgList &Args) {
2248 const Arg *A = Args.getLastArg(options::OPT_falign_functions,
2249 options::OPT_falign_functions_EQ,
2250 options::OPT_fno_align_functions);
2251 if (!A || A->getOption().matches(options::OPT_fno_align_functions))
2252 return 0;
2253
2254 if (A->getOption().matches(options::OPT_falign_functions))
2255 return 0;
2256
2257 unsigned Value = 0;
2258 if (StringRef(A->getValue()).getAsInteger(10, Value) || Value > 65536)
2259 TC.getDriver().Diag(diag::err_drv_invalid_int_value)
2260 << A->getAsString(Args) << A->getValue();
2261 return Value ? llvm::Log2_32_Ceil(std::min(Value, 65536u)) : Value;
2262}
2263
2265 ArgStringList &CmdArgs, llvm::codegenoptions::DebugInfoKind DebugInfoKind) {
2266 switch (DebugInfoKind) {
2267 case llvm::codegenoptions::DebugDirectivesOnly:
2268 CmdArgs.push_back("-debug-info-kind=line-directives-only");
2269 break;
2270 case llvm::codegenoptions::DebugLineTablesOnly:
2271 CmdArgs.push_back("-debug-info-kind=line-tables-only");
2272 break;
2273 case llvm::codegenoptions::DebugInfoConstructor:
2274 CmdArgs.push_back("-debug-info-kind=constructor");
2275 break;
2276 case llvm::codegenoptions::LimitedDebugInfo:
2277 CmdArgs.push_back("-debug-info-kind=limited");
2278 break;
2279 case llvm::codegenoptions::FullDebugInfo:
2280 CmdArgs.push_back("-debug-info-kind=standalone");
2281 break;
2282 case llvm::codegenoptions::UnusedTypeInfo:
2283 CmdArgs.push_back("-debug-info-kind=unused-types");
2284 break;
2285 default:
2286 break;
2287 }
2288}
2289
2290// Convert an arg of the form "-gN" or "-ggdbN" or one of their aliases
2291// to the corresponding DebugInfoKind.
2292llvm::codegenoptions::DebugInfoKind tools::debugLevelToInfoKind(const Arg &A) {
2293 assert(A.getOption().matches(options::OPT_gN_Group) &&
2294 "Not a -g option that specifies a debug-info level");
2295 if (A.getOption().matches(options::OPT_g0) ||
2296 A.getOption().matches(options::OPT_ggdb0))
2297 return llvm::codegenoptions::NoDebugInfo;
2298 if (A.getOption().matches(options::OPT_gline_tables_only) ||
2299 A.getOption().matches(options::OPT_ggdb1))
2300 return llvm::codegenoptions::DebugLineTablesOnly;
2301 if (A.getOption().matches(options::OPT_gline_directives_only))
2302 return llvm::codegenoptions::DebugDirectivesOnly;
2303 return llvm::codegenoptions::DebugInfoConstructor;
2304}
2305
2306static unsigned ParseDebugDefaultVersion(const ToolChain &TC,
2307 const ArgList &Args) {
2308 const Arg *A = Args.getLastArg(options::OPT_fdebug_default_version);
2309
2310 if (!A)
2311 return 0;
2312
2313 unsigned Value = 0;
2314 if (StringRef(A->getValue()).getAsInteger(10, Value) || Value > 6 ||
2315 Value < 2)
2316 TC.getDriver().Diag(diag::err_drv_invalid_int_value)
2317 << A->getAsString(Args) << A->getValue();
2318 return Value;
2319}
2320
2321unsigned tools::DwarfVersionNum(StringRef ArgValue) {
2322 return llvm::StringSwitch<unsigned>(ArgValue)
2323 .Case("-gdwarf-2", 2)
2324 .Case("-gdwarf-3", 3)
2325 .Case("-gdwarf-4", 4)
2326 .Case("-gdwarf-5", 5)
2327 .Case("-gdwarf-6", 6)
2328 .Default(0);
2329}
2330
2331const Arg *tools::getDwarfNArg(const ArgList &Args) {
2332 return Args.getLastArg(options::OPT_gdwarf_2, options::OPT_gdwarf_3,
2333 options::OPT_gdwarf_4, options::OPT_gdwarf_5,
2334 options::OPT_gdwarf_6, options::OPT_gdwarf);
2335}
2336
2338 const llvm::opt::ArgList &Args) {
2339 unsigned DwarfVersion = ParseDebugDefaultVersion(TC, Args);
2340 if (const Arg *GDwarfN = getDwarfNArg(Args))
2341 if (int N = DwarfVersionNum(GDwarfN->getSpelling())) {
2342 DwarfVersion = N;
2343 if (DwarfVersion == 5 && TC.getTriple().isOSAIX())
2344 TC.getDriver().Diag(diag::err_drv_unsupported_opt_for_target)
2345 << GDwarfN->getSpelling() << TC.getTriple().str();
2346 }
2347 if (DwarfVersion == 0) {
2348 DwarfVersion = TC.GetDefaultDwarfVersion();
2349 assert(DwarfVersion && "toolchain default DWARF version must be nonzero");
2350 }
2351 return DwarfVersion;
2352}
2353
2355 const ArgList &Args, Arg *&Arg) {
2356 Arg = Args.getLastArg(options::OPT_gsplit_dwarf, options::OPT_gsplit_dwarf_EQ,
2357 options::OPT_gno_split_dwarf);
2358 if (!Arg || Arg->getOption().matches(options::OPT_gno_split_dwarf))
2360
2361 if (Arg->getOption().matches(options::OPT_gsplit_dwarf))
2363
2364 StringRef Value = Arg->getValue();
2365 if (Value == "split")
2367 if (Value == "single")
2369
2370 D.Diag(diag::err_drv_unsupported_option_argument)
2371 << Arg->getSpelling() << Arg->getValue();
2373}
2374
2375bool tools::checkDebugInfoOption(const Arg *A, const ArgList &Args,
2376 const Driver &D, const ToolChain &TC) {
2377 assert(A && "Expected non-nullptr argument.");
2378 if (TC.supportsDebugInfoOption(A))
2379 return true;
2380 D.Diag(diag::warn_drv_unsupported_debug_info_opt_for_target)
2381 << A->getAsString(Args) << TC.getTripleString();
2382 return false;
2383}
2384
2386 const ArgList &Args,
2387 ArgStringList &CmdArgs) {
2388 if (Args.hasFlag(options::OPT_fdebug_info_for_profiling,
2389 options::OPT_fno_debug_info_for_profiling, false) &&
2391 Args.getLastArg(options::OPT_fdebug_info_for_profiling), Args, D, TC))
2392 CmdArgs.push_back("-fdebug-info-for-profiling");
2393}
2394
2395void tools::AddAssemblerKPIC(const ToolChain &ToolChain, const ArgList &Args,
2396 ArgStringList &CmdArgs) {
2397 llvm::Reloc::Model RelocationModel;
2398 unsigned PICLevel;
2399 bool IsPIE;
2400 std::tie(RelocationModel, PICLevel, IsPIE) = ParsePICArgs(ToolChain, Args);
2401
2402 if (RelocationModel != llvm::Reloc::Static)
2403 CmdArgs.push_back("-KPIC");
2404}
2405
2406/// Determine whether Objective-C automated reference counting is
2407/// enabled.
2408bool tools::isObjCAutoRefCount(const ArgList &Args) {
2409 return Args.hasFlag(options::OPT_fobjc_arc, options::OPT_fno_objc_arc, false);
2410}
2411
2413
2414static LibGccType getLibGccType(const ToolChain &TC, const Driver &D,
2415 const ArgList &Args) {
2416 if (Args.hasArg(options::OPT_static_libgcc) ||
2417 Args.hasArg(options::OPT_static) || Args.hasArg(options::OPT_static_pie) ||
2418 // The Android NDK only provides libunwind.a, not libunwind.so.
2419 TC.getTriple().isAndroid())
2421 if (Args.hasArg(options::OPT_shared_libgcc))
2424}
2425
2426// Gcc adds libgcc arguments in various ways:
2427//
2428// gcc <none>: -lgcc --as-needed -lgcc_s --no-as-needed
2429// g++ <none>: -lgcc_s -lgcc
2430// gcc shared: -lgcc_s -lgcc
2431// g++ shared: -lgcc_s -lgcc
2432// gcc static: -lgcc -lgcc_eh
2433// g++ static: -lgcc -lgcc_eh
2434// gcc static-pie: -lgcc -lgcc_eh
2435// g++ static-pie: -lgcc -lgcc_eh
2436//
2437// Also, certain targets need additional adjustments.
2438
2439static void AddUnwindLibrary(const ToolChain &TC, const Driver &D,
2440 ArgStringList &CmdArgs, const ArgList &Args) {
2442 // By default OHOS binaries are linked statically to libunwind.
2443 if (TC.getTriple().isOHOSFamily() && UNW == ToolChain::UNW_CompilerRT) {
2444 CmdArgs.push_back("-l:libunwind.a");
2445 return;
2446 }
2447
2448 // Targets that don't use unwind libraries.
2449 if ((TC.getTriple().isAndroid() && UNW == ToolChain::UNW_Libgcc) ||
2450 TC.getTriple().isOSIAMCU() || TC.getTriple().isOSBinFormatWasm() ||
2451 TC.getTriple().isWindowsMSVCEnvironment() || UNW == ToolChain::UNW_None)
2452 return;
2453
2454 LibGccType LGT = getLibGccType(TC, D, Args);
2455 bool AsNeeded = LGT == LibGccType::UnspecifiedLibGcc &&
2456 (UNW == ToolChain::UNW_CompilerRT || !D.CCCIsCXX()) &&
2457 !TC.getTriple().isAndroid() &&
2458 !TC.getTriple().isOSCygMing() && !TC.getTriple().isOSAIX();
2459 if (AsNeeded)
2460 addAsNeededOption(TC, Args, CmdArgs, true);
2461
2462 switch (UNW) {
2464 return;
2465 case ToolChain::UNW_Libgcc: {
2466 if (LGT == LibGccType::StaticLibGcc)
2467 CmdArgs.push_back("-lgcc_eh");
2468 else
2469 CmdArgs.push_back("-lgcc_s");
2470 break;
2471 }
2473 if (TC.getTriple().isOSAIX()) {
2474 // AIX only has libunwind as a shared library. So do not pass
2475 // anything in if -static is specified.
2476 if (LGT != LibGccType::StaticLibGcc)
2477 CmdArgs.push_back("-lunwind");
2478 } else if (LGT == LibGccType::StaticLibGcc) {
2479 CmdArgs.push_back("-l:libunwind.a");
2480 } else if (LGT == LibGccType::SharedLibGcc) {
2481 if (TC.getTriple().isOSCygMing())
2482 CmdArgs.push_back("-l:libunwind.dll.a");
2483 else
2484 CmdArgs.push_back("-l:libunwind.so");
2485 } else {
2486 // Let the linker choose between libunwind.so and libunwind.a
2487 // depending on what's available, and depending on the -static flag
2488 CmdArgs.push_back("-lunwind");
2489 }
2490 break;
2491 }
2492
2493 if (AsNeeded)
2494 addAsNeededOption(TC, Args, CmdArgs, false);
2495}
2496
2497static void AddLibgcc(const ToolChain &TC, const Driver &D,
2498 ArgStringList &CmdArgs, const ArgList &Args) {
2499 LibGccType LGT = getLibGccType(TC, D, Args);
2500 if (LGT == LibGccType::StaticLibGcc ||
2501 (LGT == LibGccType::UnspecifiedLibGcc && !D.CCCIsCXX()))
2502 CmdArgs.push_back("-lgcc");
2503 AddUnwindLibrary(TC, D, CmdArgs, Args);
2504 if (LGT == LibGccType::SharedLibGcc ||
2506 CmdArgs.push_back("-lgcc");
2507 // compiler-rt is needed after libgcc for flang on AArch64 for the
2508 // __trampoline_setup symbol
2509 if (D.IsFlangMode() && TC.getArch() == llvm::Triple::aarch64) {
2510 CmdArgs.push_back("--as-needed");
2511 CmdArgs.push_back(TC.getCompilerRTArgString(Args, "builtins"));
2512 CmdArgs.push_back("--no-as-needed");
2513 }
2514}
2515
2516void tools::AddRunTimeLibs(const ToolChain &TC, const Driver &D,
2517 ArgStringList &CmdArgs, const ArgList &Args) {
2518 // Make use of compiler-rt if --rtlib option is used
2520
2521 switch (RLT) {
2523 CmdArgs.push_back(TC.getCompilerRTArgString(Args, "builtins"));
2524 AddUnwindLibrary(TC, D, CmdArgs, Args);
2525 break;
2527 // Make sure libgcc is not used under MSVC environment by default
2528 if (TC.getTriple().isKnownWindowsMSVCEnvironment()) {
2529 // Issue error diagnostic if libgcc is explicitly specified
2530 // through command line as --rtlib option argument.
2531 Arg *A = Args.getLastArg(options::OPT_rtlib_EQ);
2532 if (A && A->getValue() != StringRef("platform")) {
2533 TC.getDriver().Diag(diag::err_drv_unsupported_rtlib_for_platform)
2534 << A->getValue() << "MSVC";
2535 }
2536 } else
2537 AddLibgcc(TC, D, CmdArgs, Args);
2538 break;
2539 }
2540
2541 // On Android, the unwinder uses dl_iterate_phdr (or one of
2542 // dl_unwind_find_exidx/__gnu_Unwind_Find_exidx on arm32) from libdl.so. For
2543 // statically-linked executables, these functions come from libc.a instead.
2544 if (TC.getTriple().isAndroid() && !Args.hasArg(options::OPT_static) &&
2545 !Args.hasArg(options::OPT_static_pie))
2546 CmdArgs.push_back("-ldl");
2547}
2548
2549SmallString<128> tools::getStatsFileName(const llvm::opt::ArgList &Args,
2550 const InputInfo &Output,
2551 const InputInfo &Input,
2552 const Driver &D) {
2553 const Arg *A = Args.getLastArg(options::OPT_save_stats_EQ);
2554 if (!A && !D.CCPrintInternalStats)
2555 return {};
2556
2557 SmallString<128> StatsFile;
2558 if (A) {
2559 StringRef SaveStats = A->getValue();
2560 if (SaveStats == "obj" && Output.isFilename()) {
2561 StatsFile.assign(Output.getFilename());
2562 llvm::sys::path::remove_filename(StatsFile);
2563 } else if (SaveStats != "cwd") {
2564 D.Diag(diag::err_drv_invalid_value) << A->getAsString(Args) << SaveStats;
2565 return {};
2566 }
2567
2568 StringRef BaseName = llvm::sys::path::filename(Input.getBaseInput());
2569 llvm::sys::path::append(StatsFile, BaseName);
2570 llvm::sys::path::replace_extension(StatsFile, "stats");
2571 } else {
2572 assert(D.CCPrintInternalStats);
2573 StatsFile.assign(D.CCPrintInternalStatReportFilename.empty()
2574 ? "-"
2576 }
2577 return StatsFile;
2578}
2579
2580void tools::addMultilibFlag(bool Enabled, const StringRef Flag,
2581 Multilib::flags_list &Flags) {
2582 assert(Flag.front() == '-');
2583 if (Enabled) {
2584 Flags.push_back(Flag.str());
2585 } else {
2586 Flags.push_back(("!" + Flag.substr(1)).str());
2587 }
2588}
2589
2590void tools::addX86AlignBranchArgs(const Driver &D, const ArgList &Args,
2591 ArgStringList &CmdArgs, bool IsLTO,
2592 const StringRef PluginOptPrefix) {
2593 auto addArg = [&, IsLTO](const Twine &Arg) {
2594 if (IsLTO) {
2595 assert(!PluginOptPrefix.empty() && "Cannot have empty PluginOptPrefix!");
2596 CmdArgs.push_back(Args.MakeArgString(Twine(PluginOptPrefix) + Arg));
2597 } else {
2598 CmdArgs.push_back("-mllvm");
2599 CmdArgs.push_back(Args.MakeArgString(Arg));
2600 }
2601 };
2602
2603 if (Args.hasArg(options::OPT_mbranches_within_32B_boundaries)) {
2604 addArg(Twine("-x86-branches-within-32B-boundaries"));
2605 }
2606 if (const Arg *A = Args.getLastArg(options::OPT_malign_branch_boundary_EQ)) {
2607 StringRef Value = A->getValue();
2608 unsigned Boundary;
2609 if (Value.getAsInteger(10, Boundary) || Boundary < 16 ||
2610 !llvm::isPowerOf2_64(Boundary)) {
2611 D.Diag(diag::err_drv_invalid_argument_to_option)
2612 << Value << A->getOption().getName();
2613 } else {
2614 addArg("-x86-align-branch-boundary=" + Twine(Boundary));
2615 }
2616 }
2617 if (const Arg *A = Args.getLastArg(options::OPT_malign_branch_EQ)) {
2618 std::string AlignBranch;
2619 for (StringRef T : A->getValues()) {
2620 if (T != "fused" && T != "jcc" && T != "jmp" && T != "call" &&
2621 T != "ret" && T != "indirect")
2622 D.Diag(diag::err_drv_invalid_malign_branch_EQ)
2623 << T << "fused, jcc, jmp, call, ret, indirect";
2624 if (!AlignBranch.empty())
2625 AlignBranch += '+';
2626 AlignBranch += T;
2627 }
2628 addArg("-x86-align-branch=" + Twine(AlignBranch));
2629 }
2630 if (const Arg *A = Args.getLastArg(options::OPT_mpad_max_prefix_size_EQ)) {
2631 StringRef Value = A->getValue();
2632 unsigned PrefixSize;
2633 if (Value.getAsInteger(10, PrefixSize)) {
2634 D.Diag(diag::err_drv_invalid_argument_to_option)
2635 << Value << A->getOption().getName();
2636 } else {
2637 addArg("-x86-pad-max-prefix-size=" + Twine(PrefixSize));
2638 }
2639 }
2640}
2641
2642/// SDLSearch: Search for Static Device Library
2643/// The search for SDL bitcode files is consistent with how static host
2644/// libraries are discovered. That is, the -l option triggers a search for
2645/// files in a set of directories called the LINKPATH. The host library search
2646/// procedure looks for a specific filename in the LINKPATH. The filename for
2647/// a host library is lib<libname>.a or lib<libname>.so. For SDLs, there is an
2648/// ordered-set of filenames that are searched. We call this ordered-set of
2649/// filenames as SEARCH-ORDER. Since an SDL can either be device-type specific,
2650/// architecture specific, or generic across all architectures, a naming
2651/// convention and search order is used where the file name embeds the
2652/// architecture name <arch-name> (nvptx or amdgcn) and the GPU device type
2653/// <device-name> such as sm_30 and gfx906. <device-name> is absent in case of
2654/// device-independent SDLs. To reduce congestion in host library directories,
2655/// the search first looks for files in the “libdevice” subdirectory. SDLs that
2656/// are bc files begin with the prefix “lib”.
2657///
2658/// Machine-code SDLs can also be managed as an archive (*.a file). The
2659/// convention has been to use the prefix “lib”. To avoid confusion with host
2660/// archive libraries, we use prefix "libbc-" for the bitcode SDL archives.
2661///
2662static bool SDLSearch(const Driver &D, const llvm::opt::ArgList &DriverArgs,
2663 llvm::opt::ArgStringList &CC1Args,
2664 const SmallVectorImpl<std::string> &LibraryPaths,
2665 StringRef Lib, StringRef Arch, StringRef Target,
2666 bool isBitCodeSDL) {
2668
2669 std::string LibDeviceLoc = "/libdevice";
2670 std::string LibBcPrefix = "/libbc-";
2671 std::string LibPrefix = "/lib";
2672
2673 if (isBitCodeSDL) {
2674 // SEARCH-ORDER for Bitcode SDLs:
2675 // libdevice/libbc-<libname>-<arch-name>-<device-type>.a
2676 // libbc-<libname>-<arch-name>-<device-type>.a
2677 // libdevice/libbc-<libname>-<arch-name>.a
2678 // libbc-<libname>-<arch-name>.a
2679 // libdevice/libbc-<libname>.a
2680 // libbc-<libname>.a
2681 // libdevice/lib<libname>-<arch-name>-<device-type>.bc
2682 // lib<libname>-<arch-name>-<device-type>.bc
2683 // libdevice/lib<libname>-<arch-name>.bc
2684 // lib<libname>-<arch-name>.bc
2685 // libdevice/lib<libname>.bc
2686 // lib<libname>.bc
2687
2688 for (StringRef Base : {LibBcPrefix, LibPrefix}) {
2689 const auto *Ext = Base.contains(LibBcPrefix) ? ".a" : ".bc";
2690
2691 for (auto Suffix : {Twine(Lib + "-" + Arch + "-" + Target).str(),
2692 Twine(Lib + "-" + Arch).str(), Twine(Lib).str()}) {
2693 SDLs.push_back(Twine(LibDeviceLoc + Base + Suffix + Ext).str());
2694 SDLs.push_back(Twine(Base + Suffix + Ext).str());
2695 }
2696 }
2697 } else {
2698 // SEARCH-ORDER for Machine-code SDLs:
2699 // libdevice/lib<libname>-<arch-name>-<device-type>.a
2700 // lib<libname>-<arch-name>-<device-type>.a
2701 // libdevice/lib<libname>-<arch-name>.a
2702 // lib<libname>-<arch-name>.a
2703
2704 const auto *Ext = ".a";
2705
2706 for (auto Suffix : {Twine(Lib + "-" + Arch + "-" + Target).str(),
2707 Twine(Lib + "-" + Arch).str()}) {
2708 SDLs.push_back(Twine(LibDeviceLoc + LibPrefix + Suffix + Ext).str());
2709 SDLs.push_back(Twine(LibPrefix + Suffix + Ext).str());
2710 }
2711 }
2712
2713 // The CUDA toolchain does not use a global device llvm-link before the LLVM
2714 // backend generates ptx. So currently, the use of bitcode SDL for nvptx is
2715 // only possible with post-clang-cc1 linking. Clang cc1 has a feature that
2716 // will link libraries after clang compilation while the LLVM IR is still in
2717 // memory. This utilizes a clang cc1 option called “-mlink-builtin-bitcode”.
2718 // This is a clang -cc1 option that is generated by the clang driver. The
2719 // option value must a full path to an existing file.
2720 bool FoundSDL = false;
2721 for (auto LPath : LibraryPaths) {
2722 for (auto SDL : SDLs) {
2723 auto FullName = Twine(LPath + SDL).str();
2724 if (llvm::sys::fs::exists(FullName)) {
2725 CC1Args.push_back(DriverArgs.MakeArgString(FullName));
2726 FoundSDL = true;
2727 break;
2728 }
2729 }
2730 if (FoundSDL)
2731 break;
2732 }
2733 return FoundSDL;
2734}
2735
2736/// Search if a user provided archive file lib<libname>.a exists in any of
2737/// the library paths. If so, add a new command to clang-offload-bundler to
2738/// unbundle this archive and create a temporary device specific archive. Name
2739/// of this SDL is passed to the llvm-link tool.
2741 Compilation &C, const Driver &D, const Tool &T, const JobAction &JA,
2742 const InputInfoList &Inputs, const llvm::opt::ArgList &DriverArgs,
2743 llvm::opt::ArgStringList &CC1Args,
2744 const SmallVectorImpl<std::string> &LibraryPaths, StringRef Lib,
2745 StringRef Arch, StringRef Target, bool isBitCodeSDL) {
2746
2747 // We don't support bitcode archive bundles for nvptx
2748 if (isBitCodeSDL && Arch.contains("nvptx"))
2749 return;
2750
2751 bool FoundAOB = false;
2752 std::string ArchiveOfBundles;
2753
2754 llvm::Triple Triple(D.getTargetTriple());
2755 bool IsMSVC = Triple.isWindowsMSVCEnvironment();
2756 auto Ext = IsMSVC ? ".lib" : ".a";
2757 if (!Lib.starts_with(":") && !Lib.starts_with("-l")) {
2758 if (llvm::sys::fs::exists(Lib)) {
2759 ArchiveOfBundles = Lib;
2760 FoundAOB = true;
2761 }
2762 } else {
2763 Lib.consume_front("-l");
2764 for (auto LPath : LibraryPaths) {
2765 ArchiveOfBundles.clear();
2766 auto LibFile = (Lib.starts_with(":") ? Lib.drop_front()
2767 : IsMSVC ? Lib + Ext
2768 : "lib" + Lib + Ext)
2769 .str();
2770 for (auto Prefix : {"/libdevice/", "/"}) {
2771 auto AOB = Twine(LPath + Prefix + LibFile).str();
2772 if (llvm::sys::fs::exists(AOB)) {
2773 ArchiveOfBundles = AOB;
2774 FoundAOB = true;
2775 break;
2776 }
2777 }
2778 if (FoundAOB)
2779 break;
2780 }
2781 }
2782
2783 if (!FoundAOB)
2784 return;
2785
2786 llvm::file_magic Magic;
2787 auto EC = llvm::identify_magic(ArchiveOfBundles, Magic);
2788 if (EC || Magic != llvm::file_magic::archive)
2789 return;
2790
2791 StringRef Prefix = isBitCodeSDL ? "libbc-" : "lib";
2792 std::string OutputLib =
2793 D.GetTemporaryPath(Twine(Prefix + llvm::sys::path::filename(Lib) + "-" +
2794 Arch + "-" + Target)
2795 .str(),
2796 "a");
2797
2798 C.addTempFile(C.getArgs().MakeArgString(OutputLib));
2799
2800 SmallString<128> DeviceTriple;
2802 DeviceTriple += '-';
2803 std::string NormalizedTriple =
2804 T.getToolChain().getEffectiveTriple().normalize(
2805 llvm::Triple::CanonicalForm::FOUR_IDENT);
2806 DeviceTriple += NormalizedTriple;
2807 if (!Target.empty()) {
2808 DeviceTriple += '-';
2809 DeviceTriple += Target;
2810 }
2811
2812 std::string UnbundleArg("-unbundle");
2813 std::string TypeArg("-type=a");
2814 std::string InputArg("-input=" + ArchiveOfBundles);
2815 std::string OffloadArg("-targets=" + std::string(DeviceTriple));
2816 std::string OutputArg("-output=" + OutputLib);
2817
2818 const char *UBProgram = DriverArgs.MakeArgString(
2819 T.getToolChain().GetProgramPath("clang-offload-bundler"));
2820
2821 ArgStringList UBArgs;
2822 UBArgs.push_back(C.getArgs().MakeArgString(UnbundleArg));
2823 UBArgs.push_back(C.getArgs().MakeArgString(TypeArg));
2824 UBArgs.push_back(C.getArgs().MakeArgString(InputArg));
2825 UBArgs.push_back(C.getArgs().MakeArgString(OffloadArg));
2826 UBArgs.push_back(C.getArgs().MakeArgString(OutputArg));
2827
2828 // Add this flag to not exit from clang-offload-bundler if no compatible
2829 // code object is found in heterogenous archive library.
2830 std::string AdditionalArgs("-allow-missing-bundles");
2831 UBArgs.push_back(C.getArgs().MakeArgString(AdditionalArgs));
2832
2833 // Add this flag to treat hip and hipv4 offload kinds as compatible with
2834 // openmp offload kind while extracting code objects from a heterogenous
2835 // archive library. Vice versa is also considered compatible.
2836 std::string HipCompatibleArgs("-hip-openmp-compatible");
2837 UBArgs.push_back(C.getArgs().MakeArgString(HipCompatibleArgs));
2838
2839 C.addCommand(std::make_unique<Command>(
2840 JA, T, ResponseFileSupport::AtFileCurCP(), UBProgram, UBArgs, Inputs,
2841 InputInfo(&JA, C.getArgs().MakeArgString(OutputLib))));
2842
2843 CC1Args.push_back(DriverArgs.MakeArgString(OutputLib));
2844}
2845
2846// Wrapper function used by driver for adding SDLs during link phase.
2848 const JobAction &JA,
2849 const InputInfoList &Inputs,
2850 const llvm::opt::ArgList &DriverArgs,
2851 llvm::opt::ArgStringList &CC1Args,
2852 StringRef Arch, StringRef Target,
2853 bool isBitCodeSDL) {
2854 AddStaticDeviceLibs(&C, &T, &JA, &Inputs, C.getDriver(), DriverArgs, CC1Args,
2855 Arch, Target, isBitCodeSDL);
2856}
2857
2858// User defined Static Device Libraries(SDLs) can be passed to clang for
2859// offloading GPU compilers. Like static host libraries, the use of a SDL is
2860// specified with the -l command line option. The primary difference between
2861// host and SDLs is the filenames for SDLs (refer SEARCH-ORDER for Bitcode SDLs
2862// and SEARCH-ORDER for Machine-code SDLs for the naming convention).
2863// SDLs are of following types:
2864//
2865// * Bitcode SDLs: They can either be a *.bc file or an archive of *.bc files.
2866// For NVPTX, these libraries are post-clang linked following each
2867// compilation. For AMDGPU, these libraries are linked one time
2868// during the application link phase.
2869//
2870// * Machine-code SDLs: They are archive files. For AMDGPU, the process for
2871// machine code SDLs is still in development. But they will be linked
2872// by the LLVM tool lld.
2873//
2874// * Bundled objects that contain both host and device codes: Bundled objects
2875// may also contain library code compiled from source. For NVPTX, the
2876// bundle contains cubin. For AMDGPU, the bundle contains bitcode.
2877//
2878// For Bitcode and Machine-code SDLs, current compiler toolchains hardcode the
2879// inclusion of specific SDLs such as math libraries and the OpenMP device
2880// library libomptarget.
2882 const JobAction *JA,
2883 const InputInfoList *Inputs, const Driver &D,
2884 const llvm::opt::ArgList &DriverArgs,
2885 llvm::opt::ArgStringList &CC1Args,
2886 StringRef Arch, StringRef Target,
2887 bool isBitCodeSDL) {
2888
2889 SmallVector<std::string, 8> LibraryPaths;
2890 // Add search directories from LIBRARY_PATH env variable
2891 std::optional<std::string> LibPath =
2892 llvm::sys::Process::GetEnv("LIBRARY_PATH");
2893 if (LibPath) {
2895 const char EnvPathSeparatorStr[] = {llvm::sys::EnvPathSeparator, '\0'};
2896 llvm::SplitString(*LibPath, Frags, EnvPathSeparatorStr);
2897 for (StringRef Path : Frags)
2898 LibraryPaths.emplace_back(Path.trim());
2899 }
2900
2901 // Add directories from user-specified -L options
2902 for (std::string Search_Dir : DriverArgs.getAllArgValues(options::OPT_L))
2903 LibraryPaths.emplace_back(Search_Dir);
2904
2905 // Add path to lib-debug folders
2906 SmallString<256> DefaultLibPath = llvm::sys::path::parent_path(D.Dir);
2907 llvm::sys::path::append(DefaultLibPath, CLANG_INSTALL_LIBDIR_BASENAME);
2908 LibraryPaths.emplace_back(DefaultLibPath.c_str());
2909
2910 // Build list of Static Device Libraries SDLs specified by -l option
2911 llvm::SmallSet<std::string, 16> SDLNames;
2912 static const StringRef HostOnlyArchives[] = {
2913 "omp", "cudart", "m", "gcc", "gcc_s", "pthread", "hip_hcc"};
2914 for (auto SDLName : DriverArgs.getAllArgValues(options::OPT_l)) {
2915 if (!llvm::is_contained(HostOnlyArchives, SDLName)) {
2916 SDLNames.insert(std::string("-l") + SDLName);
2917 }
2918 }
2919
2920 for (auto Input : DriverArgs.getAllArgValues(options::OPT_INPUT)) {
2921 auto FileName = StringRef(Input);
2922 // Clang treats any unknown file types as archives and passes them to the
2923 // linker. Files with extension 'lib' are classified as TY_Object by clang
2924 // but they are usually archives. It is OK if the file is not really an
2925 // archive since GetSDLFromOffloadArchive will check the magic of the file
2926 // and only unbundle it if it is really an archive.
2927 const StringRef LibFileExt = ".lib";
2928 if (!llvm::sys::path::has_extension(FileName) ||
2930 llvm::sys::path::extension(FileName).drop_front()) ==
2932 llvm::sys::path::extension(FileName) == LibFileExt)
2933 SDLNames.insert(Input);
2934 }
2935
2936 // The search stops as soon as an SDL file is found. The driver then provides
2937 // the full filename of the SDL to the llvm-link command. If no SDL is found
2938 // after searching each LINKPATH with SEARCH-ORDER, it is possible that an
2939 // archive file lib<libname>.a exists and may contain bundled object files.
2940 for (auto SDLName : SDLNames) {
2941 // This is the only call to SDLSearch
2942 if (!SDLSearch(D, DriverArgs, CC1Args, LibraryPaths, SDLName, Arch, Target,
2943 isBitCodeSDL)) {
2944 GetSDLFromOffloadArchive(*C, D, *T, *JA, *Inputs, DriverArgs, CC1Args,
2945 LibraryPaths, SDLName, Arch, Target,
2946 isBitCodeSDL);
2947 }
2948 }
2949}
2950
2951static llvm::opt::Arg *
2952getAMDGPUCodeObjectArgument(const Driver &D, const llvm::opt::ArgList &Args) {
2953 return Args.getLastArg(options::OPT_mcode_object_version_EQ);
2954}
2955
2957 const llvm::opt::ArgList &Args) {
2958 const unsigned MinCodeObjVer = 4;
2959 const unsigned MaxCodeObjVer = 6;
2960
2961 if (auto *CodeObjArg = getAMDGPUCodeObjectArgument(D, Args)) {
2962 if (CodeObjArg->getOption().getID() ==
2963 options::OPT_mcode_object_version_EQ) {
2964 unsigned CodeObjVer = MaxCodeObjVer;
2965 auto Remnant =
2966 StringRef(CodeObjArg->getValue()).getAsInteger(0, CodeObjVer);
2967 if (Remnant || CodeObjVer < MinCodeObjVer || CodeObjVer > MaxCodeObjVer)
2968 D.Diag(diag::err_drv_invalid_int_value)
2969 << CodeObjArg->getAsString(Args) << CodeObjArg->getValue();
2970 }
2971 }
2972}
2973
2975 const llvm::opt::ArgList &Args) {
2976 unsigned CodeObjVer = 6; // default
2977 if (auto *CodeObjArg = getAMDGPUCodeObjectArgument(D, Args))
2978 StringRef(CodeObjArg->getValue()).getAsInteger(0, CodeObjVer);
2979 return CodeObjVer;
2980}
2981
2983 const Driver &D, const llvm::opt::ArgList &Args) {
2984 return getAMDGPUCodeObjectArgument(D, Args) != nullptr;
2985}
2986
2988 const llvm::opt::ArgList &Args,
2989 llvm::opt::ArgStringList &CmdArgs,
2990 const llvm::Triple &Triple, bool IsLTO,
2991 const StringRef PluginOptPrefix) {
2992 auto addArg = [&, IsLTO](const Twine &Arg) {
2993 if (IsLTO) {
2994 assert(!PluginOptPrefix.empty() && "Cannot have empty PluginOptPrefix!");
2995 CmdArgs.push_back(Args.MakeArgString(Twine(PluginOptPrefix) + Arg));
2996 } else {
2997 CmdArgs.push_back("-mllvm");
2998 CmdArgs.push_back(Args.MakeArgString(Arg));
2999 }
3000 };
3001
3002 if (Arg *A = Args.getLastArg(options::OPT_moutline,
3003 options::OPT_mno_outline)) {
3004 if (A->getOption().matches(options::OPT_moutline)) {
3005 // We only support -moutline in AArch64, ARM, RISC-V and X86 targets right
3006 // now. If we're compiling for these, add the proper mllvm flags.
3007 // Otherwise, emit a warning and ignore the flag.
3008 if (Triple.isARM() || Triple.isThumb() || Triple.isAArch64() ||
3009 Triple.isRISCV() || Triple.isX86()) {
3010 addArg(Twine("-enable-machine-outliner"));
3011 } else {
3012 D.Diag(diag::warn_drv_moutline_unsupported_opt) << Triple.getArchName();
3013 }
3014 } else {
3015 if (!IsLTO)
3016 // Disable all outlining behaviour using `nooutline` attribute, in case
3017 // Linker Invocation lacks `-mno-outline`.
3018 CmdArgs.push_back("-mno-outline");
3019
3020 // Disable Pass in Pipeline
3021 addArg(Twine("-enable-machine-outliner=never"));
3022 }
3023 }
3024
3025 auto *CodeGenDataGenArg =
3026 Args.getLastArg(options::OPT_fcodegen_data_generate_EQ);
3027 auto *CodeGenDataUseArg = Args.getLastArg(options::OPT_fcodegen_data_use_EQ);
3028
3029 // We only allow one of them to be specified.
3030 if (CodeGenDataGenArg && CodeGenDataUseArg)
3031 D.Diag(diag::err_drv_argument_not_allowed_with)
3032 << CodeGenDataGenArg->getAsString(Args)
3033 << CodeGenDataUseArg->getAsString(Args);
3034
3035 // For codegen data gen, the output file is passed to the linker
3036 // while a boolean flag is passed to the LLVM backend.
3037 if (CodeGenDataGenArg)
3038 addArg(Twine("-codegen-data-generate"));
3039
3040 // For codegen data use, the input file is passed to the LLVM backend.
3041 if (CodeGenDataUseArg)
3042 addArg(Twine("-codegen-data-use-path=") + CodeGenDataUseArg->getValue());
3043}
3044
3046 const llvm::opt::ArgList &DriverArgs,
3047 llvm::opt::ArgStringList &CC1Args,
3048 StringRef BitcodeSuffix,
3049 const llvm::Triple &Triple,
3050 const ToolChain &HostTC) {
3051 SmallVector<StringRef, 8> LibraryPaths;
3052
3053 // Add user defined library paths from LIBRARY_PATH.
3054 std::optional<std::string> LibPath =
3055 llvm::sys::Process::GetEnv("LIBRARY_PATH");
3056 if (LibPath) {
3058 const char EnvPathSeparatorStr[] = {llvm::sys::EnvPathSeparator, '\0'};
3059 llvm::SplitString(*LibPath, Frags, EnvPathSeparatorStr);
3060 for (StringRef Path : Frags)
3061 LibraryPaths.emplace_back(Path.trim());
3062 }
3063
3064 // Check all of the standard library search paths used by the compiler.
3065 for (const auto &LibPath : HostTC.getFilePaths())
3066 LibraryPaths.emplace_back(LibPath);
3067
3068 // Check the target specific library path for the triple as well.
3069 SmallString<128> P(D.Dir);
3070 llvm::sys::path::append(P, "..", "lib", Triple.getTriple());
3071 LibraryPaths.emplace_back(P);
3072
3073 OptSpecifier LibomptargetBCPathOpt =
3074 Triple.isAMDGCN() ? options::OPT_libomptarget_amdgpu_bc_path_EQ
3075 : Triple.isNVPTX() ? options::OPT_libomptarget_nvptx_bc_path_EQ
3076 : options::OPT_libomptarget_spirv_bc_path_EQ;
3077
3078 StringRef ArchPrefix = Triple.isAMDGCN() ? "amdgpu"
3079 : Triple.isNVPTX() ? "nvptx"
3080 : "spirv";
3081 std::string LibOmpTargetName = ("libomptarget-" + ArchPrefix + ".bc").str();
3082
3083 // First check whether user specifies bc library
3084 if (const Arg *A = DriverArgs.getLastArg(LibomptargetBCPathOpt)) {
3085 SmallString<128> LibOmpTargetFile(A->getValue());
3086 if (llvm::sys::fs::exists(LibOmpTargetFile) &&
3087 llvm::sys::fs::is_directory(LibOmpTargetFile)) {
3088 llvm::sys::path::append(LibOmpTargetFile, LibOmpTargetName);
3089 }
3090
3091 if (llvm::sys::fs::exists(LibOmpTargetFile)) {
3092 CC1Args.push_back("-mlink-builtin-bitcode");
3093 CC1Args.push_back(DriverArgs.MakeArgString(LibOmpTargetFile));
3094 } else {
3095 D.Diag(diag::err_drv_omp_offload_target_bcruntime_not_found)
3096 << LibOmpTargetFile;
3097 }
3098 } else {
3099 bool FoundBCLibrary = false;
3100
3101 for (StringRef LibraryPath : LibraryPaths) {
3102 SmallString<128> LibOmpTargetFile(LibraryPath);
3103 llvm::sys::path::append(LibOmpTargetFile, LibOmpTargetName);
3104 if (llvm::sys::fs::exists(LibOmpTargetFile)) {
3105 CC1Args.push_back("-mlink-builtin-bitcode");
3106 CC1Args.push_back(DriverArgs.MakeArgString(LibOmpTargetFile));
3107 FoundBCLibrary = true;
3108 break;
3109 }
3110 }
3111
3112 if (!FoundBCLibrary)
3113 D.Diag(diag::err_drv_omp_offload_target_missingbcruntime)
3114 << LibOmpTargetName << ArchPrefix;
3115 }
3116}
3117
3118void tools::addOpenCLBuiltinsLib(const Driver &D, const llvm::Triple &TT,
3119 const llvm::opt::ArgList &DriverArgs,
3120 llvm::opt::ArgStringList &CC1Args) {
3121
3122 StringRef LibclcNamespec;
3123 const Arg *A = DriverArgs.getLastArg(options::OPT_libclc_lib_EQ);
3124 if (A) {
3125 // If the namespec is of the form :filename we use it exactly.
3126 LibclcNamespec = A->getValue();
3127 } else {
3128 if (!TT.isAMDGPU() || TT.getEnvironment() != llvm::Triple::LLVM)
3129 return;
3130
3131 // TODO: Should this accept following -stdlib to override?
3132 if (DriverArgs.hasArg(options::OPT_no_offloadlib,
3133 options::OPT_nodefaultlibs, options::OPT_nostdlib))
3134 return;
3135 }
3136
3137 bool FilenameSearch = LibclcNamespec.consume_front(":");
3138 if (FilenameSearch) {
3139 SmallString<128> LibclcFile(LibclcNamespec);
3140 if (D.getVFS().exists(LibclcFile)) {
3141 CC1Args.push_back("-mlink-builtin-bitcode");
3142 CC1Args.push_back(DriverArgs.MakeArgString(LibclcFile));
3143 return;
3144 }
3145 D.Diag(diag::err_drv_libclc_not_found) << LibclcFile;
3146 return;
3147 }
3148
3149 // The OpenCL libraries are stored in <ResourceDir>/lib/<triple>.
3150 SmallString<128> BasePath(D.ResourceDir);
3151 llvm::sys::path::append(BasePath, "lib");
3152 llvm::sys::path::append(BasePath, D.getTargetTriple());
3153
3154 // First check for a CPU-specific library in <ResourceDir>/lib/<triple>/<CPU>.
3155 // TODO: Factor this into common logic that checks for valid subtargets.
3156 if (const Arg *CPUArg = DriverArgs.getLastArg(options::OPT_mcpu_EQ)) {
3157 StringRef CPU = CPUArg->getValue();
3158 if (!CPU.empty()) {
3159 SmallString<128> CPUPath(BasePath);
3160 llvm::sys::path::append(CPUPath, CPU, "libclc.bc");
3161 if (D.getVFS().exists(CPUPath)) {
3162 CC1Args.push_back("-mlink-builtin-bitcode");
3163 CC1Args.push_back(DriverArgs.MakeArgString(CPUPath));
3164 return;
3165 }
3166 }
3167 }
3168
3169 // Fall back to the generic library for the triple.
3170 SmallString<128> GenericPath(BasePath);
3171 llvm::sys::path::append(GenericPath, "libclc.bc");
3172 if (D.getVFS().exists(GenericPath)) {
3173 CC1Args.push_back("-mlink-builtin-bitcode");
3174 CC1Args.push_back(DriverArgs.MakeArgString(GenericPath));
3175 return;
3176 }
3177
3178 D.Diag(diag::err_drv_libclc_not_found) << "libclc.bc";
3179}
3180
3182 const llvm::opt::ArgList &Args,
3183 llvm::opt::ArgStringList &CmdArgs,
3184 const llvm::Triple &Triple) {
3185 if (Arg *A = Args.getLastArg(options::OPT_moutline_atomics,
3186 options::OPT_mno_outline_atomics)) {
3187 // Option -moutline-atomics supported for AArch64 target only.
3188 if (!Triple.isAArch64()) {
3189 D.Diag(diag::warn_drv_moutline_atomics_unsupported_opt)
3190 << Triple.getArchName() << A->getOption().getName();
3191 } else {
3192 if (A->getOption().matches(options::OPT_moutline_atomics)) {
3193 CmdArgs.push_back("-target-feature");
3194 CmdArgs.push_back("+outline-atomics");
3195 } else {
3196 CmdArgs.push_back("-target-feature");
3197 CmdArgs.push_back("-outline-atomics");
3198 }
3199 }
3200 } else if (Triple.isAArch64() && TC.IsAArch64OutlineAtomicsDefault(Args)) {
3201 CmdArgs.push_back("-target-feature");
3202 CmdArgs.push_back("+outline-atomics");
3203 }
3204}
3205
3206void tools::addOffloadCompressArgs(const llvm::opt::ArgList &TCArgs,
3207 llvm::opt::ArgStringList &CmdArgs) {
3208 if (TCArgs.hasFlag(options::OPT_offload_compress,
3209 options::OPT_no_offload_compress, false))
3210 CmdArgs.push_back("--compress");
3211 if (TCArgs.hasArg(options::OPT_v))
3212 CmdArgs.push_back("--verbose");
3213 if (auto *Arg = TCArgs.getLastArg(options::OPT_offload_compression_level_EQ))
3214 CmdArgs.push_back(
3215 TCArgs.MakeArgString(Twine("--compression-level=") + Arg->getValue()));
3216}
3217
3218void tools::addMCModel(const Driver &D, const llvm::opt::ArgList &Args,
3219 const llvm::Triple &Triple,
3220 const llvm::Reloc::Model &RelocationModel,
3221 llvm::opt::ArgStringList &CmdArgs) {
3222 if (Arg *A = Args.getLastArg(options::OPT_mcmodel_EQ)) {
3223 StringRef CM = A->getValue();
3224 bool Ok = false;
3225 if (Triple.isOSAIX() && CM == "medium")
3226 CM = "large";
3227 if (Triple.isAArch64(64)) {
3228 Ok = CM == "tiny" || CM == "small" || CM == "large";
3229 if (CM == "large" && !Triple.isOSBinFormatMachO() &&
3230 RelocationModel != llvm::Reloc::Static)
3231 D.Diag(diag::err_drv_argument_only_allowed_with)
3232 << A->getAsString(Args) << "-fno-pic";
3233 } else if (Triple.isLoongArch()) {
3234 if (CM == "extreme" &&
3235 Args.hasFlagNoClaim(options::OPT_fplt, options::OPT_fno_plt, false))
3236 D.Diag(diag::err_drv_argument_not_allowed_with)
3237 << A->getAsString(Args) << "-fplt";
3238 Ok = CM == "normal" || CM == "medium" || CM == "extreme";
3239 // Convert to LLVM recognizable names.
3240 if (Ok)
3241 CM = llvm::StringSwitch<StringRef>(CM)
3242 .Case("normal", "small")
3243 .Case("extreme", "large")
3244 .Default(CM);
3245 } else if (Triple.isPPC64() || Triple.isOSAIX()) {
3246 Ok = CM == "small" || CM == "medium" || CM == "large";
3247 } else if (Triple.isRISCV()) {
3248 // Large code model is disallowed to be used with PIC code model.
3249 if (CM == "large" && RelocationModel != llvm::Reloc::Static)
3250 D.Diag(diag::err_drv_argument_not_allowed_with)
3251 << A->getAsString(Args) << "-fpic";
3252 if (CM == "medlow")
3253 CM = "small";
3254 else if (CM == "medany")
3255 CM = "medium";
3256 Ok = CM == "small" || CM == "medium" ||
3257 (CM == "large" && Triple.isRISCV64());
3258 } else if (Triple.getArch() == llvm::Triple::x86_64) {
3259 Ok = llvm::is_contained({"small", "kernel", "medium", "large"}, CM);
3260 } else if (Triple.isNVPTX() || Triple.isAMDGPU() || Triple.isSPIRV()) {
3261 // NVPTX/AMDGPU/SPIRV does not care about the code model and will accept
3262 // whatever works for the host.
3263 Ok = true;
3264 } else if (Triple.isSPARC64()) {
3265 if (CM == "medlow")
3266 CM = "small";
3267 else if (CM == "medmid")
3268 CM = "medium";
3269 else if (CM == "medany")
3270 CM = "large";
3271 Ok = CM == "small" || CM == "medium" || CM == "large";
3272 } else if (Triple.getArch() == llvm::Triple::lanai) {
3273 Ok = llvm::is_contained({"small", "medium", "large"}, CM);
3274 }
3275 if (Ok) {
3276 CmdArgs.push_back(Args.MakeArgString("-mcmodel=" + CM));
3277 } else {
3278 D.Diag(diag::err_drv_unsupported_option_argument_for_target)
3279 << A->getSpelling() << CM << Triple.getTriple();
3280 }
3281 }
3282
3283 if (Triple.getArch() == llvm::Triple::x86_64) {
3284 bool IsMediumCM = false;
3285 bool IsLargeCM = false;
3286 if (Arg *A = Args.getLastArg(options::OPT_mcmodel_EQ)) {
3287 IsMediumCM = StringRef(A->getValue()) == "medium";
3288 IsLargeCM = StringRef(A->getValue()) == "large";
3289 }
3290 if (Arg *A = Args.getLastArg(options::OPT_mlarge_data_threshold_EQ)) {
3291 if (!IsMediumCM && !IsLargeCM) {
3292 D.Diag(diag::warn_drv_large_data_threshold_invalid_code_model)
3293 << A->getOption().getRenderName();
3294 } else {
3295 A->render(Args, CmdArgs);
3296 }
3297 } else if (IsMediumCM) {
3298 CmdArgs.push_back("-mlarge-data-threshold=65536");
3299 } else if (IsLargeCM) {
3300 CmdArgs.push_back("-mlarge-data-threshold=0");
3301 }
3302 }
3303}
3304
3305void tools::handleColorDiagnosticsArgs(const Driver &D, const ArgList &Args,
3306 ArgStringList &CmdArgs) {
3307 // Color diagnostics are parsed by the driver directly from argv and later
3308 // re-parsed to construct this job; claim any possible color diagnostic here
3309 // to avoid warn_drv_unused_argument and diagnose bad
3310 // OPT_fdiagnostics_color_EQ values.
3311 Args.getLastArg(options::OPT_fcolor_diagnostics,
3312 options::OPT_fno_color_diagnostics);
3313 if (const Arg *A = Args.getLastArg(options::OPT_fdiagnostics_color_EQ)) {
3314 StringRef Value(A->getValue());
3315 if (Value != "always" && Value != "never" && Value != "auto")
3316 D.Diag(diag::err_drv_invalid_argument_to_option)
3317 << Value << A->getOption().getName();
3318 }
3319
3320 switch (D.getDiags().getDiagnosticOptions().getShowColors()) {
3321 case ShowColorsKind::On:
3322 CmdArgs.push_back("-fcolor-diagnostics");
3323 break;
3325 CmdArgs.push_back("-fno-color-diagnostics");
3326 break;
3328 break;
3329 }
3330}
3331
3334 for (; *Arg; ++Arg) {
3335 switch (*Arg) {
3336 default:
3337 break;
3338 case ' ':
3339 case '\\':
3340 Res.push_back('\\');
3341 break;
3342 }
3343 Res.push_back(*Arg);
3344 }
3345}
3346
3348 const llvm::opt::ArgList &Args) {
3349 const Driver &D = TC.getDriver();
3350 const char *Exec = D.getDriverProgramPath();
3351
3352 llvm::opt::ArgStringList OriginalArgs;
3353 for (const auto &Arg : Args)
3354 Arg->render(Args, OriginalArgs);
3355
3357 escapeSpacesAndBackslashes(Exec, Flags);
3358 for (const char *OriginalArg : OriginalArgs) {
3359 llvm::SmallString<128> EscapedArg;
3360 escapeSpacesAndBackslashes(OriginalArg, EscapedArg);
3361 Flags += " ";
3362 Flags += EscapedArg;
3363 }
3364
3365 return Args.MakeArgString(Flags);
3366}
3367
3369 const llvm::opt::ArgList &Args,
3370 bool &FRecordCommandLine,
3371 bool &GRecordCommandLine,
3372 bool &DXRecordCommandLine) {
3373 const Driver &D = TC.getDriver();
3374 const llvm::Triple &Triple = TC.getEffectiveTriple();
3375 const std::string &TripleStr = Triple.getTriple();
3376
3377 FRecordCommandLine =
3378 Args.hasFlag(options::OPT_frecord_command_line,
3379 options::OPT_fno_record_command_line, false);
3380 GRecordCommandLine =
3381 Args.hasFlag(options::OPT_grecord_command_line,
3382 options::OPT_gno_record_command_line, false);
3383 DXRecordCommandLine = Triple.isDXIL() && Args.hasArg(options::OPT_g_Flag);
3384 if (FRecordCommandLine && !Triple.isOSBinFormatELF() &&
3385 !Triple.isOSBinFormatXCOFF() && !Triple.isOSBinFormatMachO())
3386 D.Diag(diag::err_drv_unsupported_opt_for_target)
3387 << Args.getLastArg(options::OPT_frecord_command_line)->getAsString(Args)
3388 << TripleStr;
3389
3390 return FRecordCommandLine || TC.UseDwarfDebugFlags() || GRecordCommandLine ||
3391 DXRecordCommandLine;
3392}
3393
3394void tools::renderGlobalISelOptions(const Driver &D, const ArgList &Args,
3395 ArgStringList &CmdArgs,
3396 const llvm::Triple &Triple) {
3397 if (Arg *A = Args.getLastArg(options::OPT_fglobal_isel,
3398 options::OPT_fno_global_isel)) {
3399 CmdArgs.push_back("-mllvm");
3400 if (A->getOption().matches(options::OPT_fglobal_isel)) {
3401 CmdArgs.push_back("-global-isel=1");
3402
3403 // GISel is on by default on AArch64 -O0, so don't bother adding
3404 // the fallback remarks for it. Other combinations will add a warning of
3405 // some kind.
3406 bool IsArchSupported = Triple.getArch() == llvm::Triple::aarch64;
3407 bool IsOptLevelSupported = false;
3408
3409 Arg *A = Args.getLastArg(options::OPT_O_Group);
3410 if (IsArchSupported) {
3411 if (!A || A->getOption().matches(options::OPT_O0))
3412 IsOptLevelSupported = true;
3413 }
3414 if (!IsArchSupported || !IsOptLevelSupported) {
3415 CmdArgs.push_back("-mllvm");
3416 CmdArgs.push_back("-global-isel-abort=2");
3417
3418 if (!IsArchSupported)
3419 D.Diag(diag::warn_drv_global_isel_incomplete) << Triple.getArchName();
3420 else
3421 D.Diag(diag::warn_drv_global_isel_incomplete_opt);
3422 }
3423 } else {
3424 CmdArgs.push_back("-global-isel=0");
3425 }
3426 }
3427}
3428
3429void tools::renderCommonIntegerOverflowOptions(const ArgList &Args,
3430 ArgStringList &CmdArgs,
3431 bool IsMSVCCompat) {
3432 bool use_fwrapv = IsMSVCCompat;
3433 bool use_fwrapv_pointer = false;
3434 for (const Arg *A : Args.filtered(
3435 options::OPT_fstrict_overflow, options::OPT_fno_strict_overflow,
3436 options::OPT_fwrapv, options::OPT_fno_wrapv,
3437 options::OPT_fwrapv_pointer, options::OPT_fno_wrapv_pointer)) {
3438 A->claim();
3439 switch (A->getOption().getID()) {
3440 case options::OPT_fstrict_overflow:
3441 use_fwrapv = false;
3442 use_fwrapv_pointer = false;
3443 break;
3444 case options::OPT_fno_strict_overflow:
3445 use_fwrapv = true;
3446 use_fwrapv_pointer = true;
3447 break;
3448 case options::OPT_fwrapv:
3449 use_fwrapv = true;
3450 break;
3451 case options::OPT_fno_wrapv:
3452 use_fwrapv = false;
3453 break;
3454 case options::OPT_fwrapv_pointer:
3455 use_fwrapv_pointer = true;
3456 break;
3457 case options::OPT_fno_wrapv_pointer:
3458 use_fwrapv_pointer = false;
3459 break;
3460 }
3461 }
3462
3463 if (use_fwrapv)
3464 CmdArgs.push_back("-fwrapv");
3465 if (!use_fwrapv && IsMSVCCompat)
3466 CmdArgs.push_back("-fno-wrapv");
3467 if (use_fwrapv_pointer)
3468 CmdArgs.push_back("-fwrapv-pointer");
3469}
3470
3471/// Vectorize at all optimization levels greater than 1 except for -Oz.
3472/// For -Oz the loop vectorizer is disabled, while the slp vectorizer is
3473/// enabled.
3474bool tools::shouldEnableVectorizerAtOLevel(const ArgList &Args, bool isSlpVec) {
3475 if (Arg *A = Args.getLastArg(options::OPT_O_Group)) {
3476 if (A->getOption().matches(options::OPT_O4) ||
3477 A->getOption().matches(options::OPT_Ofast))
3478 return true;
3479
3480 if (A->getOption().matches(options::OPT_O0))
3481 return false;
3482
3483 assert(A->getOption().matches(options::OPT_O) && "Must have a -O flag");
3484
3485 // Vectorize -Os.
3486 StringRef S(A->getValue());
3487 if (S == "s")
3488 return true;
3489
3490 // Don't vectorize -Oz, unless it's the slp vectorizer.
3491 if (S == "z")
3492 return isSlpVec;
3493
3494 unsigned OptLevel = 0;
3495 if (S.getAsInteger(10, OptLevel))
3496 return false;
3497
3498 return OptLevel > 1;
3499 }
3500
3501 return false;
3502}
3503
3504void tools::handleVectorizeLoopsArgs(const ArgList &Args,
3505 ArgStringList &CmdArgs) {
3506 bool EnableVec = shouldEnableVectorizerAtOLevel(Args, false);
3507 if (Args.hasFlag(options::OPT_fvectorize, options::OPT_fno_vectorize,
3508 EnableVec))
3509 CmdArgs.push_back("-vectorize-loops");
3510}
3511
3512void tools::handleVectorizeSLPArgs(const ArgList &Args,
3513 ArgStringList &CmdArgs) {
3514 bool EnableSLPVec = shouldEnableVectorizerAtOLevel(Args, true);
3515 if (Args.hasFlag(options::OPT_fslp_vectorize, options::OPT_fno_slp_vectorize,
3516 EnableSLPVec))
3517 CmdArgs.push_back("-vectorize-slp");
3518}
3519
3520void tools::handleInterchangeLoopsArgs(const ArgList &Args,
3521 ArgStringList &CmdArgs) {
3522 if (Args.hasFlag(options::OPT_floop_interchange,
3523 options::OPT_fno_loop_interchange, false))
3524 CmdArgs.push_back("-floop-interchange");
3525}
3526
3528 switch (Range) {
3530 return "full";
3531 break;
3533 return "basic";
3534 break;
3536 return "improved";
3537 break;
3539 return "promoted";
3540 break;
3542 return "none";
3543 break;
3544 }
3545 llvm_unreachable("Fully covered switch above");
3546}
3547
3548std::string
3550 std::string ComplexRangeStr = complexRangeKindToStr(Range);
3551 if (!ComplexRangeStr.empty())
3552 return "-complex-range=" + ComplexRangeStr;
3553 return ComplexRangeStr;
3554}
3555
3556static void emitComplexRangeDiag(const Driver &D, StringRef LastOpt,
3558 StringRef NewOpt,
3560 // Do not emit a warning if NewOpt overrides LastOpt in the following cases.
3561 //
3562 // | LastOpt | NewOpt |
3563 // |-----------------------|-----------------------|
3564 // | -fcx-limited-range | -fno-cx-limited-range |
3565 // | -fno-cx-limited-range | -fcx-limited-range |
3566 // | -fcx-fortran-rules | -fno-cx-fortran-rules |
3567 // | -fno-cx-fortran-rules | -fcx-fortran-rules |
3568 // | -ffast-math | -fno-fast-math |
3569 // | -ffp-model= | -ffast-math |
3570 // | -ffp-model= | -fno-fast-math |
3571 // | -ffp-model= | -ffp-model= |
3572 // | -fcomplex-arithmetic= | -fcomplex-arithmetic= |
3573 if (LastOpt == NewOpt || NewOpt.empty() || LastOpt.empty() ||
3574 (LastOpt == "-fcx-limited-range" && NewOpt == "-fno-cx-limited-range") ||
3575 (LastOpt == "-fno-cx-limited-range" && NewOpt == "-fcx-limited-range") ||
3576 (LastOpt == "-fcx-fortran-rules" && NewOpt == "-fno-cx-fortran-rules") ||
3577 (LastOpt == "-fno-cx-fortran-rules" && NewOpt == "-fcx-fortran-rules") ||
3578 (LastOpt == "-ffast-math" && NewOpt == "-fno-fast-math") ||
3579 (LastOpt.starts_with("-ffp-model=") && NewOpt == "-ffast-math") ||
3580 (LastOpt.starts_with("-ffp-model=") && NewOpt == "-fno-fast-math") ||
3581 (LastOpt.starts_with("-ffp-model=") &&
3582 NewOpt.starts_with("-ffp-model=")) ||
3583 (LastOpt.starts_with("-fcomplex-arithmetic=") &&
3584 NewOpt.starts_with("-fcomplex-arithmetic=")))
3585 return;
3586
3587 D.Diag(clang::diag::warn_drv_overriding_complex_range)
3588 << LastOpt << NewOpt << complexRangeKindToStr(Range)
3589 << complexRangeKindToStr(NewRange);
3590}
3591
3592void tools::setComplexRange(const Driver &D, StringRef NewOpt,
3594 StringRef &LastOpt,
3596 // Warn if user overrides the previously set complex number
3597 // multiplication/division option.
3598 if (Range != LangOptions::ComplexRangeKind::CX_None && Range != NewRange)
3599 emitComplexRangeDiag(D, LastOpt, Range, NewOpt, NewRange);
3600 LastOpt = NewOpt;
3601 Range = NewRange;
3602}
3603
3605 const JobAction &JA,
3606 const InputInfoList &JobInputs,
3607 const ArgStringList &LinkerInputs,
3608 const InputInfo &Output,
3609 const llvm::opt::ArgList &Args,
3610 const char *OutputFilename) {
3611 // Construct llvm-link command.
3612 // The output from llvm-link is a bitcode file.
3613
3614 assert(!LinkerInputs.empty() && !JobInputs.empty() &&
3615 "Must have at least one input.");
3616
3617 ArgStringList LlvmLinkArgs(
3618 {"-o", OutputFilename ? OutputFilename : Output.getFilename()});
3619
3620 LlvmLinkArgs.append(LinkerInputs);
3621
3622 const ToolChain &TC = T.getToolChain();
3623 const char *LlvmLink = Args.MakeArgString(TC.GetProgramPath("llvm-link"));
3624 C.addCommand(std::make_unique<Command>(JA, T, ResponseFileSupport::None(),
3625 LlvmLink, LlvmLinkArgs, JobInputs,
3626 Output));
3627}
#define V(N, I)
static bool useLeafFramePointerForTargetByDefault(const llvm::Triple &Triple)
static unsigned ParseDebugDefaultVersion(const ToolChain &TC, const ArgList &Args)
static void getWebAssemblyTargetFeatures(const Driver &D, const llvm::Triple &Triple, const ArgList &Args, std::vector< StringRef > &Features)
LibGccType
static void emitComplexRangeDiag(const Driver &D, StringRef LastOpt, LangOptions::ComplexRangeKind Range, StringRef NewOpt, LangOptions::ComplexRangeKind NewRange)
static bool addSanitizerDynamicList(const ToolChain &TC, const ArgList &Args, ArgStringList &CmdArgs, StringRef Sanitizer)
static bool mustMaintainValidFrameChain(const llvm::opt::ArgList &Args, const llvm::Triple &Triple)
static llvm::opt::Arg * getAMDGPUCodeObjectArgument(const Driver &D, const llvm::opt::ArgList &Args)
static void collectSanitizerRuntimes(const ToolChain &TC, const ArgList &Args, SmallVectorImpl< StringRef > &SharedRuntimes, SmallVectorImpl< StringRef > &StaticRuntimes, SmallVectorImpl< StringRef > &NonWholeStaticRuntimes, SmallVectorImpl< StringRef > &HelperStaticRuntimes, SmallVectorImpl< StringRef > &RequiredSymbols)
static void addSanitizerRuntime(const ToolChain &TC, const ArgList &Args, ArgStringList &CmdArgs, StringRef Sanitizer, bool IsShared, bool IsWhole)
static void AddUnwindLibrary(const ToolChain &TC, const Driver &D, ArgStringList &CmdArgs, const ArgList &Args)
static bool SDLSearch(const Driver &D, const llvm::opt::ArgList &DriverArgs, llvm::opt::ArgStringList &CC1Args, const SmallVectorImpl< std::string > &LibraryPaths, StringRef Lib, StringRef Arch, StringRef Target, bool isBitCodeSDL)
SDLSearch: Search for Static Device Library The search for SDL bitcode files is consistent with how s...
static void renderRpassOptions(const ArgList &Args, ArgStringList &CmdArgs, const StringRef PluginOptPrefix)
static StringRef getWebAssemblyTargetCPU(const ArgList &Args)
Get the (LLVM) name of the WebAssembly cpu we are targeting.
static bool framePointerImpliesLeafFramePointer(const llvm::opt::ArgList &Args, const llvm::Triple &Triple)
static void renderRemarksHotnessOptions(const ArgList &Args, ArgStringList &CmdArgs, const StringRef PluginOptPrefix)
static void GetSDLFromOffloadArchive(Compilation &C, const Driver &D, const Tool &T, const JobAction &JA, const InputInfoList &Inputs, const llvm::opt::ArgList &DriverArgs, llvm::opt::ArgStringList &CC1Args, const SmallVectorImpl< std::string > &LibraryPaths, StringRef Lib, StringRef Arch, StringRef Target, bool isBitCodeSDL)
Search if a user provided archive file lib<libname>.a exists in any of the library paths.
static std::string getLanaiTargetCPU(const ArgList &Args)
static void renderRemarksOptions(const ArgList &Args, ArgStringList &CmdArgs, const llvm::Triple &Triple, const InputInfo &Input, const InputInfo &Output, const StringRef PluginOptPrefix)
static bool useFramePointerForTargetByDefault(const llvm::opt::ArgList &Args, const llvm::Triple &Triple)
static void AddLibgcc(const ToolChain &TC, const Driver &D, ArgStringList &CmdArgs, const ArgList &Args)
static LibGccType getLibGccType(const ToolChain &TC, const Driver &D, const ArgList &Args)
clang::CodeGenOptions::FramePointerKind getFramePointerKind(const llvm::opt::ArgList &Args, const llvm::Triple &Triple)
static std::string getAMDGPUTargetGPU(const llvm::Triple &T, const ArgList &Args)
Get the (LLVM) name of the AMDGPU gpu we are targeting.
static bool mustUseNonLeafFramePointerForTarget(const llvm::Triple &Triple)
static bool shouldIgnoreUnsupportedTargetFeature(const Arg &TargetFeatureArg, llvm::Triple T, StringRef Processor)
llvm::MachO::Target Target
Definition MachO.h:51
DiagnosticBuilder Report(SourceLocation Loc, unsigned DiagID)
Issue the message to the client.
DiagnosticOptions & getDiagnosticOptions() const
Retrieve the diagnostic options.
Definition Diagnostic.h:604
The kind of a file that we've been handed as an input.
ComplexRangeKind
Controls the various implementations for complex multiplication and.
@ CX_Full
Implementation of complex division and multiplication using a call to runtime library functions(gener...
@ CX_Basic
Implementation of complex division and multiplication using algebraic formulas at source precision.
@ CX_Promoted
Implementation of complex division using algebraic formulas at higher precision.
@ CX_None
No range rule is enabled.
@ CX_Improved
Implementation of complex division offering an improved handling for overflow in intermediate calcula...
BoundArch getOffloadingArch() const
Definition Action.h:217
static StringRef GetOffloadKindName(OffloadKind Kind)
Return a string containing a offload kind name.
Definition Action.cpp:164
OffloadKind getOffloadingDeviceKind() const
Definition Action.h:216
bool isHostOffloading(unsigned int OKind) const
Check if this action have any offload kinds.
Definition Action.h:224
Compilation - A set of tasks to perform for a single driver invocation.
Definition Compilation.h:46
Driver - Encapsulate logic for constructing compilation processes from a set of gcc-driver-like comma...
Definition Driver.h:95
std::string CCPrintInternalStatReportFilename
The file to log CC_PRINT_INTERNAL_STAT_FILE output to, if enabled.
Definition Driver.h:210
DiagnosticsEngine & getDiags() const
Definition Driver.h:409
const char * getPrependArg() const
Definition Driver.h:420
OpenMPRuntimeKind getOpenMPRuntime(const llvm::opt::ArgList &Args) const
Compute the desired OpenMP runtime from the flags provided.
Definition Driver.cpp:853
DiagnosticBuilder Diag(unsigned DiagID) const
Definition Driver.h:159
unsigned CCPrintInternalStats
Set CC_PRINT_INTERNAL_STAT mode, which causes the driver to dump internal performance report to CC_PR...
Definition Driver.h:283
const llvm::opt::OptTable & getOpts() const
Definition Driver.h:407
const char * getDriverProgramPath() const
Get the path to the main driver executable.
Definition Driver.h:431
std::string ResourceDir
The path to the compiler resource directory.
Definition Driver.h:179
llvm::vfs::FileSystem & getVFS() const
Definition Driver.h:411
std::string GetTemporaryPath(StringRef Prefix, StringRef Suffix) const
GetTemporaryPath - Return the pathname of a temporary file to use as part of compilation; the file wi...
Definition Driver.cpp:6937
std::string Dir
The path the driver executable was in, as invoked from the command line.
Definition Driver.h:170
@ OMPRT_IOMP5
The legacy name for the LLVM OpenMP runtime from when it was the Intel OpenMP runtime.
Definition Driver.h:155
@ OMPRT_OMP
The LLVM OpenMP runtime.
Definition Driver.h:145
@ OMPRT_Unknown
An unknown OpenMP runtime.
Definition Driver.h:141
@ OMPRT_GOMP
The GNU OpenMP runtime.
Definition Driver.h:150
std::string getTargetTriple() const
Definition Driver.h:428
bool IsFlangMode() const
Whether the driver should invoke flang for fortran inputs.
Definition Driver.h:235
bool CCCIsCXX() const
Whether the driver should follow g++ like behavior.
Definition Driver.h:222
InputInfo - Wrapper for information about an input source.
Definition InputInfo.h:22
const char * getBaseInput() const
Definition InputInfo.h:78
const char * getFilename() const
Definition InputInfo.h:83
bool isFilename() const
Definition InputInfo.h:75
This corresponds to a single GCC Multilib, or a segment of one controlled by a command line flag.
Definition Multilib.h:35
std::vector< std::string > flags_list
Definition Multilib.h:37
const std::string & getMemtagMode() const
ToolChain - Access to tools for a single platform.
Definition ToolChain.h:96
virtual void AddCCKextLibArgs(const llvm::opt::ArgList &Args, llvm::opt::ArgStringList &CmdArgs) const
AddCCKextLibArgs - Add the system specific linker arguments to use for kernel extensions (Darwin-spec...
virtual bool useIntegratedAs() const
Check if the toolchain should use the integrated assembler.
std::optional< std::string > getStdlibPath() const
virtual unsigned GetDefaultDwarfVersion() const
Definition ToolChain.h:662
virtual RuntimeLibType GetRuntimeLibType(const llvm::opt::ArgList &Args) const
path_list & getFilePaths()
Definition ToolChain.h:326
virtual bool supportsDebugInfoOption(const llvm::opt::Arg *) const
Does this toolchain supports given debug info option or not.
Definition ToolChain.h:685
llvm::Triple::ArchType getArch() const
Definition ToolChain.h:302
const Driver & getDriver() const
Definition ToolChain.h:286
llvm::vfs::FileSystem & getVFS() const
virtual std::string getCompilerRT(const llvm::opt::ArgList &Args, StringRef Component, FileType Type=ToolChain::FT_Static, bool IsFortran=false) const
virtual bool isPIEDefault(const llvm::opt::ArgList &Args) const =0
Test whether this toolchain defaults to PIE.
virtual bool isPICDefaultForced() const =0
Tests whether this toolchain forces its default for PIC, PIE or non-PIC.
const llvm::Triple & getEffectiveTriple() const
Get the toolchain's effective clang triple.
Definition ToolChain.h:314
virtual void AddCXXStdlibLibArgs(const llvm::opt::ArgList &Args, llvm::opt::ArgStringList &CmdArgs) const
AddCXXStdlibLibArgs - Add the system specific linker arguments to use for the given C++ standard libr...
const llvm::Triple & getTriple() const
Definition ToolChain.h:288
virtual bool HasNativeLLVMSupport() const
HasNativeLTOLinker - Check whether the linker and related tools have native LLVM support.
const llvm::SmallVector< Multilib > & getSelectedMultilibs() const
Definition ToolChain.h:334
virtual UnwindLibType GetUnwindLibType(const llvm::opt::ArgList &Args) const
const XRayArgs getXRayArgs(const llvm::opt::ArgList &) const
StringRef getTripleString() const
Definition ToolChain.h:311
std::string GetLinkerPath(bool *LinkerIsLLD=nullptr) const
Returns the linker path, respecting the -fuse-ld= argument to determine the linker suffix or name.
std::string GetProgramPath(const char *Name) const
virtual bool UseDwarfDebugFlags() const
UseDwarfDebugFlags - Embed the compile options to clang into the Dwarf compile unit information.
Definition ToolChain.h:655
virtual bool IsAArch64OutlineAtomicsDefault(const llvm::opt::ArgList &Args) const
Test whether this toolchain supports outline atomics by default.
Definition ToolChain.h:626
SanitizerArgs getSanitizerArgs(const llvm::opt::ArgList &JobArgs, BoundArch BA={}, Action::OffloadKind DeviceOffloadKind=Action::OFK_None) const
const char * getCompilerRTArgString(const llvm::opt::ArgList &Args, StringRef Component, FileType Type=ToolChain::FT_Static, bool IsFortran=false) const
virtual path_list getArchSpecificLibPaths() const
virtual bool isCrossCompiling() const
Returns true if the toolchain is targeting a non-native architecture.
virtual bool isPICDefault() const =0
Test whether this toolchain defaults to PIC.
SmallVector< std::string, 16 > path_list
Definition ToolChain.h:98
Tool - Information on a specific compilation tool.
Definition Tool.h:32
bool needsXRayDSORt() const
Definition XRayArgs.h:39
bool needsXRayRt() const
Definition XRayArgs.h:38
llvm::ArrayRef< std::string > modeList() const
Definition XRayArgs.h:40
static StringRef GetTargetCPUVersion(const llvm::opt::ArgList &Args)
Definition Hexagon.cpp:985
void getNVPTXTargetFeatures(const Driver &D, const llvm::Triple &Triple, const llvm::opt::ArgList &Args, std::vector< StringRef > &Features)
Definition Cuda.cpp:675
bool isAArch64BareMetal(const llvm::Triple &Triple)
Is the triple {aarch64.aarch64_be}-none-elf?
Definition AArch64.cpp:553
void getAArch64TargetFeatures(const Driver &D, const llvm::Triple &Triple, const llvm::opt::ArgList &Args, std::vector< llvm::StringRef > &Features, bool ForAS, bool ForMultilib=false)
std::string getAArch64TargetCPU(const llvm::opt::ArgList &Args, const llvm::Triple &Triple, llvm::opt::Arg *&A)
void getAMDGPUTargetFeatures(const Driver &D, const llvm::Triple &Triple, const llvm::opt::ArgList &Args, std::vector< StringRef > &Features)
Definition AMDGPU.cpp:660
void getARMArchCPUFromArgs(const llvm::opt::ArgList &Args, llvm::StringRef &Arch, llvm::StringRef &CPU, bool FromAs=false)
bool isARMEABIBareMetal(const llvm::Triple &Triple)
Is the triple {arm,armeb,thumb,thumbeb}-none-none-{eabi,eabihf} ?
Definition ARM.cpp:55
std::string getARMTargetCPU(StringRef CPU, llvm::StringRef Arch, const llvm::Triple &Triple)
bool isARMBigEndian(const llvm::Triple &Triple, const llvm::opt::ArgList &Args)
llvm::ARM::FPUKind getARMTargetFeatures(const Driver &D, const llvm::Triple &Triple, const llvm::opt::ArgList &Args, std::vector< llvm::StringRef > &Features, bool ForAS, bool ForMultilib=false)
void getCSKYTargetFeatures(const Driver &D, const llvm::Triple &Triple, const llvm::opt::ArgList &Args, llvm::opt::ArgStringList &CmdArgs, std::vector< llvm::StringRef > &Features)
void getHexagonTargetFeatures(const Driver &D, const llvm::Triple &Triple, const llvm::opt::ArgList &Args, std::vector< StringRef > &Features)
std::string getLoongArchTargetCPU(const llvm::opt::ArgList &Args, const llvm::Triple &Triple)
void getLoongArchTargetFeatures(const Driver &D, const llvm::Triple &Triple, const llvm::opt::ArgList &Args, std::vector< llvm::StringRef > &Features)
void getM68kTargetFeatures(const Driver &D, const llvm::Triple &Triple, const llvm::opt::ArgList &Args, std::vector< llvm::StringRef > &Features)
std::string getM68kTargetCPU(const llvm::opt::ArgList &Args)
void getMIPSTargetFeatures(const Driver &D, const llvm::Triple &Triple, const llvm::opt::ArgList &Args, std::vector< StringRef > &Features)
bool hasMipsAbiArg(const llvm::opt::ArgList &Args, const char *Value)
void getMipsCPUAndABI(const llvm::opt::ArgList &Args, const llvm::Triple &Triple, StringRef &CPUName, StringRef &ABIName)
void getMSP430TargetFeatures(const Driver &D, const llvm::opt::ArgList &Args, std::vector< llvm::StringRef > &Features)
void getPPCTargetFeatures(const Driver &D, const llvm::Triple &Triple, const llvm::opt::ArgList &Args, std::vector< llvm::StringRef > &Features)
std::string getRISCVTargetCPU(const llvm::opt::ArgList &Args, const llvm::Triple &Triple)
Definition RISCV.cpp:383
void getRISCVTargetFeatures(const Driver &D, const llvm::Triple &Triple, const llvm::opt::ArgList &Args, std::vector< llvm::StringRef > &Features)
bool isLinkerGnuLd(const ToolChain &TC, const llvm::opt::ArgList &Args)
void getSparcTargetFeatures(const Driver &D, const llvm::Triple &Triple, const llvm::opt::ArgList &Args, std::vector< llvm::StringRef > &Features)
std::string getSparcTargetCPU(const Driver &D, const llvm::opt::ArgList &Args, const llvm::Triple &Triple)
void getSystemZTargetFeatures(const Driver &D, const llvm::opt::ArgList &Args, std::vector< llvm::StringRef > &Features)
std::string getSystemZTargetCPU(const llvm::opt::ArgList &Args, const llvm::Triple &T)
void getVETargetFeatures(const Driver &D, const llvm::opt::ArgList &Args, std::vector< llvm::StringRef > &Features)
std::string getX86TargetCPU(const Driver &D, const llvm::opt::ArgList &Args, const llvm::Triple &Triple)
void getX86TargetFeatures(const Driver &D, const llvm::Triple &Triple, const llvm::opt::ArgList &Args, std::vector< llvm::StringRef > &Features)
void AddStaticDeviceLibs(Compilation *C, const Tool *T, const JobAction *JA, const InputInfoList *Inputs, const Driver &D, const llvm::opt::ArgList &DriverArgs, llvm::opt::ArgStringList &CmdArgs, StringRef Arch, StringRef Target, bool isBitCodeSDL)
void addX86AlignBranchArgs(const Driver &D, const llvm::opt::ArgList &Args, llvm::opt::ArgStringList &CmdArgs, bool IsLTO, const StringRef PluginOptPrefix="")
void addMachineOutlinerArgs(const Driver &D, const llvm::opt::ArgList &Args, llvm::opt::ArgStringList &CmdArgs, const llvm::Triple &Triple, bool IsLTO, const StringRef PluginOptPrefix="")
unsigned ParseFunctionAlignment(const ToolChain &TC, const llvm::opt::ArgList &Args)
void addOffloadCompressArgs(const llvm::opt::ArgList &TCArgs, llvm::opt::ArgStringList &CmdArgs)
void handleTargetFeaturesGroup(const Driver &D, const llvm::Triple &Triple, const llvm::opt::ArgList &Args, std::vector< StringRef > &Features, llvm::opt::OptSpecifier Group)
Iterate Args and convert -mxxx to +xxx and -mno-xxx to -xxx and append it to Features.
void addMCModel(const Driver &D, const llvm::opt::ArgList &Args, const llvm::Triple &Triple, const llvm::Reloc::Model &RelocationModel, llvm::opt::ArgStringList &CmdArgs)
SmallVector< StringRef > unifyTargetFeatures(ArrayRef< StringRef > Features)
If there are multiple +xxx or -xxx features, keep the last one.
llvm::opt::Arg * getLastProfileSampleUseArg(const llvm::opt::ArgList &Args)
void handleVectorizeSLPArgs(const llvm::opt::ArgList &Args, llvm::opt::ArgStringList &CmdArgs)
Enable -fslp-vectorize based on the optimization level selected.
void addOpenMPDeviceRTL(const Driver &D, const llvm::opt::ArgList &DriverArgs, llvm::opt::ArgStringList &CC1Args, StringRef BitcodeSuffix, const llvm::Triple &Triple, const ToolChain &HostTC)
const char * SplitDebugName(const JobAction &JA, const llvm::opt::ArgList &Args, const InputInfo &Input, const InputInfo &Output)
void addOutlineAtomicsArgs(const Driver &D, const ToolChain &TC, const llvm::opt::ArgList &Args, llvm::opt::ArgStringList &CmdArgs, const llvm::Triple &Triple)
void checkAMDGPUCodeObjectVersion(const Driver &D, const llvm::opt::ArgList &Args)
void getTargetFeatures(const Driver &D, const llvm::Triple &Triple, const llvm::opt::ArgList &Args, llvm::opt::ArgStringList &CmdArgs, bool ForAS, bool IsAux=false)
void AddStaticDeviceLibsLinking(Compilation &C, const Tool &T, const JobAction &JA, const InputInfoList &Inputs, const llvm::opt::ArgList &DriverArgs, llvm::opt::ArgStringList &CmdArgs, StringRef Arch, StringRef Target, bool isBitCodeSDL)
std::string complexRangeKindToStr(LangOptions::ComplexRangeKind Range)
void addAsNeededOption(const ToolChain &TC, const llvm::opt::ArgList &Args, llvm::opt::ArgStringList &CmdArgs, bool as_needed)
void handleColorDiagnosticsArgs(const Driver &D, const llvm::opt::ArgList &Args, llvm::opt::ArgStringList &CmdArgs)
Handle the -f{no}-color-diagnostics and -f{no}-diagnostics-colors options.
bool getStaticPIE(const llvm::opt::ArgList &Args, const ToolChain &TC)
std::string getCPUName(const Driver &D, const llvm::opt::ArgList &Args, const llvm::Triple &T, bool FromAs=false)
void addLTOOptions(const ToolChain &ToolChain, const llvm::opt::ArgList &Args, llvm::opt::ArgStringList &CmdArgs, const InputInfo &Output, const InputInfoList &Inputs, bool IsThinLTO)
void addMultilibFlag(bool Enabled, const StringRef Flag, Multilib::flags_list &Flags)
Flag must be a flag accepted by the driver.
bool isUseSeparateSections(const llvm::Triple &Triple)
void linkXRayRuntimeDeps(const ToolChain &TC, const llvm::opt::ArgList &Args, llvm::opt::ArgStringList &CmdArgs)
void AddRunTimeLibs(const ToolChain &TC, const Driver &D, llvm::opt::ArgStringList &CmdArgs, const llvm::opt::ArgList &Args)
void SplitDebugInfo(const ToolChain &TC, Compilation &C, const Tool &T, const JobAction &JA, const llvm::opt::ArgList &Args, const InputInfo &Output, const char *OutFile)
void linkSanitizerRuntimeDeps(const ToolChain &TC, const llvm::opt::ArgList &Args, llvm::opt::ArgStringList &CmdArgs)
void addDirectoryList(const llvm::opt::ArgList &Args, llvm::opt::ArgStringList &CmdArgs, const char *ArgName, const char *EnvVar)
EnvVar is split by system delimiter for environment variables.
bool addSanitizerRuntimes(const ToolChain &TC, const llvm::opt::ArgList &Args, llvm::opt::ArgStringList &CmdArgs)
bool areOptimizationsEnabled(const llvm::opt::ArgList &Args)
void addOpenMPRuntimeLibraryPath(const ToolChain &TC, const llvm::opt::ArgList &Args, llvm::opt::ArgStringList &CmdArgs)
void setComplexRange(const Driver &D, StringRef NewOpt, LangOptions::ComplexRangeKind NewRange, StringRef &LastOpt, LangOptions::ComplexRangeKind &Range)
bool addXRayRuntime(const ToolChain &TC, const llvm::opt::ArgList &Args, llvm::opt::ArgStringList &CmdArgs)
void AddAssemblerKPIC(const ToolChain &ToolChain, const llvm::opt::ArgList &Args, llvm::opt::ArgStringList &CmdArgs)
bool haveAMDGPUCodeObjectVersionArgument(const Driver &D, const llvm::opt::ArgList &Args)
bool isTLSDESCEnabled(const ToolChain &TC, const llvm::opt::ArgList &Args)
void addDebugInfoForProfilingArgs(const Driver &D, const ToolChain &TC, const llvm::opt::ArgList &Args, llvm::opt::ArgStringList &CmdArgs)
void addDebugInfoKind(llvm::opt::ArgStringList &CmdArgs, llvm::codegenoptions::DebugInfoKind DebugInfoKind)
void addPathIfExists(const Driver &D, const Twine &Path, ToolChain::path_list &Paths)
llvm::codegenoptions::DebugInfoKind debugLevelToInfoKind(const llvm::opt::Arg &A)
llvm::opt::Arg * getLastCSProfileGenerateArg(const llvm::opt::ArgList &Args)
void renderGlobalISelOptions(const Driver &D, const llvm::opt::ArgList &Args, llvm::opt::ArgStringList &CmdArgs, const llvm::Triple &Triple)
llvm::opt::Arg * getLastProfileUseArg(const llvm::opt::ArgList &Args)
void addDTLTOOptions(const ToolChain &ToolChain, const llvm::opt::ArgList &Args, llvm::opt::ArgStringList &CmdArgs)
std::string renderComplexRangeOption(LangOptions::ComplexRangeKind Range)
DwarfFissionKind getDebugFissionKind(const Driver &D, const llvm::opt::ArgList &Args, llvm::opt::Arg *&Arg)
llvm::StringRef getLTOParallelism(const llvm::opt::ArgList &Args, const Driver &D)
void addLinkerCompressDebugSectionsOption(const ToolChain &TC, const llvm::opt::ArgList &Args, llvm::opt::ArgStringList &CmdArgs)
void constructLLVMLinkCommand(Compilation &C, const Tool &T, const JobAction &JA, const InputInfoList &JobInputs, const llvm::opt::ArgStringList &LinkerInputs, const InputInfo &Output, const llvm::opt::ArgList &Args, const char *OutputFilename=nullptr)
void handleInterchangeLoopsArgs(const llvm::opt::ArgList &Args, llvm::opt::ArgStringList &CmdArgs)
Enable -floop-interchange based on the optimization level selected.
const char * renderEscapedCommandLine(const ToolChain &TC, const llvm::opt::ArgList &Args)
Join the args in the given ArgList, escape spaces and backslashes and return the joined string.
void renderCommonIntegerOverflowOptions(const llvm::opt::ArgList &Args, llvm::opt::ArgStringList &CmdArgs, bool IsMSVCCompat)
bool addOpenMPRuntime(const Compilation &C, llvm::opt::ArgStringList &CmdArgs, const ToolChain &TC, const llvm::opt::ArgList &Args, bool ForceStaticHostRuntime=false, bool IsOffloadingHost=false, bool GompNeedsRT=false)
Returns true, if an OpenMP runtime has been added.
bool checkDebugInfoOption(const llvm::opt::Arg *A, const llvm::opt::ArgList &Args, const Driver &D, const ToolChain &TC)
std::tuple< llvm::Reloc::Model, unsigned, bool > ParsePICArgs(const ToolChain &ToolChain, const llvm::opt::ArgList &Args)
void claimNoWarnArgs(const llvm::opt::ArgList &Args)
unsigned DwarfVersionNum(StringRef ArgValue)
void AddLinkerInputs(const ToolChain &TC, const InputInfoList &Inputs, const llvm::opt::ArgList &Args, llvm::opt::ArgStringList &CmdArgs, const JobAction &JA)
unsigned getDwarfVersion(const ToolChain &TC, const llvm::opt::ArgList &Args)
bool shouldRecordCommandLine(const ToolChain &TC, const llvm::opt::ArgList &Args, bool &FRecordCommandLine, bool &GRecordCommandLine, bool &DXRecordCommandLine)
Check if the command line should be recorded in the object file.
unsigned getAMDGPUCodeObjectVersion(const Driver &D, const llvm::opt::ArgList &Args)
const llvm::opt::Arg * getDwarfNArg(const llvm::opt::ArgList &Args)
void AddTargetFeature(const llvm::opt::ArgList &Args, std::vector< StringRef > &Features, llvm::opt::OptSpecifier OnOpt, llvm::opt::OptSpecifier OffOpt, StringRef FeatureName)
SmallString< 128 > getStatsFileName(const llvm::opt::ArgList &Args, const InputInfo &Output, const InputInfo &Input, const Driver &D)
Handles the -save-stats option and returns the filename to save statistics to.
void addArchSpecificRPath(const ToolChain &TC, const llvm::opt::ArgList &Args, llvm::opt::ArgStringList &CmdArgs)
void addSeparateSectionFlags(const llvm::Triple &Triple, const llvm::opt::ArgList &Args, llvm::opt::ArgStringList &CmdArgs)
Append -ffunction-sections / -fdata-sections to CmdArgs when the corresponding flags are enabled (exp...
void handleVectorizeLoopsArgs(const llvm::opt::ArgList &Args, llvm::opt::ArgStringList &CmdArgs)
Enable -fvectorize based on the optimization level selected.
void escapeSpacesAndBackslashes(const char *Arg, llvm::SmallVectorImpl< char > &Res)
Add backslashes to escape spaces and other backslashes.
const char * getLDMOption(const llvm::Triple &T, const llvm::opt::ArgList &Args)
void addOpenCLBuiltinsLib(const Driver &D, const llvm::Triple &TT, const llvm::opt::ArgList &DriverArgs, llvm::opt::ArgStringList &CC1Args)
bool isObjCAutoRefCount(const llvm::opt::ArgList &Args)
const char * RelocationModelName(llvm::Reloc::Model Model)
void addOpenMPHostOffloadingArgs(const Compilation &C, const JobAction &JA, const llvm::opt::ArgList &Args, llvm::opt::ArgStringList &CmdArgs)
Adds offloading options for OpenMP host compilation to CmdArgs.
bool shouldEnableVectorizerAtOLevel(const llvm::opt::ArgList &Args, bool isSlpVec)
bool isLLVMIR(ID Id)
Is this LLVM IR.
Definition Types.cpp:289
ID lookupTypeForExtension(llvm::StringRef Ext)
lookupTypeForExtension - Lookup the type to use for the file extension Ext.
Definition Types.cpp:332
SmallVector< InputInfo, 4 > InputInfoList
Definition Driver.h:51
bool willEmitRemarks(const llvm::opt::ArgList &Args)
The JSON file list parser is used to communicate input to InstallAPI.
llvm::StringRef getProcessorFromTargetID(const llvm::Triple &T, llvm::StringRef OffloadArch)
Get processor name from target ID.
Definition TargetID.cpp:58
unsigned getOptimizationLevel(const llvm::opt::ArgList &Args, InputKind IK, DiagnosticsEngine &Diags)
@ Auto
Emit colors only if the output stream is detected to support them.
@ On
Always emit colors regardless of the output stream.
@ Off
Never emit colors regardless of the output stream.
llvm::StringRef ArchName
static constexpr ResponseFileSupport None()
Returns a ResponseFileSupport indicating that response files are not supported.
Definition Job.h:79
static constexpr ResponseFileSupport AtFileCurCP()
Definition Job.h:93