LLVM 23.0.0git
LowerEmuTLS.cpp
Go to the documentation of this file.
1//===- LowerEmuTLS.cpp - Add __emutls_[vt].* variables --------------------===//
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 transformation is required for targets depending on libgcc style
10// emulated thread local storage variables. For every defined TLS variable xyz,
11// an __emutls_v.xyz is generated. If there is non-zero initialized value
12// an __emutls_t.xyz is also generated.
13//
14//===----------------------------------------------------------------------===//
15
21#include "llvm/CodeGen/Passes.h"
23#include "llvm/IR/Constants.h"
24#include "llvm/IR/Module.h"
26#include "llvm/Pass.h"
28
29using namespace llvm;
30
31#define DEBUG_TYPE "lower-emutls"
32
33namespace {
34
35class LowerEmuTLS : public ModulePass {
36public:
37 static char ID; // Pass identification, replacement for typeid
38 LowerEmuTLS() : ModulePass(ID) {}
39
40 bool runOnModule(Module &M) override;
41};
42}
43
44static bool addEmuTlsVar(Module &M, const GlobalVariable *GV);
45
46static void copyLinkageVisibility(Module &M, const GlobalVariable *from,
47 GlobalVariable *to) {
48 to->setLinkage(from->getLinkage());
49 to->setVisibility(from->getVisibility());
50 to->setDSOLocal(from->isDSOLocal());
51 if (from->hasComdat()) {
52 to->setComdat(M.getOrInsertComdat(to->getName()));
54 }
55}
56
58 bool Changed = false;
60 for (const auto &G : M.globals()) {
61 if (G.isThreadLocal())
62 TlsVars.push_back(&G);
63 }
64 for (const auto *G : TlsVars)
65 Changed |= addEmuTlsVar(M, G);
66
67 if (!Changed)
70 PA.abandon<GlobalsAA>();
73 return PA;
74}
75
76char LowerEmuTLS::ID = 0;
77
79 "Add __emutls_[vt]. variables for emultated TLS model", false,
80 false)
81
82ModulePass *llvm::createLowerEmuTLSPass() { return new LowerEmuTLS(); }
83
84bool LowerEmuTLS::runOnModule(Module &M) {
85 if (skipModule(M))
86 return false;
87
88 auto *TPC = getAnalysisIfAvailable<TargetPassConfig>();
89 if (!TPC)
90 return false;
91
92 auto &TM = TPC->getTM<TargetMachine>();
93 if (!TM.useEmulatedTLS())
94 return false;
95
96 bool Changed = false;
98 for (const auto &G : M.globals()) {
99 if (G.isThreadLocal())
100 TlsVars.append({&G});
101 }
102 for (const auto *const G : TlsVars)
103 Changed |= addEmuTlsVar(M, G);
104 return Changed;
105}
106
107bool addEmuTlsVar(Module &M, const GlobalVariable *GV) {
108 LLVMContext &C = M.getContext();
109 PointerType *VoidPtrType = PointerType::getUnqual(C);
110
111 std::string EmuTlsVarName = ("__emutls_v." + GV->getName()).str();
112 GlobalVariable *EmuTlsVar = M.getNamedGlobal(EmuTlsVarName);
113 if (EmuTlsVar)
114 return false; // It has been added before.
115
116 const DataLayout &DL = M.getDataLayout();
117 Constant *NullPtr = ConstantPointerNull::get(VoidPtrType);
118
119 // Get non-zero initializer from GV's initializer.
120 const Constant *InitValue = nullptr;
121 if (GV->hasInitializer()) {
122 InitValue = GV->getInitializer();
123 const ConstantInt *InitIntValue = dyn_cast<ConstantInt>(InitValue);
124 // When GV's init value is all 0, omit the EmuTlsTmplVar and let
125 // the emutls library function to reset newly allocated TLS variables.
126 if (isa<ConstantAggregateZero>(InitValue) ||
127 (InitIntValue && InitIntValue->isZero()))
128 InitValue = nullptr;
129 }
130
131 // Create the __emutls_v. symbol, whose type has 4 fields:
132 // word size; // size of GV in bytes
133 // word align; // alignment of GV
134 // void *ptr; // initialized to 0; set at run time per thread.
135 // void *templ; // 0 or point to __emutls_t.*
136 // sizeof(word) should be the same as sizeof(void*) on target.
137 IntegerType *WordType = DL.getIntPtrType(C);
138 PointerType *InitPtrType = PointerType::getUnqual(C);
139 Type *ElementTypes[4] = {WordType, WordType, VoidPtrType, InitPtrType};
140 StructType *EmuTlsVarType = StructType::create(ElementTypes);
141 EmuTlsVar = M.getOrInsertGlobal(EmuTlsVarName, EmuTlsVarType);
142 copyLinkageVisibility(M, GV, EmuTlsVar);
143
144 // Define "__emutls_t.*" and "__emutls_v.*" only if GV is defined.
145 if (!GV->hasInitializer())
146 return true;
147
148 Type *GVType = GV->getValueType();
149 Align GVAlignment = DL.getValueOrABITypeAlignment(GV->getAlign(), GVType);
150
151 // Define "__emutls_t.*" if there is InitValue
152 GlobalVariable *EmuTlsTmplVar = nullptr;
153 if (InitValue) {
154 std::string EmuTlsTmplName = ("__emutls_t." + GV->getName()).str();
155 EmuTlsTmplVar = M.getOrInsertGlobal(EmuTlsTmplName, GVType);
156 assert(EmuTlsTmplVar && "Failed to create emualted TLS initializer");
157 EmuTlsTmplVar->setConstant(true);
158 EmuTlsTmplVar->setInitializer(const_cast<Constant*>(InitValue));
159 EmuTlsTmplVar->setAlignment(GVAlignment);
160 copyLinkageVisibility(M, GV, EmuTlsTmplVar);
161 }
162
163 // Define "__emutls_v.*" with initializer and alignment.
164 Constant *ElementValues[4] = {
165 ConstantInt::get(WordType, DL.getTypeStoreSize(GVType)),
166 ConstantInt::get(WordType, GVAlignment.value()), NullPtr,
167 EmuTlsTmplVar ? EmuTlsTmplVar : NullPtr};
168 EmuTlsVar->setInitializer(ConstantStruct::get(EmuTlsVarType, ElementValues));
169 Align MaxAlignment =
170 std::max(DL.getABITypeAlign(WordType), DL.getABITypeAlign(VoidPtrType));
171 EmuTlsVar->setAlignment(MaxAlignment);
172 return true;
173}
assert(UImm &&(UImm !=~static_cast< T >(0)) &&"Invalid immediate!")
MachineBasicBlock MachineBasicBlock::iterator DebugLoc DL
This file contains the declarations for the subclasses of Constant, which represent the different fla...
#define DEBUG_TYPE
This is the interface for a simple mod/ref and alias analysis over globals.
Module.h This file contains the declarations for the Module class.
static void copyLinkageVisibility(Module &M, const GlobalVariable *from, GlobalVariable *to)
static bool addEmuTlsVar(Module &M, const GlobalVariable *GV)
#define G(x, y, z)
Definition MD5.cpp:55
This is the interface to build a ModuleSummaryIndex for a module.
ModuleAnalysisManager MAM
#define INITIALIZE_PASS(passName, arg, name, cfg, analysis)
Definition PassSupport.h:56
This file defines the SmallVector class.
Target-Independent Code Generator Pass Configuration Options pass.
void setSelectionKind(SelectionKind Val)
Definition Comdat.h:48
SelectionKind getSelectionKind() const
Definition Comdat.h:47
This is the shared class of boolean and integer constants.
Definition Constants.h:87
bool isZero() const
This is just a convenience method to make client code smaller for a common code.
Definition Constants.h:219
static LLVM_ABI ConstantPointerNull * get(PointerType *T)
Static factory methods - Return objects of the specified value.
static LLVM_ABI Constant * get(StructType *T, ArrayRef< Constant * > V)
This is an important base class in LLVM.
Definition Constant.h:43
A parsed version of the target data layout string in and methods for querying it.
Definition DataLayout.h:64
LLVM_ABI void setComdat(Comdat *C)
Definition Globals.cpp:215
bool hasComdat() const
const Comdat * getComdat() const
bool isDSOLocal() const
VisibilityTypes getVisibility() const
LinkageTypes getLinkage() const
void setLinkage(LinkageTypes LT)
void setDSOLocal(bool Local)
void setVisibility(VisibilityTypes V)
Type * getValueType() const
const Constant * getInitializer() const
getInitializer - Return the initializer for this global variable.
LLVM_ABI void setInitializer(Constant *InitVal)
setInitializer - Sets the initializer for this global variable, removing any existing initializer if ...
Definition Globals.cpp:534
bool hasInitializer() const
Definitions have initializers, declarations don't.
MaybeAlign getAlign() const
Returns the alignment of the given variable.
void setConstant(bool Val)
void setAlignment(Align Align)
Sets the alignment attribute of the GlobalVariable.
Analysis pass providing a never-invalidated alias analysis result.
Class to represent integer types.
This is an important class for using LLVM in a threaded context.
Definition LLVMContext.h:68
PreservedAnalyses run(Module &M, ModuleAnalysisManager &MAM)
ModulePass class - This class is used to implement unstructured interprocedural optimizations and ana...
Definition Pass.h:255
Analysis pass to provide the ModuleSummaryIndex object.
A Module instance is used to store all the information related to an LLVM module.
Definition Module.h:67
static PointerType * getUnqual(Type *ElementType)
This constructs a pointer to an object of the specified type in the default address space (address sp...
A set of analyses that are preserved following a run of a transformation pass.
Definition Analysis.h:112
static PreservedAnalyses all()
Construct a special preserved set that preserves all passes.
Definition Analysis.h:118
PreservedAnalyses & abandon()
Mark an analysis as abandoned.
Definition Analysis.h:171
void append(ItTy in_start, ItTy in_end)
Add the specified range to the end of the SmallVector.
void push_back(const T &Elt)
This is a 'vector' (really, a variable-sized array), optimized for the case when the array is small.
This pass performs the global (interprocedural) stack safety analysis (new pass manager).
Class to represent struct types.
static LLVM_ABI StructType * create(LLVMContext &Context, StringRef Name)
This creates an identified struct.
Definition Type.cpp:619
Primary interface to the complete machine description for the target machine.
The instances of the Type class are immutable: once they are created, they are never changed.
Definition Type.h:45
LLVM_ABI StringRef getName() const
Return a constant reference to the value's name.
Definition Value.cpp:322
Changed
unsigned ID
LLVM IR allows to use arbitrary numbers as calling convention identifiers.
Definition CallingConv.h:24
@ C
The default llvm calling convention, compatible with C.
Definition CallingConv.h:34
This is an optimization pass for GlobalISel generic memory operations.
Definition Types.h:26
decltype(auto) dyn_cast(const From &Val)
dyn_cast<X> - Return the argument parameter cast to the specified type.
Definition Casting.h:643
bool isa(const From &Val)
isa<X> - Return true if the parameter to the template is an instance of one of the template type argu...
Definition Casting.h:547
LLVM_ABI ModulePass * createLowerEmuTLSPass()
LowerEmuTLS - This pass generates __emutls_[vt].xyz variables for all TLS variables for the emulated ...
AnalysisManager< Module > ModuleAnalysisManager
Convenience typedef for the Module analysis manager.
Definition MIRParser.h:39
This struct is a compact representation of a valid (non-zero power of two) alignment.
Definition Alignment.h:39
constexpr uint64_t value() const
This is a hole in the type system and should not be abused.
Definition Alignment.h:77