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/Transforms/Instrumentation/InstrProfiling.h"
17 #include "llvm/ADT/ArrayRef.h"
18 #include "llvm/ADT/SmallVector.h"
19 #include "llvm/ADT/StringRef.h"
20 #include "llvm/ADT/Triple.h"
21 #include "llvm/ADT/Twine.h"
22 #include "llvm/Analysis/LoopInfo.h"
23 #include "llvm/Analysis/TargetLibraryInfo.h"
24 #include "llvm/IR/Attributes.h"
25 #include "llvm/IR/BasicBlock.h"
26 #include "llvm/IR/Constant.h"
27 #include "llvm/IR/Constants.h"
28 #include "llvm/IR/DerivedTypes.h"
29 #include "llvm/IR/Dominators.h"
30 #include "llvm/IR/Function.h"
31 #include "llvm/IR/GlobalValue.h"
32 #include "llvm/IR/GlobalVariable.h"
33 #include "llvm/IR/IRBuilder.h"
34 #include "llvm/IR/Instruction.h"
35 #include "llvm/IR/Instructions.h"
36 #include "llvm/IR/IntrinsicInst.h"
37 #include "llvm/IR/Module.h"
38 #include "llvm/IR/Type.h"
39 #include "llvm/Pass.h"
40 #include "llvm/ProfileData/InstrProf.h"
41 #include "llvm/Support/Casting.h"
42 #include "llvm/Support/CommandLine.h"
43 #include "llvm/Support/Error.h"
44 #include "llvm/Support/ErrorHandling.h"
45 #include "llvm/Transforms/Utils/BasicBlockUtils.h"
46 #include "llvm/Transforms/Utils/ModuleUtils.h"
47 #include "llvm/Transforms/Utils/SSAUpdater.h"
48 #include <algorithm>
49 #include <cassert>
50 #include <cstddef>
51 #include <cstdint>
52 #include <string>
53 
54 using namespace llvm;
55 
56 #define DEBUG_TYPE "instrprof"
57 
58 // The start and end values of precise value profile range for memory
59 // intrinsic sizes
60 cl::opt<std::string> MemOPSizeRange(
61     "memop-size-range",
62     cl::desc("Set the range of size in memory intrinsic calls to be profiled "
63              "precisely, in a format of <start_val>:<end_val>"),
64     cl::init(""));
65 
66 // The value that considered to be large value in  memory intrinsic.
67 cl::opt<unsigned> MemOPSizeLarge(
68     "memop-size-large",
69     cl::desc("Set large value thresthold in memory intrinsic size profiling. "
70              "Value of 0 disables the large value profiling."),
71     cl::init(8192));
72 
73 namespace {
74 
75 cl::opt<bool> DoNameCompression("enable-name-compression",
76                                 cl::desc("Enable name string compression"),
77                                 cl::init(true));
78 
79 cl::opt<bool> DoHashBasedCounterSplit(
80     "hash-based-counter-split",
81     cl::desc("Rename counter variable of a comdat function based on cfg hash"),
82     cl::init(true));
83 
84 cl::opt<bool> ValueProfileStaticAlloc(
85     "vp-static-alloc",
86     cl::desc("Do static counter allocation for value profiler"),
87     cl::init(true));
88 
89 cl::opt<double> NumCountersPerValueSite(
90     "vp-counters-per-site",
91     cl::desc("The average number of profile counters allocated "
92              "per value profiling site."),
93     // This is set to a very small value because in real programs, only
94     // a very small percentage of value sites have non-zero targets, e.g, 1/30.
95     // For those sites with non-zero profile, the average number of targets
96     // is usually smaller than 2.
97     cl::init(1.0));
98 
99 cl::opt<bool> AtomicCounterUpdateAll(
100     "instrprof-atomic-counter-update-all", cl::ZeroOrMore,
101     cl::desc("Make all profile counter updates atomic (for testing only)"),
102     cl::init(false));
103 
104 cl::opt<bool> AtomicCounterUpdatePromoted(
105     "atomic-counter-update-promoted", cl::ZeroOrMore,
106     cl::desc("Do counter update using atomic fetch add "
107              " for promoted counters only"),
108     cl::init(false));
109 
110 // If the option is not specified, the default behavior about whether
111 // counter promotion is done depends on how instrumentaiton lowering
112 // pipeline is setup, i.e., the default value of true of this option
113 // does not mean the promotion will be done by default. Explicitly
114 // setting this option can override the default behavior.
115 cl::opt<bool> DoCounterPromotion("do-counter-promotion", cl::ZeroOrMore,
116                                  cl::desc("Do counter register promotion"),
117                                  cl::init(false));
118 cl::opt<unsigned> MaxNumOfPromotionsPerLoop(
119     cl::ZeroOrMore, "max-counter-promotions-per-loop", cl::init(20),
120     cl::desc("Max number counter promotions per loop to avoid"
121              " increasing register pressure too much"));
122 
123 // A debug option
124 cl::opt<int>
125     MaxNumOfPromotions(cl::ZeroOrMore, "max-counter-promotions", cl::init(-1),
126                        cl::desc("Max number of allowed counter promotions"));
127 
128 cl::opt<unsigned> SpeculativeCounterPromotionMaxExiting(
129     cl::ZeroOrMore, "speculative-counter-promotion-max-exiting", cl::init(3),
130     cl::desc("The max number of exiting blocks of a loop to allow "
131              " speculative counter promotion"));
132 
133 cl::opt<bool> SpeculativeCounterPromotionToLoop(
134     cl::ZeroOrMore, "speculative-counter-promotion-to-loop", cl::init(false),
135     cl::desc("When the option is false, if the target block is in a loop, "
136              "the promotion will be disallowed unless the promoted counter "
137              " update can be further/iteratively promoted into an acyclic "
138              " region."));
139 
140 cl::opt<bool> IterativeCounterPromotion(
141     cl::ZeroOrMore, "iterative-counter-promotion", cl::init(true),
142     cl::desc("Allow counter promotion across the whole loop nest."));
143 
144 class InstrProfilingLegacyPass : public ModulePass {
145   InstrProfiling InstrProf;
146 
147 public:
148   static char ID;
149 
InstrProfilingLegacyPass()150   InstrProfilingLegacyPass() : ModulePass(ID) {}
InstrProfilingLegacyPass(const InstrProfOptions & Options)151   InstrProfilingLegacyPass(const InstrProfOptions &Options)
152       : ModulePass(ID), InstrProf(Options) {}
153 
getPassName() const154   StringRef getPassName() const override {
155     return "Frontend instrumentation-based coverage lowering";
156   }
157 
runOnModule(Module & M)158   bool runOnModule(Module &M) override {
159     return InstrProf.run(M, getAnalysis<TargetLibraryInfoWrapperPass>().getTLI());
160   }
161 
getAnalysisUsage(AnalysisUsage & AU) const162   void getAnalysisUsage(AnalysisUsage &AU) const override {
163     AU.setPreservesCFG();
164     AU.addRequired<TargetLibraryInfoWrapperPass>();
165   }
166 };
167 
168 ///
169 /// A helper class to promote one counter RMW operation in the loop
170 /// into register update.
171 ///
172 /// RWM update for the counter will be sinked out of the loop after
173 /// the transformation.
174 ///
175 class PGOCounterPromoterHelper : public LoadAndStorePromoter {
176 public:
PGOCounterPromoterHelper(Instruction * L,Instruction * S,SSAUpdater & SSA,Value * Init,BasicBlock * PH,ArrayRef<BasicBlock * > ExitBlocks,ArrayRef<Instruction * > InsertPts,DenseMap<Loop *,SmallVector<LoadStorePair,8>> & LoopToCands,LoopInfo & LI)177   PGOCounterPromoterHelper(
178       Instruction *L, Instruction *S, SSAUpdater &SSA, Value *Init,
179       BasicBlock *PH, ArrayRef<BasicBlock *> ExitBlocks,
180       ArrayRef<Instruction *> InsertPts,
181       DenseMap<Loop *, SmallVector<LoadStorePair, 8>> &LoopToCands,
182       LoopInfo &LI)
183       : LoadAndStorePromoter({L, S}, SSA), Store(S), ExitBlocks(ExitBlocks),
184         InsertPts(InsertPts), LoopToCandidates(LoopToCands), LI(LI) {
185     assert(isa<LoadInst>(L));
186     assert(isa<StoreInst>(S));
187     SSA.AddAvailableValue(PH, Init);
188   }
189 
doExtraRewritesBeforeFinalDeletion() const190   void doExtraRewritesBeforeFinalDeletion() const override {
191     for (unsigned i = 0, e = ExitBlocks.size(); i != e; ++i) {
192       BasicBlock *ExitBlock = ExitBlocks[i];
193       Instruction *InsertPos = InsertPts[i];
194       // Get LiveIn value into the ExitBlock. If there are multiple
195       // predecessors, the value is defined by a PHI node in this
196       // block.
197       Value *LiveInValue = SSA.GetValueInMiddleOfBlock(ExitBlock);
198       Value *Addr = cast<StoreInst>(Store)->getPointerOperand();
199       IRBuilder<> Builder(InsertPos);
200       if (AtomicCounterUpdatePromoted)
201         // automic update currently can only be promoted across the current
202         // loop, not the whole loop nest.
203         Builder.CreateAtomicRMW(AtomicRMWInst::Add, Addr, LiveInValue,
204                                 AtomicOrdering::SequentiallyConsistent);
205       else {
206         LoadInst *OldVal = Builder.CreateLoad(Addr, "pgocount.promoted");
207         auto *NewVal = Builder.CreateAdd(OldVal, LiveInValue);
208         auto *NewStore = Builder.CreateStore(NewVal, Addr);
209 
210         // Now update the parent loop's candidate list:
211         if (IterativeCounterPromotion) {
212           auto *TargetLoop = LI.getLoopFor(ExitBlock);
213           if (TargetLoop)
214             LoopToCandidates[TargetLoop].emplace_back(OldVal, NewStore);
215         }
216       }
217     }
218   }
219 
220 private:
221   Instruction *Store;
222   ArrayRef<BasicBlock *> ExitBlocks;
223   ArrayRef<Instruction *> InsertPts;
224   DenseMap<Loop *, SmallVector<LoadStorePair, 8>> &LoopToCandidates;
225   LoopInfo &LI;
226 };
227 
228 /// A helper class to do register promotion for all profile counter
229 /// updates in a loop.
230 ///
231 class PGOCounterPromoter {
232 public:
PGOCounterPromoter(DenseMap<Loop *,SmallVector<LoadStorePair,8>> & LoopToCands,Loop & CurLoop,LoopInfo & LI)233   PGOCounterPromoter(
234       DenseMap<Loop *, SmallVector<LoadStorePair, 8>> &LoopToCands,
235       Loop &CurLoop, LoopInfo &LI)
236       : LoopToCandidates(LoopToCands), ExitBlocks(), InsertPts(), L(CurLoop),
237         LI(LI) {
238 
239     SmallVector<BasicBlock *, 8> LoopExitBlocks;
240     SmallPtrSet<BasicBlock *, 8> BlockSet;
241     L.getExitBlocks(LoopExitBlocks);
242 
243     for (BasicBlock *ExitBlock : LoopExitBlocks) {
244       if (BlockSet.insert(ExitBlock).second) {
245         ExitBlocks.push_back(ExitBlock);
246         InsertPts.push_back(&*ExitBlock->getFirstInsertionPt());
247       }
248     }
249   }
250 
run(int64_t * NumPromoted)251   bool run(int64_t *NumPromoted) {
252     // Skip 'infinite' loops:
253     if (ExitBlocks.size() == 0)
254       return false;
255     unsigned MaxProm = getMaxNumOfPromotionsInLoop(&L);
256     if (MaxProm == 0)
257       return false;
258 
259     unsigned Promoted = 0;
260     for (auto &Cand : LoopToCandidates[&L]) {
261 
262       SmallVector<PHINode *, 4> NewPHIs;
263       SSAUpdater SSA(&NewPHIs);
264       Value *InitVal = ConstantInt::get(Cand.first->getType(), 0);
265 
266       PGOCounterPromoterHelper Promoter(Cand.first, Cand.second, SSA, InitVal,
267                                         L.getLoopPreheader(), ExitBlocks,
268                                         InsertPts, LoopToCandidates, LI);
269       Promoter.run(SmallVector<Instruction *, 2>({Cand.first, Cand.second}));
270       Promoted++;
271       if (Promoted >= MaxProm)
272         break;
273 
274       (*NumPromoted)++;
275       if (MaxNumOfPromotions != -1 && *NumPromoted >= MaxNumOfPromotions)
276         break;
277     }
278 
279     LLVM_DEBUG(dbgs() << Promoted << " counters promoted for loop (depth="
280                       << L.getLoopDepth() << ")\n");
281     return Promoted != 0;
282   }
283 
284 private:
allowSpeculativeCounterPromotion(Loop * LP)285   bool allowSpeculativeCounterPromotion(Loop *LP) {
286     SmallVector<BasicBlock *, 8> ExitingBlocks;
287     L.getExitingBlocks(ExitingBlocks);
288     // Not considierered speculative.
289     if (ExitingBlocks.size() == 1)
290       return true;
291     if (ExitingBlocks.size() > SpeculativeCounterPromotionMaxExiting)
292       return false;
293     return true;
294   }
295 
296   // Returns the max number of Counter Promotions for LP.
getMaxNumOfPromotionsInLoop(Loop * LP)297   unsigned getMaxNumOfPromotionsInLoop(Loop *LP) {
298     // We can't insert into a catchswitch.
299     SmallVector<BasicBlock *, 8> LoopExitBlocks;
300     LP->getExitBlocks(LoopExitBlocks);
301     if (llvm::any_of(LoopExitBlocks, [](BasicBlock *Exit) {
302           return isa<CatchSwitchInst>(Exit->getTerminator());
303         }))
304       return 0;
305 
306     if (!LP->hasDedicatedExits())
307       return 0;
308 
309     BasicBlock *PH = LP->getLoopPreheader();
310     if (!PH)
311       return 0;
312 
313     SmallVector<BasicBlock *, 8> ExitingBlocks;
314     LP->getExitingBlocks(ExitingBlocks);
315     // Not considierered speculative.
316     if (ExitingBlocks.size() == 1)
317       return MaxNumOfPromotionsPerLoop;
318 
319     if (ExitingBlocks.size() > SpeculativeCounterPromotionMaxExiting)
320       return 0;
321 
322     // Whether the target block is in a loop does not matter:
323     if (SpeculativeCounterPromotionToLoop)
324       return MaxNumOfPromotionsPerLoop;
325 
326     // Now check the target block:
327     unsigned MaxProm = MaxNumOfPromotionsPerLoop;
328     for (auto *TargetBlock : LoopExitBlocks) {
329       auto *TargetLoop = LI.getLoopFor(TargetBlock);
330       if (!TargetLoop)
331         continue;
332       unsigned MaxPromForTarget = getMaxNumOfPromotionsInLoop(TargetLoop);
333       unsigned PendingCandsInTarget = LoopToCandidates[TargetLoop].size();
334       MaxProm =
335           std::min(MaxProm, std::max(MaxPromForTarget, PendingCandsInTarget) -
336                                 PendingCandsInTarget);
337     }
338     return MaxProm;
339   }
340 
341   DenseMap<Loop *, SmallVector<LoadStorePair, 8>> &LoopToCandidates;
342   SmallVector<BasicBlock *, 8> ExitBlocks;
343   SmallVector<Instruction *, 8> InsertPts;
344   Loop &L;
345   LoopInfo &LI;
346 };
347 
348 } // end anonymous namespace
349 
run(Module & M,ModuleAnalysisManager & AM)350 PreservedAnalyses InstrProfiling::run(Module &M, ModuleAnalysisManager &AM) {
351   auto &TLI = AM.getResult<TargetLibraryAnalysis>(M);
352   if (!run(M, TLI))
353     return PreservedAnalyses::all();
354 
355   return PreservedAnalyses::none();
356 }
357 
358 char InstrProfilingLegacyPass::ID = 0;
359 INITIALIZE_PASS_BEGIN(
360     InstrProfilingLegacyPass, "instrprof",
361     "Frontend instrumentation-based coverage lowering.", false, false)
INITIALIZE_PASS_DEPENDENCY(TargetLibraryInfoWrapperPass)362 INITIALIZE_PASS_DEPENDENCY(TargetLibraryInfoWrapperPass)
363 INITIALIZE_PASS_END(
364     InstrProfilingLegacyPass, "instrprof",
365     "Frontend instrumentation-based coverage lowering.", false, false)
366 
367 ModulePass *
368 llvm::createInstrProfilingLegacyPass(const InstrProfOptions &Options) {
369   return new InstrProfilingLegacyPass(Options);
370 }
371 
castToIncrementInst(Instruction * Instr)372 static InstrProfIncrementInst *castToIncrementInst(Instruction *Instr) {
373   InstrProfIncrementInst *Inc = dyn_cast<InstrProfIncrementInstStep>(Instr);
374   if (Inc)
375     return Inc;
376   return dyn_cast<InstrProfIncrementInst>(Instr);
377 }
378 
lowerIntrinsics(Function * F)379 bool InstrProfiling::lowerIntrinsics(Function *F) {
380   bool MadeChange = false;
381   PromotionCandidates.clear();
382   for (BasicBlock &BB : *F) {
383     for (auto I = BB.begin(), E = BB.end(); I != E;) {
384       auto Instr = I++;
385       InstrProfIncrementInst *Inc = castToIncrementInst(&*Instr);
386       if (Inc) {
387         lowerIncrement(Inc);
388         MadeChange = true;
389       } else if (auto *Ind = dyn_cast<InstrProfValueProfileInst>(Instr)) {
390         lowerValueProfileInst(Ind);
391         MadeChange = true;
392       }
393     }
394   }
395 
396   if (!MadeChange)
397     return false;
398 
399   promoteCounterLoadStores(F);
400   return true;
401 }
402 
isCounterPromotionEnabled() const403 bool InstrProfiling::isCounterPromotionEnabled() const {
404   if (DoCounterPromotion.getNumOccurrences() > 0)
405     return DoCounterPromotion;
406 
407   return Options.DoCounterPromotion;
408 }
409 
promoteCounterLoadStores(Function * F)410 void InstrProfiling::promoteCounterLoadStores(Function *F) {
411   if (!isCounterPromotionEnabled())
412     return;
413 
414   DominatorTree DT(*F);
415   LoopInfo LI(DT);
416   DenseMap<Loop *, SmallVector<LoadStorePair, 8>> LoopPromotionCandidates;
417 
418   for (const auto &LoadStore : PromotionCandidates) {
419     auto *CounterLoad = LoadStore.first;
420     auto *CounterStore = LoadStore.second;
421     BasicBlock *BB = CounterLoad->getParent();
422     Loop *ParentLoop = LI.getLoopFor(BB);
423     if (!ParentLoop)
424       continue;
425     LoopPromotionCandidates[ParentLoop].emplace_back(CounterLoad, CounterStore);
426   }
427 
428   SmallVector<Loop *, 4> Loops = LI.getLoopsInPreorder();
429 
430   // Do a post-order traversal of the loops so that counter updates can be
431   // iteratively hoisted outside the loop nest.
432   for (auto *Loop : llvm::reverse(Loops)) {
433     PGOCounterPromoter Promoter(LoopPromotionCandidates, *Loop, LI);
434     Promoter.run(&TotalCountersPromoted);
435   }
436 }
437 
438 /// Check if the module contains uses of any profiling intrinsics.
containsProfilingIntrinsics(Module & M)439 static bool containsProfilingIntrinsics(Module &M) {
440   if (auto *F = M.getFunction(
441           Intrinsic::getName(llvm::Intrinsic::instrprof_increment)))
442     if (!F->use_empty())
443       return true;
444   if (auto *F = M.getFunction(
445           Intrinsic::getName(llvm::Intrinsic::instrprof_increment_step)))
446     if (!F->use_empty())
447       return true;
448   if (auto *F = M.getFunction(
449           Intrinsic::getName(llvm::Intrinsic::instrprof_value_profile)))
450     if (!F->use_empty())
451       return true;
452   return false;
453 }
454 
run(Module & M,const TargetLibraryInfo & TLI)455 bool InstrProfiling::run(Module &M, const TargetLibraryInfo &TLI) {
456   this->M = &M;
457   this->TLI = &TLI;
458   NamesVar = nullptr;
459   NamesSize = 0;
460   ProfileDataMap.clear();
461   UsedVars.clear();
462   getMemOPSizeRangeFromOption(MemOPSizeRange, MemOPSizeRangeStart,
463                               MemOPSizeRangeLast);
464   TT = Triple(M.getTargetTriple());
465 
466   // Emit the runtime hook even if no counters are present.
467   bool MadeChange = emitRuntimeHook();
468 
469   // Improve compile time by avoiding linear scans when there is no work.
470   GlobalVariable *CoverageNamesVar =
471       M.getNamedGlobal(getCoverageUnusedNamesVarName());
472   if (!containsProfilingIntrinsics(M) && !CoverageNamesVar)
473     return MadeChange;
474 
475   // We did not know how many value sites there would be inside
476   // the instrumented function. This is counting the number of instrumented
477   // target value sites to enter it as field in the profile data variable.
478   for (Function &F : M) {
479     InstrProfIncrementInst *FirstProfIncInst = nullptr;
480     for (BasicBlock &BB : F)
481       for (auto I = BB.begin(), E = BB.end(); I != E; I++)
482         if (auto *Ind = dyn_cast<InstrProfValueProfileInst>(I))
483           computeNumValueSiteCounts(Ind);
484         else if (FirstProfIncInst == nullptr)
485           FirstProfIncInst = dyn_cast<InstrProfIncrementInst>(I);
486 
487     // Value profiling intrinsic lowering requires per-function profile data
488     // variable to be created first.
489     if (FirstProfIncInst != nullptr)
490       static_cast<void>(getOrCreateRegionCounters(FirstProfIncInst));
491   }
492 
493   for (Function &F : M)
494     MadeChange |= lowerIntrinsics(&F);
495 
496   if (CoverageNamesVar) {
497     lowerCoverageData(CoverageNamesVar);
498     MadeChange = true;
499   }
500 
501   if (!MadeChange)
502     return false;
503 
504   emitVNodes();
505   emitNameData();
506   emitRegistration();
507   emitUses();
508   emitInitialization();
509   return true;
510 }
511 
getOrInsertValueProfilingCall(Module & M,const TargetLibraryInfo & TLI,bool IsRange=false)512 static Constant *getOrInsertValueProfilingCall(Module &M,
513                                                const TargetLibraryInfo &TLI,
514                                                bool IsRange = false) {
515   LLVMContext &Ctx = M.getContext();
516   auto *ReturnTy = Type::getVoidTy(M.getContext());
517 
518   Constant *Res;
519   if (!IsRange) {
520     Type *ParamTypes[] = {
521 #define VALUE_PROF_FUNC_PARAM(ParamType, ParamName, ParamLLVMType) ParamLLVMType
522 #include "llvm/ProfileData/InstrProfData.inc"
523     };
524     auto *ValueProfilingCallTy =
525         FunctionType::get(ReturnTy, makeArrayRef(ParamTypes), false);
526     Res = M.getOrInsertFunction(getInstrProfValueProfFuncName(),
527                                 ValueProfilingCallTy);
528   } else {
529     Type *RangeParamTypes[] = {
530 #define VALUE_RANGE_PROF 1
531 #define VALUE_PROF_FUNC_PARAM(ParamType, ParamName, ParamLLVMType) ParamLLVMType
532 #include "llvm/ProfileData/InstrProfData.inc"
533 #undef VALUE_RANGE_PROF
534     };
535     auto *ValueRangeProfilingCallTy =
536         FunctionType::get(ReturnTy, makeArrayRef(RangeParamTypes), false);
537     Res = M.getOrInsertFunction(getInstrProfValueRangeProfFuncName(),
538                                 ValueRangeProfilingCallTy);
539   }
540 
541   if (Function *FunRes = dyn_cast<Function>(Res)) {
542     if (auto AK = TLI.getExtAttrForI32Param(false))
543       FunRes->addParamAttr(2, AK);
544   }
545   return Res;
546 }
547 
computeNumValueSiteCounts(InstrProfValueProfileInst * Ind)548 void InstrProfiling::computeNumValueSiteCounts(InstrProfValueProfileInst *Ind) {
549   GlobalVariable *Name = Ind->getName();
550   uint64_t ValueKind = Ind->getValueKind()->getZExtValue();
551   uint64_t Index = Ind->getIndex()->getZExtValue();
552   auto It = ProfileDataMap.find(Name);
553   if (It == ProfileDataMap.end()) {
554     PerFunctionProfileData PD;
555     PD.NumValueSites[ValueKind] = Index + 1;
556     ProfileDataMap[Name] = PD;
557   } else if (It->second.NumValueSites[ValueKind] <= Index)
558     It->second.NumValueSites[ValueKind] = Index + 1;
559 }
560 
lowerValueProfileInst(InstrProfValueProfileInst * Ind)561 void InstrProfiling::lowerValueProfileInst(InstrProfValueProfileInst *Ind) {
562   GlobalVariable *Name = Ind->getName();
563   auto It = ProfileDataMap.find(Name);
564   assert(It != ProfileDataMap.end() && It->second.DataVar &&
565          "value profiling detected in function with no counter incerement");
566 
567   GlobalVariable *DataVar = It->second.DataVar;
568   uint64_t ValueKind = Ind->getValueKind()->getZExtValue();
569   uint64_t Index = Ind->getIndex()->getZExtValue();
570   for (uint32_t Kind = IPVK_First; Kind < ValueKind; ++Kind)
571     Index += It->second.NumValueSites[Kind];
572 
573   IRBuilder<> Builder(Ind);
574   bool IsRange = (Ind->getValueKind()->getZExtValue() ==
575                   llvm::InstrProfValueKind::IPVK_MemOPSize);
576   CallInst *Call = nullptr;
577   if (!IsRange) {
578     Value *Args[3] = {Ind->getTargetValue(),
579                       Builder.CreateBitCast(DataVar, Builder.getInt8PtrTy()),
580                       Builder.getInt32(Index)};
581     Call = Builder.CreateCall(getOrInsertValueProfilingCall(*M, *TLI), Args);
582   } else {
583     Value *Args[6] = {
584         Ind->getTargetValue(),
585         Builder.CreateBitCast(DataVar, Builder.getInt8PtrTy()),
586         Builder.getInt32(Index),
587         Builder.getInt64(MemOPSizeRangeStart),
588         Builder.getInt64(MemOPSizeRangeLast),
589         Builder.getInt64(MemOPSizeLarge == 0 ? INT64_MIN : MemOPSizeLarge)};
590     Call =
591         Builder.CreateCall(getOrInsertValueProfilingCall(*M, *TLI, true), Args);
592   }
593   if (auto AK = TLI->getExtAttrForI32Param(false))
594     Call->addParamAttr(2, AK);
595   Ind->replaceAllUsesWith(Call);
596   Ind->eraseFromParent();
597 }
598 
lowerIncrement(InstrProfIncrementInst * Inc)599 void InstrProfiling::lowerIncrement(InstrProfIncrementInst *Inc) {
600   GlobalVariable *Counters = getOrCreateRegionCounters(Inc);
601 
602   IRBuilder<> Builder(Inc);
603   uint64_t Index = Inc->getIndex()->getZExtValue();
604   Value *Addr = Builder.CreateConstInBoundsGEP2_64(Counters, 0, Index);
605 
606   if (Options.Atomic || AtomicCounterUpdateAll) {
607     Builder.CreateAtomicRMW(AtomicRMWInst::Add, Addr, Inc->getStep(),
608                             AtomicOrdering::Monotonic);
609   } else {
610     Value *Load = Builder.CreateLoad(Addr, "pgocount");
611     auto *Count = Builder.CreateAdd(Load, Inc->getStep());
612     auto *Store = Builder.CreateStore(Count, Addr);
613     if (isCounterPromotionEnabled())
614       PromotionCandidates.emplace_back(cast<Instruction>(Load), Store);
615   }
616   Inc->eraseFromParent();
617 }
618 
lowerCoverageData(GlobalVariable * CoverageNamesVar)619 void InstrProfiling::lowerCoverageData(GlobalVariable *CoverageNamesVar) {
620   ConstantArray *Names =
621       cast<ConstantArray>(CoverageNamesVar->getInitializer());
622   for (unsigned I = 0, E = Names->getNumOperands(); I < E; ++I) {
623     Constant *NC = Names->getOperand(I);
624     Value *V = NC->stripPointerCasts();
625     assert(isa<GlobalVariable>(V) && "Missing reference to function name");
626     GlobalVariable *Name = cast<GlobalVariable>(V);
627 
628     Name->setLinkage(GlobalValue::PrivateLinkage);
629     ReferencedNames.push_back(Name);
630     NC->dropAllReferences();
631   }
632   CoverageNamesVar->eraseFromParent();
633 }
634 
635 /// Get the name of a profiling variable for a particular function.
getVarName(InstrProfIncrementInst * Inc,StringRef Prefix)636 static std::string getVarName(InstrProfIncrementInst *Inc, StringRef Prefix) {
637   StringRef NamePrefix = getInstrProfNameVarPrefix();
638   StringRef Name = Inc->getName()->getName().substr(NamePrefix.size());
639   Function *F = Inc->getParent()->getParent();
640   Module *M = F->getParent();
641   if (!DoHashBasedCounterSplit || !isIRPGOFlagSet(M) ||
642       !canRenameComdatFunc(*F))
643     return (Prefix + Name).str();
644   uint64_t FuncHash = Inc->getHash()->getZExtValue();
645   SmallVector<char, 24> HashPostfix;
646   if (Name.endswith((Twine(".") + Twine(FuncHash)).toStringRef(HashPostfix)))
647     return (Prefix + Name).str();
648   return (Prefix + Name + "." + Twine(FuncHash)).str();
649 }
650 
shouldRecordFunctionAddr(Function * F)651 static inline bool shouldRecordFunctionAddr(Function *F) {
652   // Check the linkage
653   bool HasAvailableExternallyLinkage = F->hasAvailableExternallyLinkage();
654   if (!F->hasLinkOnceLinkage() && !F->hasLocalLinkage() &&
655       !HasAvailableExternallyLinkage)
656     return true;
657 
658   // A function marked 'alwaysinline' with available_externally linkage can't
659   // have its address taken. Doing so would create an undefined external ref to
660   // the function, which would fail to link.
661   if (HasAvailableExternallyLinkage &&
662       F->hasFnAttribute(Attribute::AlwaysInline))
663     return false;
664 
665   // Prohibit function address recording if the function is both internal and
666   // COMDAT. This avoids the profile data variable referencing internal symbols
667   // in COMDAT.
668   if (F->hasLocalLinkage() && F->hasComdat())
669     return false;
670 
671   // Check uses of this function for other than direct calls or invokes to it.
672   // Inline virtual functions have linkeOnceODR linkage. When a key method
673   // exists, the vtable will only be emitted in the TU where the key method
674   // is defined. In a TU where vtable is not available, the function won't
675   // be 'addresstaken'. If its address is not recorded here, the profile data
676   // with missing address may be picked by the linker leading  to missing
677   // indirect call target info.
678   return F->hasAddressTaken() || F->hasLinkOnceLinkage();
679 }
680 
getOrCreateProfileComdat(Module & M,Function & F,InstrProfIncrementInst * Inc)681 static inline Comdat *getOrCreateProfileComdat(Module &M, Function &F,
682                                                InstrProfIncrementInst *Inc) {
683   if (!needsComdatForCounter(F, M))
684     return nullptr;
685 
686   // COFF format requires a COMDAT section to have a key symbol with the same
687   // name. The linker targeting COFF also requires that the COMDAT
688   // a section is associated to must precede the associating section. For this
689   // reason, we must choose the counter var's name as the name of the comdat.
690   StringRef ComdatPrefix = (Triple(M.getTargetTriple()).isOSBinFormatCOFF()
691                                 ? getInstrProfCountersVarPrefix()
692                                 : getInstrProfComdatPrefix());
693   return M.getOrInsertComdat(StringRef(getVarName(Inc, ComdatPrefix)));
694 }
695 
needsRuntimeRegistrationOfSectionRange(const Module & M)696 static bool needsRuntimeRegistrationOfSectionRange(const Module &M) {
697   // Don't do this for Darwin.  compiler-rt uses linker magic.
698   if (Triple(M.getTargetTriple()).isOSDarwin())
699     return false;
700 
701   // Use linker script magic to get data/cnts/name start/end.
702   if (Triple(M.getTargetTriple()).isOSLinux() ||
703       Triple(M.getTargetTriple()).isOSFreeBSD() ||
704       Triple(M.getTargetTriple()).isOSNetBSD() ||
705       Triple(M.getTargetTriple()).isOSFuchsia() ||
706       Triple(M.getTargetTriple()).isPS4CPU())
707     return false;
708 
709   return true;
710 }
711 
712 GlobalVariable *
getOrCreateRegionCounters(InstrProfIncrementInst * Inc)713 InstrProfiling::getOrCreateRegionCounters(InstrProfIncrementInst *Inc) {
714   GlobalVariable *NamePtr = Inc->getName();
715   auto It = ProfileDataMap.find(NamePtr);
716   PerFunctionProfileData PD;
717   if (It != ProfileDataMap.end()) {
718     if (It->second.RegionCounters)
719       return It->second.RegionCounters;
720     PD = It->second;
721   }
722 
723   // Move the name variable to the right section. Place them in a COMDAT group
724   // if the associated function is a COMDAT. This will make sure that
725   // only one copy of counters of the COMDAT function will be emitted after
726   // linking.
727   Function *Fn = Inc->getParent()->getParent();
728   Comdat *ProfileVarsComdat = nullptr;
729   ProfileVarsComdat = getOrCreateProfileComdat(*M, *Fn, Inc);
730 
731   uint64_t NumCounters = Inc->getNumCounters()->getZExtValue();
732   LLVMContext &Ctx = M->getContext();
733   ArrayType *CounterTy = ArrayType::get(Type::getInt64Ty(Ctx), NumCounters);
734 
735   // Create the counters variable.
736   auto *CounterPtr =
737       new GlobalVariable(*M, CounterTy, false, NamePtr->getLinkage(),
738                          Constant::getNullValue(CounterTy),
739                          getVarName(Inc, getInstrProfCountersVarPrefix()));
740   CounterPtr->setVisibility(NamePtr->getVisibility());
741   CounterPtr->setSection(
742       getInstrProfSectionName(IPSK_cnts, TT.getObjectFormat()));
743   CounterPtr->setAlignment(8);
744   CounterPtr->setComdat(ProfileVarsComdat);
745 
746   auto *Int8PtrTy = Type::getInt8PtrTy(Ctx);
747   // Allocate statically the array of pointers to value profile nodes for
748   // the current function.
749   Constant *ValuesPtrExpr = ConstantPointerNull::get(Int8PtrTy);
750   if (ValueProfileStaticAlloc && !needsRuntimeRegistrationOfSectionRange(*M)) {
751     uint64_t NS = 0;
752     for (uint32_t Kind = IPVK_First; Kind <= IPVK_Last; ++Kind)
753       NS += PD.NumValueSites[Kind];
754     if (NS) {
755       ArrayType *ValuesTy = ArrayType::get(Type::getInt64Ty(Ctx), NS);
756 
757       auto *ValuesVar =
758           new GlobalVariable(*M, ValuesTy, false, NamePtr->getLinkage(),
759                              Constant::getNullValue(ValuesTy),
760                              getVarName(Inc, getInstrProfValuesVarPrefix()));
761       ValuesVar->setVisibility(NamePtr->getVisibility());
762       ValuesVar->setSection(
763           getInstrProfSectionName(IPSK_vals, TT.getObjectFormat()));
764       ValuesVar->setAlignment(8);
765       ValuesVar->setComdat(ProfileVarsComdat);
766       ValuesPtrExpr =
767           ConstantExpr::getBitCast(ValuesVar, Type::getInt8PtrTy(Ctx));
768     }
769   }
770 
771   // Create data variable.
772   auto *Int16Ty = Type::getInt16Ty(Ctx);
773   auto *Int16ArrayTy = ArrayType::get(Int16Ty, IPVK_Last + 1);
774   Type *DataTypes[] = {
775 #define INSTR_PROF_DATA(Type, LLVMType, Name, Init) LLVMType,
776 #include "llvm/ProfileData/InstrProfData.inc"
777   };
778   auto *DataTy = StructType::get(Ctx, makeArrayRef(DataTypes));
779 
780   Constant *FunctionAddr = shouldRecordFunctionAddr(Fn)
781                                ? ConstantExpr::getBitCast(Fn, Int8PtrTy)
782                                : ConstantPointerNull::get(Int8PtrTy);
783 
784   Constant *Int16ArrayVals[IPVK_Last + 1];
785   for (uint32_t Kind = IPVK_First; Kind <= IPVK_Last; ++Kind)
786     Int16ArrayVals[Kind] = ConstantInt::get(Int16Ty, PD.NumValueSites[Kind]);
787 
788   Constant *DataVals[] = {
789 #define INSTR_PROF_DATA(Type, LLVMType, Name, Init) Init,
790 #include "llvm/ProfileData/InstrProfData.inc"
791   };
792   auto *Data = new GlobalVariable(*M, DataTy, false, NamePtr->getLinkage(),
793                                   ConstantStruct::get(DataTy, DataVals),
794                                   getVarName(Inc, getInstrProfDataVarPrefix()));
795   Data->setVisibility(NamePtr->getVisibility());
796   Data->setSection(getInstrProfSectionName(IPSK_data, TT.getObjectFormat()));
797   Data->setAlignment(INSTR_PROF_DATA_ALIGNMENT);
798   Data->setComdat(ProfileVarsComdat);
799 
800   PD.RegionCounters = CounterPtr;
801   PD.DataVar = Data;
802   ProfileDataMap[NamePtr] = PD;
803 
804   // Mark the data variable as used so that it isn't stripped out.
805   UsedVars.push_back(Data);
806   // Now that the linkage set by the FE has been passed to the data and counter
807   // variables, reset Name variable's linkage and visibility to private so that
808   // it can be removed later by the compiler.
809   NamePtr->setLinkage(GlobalValue::PrivateLinkage);
810   // Collect the referenced names to be used by emitNameData.
811   ReferencedNames.push_back(NamePtr);
812 
813   return CounterPtr;
814 }
815 
emitVNodes()816 void InstrProfiling::emitVNodes() {
817   if (!ValueProfileStaticAlloc)
818     return;
819 
820   // For now only support this on platforms that do
821   // not require runtime registration to discover
822   // named section start/end.
823   if (needsRuntimeRegistrationOfSectionRange(*M))
824     return;
825 
826   size_t TotalNS = 0;
827   for (auto &PD : ProfileDataMap) {
828     for (uint32_t Kind = IPVK_First; Kind <= IPVK_Last; ++Kind)
829       TotalNS += PD.second.NumValueSites[Kind];
830   }
831 
832   if (!TotalNS)
833     return;
834 
835   uint64_t NumCounters = TotalNS * NumCountersPerValueSite;
836 // Heuristic for small programs with very few total value sites.
837 // The default value of vp-counters-per-site is chosen based on
838 // the observation that large apps usually have a low percentage
839 // of value sites that actually have any profile data, and thus
840 // the average number of counters per site is low. For small
841 // apps with very few sites, this may not be true. Bump up the
842 // number of counters in this case.
843 #define INSTR_PROF_MIN_VAL_COUNTS 10
844   if (NumCounters < INSTR_PROF_MIN_VAL_COUNTS)
845     NumCounters = std::max(INSTR_PROF_MIN_VAL_COUNTS, (int)NumCounters * 2);
846 
847   auto &Ctx = M->getContext();
848   Type *VNodeTypes[] = {
849 #define INSTR_PROF_VALUE_NODE(Type, LLVMType, Name, Init) LLVMType,
850 #include "llvm/ProfileData/InstrProfData.inc"
851   };
852   auto *VNodeTy = StructType::get(Ctx, makeArrayRef(VNodeTypes));
853 
854   ArrayType *VNodesTy = ArrayType::get(VNodeTy, NumCounters);
855   auto *VNodesVar = new GlobalVariable(
856       *M, VNodesTy, false, GlobalValue::PrivateLinkage,
857       Constant::getNullValue(VNodesTy), getInstrProfVNodesVarName());
858   VNodesVar->setSection(
859       getInstrProfSectionName(IPSK_vnodes, TT.getObjectFormat()));
860   UsedVars.push_back(VNodesVar);
861 }
862 
emitNameData()863 void InstrProfiling::emitNameData() {
864   std::string UncompressedData;
865 
866   if (ReferencedNames.empty())
867     return;
868 
869   std::string CompressedNameStr;
870   if (Error E = collectPGOFuncNameStrings(ReferencedNames, CompressedNameStr,
871                                           DoNameCompression)) {
872     report_fatal_error(toString(std::move(E)), false);
873   }
874 
875   auto &Ctx = M->getContext();
876   auto *NamesVal = ConstantDataArray::getString(
877       Ctx, StringRef(CompressedNameStr), false);
878   NamesVar = new GlobalVariable(*M, NamesVal->getType(), true,
879                                 GlobalValue::PrivateLinkage, NamesVal,
880                                 getInstrProfNamesVarName());
881   NamesSize = CompressedNameStr.size();
882   NamesVar->setSection(
883       getInstrProfSectionName(IPSK_name, TT.getObjectFormat()));
884   UsedVars.push_back(NamesVar);
885 
886   for (auto *NamePtr : ReferencedNames)
887     NamePtr->eraseFromParent();
888 }
889 
emitRegistration()890 void InstrProfiling::emitRegistration() {
891   if (!needsRuntimeRegistrationOfSectionRange(*M))
892     return;
893 
894   // Construct the function.
895   auto *VoidTy = Type::getVoidTy(M->getContext());
896   auto *VoidPtrTy = Type::getInt8PtrTy(M->getContext());
897   auto *Int64Ty = Type::getInt64Ty(M->getContext());
898   auto *RegisterFTy = FunctionType::get(VoidTy, false);
899   auto *RegisterF = Function::Create(RegisterFTy, GlobalValue::InternalLinkage,
900                                      getInstrProfRegFuncsName(), M);
901   RegisterF->setUnnamedAddr(GlobalValue::UnnamedAddr::Global);
902   if (Options.NoRedZone)
903     RegisterF->addFnAttr(Attribute::NoRedZone);
904 
905   auto *RuntimeRegisterTy = FunctionType::get(VoidTy, VoidPtrTy, false);
906   auto *RuntimeRegisterF =
907       Function::Create(RuntimeRegisterTy, GlobalVariable::ExternalLinkage,
908                        getInstrProfRegFuncName(), M);
909 
910   IRBuilder<> IRB(BasicBlock::Create(M->getContext(), "", RegisterF));
911   for (Value *Data : UsedVars)
912     if (Data != NamesVar && !isa<Function>(Data))
913       IRB.CreateCall(RuntimeRegisterF, IRB.CreateBitCast(Data, VoidPtrTy));
914 
915   if (NamesVar) {
916     Type *ParamTypes[] = {VoidPtrTy, Int64Ty};
917     auto *NamesRegisterTy =
918         FunctionType::get(VoidTy, makeArrayRef(ParamTypes), false);
919     auto *NamesRegisterF =
920         Function::Create(NamesRegisterTy, GlobalVariable::ExternalLinkage,
921                          getInstrProfNamesRegFuncName(), M);
922     IRB.CreateCall(NamesRegisterF, {IRB.CreateBitCast(NamesVar, VoidPtrTy),
923                                     IRB.getInt64(NamesSize)});
924   }
925 
926   IRB.CreateRetVoid();
927 }
928 
emitRuntimeHook()929 bool InstrProfiling::emitRuntimeHook() {
930   // We expect the linker to be invoked with -u<hook_var> flag for linux,
931   // for which case there is no need to emit the user function.
932   if (Triple(M->getTargetTriple()).isOSLinux())
933     return false;
934 
935   // If the module's provided its own runtime, we don't need to do anything.
936   if (M->getGlobalVariable(getInstrProfRuntimeHookVarName()))
937     return false;
938 
939   // Declare an external variable that will pull in the runtime initialization.
940   auto *Int32Ty = Type::getInt32Ty(M->getContext());
941   auto *Var =
942       new GlobalVariable(*M, Int32Ty, false, GlobalValue::ExternalLinkage,
943                          nullptr, getInstrProfRuntimeHookVarName());
944 
945   // Make a function that uses it.
946   auto *User = Function::Create(FunctionType::get(Int32Ty, false),
947                                 GlobalValue::LinkOnceODRLinkage,
948                                 getInstrProfRuntimeHookVarUseFuncName(), M);
949   User->addFnAttr(Attribute::NoInline);
950   if (Options.NoRedZone)
951     User->addFnAttr(Attribute::NoRedZone);
952   User->setVisibility(GlobalValue::HiddenVisibility);
953   if (Triple(M->getTargetTriple()).supportsCOMDAT())
954     User->setComdat(M->getOrInsertComdat(User->getName()));
955 
956   IRBuilder<> IRB(BasicBlock::Create(M->getContext(), "", User));
957   auto *Load = IRB.CreateLoad(Var);
958   IRB.CreateRet(Load);
959 
960   // Mark the user variable as used so that it isn't stripped out.
961   UsedVars.push_back(User);
962   return true;
963 }
964 
emitUses()965 void InstrProfiling::emitUses() {
966   if (!UsedVars.empty())
967     appendToUsed(*M, UsedVars);
968 }
969 
emitInitialization()970 void InstrProfiling::emitInitialization() {
971   StringRef InstrProfileOutput = Options.InstrProfileOutput;
972 
973   if (!InstrProfileOutput.empty()) {
974     // Create variable for profile name.
975     Constant *ProfileNameConst =
976         ConstantDataArray::getString(M->getContext(), InstrProfileOutput, true);
977     GlobalVariable *ProfileNameVar = new GlobalVariable(
978         *M, ProfileNameConst->getType(), true, GlobalValue::WeakAnyLinkage,
979         ProfileNameConst, INSTR_PROF_QUOTE(INSTR_PROF_PROFILE_NAME_VAR));
980     if (TT.supportsCOMDAT()) {
981       ProfileNameVar->setLinkage(GlobalValue::ExternalLinkage);
982       ProfileNameVar->setComdat(M->getOrInsertComdat(
983           StringRef(INSTR_PROF_QUOTE(INSTR_PROF_PROFILE_NAME_VAR))));
984     }
985   }
986 
987   Constant *RegisterF = M->getFunction(getInstrProfRegFuncsName());
988   if (!RegisterF)
989     return;
990 
991   // Create the initialization function.
992   auto *VoidTy = Type::getVoidTy(M->getContext());
993   auto *F = Function::Create(FunctionType::get(VoidTy, false),
994                              GlobalValue::InternalLinkage,
995                              getInstrProfInitFuncName(), M);
996   F->setUnnamedAddr(GlobalValue::UnnamedAddr::Global);
997   F->addFnAttr(Attribute::NoInline);
998   if (Options.NoRedZone)
999     F->addFnAttr(Attribute::NoRedZone);
1000 
1001   // Add the basic block and the necessary calls.
1002   IRBuilder<> IRB(BasicBlock::Create(M->getContext(), "", F));
1003   if (RegisterF)
1004     IRB.CreateCall(RegisterF, {});
1005   IRB.CreateRetVoid();
1006 
1007   appendToGlobalCtors(*M, F, 0);
1008 }
1009