ToolChain - Access to tools for a single platform. More...

#include "clang/Driver/ToolChain.h"

Inheritance diagram for clang::driver::ToolChain:

[legend]

Classes
struct	BitCodeLibraryInfo

Public Types
enum	CXXStdlibType { CST_Libcxx , CST_Libstdcxx }

enum	RuntimeLibType { RLT_CompilerRT , RLT_Libgcc }

enum	UnwindLibType { UNW_None , UNW_CompilerRT , UNW_Libgcc }

enum class	UnwindTableLevel { None , Synchronous , Asynchronous }

enum	RTTIMode { RM_Enabled , RM_Disabled }

enum	FileType { FT_Object , FT_Static , FT_Shared }

using	path_list = SmallVector< std::string, 16 >

Public Member Functions
virtual	~ToolChain ()

const Driver &	getDriver () const

llvm::vfs::FileSystem &	getVFS () const

const llvm::Triple &	getTriple () const

virtual const llvm::Triple *	getAuxTriple () const
	Get the toolchain's aux triple, if it has one.

virtual std::string	getInputFilename (const InputInfo &Input) const
	Some toolchains need to modify the file name, for example to replace the extension for object files with .cubin for OpenMP offloading to Nvidia GPUs.

llvm::Triple::ArchType	getArch () const

StringRef	getArchName () const

StringRef	getPlatform () const

StringRef	getOS () const

StringRef	getDefaultUniversalArchName () const
	Provide the default architecture name (as expected by -arch) for this toolchain.

std::string	getTripleString () const

const llvm::Triple &	getEffectiveTriple () const
	Get the toolchain's effective clang triple.

bool	hasEffectiveTriple () const

path_list &	getLibraryPaths ()

const path_list &	getLibraryPaths () const

path_list &	getFilePaths ()

const path_list &	getFilePaths () const

path_list &	getProgramPaths ()

const path_list &	getProgramPaths () const

const MultilibSet &	getMultilibs () const

const llvm::SmallVector< Multilib > &	getSelectedMultilibs () const

Multilib::flags_list	getMultilibFlags (const llvm::opt::ArgList &) const
	Get flags suitable for multilib selection, based on the provided clang command line arguments.

SanitizerArgs	getSanitizerArgs (const llvm::opt::ArgList &JobArgs) const

const XRayArgs &	getXRayArgs () const

const llvm::opt::Arg *	getRTTIArg () const

RTTIMode	getRTTIMode () const

virtual llvm::opt::DerivedArgList *	TranslateArgs (const llvm::opt::DerivedArgList &Args, StringRef BoundArch, Action::OffloadKind DeviceOffloadKind) const
	TranslateArgs - Create a new derived argument list for any argument translations this ToolChain may wish to perform, or 0 if no tool chain specific translations are needed.

virtual llvm::opt::DerivedArgList *	TranslateOpenMPTargetArgs (const llvm::opt::DerivedArgList &Args, bool SameTripleAsHost, SmallVectorImpl< llvm::opt::Arg * > &AllocatedArgs) const
	TranslateOpenMPTargetArgs - Create a new derived argument list for that contains the OpenMP target specific flags passed via -Xopenmp-target -opt=val OR -Xopenmp-target=<triple> -opt=val.

virtual void	TranslateXarchArgs (const llvm::opt::DerivedArgList &Args, llvm::opt::Arg &A, llvm::opt::DerivedArgList DAL, SmallVectorImpl< llvm::opt::Arg * > *AllocatedArgs=nullptr) const
	Append the argument following `A` to `DAL` assuming `A` is an Xarch argument.

virtual llvm::opt::DerivedArgList *	TranslateXarchArgs (const llvm::opt::DerivedArgList &Args, StringRef BoundArch, Action::OffloadKind DeviceOffloadKind, SmallVectorImpl< llvm::opt::Arg * > *AllocatedArgs) const
	Translate -Xarch_ arguments.

virtual Tool *	SelectTool (const JobAction &JA) const
	Choose a tool to use to handle the action `JA`.

std::string	GetFilePath (const char *Name) const

std::string	GetProgramPath (const char *Name) const

std::string	GetLinkerPath (bool *LinkerIsLLD=nullptr) const
	Returns the linker path, respecting the -fuse-ld= argument to determine the linker suffix or name.

std::string	GetStaticLibToolPath () const
	Returns the linker path for emitting a static library.

virtual void	printVerboseInfo (raw_ostream &OS) const
	Dispatch to the specific toolchain for verbose printing.

virtual bool	isCrossCompiling () const
	Returns true if the toolchain is targeting a non-native architecture.

virtual bool	HasNativeLLVMSupport () const
	HasNativeLTOLinker - Check whether the linker and related tools have native LLVM support.

virtual types::ID	LookupTypeForExtension (StringRef Ext) const
	LookupTypeForExtension - Return the default language type to use for the given extension.

virtual bool	IsBlocksDefault () const
	IsBlocksDefault - Does this tool chain enable -fblocks by default.

virtual bool	IsIntegratedAssemblerDefault () const
	IsIntegratedAssemblerDefault - Does this tool chain enable -integrated-as by default.

virtual bool	IsIntegratedBackendDefault () const
	IsIntegratedBackendDefault - Does this tool chain enable -fintegrated-objemitter by default.

virtual bool	IsIntegratedBackendSupported () const
	IsIntegratedBackendSupported - Does this tool chain support -fintegrated-objemitter.

virtual bool	IsNonIntegratedBackendSupported () const
	IsNonIntegratedBackendSupported - Does this tool chain support -fno-integrated-objemitter.

virtual bool	useIntegratedAs () const
	Check if the toolchain should use the integrated assembler.

virtual bool	useIntegratedBackend () const
	Check if the toolchain should use the integrated backend.

virtual bool	parseInlineAsmUsingAsmParser () const
	Check if the toolchain should use AsmParser to parse inlineAsm when integrated assembler is not default.

virtual bool	IsMathErrnoDefault () const
	IsMathErrnoDefault - Does this tool chain use -fmath-errno by default.

virtual bool	IsEncodeExtendedBlockSignatureDefault () const
	IsEncodeExtendedBlockSignatureDefault - Does this tool chain enable -fencode-extended-block-signature by default.

virtual bool	IsObjCNonFragileABIDefault () const
	IsObjCNonFragileABIDefault - Does this tool chain set -fobjc-nonfragile-abi by default.

virtual bool	UseObjCMixedDispatch () const
	UseObjCMixedDispatchDefault - When using non-legacy dispatch, should the mixed dispatch method be used?

virtual bool	useRelaxRelocations () const
	Check whether to enable x86 relax relocations by default.

bool	defaultToIEEELongDouble () const
	Check whether use IEEE binary128 as long double format by default.

virtual LangOptions::StackProtectorMode	GetDefaultStackProtectorLevel (bool KernelOrKext) const
	GetDefaultStackProtectorLevel - Get the default stack protector level for this tool chain.

virtual LangOptions::TrivialAutoVarInitKind	GetDefaultTrivialAutoVarInit () const
	Get the default trivial automatic variable initialization.

virtual const char *	getDefaultLinker () const
	GetDefaultLinker - Get the default linker to use.

virtual RuntimeLibType	GetDefaultRuntimeLibType () const
	GetDefaultRuntimeLibType - Get the default runtime library variant to use.

virtual CXXStdlibType	GetDefaultCXXStdlibType () const

virtual UnwindLibType	GetDefaultUnwindLibType () const

virtual std::string	getCompilerRTPath () const

virtual std::string	getCompilerRT (const llvm::opt::ArgList &Args, StringRef Component, FileType Type=ToolChain::FT_Static) const

const char *	getCompilerRTArgString (const llvm::opt::ArgList &Args, StringRef Component, FileType Type=ToolChain::FT_Static) const

std::string	getCompilerRTBasename (const llvm::opt::ArgList &Args, StringRef Component, FileType Type=ToolChain::FT_Static) const

std::optional< std::string >	getRuntimePath () const

std::optional< std::string >	getStdlibPath () const

virtual path_list	getArchSpecificLibPaths () const

virtual StringRef	getOSLibName () const

virtual UnwindTableLevel	getDefaultUnwindTableLevel (const llvm::opt::ArgList &Args) const
	How detailed should the unwind tables be by default.

virtual bool	IsAArch64OutlineAtomicsDefault (const llvm::opt::ArgList &Args) const
	Test whether this toolchain supports outline atomics by default.

virtual bool	isPICDefault () const =0
	Test whether this toolchain defaults to PIC.

virtual bool	isPIEDefault (const llvm::opt::ArgList &Args) const =0
	Test whether this toolchain defaults to PIE.

virtual bool	isPICDefaultForced () const =0
	Tests whether this toolchain forces its default for PIC, PIE or non-PIC.

virtual bool	SupportsProfiling () const
	SupportsProfiling - Does this tool chain support -pg.

virtual void	CheckObjCARC () const
	Complain if this tool chain doesn't support Objective-C ARC.

virtual llvm::codegenoptions::DebugInfoFormat	getDefaultDebugFormat () const
	Get the default debug info format. Typically, this is DWARF.

virtual bool	UseDwarfDebugFlags () const
	UseDwarfDebugFlags - Embed the compile options to clang into the Dwarf compile unit information.

virtual std::string	GetGlobalDebugPathRemapping () const
	Add an additional -fdebug-prefix-map entry.

virtual unsigned	GetDefaultDwarfVersion () const

virtual unsigned	getMaxDwarfVersion () const

virtual bool	GetDefaultStandaloneDebug () const

virtual llvm::DebuggerKind	getDefaultDebuggerTuning () const

virtual bool	supportsDebugInfoOption (const llvm::opt::Arg *) const
	Does this toolchain supports given debug info option or not.

virtual void	adjustDebugInfoKind (llvm::codegenoptions::DebugInfoKind &DebugInfoKind, const llvm::opt::ArgList &Args) const
	Adjust debug information kind considering all passed options.

virtual llvm::ExceptionHandling	GetExceptionModel (const llvm::opt::ArgList &Args) const
	GetExceptionModel - Return the tool chain exception model.

virtual bool	SupportsEmbeddedBitcode () const
	SupportsEmbeddedBitcode - Does this tool chain support embedded bitcode.

virtual std::string	getThreadModel () const
	getThreadModel() - Which thread model does this target use?

virtual bool	isThreadModelSupported (const StringRef Model) const
	isThreadModelSupported() - Does this target support a thread model?

virtual bool	isBareMetal () const
	isBareMetal - Is this a bare metal target.

virtual std::string	getMultiarchTriple (const Driver &D, const llvm::Triple &TargetTriple, StringRef SysRoot) const

virtual std::string	ComputeLLVMTriple (const llvm::opt::ArgList &Args, types::ID InputType=types::TY_INVALID) const
	ComputeLLVMTriple - Return the LLVM target triple to use, after taking command line arguments into account.

virtual std::string	ComputeEffectiveClangTriple (const llvm::opt::ArgList &Args, types::ID InputType=types::TY_INVALID) const
	ComputeEffectiveClangTriple - Return the Clang triple to use for this target, which may take into account the command line arguments.

virtual ObjCRuntime	getDefaultObjCRuntime (bool isNonFragile) const
	getDefaultObjCRuntime - Return the default Objective-C runtime for this platform.

virtual bool	hasBlocksRuntime () const
	hasBlocksRuntime - Given that the user is compiling with -fblocks, does this tool chain guarantee the existence of a blocks runtime?

virtual std::string	computeSysRoot () const
	Return the sysroot, possibly searching for a default sysroot using target-specific logic.

