| //===--- Clang.h - Clang Tool and ToolChain Implementations ====-*- C++ -*-===// |
| // |
| // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions. |
| // See https://llvm.org/LICENSE.txt for license information. |
| // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception |
| // |
| //===----------------------------------------------------------------------===// |
| |
| #ifndef LLVM_CLANG_LIB_DRIVER_TOOLCHAINS_CLANG_H |
| #define LLVM_CLANG_LIB_DRIVER_TOOLCHAINS_CLANG_H |
| |
| #include "MSVC.h" |
| #include "clang/Driver/Driver.h" |
| #include "clang/Driver/Tool.h" |
| #include "clang/Driver/Types.h" |
| #include "llvm/Frontend/Debug/Options.h" |
| #include "llvm/Option/Option.h" |
| #include "llvm/Support/raw_ostream.h" |
| #include "llvm/TargetParser/Triple.h" |
| |
| namespace clang { |
| class ObjCRuntime; |
| namespace driver { |
| |
| namespace tools { |
| |
| /// Clang compiler tool. |
| class LLVM_LIBRARY_VISIBILITY Clang : public Tool { |
| // Indicates whether this instance has integrated backend using |
| // internal LLVM infrastructure. |
| bool HasBackend; |
| |
| public: |
| static const char *getBaseInputName(const llvm::opt::ArgList &Args, |
| const InputInfo &Input); |
| static const char *getBaseInputStem(const llvm::opt::ArgList &Args, |
| const InputInfoList &Inputs); |
| static const char *getDependencyFileName(const llvm::opt::ArgList &Args, |
| const InputInfoList &Inputs); |
| |
| private: |
| void AddPreprocessingOptions(Compilation &C, const JobAction &JA, |
| const Driver &D, const llvm::opt::ArgList &Args, |
| llvm::opt::ArgStringList &CmdArgs, |
| const InputInfo &Output, |
| const InputInfoList &Inputs) const; |
| |
| void RenderTargetOptions(const llvm::Triple &EffectiveTriple, |
| const llvm::opt::ArgList &Args, bool KernelOrKext, |
| llvm::opt::ArgStringList &CmdArgs) const; |
| |
| void AddAArch64TargetArgs(const llvm::opt::ArgList &Args, |
| llvm::opt::ArgStringList &CmdArgs) const; |
| void AddARMTargetArgs(const llvm::Triple &Triple, |
| const llvm::opt::ArgList &Args, |
| llvm::opt::ArgStringList &CmdArgs, |
| bool KernelOrKext) const; |
| void AddARM64TargetArgs(const llvm::opt::ArgList &Args, |
| llvm::opt::ArgStringList &CmdArgs) const; |
| void AddLoongArchTargetArgs(const llvm::opt::ArgList &Args, |
| llvm::opt::ArgStringList &CmdArgs) const; |
| void AddMIPSTargetArgs(const llvm::opt::ArgList &Args, |
| llvm::opt::ArgStringList &CmdArgs) const; |
| void AddPPCTargetArgs(const llvm::opt::ArgList &Args, |
| llvm::opt::ArgStringList &CmdArgs) const; |
| void AddR600TargetArgs(const llvm::opt::ArgList &Args, |
| llvm::opt::ArgStringList &CmdArgs) const; |
| void AddRISCVTargetArgs(const llvm::opt::ArgList &Args, |
| llvm::opt::ArgStringList &CmdArgs) const; |
| void AddSparcTargetArgs(const llvm::opt::ArgList &Args, |
| llvm::opt::ArgStringList &CmdArgs) const; |
| void AddSystemZTargetArgs(const llvm::opt::ArgList &Args, |
| llvm::opt::ArgStringList &CmdArgs) const; |
| void AddX86TargetArgs(const llvm::opt::ArgList &Args, |
| llvm::opt::ArgStringList &CmdArgs) const; |
| void AddHexagonTargetArgs(const llvm::opt::ArgList &Args, |
| llvm::opt::ArgStringList &CmdArgs) const; |
| void AddLanaiTargetArgs(const llvm::opt::ArgList &Args, |
| llvm::opt::ArgStringList &CmdArgs) const; |
| void AddWebAssemblyTargetArgs(const llvm::opt::ArgList &Args, |
| llvm::opt::ArgStringList &CmdArgs) const; |
| void AddVETargetArgs(const llvm::opt::ArgList &Args, |
| llvm::opt::ArgStringList &CmdArgs) const; |
| |
| enum RewriteKind { RK_None, RK_Fragile, RK_NonFragile }; |
| |
| ObjCRuntime AddObjCRuntimeArgs(const llvm::opt::ArgList &args, |
| const InputInfoList &inputs, |
| llvm::opt::ArgStringList &cmdArgs, |
| RewriteKind rewrite) const; |
| |
| void AddClangCLArgs(const llvm::opt::ArgList &Args, types::ID InputType, |
| llvm::opt::ArgStringList &CmdArgs) const; |
| |
| mutable std::unique_ptr<llvm::raw_fd_ostream> CompilationDatabase = nullptr; |
| void DumpCompilationDatabase(Compilation &C, StringRef Filename, |
| StringRef Target, |
| const InputInfo &Output, const InputInfo &Input, |
| const llvm::opt::ArgList &Args) const; |
| |
| void DumpCompilationDatabaseFragmentToDir( |
| StringRef Dir, Compilation &C, StringRef Target, const InputInfo &Output, |
| const InputInfo &Input, const llvm::opt::ArgList &Args) const; |
| |
| public: |
| Clang(const ToolChain &TC, bool HasIntegratedBackend = true); |
| ~Clang() override; |
| |
| bool hasGoodDiagnostics() const override { return true; } |
| bool hasIntegratedAssembler() const override { return true; } |
| bool hasIntegratedBackend() const override { return HasBackend; } |
| bool hasIntegratedCPP() const override { return true; } |
| bool canEmitIR() const override { return true; } |
| |
| void ConstructJob(Compilation &C, const JobAction &JA, |
| const InputInfo &Output, const InputInfoList &Inputs, |
| const llvm::opt::ArgList &TCArgs, |
| const char *LinkingOutput) const override; |
| }; |
| |
| /// Clang integrated assembler tool. |
| class LLVM_LIBRARY_VISIBILITY ClangAs : public Tool { |
| public: |
| ClangAs(const ToolChain &TC) |
| : Tool("clang::as", "clang integrated assembler", TC) {} |
| void AddLoongArchTargetArgs(const llvm::opt::ArgList &Args, |
| llvm::opt::ArgStringList &CmdArgs) const; |
| void AddMIPSTargetArgs(const llvm::opt::ArgList &Args, |
| llvm::opt::ArgStringList &CmdArgs) const; |
| void AddX86TargetArgs(const llvm::opt::ArgList &Args, |
| llvm::opt::ArgStringList &CmdArgs) const; |
| void AddRISCVTargetArgs(const llvm::opt::ArgList &Args, |
| llvm::opt::ArgStringList &CmdArgs) const; |
| bool hasGoodDiagnostics() const override { return true; } |
| bool hasIntegratedAssembler() const override { return false; } |
| bool hasIntegratedCPP() const override { return false; } |
| |
| void ConstructJob(Compilation &C, const JobAction &JA, |
| const InputInfo &Output, const InputInfoList &Inputs, |
| const llvm::opt::ArgList &TCArgs, |
| const char *LinkingOutput) const override; |
| }; |
| |
| /// Offload bundler tool. |
| class LLVM_LIBRARY_VISIBILITY OffloadBundler final : public Tool { |
| public: |
| OffloadBundler(const ToolChain &TC) |
| : Tool("offload bundler", "clang-offload-bundler", TC) {} |
| |
| bool hasIntegratedCPP() const override { return false; } |
| void ConstructJob(Compilation &C, const JobAction &JA, |
| const InputInfo &Output, const InputInfoList &Inputs, |
| const llvm::opt::ArgList &TCArgs, |
| const char *LinkingOutput) const override; |
| void ConstructJobMultipleOutputs(Compilation &C, const JobAction &JA, |
| const InputInfoList &Outputs, |
| const InputInfoList &Inputs, |
| const llvm::opt::ArgList &TCArgs, |
| const char *LinkingOutput) const override; |
| }; |
| |
| /// Offload binary tool. |
| class LLVM_LIBRARY_VISIBILITY OffloadPackager final : public Tool { |
| public: |
| OffloadPackager(const ToolChain &TC) |
| : Tool("Offload::Packager", "clang-offload-packager", TC) {} |
| |
| bool hasIntegratedCPP() const override { return false; } |
| void ConstructJob(Compilation &C, const JobAction &JA, |
| const InputInfo &Output, const InputInfoList &Inputs, |
| const llvm::opt::ArgList &TCArgs, |
| const char *LinkingOutput) const override; |
| }; |
| |
| /// Linker wrapper tool. |
| class LLVM_LIBRARY_VISIBILITY LinkerWrapper final : public Tool { |
| const Tool *Linker; |
| |
| public: |
| LinkerWrapper(const ToolChain &TC, const Tool *Linker) |
| : Tool("Offload::Linker", "linker", TC), Linker(Linker) {} |
| |
| bool hasIntegratedCPP() const override { return false; } |
| void ConstructJob(Compilation &C, const JobAction &JA, |
| const InputInfo &Output, const InputInfoList &Inputs, |
| const llvm::opt::ArgList &TCArgs, |
| const char *LinkingOutput) const override; |
| }; |
| |
| enum class DwarfFissionKind { None, Split, Single }; |
| |
| DwarfFissionKind getDebugFissionKind(const Driver &D, |
| const llvm::opt::ArgList &Args, |
| llvm::opt::Arg *&Arg); |
| |
| // Calculate the output path of the module file when compiling a module unit |
| // with the `-fmodule-output` option or `-fmodule-output=` option specified. |
| // The behavior is: |
| // - If `-fmodule-output=` is specfied, then the module file is |
| // writing to the value. |
| // - Otherwise if the output object file of the module unit is specified, the |
| // output path |
| // of the module file should be the same with the output object file except |
| // the corresponding suffix. This requires both `-o` and `-c` are specified. |
| // - Otherwise, the output path of the module file will be the same with the |
| // input with the corresponding suffix. |
| llvm::SmallString<256> |
| getCXX20NamedModuleOutputPath(const llvm::opt::ArgList &Args, |
| const char *BaseInput); |
| |
| } // end namespace tools |
| |
| } // end namespace driver |
| } // end namespace clang |
| |
| #endif // LLVM_CLANG_LIB_DRIVER_TOOLCHAINS_CLANG_H |