1//===--- Gnu.h - Gnu 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#ifndef LLVM_CLANG_LIB_DRIVER_TOOLCHAINS_GNU_H
10#define LLVM_CLANG_LIB_DRIVER_TOOLCHAINS_GNU_H
11
12#include "Cuda.h"
13#include "ROCm.h"
14#include "clang/Driver/Tool.h"
15#include "clang/Driver/ToolChain.h"
16#include <set>
17
18namespace clang {
19namespace driver {
20
21struct DetectedMultilibs {
22  /// The set of multilibs that the detected installation supports.
23  MultilibSet Multilibs;
24
25  /// The primary multilib appropriate for the given flags.
26  Multilib SelectedMultilib;
27
28  /// On Biarch systems, this corresponds to the default multilib when
29  /// targeting the non-default multilib. Otherwise, it is empty.
30  std::optional<Multilib> BiarchSibling;
31};
32
33bool findMIPSMultilibs(const Driver &D, const llvm::Triple &TargetTriple,
34                       StringRef Path, const llvm::opt::ArgList &Args,
35                       DetectedMultilibs &Result);
36
37namespace tools {
38
39/// Directly call GNU Binutils' assembler and linker.
40namespace gnutools {
41class LLVM_LIBRARY_VISIBILITY Assembler : public Tool {
42public:
43  Assembler(const ToolChain &TC) : Tool("GNU::Assembler", "assembler", TC) {}
44
45  bool hasIntegratedCPP() const override { return false; }
46
47  void ConstructJob(Compilation &C, const JobAction &JA,
48                    const InputInfo &Output, const InputInfoList &Inputs,
49                    const llvm::opt::ArgList &TCArgs,
50                    const char *LinkingOutput) const override;
51};
52
53class LLVM_LIBRARY_VISIBILITY Linker : public Tool {
54public:
55  Linker(const ToolChain &TC) : Tool("GNU::Linker", "linker", TC) {}
56
57  bool hasIntegratedCPP() const override { return false; }
58  bool isLinkJob() const override { return true; }
59
60  void ConstructJob(Compilation &C, const JobAction &JA,
61                    const InputInfo &Output, const InputInfoList &Inputs,
62                    const llvm::opt::ArgList &TCArgs,
63                    const char *LinkingOutput) const override;
64};
65
66class LLVM_LIBRARY_VISIBILITY StaticLibTool : public Tool {
67public:
68  StaticLibTool(const ToolChain &TC)
69      : Tool("GNU::StaticLibTool", "static-lib-linker", TC) {}
70
71  bool hasIntegratedCPP() const override { return false; }
72  bool isLinkJob() const override { return true; }
73
74  void ConstructJob(Compilation &C, const JobAction &JA,
75                    const InputInfo &Output, const InputInfoList &Inputs,
76                    const llvm::opt::ArgList &TCArgs,
77                    const char *LinkingOutput) const override;
78};
79} // end namespace gnutools
80
81/// gcc - Generic GCC tool implementations.
82namespace gcc {
83class LLVM_LIBRARY_VISIBILITY Common : public Tool {
84public:
85  Common(const char *Name, const char *ShortName, const ToolChain &TC)
86      : Tool(Name, ShortName, TC) {}
87
88  // A gcc tool has an "integrated" assembler that it will call to produce an
89  // object. Let it use that assembler so that we don't have to deal with
90  // assembly syntax incompatibilities.
91  bool hasIntegratedAssembler() const override { return true; }
92  void ConstructJob(Compilation &C, const JobAction &JA,
93                    const InputInfo &Output, const InputInfoList &Inputs,
94                    const llvm::opt::ArgList &TCArgs,
95                    const char *LinkingOutput) const override;
96
97  /// RenderExtraToolArgs - Render any arguments necessary to force
98  /// the particular tool mode.
99  virtual void RenderExtraToolArgs(const JobAction &JA,
100                                   llvm::opt::ArgStringList &CmdArgs) const = 0;
101};
102
103class LLVM_LIBRARY_VISIBILITY Preprocessor : public Common {
104public:
105  Preprocessor(const ToolChain &TC)
106      : Common("gcc::Preprocessor", "gcc preprocessor", TC) {}
107
108  bool hasGoodDiagnostics() const override { return true; }
109  bool hasIntegratedCPP() const override { return false; }
110
111  void RenderExtraToolArgs(const JobAction &JA,
112                           llvm::opt::ArgStringList &CmdArgs) const override;
113};
114
115class LLVM_LIBRARY_VISIBILITY Compiler : public Common {
116public:
117  Compiler(const ToolChain &TC) : Common("gcc::Compiler", "gcc frontend", TC) {}
118
119  bool hasGoodDiagnostics() const override { return true; }
120  bool hasIntegratedCPP() const override { return true; }
121
122  void RenderExtraToolArgs(const JobAction &JA,
123                           llvm::opt::ArgStringList &CmdArgs) const override;
124};
125
126class LLVM_LIBRARY_VISIBILITY Linker : public Common {
127public:
128  Linker(const ToolChain &TC) : Common("gcc::Linker", "linker (via gcc)", TC) {}
129
130  bool hasIntegratedCPP() const override { return false; }
131  bool isLinkJob() const override { return true; }
132
133  void RenderExtraToolArgs(const JobAction &JA,
134                           llvm::opt::ArgStringList &CmdArgs) const override;
135};
136} // end namespace gcc
137} // end namespace tools
138
139namespace toolchains {
140
141/// Generic_GCC - A tool chain using the 'gcc' command to perform
142/// all subcommands; this relies on gcc translating the majority of
143/// command line options.
144class LLVM_LIBRARY_VISIBILITY Generic_GCC : public ToolChain {
145public:
146  /// Struct to store and manipulate GCC versions.
147  ///
148  /// We rely on assumptions about the form and structure of GCC version
149  /// numbers: they consist of at most three '.'-separated components, and each
150  /// component is a non-negative integer except for the last component. For
151  /// the last component we are very flexible in order to tolerate release
152  /// candidates or 'x' wildcards.
153  ///
154  /// Note that the ordering established among GCCVersions is based on the
155  /// preferred version string to use. For example we prefer versions without
156  /// a hard-coded patch number to those with a hard coded patch number.
157  ///
158  /// Currently this doesn't provide any logic for textual suffixes to patches
159  /// in the way that (for example) Debian's version format does. If that ever
160  /// becomes necessary, it can be added.
161  struct GCCVersion {
162    /// The unparsed text of the version.
163    std::string Text;
164
165    /// The parsed major, minor, and patch numbers.
166    int Major, Minor, Patch;
167
168    /// The text of the parsed major, and major+minor versions.
169    std::string MajorStr, MinorStr;
170
171    /// Any textual suffix on the patch number.
172    std::string PatchSuffix;
173
174    static GCCVersion Parse(StringRef VersionText);
175    bool isOlderThan(int RHSMajor, int RHSMinor, int RHSPatch,
176                     StringRef RHSPatchSuffix = StringRef()) const;
177    bool operator<(const GCCVersion &RHS) const {
178      return isOlderThan(RHS.Major, RHS.Minor, RHS.Patch, RHS.PatchSuffix);
179    }
180    bool operator>(const GCCVersion &RHS) const { return RHS < *this; }
181    bool operator<=(const GCCVersion &RHS) const { return !(*this > RHS); }
182    bool operator>=(const GCCVersion &RHS) const { return !(*this < RHS); }
183  };
184
185  /// This is a class to find a viable GCC installation for Clang to
186  /// use.
187  ///
188  /// This class tries to find a GCC installation on the system, and report
189  /// information about it. It starts from the host information provided to the
190  /// Driver, and has logic for fuzzing that where appropriate.
191  class GCCInstallationDetector {
192    bool IsValid;
193    llvm::Triple GCCTriple;
194    const Driver &D;
195
196    // FIXME: These might be better as path objects.
197    std::string GCCInstallPath;
198    std::string GCCParentLibPath;
199
200    /// The primary multilib appropriate for the given flags.
201    Multilib SelectedMultilib;
202    /// On Biarch systems, this corresponds to the default multilib when
203    /// targeting the non-default multilib. Otherwise, it is empty.
204    std::optional<Multilib> BiarchSibling;
205
206    GCCVersion Version;
207
208    // We retain the list of install paths that were considered and rejected in
209    // order to print out detailed information in verbose mode.
210    std::set<std::string> CandidateGCCInstallPaths;
211
212    /// The set of multilibs that the detected installation supports.
213    MultilibSet Multilibs;
214
215    // Gentoo-specific toolchain configurations are stored here.
216    const std::string GentooConfigDir = "/etc/env.d/gcc";
217
218  public:
219    explicit GCCInstallationDetector(const Driver &D) : IsValid(false), D(D) {}
220    void init(const llvm::Triple &TargetTriple, const llvm::opt::ArgList &Args,
221              ArrayRef<std::string> ExtraTripleAliases = std::nullopt);
222
223    /// Check whether we detected a valid GCC install.
224    bool isValid() const { return IsValid; }
225
226    /// Get the GCC triple for the detected install.
227    const llvm::Triple &getTriple() const { return GCCTriple; }
228
229    /// Get the detected GCC installation path.
230    StringRef getInstallPath() const { return GCCInstallPath; }
231
232    /// Get the detected GCC parent lib path.
233    StringRef getParentLibPath() const { return GCCParentLibPath; }
234
235    /// Get the detected Multilib
236    const Multilib &getMultilib() const { return SelectedMultilib; }
237
238    /// Get the whole MultilibSet
239    const MultilibSet &getMultilibs() const { return Multilibs; }
240
241    /// Get the biarch sibling multilib (if it exists).
242    /// \return true iff such a sibling exists
243    bool getBiarchSibling(Multilib &M) const;
244
245    /// Get the detected GCC version string.
246    const GCCVersion &getVersion() const { return Version; }
247
248    /// Print information about the detected GCC installation.
249    void print(raw_ostream &OS) const;
250
251  private:
252    static void
253    CollectLibDirsAndTriples(const llvm::Triple &TargetTriple,
254                             const llvm::Triple &BiarchTriple,
255                             SmallVectorImpl<StringRef> &LibDirs,
256                             SmallVectorImpl<StringRef> &TripleAliases,
257                             SmallVectorImpl<StringRef> &BiarchLibDirs,
258                             SmallVectorImpl<StringRef> &BiarchTripleAliases);
259
260    void AddDefaultGCCPrefixes(const llvm::Triple &TargetTriple,
261                               SmallVectorImpl<std::string> &Prefixes,
262                               StringRef SysRoot);
263
264    bool ScanGCCForMultilibs(const llvm::Triple &TargetTriple,
265                             const llvm::opt::ArgList &Args,
266                             StringRef Path,
267                             bool NeedsBiarchSuffix = false);
268
269    void ScanLibDirForGCCTriple(const llvm::Triple &TargetArch,
270                                const llvm::opt::ArgList &Args,
271                                const std::string &LibDir,
272                                StringRef CandidateTriple,
273                                bool NeedsBiarchSuffix, bool GCCDirExists,
274                                bool GCCCrossDirExists);
275
276    bool ScanGentooConfigs(const llvm::Triple &TargetTriple,
277                           const llvm::opt::ArgList &Args,
278                           const SmallVectorImpl<StringRef> &CandidateTriples,
279                           const SmallVectorImpl<StringRef> &BiarchTriples);
280
281    bool ScanGentooGccConfig(const llvm::Triple &TargetTriple,
282                             const llvm::opt::ArgList &Args,
283                             StringRef CandidateTriple,
284                             bool NeedsBiarchSuffix = false);
285  };
286
287protected:
288  GCCInstallationDetector GCCInstallation;
289  CudaInstallationDetector CudaInstallation;
290  RocmInstallationDetector RocmInstallation;
291
292public:
293  Generic_GCC(const Driver &D, const llvm::Triple &Triple,
294              const llvm::opt::ArgList &Args);
295  ~Generic_GCC() override;
296
297  void printVerboseInfo(raw_ostream &OS) const override;
298
299  UnwindTableLevel
300  getDefaultUnwindTableLevel(const llvm::opt::ArgList &Args) const override;
301  bool isPICDefault() const override;
302  bool isPIEDefault(const llvm::opt::ArgList &Args) const override;
303  bool isPICDefaultForced() const override;
304  bool IsIntegratedAssemblerDefault() const override;
305  llvm::opt::DerivedArgList *
306  TranslateArgs(const llvm::opt::DerivedArgList &Args, StringRef BoundArch,
307                Action::OffloadKind DeviceOffloadKind) const override;
308
309protected:
310  Tool *getTool(Action::ActionClass AC) const override;
311  Tool *buildAssembler() const override;
312  Tool *buildLinker() const override;
313
314  /// \name ToolChain Implementation Helper Functions
315  /// @{
316
317  /// Check whether the target triple's architecture is 64-bits.
318  bool isTarget64Bit() const { return getTriple().isArch64Bit(); }
319
320  /// Check whether the target triple's architecture is 32-bits.
321  bool isTarget32Bit() const { return getTriple().isArch32Bit(); }
322
323  void PushPPaths(ToolChain::path_list &PPaths);
324  void AddMultilibPaths(const Driver &D, const std::string &SysRoot,
325                        const std::string &OSLibDir,
326                        const std::string &MultiarchTriple,
327                        path_list &Paths);
328  void AddMultiarchPaths(const Driver &D, const std::string &SysRoot,
329                         const std::string &OSLibDir, path_list &Paths);
330  void AddMultilibIncludeArgs(const llvm::opt::ArgList &DriverArgs,
331                              llvm::opt::ArgStringList &CC1Args) const;
332
333  // FIXME: This should be final, but the CrossWindows toolchain does weird
334  // things that can't be easily generalized.
335  void AddClangCXXStdlibIncludeArgs(
336      const llvm::opt::ArgList &DriverArgs,
337      llvm::opt::ArgStringList &CC1Args) const override;
338
339  virtual void
340  addLibCxxIncludePaths(const llvm::opt::ArgList &DriverArgs,
341                        llvm::opt::ArgStringList &CC1Args) const;
342  virtual void
343  addLibStdCxxIncludePaths(const llvm::opt::ArgList &DriverArgs,
344                           llvm::opt::ArgStringList &CC1Args) const;
345
346  bool addGCCLibStdCxxIncludePaths(const llvm::opt::ArgList &DriverArgs,
347                                   llvm::opt::ArgStringList &CC1Args,
348                                   StringRef DebianMultiarch) const;
349
350  bool addLibStdCXXIncludePaths(Twine IncludeDir, StringRef Triple,
351                                Twine IncludeSuffix,
352                                const llvm::opt::ArgList &DriverArgs,
353                                llvm::opt::ArgStringList &CC1Args,
354                                bool DetectDebian = false) const;
355
356  /// @}
357
358private:
359  mutable std::unique_ptr<tools::gcc::Preprocessor> Preprocess;
360  mutable std::unique_ptr<tools::gcc::Compiler> Compile;
361};
362
363class LLVM_LIBRARY_VISIBILITY Generic_ELF : public Generic_GCC {
364  virtual void anchor();
365
366public:
367  Generic_ELF(const Driver &D, const llvm::Triple &Triple,
368              const llvm::opt::ArgList &Args)
369      : Generic_GCC(D, Triple, Args) {}
370
371  void addClangTargetOptions(const llvm::opt::ArgList &DriverArgs,
372                             llvm::opt::ArgStringList &CC1Args,
373                             Action::OffloadKind DeviceOffloadKind) const override;
374
375  virtual std::string getDynamicLinker(const llvm::opt::ArgList &Args) const {
376    return {};
377  }
378
379  virtual void addExtraOpts(llvm::opt::ArgStringList &CmdArgs) const {}
380};
381
382} // end namespace toolchains
383} // end namespace driver
384} // end namespace clang
385
386#endif // LLVM_CLANG_LIB_DRIVER_TOOLCHAINS_GNU_H
387