1 //===-- InstrProfiling.cpp - Frontend instrumentation based profiling -----===//
2 //
3 // The LLVM Compiler Infrastructure
4 //
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
7 //
8 //===----------------------------------------------------------------------===//
9 //
10 // This pass lowers instrprof_* intrinsics emitted by a frontend for profiling.
11 // It also builds the data structures and initialization code needed for
12 // updating execution counts and emitting the profile at runtime.
13 //
14 //===----------------------------------------------------------------------===//
15
16 #include "llvm/ADT/Triple.h"
17 #include "llvm/IR/IRBuilder.h"
18 #include "llvm/IR/IntrinsicInst.h"
19 #include "llvm/IR/Module.h"
20 #include "llvm/ProfileData/InstrProf.h"
21 #include "llvm/Transforms/Instrumentation.h"
22 #include "llvm/Transforms/Utils/ModuleUtils.h"
23
24 using namespace llvm;
25
26 #define DEBUG_TYPE "instrprof"
27
28 namespace {
29
30 class InstrProfiling : public ModulePass {
31 public:
32 static char ID;
33
InstrProfiling()34 InstrProfiling() : ModulePass(ID) {}
35
InstrProfiling(const InstrProfOptions & Options)36 InstrProfiling(const InstrProfOptions &Options)
37 : ModulePass(ID), Options(Options) {}
38
getPassName() const39 const char *getPassName() const override {
40 return "Frontend instrumentation-based coverage lowering";
41 }
42
43 bool runOnModule(Module &M) override;
44
getAnalysisUsage(AnalysisUsage & AU) const45 void getAnalysisUsage(AnalysisUsage &AU) const override {
46 AU.setPreservesCFG();
47 }
48
49 private:
50 InstrProfOptions Options;
51 Module *M;
52 typedef struct PerFunctionProfileData {
53 uint32_t NumValueSites[IPVK_Last+1];
54 GlobalVariable* RegionCounters;
55 GlobalVariable* DataVar;
PerFunctionProfileData__anond5e06e8d0111::InstrProfiling::PerFunctionProfileData56 PerFunctionProfileData() : RegionCounters(nullptr), DataVar(nullptr) {
57 memset(NumValueSites, 0, sizeof(uint32_t) * (IPVK_Last+1));
58 }
59 } PerFunctionProfileData;
60 DenseMap<GlobalVariable *, PerFunctionProfileData> ProfileDataMap;
61 std::vector<Value *> UsedVars;
62
isMachO() const63 bool isMachO() const {
64 return Triple(M->getTargetTriple()).isOSBinFormatMachO();
65 }
66
67 /// Get the section name for the counter variables.
getCountersSection() const68 StringRef getCountersSection() const {
69 return getInstrProfCountersSectionName(isMachO());
70 }
71
72 /// Get the section name for the name variables.
getNameSection() const73 StringRef getNameSection() const {
74 return getInstrProfNameSectionName(isMachO());
75 }
76
77 /// Get the section name for the profile data variables.
getDataSection() const78 StringRef getDataSection() const {
79 return getInstrProfDataSectionName(isMachO());
80 }
81
82 /// Get the section name for the coverage mapping data.
getCoverageSection() const83 StringRef getCoverageSection() const {
84 return getInstrProfCoverageSectionName(isMachO());
85 }
86
87 /// Count the number of instrumented value sites for the function.
88 void computeNumValueSiteCounts(InstrProfValueProfileInst *Ins);
89
90 /// Replace instrprof_value_profile with a call to runtime library.
91 void lowerValueProfileInst(InstrProfValueProfileInst *Ins);
92
93 /// Replace instrprof_increment with an increment of the appropriate value.
94 void lowerIncrement(InstrProfIncrementInst *Inc);
95
96 /// Set up the section and uses for coverage data and its references.
97 void lowerCoverageData(GlobalVariable *CoverageData);
98
99 /// Get the region counters for an increment, creating them if necessary.
100 ///
101 /// If the counter array doesn't yet exist, the profile data variables
102 /// referring to them will also be created.
103 GlobalVariable *getOrCreateRegionCounters(InstrProfIncrementInst *Inc);
104
105 /// Emit runtime registration functions for each profile data variable.
106 void emitRegistration();
107
108 /// Emit the necessary plumbing to pull in the runtime initialization.
109 void emitRuntimeHook();
110
111 /// Add uses of our data variables and runtime hook.
112 void emitUses();
113
114 /// Create a static initializer for our data, on platforms that need it,
115 /// and for any profile output file that was specified.
116 void emitInitialization();
117 };
118
119 } // anonymous namespace
120
121 char InstrProfiling::ID = 0;
122 INITIALIZE_PASS(InstrProfiling, "instrprof",
123 "Frontend instrumentation-based coverage lowering.", false,
124 false)
125
createInstrProfilingPass(const InstrProfOptions & Options)126 ModulePass *llvm::createInstrProfilingPass(const InstrProfOptions &Options) {
127 return new InstrProfiling(Options);
128 }
129
runOnModule(Module & M)130 bool InstrProfiling::runOnModule(Module &M) {
131 bool MadeChange = false;
132
133 this->M = &M;
134 ProfileDataMap.clear();
135 UsedVars.clear();
136
137 // We did not know how many value sites there would be inside
138 // the instrumented function. This is counting the number of instrumented
139 // target value sites to enter it as field in the profile data variable.
140 for (Function &F : M)
141 for (BasicBlock &BB : F)
142 for (auto I = BB.begin(), E = BB.end(); I != E;)
143 if (auto *Ind = dyn_cast<InstrProfValueProfileInst>(I++))
144 computeNumValueSiteCounts(Ind);
145
146 for (Function &F : M)
147 for (BasicBlock &BB : F)
148 for (auto I = BB.begin(), E = BB.end(); I != E;) {
149 auto Instr = I++;
150 if (auto *Inc = dyn_cast<InstrProfIncrementInst>(Instr)) {
151 lowerIncrement(Inc);
152 MadeChange = true;
153 } else if (auto *Ind = dyn_cast<InstrProfValueProfileInst>(Instr)) {
154 lowerValueProfileInst(Ind);
155 MadeChange = true;
156 }
157 }
158
159 if (GlobalVariable *Coverage =
160 M.getNamedGlobal(getCoverageMappingVarName())) {
161 lowerCoverageData(Coverage);
162 MadeChange = true;
163 }
164
165 if (!MadeChange)
166 return false;
167
168 emitRegistration();
169 emitRuntimeHook();
170 emitUses();
171 emitInitialization();
172 return true;
173 }
174
getOrInsertValueProfilingCall(Module & M)175 static Constant *getOrInsertValueProfilingCall(Module &M) {
176 LLVMContext &Ctx = M.getContext();
177 auto *ReturnTy = Type::getVoidTy(M.getContext());
178 Type *ParamTypes[] = {
179 #define VALUE_PROF_FUNC_PARAM(ParamType, ParamName, ParamLLVMType) ParamLLVMType
180 #include "llvm/ProfileData/InstrProfData.inc"
181 };
182 auto *ValueProfilingCallTy =
183 FunctionType::get(ReturnTy, makeArrayRef(ParamTypes), false);
184 return M.getOrInsertFunction(getInstrProfValueProfFuncName(),
185 ValueProfilingCallTy);
186 }
187
computeNumValueSiteCounts(InstrProfValueProfileInst * Ind)188 void InstrProfiling::computeNumValueSiteCounts(InstrProfValueProfileInst *Ind) {
189
190 GlobalVariable *Name = Ind->getName();
191 uint64_t ValueKind = Ind->getValueKind()->getZExtValue();
192 uint64_t Index = Ind->getIndex()->getZExtValue();
193 auto It = ProfileDataMap.find(Name);
194 if (It == ProfileDataMap.end()) {
195 PerFunctionProfileData PD;
196 PD.NumValueSites[ValueKind] = Index + 1;
197 ProfileDataMap[Name] = PD;
198 } else if (It->second.NumValueSites[ValueKind] <= Index)
199 It->second.NumValueSites[ValueKind] = Index + 1;
200 }
201
lowerValueProfileInst(InstrProfValueProfileInst * Ind)202 void InstrProfiling::lowerValueProfileInst(InstrProfValueProfileInst *Ind) {
203
204 GlobalVariable *Name = Ind->getName();
205 auto It = ProfileDataMap.find(Name);
206 assert(It != ProfileDataMap.end() && It->second.DataVar &&
207 "value profiling detected in function with no counter incerement");
208
209 GlobalVariable *DataVar = It->second.DataVar;
210 uint64_t ValueKind = Ind->getValueKind()->getZExtValue();
211 uint64_t Index = Ind->getIndex()->getZExtValue();
212 for (uint32_t Kind = IPVK_First; Kind < ValueKind; ++Kind)
213 Index += It->second.NumValueSites[Kind];
214
215 IRBuilder<> Builder(Ind);
216 Value* Args[3] = {Ind->getTargetValue(),
217 Builder.CreateBitCast(DataVar, Builder.getInt8PtrTy()),
218 Builder.getInt32(Index)};
219 Ind->replaceAllUsesWith(
220 Builder.CreateCall(getOrInsertValueProfilingCall(*M), Args));
221 Ind->eraseFromParent();
222 }
223
lowerIncrement(InstrProfIncrementInst * Inc)224 void InstrProfiling::lowerIncrement(InstrProfIncrementInst *Inc) {
225 GlobalVariable *Counters = getOrCreateRegionCounters(Inc);
226
227 IRBuilder<> Builder(Inc);
228 uint64_t Index = Inc->getIndex()->getZExtValue();
229 Value *Addr = Builder.CreateConstInBoundsGEP2_64(Counters, 0, Index);
230 Value *Count = Builder.CreateLoad(Addr, "pgocount");
231 Count = Builder.CreateAdd(Count, Builder.getInt64(1));
232 Inc->replaceAllUsesWith(Builder.CreateStore(Count, Addr));
233 Inc->eraseFromParent();
234 }
235
lowerCoverageData(GlobalVariable * CoverageData)236 void InstrProfiling::lowerCoverageData(GlobalVariable *CoverageData) {
237 CoverageData->setSection(getCoverageSection());
238 CoverageData->setAlignment(8);
239
240 Constant *Init = CoverageData->getInitializer();
241 // We're expecting { i32, i32, i32, i32, [n x { i8*, i32, i32 }], [m x i8] }
242 // for some C. If not, the frontend's given us something broken.
243 assert(Init->getNumOperands() == 6 && "bad number of fields in coverage map");
244 assert(isa<ConstantArray>(Init->getAggregateElement(4)) &&
245 "invalid function list in coverage map");
246 ConstantArray *Records = cast<ConstantArray>(Init->getAggregateElement(4));
247 for (unsigned I = 0, E = Records->getNumOperands(); I < E; ++I) {
248 Constant *Record = Records->getOperand(I);
249 Value *V = const_cast<Value *>(Record->getOperand(0))->stripPointerCasts();
250
251 assert(isa<GlobalVariable>(V) && "Missing reference to function name");
252 GlobalVariable *Name = cast<GlobalVariable>(V);
253
254 // If we have region counters for this name, we've already handled it.
255 auto It = ProfileDataMap.find(Name);
256 if (It != ProfileDataMap.end())
257 if (It->second.RegionCounters)
258 continue;
259
260 // Move the name variable to the right section.
261 Name->setSection(getNameSection());
262 Name->setAlignment(1);
263 }
264 }
265
266 /// Get the name of a profiling variable for a particular function.
getVarName(InstrProfIncrementInst * Inc,StringRef Prefix)267 static std::string getVarName(InstrProfIncrementInst *Inc, StringRef Prefix) {
268 StringRef NamePrefix = getInstrProfNameVarPrefix();
269 StringRef Name = Inc->getName()->getName().substr(NamePrefix.size());
270 return (Prefix + Name).str();
271 }
272
shouldRecordFunctionAddr(Function * F)273 static inline bool shouldRecordFunctionAddr(Function *F) {
274 // Check the linkage
275 if (!F->hasLinkOnceLinkage() && !F->hasLocalLinkage() &&
276 !F->hasAvailableExternallyLinkage())
277 return true;
278 // Check uses of this function for other than direct calls or invokes to it.
279 return F->hasAddressTaken();
280 }
281
getOrCreateProfileComdat(Module & M,InstrProfIncrementInst * Inc)282 static inline Comdat *getOrCreateProfileComdat(Module &M,
283 InstrProfIncrementInst *Inc) {
284 // COFF format requires a COMDAT section to have a key symbol with the same
285 // name. The linker targeting COFF also requires that the COMDAT section
286 // a section is associated to must precede the associating section. For this
287 // reason, we must choose the name var's name as the name of the comdat.
288 StringRef ComdatPrefix = (Triple(M.getTargetTriple()).isOSBinFormatCOFF()
289 ? getInstrProfNameVarPrefix()
290 : getInstrProfComdatPrefix());
291 return M.getOrInsertComdat(StringRef(getVarName(Inc, ComdatPrefix)));
292 }
293
294 GlobalVariable *
getOrCreateRegionCounters(InstrProfIncrementInst * Inc)295 InstrProfiling::getOrCreateRegionCounters(InstrProfIncrementInst *Inc) {
296 GlobalVariable *NamePtr = Inc->getName();
297 auto It = ProfileDataMap.find(NamePtr);
298 PerFunctionProfileData PD;
299 if (It != ProfileDataMap.end()) {
300 if (It->second.RegionCounters)
301 return It->second.RegionCounters;
302 PD = It->second;
303 }
304
305 // Move the name variable to the right section. Place them in a COMDAT group
306 // if the associated function is a COMDAT. This will make sure that
307 // only one copy of counters of the COMDAT function will be emitted after
308 // linking.
309 Function *Fn = Inc->getParent()->getParent();
310 Comdat *ProfileVarsComdat = nullptr;
311 if (Fn->hasComdat())
312 ProfileVarsComdat = getOrCreateProfileComdat(*M, Inc);
313 NamePtr->setSection(getNameSection());
314 NamePtr->setAlignment(1);
315 NamePtr->setComdat(ProfileVarsComdat);
316
317 uint64_t NumCounters = Inc->getNumCounters()->getZExtValue();
318 LLVMContext &Ctx = M->getContext();
319 ArrayType *CounterTy = ArrayType::get(Type::getInt64Ty(Ctx), NumCounters);
320
321 // Create the counters variable.
322 auto *CounterPtr =
323 new GlobalVariable(*M, CounterTy, false, NamePtr->getLinkage(),
324 Constant::getNullValue(CounterTy),
325 getVarName(Inc, getInstrProfCountersVarPrefix()));
326 CounterPtr->setVisibility(NamePtr->getVisibility());
327 CounterPtr->setSection(getCountersSection());
328 CounterPtr->setAlignment(8);
329 CounterPtr->setComdat(ProfileVarsComdat);
330
331 // Create data variable.
332 auto *Int8PtrTy = Type::getInt8PtrTy(Ctx);
333 auto *Int16Ty = Type::getInt16Ty(Ctx);
334 auto *Int16ArrayTy = ArrayType::get(Int16Ty, IPVK_Last+1);
335 Type *DataTypes[] = {
336 #define INSTR_PROF_DATA(Type, LLVMType, Name, Init) LLVMType,
337 #include "llvm/ProfileData/InstrProfData.inc"
338 };
339 auto *DataTy = StructType::get(Ctx, makeArrayRef(DataTypes));
340
341 Constant *FunctionAddr = shouldRecordFunctionAddr(Fn) ?
342 ConstantExpr::getBitCast(Fn, Int8PtrTy) :
343 ConstantPointerNull::get(Int8PtrTy);
344
345 Constant *Int16ArrayVals[IPVK_Last+1];
346 for (uint32_t Kind = IPVK_First; Kind <= IPVK_Last; ++Kind)
347 Int16ArrayVals[Kind] = ConstantInt::get(Int16Ty, PD.NumValueSites[Kind]);
348
349 Constant *DataVals[] = {
350 #define INSTR_PROF_DATA(Type, LLVMType, Name, Init) Init,
351 #include "llvm/ProfileData/InstrProfData.inc"
352 };
353 auto *Data = new GlobalVariable(*M, DataTy, false, NamePtr->getLinkage(),
354 ConstantStruct::get(DataTy, DataVals),
355 getVarName(Inc, getInstrProfDataVarPrefix()));
356 Data->setVisibility(NamePtr->getVisibility());
357 Data->setSection(getDataSection());
358 Data->setAlignment(INSTR_PROF_DATA_ALIGNMENT);
359 Data->setComdat(ProfileVarsComdat);
360
361 PD.RegionCounters = CounterPtr;
362 PD.DataVar = Data;
363 ProfileDataMap[NamePtr] = PD;
364
365 // Mark the data variable as used so that it isn't stripped out.
366 UsedVars.push_back(Data);
367
368 return CounterPtr;
369 }
370
emitRegistration()371 void InstrProfiling::emitRegistration() {
372 // Don't do this for Darwin. compiler-rt uses linker magic.
373 if (Triple(M->getTargetTriple()).isOSDarwin())
374 return;
375
376 // Use linker script magic to get data/cnts/name start/end.
377 if (Triple(M->getTargetTriple()).isOSLinux() ||
378 Triple(M->getTargetTriple()).isOSFreeBSD())
379 return;
380
381 // Construct the function.
382 auto *VoidTy = Type::getVoidTy(M->getContext());
383 auto *VoidPtrTy = Type::getInt8PtrTy(M->getContext());
384 auto *RegisterFTy = FunctionType::get(VoidTy, false);
385 auto *RegisterF = Function::Create(RegisterFTy, GlobalValue::InternalLinkage,
386 getInstrProfRegFuncsName(), M);
387 RegisterF->setUnnamedAddr(true);
388 if (Options.NoRedZone) RegisterF->addFnAttr(Attribute::NoRedZone);
389
390 auto *RuntimeRegisterTy = FunctionType::get(VoidTy, VoidPtrTy, false);
391 auto *RuntimeRegisterF =
392 Function::Create(RuntimeRegisterTy, GlobalVariable::ExternalLinkage,
393 getInstrProfRegFuncName(), M);
394
395 IRBuilder<> IRB(BasicBlock::Create(M->getContext(), "", RegisterF));
396 for (Value *Data : UsedVars)
397 IRB.CreateCall(RuntimeRegisterF, IRB.CreateBitCast(Data, VoidPtrTy));
398 IRB.CreateRetVoid();
399 }
400
emitRuntimeHook()401 void InstrProfiling::emitRuntimeHook() {
402
403 // We expect the linker to be invoked with -u<hook_var> flag for linux,
404 // for which case there is no need to emit the user function.
405 if (Triple(M->getTargetTriple()).isOSLinux())
406 return;
407
408 // If the module's provided its own runtime, we don't need to do anything.
409 if (M->getGlobalVariable(getInstrProfRuntimeHookVarName())) return;
410
411 // Declare an external variable that will pull in the runtime initialization.
412 auto *Int32Ty = Type::getInt32Ty(M->getContext());
413 auto *Var =
414 new GlobalVariable(*M, Int32Ty, false, GlobalValue::ExternalLinkage,
415 nullptr, getInstrProfRuntimeHookVarName());
416
417 // Make a function that uses it.
418 auto *User = Function::Create(FunctionType::get(Int32Ty, false),
419 GlobalValue::LinkOnceODRLinkage,
420 getInstrProfRuntimeHookVarUseFuncName(), M);
421 User->addFnAttr(Attribute::NoInline);
422 if (Options.NoRedZone) User->addFnAttr(Attribute::NoRedZone);
423 User->setVisibility(GlobalValue::HiddenVisibility);
424
425 IRBuilder<> IRB(BasicBlock::Create(M->getContext(), "", User));
426 auto *Load = IRB.CreateLoad(Var);
427 IRB.CreateRet(Load);
428
429 // Mark the user variable as used so that it isn't stripped out.
430 UsedVars.push_back(User);
431 }
432
emitUses()433 void InstrProfiling::emitUses() {
434 if (UsedVars.empty())
435 return;
436
437 GlobalVariable *LLVMUsed = M->getGlobalVariable("llvm.used");
438 std::vector<Constant *> MergedVars;
439 if (LLVMUsed) {
440 // Collect the existing members of llvm.used.
441 ConstantArray *Inits = cast<ConstantArray>(LLVMUsed->getInitializer());
442 for (unsigned I = 0, E = Inits->getNumOperands(); I != E; ++I)
443 MergedVars.push_back(Inits->getOperand(I));
444 LLVMUsed->eraseFromParent();
445 }
446
447 Type *i8PTy = Type::getInt8PtrTy(M->getContext());
448 // Add uses for our data.
449 for (auto *Value : UsedVars)
450 MergedVars.push_back(
451 ConstantExpr::getBitCast(cast<Constant>(Value), i8PTy));
452
453 // Recreate llvm.used.
454 ArrayType *ATy = ArrayType::get(i8PTy, MergedVars.size());
455 LLVMUsed =
456 new GlobalVariable(*M, ATy, false, GlobalValue::AppendingLinkage,
457 ConstantArray::get(ATy, MergedVars), "llvm.used");
458 LLVMUsed->setSection("llvm.metadata");
459 }
460
emitInitialization()461 void InstrProfiling::emitInitialization() {
462 std::string InstrProfileOutput = Options.InstrProfileOutput;
463
464 Constant *RegisterF = M->getFunction(getInstrProfRegFuncsName());
465 if (!RegisterF && InstrProfileOutput.empty()) return;
466
467 // Create the initialization function.
468 auto *VoidTy = Type::getVoidTy(M->getContext());
469 auto *F = Function::Create(FunctionType::get(VoidTy, false),
470 GlobalValue::InternalLinkage,
471 getInstrProfInitFuncName(), M);
472 F->setUnnamedAddr(true);
473 F->addFnAttr(Attribute::NoInline);
474 if (Options.NoRedZone) F->addFnAttr(Attribute::NoRedZone);
475
476 // Add the basic block and the necessary calls.
477 IRBuilder<> IRB(BasicBlock::Create(M->getContext(), "", F));
478 if (RegisterF)
479 IRB.CreateCall(RegisterF, {});
480 if (!InstrProfileOutput.empty()) {
481 auto *Int8PtrTy = Type::getInt8PtrTy(M->getContext());
482 auto *SetNameTy = FunctionType::get(VoidTy, Int8PtrTy, false);
483 auto *SetNameF = Function::Create(SetNameTy, GlobalValue::ExternalLinkage,
484 getInstrProfFileOverriderFuncName(), M);
485
486 // Create variable for profile name.
487 Constant *ProfileNameConst =
488 ConstantDataArray::getString(M->getContext(), InstrProfileOutput, true);
489 GlobalVariable *ProfileName =
490 new GlobalVariable(*M, ProfileNameConst->getType(), true,
491 GlobalValue::PrivateLinkage, ProfileNameConst);
492
493 IRB.CreateCall(SetNameF, IRB.CreatePointerCast(ProfileName, Int8PtrTy));
494 }
495 IRB.CreateRetVoid();
496
497 appendToGlobalCtors(*M, F, 0);
498 }
499