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