LLVM 20.0.0git
TargetMachine.cpp
Go to the documentation of this file.
1//===-- TargetMachine.cpp - General Target Information ---------------------==//
2//
3// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4// See https://llvm.org/LICENSE.txt for license information.
5// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6//
7//===----------------------------------------------------------------------===//
8//
9// This file describes the general parts of a Target machine.
10//
11//===----------------------------------------------------------------------===//
12
15#include "llvm/IR/Function.h"
16#include "llvm/IR/GlobalValue.h"
18#include "llvm/IR/Mangler.h"
19#include "llvm/IR/Module.h"
20#include "llvm/MC/MCAsmInfo.h"
21#include "llvm/MC/MCContext.h"
22#include "llvm/MC/MCInstrInfo.h"
27using namespace llvm;
28
29//---------------------------------------------------------------------------
30// TargetMachine Class
31//
32
34 const Triple &TT, StringRef CPU, StringRef FS,
36 : TheTarget(T), DL(DataLayoutString), TargetTriple(TT),
37 TargetCPU(std::string(CPU)), TargetFS(std::string(FS)), AsmInfo(nullptr),
38 MRI(nullptr), MII(nullptr), STI(nullptr), RequireStructuredCFG(false),
39 O0WantsFastISel(false), Options(Options) {}
40
42
44 if (getTargetTriple().getArch() != Triple::x86_64)
45 return false;
46
47 // Remaining logic below is ELF-specific. For other object file formats where
48 // the large code model is mostly used for JIT compilation, just look at the
49 // code model.
50 if (!getTargetTriple().isOSBinFormatELF())
52
53 auto *GO = GVal->getAliaseeObject();
54
55 // Be conservative if we can't find an underlying GlobalObject.
56 if (!GO)
57 return true;
58
59 auto *GV = dyn_cast<GlobalVariable>(GO);
60
61 auto IsPrefix = [](StringRef Name, StringRef Prefix) {
62 return Name.consume_front(Prefix) && (Name.empty() || Name[0] == '.');
63 };
64
65 // Functions/GlobalIFuncs are only large under the large code model.
66 if (!GV) {
67 // Handle explicit sections as we do for GlobalVariables with an explicit
68 // section, see comments below.
69 if (GO->hasSection()) {
70 StringRef Name = GO->getSection();
71 return IsPrefix(Name, ".ltext");
72 }
74 }
75
76 if (GV->isThreadLocal())
77 return false;
78
79 // For x86-64, we treat an explicit GlobalVariable small code model to mean
80 // that the global should be placed in a small section, and ditto for large.
81 if (auto CM = GV->getCodeModel()) {
82 if (*CM == CodeModel::Small)
83 return false;
84 if (*CM == CodeModel::Large)
85 return true;
86 }
87
88 // Treat all globals in explicit sections as small, except for the standard
89 // large sections of .lbss, .ldata, .lrodata. This reduces the risk of linking
90 // together small and large sections, resulting in small references to large
91 // data sections. The code model attribute overrides this above.
92 if (GV->hasSection()) {
93 StringRef Name = GV->getSection();
94 return IsPrefix(Name, ".lbss") || IsPrefix(Name, ".ldata") ||
95 IsPrefix(Name, ".lrodata");
96 }
97
98 // Respect large data threshold for medium and large code models.
101 if (!GV->getValueType()->isSized())
102 return true;
103 // Linker defined start/stop symbols can point to arbitrary points in the
104 // binary, so treat them as large.
105 if (GV->isDeclaration() && (GV->getName() == "__ehdr_start" ||
106 GV->getName().starts_with("__start_") ||
107 GV->getName().starts_with("__stop_")))
108 return true;
109 const DataLayout &DL = GV->getDataLayout();
110 uint64_t Size = DL.getTypeAllocSize(GV->getValueType());
111 return Size == 0 || Size > LargeDataThreshold;
112 }
113
114 return false;
115}
116
119}
120
121/// Reset the target options based on the function's attributes.
122/// setFunctionAttributes should have made the raw attribute value consistent
123/// with the command line flag if used.
124//
125// FIXME: This function needs to go away for a number of reasons:
126// a) global state on the TargetMachine is terrible in general,
127// b) these target options should be passed only on the function
128// and not on the TargetMachine (via TargetOptions) at all.
130#define RESET_OPTION(X, Y) \
131 do { \
132 Options.X = F.getFnAttribute(Y).getValueAsBool(); \
133 } while (0)
134
135 RESET_OPTION(UnsafeFPMath, "unsafe-fp-math");
136 RESET_OPTION(NoInfsFPMath, "no-infs-fp-math");
137 RESET_OPTION(NoNaNsFPMath, "no-nans-fp-math");
138 RESET_OPTION(NoSignedZerosFPMath, "no-signed-zeros-fp-math");
139 RESET_OPTION(ApproxFuncFPMath, "approx-func-fp-math");
140}
141
142/// Returns the code generation relocation model. The choices are static, PIC,
143/// and dynamic-no-pic.
145
147 switch (getCodeModel()) {
148 case CodeModel::Tiny:
149 return llvm::maxUIntN(10);
150 case CodeModel::Small:
153 return llvm::maxUIntN(31);
154 case CodeModel::Large:
155 return llvm::maxUIntN(64);
156 }
157 llvm_unreachable("Unhandled CodeModel enum");
158}
159
160/// Get the IR-specified TLS model for Var.
162 switch (GV->getThreadLocalMode()) {
164 llvm_unreachable("getSelectedTLSModel for non-TLS variable");
165 break;
173 return TLSModel::LocalExec;
174 }
175 llvm_unreachable("invalid TLS model");
176}
177
179 const Triple &TT = getTargetTriple();
181
182 // According to the llvm language reference, we should be able to
183 // just return false in here if we have a GV, as we know it is
184 // dso_preemptable. At this point in time, the various IR producers
185 // have not been transitioned to always produce a dso_local when it
186 // is possible to do so.
187 //
188 // As a result we still have some logic in here to improve the quality of the
189 // generated code.
190 if (!GV)
191 return false;
192
193 // If the IR producer requested that this GV be treated as dso local, obey.
194 if (GV->isDSOLocal())
195 return true;
196
197 if (TT.isOSBinFormatCOFF()) {
198 // DLLImport explicitly marks the GV as external.
199 if (GV->hasDLLImportStorageClass())
200 return false;
201
202 // On MinGW, variables that haven't been declared with DLLImport may still
203 // end up automatically imported by the linker. To make this feasible,
204 // don't assume the variables to be DSO local unless we actually know
205 // that for sure. This only has to be done for variables; for functions
206 // the linker can insert thunks for calling functions from another DLL.
207 if (TT.isWindowsGNUEnvironment() && GV->isDeclarationForLinker() &&
208 isa<GlobalVariable>(GV))
209 return false;
210
211 // Don't mark 'extern_weak' symbols as DSO local. If these symbols remain
212 // unresolved in the link, they can be resolved to zero, which is outside
213 // the current DSO.
214 if (GV->hasExternalWeakLinkage())
215 return false;
216
217 // Every other GV is local on COFF.
218 return true;
219 }
220
221 if (TT.isOSBinFormatGOFF())
222 return true;
223
224 if (TT.isOSBinFormatMachO()) {
225 if (RM == Reloc::Static)
226 return true;
227 return GV->isStrongDefinitionForLinker();
228 }
229
230 assert(TT.isOSBinFormatELF() || TT.isOSBinFormatWasm() ||
231 TT.isOSBinFormatXCOFF());
232 return false;
233}
234
237
239 bool IsPIE = GV->getParent()->getPIELevel() != PIELevel::Default;
241 bool IsSharedLibrary = RM == Reloc::PIC_ && !IsPIE;
242 bool IsLocal = shouldAssumeDSOLocal(GV);
243
244 TLSModel::Model Model;
245 if (IsSharedLibrary) {
246 if (IsLocal)
248 else
250 } else {
251 if (IsLocal)
252 Model = TLSModel::LocalExec;
253 else
254 Model = TLSModel::InitialExec;
255 }
256
257 // If the user specified a more specific model, use that.
258 TLSModel::Model SelectedModel = getSelectedTLSModel(GV);
259 if (SelectedModel > Model)
260 return SelectedModel;
261
262 return Model;
263}
264
267 return TargetTransformInfo(F.getDataLayout());
268}
269
271 const GlobalValue *GV, Mangler &Mang,
272 bool MayAlwaysUsePrivate) const {
273 if (MayAlwaysUsePrivate || !GV->hasPrivateLinkage()) {
274 // Simple case: If GV is not private, it is not important to find out if
275 // private labels are legal in this case or not.
276 Mang.getNameWithPrefix(Name, GV, false);
277 return;
278 }
280 TLOF->getNameWithPrefix(Name, GV, *this);
281}
282
285 // XCOFF symbols could have special naming convention.
286 if (MCSymbol *TargetSymbol = TLOF->getTargetSymbol(GV, *this))
287 return TargetSymbol;
288
289 SmallString<128> NameStr;
290 getNameWithPrefix(NameStr, GV, TLOF->getMangler());
291 return TLOF->getContext().getOrCreateSymbol(NameStr);
292}
293
295 // Since Analysis can't depend on Target, use a std::function to invert the
296 // dependency.
297 return TargetIRAnalysis(
298 [this](const Function &F) { return this->getTargetTransformInfo(F); });
299}
300
302 if (Version == "none")
303 return {INT_MAX, INT_MAX}; // Make binutilsIsAtLeast() return true.
304 std::pair<int, int> Ret;
305 if (!Version.consumeInteger(10, Ret.first) && Version.consume_front("."))
306 Version.consumeInteger(10, Ret.second);
307 return Ret;
308}
unsigned const MachineRegisterInfo * MRI
MachineBasicBlock MachineBasicBlock::iterator DebugLoc DL
std::string Name
uint64_t Size
static LVOptions Options
Definition: LVOptions.cpp:25
#define F(x, y, z)
Definition: MD5.cpp:55
Module.h This file contains the declarations for the Module class.
assert(ImpDefSCC.getReg()==AMDGPU::SCC &&ImpDefSCC.isDef())
static TLSModel::Model getSelectedTLSModel(const GlobalValue *GV)
Get the IR-specified TLS model for Var.
#define RESET_OPTION(X, Y)
This pass exposes codegen information to IR-level passes.
A parsed version of the target data layout string in and methods for querying it.
Definition: DataLayout.h:63
TypeSize getTypeAllocSize(Type *Ty) const
Returns the offset in bytes between successive objects of the specified type, including alignment pad...
Definition: DataLayout.h:461
bool isDSOLocal() const
Definition: GlobalValue.h:305
bool hasPrivateLinkage() const
Definition: GlobalValue.h:527
bool hasExternalWeakLinkage() const
Definition: GlobalValue.h:529
ThreadLocalMode getThreadLocalMode() const
Definition: GlobalValue.h:271
bool hasDLLImportStorageClass() const
Definition: GlobalValue.h:278
bool isDeclarationForLinker() const
Definition: GlobalValue.h:618
Module * getParent()
Get the module that this global value is contained inside of...
Definition: GlobalValue.h:656
const GlobalObject * getAliaseeObject() const
Definition: Globals.cpp:394
bool isStrongDefinitionForLinker() const
Returns true if this global's definition will be the one chosen by the linker.
Definition: GlobalValue.h:631
MCSymbol * getOrCreateSymbol(const Twine &Name)
Lookup the symbol inside with the specified Name.
Definition: MCContext.cpp:213
MCContext & getContext() const
MCSymbol - Instances of this class represent a symbol name in the MC file, and MCSymbols are created ...
Definition: MCSymbol.h:41
void getNameWithPrefix(raw_ostream &OS, const GlobalValue *GV, bool CannotUsePrivateLabel) const
Print the appropriate prefix and the specified global variable's name.
Definition: Mangler.cpp:120
PIELevel::Level getPIELevel() const
Returns the PIE level (small or large model)
Definition: Module.cpp:598
SmallString - A SmallString is just a SmallVector with methods and accessors that make it work better...
Definition: SmallString.h:26
This class consists of common code factored out of the SmallVector class to reduce code duplication b...
Definition: SmallVector.h:586
StringRef - Represent a constant reference to a string, i.e.
Definition: StringRef.h:50
Analysis pass providing the TargetTransformInfo.
virtual void getNameWithPrefix(SmallVectorImpl< char > &OutName, const GlobalValue *GV, const TargetMachine &TM) const
virtual MCSymbol * getTargetSymbol(const GlobalValue *GV, const TargetMachine &TM) const
Targets that have a special convention for their symbols could use this hook to return a specialized ...
TLSModel::Model getTLSModel(const GlobalValue *GV) const
Returns the TLS model which should be used for the given global variable.
bool isPositionIndependent() const
uint64_t getMaxCodeSize() const
Returns the maximum code size possible under the code model.
const Triple & getTargetTriple() const
bool useTLSDESC() const
Returns true if this target uses TLS Descriptors.
uint64_t LargeDataThreshold
bool useEmulatedTLS() const
Returns true if this target uses emulated TLS.
virtual TargetLoweringObjectFile * getObjFileLowering() const
Reloc::Model getRelocationModel() const
Returns the code generation relocation model.
virtual TargetTransformInfo getTargetTransformInfo(const Function &F) const
Return a TargetTransformInfo for a given function.
const DataLayout DL
DataLayout for the target: keep ABI type size and alignment.
Definition: TargetMachine.h:92
bool shouldAssumeDSOLocal(const GlobalValue *GV) const
static std::pair< int, int > parseBinutilsVersion(StringRef Version)
TargetIRAnalysis getTargetIRAnalysis() const
Get a TargetIRAnalysis appropriate for the target.
TargetOptions Options
virtual ~TargetMachine()
MCSymbol * getSymbol(const GlobalValue *GV) const
CodeModel::Model getCodeModel() const
Returns the code model.
bool isLargeGlobalValue(const GlobalValue *GV) const
void resetTargetOptions(const Function &F) const
Reset the target options based on the function's attributes.
TargetMachine(const Target &T, StringRef DataLayoutString, const Triple &TargetTriple, StringRef CPU, StringRef FS, const TargetOptions &Options)
void getNameWithPrefix(SmallVectorImpl< char > &Name, const GlobalValue *GV, Mangler &Mang, bool MayAlwaysUsePrivate=false) const
unsigned EnableTLSDESC
EnableTLSDESC - This flag enables TLS Descriptors.
unsigned EmulatedTLS
EmulatedTLS - This flag enables emulated TLS model, using emutls function in the runtime library.
This pass provides access to the codegen interfaces that are needed for IR-level transformations.
Target - Wrapper for Target specific information.
Triple - Helper class for working with autoconf configuration names.
Definition: Triple.h:44
#define llvm_unreachable(msg)
Marks that the current location is not supposed to be reachable.
@ GeneralDynamic
Definition: CodeGen.h:46
This is an optimization pass for GlobalISel generic memory operations.
Definition: AddressRanges.h:18
uint64_t maxUIntN(uint64_t N)
Gets the maximum value for a N-bit unsigned integer.
Definition: MathExtras.h:219
Implement std::hash so that hash_code can be used in STL containers.
Definition: BitVector.h:858