virtual void	AddClangSystemIncludeArgs (const llvm::opt::ArgList &DriverArgs, llvm::opt::ArgStringList &CC1Args) const
	Add the clang cc1 arguments for system include paths.

virtual void	addClangTargetOptions (const llvm::opt::ArgList &DriverArgs, llvm::opt::ArgStringList &CC1Args, Action::OffloadKind DeviceOffloadKind) const
	Add options that need to be passed to cc1 for this target.

virtual void	addClangCC1ASTargetOptions (const llvm::opt::ArgList &Args, llvm::opt::ArgStringList &CC1ASArgs) const
	Add options that need to be passed to cc1as for this target.

virtual void	addClangWarningOptions (llvm::opt::ArgStringList &CC1Args) const
	Add warning options that need to be passed to cc1 for this target.

virtual RuntimeLibType	GetRuntimeLibType (const llvm::opt::ArgList &Args) const

virtual CXXStdlibType	GetCXXStdlibType (const llvm::opt::ArgList &Args) const

virtual UnwindLibType	GetUnwindLibType (const llvm::opt::ArgList &Args) const

virtual std::string	detectLibcxxVersion (StringRef IncludePath) const

virtual void	AddClangCXXStdlibIncludeArgs (const llvm::opt::ArgList &DriverArgs, llvm::opt::ArgStringList &CC1Args) const
	AddClangCXXStdlibIncludeArgs - Add the clang -cc1 level arguments to set the include paths to use for the given C++ standard library type.

void	AddClangCXXStdlibIsystemArgs (const llvm::opt::ArgList &DriverArgs, llvm::opt::ArgStringList &CC1Args) const
	AddClangCXXStdlibIsystemArgs - Add the clang -cc1 level arguments to set the specified include paths for the C++ standard library.

bool	ShouldLinkCXXStdlib (const llvm::opt::ArgList &Args) const
	Returns if the C++ standard library should be linked in.

virtual void	AddCXXStdlibLibArgs (const llvm::opt::ArgList &Args, llvm::opt::ArgStringList &CmdArgs) const
	AddCXXStdlibLibArgs - Add the system specific linker arguments to use for the given C++ standard library type.

void	AddFilePathLibArgs (const llvm::opt::ArgList &Args, llvm::opt::ArgStringList &CmdArgs) const
	AddFilePathLibArgs - Add each thing in getFilePaths() as a "-L" option.

virtual void	AddCCKextLibArgs (const llvm::opt::ArgList &Args, llvm::opt::ArgStringList &CmdArgs) const
	AddCCKextLibArgs - Add the system specific linker arguments to use for kernel extensions (Darwin-specific).

virtual bool	isFastMathRuntimeAvailable (const llvm::opt::ArgList &Args, std::string &Path) const
	If a runtime library exists that sets global flags for unsafe floating point math, return true.

bool	addFastMathRuntimeIfAvailable (const llvm::opt::ArgList &Args, llvm::opt::ArgStringList &CmdArgs) const
	AddFastMathRuntimeIfAvailable - If a runtime library exists that sets global flags for unsafe floating point math, add it and return true.

virtual Expected< SmallVector< std::string > >	getSystemGPUArchs (const llvm::opt::ArgList &Args) const
	getSystemGPUArchs - Use a tool to detect the user's availible GPUs.

virtual void	addProfileRTLibs (const llvm::opt::ArgList &Args, llvm::opt::ArgStringList &CmdArgs) const
	addProfileRTLibs - When -fprofile-instr-profile is specified, try to pass a suitable profile runtime library to the linker.

virtual void	AddCudaIncludeArgs (const llvm::opt::ArgList &DriverArgs, llvm::opt::ArgStringList &CC1Args) const
	Add arguments to use system-specific CUDA includes.

virtual void	AddHIPIncludeArgs (const llvm::opt::ArgList &DriverArgs, llvm::opt::ArgStringList &CC1Args) const
	Add arguments to use system-specific HIP includes.

virtual void	AddIAMCUIncludeArgs (const llvm::opt::ArgList &DriverArgs, llvm::opt::ArgStringList &CC1Args) const
	Add arguments to use MCU GCC toolchain includes.

virtual VersionTuple	computeMSVCVersion (const Driver *D, const llvm::opt::ArgList &Args) const
	On Windows, returns the MSVC compatibility version.

virtual llvm::SmallVector< BitCodeLibraryInfo, 12 >	getDeviceLibs (const llvm::opt::ArgList &Args) const
	Get paths for device libraries.

virtual void	AddHIPRuntimeLibArgs (const llvm::opt::ArgList &Args, llvm::opt::ArgStringList &CmdArgs) const
	Add the system specific linker arguments to use for the given HIP runtime library type.

virtual SanitizerMask	getSupportedSanitizers () const
	Return sanitizers which are available in this toolchain.

virtual SanitizerMask	getDefaultSanitizers () const
	Return sanitizers which are enabled by default.

virtual bool	canSplitThinLTOUnit () const
	Returns true when it's possible to split LTO unit to use whole program devirtualization and CFI santiizers.

virtual llvm::DenormalMode	getDefaultDenormalModeForType (const llvm::opt::ArgList &DriverArgs, const JobAction &JA, const llvm::fltSemantics *FPType=nullptr) const
	Returns the output denormal handling type in the default floating point environment for the given `FPType` if given.

Static Public Member Functions
static ParsedClangName	getTargetAndModeFromProgramName (StringRef ProgName)
	Return any implicit target and/or mode flag for an invocation of the compiler driver as `ProgName`.

static bool	needsProfileRT (const llvm::opt::ArgList &Args)
	needsProfileRT - returns true if instrumentation profile is on.

static bool	needsGCovInstrumentation (const llvm::opt::ArgList &Args)
	Returns true if gcov instrumentation (-fprofile-arcs or –coverage) is on.

static llvm::Triple	getOpenMPTriple (StringRef TripleStr)

Protected Member Functions
	ToolChain (const Driver &D, const llvm::Triple &T, const llvm::opt::ArgList &Args)

llvm::Expected< std::unique_ptr< llvm::MemoryBuffer > >	executeToolChainProgram (StringRef Executable) const
	Executes the given `Executable` and returns the stdout.

void	setTripleEnvironment (llvm::Triple::EnvironmentType Env)

virtual Tool *	buildAssembler () const

virtual Tool *	buildLinker () const

virtual Tool *	buildStaticLibTool () const

virtual Tool *	getTool (Action::ActionClass AC) const

virtual std::string	buildCompilerRTBasename (const llvm::opt::ArgList &Args, StringRef Component, FileType Type, bool AddArch) const

std::optional< std::string >	getTargetSubDirPath (StringRef BaseDir) const
	Find the target-specific subdirectory for the current target triple under `BaseDir`, doing fallback triple searches as necessary.

Static Protected Member Functions
Utilities for implementing subclasses.
static void	addSystemInclude (const llvm::opt::ArgList &DriverArgs, llvm::opt::ArgStringList &CC1Args, const Twine &Path)
	Utility function to add a system include directory to CC1 arguments.

static void	addExternCSystemInclude (const llvm::opt::ArgList &DriverArgs, llvm::opt::ArgStringList &CC1Args, const Twine &Path)
	Utility function to add a system include directory with extern "C" semantics to CC1 arguments.

static void	addExternCSystemIncludeIfExists (const llvm::opt::ArgList &DriverArgs, llvm::opt::ArgStringList &CC1Args, const Twine &Path)

static void	addSystemIncludes (const llvm::opt::ArgList &DriverArgs, llvm::opt::ArgStringList &CC1Args, ArrayRef< StringRef > Paths)
	Utility function to add a list of system include directories to CC1.

static std::string	concat (StringRef Path, const Twine &A, const Twine &B="", const Twine &C="", const Twine &D="")

Protected Attributes
MultilibSet	Multilibs

llvm::SmallVector< Multilib >	SelectedMultilibs

Friends
class	RegisterEffectiveTriple

Detailed Description

ToolChain - Access to tools for a single platform.

Definition at line 92 of file ToolChain.h.

Member Typedef Documentation

◆ path_list

using clang::driver::ToolChain::path_list = SmallVector<std::string, 16>

Definition at line 94 of file ToolChain.h.

Member Enumeration Documentation

◆ CXXStdlibType

enum clang::driver::ToolChain::CXXStdlibType

Enumerator
CST_Libcxx
CST_Libstdcxx

Definition at line 96 of file ToolChain.h.

◆ FileType

enum clang::driver::ToolChain::FileType

Enumerator
FT_Object
FT_Static
FT_Shared

Definition at line 130 of file ToolChain.h.

◆ RTTIMode

enum clang::driver::ToolChain::RTTIMode

Enumerator
RM_Enabled
RM_Disabled

Definition at line 118 of file ToolChain.h.

◆ RuntimeLibType

enum clang::driver::ToolChain::RuntimeLibType

Enumerator
RLT_CompilerRT
RLT_Libgcc

Definition at line 101 of file ToolChain.h.

◆ UnwindLibType

enum clang::driver::ToolChain::UnwindLibType

Enumerator
UNW_None
UNW_CompilerRT
UNW_Libgcc

Definition at line 106 of file ToolChain.h.

◆ UnwindTableLevel

enum class clang::driver::ToolChain::UnwindTableLevel

strong

Enumerator
None
Synchronous
Asynchronous

Definition at line 112 of file ToolChain.h.

Constructor & Destructor Documentation

◆ ToolChain()

ToolChain::ToolChain	(	const Driver &	D,
		const llvm::Triple &	T,
		const llvm::opt::ArgList &	Args
	)

protected

Definition at line 80 of file ToolChain.cpp.

References getArchSpecificLibPaths(), getFilePaths(), getLibraryPaths(), getRuntimePath(), getStdlibPath(), getVFS(), and clang::List.

◆ ~ToolChain()

ToolChain::~ToolChain ( )

virtualdefault

Member Function Documentation

◆ AddCCKextLibArgs()

void ToolChain::AddCCKextLibArgs	(	const llvm::opt::ArgList &	Args,
		llvm::opt::ArgStringList &	CmdArgs
	)		const

virtual

AddCCKextLibArgs - Add the system specific linker arguments to use for kernel extensions (Darwin-specific).

Reimplemented in clang::driver::toolchains::DarwinClang.

Definition at line 1267 of file ToolChain.cpp.

◆ addClangCC1ASTargetOptions()

void ToolChain::addClangCC1ASTargetOptions	(	const llvm::opt::ArgList &	Args,
		llvm::opt::ArgStringList &	CC1ASArgs
	)		const

virtual

Add options that need to be passed to cc1as for this target.

Reimplemented in clang::driver::toolchains::Darwin.

Definition at line 1032 of file ToolChain.cpp.

Referenced by clang::driver::tools::ClangAs::ConstructJob().

◆ AddClangCXXStdlibIncludeArgs()

void ToolChain::AddClangCXXStdlibIncludeArgs	(	const llvm::opt::ArgList &	DriverArgs,
		llvm::opt::ArgStringList &	CC1Args
	)		const

virtual

AddClangCXXStdlibIncludeArgs - Add the clang -cc1 level arguments to set the include paths to use for the given C++ standard library type.

Definition at line 1203 of file ToolChain.cpp.

Referenced by clang::driver::toolchains::CudaToolChain::AddClangCXXStdlibIncludeArgs(), clang::driver::toolchains::HIPAMDToolChain::AddClangCXXStdlibIncludeArgs(), clang::driver::toolchains::HIPSPVToolChain::AddClangCXXStdlibIncludeArgs(), and clang::driver::toolchains::DarwinClang::AddClangCXXStdlibIncludeArgs().

◆ AddClangCXXStdlibIsystemArgs()

