Coverage Report

Created: 2024-01-17 10:31

/src/llvm-project/clang/lib/Driver/ToolChains/HIPSPV.cpp
Line
Count
Source (jump to first uncovered line)
1
//===--- HIPSPV.cpp - HIPSPV ToolChain Implementation -----------*- 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 "HIPSPV.h"
10
#include "CommonArgs.h"
11
#include "HIPUtility.h"
12
#include "clang/Driver/Compilation.h"
13
#include "clang/Driver/Driver.h"
14
#include "clang/Driver/DriverDiagnostic.h"
15
#include "clang/Driver/InputInfo.h"
16
#include "clang/Driver/Options.h"
17
#include "llvm/Support/FileSystem.h"
18
#include "llvm/Support/Path.h"
19
20
using namespace clang::driver;
21
using namespace clang::driver::toolchains;
22
using namespace clang::driver::tools;
23
using namespace clang;
24
using namespace llvm::opt;
25
26
// Convenience function for creating temporary file for both modes of
27
// isSaveTempsEnabled().
28
static const char *getTempFile(Compilation &C, StringRef Prefix,
29
0
                               StringRef Extension) {
30
0
  if (C.getDriver().isSaveTempsEnabled()) {
31
0
    return C.getArgs().MakeArgString(Prefix + "." + Extension);
32
0
  }
33
0
  auto TmpFile = C.getDriver().GetTemporaryPath(Prefix, Extension);
34
0
  return C.addTempFile(C.getArgs().MakeArgString(TmpFile));
35
0
}
36
37
// Locates HIP pass plugin.
38
static std::string findPassPlugin(const Driver &D,
39
0
                                  const llvm::opt::ArgList &Args) {
40
0
  StringRef Path = Args.getLastArgValue(options::OPT_hipspv_pass_plugin_EQ);
41
0
  if (!Path.empty()) {
42
0
    if (llvm::sys::fs::exists(Path))
43
0
      return Path.str();
44
0
    D.Diag(diag::err_drv_no_such_file) << Path;
45
0
  }
46
47
0
  StringRef hipPath = Args.getLastArgValue(options::OPT_hip_path_EQ);
48
0
  if (!hipPath.empty()) {
49
0
    SmallString<128> PluginPath(hipPath);
50
0
    llvm::sys::path::append(PluginPath, "lib", "libLLVMHipSpvPasses.so");
51
0
    if (llvm::sys::fs::exists(PluginPath))
52
0
      return PluginPath.str().str();
53
0
    PluginPath.assign(hipPath);
54
0
    llvm::sys::path::append(PluginPath, "lib", "llvm",
55
0
                            "libLLVMHipSpvPasses.so");
56
0
    if (llvm::sys::fs::exists(PluginPath))
57
0
      return PluginPath.str().str();
58
0
  }
59
60
0
  return std::string();
61
0
}
62
63
void HIPSPV::Linker::constructLinkAndEmitSpirvCommand(
64
    Compilation &C, const JobAction &JA, const InputInfoList &Inputs,
65
0
    const InputInfo &Output, const llvm::opt::ArgList &Args) const {
66
67
0
  assert(!Inputs.empty() && "Must have at least one input.");
68
0
  std::string Name = std::string(llvm::sys::path::stem(Output.getFilename()));
69
0
  const char *TempFile = getTempFile(C, Name + "-link", "bc");
70
71
  // Link LLVM bitcode.
72
0
  ArgStringList LinkArgs{};
73
0
  for (auto Input : Inputs)
74
0
    LinkArgs.push_back(Input.getFilename());
75
0
  LinkArgs.append({"-o", TempFile});
76
0
  const char *LlvmLink =
77
0
      Args.MakeArgString(getToolChain().GetProgramPath("llvm-link"));
78
0
  C.addCommand(std::make_unique<Command>(JA, *this, ResponseFileSupport::None(),
79
0
                                         LlvmLink, LinkArgs, Inputs, Output));
80
81
  // Post-link HIP lowering.
82
83
  // Run LLVM IR passes to lower/expand/emulate HIP code that does not translate
84
  // to SPIR-V (E.g. dynamic shared memory).
85
0
  auto PassPluginPath = findPassPlugin(C.getDriver(), Args);
86
0
  if (!PassPluginPath.empty()) {
87
0
    const char *PassPathCStr = C.getArgs().MakeArgString(PassPluginPath);
88
0
    const char *OptOutput = getTempFile(C, Name + "-lower", "bc");
89
0
    ArgStringList OptArgs{TempFile,     "-load-pass-plugin",
90
0
                          PassPathCStr, "-passes=hip-post-link-passes",
91
0
                          "-o",         OptOutput};
92
0
    const char *Opt = Args.MakeArgString(getToolChain().GetProgramPath("opt"));
93
0
    C.addCommand(std::make_unique<Command>(
94
0
        JA, *this, ResponseFileSupport::None(), Opt, OptArgs, Inputs, Output));
95
0
    TempFile = OptOutput;
96
0
  }
97
98
  // Emit SPIR-V binary.
99
100
0
  llvm::opt::ArgStringList TrArgs{"--spirv-max-version=1.1",
101
0
                                  "--spirv-ext=+all"};
102
0
  InputInfo TrInput = InputInfo(types::TY_LLVM_BC, TempFile, "");
103
0
  SPIRV::constructTranslateCommand(C, *this, JA, Output, TrInput, TrArgs);
104
0
}
105
106
void HIPSPV::Linker::ConstructJob(Compilation &C, const JobAction &JA,
107
                                  const InputInfo &Output,
108
                                  const InputInfoList &Inputs,
109
                                  const ArgList &Args,
110
0
                                  const char *LinkingOutput) const {
111
0
  if (Inputs.size() > 0 && Inputs[0].getType() == types::TY_Image &&
112
0
      JA.getType() == types::TY_Object)
113
0
    return HIP::constructGenerateObjFileFromHIPFatBinary(C, Output, Inputs,
114
0
                                                         Args, JA, *this);
115
116
0
  if (JA.getType() == types::TY_HIP_FATBIN)
117
0
    return HIP::constructHIPFatbinCommand(C, JA, Output.getFilename(), Inputs,
118
0
                                          Args, *this);
119
120
0
  constructLinkAndEmitSpirvCommand(C, JA, Inputs, Output, Args);
121
0
}
122
123
HIPSPVToolChain::HIPSPVToolChain(const Driver &D, const llvm::Triple &Triple,
124
                                 const ToolChain &HostTC, const ArgList &Args)
