1 //===--- ToolChain.cpp - Collections of tools for one platform ------------===//
3 // The LLVM Compiler Infrastructure
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
8 //===----------------------------------------------------------------------===//
11 #include "clang/Basic/ObjCRuntime.h"
12 #include "clang/Driver/Action.h"
13 #include "clang/Driver/Driver.h"
14 #include "clang/Driver/DriverDiagnostic.h"
15 #include "clang/Driver/Options.h"
16 #include "clang/Driver/SanitizerArgs.h"
17 #include "clang/Driver/ToolChain.h"
18 #include "llvm/ADT/SmallString.h"
19 #include "llvm/ADT/StringSwitch.h"
20 #include "llvm/Option/Arg.h"
21 #include "llvm/Option/ArgList.h"
22 #include "llvm/Option/Option.h"
23 #include "llvm/Support/ErrorHandling.h"
24 #include "llvm/Support/FileSystem.h"
25 using namespace clang::driver;
26 using namespace clang;
27 using namespace llvm::opt;
29 static llvm::opt::Arg *GetRTTIArgument(const ArgList &Args) {
30 return Args.getLastArg(options::OPT_mkernel, options::OPT_fapple_kext,
31 options::OPT_fno_rtti, options::OPT_frtti);
34 static ToolChain::RTTIMode CalculateRTTIMode(const ArgList &Args,
35 const llvm::Triple &Triple,
36 const Arg *CachedRTTIArg) {
37 // Explicit rtti/no-rtti args
39 if (CachedRTTIArg->getOption().matches(options::OPT_frtti))
40 return ToolChain::RM_EnabledExplicitly;
42 return ToolChain::RM_DisabledExplicitly;
45 // -frtti is default, except for the PS4 CPU.
46 if (!Triple.isPS4CPU())
47 return ToolChain::RM_EnabledImplicitly;
49 // On the PS4, turning on c++ exceptions turns on rtti.
50 // We're assuming that, if we see -fexceptions, rtti gets turned on.
51 Arg *Exceptions = Args.getLastArgNoClaim(
52 options::OPT_fcxx_exceptions, options::OPT_fno_cxx_exceptions,
53 options::OPT_fexceptions, options::OPT_fno_exceptions);
55 (Exceptions->getOption().matches(options::OPT_fexceptions) ||
56 Exceptions->getOption().matches(options::OPT_fcxx_exceptions)))
57 return ToolChain::RM_EnabledImplicitly;
59 return ToolChain::RM_DisabledImplicitly;
62 ToolChain::ToolChain(const Driver &D, const llvm::Triple &T,
64 : D(D), Triple(T), Args(Args), CachedRTTIArg(GetRTTIArgument(Args)),
65 CachedRTTIMode(CalculateRTTIMode(Args, Triple, CachedRTTIArg)) {
66 if (Arg *A = Args.getLastArg(options::OPT_mthread_model))
67 if (!isThreadModelSupported(A->getValue()))
68 D.Diag(diag::err_drv_invalid_thread_model_for_target)
69 << A->getValue() << A->getAsString(Args);
72 ToolChain::~ToolChain() {
75 const Driver &ToolChain::getDriver() const {
79 bool ToolChain::useIntegratedAs() const {
80 return Args.hasFlag(options::OPT_fintegrated_as,
81 options::OPT_fno_integrated_as,
82 IsIntegratedAssemblerDefault());
85 const SanitizerArgs& ToolChain::getSanitizerArgs() const {
86 if (!SanitizerArguments.get())
87 SanitizerArguments.reset(new SanitizerArgs(*this, Args));
88 return *SanitizerArguments.get();
91 StringRef ToolChain::getDefaultUniversalArchName() const {
92 // In universal driver terms, the arch name accepted by -arch isn't exactly
93 // the same as the ones that appear in the triple. Roughly speaking, this is
94 // an inverse of the darwin::getArchTypeForDarwinArchName() function, but the
95 // only interesting special case is powerpc.
96 switch (Triple.getArch()) {
97 case llvm::Triple::ppc:
99 case llvm::Triple::ppc64:
101 case llvm::Triple::ppc64le:
104 return Triple.getArchName();
108 bool ToolChain::IsUnwindTablesDefault() const {
112 Tool *ToolChain::getClang() const {
114 Clang.reset(new tools::Clang(*this));
118 Tool *ToolChain::buildAssembler() const {
119 return new tools::ClangAs(*this);
122 Tool *ToolChain::buildLinker() const {
123 llvm_unreachable("Linking is not supported by this toolchain");
126 Tool *ToolChain::getAssemble() const {
128 Assemble.reset(buildAssembler());
129 return Assemble.get();
132 Tool *ToolChain::getClangAs() const {
134 Assemble.reset(new tools::ClangAs(*this));
135 return Assemble.get();
138 Tool *ToolChain::getLink() const {
140 Link.reset(buildLinker());
144 Tool *ToolChain::getTool(Action::ActionClass AC) const {
146 case Action::AssembleJobClass:
147 return getAssemble();
149 case Action::LinkJobClass:
152 case Action::InputClass:
153 case Action::BindArchClass:
154 case Action::CudaDeviceClass:
155 case Action::CudaHostClass:
156 case Action::LipoJobClass:
157 case Action::DsymutilJobClass:
158 case Action::VerifyDebugInfoJobClass:
159 llvm_unreachable("Invalid tool kind.");
161 case Action::CompileJobClass:
162 case Action::PrecompileJobClass:
163 case Action::PreprocessJobClass:
164 case Action::AnalyzeJobClass:
165 case Action::MigrateJobClass:
166 case Action::VerifyPCHJobClass:
167 case Action::BackendJobClass:
171 llvm_unreachable("Invalid tool kind.");
174 Tool *ToolChain::SelectTool(const JobAction &JA) const {
175 if (getDriver().ShouldUseClangCompiler(JA))
177 Action::ActionClass AC = JA.getKind();
178 if (AC == Action::AssembleJobClass && useIntegratedAs())
183 std::string ToolChain::GetFilePath(const char *Name) const {
184 return D.GetFilePath(Name, *this);
188 std::string ToolChain::GetProgramPath(const char *Name) const {
189 return D.GetProgramPath(Name, *this);
192 std::string ToolChain::GetLinkerPath() const {
193 if (Arg *A = Args.getLastArg(options::OPT_fuse_ld_EQ)) {
194 StringRef Suffix = A->getValue();
196 // If we're passed -fuse-ld= with no argument, or with the argument ld,
197 // then use whatever the default system linker is.
198 if (Suffix.empty() || Suffix == "ld")
199 return GetProgramPath("ld");
201 llvm::SmallString<8> LinkerName("ld.");
202 LinkerName.append(Suffix);
204 std::string LinkerPath(GetProgramPath(LinkerName.c_str()));
205 if (llvm::sys::fs::exists(LinkerPath))
208 getDriver().Diag(diag::err_drv_invalid_linker_name) << A->getAsString(Args);
212 return GetProgramPath("ld");
216 types::ID ToolChain::LookupTypeForExtension(const char *Ext) const {
217 return types::lookupTypeForExtension(Ext);
220 bool ToolChain::HasNativeLLVMSupport() const {
224 bool ToolChain::isCrossCompiling() const {
225 llvm::Triple HostTriple(LLVM_HOST_TRIPLE);
226 switch (HostTriple.getArch()) {
227 // The A32/T32/T16 instruction sets are not separate architectures in this
229 case llvm::Triple::arm:
230 case llvm::Triple::armeb:
231 case llvm::Triple::thumb:
232 case llvm::Triple::thumbeb:
233 return getArch() != llvm::Triple::arm && getArch() != llvm::Triple::thumb &&
234 getArch() != llvm::Triple::armeb && getArch() != llvm::Triple::thumbeb;
236 return HostTriple.getArch() != getArch();
240 ObjCRuntime ToolChain::getDefaultObjCRuntime(bool isNonFragile) const {
241 return ObjCRuntime(isNonFragile ? ObjCRuntime::GNUstep : ObjCRuntime::GCC,
245 bool ToolChain::isThreadModelSupported(const StringRef Model) const {
246 if (Model == "single") {
247 // FIXME: 'single' is only supported on ARM so far.
248 return Triple.getArch() == llvm::Triple::arm ||
249 Triple.getArch() == llvm::Triple::armeb ||
250 Triple.getArch() == llvm::Triple::thumb ||
251 Triple.getArch() == llvm::Triple::thumbeb;
252 } else if (Model == "posix")
258 std::string ToolChain::ComputeLLVMTriple(const ArgList &Args,
259 types::ID InputType) const {
260 switch (getTriple().getArch()) {
262 return getTripleString();
264 case llvm::Triple::x86_64: {
265 llvm::Triple Triple = getTriple();
266 if (!Triple.isOSBinFormatMachO())
267 return getTripleString();
269 if (Arg *A = Args.getLastArg(options::OPT_march_EQ)) {
270 // x86_64h goes in the triple. Other -march options just use the
271 // vanilla triple we already have.
272 StringRef MArch = A->getValue();
273 if (MArch == "x86_64h")
274 Triple.setArchName(MArch);
276 return Triple.getTriple();
278 case llvm::Triple::aarch64: {
279 llvm::Triple Triple = getTriple();
280 if (!Triple.isOSBinFormatMachO())
281 return getTripleString();
283 // FIXME: older versions of ld64 expect the "arm64" component in the actual
284 // triple string and query it to determine whether an LTO file can be
285 // handled. Remove this when we don't care any more.
286 Triple.setArchName("arm64");
287 return Triple.getTriple();
289 case llvm::Triple::arm:
290 case llvm::Triple::armeb:
291 case llvm::Triple::thumb:
292 case llvm::Triple::thumbeb: {
293 // FIXME: Factor into subclasses.
294 llvm::Triple Triple = getTriple();
295 bool IsBigEndian = getTriple().getArch() == llvm::Triple::armeb ||
296 getTriple().getArch() == llvm::Triple::thumbeb;
298 // Handle pseudo-target flags '-mlittle-endian'/'-EL' and
299 // '-mbig-endian'/'-EB'.
300 if (Arg *A = Args.getLastArg(options::OPT_mlittle_endian,
301 options::OPT_mbig_endian)) {
302 IsBigEndian = !A->getOption().matches(options::OPT_mlittle_endian);
305 // Thumb2 is the default for V7 on Darwin.
307 // FIXME: Thumb should just be another -target-feaure, not in the triple.
308 std::string CPU = Triple.isOSBinFormatMachO()
309 ? tools::arm::getARMCPUForMArch(Args, Triple)
310 : tools::arm::getARMTargetCPU(Args, Triple);
312 tools::arm::getLLVMArchSuffixForARM(CPU,
313 tools::arm::getARMArch(Args, Triple));
314 bool ThumbDefault = Suffix.startswith("v6m") || Suffix.startswith("v7m") ||
315 Suffix.startswith("v7em") ||
316 (Suffix.startswith("v7") && getTriple().isOSBinFormatMachO());
317 // FIXME: this is invalid for WindowsCE
318 if (getTriple().isOSWindows())
320 std::string ArchName;
326 // Assembly files should start in ARM mode.
327 if (InputType != types::TY_PP_Asm &&
328 Args.hasFlag(options::OPT_mthumb, options::OPT_mno_thumb, ThumbDefault))
331 ArchName = "thumbeb";
335 Triple.setArchName(ArchName + Suffix.str());
337 return Triple.getTriple();
342 std::string ToolChain::ComputeEffectiveClangTriple(const ArgList &Args,
343 types::ID InputType) const {
344 return ComputeLLVMTriple(Args, InputType);
347 void ToolChain::AddClangSystemIncludeArgs(const ArgList &DriverArgs,
348 ArgStringList &CC1Args) const {
349 // Each toolchain should provide the appropriate include flags.
352 void ToolChain::addClangTargetOptions(const ArgList &DriverArgs,
353 ArgStringList &CC1Args) const {
356 void ToolChain::addClangWarningOptions(ArgStringList &CC1Args) const {}
358 ToolChain::RuntimeLibType ToolChain::GetRuntimeLibType(
359 const ArgList &Args) const
361 if (Arg *A = Args.getLastArg(options::OPT_rtlib_EQ)) {
362 StringRef Value = A->getValue();
363 if (Value == "compiler-rt")
364 return ToolChain::RLT_CompilerRT;
365 if (Value == "libgcc")
366 return ToolChain::RLT_Libgcc;
367 getDriver().Diag(diag::err_drv_invalid_rtlib_name)
368 << A->getAsString(Args);
371 return GetDefaultRuntimeLibType();
374 ToolChain::CXXStdlibType ToolChain::GetCXXStdlibType(const ArgList &Args) const{
375 if (Arg *A = Args.getLastArg(options::OPT_stdlib_EQ)) {
376 StringRef Value = A->getValue();
377 if (Value == "libc++")
378 return ToolChain::CST_Libcxx;
379 if (Value == "libstdc++")
380 return ToolChain::CST_Libstdcxx;
381 getDriver().Diag(diag::err_drv_invalid_stdlib_name)
382 << A->getAsString(Args);
385 return ToolChain::CST_Libstdcxx;
388 /// \brief Utility function to add a system include directory to CC1 arguments.
389 /*static*/ void ToolChain::addSystemInclude(const ArgList &DriverArgs,
390 ArgStringList &CC1Args,
392 CC1Args.push_back("-internal-isystem");
393 CC1Args.push_back(DriverArgs.MakeArgString(Path));
396 /// \brief Utility function to add a system include directory with extern "C"
397 /// semantics to CC1 arguments.
399 /// Note that this should be used rarely, and only for directories that
400 /// historically and for legacy reasons are treated as having implicit extern
401 /// "C" semantics. These semantics are *ignored* by and large today, but its
402 /// important to preserve the preprocessor changes resulting from the
404 /*static*/ void ToolChain::addExternCSystemInclude(const ArgList &DriverArgs,
405 ArgStringList &CC1Args,
407 CC1Args.push_back("-internal-externc-isystem");
408 CC1Args.push_back(DriverArgs.MakeArgString(Path));
411 void ToolChain::addExternCSystemIncludeIfExists(const ArgList &DriverArgs,
412 ArgStringList &CC1Args,
414 if (llvm::sys::fs::exists(Path))
415 addExternCSystemInclude(DriverArgs, CC1Args, Path);
418 /// \brief Utility function to add a list of system include directories to CC1.
419 /*static*/ void ToolChain::addSystemIncludes(const ArgList &DriverArgs,
420 ArgStringList &CC1Args,
421 ArrayRef<StringRef> Paths) {
422 for (ArrayRef<StringRef>::iterator I = Paths.begin(), E = Paths.end();
424 CC1Args.push_back("-internal-isystem");
425 CC1Args.push_back(DriverArgs.MakeArgString(*I));
429 void ToolChain::AddClangCXXStdlibIncludeArgs(const ArgList &DriverArgs,
430 ArgStringList &CC1Args) const {
431 // Header search paths should be handled by each of the subclasses.
432 // Historically, they have not been, and instead have been handled inside of
433 // the CC1-layer frontend. As the logic is hoisted out, this generic function
434 // will slowly stop being called.
436 // While it is being called, replicate a bit of a hack to propagate the
437 // '-stdlib=' flag down to CC1 so that it can in turn customize the C++
438 // header search paths with it. Once all systems are overriding this
439 // function, the CC1 flag and this line can be removed.
440 DriverArgs.AddAllArgs(CC1Args, options::OPT_stdlib_EQ);
443 void ToolChain::AddCXXStdlibLibArgs(const ArgList &Args,
444 ArgStringList &CmdArgs) const {
445 CXXStdlibType Type = GetCXXStdlibType(Args);
448 case ToolChain::CST_Libcxx:
449 CmdArgs.push_back("-lc++");
452 case ToolChain::CST_Libstdcxx:
453 CmdArgs.push_back("-lstdc++");
458 void ToolChain::AddCCKextLibArgs(const ArgList &Args,
459 ArgStringList &CmdArgs) const {
460 CmdArgs.push_back("-lcc_kext");
463 bool ToolChain::AddFastMathRuntimeIfAvailable(const ArgList &Args,
464 ArgStringList &CmdArgs) const {
465 // Do not check for -fno-fast-math or -fno-unsafe-math when -Ofast passed
466 // (to keep the linker options consistent with gcc and clang itself).
467 if (!isOptimizationLevelFast(Args)) {
468 // Check if -ffast-math or -funsafe-math.
470 Args.getLastArg(options::OPT_ffast_math, options::OPT_fno_fast_math,
471 options::OPT_funsafe_math_optimizations,
472 options::OPT_fno_unsafe_math_optimizations);
474 if (!A || A->getOption().getID() == options::OPT_fno_fast_math ||
475 A->getOption().getID() == options::OPT_fno_unsafe_math_optimizations)
478 // If crtfastmath.o exists add it to the arguments.
479 std::string Path = GetFilePath("crtfastmath.o");
480 if (Path == "crtfastmath.o") // Not found.
483 CmdArgs.push_back(Args.MakeArgString(Path));
487 SanitizerMask ToolChain::getSupportedSanitizers() const {
488 // Return sanitizers which don't require runtime support and are not
489 // platform or architecture-dependent.
490 using namespace SanitizerKind;
491 return (Undefined & ~Vptr & ~Function) | CFI | CFICastStrict |
492 UnsignedIntegerOverflow | LocalBounds;