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