125
0
    : ToolChain(D, Triple, Args), HostTC(HostTC) {
126
  // Lookup binaries into the driver directory, this is used to
127
  // discover the clang-offload-bundler executable.
128
0
  getProgramPaths().push_back(getDriver().Dir);
129
0
}
130
131
void HIPSPVToolChain::addClangTargetOptions(
132
    const llvm::opt::ArgList &DriverArgs, llvm::opt::ArgStringList &CC1Args,
133
0
    Action::OffloadKind DeviceOffloadingKind) const {
134
0
  HostTC.addClangTargetOptions(DriverArgs, CC1Args, DeviceOffloadingKind);
135
136
0
  assert(DeviceOffloadingKind == Action::OFK_HIP &&
137
0
         "Only HIP offloading kinds are supported for GPUs.");
138
139
0
  CC1Args.append(
140
0
      {"-fcuda-is-device", "-fcuda-allow-variadic-functions",
141
       // A crude workaround for llvm-spirv which does not handle the
142
       // autovectorized code well (vector reductions, non-i{8,16,32,64} types).
143
       // TODO: Allow autovectorization when SPIR-V backend arrives.
144
0
       "-mllvm", "-vectorize-loops=false", "-mllvm", "-vectorize-slp=false"});
145
146
  // Default to "hidden" visibility, as object level linking will not be
147
  // supported for the foreseeable future.
148
0
  if (!DriverArgs.hasArg(options::OPT_fvisibility_EQ,
149
0
                         options::OPT_fvisibility_ms_compat))
150
0
    CC1Args.append(
151
0
        {"-fvisibility=hidden", "-fapply-global-visibility-to-externs"});
152
153
0
  llvm::for_each(getDeviceLibs(DriverArgs),
154
0
                 [&](const BitCodeLibraryInfo &BCFile) {
155
0
                   CC1Args.append({"-mlink-builtin-bitcode",
156
0
                                   DriverArgs.MakeArgString(BCFile.Path)});
157
0
                 });
158
0
}
159
160
0
Tool *HIPSPVToolChain::buildLinker() const {
161
0
  assert(getTriple().getArch() == llvm::Triple::spirv64);
162
0
  return new tools::HIPSPV::Linker(*this);
163
0
}
164
165
0
void HIPSPVToolChain::addClangWarningOptions(ArgStringList &CC1Args) const {
166
0
  HostTC.addClangWarningOptions(CC1Args);
167
0
}
168
169
ToolChain::CXXStdlibType
170
0
HIPSPVToolChain::GetCXXStdlibType(const ArgList &Args) const {
171
0
  return HostTC.GetCXXStdlibType(Args);
172
0
}
173
174
void HIPSPVToolChain::AddClangSystemIncludeArgs(const ArgList &DriverArgs,
175
0
                                                ArgStringList &CC1Args) const {
176
0
  HostTC.AddClangSystemIncludeArgs(DriverArgs, CC1Args);
177
0
}
178
179
void HIPSPVToolChain::AddClangCXXStdlibIncludeArgs(
180
0
    const ArgList &Args, ArgStringList &CC1Args) const {
181
0
  HostTC.AddClangCXXStdlibIncludeArgs(Args, CC1Args);
182
0
}
183
184
void HIPSPVToolChain::AddIAMCUIncludeArgs(const ArgList &Args,
185
0
                                          ArgStringList &CC1Args) const {
186
0
  HostTC.AddIAMCUIncludeArgs(Args, CC1Args);
187
0
}
188
189
void HIPSPVToolChain::AddHIPIncludeArgs(const ArgList &DriverArgs,
190
0
                                        ArgStringList &CC1Args) const {
191
0
  if (DriverArgs.hasArg(options::OPT_nogpuinc))
192
0
    return;
193
194
0
  StringRef hipPath = DriverArgs.getLastArgValue(options::OPT_hip_path_EQ);
195
0
  if (hipPath.empty()) {
196
0
    getDriver().Diag(diag::err_drv_hipspv_no_hip_path) << 1 << "'-nogpuinc'";
197
0
    return;
198
0
  }
199
0
  SmallString<128> P(hipPath);
200
0
  llvm::sys::path::append(P, "include");
201
0
  CC1Args.append({"-isystem", DriverArgs.MakeArgString(P)});
202
0
}
203
204
llvm::SmallVector<ToolChain::BitCodeLibraryInfo, 12>
205
0
HIPSPVToolChain::getDeviceLibs(const llvm::opt::ArgList &DriverArgs) const {
206
0
  llvm::SmallVector<ToolChain::BitCodeLibraryInfo, 12> BCLibs;
207
0
  if (DriverArgs.hasArg(options::OPT_nogpulib))
208
0
    return {};
209
210
0
  ArgStringList LibraryPaths;
211
  // Find device libraries in --hip-device-lib-path and HIP_DEVICE_LIB_PATH.
212
0
  auto HipDeviceLibPathArgs = DriverArgs.getAllArgValues(
213
      // --hip-device-lib-path is alias to this option.
214
0
      clang::driver::options::OPT_rocm_device_lib_path_EQ);
215
0
  for (auto Path : HipDeviceLibPathArgs)
216
0
    LibraryPaths.push_back(DriverArgs.MakeArgString(Path));
217
218
0
  StringRef HipPath = DriverArgs.getLastArgValue(options::OPT_hip_path_EQ);
219
0
  if (!HipPath.empty()) {
220
0
    SmallString<128> Path(HipPath);
221
0
    llvm::sys::path::append(Path, "lib", "hip-device-lib");
222
0
    LibraryPaths.push_back(DriverArgs.MakeArgString(Path));
223
0
  }
224
225
0
  addDirectoryList(DriverArgs, LibraryPaths, "", "HIP_DEVICE_LIB_PATH");
226
227
  // Maintain compatability with --hip-device-lib.
228
0
  auto BCLibArgs = DriverArgs.getAllArgValues(options::OPT_hip_device_lib_EQ);
229
0
  if (!BCLibArgs.empty()) {
230
0
    llvm::for_each(BCLibArgs, [&](StringRef BCName) {
231
0
      StringRef FullName;
232
0
      for (std::string LibraryPath : LibraryPaths) {
233
0
        SmallString<128> Path(LibraryPath);
234
0
        llvm::sys::path::append(Path, BCName);
235
0
        FullName = Path;
236
0
        if (llvm::sys::fs::exists(FullName)) {
237
0
          BCLibs.emplace_back(FullName.str());
238
0
          return;
239
0
        }
240
0
      }
241
0
      getDriver().Diag(diag::err_drv_no_such_file) << BCName;
242
0
    });
243
0
  } else {
244
    // Search device library named as 'hipspv-<triple>.bc'.
245
0
    auto TT = getTriple().normalize();
246
0
    std::string BCName = "hipspv-" + TT + ".bc";
247
0
    for (auto *LibPath : LibraryPaths) {
248
0
      SmallString<128> Path(LibPath);
249
0
      llvm::sys::path::append(Path, BCName);
250
0
      if (llvm::sys::fs::exists(Path)) {
251
0
        BCLibs.emplace_back(Path.str().str());
252
0
        return BCLibs;
253
0
      }
254
0
    }
255
0
    getDriver().Diag(diag::err_drv_no_hipspv_device_lib)
256
0
        << 1 << ("'" + TT + "' target");
257
0
    return {};
258
0
  }
259
260
0
  return BCLibs;
261
0
}
262
263
0
SanitizerMask HIPSPVToolChain::getSupportedSanitizers() const {
264
  // The HIPSPVToolChain only supports sanitizers in the sense that it allows
265
  // sanitizer arguments on the command line if they are supported by the host
266
  // toolchain. The HIPSPVToolChain will actually ignore any command line
267
  // arguments for any of these "supported" sanitizers. That means that no
268
  // sanitization of device code is actually supported at this time.
269
  //
270
  // This behavior is necessary because the host and device toolchains
271
  // invocations often share the command line, so the device toolchain must
272
  // tolerate flags meant only for the host toolchain.
273
0
  return HostTC.getSupportedSanitizers();
274
0
}
275
276
VersionTuple HIPSPVToolChain::computeMSVCVersion(const Driver *D,
277
0
                                                 const ArgList &Args) const {
278
0
  return HostTC.computeMSVCVersion(D, Args);
279
0
}
280
281
void HIPSPVToolChain::adjustDebugInfoKind(
282
    llvm::codegenoptions::DebugInfoKind &DebugInfoKind,
283
0
    const llvm::opt::ArgList &Args) const {
284
  // Debug info generation is disabled for SPIRV-LLVM-Translator
285
  // which currently aborts on the presence of DW_OP_LLVM_convert.
286
  // TODO: Enable debug info when the SPIR-V backend arrives.
287
0
  DebugInfoKind = llvm::codegenoptions::NoDebugInfo;
288
0
}