void ToolChain::AddClangCXXStdlibIsystemArgs	(	const llvm::opt::ArgList &	DriverArgs,
		llvm::opt::ArgStringList &	CC1Args
	)		const

AddClangCXXStdlibIsystemArgs - Add the clang -cc1 level arguments to set the specified include paths for the C++ standard library.

Definition at line 1217 of file ToolChain.cpp.

References addSystemInclude(), and P.

◆ AddClangSystemIncludeArgs()

void ToolChain::AddClangSystemIncludeArgs	(	const llvm::opt::ArgList &	DriverArgs,
		llvm::opt::ArgStringList &	CC1Args
	)		const

virtual

Add the clang cc1 arguments for system include paths.

This routine is responsible for adding the necessary cc1 arguments to include headers from standard system header directories.

Definition at line 1023 of file ToolChain.cpp.

Referenced by clang::driver::toolchains::AMDGPUOpenMPToolChain::AddClangSystemIncludeArgs(), clang::driver::toolchains::CudaToolChain::AddClangSystemIncludeArgs(), clang::driver::toolchains::HIPAMDToolChain::AddClangSystemIncludeArgs(), and clang::driver::toolchains::HIPSPVToolChain::AddClangSystemIncludeArgs().

◆ addClangTargetOptions()

void ToolChain::addClangTargetOptions	(	const llvm::opt::ArgList &	DriverArgs,
		llvm::opt::ArgStringList &	CC1Args,
		Action::OffloadKind	DeviceOffloadKind
	)		const

virtual

Add options that need to be passed to cc1 for this target.

Definition at line 1028 of file ToolChain.cpp.

Referenced by clang::driver::toolchains::AMDGPUOpenMPToolChain::addClangTargetOptions(), clang::driver::toolchains::CudaToolChain::addClangTargetOptions(), clang::driver::toolchains::HIPAMDToolChain::addClangTargetOptions(), clang::driver::toolchains::HIPSPVToolChain::addClangTargetOptions(), and clang::driver::tools::Clang::ConstructJob().

◆ addClangWarningOptions()

void ToolChain::addClangWarningOptions ( llvm::opt::ArgStringList & CC1Args ) const

virtual

Add warning options that need to be passed to cc1 for this target.

Reimplemented in clang::driver::toolchains::AMDGPUOpenMPToolChain, clang::driver::toolchains::CudaToolChain, clang::driver::toolchains::DarwinClang, clang::driver::toolchains::HIPAMDToolChain, and clang::driver::toolchains::HIPSPVToolChain.

Definition at line 1035 of file ToolChain.cpp.

Referenced by clang::driver::toolchains::AMDGPUOpenMPToolChain::addClangWarningOptions(), clang::driver::toolchains::CudaToolChain::addClangWarningOptions(), clang::driver::toolchains::HIPAMDToolChain::addClangWarningOptions(), clang::driver::toolchains::HIPSPVToolChain::addClangWarningOptions(), and clang::driver::tools::Clang::ConstructJob().

◆ AddCudaIncludeArgs()

void ToolChain::AddCudaIncludeArgs	(	const llvm::opt::ArgList &	DriverArgs,
		llvm::opt::ArgStringList &	CC1Args
	)		const

virtual

Add arguments to use system-specific CUDA includes.

Reimplemented in clang::driver::toolchains::CudaToolChain, clang::driver::toolchains::Darwin, clang::driver::toolchains::FreeBSD, clang::driver::toolchains::Linux, clang::driver::toolchains::MinGW, and clang::driver::toolchains::MSVCToolChain.

Definition at line 1333 of file ToolChain.cpp.

◆ AddCXXStdlibLibArgs()

void ToolChain::AddCXXStdlibLibArgs	(	const llvm::opt::ArgList &	Args,
		llvm::opt::ArgStringList &	CmdArgs
	)		const

virtual

AddCXXStdlibLibArgs - Add the system specific linker arguments to use for the given C++ standard library type.

Definition at line 1241 of file ToolChain.cpp.

References CST_Libcxx, CST_Libstdcxx, and GetCXXStdlibType().

◆ addExternCSystemInclude()

void ToolChain::addExternCSystemInclude	(	const llvm::opt::ArgList &	DriverArgs,
		llvm::opt::ArgStringList &	CC1Args,
		const Twine &	Path
	)

staticprotected

Utility function to add a system include directory with extern "C" semantics to CC1 arguments.

Note that this should be used rarely, and only for directories that historically and for legacy reasons are treated as having implicit extern "C" semantics. These semantics are ignored by and large today, but its important to preserve the preprocessor changes resulting from the classification.

Definition at line 1148 of file ToolChain.cpp.

◆ addExternCSystemIncludeIfExists()

void ToolChain::addExternCSystemIncludeIfExists	(	const llvm::opt::ArgList &	DriverArgs,
		llvm::opt::ArgStringList &	CC1Args,
		const Twine &	Path
	)

staticprotected

Definition at line 1155 of file ToolChain.cpp.

References addExternCSystemInclude().

Referenced by clang::driver::toolchains::MipsLLVMToolChain::AddClangSystemIncludeArgs(), clang::driver::toolchains::Solaris::AddClangSystemIncludeArgs(), and clang::driver::toolchains::Generic_GCC::AddMultilibIncludeArgs().

◆ addFastMathRuntimeIfAvailable()

bool ToolChain::addFastMathRuntimeIfAvailable	(	const llvm::opt::ArgList &	Args,
		llvm::opt::ArgStringList &	CmdArgs
	)		const

AddFastMathRuntimeIfAvailable - If a runtime library exists that sets global flags for unsafe floating point math, add it and return true.

This checks for presence of the -Ofast, -ffast-math or -funsafe-math flags.

Definition at line 1292 of file ToolChain.cpp.

References isFastMathRuntimeAvailable().

Referenced by clang::driver::tools::gnutools::Linker::ConstructJob(), clang::driver::tools::MinGW::Linker::ConstructJob(), and clang::driver::tools::solaris::Linker::ConstructJob().

◆ AddFilePathLibArgs()

void ToolChain::AddFilePathLibArgs	(	const llvm::opt::ArgList &	Args,
		llvm::opt::ArgStringList &	CmdArgs
	)		const

AddFilePathLibArgs - Add each thing in getFilePaths() as a "-L" option.

Definition at line 1260 of file ToolChain.cpp.

References getFilePaths().

◆ AddHIPIncludeArgs()

void ToolChain::AddHIPIncludeArgs	(	const llvm::opt::ArgList &	DriverArgs,
		llvm::opt::ArgStringList &	CC1Args
	)		const

virtual

Add arguments to use system-specific HIP includes.

Reimplemented in clang::driver::toolchains::Darwin, clang::driver::toolchains::FreeBSD, clang::driver::toolchains::HIPAMDToolChain, clang::driver::toolchains::HIPSPVToolChain, clang::driver::toolchains::Linux, clang::driver::toolchains::MinGW, and clang::driver::toolchains::MSVCToolChain.

Definition at line 1336 of file ToolChain.cpp.

◆ AddHIPRuntimeLibArgs()

virtual void clang::driver::ToolChain::AddHIPRuntimeLibArgs	(	const llvm::opt::ArgList &	Args,
		llvm::opt::ArgStringList &	CmdArgs
	)		const

inlinevirtual

Add the system specific linker arguments to use for the given HIP runtime library type.

Reimplemented in clang::driver::toolchains::Linux, and clang::driver::toolchains::MSVCToolChain.

Definition at line 766 of file ToolChain.h.

Referenced by clang::driver::tools::addHIPRuntimeLibArgs().

◆ AddIAMCUIncludeArgs()

void ToolChain::AddIAMCUIncludeArgs	(	const llvm::opt::ArgList &	DriverArgs,
		llvm::opt::ArgStringList &	CC1Args
	)		const

virtual

Add arguments to use MCU GCC toolchain includes.

Reimplemented in clang::driver::toolchains::AMDGPUOpenMPToolChain, clang::driver::toolchains::CudaToolChain, clang::driver::toolchains::HIPAMDToolChain, clang::driver::toolchains::HIPSPVToolChain, and clang::driver::toolchains::Linux.

Definition at line 1344 of file ToolChain.cpp.

Referenced by clang::driver::toolchains::AMDGPUOpenMPToolChain::AddIAMCUIncludeArgs(), clang::driver::toolchains::CudaToolChain::AddIAMCUIncludeArgs(), clang::driver::toolchains::HIPAMDToolChain::AddIAMCUIncludeArgs(), and clang::driver::toolchains::HIPSPVToolChain::AddIAMCUIncludeArgs().

◆ addProfileRTLibs()

void ToolChain::addProfileRTLibs	(	const llvm::opt::ArgList &	Args,
		llvm::opt::ArgStringList &	CmdArgs
	)		const

virtual

addProfileRTLibs - When -fprofile-instr-profile is specified, try to pass a suitable profile runtime library to the linker.

Reimplemented in clang::driver::toolchains::AIX, clang::driver::toolchains::MachO, clang::driver::toolchains::Darwin, clang::driver::toolchains::Linux, and clang::driver::toolchains::OHOS.

Definition at line 1037 of file ToolChain.cpp.

References getCompilerRTArgString(), needsGCovInstrumentation(), and needsProfileRT().

◆ addSystemInclude()

void ToolChain::addSystemInclude	(	const llvm::opt::ArgList &	DriverArgs,
		llvm::opt::ArgStringList &	CC1Args,
		const Twine &	Path
	)

staticprotected

Utility function to add a system include directory to CC1 arguments.

Definition at line 1133 of file ToolChain.cpp.

◆ addSystemIncludes()

void ToolChain::addSystemIncludes	(	const llvm::opt::ArgList &	DriverArgs,
		llvm::opt::ArgStringList &	CC1Args,
		ArrayRef< StringRef >	Paths
	)

staticprotected

Utility function to add a list of system include directories to CC1.

Definition at line 1163 of file ToolChain.cpp.

Referenced by clang::driver::toolchains::VEToolChain::AddClangCXXStdlibIncludeArgs(), clang::driver::toolchains::XCoreToolChain::AddClangCXXStdlibIncludeArgs(), clang::driver::toolchains::MSVCToolChain::AddClangSystemIncludeArgs(), clang::driver::toolchains::VEToolChain::AddClangSystemIncludeArgs(), and clang::driver::toolchains::XCoreToolChain::AddClangSystemIncludeArgs().

◆ adjustDebugInfoKind()

virtual void clang::driver::ToolChain::adjustDebugInfoKind	(	llvm::codegenoptions::DebugInfoKind &	DebugInfoKind,
		const llvm::opt::ArgList &	Args
	)		const

inlinevirtual

Adjust debug information kind considering all passed options.

Reimplemented in clang::driver::toolchains::NVPTXToolChain, and clang::driver::toolchains::HIPSPVToolChain.

Definition at line 598 of file ToolChain.h.

Referenced by renderDebugOptions().

◆ buildAssembler()

Tool * ToolChain::buildAssembler ( ) const

protectedvirtual

Definition at line 448 of file ToolChain.cpp.

◆ buildCompilerRTBasename()

std::string ToolChain::buildCompilerRTBasename	(	const llvm::opt::ArgList &	Args,
		StringRef	Component,
		FileType	Type,
		bool	AddArch
	)		const

protectedvirtual

Definition at line 619 of file ToolChain.cpp.

References Env, FT_Object, FT_Shared, FT_Static, getArchNameForCompilerRTLib(), and getTriple().

Referenced by getCompilerRT(), and clang::driver::toolchains::OpenBSD::getCompilerRT().

◆ buildLinker()

Tool * ToolChain::buildLinker ( ) const

protectedvirtual

Definition at line 452 of file ToolChain.cpp.

◆ buildStaticLibTool()

