1 //===--- Cuda.cpp - Cuda Tool and ToolChain Implementations -----*- 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 "Cuda.h"
10 #include "CommonArgs.h"
11 #include "clang/Basic/Cuda.h"
12 #include "clang/Config/config.h"
13 #include "clang/Driver/Compilation.h"
14 #include "clang/Driver/Distro.h"
15 #include "clang/Driver/Driver.h"
16 #include "clang/Driver/DriverDiagnostic.h"
17 #include "clang/Driver/InputInfo.h"
18 #include "clang/Driver/Options.h"
19 #include "llvm/ADT/Optional.h"
20 #include "llvm/ADT/StringExtras.h"
21 #include "llvm/Option/ArgList.h"
22 #include "llvm/Support/FileSystem.h"
23 #include "llvm/Support/Host.h"
24 #include "llvm/Support/Path.h"
25 #include "llvm/Support/Process.h"
26 #include "llvm/Support/Program.h"
27 #include "llvm/Support/TargetParser.h"
28 #include "llvm/Support/VirtualFileSystem.h"
29 #include <system_error>
30 
31 using namespace clang::driver;
32 using namespace clang::driver::toolchains;
33 using namespace clang::driver::tools;
34 using namespace clang;
35 using namespace llvm::opt;
36 
37 namespace {
38 
39 CudaVersion getCudaVersion(uint32_t raw_version) {
40   if (raw_version < 7050)
41     return CudaVersion::CUDA_70;
42   if (raw_version < 8000)
43     return CudaVersion::CUDA_75;
44   if (raw_version < 9000)
45     return CudaVersion::CUDA_80;
46   if (raw_version < 9010)
47     return CudaVersion::CUDA_90;
48   if (raw_version < 9020)
49     return CudaVersion::CUDA_91;
50   if (raw_version < 10000)
51     return CudaVersion::CUDA_92;
52   if (raw_version < 10010)
53     return CudaVersion::CUDA_100;
54   if (raw_version < 10020)
55     return CudaVersion::CUDA_101;
56   if (raw_version < 11000)
57     return CudaVersion::CUDA_102;
58   if (raw_version < 11010)
59     return CudaVersion::CUDA_110;
60   if (raw_version < 11020)
61     return CudaVersion::CUDA_111;
62   if (raw_version < 11030)
63     return CudaVersion::CUDA_112;
64   if (raw_version < 11040)
65     return CudaVersion::CUDA_113;
66   if (raw_version < 11050)
67     return CudaVersion::CUDA_114;
68   if (raw_version < 11060)
69     return CudaVersion::CUDA_115;
70   return CudaVersion::NEW;
71 }
72 
73 CudaVersion parseCudaHFile(llvm::StringRef Input) {
74   // Helper lambda which skips the words if the line starts with them or returns
75   // None otherwise.
76   auto StartsWithWords =
77       [](llvm::StringRef Line,
78          const SmallVector<StringRef, 3> words) -> llvm::Optional<StringRef> {
79     for (StringRef word : words) {
80       if (!Line.consume_front(word))
81         return {};
82       Line = Line.ltrim();
83     }
84     return Line;
85   };
86 
87   Input = Input.ltrim();
88   while (!Input.empty()) {
89     if (auto Line =
90             StartsWithWords(Input.ltrim(), {"#", "define", "CUDA_VERSION"})) {
91       uint32_t RawVersion;
92       Line->consumeInteger(10, RawVersion);
93       return getCudaVersion(RawVersion);
94     }
95     // Find next non-empty line.
96     Input = Input.drop_front(Input.find_first_of("\n\r")).ltrim();
97   }
98   return CudaVersion::UNKNOWN;
99 }
100 } // namespace
101 
102 void CudaInstallationDetector::WarnIfUnsupportedVersion() {
103   if (Version > CudaVersion::PARTIALLY_SUPPORTED) {
104     std::string VersionString = CudaVersionToString(Version);
105     if (!VersionString.empty())
106       VersionString.insert(0, " ");
107     D.Diag(diag::warn_drv_new_cuda_version)
108         << VersionString
109         << (CudaVersion::PARTIALLY_SUPPORTED != CudaVersion::FULLY_SUPPORTED)
110         << CudaVersionToString(CudaVersion::PARTIALLY_SUPPORTED);
111   } else if (Version > CudaVersion::FULLY_SUPPORTED)
112     D.Diag(diag::warn_drv_partially_supported_cuda_version)
113         << CudaVersionToString(Version);
114 }
115 
116 CudaInstallationDetector::CudaInstallationDetector(
117     const Driver &D, const llvm::Triple &HostTriple,
118     const llvm::opt::ArgList &Args)
119     : D(D) {
120   struct Candidate {
121     std::string Path;
122     bool StrictChecking;
123 
124     Candidate(std::string Path, bool StrictChecking = false)
125         : Path(Path), StrictChecking(StrictChecking) {}
126   };
127   SmallVector<Candidate, 4> Candidates;
128 
129   // In decreasing order so we prefer newer versions to older versions.
130   std::initializer_list<const char *> Versions = {"8.0", "7.5", "7.0"};
131   auto &FS = D.getVFS();
132 
133   if (Args.hasArg(clang::driver::options::OPT_cuda_path_EQ)) {
134     Candidates.emplace_back(
135         Args.getLastArgValue(clang::driver::options::OPT_cuda_path_EQ).str());
136   } else if (HostTriple.isOSWindows()) {
137     for (const char *Ver : Versions)
138       Candidates.emplace_back(
139           D.SysRoot + "/Program Files/NVIDIA GPU Computing Toolkit/CUDA/v" +
140           Ver);
141   } else {
142     if (!Args.hasArg(clang::driver::options::OPT_cuda_path_ignore_env)) {
143       // Try to find ptxas binary. If the executable is located in a directory
144       // called 'bin/', its parent directory might be a good guess for a valid
145       // CUDA installation.
146       // However, some distributions might installs 'ptxas' to /usr/bin. In that
147       // case the candidate would be '/usr' which passes the following checks
148       // because '/usr/include' exists as well. To avoid this case, we always
149       // check for the directory potentially containing files for libdevice,
150       // even if the user passes -nocudalib.
151       if (llvm::ErrorOr<std::string> ptxas =
152               llvm::sys::findProgramByName("ptxas")) {
153         SmallString<256> ptxasAbsolutePath;
154         llvm::sys::fs::real_path(*ptxas, ptxasAbsolutePath);
155 
156         StringRef ptxasDir = llvm::sys::path::parent_path(ptxasAbsolutePath);
157         if (llvm::sys::path::filename(ptxasDir) == "bin")
158           Candidates.emplace_back(
159               std::string(llvm::sys::path::parent_path(ptxasDir)),
160               /*StrictChecking=*/true);
161       }
162     }
163 
164     Candidates.emplace_back(D.SysRoot + "/usr/local/cuda");
165     for (const char *Ver : Versions)
166       Candidates.emplace_back(D.SysRoot + "/usr/local/cuda-" + Ver);
167 
168     Distro Dist(FS, llvm::Triple(llvm::sys::getProcessTriple()));
169     if (Dist.IsDebian() || Dist.IsUbuntu())
170       // Special case for Debian to have nvidia-cuda-toolkit work
171       // out of the box. More info on http://bugs.debian.org/882505
172       Candidates.emplace_back(D.SysRoot + "/usr/lib/cuda");
173   }
174 
175   bool NoCudaLib = Args.hasArg(options::OPT_nogpulib);
176 
177   for (const auto &Candidate : Candidates) {
178     InstallPath = Candidate.Path;
179     if (InstallPath.empty() || !FS.exists(InstallPath))
180       continue;
181 
182     BinPath = InstallPath + "/bin";
183     IncludePath = InstallPath + "/include";
184     LibDevicePath = InstallPath + "/nvvm/libdevice";
185 
186     if (!(FS.exists(IncludePath) && FS.exists(BinPath)))
187       continue;
188     bool CheckLibDevice = (!NoCudaLib || Candidate.StrictChecking);
189     if (CheckLibDevice && !FS.exists(LibDevicePath))
190       continue;
191 
192     // On Linux, we have both lib and lib64 directories, and we need to choose
193     // based on our triple.  On MacOS, we have only a lib directory.
194     //
195     // It's sufficient for our purposes to be flexible: If both lib and lib64
196     // exist, we choose whichever one matches our triple.  Otherwise, if only
197     // lib exists, we use it.
198     if (HostTriple.isArch64Bit() && FS.exists(InstallPath + "/lib64"))
199       LibPath = InstallPath + "/lib64";
200     else if (FS.exists(InstallPath + "/lib"))
201       LibPath = InstallPath + "/lib";
202     else
203       continue;
204 
205     Version = CudaVersion::UNKNOWN;
206     if (auto CudaHFile = FS.getBufferForFile(InstallPath + "/include/cuda.h"))
207       Version = parseCudaHFile((*CudaHFile)->getBuffer());
208     // As the last resort, make an educated guess between CUDA-7.0, which had
209     // old-style libdevice bitcode, and an unknown recent CUDA version.
210     if (Version == CudaVersion::UNKNOWN) {
211       Version = FS.exists(LibDevicePath + "/libdevice.10.bc")
212                     ? CudaVersion::NEW
213                     : CudaVersion::CUDA_70;
214     }
215 
216     if (Version >= CudaVersion::CUDA_90) {
217       // CUDA-9+ uses single libdevice file for all GPU variants.
218       std::string FilePath = LibDevicePath + "/libdevice.10.bc";
219       if (FS.exists(FilePath)) {
220         for (int Arch = (int)CudaArch::SM_30, E = (int)CudaArch::LAST; Arch < E;
221              ++Arch) {
222           CudaArch GpuArch = static_cast<CudaArch>(Arch);
223           if (!IsNVIDIAGpuArch(GpuArch))
224             continue;
225           std::string GpuArchName(CudaArchToString(GpuArch));
226           LibDeviceMap[GpuArchName] = FilePath;
227         }
228       }
229     } else {
230       std::error_code EC;
231       for (llvm::vfs::directory_iterator LI = FS.dir_begin(LibDevicePath, EC),
232                                          LE;
233            !EC && LI != LE; LI = LI.increment(EC)) {
234         StringRef FilePath = LI->path();
235         StringRef FileName = llvm::sys::path::filename(FilePath);
236         // Process all bitcode filenames that look like
237         // libdevice.compute_XX.YY.bc
238         const StringRef LibDeviceName = "libdevice.";
239         if (!(FileName.startswith(LibDeviceName) && FileName.endswith(".bc")))
240           continue;
241         StringRef GpuArch = FileName.slice(
242             LibDeviceName.size(), FileName.find('.', LibDeviceName.size()));
243         LibDeviceMap[GpuArch] = FilePath.str();
244         // Insert map entries for specific devices with this compute
245         // capability. NVCC's choice of the libdevice library version is
246         // rather peculiar and depends on the CUDA version.
247         if (GpuArch == "compute_20") {
248           LibDeviceMap["sm_20"] = std::string(FilePath);
249           LibDeviceMap["sm_21"] = std::string(FilePath);
250           LibDeviceMap["sm_32"] = std::string(FilePath);
251         } else if (GpuArch == "compute_30") {
252           LibDeviceMap["sm_30"] = std::string(FilePath);
253           if (Version < CudaVersion::CUDA_80) {
254             LibDeviceMap["sm_50"] = std::string(FilePath);
255             LibDeviceMap["sm_52"] = std::string(FilePath);
256             LibDeviceMap["sm_53"] = std::string(FilePath);
257           }
258           LibDeviceMap["sm_60"] = std::string(FilePath);
259           LibDeviceMap["sm_61"] = std::string(FilePath);
260           LibDeviceMap["sm_62"] = std::string(FilePath);
261         } else if (GpuArch == "compute_35") {
262           LibDeviceMap["sm_35"] = std::string(FilePath);
263           LibDeviceMap["sm_37"] = std::string(FilePath);
264         } else if (GpuArch == "compute_50") {
265           if (Version >= CudaVersion::CUDA_80) {
266             LibDeviceMap["sm_50"] = std::string(FilePath);
267             LibDeviceMap["sm_52"] = std::string(FilePath);
268             LibDeviceMap["sm_53"] = std::string(FilePath);
269           }
270         }
271       }
272     }
273 
274     // Check that we have found at least one libdevice that we can link in if
275     // -nocudalib hasn't been specified.
276     if (LibDeviceMap.empty() && !NoCudaLib)
277       continue;
278 
279     IsValid = true;
280     break;
281   }
282 }
283 
284 void CudaInstallationDetector::AddCudaIncludeArgs(
285     const ArgList &DriverArgs, ArgStringList &CC1Args) const {
286   if (!DriverArgs.hasArg(options::OPT_nobuiltininc)) {
287     // Add cuda_wrappers/* to our system include path.  This lets us wrap
288     // standard library headers.
289     SmallString<128> P(D.ResourceDir);
290     llvm::sys::path::append(P, "include");
291     llvm::sys::path::append(P, "cuda_wrappers");
292     CC1Args.push_back("-internal-isystem");
293     CC1Args.push_back(DriverArgs.MakeArgString(P));
294   }
295 
296   if (DriverArgs.hasArg(options::OPT_nogpuinc))
297     return;
298 
299   if (!isValid()) {
300     D.Diag(diag::err_drv_no_cuda_installation);
301     return;
302   }
303 
304   CC1Args.push_back("-include");
305   CC1Args.push_back("__clang_cuda_runtime_wrapper.h");
306 }
307 
308 void CudaInstallationDetector::CheckCudaVersionSupportsArch(
309     CudaArch Arch) const {
310   if (Arch == CudaArch::UNKNOWN || Version == CudaVersion::UNKNOWN ||
311       ArchsWithBadVersion[(int)Arch])
312     return;
313 
314   auto MinVersion = MinVersionForCudaArch(Arch);
315   auto MaxVersion = MaxVersionForCudaArch(Arch);
316   if (Version < MinVersion || Version > MaxVersion) {
317     ArchsWithBadVersion[(int)Arch] = true;
318     D.Diag(diag::err_drv_cuda_version_unsupported)
319         << CudaArchToString(Arch) << CudaVersionToString(MinVersion)
320         << CudaVersionToString(MaxVersion) << InstallPath
321         << CudaVersionToString(Version);
322   }
323 }
324 
325 void CudaInstallationDetector::print(raw_ostream &OS) const {
326   if (isValid())
327     OS << "Found CUDA installation: " << InstallPath << ", version "
328        << CudaVersionToString(Version) << "\n";
329 }
330 
331 namespace {
332 /// Debug info level for the NVPTX devices. We may need to emit different debug
333 /// info level for the host and for the device itselfi. This type controls
334 /// emission of the debug info for the devices. It either prohibits disable info
335 /// emission completely, or emits debug directives only, or emits same debug
336 /// info as for the host.
337 enum DeviceDebugInfoLevel {
338   DisableDebugInfo,        /// Do not emit debug info for the devices.
339   DebugDirectivesOnly,     /// Emit only debug directives.
340   EmitSameDebugInfoAsHost, /// Use the same debug info level just like for the
341                            /// host.
342 };
343 } // anonymous namespace
344 
345 /// Define debug info level for the NVPTX devices. If the debug info for both
346 /// the host and device are disabled (-g0/-ggdb0 or no debug options at all). If
347 /// only debug directives are requested for the both host and device
348 /// (-gline-directvies-only), or the debug info only for the device is disabled
349 /// (optimization is on and --cuda-noopt-device-debug was not specified), the
350 /// debug directves only must be emitted for the device. Otherwise, use the same
351 /// debug info level just like for the host (with the limitations of only
352 /// supported DWARF2 standard).
353 static DeviceDebugInfoLevel mustEmitDebugInfo(const ArgList &Args) {
354   const Arg *A = Args.getLastArg(options::OPT_O_Group);
355   bool IsDebugEnabled = !A || A->getOption().matches(options::OPT_O0) ||
356                         Args.hasFlag(options::OPT_cuda_noopt_device_debug,
357                                      options::OPT_no_cuda_noopt_device_debug,
358                                      /*Default=*/false);
359   if (const Arg *A = Args.getLastArg(options::OPT_g_Group)) {
360     const Option &Opt = A->getOption();
361     if (Opt.matches(options::OPT_gN_Group)) {
362       if (Opt.matches(options::OPT_g0) || Opt.matches(options::OPT_ggdb0))
363         return DisableDebugInfo;
364       if (Opt.matches(options::OPT_gline_directives_only))
365         return DebugDirectivesOnly;
366     }
367     return IsDebugEnabled ? EmitSameDebugInfoAsHost : DebugDirectivesOnly;
368   }
369   return willEmitRemarks(Args) ? DebugDirectivesOnly : DisableDebugInfo;
370 }
371 
372 void NVPTX::Assembler::ConstructJob(Compilation &C, const JobAction &JA,
373                                     const InputInfo &Output,
374                                     const InputInfoList &Inputs,
375                                     const ArgList &Args,
376                                     const char *LinkingOutput) const {
377   const auto &TC =
378       static_cast<const toolchains::CudaToolChain &>(getToolChain());
379   assert(TC.getTriple().isNVPTX() && "Wrong platform");
380 
381   StringRef GPUArchName;
382   // If this is an OpenMP action we need to extract the device architecture
383   // from the -march=arch option. This option may come from -Xopenmp-target
384   // flag or the default value.
385   if (JA.isDeviceOffloading(Action::OFK_OpenMP)) {
386     GPUArchName = Args.getLastArgValue(options::OPT_march_EQ);
387     assert(!GPUArchName.empty() && "Must have an architecture passed in.");
388   } else
389     GPUArchName = JA.getOffloadingArch();
390 
391   // Obtain architecture from the action.
392   CudaArch gpu_arch = StringToCudaArch(GPUArchName);
393   assert(gpu_arch != CudaArch::UNKNOWN &&
394          "Device action expected to have an architecture.");
395 
396   // Check that our installation's ptxas supports gpu_arch.
397   if (!Args.hasArg(options::OPT_no_cuda_version_check)) {
398     TC.CudaInstallation.CheckCudaVersionSupportsArch(gpu_arch);
399   }
400 
401   ArgStringList CmdArgs;
402   CmdArgs.push_back(TC.getTriple().isArch64Bit() ? "-m64" : "-m32");
403   DeviceDebugInfoLevel DIKind = mustEmitDebugInfo(Args);
404   if (DIKind == EmitSameDebugInfoAsHost) {
405     // ptxas does not accept -g option if optimization is enabled, so
406     // we ignore the compiler's -O* options if we want debug info.
407     CmdArgs.push_back("-g");
408     CmdArgs.push_back("--dont-merge-basicblocks");
409     CmdArgs.push_back("--return-at-end");
410   } else if (Arg *A = Args.getLastArg(options::OPT_O_Group)) {
411     // Map the -O we received to -O{0,1,2,3}.
412     //
413     // TODO: Perhaps we should map host -O2 to ptxas -O3. -O3 is ptxas's
414     // default, so it may correspond more closely to the spirit of clang -O2.
415 
416     // -O3 seems like the least-bad option when -Osomething is specified to
417     // clang but it isn't handled below.
418     StringRef OOpt = "3";
419     if (A->getOption().matches(options::OPT_O4) ||
420         A->getOption().matches(options::OPT_Ofast))
421       OOpt = "3";
422     else if (A->getOption().matches(options::OPT_O0))
423       OOpt = "0";
424     else if (A->getOption().matches(options::OPT_O)) {
425       // -Os, -Oz, and -O(anything else) map to -O2, for lack of better options.
426       OOpt = llvm::StringSwitch<const char *>(A->getValue())
427                  .Case("1", "1")
428                  .Case("2", "2")
429                  .Case("3", "3")
430                  .Case("s", "2")
431                  .Case("z", "2")
432                  .Default("2");
433     }
434     CmdArgs.push_back(Args.MakeArgString(llvm::Twine("-O") + OOpt));
435   } else {
436     // If no -O was passed, pass -O0 to ptxas -- no opt flag should correspond
437     // to no optimizations, but ptxas's default is -O3.
438     CmdArgs.push_back("-O0");
439   }
440   if (DIKind == DebugDirectivesOnly)
441     CmdArgs.push_back("-lineinfo");
442 
443   // Pass -v to ptxas if it was passed to the driver.
444   if (Args.hasArg(options::OPT_v))
445     CmdArgs.push_back("-v");
446 
447   CmdArgs.push_back("--gpu-name");
448   CmdArgs.push_back(Args.MakeArgString(CudaArchToString(gpu_arch)));
449   CmdArgs.push_back("--output-file");
450   const char *OutputFileName = Args.MakeArgString(TC.getInputFilename(Output));
451   if (std::string(OutputFileName) != std::string(Output.getFilename()))
452     C.addTempFile(OutputFileName);
453   CmdArgs.push_back(OutputFileName);
454   for (const auto& II : Inputs)
455     CmdArgs.push_back(Args.MakeArgString(II.getFilename()));
456 
457   for (const auto& A : Args.getAllArgValues(options::OPT_Xcuda_ptxas))
458     CmdArgs.push_back(Args.MakeArgString(A));
459 
460   bool Relocatable = false;
461   if (JA.isOffloading(Action::OFK_OpenMP))
462     // In OpenMP we need to generate relocatable code.
463     Relocatable = Args.hasFlag(options::OPT_fopenmp_relocatable_target,
464                                options::OPT_fnoopenmp_relocatable_target,
465                                /*Default=*/true);
466   else if (JA.isOffloading(Action::OFK_Cuda))
467     Relocatable = Args.hasFlag(options::OPT_fgpu_rdc,
468                                options::OPT_fno_gpu_rdc, /*Default=*/false);
469 
470   if (Relocatable)
471     CmdArgs.push_back("-c");
472 
473   const char *Exec;
474   if (Arg *A = Args.getLastArg(options::OPT_ptxas_path_EQ))
475     Exec = A->getValue();
476   else
477     Exec = Args.MakeArgString(TC.GetProgramPath("ptxas"));
478   C.addCommand(std::make_unique<Command>(
479       JA, *this,
480       ResponseFileSupport{ResponseFileSupport::RF_Full, llvm::sys::WEM_UTF8,
481                           "--options-file"},
482       Exec, CmdArgs, Inputs, Output));
483 }
484 
485 static bool shouldIncludePTX(const ArgList &Args, const char *gpu_arch) {
486   bool includePTX = true;
487   for (Arg *A : Args) {
488     if (!(A->getOption().matches(options::OPT_cuda_include_ptx_EQ) ||
489           A->getOption().matches(options::OPT_no_cuda_include_ptx_EQ)))
490       continue;
491     A->claim();
492     const StringRef ArchStr = A->getValue();
493     if (ArchStr == "all" || ArchStr == gpu_arch) {
494       includePTX = A->getOption().matches(options::OPT_cuda_include_ptx_EQ);
495       continue;
496     }
497   }
498   return includePTX;
499 }
500 
501 // All inputs to this linker must be from CudaDeviceActions, as we need to look
502 // at the Inputs' Actions in order to figure out which GPU architecture they
503 // correspond to.
504 void NVPTX::Linker::ConstructJob(Compilation &C, const JobAction &JA,
505                                  const InputInfo &Output,
506                                  const InputInfoList &Inputs,
507                                  const ArgList &Args,
508                                  const char *LinkingOutput) const {
509   const auto &TC =
510       static_cast<const toolchains::CudaToolChain &>(getToolChain());
511   assert(TC.getTriple().isNVPTX() && "Wrong platform");
512 
513   ArgStringList CmdArgs;
514   if (TC.CudaInstallation.version() <= CudaVersion::CUDA_100)
515     CmdArgs.push_back("--cuda");
516   CmdArgs.push_back(TC.getTriple().isArch64Bit() ? "-64" : "-32");
517   CmdArgs.push_back(Args.MakeArgString("--create"));
518   CmdArgs.push_back(Args.MakeArgString(Output.getFilename()));
519   if (mustEmitDebugInfo(Args) == EmitSameDebugInfoAsHost)
520     CmdArgs.push_back("-g");
521 
522   for (const auto& II : Inputs) {
523     auto *A = II.getAction();
524     assert(A->getInputs().size() == 1 &&
525            "Device offload action is expected to have a single input");
526     const char *gpu_arch_str = A->getOffloadingArch();
527     assert(gpu_arch_str &&
528            "Device action expected to have associated a GPU architecture!");
529     CudaArch gpu_arch = StringToCudaArch(gpu_arch_str);
530 
531     if (II.getType() == types::TY_PP_Asm &&
532         !shouldIncludePTX(Args, gpu_arch_str))
533       continue;
534     // We need to pass an Arch of the form "sm_XX" for cubin files and
535     // "compute_XX" for ptx.
536     const char *Arch = (II.getType() == types::TY_PP_Asm)
537                            ? CudaArchToVirtualArchString(gpu_arch)
538                            : gpu_arch_str;
539     CmdArgs.push_back(Args.MakeArgString(llvm::Twine("--image=profile=") +
540                                          Arch + ",file=" + II.getFilename()));
541   }
542 
543   for (const auto& A : Args.getAllArgValues(options::OPT_Xcuda_fatbinary))
544     CmdArgs.push_back(Args.MakeArgString(A));
545 
546   const char *Exec = Args.MakeArgString(TC.GetProgramPath("fatbinary"));
547   C.addCommand(std::make_unique<Command>(
548       JA, *this,
549       ResponseFileSupport{ResponseFileSupport::RF_Full, llvm::sys::WEM_UTF8,
550                           "--options-file"},
551       Exec, CmdArgs, Inputs, Output));
552 }
553 
554 void NVPTX::OpenMPLinker::ConstructJob(Compilation &C, const JobAction &JA,
555                                        const InputInfo &Output,
556                                        const InputInfoList &Inputs,
557                                        const ArgList &Args,
558                                        const char *LinkingOutput) const {
559   const auto &TC =
560       static_cast<const toolchains::CudaToolChain &>(getToolChain());
561   assert(TC.getTriple().isNVPTX() && "Wrong platform");
562 
563   ArgStringList CmdArgs;
564 
565   // OpenMP uses nvlink to link cubin files. The result will be embedded in the
566   // host binary by the host linker.
567   assert(!JA.isHostOffloading(Action::OFK_OpenMP) &&
568          "CUDA toolchain not expected for an OpenMP host device.");
569 
570   if (Output.isFilename()) {
571     CmdArgs.push_back("-o");
572     CmdArgs.push_back(Output.getFilename());
573   } else
574     assert(Output.isNothing() && "Invalid output.");
575   if (mustEmitDebugInfo(Args) == EmitSameDebugInfoAsHost)
576     CmdArgs.push_back("-g");
577 
578   if (Args.hasArg(options::OPT_v))
579     CmdArgs.push_back("-v");
580 
581   StringRef GPUArch =
582       Args.getLastArgValue(options::OPT_march_EQ);
583   assert(!GPUArch.empty() && "At least one GPU Arch required for ptxas.");
584 
585   CmdArgs.push_back("-arch");
586   CmdArgs.push_back(Args.MakeArgString(GPUArch));
587 
588   // Add paths specified in LIBRARY_PATH environment variable as -L options.
589   addDirectoryList(Args, CmdArgs, "-L", "LIBRARY_PATH");
590 
591   // Add paths for the default clang library path.
592   SmallString<256> DefaultLibPath =
593       llvm::sys::path::parent_path(TC.getDriver().Dir);
594   llvm::sys::path::append(DefaultLibPath, "lib" CLANG_LIBDIR_SUFFIX);
595   CmdArgs.push_back(Args.MakeArgString(Twine("-L") + DefaultLibPath));
596 
597   for (const auto &II : Inputs) {
598     if (II.getType() == types::TY_LLVM_IR ||
599         II.getType() == types::TY_LTO_IR ||
600         II.getType() == types::TY_LTO_BC ||
601         II.getType() == types::TY_LLVM_BC) {
602       C.getDriver().Diag(diag::err_drv_no_linker_llvm_support)
603           << getToolChain().getTripleString();
604       continue;
605     }
606 
607     // Currently, we only pass the input files to the linker, we do not pass
608     // any libraries that may be valid only for the host.
609     if (!II.isFilename())
610       continue;
611 
612     const char *CubinF =
613         C.getArgs().MakeArgString(getToolChain().getInputFilename(II));
614 
615     CmdArgs.push_back(CubinF);
616   }
617 
618   AddStaticDeviceLibsLinking(C, *this, JA, Inputs, Args, CmdArgs, "nvptx",
619                              GPUArch, /*isBitCodeSDL=*/false,
620                              /*postClangLink=*/false);
621 
622   // Find nvlink and pass it as "--nvlink-path=" argument of
623   // clang-nvlink-wrapper.
624   CmdArgs.push_back(Args.MakeArgString(
625       Twine("--nvlink-path=" + getToolChain().GetProgramPath("nvlink"))));
626 
627   const char *Exec =
628       Args.MakeArgString(getToolChain().GetProgramPath("clang-nvlink-wrapper"));
629   C.addCommand(std::make_unique<Command>(
630       JA, *this,
631       ResponseFileSupport{ResponseFileSupport::RF_Full, llvm::sys::WEM_UTF8,
632                           "--options-file"},
633       Exec, CmdArgs, Inputs, Output));
634 }
635 
636 void NVPTX::getNVPTXTargetFeatures(const Driver &D, const llvm::Triple &Triple,
637                                    const llvm::opt::ArgList &Args,
638                                    std::vector<StringRef> &Features,
639                                    Optional<clang::CudaVersion> Version) {
640   if (!Version) {
641     CudaInstallationDetector CudaInstallation(D, Triple, Args);
642     Version = CudaInstallation.version();
643   }
644 
645   // New CUDA versions often introduce new instructions that are only supported
646   // by new PTX version, so we need to raise PTX level to enable them in NVPTX
647   // back-end.
648   const char *PtxFeature = nullptr;
649   switch (*Version) {
650 #define CASE_CUDA_VERSION(CUDA_VER, PTX_VER)                                   \
651   case CudaVersion::CUDA_##CUDA_VER:                                           \
652     PtxFeature = "+ptx" #PTX_VER;                                              \
653     break;
654     CASE_CUDA_VERSION(115, 75);
655     CASE_CUDA_VERSION(114, 74);
656     CASE_CUDA_VERSION(113, 73);
657     CASE_CUDA_VERSION(112, 72);
658     CASE_CUDA_VERSION(111, 71);
659     CASE_CUDA_VERSION(110, 70);
660     CASE_CUDA_VERSION(102, 65);
661     CASE_CUDA_VERSION(101, 64);
662     CASE_CUDA_VERSION(100, 63);
663     CASE_CUDA_VERSION(92, 61);
664     CASE_CUDA_VERSION(91, 61);
665     CASE_CUDA_VERSION(90, 60);
666 #undef CASE_CUDA_VERSION
667   default:
668     PtxFeature = "+ptx42";
669   }
670   Features.push_back(PtxFeature);
671 }
672 
673 /// CUDA toolchain.  Our assembler is ptxas, and our "linker" is fatbinary,
674 /// which isn't properly a linker but nonetheless performs the step of stitching
675 /// together object files from the assembler into a single blob.
676 
677 CudaToolChain::CudaToolChain(const Driver &D, const llvm::Triple &Triple,
678                              const ToolChain &HostTC, const ArgList &Args,
679                              const Action::OffloadKind OK)
680     : ToolChain(D, Triple, Args), HostTC(HostTC),
681       CudaInstallation(D, HostTC.getTriple(), Args), OK(OK) {
682   if (CudaInstallation.isValid()) {
683     CudaInstallation.WarnIfUnsupportedVersion();
684     getProgramPaths().push_back(std::string(CudaInstallation.getBinPath()));
685   }
686   // Lookup binaries into the driver directory, this is used to
687   // discover the clang-offload-bundler executable.
688   getProgramPaths().push_back(getDriver().Dir);
689 }
690 
691 std::string CudaToolChain::getInputFilename(const InputInfo &Input) const {
692   // Only object files are changed, for example assembly files keep their .s
693   // extensions. CUDA also continues to use .o as they don't use nvlink but
694   // fatbinary.
695   if (!(OK == Action::OFK_OpenMP && Input.getType() == types::TY_Object))
696     return ToolChain::getInputFilename(Input);
697 
698   // Replace extension for object files with cubin because nvlink relies on
699   // these particular file names.
700   SmallString<256> Filename(ToolChain::getInputFilename(Input));
701   llvm::sys::path::replace_extension(Filename, "cubin");
702   return std::string(Filename.str());
703 }
704 
705 void CudaToolChain::addClangTargetOptions(
706     const llvm::opt::ArgList &DriverArgs,
707     llvm::opt::ArgStringList &CC1Args,
708     Action::OffloadKind DeviceOffloadingKind) const {
709   HostTC.addClangTargetOptions(DriverArgs, CC1Args, DeviceOffloadingKind);
710 
711   StringRef GpuArch = DriverArgs.getLastArgValue(options::OPT_march_EQ);
712   assert(!GpuArch.empty() && "Must have an explicit GPU arch.");
713   assert((DeviceOffloadingKind == Action::OFK_OpenMP ||
714           DeviceOffloadingKind == Action::OFK_Cuda) &&
715          "Only OpenMP or CUDA offloading kinds are supported for NVIDIA GPUs.");
716 
717   if (DeviceOffloadingKind == Action::OFK_Cuda) {
718     CC1Args.append(
719         {"-fcuda-is-device", "-mllvm", "-enable-memcpyopt-without-libcalls"});
720 
721     if (DriverArgs.hasFlag(options::OPT_fcuda_approx_transcendentals,
722                            options::OPT_fno_cuda_approx_transcendentals, false))
723       CC1Args.push_back("-fcuda-approx-transcendentals");
724   }
725 
726   if (DriverArgs.hasArg(options::OPT_nogpulib))
727     return;
728 
729   if (DeviceOffloadingKind == Action::OFK_OpenMP &&
730       DriverArgs.hasArg(options::OPT_S))
731     return;
732 
733   std::string LibDeviceFile = CudaInstallation.getLibDeviceFile(GpuArch);
734   if (LibDeviceFile.empty()) {
735     getDriver().Diag(diag::err_drv_no_cuda_libdevice) << GpuArch;
736     return;
737   }
738 
739   CC1Args.push_back("-mlink-builtin-bitcode");
740   CC1Args.push_back(DriverArgs.MakeArgString(LibDeviceFile));
741 
742   clang::CudaVersion CudaInstallationVersion = CudaInstallation.version();
743 
744   std::vector<StringRef> Features;
745   NVPTX::getNVPTXTargetFeatures(getDriver(), getTriple(), DriverArgs, Features,
746                                 CudaInstallationVersion);
747   for (StringRef PtxFeature : Features)
748     CC1Args.append({"-target-feature", DriverArgs.MakeArgString(PtxFeature)});
749   if (DriverArgs.hasFlag(options::OPT_fcuda_short_ptr,
750                          options::OPT_fno_cuda_short_ptr, false))
751     CC1Args.append({"-mllvm", "--nvptx-short-ptr"});
752 
753   if (CudaInstallationVersion >= CudaVersion::UNKNOWN)
754     CC1Args.push_back(
755         DriverArgs.MakeArgString(Twine("-target-sdk-version=") +
756                                  CudaVersionToString(CudaInstallationVersion)));
757 
758   if (DeviceOffloadingKind == Action::OFK_OpenMP) {
759     if (CudaInstallationVersion < CudaVersion::CUDA_92) {
760       getDriver().Diag(
761           diag::err_drv_omp_offload_target_cuda_version_not_support)
762           << CudaVersionToString(CudaInstallationVersion);
763       return;
764     }
765 
766     // Link the bitcode library late if we're using device LTO.
767     if (getDriver().isUsingLTO(/* IsOffload */ true))
768       return;
769 
770     addOpenMPDeviceRTL(getDriver(), DriverArgs, CC1Args, GpuArch.str(),
771                        getTriple());
772     AddStaticDeviceLibsPostLinking(getDriver(), DriverArgs, CC1Args, "nvptx",
773                                    GpuArch, /*isBitCodeSDL=*/true,
774                                    /*postClangLink=*/true);
775   }
776 }
777 
778 llvm::DenormalMode CudaToolChain::getDefaultDenormalModeForType(
779     const llvm::opt::ArgList &DriverArgs, const JobAction &JA,
780     const llvm::fltSemantics *FPType) const {
781   if (JA.getOffloadingDeviceKind() == Action::OFK_Cuda) {
782     if (FPType && FPType == &llvm::APFloat::IEEEsingle() &&
783         DriverArgs.hasFlag(options::OPT_fgpu_flush_denormals_to_zero,
784                            options::OPT_fno_gpu_flush_denormals_to_zero, false))
785       return llvm::DenormalMode::getPreserveSign();
786   }
787 
788   assert(JA.getOffloadingDeviceKind() != Action::OFK_Host);
789   return llvm::DenormalMode::getIEEE();
790 }
791 
792 bool CudaToolChain::supportsDebugInfoOption(const llvm::opt::Arg *A) const {
793   const Option &O = A->getOption();
794   return (O.matches(options::OPT_gN_Group) &&
795           !O.matches(options::OPT_gmodules)) ||
796          O.matches(options::OPT_g_Flag) ||
797          O.matches(options::OPT_ggdbN_Group) || O.matches(options::OPT_ggdb) ||
798          O.matches(options::OPT_gdwarf) || O.matches(options::OPT_gdwarf_2) ||
799          O.matches(options::OPT_gdwarf_3) || O.matches(options::OPT_gdwarf_4) ||
800          O.matches(options::OPT_gdwarf_5) ||
801          O.matches(options::OPT_gcolumn_info);
802 }
803 
804 void CudaToolChain::adjustDebugInfoKind(
805     codegenoptions::DebugInfoKind &DebugInfoKind, const ArgList &Args) const {
806   switch (mustEmitDebugInfo(Args)) {
807   case DisableDebugInfo:
808     DebugInfoKind = codegenoptions::NoDebugInfo;
809     break;
810   case DebugDirectivesOnly:
811     DebugInfoKind = codegenoptions::DebugDirectivesOnly;
812     break;
813   case EmitSameDebugInfoAsHost:
814     // Use same debug info level as the host.
815     break;
816   }
817 }
818 
819 void CudaToolChain::AddCudaIncludeArgs(const ArgList &DriverArgs,
820                                        ArgStringList &CC1Args) const {
821   // Check our CUDA version if we're going to include the CUDA headers.
822   if (!DriverArgs.hasArg(options::OPT_nogpuinc) &&
823       !DriverArgs.hasArg(options::OPT_no_cuda_version_check)) {
824     StringRef Arch = DriverArgs.getLastArgValue(options::OPT_march_EQ);
825     assert(!Arch.empty() && "Must have an explicit GPU arch.");
826     CudaInstallation.CheckCudaVersionSupportsArch(StringToCudaArch(Arch));
827   }
828   CudaInstallation.AddCudaIncludeArgs(DriverArgs, CC1Args);
829 }
830 
831 llvm::opt::DerivedArgList *
832 CudaToolChain::TranslateArgs(const llvm::opt::DerivedArgList &Args,
833                              StringRef BoundArch,
834                              Action::OffloadKind DeviceOffloadKind) const {
835   DerivedArgList *DAL =
836       HostTC.TranslateArgs(Args, BoundArch, DeviceOffloadKind);
837   if (!DAL)
838     DAL = new DerivedArgList(Args.getBaseArgs());
839 
840   const OptTable &Opts = getDriver().getOpts();
841 
842   // For OpenMP device offloading, append derived arguments. Make sure
843   // flags are not duplicated.
844   // Also append the compute capability.
845   if (DeviceOffloadKind == Action::OFK_OpenMP) {
846     for (Arg *A : Args)
847       if (!llvm::is_contained(*DAL, A))
848         DAL->append(A);
849 
850     if (!DAL->hasArg(options::OPT_march_EQ))
851       DAL->AddJoinedArg(nullptr, Opts.getOption(options::OPT_march_EQ),
852                         !BoundArch.empty() ? BoundArch
853                                            : CLANG_OPENMP_NVPTX_DEFAULT_ARCH);
854 
855     return DAL;
856   }
857 
858   for (Arg *A : Args) {
859     DAL->append(A);
860   }
861 
862   if (!BoundArch.empty()) {
863     DAL->eraseArg(options::OPT_march_EQ);
864     DAL->AddJoinedArg(nullptr, Opts.getOption(options::OPT_march_EQ), BoundArch);
865   }
866   return DAL;
867 }
868 
869 Tool *CudaToolChain::buildAssembler() const {
870   return new tools::NVPTX::Assembler(*this);
871 }
872 
873 Tool *CudaToolChain::buildLinker() const {
874   if (OK == Action::OFK_OpenMP)
875     return new tools::NVPTX::OpenMPLinker(*this);
876   return new tools::NVPTX::Linker(*this);
877 }
878 
879 void CudaToolChain::addClangWarningOptions(ArgStringList &CC1Args) const {
880   HostTC.addClangWarningOptions(CC1Args);
881 }
882 
883 ToolChain::CXXStdlibType
884 CudaToolChain::GetCXXStdlibType(const ArgList &Args) const {
885   return HostTC.GetCXXStdlibType(Args);
886 }
887 
888 void CudaToolChain::AddClangSystemIncludeArgs(const ArgList &DriverArgs,
889                                               ArgStringList &CC1Args) const {
890   HostTC.AddClangSystemIncludeArgs(DriverArgs, CC1Args);
891 
892   if (!DriverArgs.hasArg(options::OPT_nogpuinc) && CudaInstallation.isValid())
893     CC1Args.append(
894         {"-internal-isystem",
895          DriverArgs.MakeArgString(CudaInstallation.getIncludePath())});
896 }
897 
898 void CudaToolChain::AddClangCXXStdlibIncludeArgs(const ArgList &Args,
899                                                  ArgStringList &CC1Args) const {
900   HostTC.AddClangCXXStdlibIncludeArgs(Args, CC1Args);
901 }
902 
903 void CudaToolChain::AddIAMCUIncludeArgs(const ArgList &Args,
904                                         ArgStringList &CC1Args) const {
905   HostTC.AddIAMCUIncludeArgs(Args, CC1Args);
906 }
907 
908 SanitizerMask CudaToolChain::getSupportedSanitizers() const {
909   // The CudaToolChain only supports sanitizers in the sense that it allows
910   // sanitizer arguments on the command line if they are supported by the host
911   // toolchain. The CudaToolChain will actually ignore any command line
912   // arguments for any of these "supported" sanitizers. That means that no
913   // sanitization of device code is actually supported at this time.
914   //
915   // This behavior is necessary because the host and device toolchains
916   // invocations often share the command line, so the device toolchain must
917   // tolerate flags meant only for the host toolchain.
918   return HostTC.getSupportedSanitizers();
919 }
920 
921 VersionTuple CudaToolChain::computeMSVCVersion(const Driver *D,
922                                                const ArgList &Args) const {
923   return HostTC.computeMSVCVersion(D, Args);
924 }
925