Tool * ToolChain::buildStaticLibTool ( ) const

protectedvirtual

Reimplemented in clang::driver::toolchains::BareMetal, clang::driver::toolchains::MachO, clang::driver::toolchains::Fuchsia, and clang::driver::toolchains::Linux.

Definition at line 456 of file ToolChain.cpp.

◆ canSplitThinLTOUnit()

virtual bool clang::driver::ToolChain::canSplitThinLTOUnit ( ) const

inlinevirtual

Returns true when it's possible to split LTO unit to use whole program devirtualization and CFI santiizers.

Reimplemented in clang::driver::toolchains::MachO, and clang::driver::toolchains::PS4CPU.

Definition at line 779 of file ToolChain.h.

Referenced by clang::driver::tools::Clang::ConstructJob().

◆ CheckObjCARC()

virtual void clang::driver::ToolChain::CheckObjCARC ( ) const

inlinevirtual

Complain if this tool chain doesn't support Objective-C ARC.

Reimplemented in clang::driver::toolchains::Darwin.

Definition at line 557 of file ToolChain.h.

Referenced by RenderObjCOptions().

◆ ComputeEffectiveClangTriple()

std::string ToolChain::ComputeEffectiveClangTriple	(	const llvm::opt::ArgList &	Args,
		types::ID	InputType = `types::TY_INVALID`
	)		const

virtual

ComputeEffectiveClangTriple - Return the Clang triple to use for this target, which may take into account the command line arguments.

For example, on Darwin the -mmacosx-version-min= command line argument (which sets the deployment target) determines the version in the triple passed to Clang.

Reimplemented in clang::driver::toolchains::Darwin, clang::driver::toolchains::Fuchsia, clang::driver::toolchains::MSVCToolChain, and clang::driver::toolchains::NaClToolChain.

Definition at line 1014 of file ToolChain.cpp.

References ComputeLLVMTriple().

Referenced by clang::driver::toolchains::MSVCToolChain::ComputeEffectiveClangTriple(), getMultilibFlags(), and clang::driver::Driver::HandleImmediateArgs().

◆ ComputeLLVMTriple()

std::string ToolChain::ComputeLLVMTriple	(	const llvm::opt::ArgList &	Args,
		types::ID	InputType = `types::TY_INVALID`
	)		const

virtual

ComputeLLVMTriple - Return the LLVM target triple to use, after taking command line arguments into account.

Definition at line 966 of file ToolChain.cpp.

References getArch(), getDriver(), getTriple(), getTripleString(), clang::driver::tools::arm::setArchNameInTriple(), and clang::driver::tools::arm::setFloatABIInTriple().

Referenced by clang::driver::toolchains::Darwin::ComputeEffectiveClangTriple(), clang::driver::toolchains::Fuchsia::ComputeEffectiveClangTriple(), clang::driver::toolchains::NaClToolChain::ComputeEffectiveClangTriple(), ComputeEffectiveClangTriple(), and clang::driver::toolchains::Darwin::GetExceptionModel().

◆ computeMSVCVersion()

VersionTuple ToolChain::computeMSVCVersion	(	const Driver *	D,
		const llvm::opt::ArgList &	Args
	)		const

virtual

On Windows, returns the MSVC compatibility version.

Reimplemented in clang::driver::toolchains::AMDGPUOpenMPToolChain, clang::driver::toolchains::CudaToolChain, clang::driver::toolchains::HIPAMDToolChain, clang::driver::toolchains::HIPSPVToolChain, and clang::driver::toolchains::MSVCToolChain.

Definition at line 1361 of file ToolChain.cpp.

References clang::driver::Driver::Diag(), and separateMSVCFullVersion().

Referenced by clang::driver::toolchains::AMDGPUOpenMPToolChain::computeMSVCVersion(), clang::driver::toolchains::CudaToolChain::computeMSVCVersion(), clang::driver::toolchains::HIPAMDToolChain::computeMSVCVersion(), clang::driver::toolchains::HIPSPVToolChain::computeMSVCVersion(), clang::driver::toolchains::MSVCToolChain::computeMSVCVersion(), and clang::driver::tools::Clang::ConstructJob().

◆ computeSysRoot()

std::string ToolChain::computeSysRoot ( ) const

virtual

Return the sysroot, possibly searching for a default sysroot using target-specific logic.

Reimplemented in clang::driver::toolchains::BareMetal, clang::driver::toolchains::Linux, clang::driver::toolchains::MipsLLVMToolChain, and clang::driver::toolchains::OHOS.

Definition at line 1019 of file ToolChain.cpp.

References clang::driver::Driver::SysRoot.

Referenced by clang::driver::toolchains::Hurd::AddClangSystemIncludeArgs(), clang::driver::toolchains::Generic_GCC::addLibCxxIncludePaths(), and clang::driver::toolchains::Hurd::Hurd().

◆ concat()

std::string ToolChain::concat	(	StringRef	Path,
		const Twine &	A,
		const Twine &	B = `""`,
		const Twine &	C = `""`,
		const Twine &	D = `""`
	)

staticprotected

Definition at line 1172 of file ToolChain.cpp.

References clang::C, and clang::Result.

◆ defaultToIEEELongDouble()

bool ToolChain::defaultToIEEELongDouble ( ) const

Check whether use IEEE binary128 as long double format by default.

Definition at line 174 of file ToolChain.cpp.

References getTriple().

◆ detectLibcxxVersion()

std::string ToolChain::detectLibcxxVersion ( StringRef IncludePath ) const

virtual

Definition at line 1180 of file ToolChain.cpp.

References getVFS().

Referenced by clang::driver::toolchains::Fuchsia::AddClangCXXStdlibIncludeArgs(), and clang::driver::toolchains::Generic_GCC::addLibCxxIncludePaths().

◆ executeToolChainProgram()

llvm::Expected< std::unique_ptr< llvm::MemoryBuffer > > ToolChain::executeToolChainProgram ( StringRef Executable ) const

protected

Executes the given Executable and returns the stdout.

Definition at line 98 of file ToolChain.cpp.

Referenced by clang::driver::toolchains::AMDGPUToolChain::getSystemGPUArchs(), and clang::driver::toolchains::CudaToolChain::getSystemGPUArchs().

◆ getArch()

llvm::Triple::ArchType clang::driver::ToolChain::getArch ( ) const

inline

Definition at line 261 of file ToolChain.h.

◆ getArchName()

StringRef clang::driver::ToolChain::getArchName ( ) const

inline

Definition at line 262 of file ToolChain.h.

Referenced by clang::driver::toolchains::Darwin::addPlatformVersionArgs(), clang::driver::tools::nacltools::Linker::ConstructJob(), and clang::driver::toolchains::MachO::TranslateArgs().

◆ getArchSpecificLibPaths()

ToolChain::path_list ToolChain::getArchSpecificLibPaths ( ) const

virtual

Reimplemented in clang::driver::toolchains::OHOS.

Definition at line 778 of file ToolChain.cpp.

References getArch(), getDriver(), getOSLibName(), and getTriple().

Referenced by ToolChain(), and clang::driver::toolchains::VEToolChain::VEToolChain().

◆ getAuxTriple()

virtual const llvm::Triple * clang::driver::ToolChain::getAuxTriple ( ) const

inlinevirtual

Get the toolchain's aux triple, if it has one.

Exactly what the aux triple represents depends on the toolchain, but for example when compiling CUDA code for the GPU, the triple might be NVPTX, while the aux triple is the host (CPU) toolchain, e.g. x86-linux-gnu.

Reimplemented in clang::driver::toolchains::AMDGPUOpenMPToolChain, clang::driver::toolchains::CudaToolChain, clang::driver::toolchains::HIPAMDToolChain, and clang::driver::toolchains::HIPSPVToolChain.

Definition at line 254 of file ToolChain.h.

Referenced by clang::driver::tools::Clang::ConstructJob().

◆ getCompilerRT()

std::string ToolChain::getCompilerRT	(	const llvm::opt::ArgList &	Args,
		StringRef	Component,
		FileType	Type = `ToolChain::FT_Static`
	)		const

virtual

Reimplemented in clang::driver::toolchains::AVRToolChain, clang::driver::toolchains::MipsLLVMToolChain, clang::driver::toolchains::OHOS, and clang::driver::toolchains::OpenBSD.

Definition at line 653 of file ToolChain.cpp.

References buildCompilerRTBasename(), getCompilerRTPath(), getLibraryPaths(), getVFS(), and P.

Referenced by clang::driver::toolchains::BareMetal::AddLinkRuntimeLib(), addSanitizerDynamicList(), clang::driver::tools::gnutools::Linker::ConstructJob(), clang::driver::toolchains::OpenBSD::getCompilerRT(), getCompilerRTArgString(), getCompilerRTBasename(), and clang::driver::Driver::HandleImmediateArgs().

◆ getCompilerRTArgString()

const char * ToolChain::getCompilerRTArgString	(	const llvm::opt::ArgList &	Args,
		StringRef	Component,
		FileType	Type = `ToolChain::FT_Static`
	)		const

Definition at line 674 of file ToolChain.cpp.

References getCompilerRT().

Referenced by addProfileRTLibs(), addSanitizerRuntime(), clang::driver::tools::CSKY::Linker::ConstructJob(), clang::driver::tools::MinGW::Linker::ConstructJob(), clang::driver::tools::openbsd::Linker::ConstructJob(), and clang::driver::tools::RISCV::Linker::ConstructJob().

◆ getCompilerRTBasename()

std::string ToolChain::getCompilerRTBasename	(	const llvm::opt::ArgList &	Args,
		StringRef	Component,
		FileType	Type = `ToolChain::FT_Static`
	)		const

Definition at line 612 of file ToolChain.cpp.

References getCompilerRT().

Referenced by clang::driver::SanitizerArgs::addArgs(), addPGOAndCoverageFlags(), and processVSRuntimeLibrary().

◆ getCompilerRTPath()

std::string ToolChain::getCompilerRTPath ( ) const

virtual

Reimplemented in clang::driver::toolchains::HexagonToolChain.

Definition at line 597 of file ToolChain.cpp.

References getDriver(), getOSLibName(), isBareMetal(), and SelectedMultilibs.

Referenced by clang::driver::tools::MinGW::Linker::ConstructJob(), clang::driver::tools::netbsd::Linker::ConstructJob(), clang::driver::toolchains::AVRToolChain::getCompilerRT(), getCompilerRT(), clang::driver::Driver::GetFilePath(), and clang::driver::Driver::HandleImmediateArgs().

◆ GetCXXStdlibType()

ToolChain::CXXStdlibType ToolChain::GetCXXStdlibType ( const llvm::opt::ArgList & Args ) const

virtual

Reimplemented in clang::driver::toolchains::AMDGPUOpenMPToolChain, clang::driver::toolchains::CudaToolChain, clang::driver::toolchains::Fuchsia, clang::driver::toolchains::HexagonToolChain, clang::driver::toolchains::HIPAMDToolChain, clang::driver::toolchains::HIPSPVToolChain, clang::driver::toolchains::MipsLLVMToolChain, clang::driver::toolchains::NaClToolChain, clang::driver::toolchains::OHOS, and clang::driver::toolchains::VEToolChain.

Definition at line 1107 of file ToolChain.cpp.

References CST_Libcxx, CST_Libstdcxx, clang::driver::Driver::Diag(), GetDefaultCXXStdlibType(), and getDriver().

◆ GetDefaultCXXStdlibType()

virtual CXXStdlibType clang::driver::ToolChain::GetDefaultCXXStdlibType ( ) const

inlinevirtual

Reimplemented in clang::driver::toolchains::AIX, clang::driver::toolchains::BareMetal, clang::driver::toolchains::Darwin, clang::driver::toolchains::FreeBSD, clang::driver::toolchains::Fuchsia, clang::driver::toolchains::Linux, clang::driver::toolchains::NetBSD, clang::driver::toolchains::OHOS, clang::driver::toolchains::OpenBSD, and clang::driver::toolchains::ZOS.

Definition at line 490 of file ToolChain.h.

References CST_Libstdcxx.

Referenced by GetCXXStdlibType().

◆ getDefaultDebugFormat()

virtual llvm::codegenoptions::DebugInfoFormat clang::driver::ToolChain::getDefaultDebugFormat ( ) const

inlinevirtual

Get the default debug info format. Typically, this is DWARF.

Reimplemented in clang::driver::toolchains::MSVCToolChain.

Definition at line 560 of file ToolChain.h.

Referenced by renderDebugOptions().

◆ getDefaultDebuggerTuning()

virtual llvm::DebuggerKind clang::driver::ToolChain::getDefaultDebuggerTuning ( ) const

inlinevirtual

Reimplemented in clang::driver::toolchains::AIX, clang::driver::toolchains::DarwinClang, clang::driver::toolchains::Fuchsia, clang::driver::toolchains::MSVCToolChain, and clang::driver::toolchains::PS4PS5Base.

Definition at line 587 of file ToolChain.h.

Referenced by renderDebugOptions().

◆ getDefaultDenormalModeForType()

virtual llvm::DenormalMode clang::driver::ToolChain::getDefaultDenormalModeForType	(	const llvm::opt::ArgList &	DriverArgs,
		const JobAction &	JA,
		const llvm::fltSemantics *	FPType = `nullptr`
	)		const

inlinevirtual

Returns the output denormal handling type in the default floating point environment for the given FPType if given.

Otherwise, the default assumed mode for any floating point type.

Reimplemented in clang::driver::toolchains::PS4PS5Base, clang::driver::toolchains::AMDGPUToolChain, clang::driver::toolchains::CudaToolChain, and clang::driver::toolchains::Linux.

Definition at line 784 of file ToolChain.h.

Referenced by RenderFloatingPointOptions().

◆ GetDefaultDwarfVersion()

unsigned ToolChain::GetDefaultDwarfVersion ( ) const

virtual

Definition at line 430 of file ToolChain.cpp.

References getTriple().

Referenced by clang::driver::toolchains::Linux::GetDefaultDwarfVersion(), and clang::driver::tools::getDwarfVersion().

◆ getDefaultLinker()

virtual const char * clang::driver::ToolChain::getDefaultLinker ( ) const

inlinevirtual

GetDefaultLinker - Get the default linker to use.

Reimplemented in clang::driver::toolchains::AMDGPUToolChain, clang::driver::toolchains::BareMetal, clang::driver::toolchains::Fuchsia, clang::driver::toolchains::Haiku, clang::driver::toolchains::HexagonToolChain, clang::driver::toolchains::Linux, clang::driver::toolchains::MipsLLVMToolChain, clang::driver::toolchains::OHOS, clang::driver::toolchains::Solaris, clang::driver::toolchains::VEToolChain, and clang::driver::toolchains::ZOS.

Definition at line 483 of file ToolChain.h.

Referenced by clang::driver::toolchains::Linux::getDefaultLinker(), GetLinkerPath(), clang::driver::tools::solaris::Linker::getLinkerPath(), and clang::driver::tools::wasm::Linker::getLinkerPath().

◆ getDefaultObjCRuntime()

ObjCRuntime ToolChain::getDefaultObjCRuntime ( bool isNonFragile ) const

virtual

getDefaultObjCRuntime - Return the default Objective-C runtime for this platform.

FIXME: this really belongs on some sort of DeploymentTarget abstraction

Reimplemented in clang::driver::toolchains::Darwin.

Definition at line 943 of file ToolChain.cpp.

References clang::ObjCRuntime::GCC, and clang::ObjCRuntime::GNUstep.

◆ GetDefaultRuntimeLibType()

virtual RuntimeLibType clang::driver::ToolChain::GetDefaultRuntimeLibType ( ) const

inlinevirtual

GetDefaultRuntimeLibType - Get the default runtime library variant to use.

Definition at line 486 of file ToolChain.h.

References RLT_Libgcc.

Referenced by clang::driver::toolchains::Linux::GetDefaultRuntimeLibType(), and GetRuntimeLibType().

◆ getDefaultSanitizers()

virtual SanitizerMask clang::driver::ToolChain::getDefaultSanitizers ( ) const

inlinevirtual

Return sanitizers which are enabled by default.

Reimplemented in clang::driver::toolchains::Fuchsia.

Definition at line 773 of file ToolChain.h.

Referenced by clang::driver::SanitizerArgs::SanitizerArgs().

◆ GetDefaultStackProtectorLevel()

virtual LangOptions::StackProtectorMode clang::driver::ToolChain::GetDefaultStackProtectorLevel ( bool KernelOrKext ) const

inlinevirtual

GetDefaultStackProtectorLevel - Get the default stack protector level for this tool chain.

Reimplemented in clang::driver::toolchains::CrossWindowsToolChain, clang::driver::toolchains::Darwin, clang::driver::toolchains::Fuchsia, clang::driver::toolchains::OpenBSD, and clang::driver::toolchains::PS4PS5Base.

Definition at line 472 of file ToolChain.h.

References clang::LangOptions::SSPOff.

Referenced by RenderSSPOptions().

◆ GetDefaultStandaloneDebug()

virtual bool clang::driver::ToolChain::GetDefaultStandaloneDebug ( ) const

inlinevirtual

Reimplemented in clang::driver::toolchains::DarwinClang, clang::driver::toolchains::FreeBSD, and clang::driver::toolchains::Haiku.

Definition at line 584 of file ToolChain.h.

Referenced by renderDebugOptions().

◆ GetDefaultTrivialAutoVarInit()

virtual LangOptions::TrivialAutoVarInitKind clang::driver::ToolChain::GetDefaultTrivialAutoVarInit ( ) const

inlinevirtual

Get the default trivial automatic variable initialization.

Definition at line 478 of file ToolChain.h.

References clang::LangOptions::Uninitialized.

Referenced by RenderTrivialAutoVarInitOptions().

◆ getDefaultUniversalArchName()

StringRef ToolChain::getDefaultUniversalArchName ( ) const

Provide the default architecture name (as expected by -arch) for this toolchain.

Definition at line 396 of file ToolChain.cpp.

References getTriple().

Referenced by clang::driver::Driver::BuildUniversalActions(), and clang::driver::toolchains::MachO::getMachOArchName().

◆ GetDefaultUnwindLibType()

virtual UnwindLibType clang::driver::ToolChain::GetDefaultUnwindLibType ( ) const

inlinevirtual

Reimplemented in clang::driver::toolchains::OHOS.

Definition at line 494 of file ToolChain.h.

References UNW_None.

Referenced by GetUnwindLibType().

◆ getDefaultUnwindTableLevel()

ToolChain::UnwindTableLevel ToolChain::getDefaultUnwindTableLevel ( const llvm::opt::ArgList & Args ) const

virtual

How detailed should the unwind tables be by default.

Reimplemented in clang::driver::toolchains::CrossWindowsToolChain, clang::driver::toolchains::MachO, clang::driver::toolchains::FreeBSD, clang::driver::toolchains::Fuchsia, clang::driver::toolchains::Generic_GCC, clang::driver::toolchains::MinGW, clang::driver::toolchains::MSVCToolChain, clang::driver::toolchains::NetBSD, and clang::driver::toolchains::OpenBSD.

Definition at line 426 of file ToolChain.cpp.

References None.

Referenced by clang::driver::tools::Clang::ConstructJob().

◆ getDeviceLibs()

llvm::SmallVector< ToolChain::BitCodeLibraryInfo, 12 > ToolChain::getDeviceLibs ( const llvm::opt::ArgList & Args ) const

virtual

Get paths for device libraries.

Reimplemented in clang::driver::toolchains::AMDGPUOpenMPToolChain, clang::driver::toolchains::HIPAMDToolChain, and clang::driver::toolchains::HIPSPVToolChain.

Definition at line 1340 of file ToolChain.cpp.

◆ getDriver()

const Driver & clang::driver::ToolChain::getDriver ( ) const

inline

Definition at line 245 of file ToolChain.h.

◆ getEffectiveTriple()

const llvm::Triple & clang::driver::ToolChain::getEffectiveTriple ( ) const

inline

Get the toolchain's effective clang triple.

Definition at line 275 of file ToolChain.h.

Referenced by clang::driver::toolchains::Darwin::addMinVersionArgs(), clang::driver::toolchains::Darwin::addPlatformVersionArgs(), CollectARMPACBTIOptions(), clang::driver::tools::Clang::ConstructJob(), clang::driver::tools::ClangAs::ConstructJob(), clang::driver::tools::Flang::ConstructJob(), clang::driver::tools::fuchsia::Linker::ConstructJob(), clang::driver::tools::MinGW::Linker::ConstructJob(), clang::driver::tools::netbsd::Linker::ConstructJob(), RenderSCPOptions(), and RenderSSPOptions().

◆ GetExceptionModel()

llvm::ExceptionHandling ToolChain::GetExceptionModel ( const llvm::opt::ArgList & Args ) const

virtual

GetExceptionModel - Return the tool chain exception model.

Reimplemented in clang::driver::toolchains::MachO, clang::driver::toolchains::Darwin, clang::driver::toolchains::MinGW, clang::driver::toolchains::NetBSD, and clang::driver::toolchains::VEToolChain.

Definition at line 949 of file ToolChain.cpp.

Referenced by clang::driver::tools::Clang::ConstructJob().

◆ GetFilePath()

std::string ToolChain::GetFilePath ( const char * Name ) const

Definition at line 824 of file ToolChain.cpp.

References clang::driver::Driver::GetFilePath().

◆ getFilePaths() [1/2]

path_list & clang::driver::ToolChain::getFilePaths ( )

inline

Definition at line 287 of file ToolChain.h.

◆ getFilePaths() [2/2]

const path_list & clang::driver::ToolChain::getFilePaths ( ) const

inline

Definition at line 288 of file ToolChain.h.

◆ GetGlobalDebugPathRemapping()

virtual std::string clang::driver::ToolChain::GetGlobalDebugPathRemapping ( ) const

inlinevirtual

Add an additional -fdebug-prefix-map entry.

Reimplemented in clang::driver::toolchains::MachO.

Definition at line 569 of file ToolChain.h.

Referenced by addDebugPrefixMapArg().

◆ getInputFilename()

std::string ToolChain::getInputFilename ( const InputInfo & Input ) const

virtual

Some toolchains need to modify the file name, for example to replace the extension for object files with .cubin for OpenMP offloading to Nvidia GPUs.

Reimplemented in clang::driver::toolchains::CudaToolChain.

Definition at line 421 of file ToolChain.cpp.

References clang::driver::InputInfo::getFilename().

Referenced by clang::driver::tools::Clang::ConstructJob(), clang::driver::tools::OffloadBundler::ConstructJob(), clang::driver::tools::OffloadPackager::ConstructJob(), and clang::driver::toolchains::CudaToolChain::getInputFilename().

◆ getLibraryPaths() [1/2]

path_list & clang::driver::ToolChain::getLibraryPaths ( )

inline

Definition at line 284 of file ToolChain.h.

Referenced by clang::driver::toolchains::AIX::AIX(), clang::driver::toolchains::BareMetal::BareMetal(), clang::driver::tools::MinGW::Linker::ConstructJob(), getCompilerRT(), clang::driver::Driver::GetFilePath(), clang::driver::toolchains::OHOS::OHOS(), and ToolChain().

◆ getLibraryPaths() [2/2]

const path_list & clang::driver::ToolChain::getLibraryPaths ( ) const

inline

Definition at line 285 of file ToolChain.h.

◆ GetLinkerPath()

std::string ToolChain::GetLinkerPath ( bool * LinkerIsLLD = nullptr ) const

Returns the linker path, respecting the -fuse-ld= argument to determine the linker suffix or name.

If LinkerIsLLD is non-nullptr, it is set to true if the returned linker is LLD. If it's set, it can be assumed that the linker is LLD built at the same revision as clang, and clang can make assumptions about LLD's supported flags, error output, etc.

Definition at line 832 of file ToolChain.cpp.

References clang::driver::Driver::Diag(), getDefaultLinker(), getDriver(), and GetProgramPath().

◆ getMaxDwarfVersion()

virtual unsigned clang::driver::ToolChain::getMaxDwarfVersion ( ) const

inlinevirtual

Reimplemented in clang::driver::toolchains::NVPTXToolChain.

Definition at line 578 of file ToolChain.h.

References UINT_MAX.

Referenced by renderDebugOptions().

◆ getMultiarchTriple()

virtual std::string clang::driver::ToolChain::getMultiarchTriple	(	const Driver &	D,
		const llvm::Triple &	TargetTriple,
		StringRef	SysRoot
	)		const

inlinevirtual

Reimplemented in clang::driver::toolchains::Hurd, clang::driver::toolchains::Linux, and clang::driver::toolchains::OHOS.

Definition at line 617 of file ToolChain.h.

◆ getMultilibFlags()

Multilib::flags_list ToolChain::getMultilibFlags ( const llvm::opt::ArgList & Args ) const

Get flags suitable for multilib selection, based on the provided clang command line arguments.

The command line arguments aren't suitable to be used directly for multilib selection because they are not normalized and normalization is a complex process. The result of this function is similar to clang command line arguments except that the list of arguments is incomplete. Only certain command line arguments are processed. If more command line arguments are needed for multilib selection then this function should be extended. To allow users to find out what flags are returned, clang accepts a -print-multi-flags-experimental argument.

Definition at line 244 of file ToolChain.cpp.

References ComputeEffectiveClangTriple(), getAArch64MultilibFlags(), getARMMultilibFlags(), and clang::Result.

Referenced by findMultilibsFromYAML(), and clang::driver::Driver::HandleImmediateArgs().

◆ getMultilibs()

const MultilibSet & clang::driver::ToolChain::getMultilibs ( ) const

inline

Definition at line 293 of file ToolChain.h.

References Multilibs.

Referenced by clang::driver::Driver::HandleImmediateArgs().

◆ getOpenMPTriple()

static llvm::Triple clang::driver::ToolChain::getOpenMPTriple ( StringRef TripleStr )

inlinestatic

Definition at line 792 of file ToolChain.h.

Referenced by clang::driver::tools::LinkerWrapper::ConstructJob(), clang::driver::Driver::CreateOffloadingDeviceToolChains(), clang::driver::Driver::getOffloadArchs(), and TranslateOpenMPTargetArgs().

◆ getOS()

StringRef clang::driver::ToolChain::getOS ( ) const

inline

Definition at line 264 of file ToolChain.h.

Referenced by clang::driver::toolchains::Linux::AddClangSystemIncludeArgs(), clang::driver::toolchains::MipsLLVMToolChain::getCompilerRT(), and getOSLibName().

◆ getOSLibName()

StringRef ToolChain::getOSLibName ( ) const

virtual

Reimplemented in clang::driver::toolchains::BareMetal.

Definition at line 577 of file ToolChain.cpp.

References getOS().

Referenced by getArchSpecificLibPaths(), and getCompilerRTPath().

◆ getPlatform()

StringRef clang::driver::ToolChain::getPlatform ( ) const

inline

Definition at line 263 of file ToolChain.h.

◆ GetProgramPath()

std::string ToolChain::GetProgramPath ( const char * Name ) const

Definition at line 828 of file ToolChain.cpp.

References clang::driver::Driver::GetProgramPath().

◆ getProgramPaths() [1/2]

path_list & clang::driver::ToolChain::getProgramPaths ( )

inline

Definition at line 290 of file ToolChain.h.

◆ getProgramPaths() [2/2]

const path_list & clang::driver::ToolChain::getProgramPaths ( ) const

inline

Definition at line 291 of file ToolChain.h.

◆ getRTTIArg()

const llvm::opt::Arg * clang::driver::ToolChain::getRTTIArg ( ) const

inline

Definition at line 316 of file ToolChain.h.

Referenced by clang::driver::SanitizerArgs::SanitizerArgs().

◆ getRTTIMode()

RTTIMode clang::driver::ToolChain::getRTTIMode ( ) const

inline

Definition at line 319 of file ToolChain.h.

Referenced by clang::driver::tools::Clang::ConstructJob(), and clang::driver::SanitizerArgs::SanitizerArgs().

◆ GetRuntimeLibType()

ToolChain::RuntimeLibType ToolChain::GetRuntimeLibType ( const llvm::opt::ArgList & Args ) const

virtual

Reimplemented in clang::driver::toolchains::DarwinClang, clang::driver::toolchains::Fuchsia, and clang::driver::toolchains::OHOS.

Definition at line 1045 of file ToolChain.cpp.

References clang::driver::Driver::Diag(), GetDefaultRuntimeLibType(), getDriver(), RLT_CompilerRT, and RLT_Libgcc.

Referenced by clang::driver::toolchains::BareMetal::AddLinkRuntimeLib(), clang::driver::tools::CSKY::Linker::ConstructJob(), clang::driver::tools::gnutools::Linker::ConstructJob(), clang::driver::tools::RISCV::Linker::ConstructJob(), GetUnwindLibType(), clang::driver::Driver::HandleImmediateArgs(), and clang::driver::toolchains::Linux::IsAArch64OutlineAtomicsDefault().

◆ getRuntimePath()

std::optional< std::string > ToolChain::getRuntimePath ( ) const

Definition at line 766 of file ToolChain.cpp.

References getTargetSubDirPath(), P, and clang::driver::Driver::ResourceDir.

Referenced by clang::driver::Driver::HandleImmediateArgs(), and ToolChain().

◆ getSanitizerArgs()

SanitizerArgs ToolChain::getSanitizerArgs ( const llvm::opt::ArgList & JobArgs ) const

Definition at line 274 of file ToolChain.cpp.

◆ getSelectedMultilibs()

const llvm::SmallVector< Multilib > & clang::driver::ToolChain::getSelectedMultilibs ( ) const

inline

Definition at line 295 of file ToolChain.h.

References SelectedMultilibs.

Referenced by clang::driver::Driver::HandleImmediateArgs().

◆ GetStaticLibToolPath()

std::string ToolChain::GetStaticLibToolPath ( ) const

Returns the linker path for emitting a static library.

Definition at line 904 of file ToolChain.cpp.

References GetProgramPath().

◆ getStdlibPath()

std::optional< std::string > ToolChain::getStdlibPath ( ) const

Definition at line 772 of file ToolChain.cpp.

References clang::driver::Driver::Dir, getTargetSubDirPath(), and P.

Referenced by clang::driver::toolchains::VEToolChain::AddCXXStdlibLibArgs(), clang::driver::toolchains::Fuchsia::Fuchsia(), ToolChain(), and clang::driver::toolchains::VEToolChain::VEToolChain().

◆ getSupportedSanitizers()

SanitizerMask ToolChain::getSupportedSanitizers ( ) const

virtual

Return sanitizers which are available in this toolchain.

Definition at line 1308 of file ToolChain.cpp.

References getTriple().

◆ getSystemGPUArchs()

Expected< SmallVector< std::string > > ToolChain::getSystemGPUArchs ( const llvm::opt::ArgList & Args ) const

virtual

getSystemGPUArchs - Use a tool to detect the user's availible GPUs.

Reimplemented in clang::driver::toolchains::AMDGPUToolChain, and clang::driver::toolchains::CudaToolChain.

Definition at line 1304 of file ToolChain.cpp.

Referenced by clang::driver::Driver::getOffloadArchs().

◆ getTargetAndModeFromProgramName()

ParsedClangName ToolChain::getTargetAndModeFromProgramName ( StringRef ProgName )

static

Return any implicit target and/or mode flag for an invocation of the compiler driver as ProgName.

For example, when called with i686-linux-android-g++, the first element of the return value will be set to "i686-linux-android" and the second will be set to "--driver-mode=g++"`. It is OK if the target name is not registered. In this case the return value contains false in the field TargetIsValid.

Precondition: llvm::InitializeAllTargets() has been called.

Parameters

ProgName The name the Clang driver was invoked with (from, e.g., argv[0]).

Returns: A structure of type ParsedClangName that contains the executable name parts.

Definition at line 372 of file ToolChain.cpp.

References normalizeProgramName(), and parseDriverSuffix().

Referenced by clang::tooling::addTargetAndModeForProgramName(), and clang::driver::getDriverMode().

◆ getTargetSubDirPath()

std::optional< std::string > ToolChain::getTargetSubDirPath ( StringRef BaseDir ) const

protected

Find the target-specific subdirectory for the current target triple under BaseDir, doing fallback triple searches as necessary.

Returns: The subdirectory path if it exists.

Definition at line 725 of file ToolChain.cpp.

References getArch(), getTriple(), getVFS(), and P.

Referenced by clang::driver::toolchains::Generic_GCC::addLibCxxIncludePaths(), getRuntimePath(), and getStdlibPath().

◆ getThreadModel()

virtual std::string clang::driver::ToolChain::getThreadModel ( ) const

inlinevirtual

getThreadModel() - Which thread model does this target use?

Definition at line 609 of file ToolChain.h.

Referenced by clang::driver::tools::Clang::ConstructJob(), and clang::driver::Driver::PrintVersion().

◆ getTool()

Tool * ToolChain::getTool ( Action::ActionClass AC ) const

protectedvirtual

Reimplemented in clang::driver::toolchains::MachO, clang::driver::toolchains::Generic_GCC, clang::driver::toolchains::HLSLToolChain, clang::driver::toolchains::MinGW, and clang::driver::toolchains::SPIRVToolChain.

Definition at line 508 of file ToolChain.cpp.

Referenced by clang::driver::toolchains::MachO::getTool(), clang::driver::toolchains::Generic_GCC::getTool(), clang::driver::toolchains::HLSLToolChain::getTool(), clang::driver::toolchains::MinGW::getTool(), clang::driver::toolchains::SPIRVToolChain::getTool(), and SelectTool().

◆ getTriple()

const llvm::Triple & clang::driver::ToolChain::getTriple ( ) const

inline

Definition at line 247 of file ToolChain.h.

◆ getTripleString()

std::string clang::driver::ToolChain::getTripleString ( ) const

inline

Definition at line 270 of file ToolChain.h.

Referenced by clang::driver::toolchains::Fuchsia::AddClangCXXStdlibIncludeArgs(), checkDebugInfoOption(), ComputeLLVMTriple(), clang::driver::tools::Clang::ConstructJob(), clang::driver::tools::OffloadPackager::ConstructJob(), clang::driver::tools::gcc::Common::ConstructJob(), clang::driver::Driver::HandleImmediateArgs(), clang::driver::Driver::PrintVersion(), renderDebugOptions(), and TranslateOpenMPTargetArgs().

◆ GetUnwindLibType()

ToolChain::UnwindLibType ToolChain::GetUnwindLibType ( const llvm::opt::ArgList & Args ) const

virtual

Reimplemented in clang::driver::toolchains::CSKYToolChain, clang::driver::toolchains::MSP430ToolChain, clang::driver::toolchains::OHOS, and clang::driver::toolchains::RISCVToolChain.

Definition at line 1071 of file ToolChain.cpp.

References clang::driver::Driver::Diag(), GetDefaultUnwindLibType(), getDriver(), GetRuntimeLibType(), getTriple(), RLT_CompilerRT, RLT_Libgcc, UNW_CompilerRT, UNW_Libgcc, and UNW_None.

Referenced by AddUnwindLibrary(), and clang::driver::toolchains::OHOS::GetUnwindLibType().

◆ getVFS()

llvm::vfs::FileSystem & ToolChain::getVFS ( ) const

Definition at line 132 of file ToolChain.cpp.

References getDriver(), and clang::driver::Driver::getVFS().

◆ getXRayArgs()

const XRayArgs & ToolChain::getXRayArgs ( ) const

Definition at line 280 of file ToolChain.cpp.

Referenced by clang::driver::toolchains::DarwinClang::AddLinkRuntimeLibArgs(), and clang::driver::tools::Clang::ConstructJob().

◆ hasBlocksRuntime()

virtual bool clang::driver::ToolChain::hasBlocksRuntime ( ) const

inlinevirtual

hasBlocksRuntime - Given that the user is compiling with -fblocks, does this tool chain guarantee the existence of a blocks runtime?

FIXME: this really belongs on some sort of DeploymentTarget abstraction

Reimplemented in clang::driver::toolchains::Darwin, clang::driver::toolchains::VEToolChain, and clang::driver::toolchains::XCoreToolChain.

Definition at line 649 of file ToolChain.h.

Referenced by clang::driver::tools::Clang::ConstructJob().

◆ hasEffectiveTriple()

bool clang::driver::ToolChain::hasEffectiveTriple ( ) const

inline

Definition at line 280 of file ToolChain.h.

◆ HasNativeLLVMSupport()

bool ToolChain::HasNativeLLVMSupport ( ) const

virtual

HasNativeLTOLinker - Check whether the linker and related tools have native LLVM support.

Definition at line 923 of file ToolChain.cpp.

◆ IsAArch64OutlineAtomicsDefault()

virtual bool clang::driver::ToolChain::IsAArch64OutlineAtomicsDefault ( const llvm::opt::ArgList & Args ) const

inlinevirtual

Test whether this toolchain supports outline atomics by default.

Reimplemented in clang::driver::toolchains::Fuchsia, and clang::driver::toolchains::Linux.

Definition at line 537 of file ToolChain.h.

◆ isBareMetal()

virtual bool clang::driver::ToolChain::isBareMetal ( ) const

inlinevirtual

isBareMetal - Is this a bare metal target.

Reimplemented in clang::driver::toolchains::BareMetal.

Definition at line 615 of file ToolChain.h.

Referenced by getArchNameForCompilerRTLib(), and getCompilerRTPath().

◆ IsBlocksDefault()

virtual bool clang::driver::ToolChain::IsBlocksDefault ( ) const

inlinevirtual

IsBlocksDefault - Does this tool chain enable -fblocks by default.

Reimplemented in clang::driver::toolchains::MachO.

Definition at line 420 of file ToolChain.h.

Referenced by clang::driver::tools::Clang::ConstructJob().

◆ isCrossCompiling()

bool ToolChain::isCrossCompiling ( ) const

virtual

Returns true if the toolchain is targeting a non-native architecture.

Reimplemented in clang::driver::toolchains::AMDGPUToolChain, clang::driver::toolchains::BareMetal, clang::driver::toolchains::NVPTXToolChain, clang::driver::toolchains::Darwin, clang::driver::toolchains::HIPSPVToolChain, and clang::driver::toolchains::SPIRVToolChain.

Definition at line 927 of file ToolChain.cpp.

References getArch().

Referenced by clang::driver::toolchains::MinGW::MinGW().

◆ IsEncodeExtendedBlockSignatureDefault()

virtual bool clang::driver::ToolChain::IsEncodeExtendedBlockSignatureDefault ( ) const

inlinevirtual

IsEncodeExtendedBlockSignatureDefault - Does this tool chain enable -fencode-extended-block-signature by default.

Reimplemented in clang::driver::toolchains::MachO.

Definition at line 453 of file ToolChain.h.

Referenced by clang::driver::tools::Clang::ConstructJob().

◆ isFastMathRuntimeAvailable()

bool ToolChain::isFastMathRuntimeAvailable	(	const llvm::opt::ArgList &	Args,
		std::string &	Path
	)		const

virtual

If a runtime library exists that sets global flags for unsafe floating point math, return true.

This checks for presence of the -Ofast, -ffast-math or -funsafe-math flags.

Definition at line 1272 of file ToolChain.cpp.

References GetFilePath(), and clang::driver::isOptimizationLevelFast().

Referenced by addFastMathRuntimeIfAvailable(), and clang::driver::toolchains::Linux::getDefaultDenormalModeForType().

◆ IsIntegratedAssemblerDefault()

virtual bool clang::driver::ToolChain::IsIntegratedAssemblerDefault ( ) const

inlinevirtual

IsIntegratedAssemblerDefault - Does this tool chain enable -integrated-as by default.

Reimplemented in clang::driver::toolchains::Generic_GCC, clang::driver::toolchains::NaClToolChain, and clang::driver::toolchains::XCoreToolChain.

Definition at line 424 of file ToolChain.h.

Referenced by clang::driver::tools::Clang::ConstructJob(), and useIntegratedAs().

◆ IsIntegratedBackendDefault()

virtual bool clang::driver::ToolChain::IsIntegratedBackendDefault ( ) const

inlinevirtual

IsIntegratedBackendDefault - Does this tool chain enable -fintegrated-objemitter by default.

Reimplemented in clang::driver::toolchains::SPIRVToolChain.

Definition at line 428 of file ToolChain.h.

Referenced by useIntegratedBackend().

◆ IsIntegratedBackendSupported()

virtual bool clang::driver::ToolChain::IsIntegratedBackendSupported ( ) const

inlinevirtual

IsIntegratedBackendSupported - Does this tool chain support -fintegrated-objemitter.

Definition at line 432 of file ToolChain.h.

Referenced by useIntegratedBackend().

◆ IsMathErrnoDefault()

virtual bool clang::driver::ToolChain::IsMathErrnoDefault ( ) const

inlinevirtual

IsMathErrnoDefault - Does this tool chain use -fmath-errno by default.

Definition at line 449 of file ToolChain.h.

Referenced by clang::driver::toolchains::Linux::IsMathErrnoDefault(), and RenderFloatingPointOptions().

◆ IsNonIntegratedBackendSupported()

virtual bool clang::driver::ToolChain::IsNonIntegratedBackendSupported ( ) const

inlinevirtual

IsNonIntegratedBackendSupported - Does this tool chain support -fno-integrated-objemitter.

Reimplemented in clang::driver::toolchains::SPIRVToolChain.

Definition at line 436 of file ToolChain.h.

Referenced by useIntegratedBackend().

◆ IsObjCNonFragileABIDefault()

virtual bool clang::driver::ToolChain::IsObjCNonFragileABIDefault ( ) const

inlinevirtual

IsObjCNonFragileABIDefault - Does this tool chain set -fobjc-nonfragile-abi by default.

Reimplemented in clang::driver::toolchains::MachO, clang::driver::toolchains::FreeBSD, clang::driver::toolchains::Haiku, clang::driver::toolchains::NetBSD, clang::driver::toolchains::OpenBSD, and clang::driver::toolchains::PS4PS5Base.

Definition at line 457 of file ToolChain.h.

◆ isPICDefault()

virtual bool clang::driver::ToolChain::isPICDefault ( ) const

pure virtual

Test whether this toolchain defaults to PIC.

◆ isPICDefaultForced()

virtual bool clang::driver::ToolChain::isPICDefaultForced ( ) const

pure virtual

Tests whether this toolchain forces its default for PIC, PIE or non-PIC.

If this returns true, any PIC related flags should be ignored and instead the results of isPICDefault() and isPIEDefault(const llvm::opt::ArgList &Args) are used exclusively.

◆ isPIEDefault()

virtual bool clang::driver::ToolChain::isPIEDefault ( const llvm::opt::ArgList & Args ) const

pure virtual

Test whether this toolchain defaults to PIE.

Referenced by clang::driver::tools::freebsd::Linker::ConstructJob(), clang::driver::tools::gnutools::Linker::ConstructJob(), and getPIE().

◆ isThreadModelSupported()

bool ToolChain::isThreadModelSupported ( const StringRef Model ) const

virtual

isThreadModelSupported() - Does this target support a thread model?

Definition at line 953 of file ToolChain.cpp.

Referenced by clang::driver::tools::Clang::ConstructJob(), and clang::driver::Driver::PrintVersion().

◆ LookupTypeForExtension()

types::ID ToolChain::LookupTypeForExtension ( StringRef Ext ) const

virtual

LookupTypeForExtension - Return the default language type to use for the given extension.

Reimplemented in clang::driver::toolchains::MachO.

Definition at line 911 of file ToolChain.cpp.

References clang::driver::Driver::IsFlangMode(), and clang::driver::types::lookupTypeForExtension().

Referenced by clang::driver::Driver::BuildInputs(), and clang::driver::toolchains::MachO::LookupTypeForExtension().

◆ needsGCovInstrumentation()

bool ToolChain::needsGCovInstrumentation ( const llvm::opt::ArgList & Args )

static

Returns true if gcov instrumentation (-fprofile-arcs or –coverage) is on.

Definition at line 808 of file ToolChain.cpp.

Referenced by addPGOAndCoverageFlags(), addProfileRTLibs(), and clang::driver::toolchains::Darwin::addProfileRTLibs().

◆ needsProfileRT()

bool ToolChain::needsProfileRT ( const llvm::opt::ArgList & Args )

static

needsProfileRT - returns true if instrumentation profile is on.

Definition at line 794 of file ToolChain.cpp.

Referenced by addProfileRTLibs(), clang::driver::toolchains::AIX::addProfileRTLibs(), clang::driver::toolchains::Darwin::addProfileRTLibs(), clang::driver::toolchains::Linux::addProfileRTLibs(), and clang::driver::toolchains::OHOS::addProfileRTLibs().

◆ parseInlineAsmUsingAsmParser()

virtual bool clang::driver::ToolChain::parseInlineAsmUsingAsmParser ( ) const

inlinevirtual

Check if the toolchain should use AsmParser to parse inlineAsm when integrated assembler is not default.

Reimplemented in clang::driver::toolchains::AIX.

Definition at line 446 of file ToolChain.h.

Referenced by clang::driver::tools::Clang::ConstructJob().

◆ printVerboseInfo()

virtual void clang::driver::ToolChain::printVerboseInfo ( raw_ostream & OS ) const

inlinevirtual

Dispatch to the specific toolchain for verbose printing.

This is used when handling the verbose option to print detailed, toolchain-specific information useful for understanding the behavior of the driver on a specific platform.

Reimplemented in clang::driver::toolchains::Darwin, clang::driver::toolchains::Generic_GCC, clang::driver::toolchains::MinGW, and clang::driver::toolchains::MSVCToolChain.

Definition at line 403 of file ToolChain.h.

Referenced by clang::driver::Driver::HandleImmediateArgs().

◆ SelectTool()

Tool * ToolChain::SelectTool ( const JobAction & JA ) const

virtual

Choose a tool to use to handle the action JA.

This can be overridden when a particular ToolChain needs to use a compiler other than Clang.

Reimplemented in clang::driver::toolchains::SPIRVToolChain.

Definition at line 814 of file ToolChain.cpp.

References clang::driver::Action::AssembleJobClass, getDriver(), clang::driver::Action::getKind(), getTool(), getTriple(), clang::driver::Driver::IsFlangMode(), and useIntegratedAs().

◆ setTripleEnvironment()

void ToolChain::setTripleEnvironment ( llvm::Triple::EnvironmentType Env )

protected

Definition at line 124 of file ToolChain.cpp.

References Env.

◆ ShouldLinkCXXStdlib()

bool ToolChain::ShouldLinkCXXStdlib ( const llvm::opt::ArgList & Args ) const

Returns if the C++ standard library should be linked in.

Note that e.g. -lm should still be linked even if this returns false.

Definition at line 1235 of file ToolChain.cpp.

References clang::driver::Driver::CCCIsCXX(), and getDriver().

◆ supportsDebugInfoOption()

virtual bool clang::driver::ToolChain::supportsDebugInfoOption ( const llvm::opt::Arg * ) const

inlinevirtual

Does this toolchain supports given debug info option or not.

Reimplemented in clang::driver::toolchains::NVPTXToolChain.

Definition at line 592 of file ToolChain.h.

Referenced by checkDebugInfoOption().

◆ SupportsEmbeddedBitcode()

virtual bool clang::driver::ToolChain::SupportsEmbeddedBitcode ( ) const

inlinevirtual

SupportsEmbeddedBitcode - Does this tool chain support embedded bitcode.

Reimplemented in clang::driver::toolchains::Darwin.

Definition at line 606 of file ToolChain.h.

◆ SupportsProfiling()

virtual bool clang::driver::ToolChain::SupportsProfiling ( ) const

inlinevirtual

SupportsProfiling - Does this tool chain support -pg.

Reimplemented in clang::driver::toolchains::AMDGPUToolChain, clang::driver::toolchains::BareMetal, clang::driver::toolchains::NVPTXToolChain, clang::driver::toolchains::MachO, clang::driver::toolchains::HIPSPVToolChain, clang::driver::toolchains::SPIRVToolChain, clang::driver::toolchains::VEToolChain, and clang::driver::toolchains::XCoreToolChain.

Definition at line 554 of file ToolChain.h.

Referenced by clang::driver::tools::Clang::ConstructJob().

◆ TranslateArgs()

virtual llvm::opt::DerivedArgList * clang::driver::ToolChain::TranslateArgs	(	const llvm::opt::DerivedArgList &	Args,
		StringRef	BoundArch,
		Action::OffloadKind	DeviceOffloadKind
	)		const

inlinevirtual

TranslateArgs - Create a new derived argument list for any argument translations this ToolChain may wish to perform, or 0 if no tool chain specific translations are needed.

If DeviceOffloadKind is specified the translation specific for that offload kind is performed.

Parameters

BoundArch	- The bound architecture name, or 0.
DeviceOffloadKind	- The device offload kind used for the translation.

Reimplemented in clang::driver::toolchains::AMDGPUToolChain, clang::driver::toolchains::AMDGPUOpenMPToolChain, clang::driver::toolchains::NVPTXToolChain, clang::driver::toolchains::CudaToolChain, clang::driver::toolchains::MachO, clang::driver::toolchains::Darwin, clang::driver::toolchains::Generic_GCC, clang::driver::toolchains::HIPAMDToolChain, clang::driver::toolchains::HLSLToolChain, and clang::driver::toolchains::MSVCToolChain.

Definition at line 348 of file ToolChain.h.

Referenced by clang::driver::Compilation::getArgsForToolChain(), clang::driver::toolchains::AMDGPUToolChain::TranslateArgs(), clang::driver::toolchains::AMDGPUOpenMPToolChain::TranslateArgs(), clang::driver::toolchains::NVPTXToolChain::TranslateArgs(), clang::driver::toolchains::CudaToolChain::TranslateArgs(), and clang::driver::toolchains::HIPAMDToolChain::TranslateArgs().

◆ TranslateOpenMPTargetArgs()

llvm::opt::DerivedArgList * ToolChain::TranslateOpenMPTargetArgs	(	const llvm::opt::DerivedArgList &	Args,
		bool	SameTripleAsHost,
		SmallVectorImpl< llvm::opt::Arg * > &	AllocatedArgs
	)		const

virtual

TranslateOpenMPTargetArgs - Create a new derived argument list for that contains the OpenMP target specific flags passed via -Xopenmp-target -opt=val OR -Xopenmp-target=<triple> -opt=val.

Definition at line 1401 of file ToolChain.cpp.

References clang::driver::Driver::Diag(), getDriver(), getOpenMPTriple(), clang::driver::Driver::getOpts(), and getTripleString().

Referenced by clang::driver::Compilation::getArgsForToolChain().

◆ TranslateXarchArgs() [1/2]

void ToolChain::TranslateXarchArgs	(	const llvm::opt::DerivedArgList &	Args,
		llvm::opt::Arg *&	A,
		llvm::opt::DerivedArgList *	DAL,
		SmallVectorImpl< llvm::opt::Arg * > *	AllocatedArgs = `nullptr`
	)		const

virtual

Append the argument following A to DAL assuming A is an Xarch argument.

If AllocatedArgs is null pointer, synthesized arguments are added to DAL, otherwise they are appended to AllocatedArgs.

Definition at line 1476 of file ToolChain.cpp.

References clang::driver::Driver::Diag(), clang::DiagnosticsEngine::Error, clang::DiagnosticsEngine::getCustomDiagID(), clang::driver::Driver::getDiags(), getDriver(), clang::driver::Driver::getOpts(), and clang::driver::options::NoXarchOption.

Referenced by clang::driver::Compilation::getArgsForToolChain(), clang::driver::toolchains::MachO::TranslateArgs(), and TranslateXarchArgs().

◆ TranslateXarchArgs() [2/2]

llvm::opt::DerivedArgList * ToolChain::TranslateXarchArgs	(	const llvm::opt::DerivedArgList &	Args,
		StringRef	BoundArch,
		Action::OffloadKind	DeviceOffloadKind,
		SmallVectorImpl< llvm::opt::Arg * > *	AllocatedArgs
	)		const

virtual

Translate -Xarch_ arguments.

If there are no such arguments, return a null pointer, otherwise return a DerivedArgList containing the translated arguments.

Definition at line 1518 of file ToolChain.cpp.

References clang::driver::Action::OFK_Host, clang::driver::Action::OFK_None, and TranslateXarchArgs().

◆ UseDwarfDebugFlags()

virtual bool clang::driver::ToolChain::UseDwarfDebugFlags ( ) const

inlinevirtual

UseDwarfDebugFlags - Embed the compile options to clang into the Dwarf compile unit information.

Reimplemented in clang::driver::toolchains::MachO.

Definition at line 566 of file ToolChain.h.

Referenced by clang::driver::tools::Clang::ConstructJob().

◆ useIntegratedAs()

bool ToolChain::useIntegratedAs ( ) const

virtual

Check if the toolchain should use the integrated assembler.

Reimplemented in clang::driver::toolchains::BareMetal, clang::driver::toolchains::NVPTXToolChain, clang::driver::toolchains::HIPSPVToolChain, and clang::driver::toolchains::SPIRVToolChain.

Definition at line 136 of file ToolChain.cpp.

References IsIntegratedAssemblerDefault().

Referenced by clang::driver::tools::Clang::ConstructJob(), renderDebugOptions(), SelectTool(), and ShouldEnableAutolink().

◆ useIntegratedBackend()

bool ToolChain::useIntegratedBackend ( ) const

virtual

Check if the toolchain should use the integrated backend.

Definition at line 142 of file ToolChain.cpp.

References clang::driver::Driver::Diag(), IsIntegratedBackendDefault(), IsIntegratedBackendSupported(), and IsNonIntegratedBackendSupported().

◆ UseObjCMixedDispatch()

virtual bool clang::driver::ToolChain::UseObjCMixedDispatch ( ) const

inlinevirtual

UseObjCMixedDispatchDefault - When using non-legacy dispatch, should the mixed dispatch method be used?

Reimplemented in clang::driver::toolchains::MachO, and clang::driver::toolchains::Darwin.

Definition at line 461 of file ToolChain.h.

Referenced by RenderObjCOptions().

◆ useRelaxRelocations()

bool ToolChain::useRelaxRelocations ( ) const

virtual

Check whether to enable x86 relax relocations by default.

Definition at line 170 of file ToolChain.cpp.

Friends And Related Function Documentation

◆ RegisterEffectiveTriple

friend class RegisterEffectiveTriple

friend

Definition at line 133 of file ToolChain.h.

Member Data Documentation

◆ Multilibs

MultilibSet clang::driver::ToolChain::Multilibs

protected

Definition at line 193 of file ToolChain.h.

◆ SelectedMultilibs

llvm::SmallVector<Multilib> clang::driver::ToolChain::SelectedMultilibs

protected

Definition at line 194 of file ToolChain.h.

The documentation for this class was generated from the following files:

include/clang/Driver/ToolChain.h
lib/Driver/ToolChain.cpp

Classes

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Friends

Detailed Description

Member Typedef Documentation

◆ path_list

Member Enumeration Documentation

◆ CXXStdlibType

◆ FileType

◆ RTTIMode

◆ RuntimeLibType

◆ UnwindLibType

◆ UnwindTableLevel

Constructor & Destructor Documentation

◆ ToolChain()

◆ ~ToolChain()

Member Function Documentation

◆ AddCCKextLibArgs()

◆ addClangCC1ASTargetOptions()

◆ AddClangCXXStdlibIncludeArgs()

◆ AddClangCXXStdlibIsystemArgs()

◆ AddClangSystemIncludeArgs()

◆ addClangTargetOptions()

◆ addClangWarningOptions()

◆ AddCudaIncludeArgs()

◆ AddCXXStdlibLibArgs()

◆ addExternCSystemInclude()

◆ addExternCSystemIncludeIfExists()

◆ addFastMathRuntimeIfAvailable()

◆ AddFilePathLibArgs()

◆ AddHIPIncludeArgs()

◆ AddHIPRuntimeLibArgs()

◆ AddIAMCUIncludeArgs()

◆ addProfileRTLibs()

◆ addSystemInclude()

◆ addSystemIncludes()

◆ adjustDebugInfoKind()

◆ buildAssembler()

◆ buildCompilerRTBasename()

◆ buildLinker()

◆ buildStaticLibTool()

◆ canSplitThinLTOUnit()

◆ CheckObjCARC()

◆ ComputeEffectiveClangTriple()

◆ ComputeLLVMTriple()

◆ computeMSVCVersion()

◆ computeSysRoot()

◆ concat()

◆ defaultToIEEELongDouble()

◆ detectLibcxxVersion()

◆ executeToolChainProgram()

◆ getArch()

◆ getArchName()

◆ getArchSpecificLibPaths()

◆ getAuxTriple()

◆ getCompilerRT()

◆ getCompilerRTArgString()

◆ getCompilerRTBasename()

◆ getCompilerRTPath()

◆ GetCXXStdlibType()

◆ GetDefaultCXXStdlibType()

◆ getDefaultDebugFormat()

◆ getDefaultDebuggerTuning()

◆ getDefaultDenormalModeForType()

◆ GetDefaultDwarfVersion()

◆ getDefaultLinker()

◆ getDefaultObjCRuntime()

◆ GetDefaultRuntimeLibType()

◆ getDefaultSanitizers()

◆ GetDefaultStackProtectorLevel()

◆ GetDefaultStandaloneDebug()

◆ GetDefaultTrivialAutoVarInit()

◆ getDefaultUniversalArchName()

◆ GetDefaultUnwindLibType()

◆ getDefaultUnwindTableLevel()