blob: d802295d5532b31b5d0031bfbcc22983d1854f2a [file] [log] [blame]
Rong Xuf430ae42015-12-09 18:08:16 +00001//===-- PGOInstrumentation.cpp - MST-based PGO Instrumentation ------------===//
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 file implements PGO instrumentation using a minimum spanning tree based
11// on the following paper:
12// [1] Donald E. Knuth, Francis R. Stevenson. Optimal measurement of points
13// for program frequency counts. BIT Numerical Mathematics 1973, Volume 13,
14// Issue 3, pp 313-322
15// The idea of the algorithm based on the fact that for each node (except for
16// the entry and exit), the sum of incoming edge counts equals the sum of
17// outgoing edge counts. The count of edge on spanning tree can be derived from
18// those edges not on the spanning tree. Knuth proves this method instruments
19// the minimum number of edges.
20//
21// The minimal spanning tree here is actually a maximum weight tree -- on-tree
22// edges have higher frequencies (more likely to execute). The idea is to
23// instrument those less frequently executed edges to reduce the runtime
24// overhead of instrumented binaries.
25//
26// This file contains two passes:
27// (1) Pass PGOInstrumentationGen which instruments the IR to generate edge
Rong Xu13b01dc2016-02-10 18:24:45 +000028// count profile, and generates the instrumentation for indirect call
29// profiling.
Rong Xuf430ae42015-12-09 18:08:16 +000030// (2) Pass PGOInstrumentationUse which reads the edge count profile and
Rong Xu13b01dc2016-02-10 18:24:45 +000031// annotates the branch weights. It also reads the indirect call value
32// profiling records and annotate the indirect call instructions.
33//
Rong Xuf430ae42015-12-09 18:08:16 +000034// To get the precise counter information, These two passes need to invoke at
35// the same compilation point (so they see the same IR). For pass
36// PGOInstrumentationGen, the real work is done in instrumentOneFunc(). For
37// pass PGOInstrumentationUse, the real work in done in class PGOUseFunc and
38// the profile is opened in module level and passed to each PGOUseFunc instance.
39// The shared code for PGOInstrumentationGen and PGOInstrumentationUse is put
40// in class FuncPGOInstrumentation.
41//
42// Class PGOEdge represents a CFG edge and some auxiliary information. Class
43// BBInfo contains auxiliary information for each BB. These two classes are used
44// in pass PGOInstrumentationGen. Class PGOUseEdge and UseBBInfo are the derived
45// class of PGOEdge and BBInfo, respectively. They contains extra data structure
46// used in populating profile counters.
47// The MST implementation is in Class CFGMST (CFGMST.h).
48//
49//===----------------------------------------------------------------------===//
50
Xinliang David Li8aebf442016-05-06 05:49:19 +000051#include "llvm/Transforms/PGOInstrumentation.h"
Rong Xuf430ae42015-12-09 18:08:16 +000052#include "CFGMST.h"
Rong Xuf430ae42015-12-09 18:08:16 +000053#include "llvm/ADT/STLExtras.h"
Rong Xu705f7772016-07-25 18:45:37 +000054#include "llvm/ADT/SmallVector.h"
Rong Xuf430ae42015-12-09 18:08:16 +000055#include "llvm/ADT/Statistic.h"
Rong Xu33c76c02016-02-10 17:18:30 +000056#include "llvm/ADT/Triple.h"
Rong Xuf430ae42015-12-09 18:08:16 +000057#include "llvm/Analysis/BlockFrequencyInfo.h"
58#include "llvm/Analysis/BranchProbabilityInfo.h"
59#include "llvm/Analysis/CFG.h"
Teresa Johnson1e44b5d2016-07-12 21:13:44 +000060#include "llvm/Analysis/IndirectCallSiteVisitor.h"
Rong Xued9fec72016-01-21 18:11:44 +000061#include "llvm/IR/CallSite.h"
Rong Xuf430ae42015-12-09 18:08:16 +000062#include "llvm/IR/DiagnosticInfo.h"
Rong Xu705f7772016-07-25 18:45:37 +000063#include "llvm/IR/GlobalValue.h"
Rong Xuf430ae42015-12-09 18:08:16 +000064#include "llvm/IR/IRBuilder.h"
65#include "llvm/IR/InstIterator.h"
66#include "llvm/IR/Instructions.h"
67#include "llvm/IR/IntrinsicInst.h"
68#include "llvm/IR/MDBuilder.h"
69#include "llvm/IR/Module.h"
70#include "llvm/Pass.h"
71#include "llvm/ProfileData/InstrProfReader.h"
Easwaran Raman5fe04a12016-05-26 22:57:11 +000072#include "llvm/ProfileData/ProfileCommon.h"
Rong Xuf430ae42015-12-09 18:08:16 +000073#include "llvm/Support/BranchProbability.h"
74#include "llvm/Support/Debug.h"
75#include "llvm/Support/JamCRC.h"
Rong Xued9fec72016-01-21 18:11:44 +000076#include "llvm/Transforms/Instrumentation.h"
Rong Xuf430ae42015-12-09 18:08:16 +000077#include "llvm/Transforms/Utils/BasicBlockUtils.h"
Xinliang David Li8aebf442016-05-06 05:49:19 +000078#include <algorithm>
Rong Xuf430ae42015-12-09 18:08:16 +000079#include <string>
Rong Xu705f7772016-07-25 18:45:37 +000080#include <unordered_map>
Rong Xuf430ae42015-12-09 18:08:16 +000081#include <utility>
82#include <vector>
83
84using namespace llvm;
85
86#define DEBUG_TYPE "pgo-instrumentation"
87
88STATISTIC(NumOfPGOInstrument, "Number of edges instrumented.");
Xinliang David Li4ca17332016-09-18 18:34:07 +000089STATISTIC(NumOfPGOSelectInsts, "Number of select instruction instrumented.");
Rong Xuf430ae42015-12-09 18:08:16 +000090STATISTIC(NumOfPGOEdge, "Number of edges.");
91STATISTIC(NumOfPGOBB, "Number of basic-blocks.");
92STATISTIC(NumOfPGOSplit, "Number of critical edge splits.");
93STATISTIC(NumOfPGOFunc, "Number of functions having valid profile counts.");
94STATISTIC(NumOfPGOMismatch, "Number of functions having mismatch profile.");
95STATISTIC(NumOfPGOMissing, "Number of functions without profile.");
Rong Xu13b01dc2016-02-10 18:24:45 +000096STATISTIC(NumOfPGOICall, "Number of indirect call value instrumentations.");
Rong Xuf430ae42015-12-09 18:08:16 +000097
98// Command line option to specify the file to read profile from. This is
99// mainly used for testing.
100static cl::opt<std::string>
101 PGOTestProfileFile("pgo-test-profile-file", cl::init(""), cl::Hidden,
102 cl::value_desc("filename"),
103 cl::desc("Specify the path of profile data file. This is"
104 "mainly for test purpose."));
105
Rong Xuecdc98f2016-03-04 22:08:44 +0000106// Command line option to disable value profiling. The default is false:
Rong Xu13b01dc2016-02-10 18:24:45 +0000107// i.e. value profiling is enabled by default. This is for debug purpose.
Rong Xu9e926e82016-02-29 19:16:04 +0000108static cl::opt<bool> DisableValueProfiling("disable-vp", cl::init(false),
109 cl::Hidden,
110 cl::desc("Disable Value Profiling"));
Rong Xued9fec72016-01-21 18:11:44 +0000111
Rong Xuecdc98f2016-03-04 22:08:44 +0000112// Command line option to set the maximum number of VP annotations to write to
Rong Xu08afb052016-04-28 17:31:22 +0000113// the metadata for a single indirect call callsite.
114static cl::opt<unsigned> MaxNumAnnotations(
115 "icp-max-annotations", cl::init(3), cl::Hidden, cl::ZeroOrMore,
116 cl::desc("Max number of annotations for a single indirect "
117 "call callsite"));
Rong Xuecdc98f2016-03-04 22:08:44 +0000118
Rong Xu705f7772016-07-25 18:45:37 +0000119// Command line option to control appending FunctionHash to the name of a COMDAT
120// function. This is to avoid the hash mismatch caused by the preinliner.
121static cl::opt<bool> DoComdatRenaming(
122 "do-comdat-renaming", cl::init(true), cl::Hidden,
123 cl::desc("Append function hash to the name of COMDAT function to avoid "
124 "function hash mismatch due to the preinliner"));
125
Rong Xu0698de92016-05-13 17:26:06 +0000126// Command line option to enable/disable the warning about missing profile
127// information.
Xinliang David Li76a01082016-08-11 05:09:30 +0000128static cl::opt<bool> PGOWarnMissing("pgo-warn-missing-function",
129 cl::init(false),
130 cl::Hidden);
Rong Xu0698de92016-05-13 17:26:06 +0000131
132// Command line option to enable/disable the warning about a hash mismatch in
133// the profile data.
134static cl::opt<bool> NoPGOWarnMismatch("no-pgo-warn-mismatch", cl::init(false),
135 cl::Hidden);
136
Xinliang David Li4ca17332016-09-18 18:34:07 +0000137// Command line option to enable/disable select instruction instrumentation.
138static cl::opt<bool> PGOInstrSelect("pgo-instr-select", cl::init(true),
139 cl::Hidden);
Rong Xuf430ae42015-12-09 18:08:16 +0000140namespace {
Xinliang David Li4ca17332016-09-18 18:34:07 +0000141
142/// The select instruction visitor plays three roles specified
143/// by the mode. In \c VM_counting mode, it simply counts the number of
144/// select instructions. In \c VM_instrument mode, it inserts code to count
145/// the number times TrueValue of select is taken. In \c VM_annotate mode,
146/// it reads the profile data and annotate the select instruction with metadata.
147enum VisitMode { VM_counting, VM_instrument, VM_annotate };
148class PGOUseFunc;
149
150/// Instruction Visitor class to visit select instructions.
151struct SelectInstVisitor : public InstVisitor<SelectInstVisitor> {
152 Function &F;
153 unsigned NSIs = 0; // Number of select instructions instrumented.
154 VisitMode Mode = VM_counting; // Visiting mode.
155 unsigned *CurCtrIdx = nullptr; // Pointer to current counter index.
156 unsigned TotalNumCtrs = 0; // Total number of counters
157 GlobalVariable *FuncNameVar = nullptr;
158 uint64_t FuncHash = 0;
159 PGOUseFunc *UseFunc = nullptr;
160
161 SelectInstVisitor(Function &Func) : F(Func) {}
162
163 void countSelects(Function &Func) {
164 Mode = VM_counting;
165 visit(Func);
166 }
167 // Visit the IR stream and instrument all select instructions. \p
168 // Ind is a pointer to the counter index variable; \p TotalNC
169 // is the total number of counters; \p FNV is the pointer to the
170 // PGO function name var; \p FHash is the function hash.
171 void instrumentSelects(Function &Func, unsigned *Ind, unsigned TotalNC,
172 GlobalVariable *FNV, uint64_t FHash) {
173 Mode = VM_instrument;
174 CurCtrIdx = Ind;
175 TotalNumCtrs = TotalNC;
176 FuncHash = FHash;
177 FuncNameVar = FNV;
178 visit(Func);
179 }
180
181 // Visit the IR stream and annotate all select instructions.
182 void annotateSelects(Function &Func, PGOUseFunc *UF, unsigned *Ind) {
183 Mode = VM_annotate;
184 UseFunc = UF;
185 CurCtrIdx = Ind;
186 visit(Func);
187 }
188
189 void instrumentOneSelectInst(SelectInst &SI);
190 void annotateOneSelectInst(SelectInst &SI);
191 // Visit \p SI instruction and perform tasks according to visit mode.
192 void visitSelectInst(SelectInst &SI);
193 unsigned getNumOfSelectInsts() const { return NSIs; }
194};
195
Xinliang David Li8aebf442016-05-06 05:49:19 +0000196class PGOInstrumentationGenLegacyPass : public ModulePass {
Rong Xuf430ae42015-12-09 18:08:16 +0000197public:
198 static char ID;
199
Xinliang David Lidfa21c32016-05-09 21:37:12 +0000200 PGOInstrumentationGenLegacyPass() : ModulePass(ID) {
Xinliang David Li8aebf442016-05-06 05:49:19 +0000201 initializePGOInstrumentationGenLegacyPassPass(
202 *PassRegistry::getPassRegistry());
Rong Xuf430ae42015-12-09 18:08:16 +0000203 }
204
Mehdi Amini117296c2016-10-01 02:56:57 +0000205 StringRef getPassName() const override { return "PGOInstrumentationGenPass"; }
Rong Xuf430ae42015-12-09 18:08:16 +0000206
207private:
208 bool runOnModule(Module &M) override;
209
210 void getAnalysisUsage(AnalysisUsage &AU) const override {
211 AU.addRequired<BlockFrequencyInfoWrapperPass>();
212 }
213};
214
Xinliang David Lid55827f2016-05-07 05:39:12 +0000215class PGOInstrumentationUseLegacyPass : public ModulePass {
Rong Xuf430ae42015-12-09 18:08:16 +0000216public:
217 static char ID;
218
219 // Provide the profile filename as the parameter.
Xinliang David Lid55827f2016-05-07 05:39:12 +0000220 PGOInstrumentationUseLegacyPass(std::string Filename = "")
Benjamin Kramer82de7d32016-05-27 14:27:24 +0000221 : ModulePass(ID), ProfileFileName(std::move(Filename)) {
Rong Xuf430ae42015-12-09 18:08:16 +0000222 if (!PGOTestProfileFile.empty())
223 ProfileFileName = PGOTestProfileFile;
Xinliang David Lid55827f2016-05-07 05:39:12 +0000224 initializePGOInstrumentationUseLegacyPassPass(
225 *PassRegistry::getPassRegistry());
Rong Xuf430ae42015-12-09 18:08:16 +0000226 }
227
Mehdi Amini117296c2016-10-01 02:56:57 +0000228 StringRef getPassName() const override { return "PGOInstrumentationUsePass"; }
Rong Xuf430ae42015-12-09 18:08:16 +0000229
230private:
231 std::string ProfileFileName;
Rong Xuf430ae42015-12-09 18:08:16 +0000232
Xinliang David Lida195582016-05-10 21:59:52 +0000233 bool runOnModule(Module &M) override;
Rong Xuf430ae42015-12-09 18:08:16 +0000234 void getAnalysisUsage(AnalysisUsage &AU) const override {
235 AU.addRequired<BlockFrequencyInfoWrapperPass>();
236 }
237};
Xinliang David Li4ca17332016-09-18 18:34:07 +0000238
Rong Xuf430ae42015-12-09 18:08:16 +0000239} // end anonymous namespace
240
Xinliang David Li8aebf442016-05-06 05:49:19 +0000241char PGOInstrumentationGenLegacyPass::ID = 0;
242INITIALIZE_PASS_BEGIN(PGOInstrumentationGenLegacyPass, "pgo-instr-gen",
Rong Xuf430ae42015-12-09 18:08:16 +0000243 "PGO instrumentation.", false, false)
244INITIALIZE_PASS_DEPENDENCY(BlockFrequencyInfoWrapperPass)
245INITIALIZE_PASS_DEPENDENCY(BranchProbabilityInfoWrapperPass)
Xinliang David Li8aebf442016-05-06 05:49:19 +0000246INITIALIZE_PASS_END(PGOInstrumentationGenLegacyPass, "pgo-instr-gen",
Rong Xuf430ae42015-12-09 18:08:16 +0000247 "PGO instrumentation.", false, false)
248
Xinliang David Li8aebf442016-05-06 05:49:19 +0000249ModulePass *llvm::createPGOInstrumentationGenLegacyPass() {
250 return new PGOInstrumentationGenLegacyPass();
Rong Xuf430ae42015-12-09 18:08:16 +0000251}
252
Xinliang David Lid55827f2016-05-07 05:39:12 +0000253char PGOInstrumentationUseLegacyPass::ID = 0;
254INITIALIZE_PASS_BEGIN(PGOInstrumentationUseLegacyPass, "pgo-instr-use",
Rong Xuf430ae42015-12-09 18:08:16 +0000255 "Read PGO instrumentation profile.", false, false)
256INITIALIZE_PASS_DEPENDENCY(BlockFrequencyInfoWrapperPass)
257INITIALIZE_PASS_DEPENDENCY(BranchProbabilityInfoWrapperPass)
Xinliang David Lid55827f2016-05-07 05:39:12 +0000258INITIALIZE_PASS_END(PGOInstrumentationUseLegacyPass, "pgo-instr-use",
Rong Xuf430ae42015-12-09 18:08:16 +0000259 "Read PGO instrumentation profile.", false, false)
260
Xinliang David Lid55827f2016-05-07 05:39:12 +0000261ModulePass *llvm::createPGOInstrumentationUseLegacyPass(StringRef Filename) {
262 return new PGOInstrumentationUseLegacyPass(Filename.str());
Rong Xuf430ae42015-12-09 18:08:16 +0000263}
264
265namespace {
266/// \brief An MST based instrumentation for PGO
267///
268/// Implements a Minimum Spanning Tree (MST) based instrumentation for PGO
269/// in the function level.
270struct PGOEdge {
271 // This class implements the CFG edges. Note the CFG can be a multi-graph.
272 // So there might be multiple edges with same SrcBB and DestBB.
273 const BasicBlock *SrcBB;
274 const BasicBlock *DestBB;
275 uint64_t Weight;
276 bool InMST;
277 bool Removed;
278 bool IsCritical;
279 PGOEdge(const BasicBlock *Src, const BasicBlock *Dest, unsigned W = 1)
280 : SrcBB(Src), DestBB(Dest), Weight(W), InMST(false), Removed(false),
281 IsCritical(false) {}
282 // Return the information string of an edge.
283 const std::string infoString() const {
284 return (Twine(Removed ? "-" : " ") + (InMST ? " " : "*") +
285 (IsCritical ? "c" : " ") + " W=" + Twine(Weight)).str();
286 }
287};
288
289// This class stores the auxiliary information for each BB.
290struct BBInfo {
291 BBInfo *Group;
292 uint32_t Index;
293 uint32_t Rank;
294
295 BBInfo(unsigned IX) : Group(this), Index(IX), Rank(0) {}
296
297 // Return the information string of this object.
298 const std::string infoString() const {
299 return (Twine("Index=") + Twine(Index)).str();
300 }
301};
302
303// This class implements the CFG edges. Note the CFG can be a multi-graph.
304template <class Edge, class BBInfo> class FuncPGOInstrumentation {
305private:
306 Function &F;
307 void computeCFGHash();
Rong Xu705f7772016-07-25 18:45:37 +0000308 void renameComdatFunction();
309 // A map that stores the Comdat group in function F.
310 std::unordered_multimap<Comdat *, GlobalValue *> &ComdatMembers;
Rong Xuf430ae42015-12-09 18:08:16 +0000311
312public:
Xinliang David Li9780fc12016-09-20 22:39:47 +0000313 std::vector<Instruction *> IndirectCallSites;
Xinliang David Li4ca17332016-09-18 18:34:07 +0000314 SelectInstVisitor SIVisitor;
Rong Xuf430ae42015-12-09 18:08:16 +0000315 std::string FuncName;
316 GlobalVariable *FuncNameVar;
317 // CFG hash value for this function.
318 uint64_t FunctionHash;
319
320 // The Minimum Spanning Tree of function CFG.
321 CFGMST<Edge, BBInfo> MST;
322
323 // Give an edge, find the BB that will be instrumented.
324 // Return nullptr if there is no BB to be instrumented.
325 BasicBlock *getInstrBB(Edge *E);
326
327 // Return the auxiliary BB information.
328 BBInfo &getBBInfo(const BasicBlock *BB) const { return MST.getBBInfo(BB); }
329
Rong Xua5b57452016-12-02 19:10:29 +0000330 // Return the auxiliary BB information if available.
331 BBInfo *findBBInfo(const BasicBlock *BB) const { return MST.findBBInfo(BB); }
332
Rong Xuf430ae42015-12-09 18:08:16 +0000333 // Dump edges and BB information.
334 void dumpInfo(std::string Str = "") const {
335 MST.dumpEdges(dbgs(), Twine("Dump Function ") + FuncName + " Hash: " +
Rong Xued9fec72016-01-21 18:11:44 +0000336 Twine(FunctionHash) + "\t" + Str);
Rong Xuf430ae42015-12-09 18:08:16 +0000337 }
338
Rong Xu705f7772016-07-25 18:45:37 +0000339 FuncPGOInstrumentation(
340 Function &Func,
341 std::unordered_multimap<Comdat *, GlobalValue *> &ComdatMembers,
342 bool CreateGlobalVar = false, BranchProbabilityInfo *BPI = nullptr,
343 BlockFrequencyInfo *BFI = nullptr)
Xinliang David Li4ca17332016-09-18 18:34:07 +0000344 : F(Func), ComdatMembers(ComdatMembers), SIVisitor(Func), FunctionHash(0),
Rong Xu705f7772016-07-25 18:45:37 +0000345 MST(F, BPI, BFI) {
Xinliang David Li4ca17332016-09-18 18:34:07 +0000346
347 // This should be done before CFG hash computation.
348 SIVisitor.countSelects(Func);
349 NumOfPGOSelectInsts += SIVisitor.getNumOfSelectInsts();
Xinliang David Li9780fc12016-09-20 22:39:47 +0000350 IndirectCallSites = findIndirectCallSites(Func);
Xinliang David Li4ca17332016-09-18 18:34:07 +0000351
Rong Xuf430ae42015-12-09 18:08:16 +0000352 FuncName = getPGOFuncName(F);
353 computeCFGHash();
Rong Xu705f7772016-07-25 18:45:37 +0000354 if (ComdatMembers.size())
355 renameComdatFunction();
Rong Xuf430ae42015-12-09 18:08:16 +0000356 DEBUG(dumpInfo("after CFGMST"));
357
358 NumOfPGOBB += MST.BBInfos.size();
359 for (auto &E : MST.AllEdges) {
360 if (E->Removed)
361 continue;
362 NumOfPGOEdge++;
363 if (!E->InMST)
364 NumOfPGOInstrument++;
365 }
366
367 if (CreateGlobalVar)
368 FuncNameVar = createPGOFuncNameVar(F, FuncName);
Eugene Zelenko6ac3f732016-01-26 18:48:36 +0000369 }
Xinliang David Lid1197612016-08-01 20:25:06 +0000370
371 // Return the number of profile counters needed for the function.
372 unsigned getNumCounters() {
373 unsigned NumCounters = 0;
374 for (auto &E : this->MST.AllEdges) {
375 if (!E->InMST && !E->Removed)
376 NumCounters++;
377 }
Xinliang David Li4ca17332016-09-18 18:34:07 +0000378 return NumCounters + SIVisitor.getNumOfSelectInsts();
Xinliang David Lid1197612016-08-01 20:25:06 +0000379 }
Rong Xuf430ae42015-12-09 18:08:16 +0000380};
381
382// Compute Hash value for the CFG: the lower 32 bits are CRC32 of the index
383// value of each BB in the CFG. The higher 32 bits record the number of edges.
384template <class Edge, class BBInfo>
385void FuncPGOInstrumentation<Edge, BBInfo>::computeCFGHash() {
386 std::vector<char> Indexes;
387 JamCRC JC;
388 for (auto &BB : F) {
389 const TerminatorInst *TI = BB.getTerminator();
390 for (unsigned I = 0, E = TI->getNumSuccessors(); I != E; ++I) {
391 BasicBlock *Succ = TI->getSuccessor(I);
Rong Xua5b57452016-12-02 19:10:29 +0000392 auto BI = findBBInfo(Succ);
393 if (BI == nullptr)
394 continue;
395 uint32_t Index = BI->Index;
Rong Xuf430ae42015-12-09 18:08:16 +0000396 for (int J = 0; J < 4; J++)
397 Indexes.push_back((char)(Index >> (J * 8)));
398 }
399 }
400 JC.update(Indexes);
Xinliang David Li4ca17332016-09-18 18:34:07 +0000401 FunctionHash = (uint64_t)SIVisitor.getNumOfSelectInsts() << 56 |
Xinliang David Li9780fc12016-09-20 22:39:47 +0000402 (uint64_t)IndirectCallSites.size() << 48 |
Rong Xu705f7772016-07-25 18:45:37 +0000403 (uint64_t)MST.AllEdges.size() << 32 | JC.getCRC();
404}
405
406// Check if we can safely rename this Comdat function.
407static bool canRenameComdat(
408 Function &F,
409 std::unordered_multimap<Comdat *, GlobalValue *> &ComdatMembers) {
410 if (F.getName().empty())
411 return false;
412 if (!needsComdatForCounter(F, *(F.getParent())))
413 return false;
414 // Only safe to do if this function may be discarded if it is not used
415 // in the compilation unit.
416 if (!GlobalValue::isDiscardableIfUnused(F.getLinkage()))
417 return false;
418
419 // For AvailableExternallyLinkage functions.
420 if (!F.hasComdat()) {
421 assert(F.getLinkage() == GlobalValue::AvailableExternallyLinkage);
422 return true;
423 }
424
425 // FIXME: Current only handle those Comdat groups that only containing one
426 // function and function aliases.
427 // (1) For a Comdat group containing multiple functions, we need to have a
428 // unique postfix based on the hashes for each function. There is a
429 // non-trivial code refactoring to do this efficiently.
430 // (2) Variables can not be renamed, so we can not rename Comdat function in a
431 // group including global vars.
432 Comdat *C = F.getComdat();
433 for (auto &&CM : make_range(ComdatMembers.equal_range(C))) {
434 if (dyn_cast<GlobalAlias>(CM.second))
435 continue;
436 Function *FM = dyn_cast<Function>(CM.second);
437 if (FM != &F)
438 return false;
439 }
440 return true;
441}
442
443// Append the CFGHash to the Comdat function name.
444template <class Edge, class BBInfo>
445void FuncPGOInstrumentation<Edge, BBInfo>::renameComdatFunction() {
446 if (!canRenameComdat(F, ComdatMembers))
447 return;
Rong Xu0e79f7d2016-10-06 20:38:13 +0000448 std::string OrigName = F.getName().str();
Rong Xu705f7772016-07-25 18:45:37 +0000449 std::string NewFuncName =
450 Twine(F.getName() + "." + Twine(FunctionHash)).str();
451 F.setName(Twine(NewFuncName));
Rong Xu0e79f7d2016-10-06 20:38:13 +0000452 GlobalAlias::create(GlobalValue::WeakAnyLinkage, OrigName, &F);
Rong Xu705f7772016-07-25 18:45:37 +0000453 FuncName = Twine(FuncName + "." + Twine(FunctionHash)).str();
454 Comdat *NewComdat;
455 Module *M = F.getParent();
456 // For AvailableExternallyLinkage functions, change the linkage to
457 // LinkOnceODR and put them into comdat. This is because after renaming, there
458 // is no backup external copy available for the function.
459 if (!F.hasComdat()) {
460 assert(F.getLinkage() == GlobalValue::AvailableExternallyLinkage);
461 NewComdat = M->getOrInsertComdat(StringRef(NewFuncName));
462 F.setLinkage(GlobalValue::LinkOnceODRLinkage);
463 F.setComdat(NewComdat);
464 return;
465 }
466
467 // This function belongs to a single function Comdat group.
468 Comdat *OrigComdat = F.getComdat();
469 std::string NewComdatName =
470 Twine(OrigComdat->getName() + "." + Twine(FunctionHash)).str();
471 NewComdat = M->getOrInsertComdat(StringRef(NewComdatName));
472 NewComdat->setSelectionKind(OrigComdat->getSelectionKind());
473
474 for (auto &&CM : make_range(ComdatMembers.equal_range(OrigComdat))) {
475 if (GlobalAlias *GA = dyn_cast<GlobalAlias>(CM.second)) {
476 // For aliases, change the name directly.
477 assert(dyn_cast<Function>(GA->getAliasee()->stripPointerCasts()) == &F);
Rong Xu0e79f7d2016-10-06 20:38:13 +0000478 std::string OrigGAName = GA->getName().str();
Rong Xu705f7772016-07-25 18:45:37 +0000479 GA->setName(Twine(GA->getName() + "." + Twine(FunctionHash)));
Rong Xu0e79f7d2016-10-06 20:38:13 +0000480 GlobalAlias::create(GlobalValue::WeakAnyLinkage, OrigGAName, GA);
Rong Xu705f7772016-07-25 18:45:37 +0000481 continue;
482 }
483 // Must be a function.
484 Function *CF = dyn_cast<Function>(CM.second);
485 assert(CF);
486 CF->setComdat(NewComdat);
487 }
Rong Xuf430ae42015-12-09 18:08:16 +0000488}
489
490// Given a CFG E to be instrumented, find which BB to place the instrumented
491// code. The function will split the critical edge if necessary.
492template <class Edge, class BBInfo>
493BasicBlock *FuncPGOInstrumentation<Edge, BBInfo>::getInstrBB(Edge *E) {
494 if (E->InMST || E->Removed)
495 return nullptr;
496
497 BasicBlock *SrcBB = const_cast<BasicBlock *>(E->SrcBB);
498 BasicBlock *DestBB = const_cast<BasicBlock *>(E->DestBB);
499 // For a fake edge, instrument the real BB.
500 if (SrcBB == nullptr)
501 return DestBB;
502 if (DestBB == nullptr)
503 return SrcBB;
504
505 // Instrument the SrcBB if it has a single successor,
506 // otherwise, the DestBB if this is not a critical edge.
507 TerminatorInst *TI = SrcBB->getTerminator();
508 if (TI->getNumSuccessors() <= 1)
509 return SrcBB;
510 if (!E->IsCritical)
511 return DestBB;
512
513 // For a critical edge, we have to split. Instrument the newly
514 // created BB.
515 NumOfPGOSplit++;
516 DEBUG(dbgs() << "Split critical edge: " << getBBInfo(SrcBB).Index << " --> "
517 << getBBInfo(DestBB).Index << "\n");
518 unsigned SuccNum = GetSuccessorNumber(SrcBB, DestBB);
519 BasicBlock *InstrBB = SplitCriticalEdge(TI, SuccNum);
520 assert(InstrBB && "Critical edge is not split");
521
522 E->Removed = true;
523 return InstrBB;
524}
525
Rong Xued9fec72016-01-21 18:11:44 +0000526// Visit all edge and instrument the edges not in MST, and do value profiling.
Rong Xuf430ae42015-12-09 18:08:16 +0000527// Critical edges will be split.
Rong Xu705f7772016-07-25 18:45:37 +0000528static void instrumentOneFunc(
529 Function &F, Module *M, BranchProbabilityInfo *BPI, BlockFrequencyInfo *BFI,
530 std::unordered_multimap<Comdat *, GlobalValue *> &ComdatMembers) {
Rong Xu705f7772016-07-25 18:45:37 +0000531 FuncPGOInstrumentation<PGOEdge, BBInfo> FuncInfo(F, ComdatMembers, true, BPI,
532 BFI);
Xinliang David Lid1197612016-08-01 20:25:06 +0000533 unsigned NumCounters = FuncInfo.getNumCounters();
534
Rong Xuf430ae42015-12-09 18:08:16 +0000535 uint32_t I = 0;
Rong Xued9fec72016-01-21 18:11:44 +0000536 Type *I8PtrTy = Type::getInt8PtrTy(M->getContext());
Rong Xuf430ae42015-12-09 18:08:16 +0000537 for (auto &E : FuncInfo.MST.AllEdges) {
538 BasicBlock *InstrBB = FuncInfo.getInstrBB(E.get());
539 if (!InstrBB)
540 continue;
541
542 IRBuilder<> Builder(InstrBB, InstrBB->getFirstInsertionPt());
543 assert(Builder.GetInsertPoint() != InstrBB->end() &&
544 "Cannot get the Instrumentation point");
Rong Xuf430ae42015-12-09 18:08:16 +0000545 Builder.CreateCall(
546 Intrinsic::getDeclaration(M, Intrinsic::instrprof_increment),
547 {llvm::ConstantExpr::getBitCast(FuncInfo.FuncNameVar, I8PtrTy),
548 Builder.getInt64(FuncInfo.FunctionHash), Builder.getInt32(NumCounters),
549 Builder.getInt32(I++)});
550 }
Xinliang David Li4ca17332016-09-18 18:34:07 +0000551
552 // Now instrument select instructions:
553 FuncInfo.SIVisitor.instrumentSelects(F, &I, NumCounters, FuncInfo.FuncNameVar,
554 FuncInfo.FunctionHash);
Xinliang David Lid1197612016-08-01 20:25:06 +0000555 assert(I == NumCounters);
Rong Xued9fec72016-01-21 18:11:44 +0000556
557 if (DisableValueProfiling)
558 return;
559
560 unsigned NumIndirectCallSites = 0;
Xinliang David Li9780fc12016-09-20 22:39:47 +0000561 for (auto &I : FuncInfo.IndirectCallSites) {
Rong Xued9fec72016-01-21 18:11:44 +0000562 CallSite CS(I);
563 Value *Callee = CS.getCalledValue();
564 DEBUG(dbgs() << "Instrument one indirect call: CallSite Index = "
565 << NumIndirectCallSites << "\n");
566 IRBuilder<> Builder(I);
567 assert(Builder.GetInsertPoint() != I->getParent()->end() &&
568 "Cannot get the Instrumentation point");
569 Builder.CreateCall(
570 Intrinsic::getDeclaration(M, Intrinsic::instrprof_value_profile),
571 {llvm::ConstantExpr::getBitCast(FuncInfo.FuncNameVar, I8PtrTy),
572 Builder.getInt64(FuncInfo.FunctionHash),
573 Builder.CreatePtrToInt(Callee, Builder.getInt64Ty()),
574 Builder.getInt32(llvm::InstrProfValueKind::IPVK_IndirectCallTarget),
575 Builder.getInt32(NumIndirectCallSites++)});
576 }
577 NumOfPGOICall += NumIndirectCallSites;
Rong Xuf430ae42015-12-09 18:08:16 +0000578}
579
580// This class represents a CFG edge in profile use compilation.
581struct PGOUseEdge : public PGOEdge {
582 bool CountValid;
583 uint64_t CountValue;
584 PGOUseEdge(const BasicBlock *Src, const BasicBlock *Dest, unsigned W = 1)
585 : PGOEdge(Src, Dest, W), CountValid(false), CountValue(0) {}
586
587 // Set edge count value
588 void setEdgeCount(uint64_t Value) {
589 CountValue = Value;
590 CountValid = true;
591 }
592
593 // Return the information string for this object.
594 const std::string infoString() const {
595 if (!CountValid)
596 return PGOEdge::infoString();
Rong Xu9e926e82016-02-29 19:16:04 +0000597 return (Twine(PGOEdge::infoString()) + " Count=" + Twine(CountValue))
598 .str();
Rong Xuf430ae42015-12-09 18:08:16 +0000599 }
600};
601
602typedef SmallVector<PGOUseEdge *, 2> DirectEdges;
603
604// This class stores the auxiliary information for each BB.
605struct UseBBInfo : public BBInfo {
606 uint64_t CountValue;
607 bool CountValid;
608 int32_t UnknownCountInEdge;
609 int32_t UnknownCountOutEdge;
610 DirectEdges InEdges;
611 DirectEdges OutEdges;
612 UseBBInfo(unsigned IX)
613 : BBInfo(IX), CountValue(0), CountValid(false), UnknownCountInEdge(0),
614 UnknownCountOutEdge(0) {}
615 UseBBInfo(unsigned IX, uint64_t C)
616 : BBInfo(IX), CountValue(C), CountValid(true), UnknownCountInEdge(0),
617 UnknownCountOutEdge(0) {}
618
619 // Set the profile count value for this BB.
620 void setBBInfoCount(uint64_t Value) {
621 CountValue = Value;
622 CountValid = true;
623 }
624
625 // Return the information string of this object.
626 const std::string infoString() const {
627 if (!CountValid)
628 return BBInfo::infoString();
629 return (Twine(BBInfo::infoString()) + " Count=" + Twine(CountValue)).str();
630 }
631};
632
633// Sum up the count values for all the edges.
634static uint64_t sumEdgeCount(const ArrayRef<PGOUseEdge *> Edges) {
635 uint64_t Total = 0;
636 for (auto &E : Edges) {
637 if (E->Removed)
638 continue;
639 Total += E->CountValue;
640 }
641 return Total;
642}
643
644class PGOUseFunc {
Rong Xu6090afd2016-03-28 17:08:56 +0000645public:
Rong Xu705f7772016-07-25 18:45:37 +0000646 PGOUseFunc(Function &Func, Module *Modu,
647 std::unordered_multimap<Comdat *, GlobalValue *> &ComdatMembers,
648 BranchProbabilityInfo *BPI = nullptr,
Rong Xu6090afd2016-03-28 17:08:56 +0000649 BlockFrequencyInfo *BFI = nullptr)
Rong Xu705f7772016-07-25 18:45:37 +0000650 : F(Func), M(Modu), FuncInfo(Func, ComdatMembers, false, BPI, BFI),
Rong Xu33308f92016-10-25 21:47:24 +0000651 CountPosition(0), ProfileCountSize(0), FreqAttr(FFA_Normal) {}
Rong Xu6090afd2016-03-28 17:08:56 +0000652
653 // Read counts for the instrumented BB from profile.
654 bool readCounters(IndexedInstrProfReader *PGOReader);
655
656 // Populate the counts for all BBs.
657 void populateCounters();
658
659 // Set the branch weights based on the count values.
660 void setBranchWeights();
661
662 // Annotate the indirect call sites.
663 void annotateIndirectCallSites();
664
Sean Silva9dd4b5c2016-05-28 03:56:25 +0000665 // The hotness of the function from the profile count.
666 enum FuncFreqAttr { FFA_Normal, FFA_Cold, FFA_Hot };
667
668 // Return the function hotness from the profile.
669 FuncFreqAttr getFuncFreqAttr() const { return FreqAttr; }
670
Rong Xu705f7772016-07-25 18:45:37 +0000671 // Return the function hash.
672 uint64_t getFuncHash() const { return FuncInfo.FunctionHash; }
Easwaran Raman5fe04a12016-05-26 22:57:11 +0000673 // Return the profile record for this function;
674 InstrProfRecord &getProfileRecord() { return ProfileRecord; }
675
Xinliang David Li4ca17332016-09-18 18:34:07 +0000676 // Return the auxiliary BB information.
677 UseBBInfo &getBBInfo(const BasicBlock *BB) const {
678 return FuncInfo.getBBInfo(BB);
679 }
680
Rong Xua5b57452016-12-02 19:10:29 +0000681 // Return the auxiliary BB information if available.
682 UseBBInfo *findBBInfo(const BasicBlock *BB) const {
683 return FuncInfo.findBBInfo(BB);
684 }
685
Rong Xuf430ae42015-12-09 18:08:16 +0000686private:
687 Function &F;
688 Module *M;
689 // This member stores the shared information with class PGOGenFunc.
690 FuncPGOInstrumentation<PGOUseEdge, UseBBInfo> FuncInfo;
691
Sean Silva9dd4b5c2016-05-28 03:56:25 +0000692 // The maximum count value in the profile. This is only used in PGO use
693 // compilation.
694 uint64_t ProgramMaxCount;
695
Rong Xu33308f92016-10-25 21:47:24 +0000696 // Position of counter that remains to be read.
697 uint32_t CountPosition;
698
699 // Total size of the profile count for this function.
700 uint32_t ProfileCountSize;
701
Rong Xu13b01dc2016-02-10 18:24:45 +0000702 // ProfileRecord for this function.
703 InstrProfRecord ProfileRecord;
704
Sean Silva9dd4b5c2016-05-28 03:56:25 +0000705 // Function hotness info derived from profile.
706 FuncFreqAttr FreqAttr;
707
Rong Xuf430ae42015-12-09 18:08:16 +0000708 // Find the Instrumented BB and set the value.
709 void setInstrumentedCounts(const std::vector<uint64_t> &CountFromProfile);
710
711 // Set the edge counter value for the unknown edge -- there should be only
712 // one unknown edge.
713 void setEdgeCount(DirectEdges &Edges, uint64_t Value);
714
715 // Return FuncName string;
716 const std::string getFuncName() const { return FuncInfo.FuncName; }
Sean Silva9dd4b5c2016-05-28 03:56:25 +0000717
718 // Set the hot/cold inline hints based on the count values.
719 // FIXME: This function should be removed once the functionality in
720 // the inliner is implemented.
721 void markFunctionAttributes(uint64_t EntryCount, uint64_t MaxCount) {
722 if (ProgramMaxCount == 0)
723 return;
724 // Threshold of the hot functions.
725 const BranchProbability HotFunctionThreshold(1, 100);
726 // Threshold of the cold functions.
727 const BranchProbability ColdFunctionThreshold(2, 10000);
728 if (EntryCount >= HotFunctionThreshold.scale(ProgramMaxCount))
729 FreqAttr = FFA_Hot;
730 else if (MaxCount <= ColdFunctionThreshold.scale(ProgramMaxCount))
731 FreqAttr = FFA_Cold;
732 }
Rong Xuf430ae42015-12-09 18:08:16 +0000733};
734
735// Visit all the edges and assign the count value for the instrumented
736// edges and the BB.
737void PGOUseFunc::setInstrumentedCounts(
738 const std::vector<uint64_t> &CountFromProfile) {
739
Xinliang David Lid1197612016-08-01 20:25:06 +0000740 assert(FuncInfo.getNumCounters() == CountFromProfile.size());
Rong Xuf430ae42015-12-09 18:08:16 +0000741 // Use a worklist as we will update the vector during the iteration.
742 std::vector<PGOUseEdge *> WorkList;
743 for (auto &E : FuncInfo.MST.AllEdges)
744 WorkList.push_back(E.get());
745
746 uint32_t I = 0;
747 for (auto &E : WorkList) {
748 BasicBlock *InstrBB = FuncInfo.getInstrBB(E);
749 if (!InstrBB)
750 continue;
751 uint64_t CountValue = CountFromProfile[I++];
752 if (!E->Removed) {
753 getBBInfo(InstrBB).setBBInfoCount(CountValue);
754 E->setEdgeCount(CountValue);
755 continue;
756 }
757
758 // Need to add two new edges.
759 BasicBlock *SrcBB = const_cast<BasicBlock *>(E->SrcBB);
760 BasicBlock *DestBB = const_cast<BasicBlock *>(E->DestBB);
761 // Add new edge of SrcBB->InstrBB.
762 PGOUseEdge &NewEdge = FuncInfo.MST.addEdge(SrcBB, InstrBB, 0);
763 NewEdge.setEdgeCount(CountValue);
764 // Add new edge of InstrBB->DestBB.
765 PGOUseEdge &NewEdge1 = FuncInfo.MST.addEdge(InstrBB, DestBB, 0);
766 NewEdge1.setEdgeCount(CountValue);
767 NewEdge1.InMST = true;
768 getBBInfo(InstrBB).setBBInfoCount(CountValue);
769 }
Rong Xu33308f92016-10-25 21:47:24 +0000770 ProfileCountSize = CountFromProfile.size();
771 CountPosition = I;
Rong Xuf430ae42015-12-09 18:08:16 +0000772}
773
774// Set the count value for the unknown edge. There should be one and only one
775// unknown edge in Edges vector.
776void PGOUseFunc::setEdgeCount(DirectEdges &Edges, uint64_t Value) {
777 for (auto &E : Edges) {
778 if (E->CountValid)
779 continue;
780 E->setEdgeCount(Value);
781
782 getBBInfo(E->SrcBB).UnknownCountOutEdge--;
783 getBBInfo(E->DestBB).UnknownCountInEdge--;
784 return;
785 }
786 llvm_unreachable("Cannot find the unknown count edge");
787}
788
789// Read the profile from ProfileFileName and assign the value to the
790// instrumented BB and the edges. This function also updates ProgramMaxCount.
791// Return true if the profile are successfully read, and false on errors.
792bool PGOUseFunc::readCounters(IndexedInstrProfReader *PGOReader) {
793 auto &Ctx = M->getContext();
Vedant Kumar9152fd12016-05-19 03:54:45 +0000794 Expected<InstrProfRecord> Result =
Rong Xuf430ae42015-12-09 18:08:16 +0000795 PGOReader->getInstrProfRecord(FuncInfo.FuncName, FuncInfo.FunctionHash);
Vedant Kumar9152fd12016-05-19 03:54:45 +0000796 if (Error E = Result.takeError()) {
797 handleAllErrors(std::move(E), [&](const InstrProfError &IPE) {
798 auto Err = IPE.get();
799 bool SkipWarning = false;
800 if (Err == instrprof_error::unknown_function) {
801 NumOfPGOMissing++;
Xinliang David Li76a01082016-08-11 05:09:30 +0000802 SkipWarning = !PGOWarnMissing;
Vedant Kumar9152fd12016-05-19 03:54:45 +0000803 } else if (Err == instrprof_error::hash_mismatch ||
804 Err == instrprof_error::malformed) {
805 NumOfPGOMismatch++;
806 SkipWarning = NoPGOWarnMismatch;
807 }
Rong Xuf430ae42015-12-09 18:08:16 +0000808
Vedant Kumar9152fd12016-05-19 03:54:45 +0000809 if (SkipWarning)
810 return;
811
812 std::string Msg = IPE.message() + std::string(" ") + F.getName().str();
813 Ctx.diagnose(
814 DiagnosticInfoPGOProfile(M->getName().data(), Msg, DS_Warning));
815 });
Rong Xuf430ae42015-12-09 18:08:16 +0000816 return false;
817 }
Rong Xu13b01dc2016-02-10 18:24:45 +0000818 ProfileRecord = std::move(Result.get());
819 std::vector<uint64_t> &CountFromProfile = ProfileRecord.Counts;
Rong Xuf430ae42015-12-09 18:08:16 +0000820
821 NumOfPGOFunc++;
822 DEBUG(dbgs() << CountFromProfile.size() << " counts\n");
823 uint64_t ValueSum = 0;
824 for (unsigned I = 0, S = CountFromProfile.size(); I < S; I++) {
825 DEBUG(dbgs() << " " << I << ": " << CountFromProfile[I] << "\n");
826 ValueSum += CountFromProfile[I];
827 }
828
829 DEBUG(dbgs() << "SUM = " << ValueSum << "\n");
830
831 getBBInfo(nullptr).UnknownCountOutEdge = 2;
832 getBBInfo(nullptr).UnknownCountInEdge = 2;
833
834 setInstrumentedCounts(CountFromProfile);
Sean Silva9dd4b5c2016-05-28 03:56:25 +0000835 ProgramMaxCount = PGOReader->getMaximumFunctionCount();
Rong Xuf430ae42015-12-09 18:08:16 +0000836 return true;
837}
838
839// Populate the counters from instrumented BBs to all BBs.
840// In the end of this operation, all BBs should have a valid count value.
841void PGOUseFunc::populateCounters() {
842 // First set up Count variable for all BBs.
843 for (auto &E : FuncInfo.MST.AllEdges) {
844 if (E->Removed)
845 continue;
846
847 const BasicBlock *SrcBB = E->SrcBB;
848 const BasicBlock *DestBB = E->DestBB;
849 UseBBInfo &SrcInfo = getBBInfo(SrcBB);
850 UseBBInfo &DestInfo = getBBInfo(DestBB);
851 SrcInfo.OutEdges.push_back(E.get());
852 DestInfo.InEdges.push_back(E.get());
853 SrcInfo.UnknownCountOutEdge++;
854 DestInfo.UnknownCountInEdge++;
855
856 if (!E->CountValid)
857 continue;
858 DestInfo.UnknownCountInEdge--;
859 SrcInfo.UnknownCountOutEdge--;
860 }
861
862 bool Changes = true;
863 unsigned NumPasses = 0;
864 while (Changes) {
865 NumPasses++;
866 Changes = false;
867
868 // For efficient traversal, it's better to start from the end as most
869 // of the instrumented edges are at the end.
870 for (auto &BB : reverse(F)) {
Rong Xua5b57452016-12-02 19:10:29 +0000871 UseBBInfo *Count = findBBInfo(&BB);
872 if (Count == nullptr)
873 continue;
874 if (!Count->CountValid) {
875 if (Count->UnknownCountOutEdge == 0) {
876 Count->CountValue = sumEdgeCount(Count->OutEdges);
877 Count->CountValid = true;
Rong Xuf430ae42015-12-09 18:08:16 +0000878 Changes = true;
Rong Xua5b57452016-12-02 19:10:29 +0000879 } else if (Count->UnknownCountInEdge == 0) {
880 Count->CountValue = sumEdgeCount(Count->InEdges);
881 Count->CountValid = true;
Rong Xuf430ae42015-12-09 18:08:16 +0000882 Changes = true;
883 }
884 }
Rong Xua5b57452016-12-02 19:10:29 +0000885 if (Count->CountValid) {
886 if (Count->UnknownCountOutEdge == 1) {
887 uint64_t Total = Count->CountValue - sumEdgeCount(Count->OutEdges);
888 setEdgeCount(Count->OutEdges, Total);
Rong Xuf430ae42015-12-09 18:08:16 +0000889 Changes = true;
890 }
Rong Xua5b57452016-12-02 19:10:29 +0000891 if (Count->UnknownCountInEdge == 1) {
892 uint64_t Total = Count->CountValue - sumEdgeCount(Count->InEdges);
893 setEdgeCount(Count->InEdges, Total);
Rong Xuf430ae42015-12-09 18:08:16 +0000894 Changes = true;
895 }
896 }
897 }
898 }
899
900 DEBUG(dbgs() << "Populate counts in " << NumPasses << " passes.\n");
Sean Silva8c7e1212016-05-28 04:19:45 +0000901#ifndef NDEBUG
Sean Silva9dd4b5c2016-05-28 03:56:25 +0000902 // Assert every BB has a valid counter.
Rong Xua5b57452016-12-02 19:10:29 +0000903 for (auto &BB : F) {
904 auto BI = findBBInfo(&BB);
905 if (BI == nullptr)
906 continue;
907 assert(BI->CountValid && "BB count is not valid");
908 }
Sean Silva8c7e1212016-05-28 04:19:45 +0000909#endif
Sean Silva9dd4b5c2016-05-28 03:56:25 +0000910 uint64_t FuncEntryCount = getBBInfo(&*F.begin()).CountValue;
Sean Silva02b9d892016-05-28 04:05:36 +0000911 F.setEntryCount(FuncEntryCount);
Sean Silva9dd4b5c2016-05-28 03:56:25 +0000912 uint64_t FuncMaxCount = FuncEntryCount;
Rong Xua5b57452016-12-02 19:10:29 +0000913 for (auto &BB : F) {
914 auto BI = findBBInfo(&BB);
915 if (BI == nullptr)
916 continue;
917 FuncMaxCount = std::max(FuncMaxCount, BI->CountValue);
918 }
Sean Silva9dd4b5c2016-05-28 03:56:25 +0000919 markFunctionAttributes(FuncEntryCount, FuncMaxCount);
Rong Xuf430ae42015-12-09 18:08:16 +0000920
Rong Xu33308f92016-10-25 21:47:24 +0000921 // Now annotate select instructions
922 FuncInfo.SIVisitor.annotateSelects(F, this, &CountPosition);
923 assert(CountPosition == ProfileCountSize);
924
Rong Xuf430ae42015-12-09 18:08:16 +0000925 DEBUG(FuncInfo.dumpInfo("after reading profile."));
926}
927
Xinliang David Li4ca17332016-09-18 18:34:07 +0000928static void setProfMetadata(Module *M, Instruction *TI,
Xinliang David Li63248ab2016-08-19 06:31:45 +0000929 ArrayRef<uint64_t> EdgeCounts, uint64_t MaxCount) {
Xinliang David Li2c933682016-08-19 05:31:33 +0000930 MDBuilder MDB(M->getContext());
931 assert(MaxCount > 0 && "Bad max count");
932 uint64_t Scale = calculateCountScale(MaxCount);
933 SmallVector<unsigned, 4> Weights;
934 for (const auto &ECI : EdgeCounts)
935 Weights.push_back(scaleBranchCount(ECI, Scale));
936
937 DEBUG(dbgs() << "Weight is: ";
938 for (const auto &W : Weights) { dbgs() << W << " "; }
939 dbgs() << "\n";);
940 TI->setMetadata(llvm::LLVMContext::MD_prof, MDB.createBranchWeights(Weights));
941}
942
Rong Xuf430ae42015-12-09 18:08:16 +0000943// Assign the scaled count values to the BB with multiple out edges.
944void PGOUseFunc::setBranchWeights() {
945 // Generate MD_prof metadata for every branch instruction.
946 DEBUG(dbgs() << "\nSetting branch weights.\n");
Rong Xuf430ae42015-12-09 18:08:16 +0000947 for (auto &BB : F) {
948 TerminatorInst *TI = BB.getTerminator();
949 if (TI->getNumSuccessors() < 2)
950 continue;
951 if (!isa<BranchInst>(TI) && !isa<SwitchInst>(TI))
952 continue;
953 if (getBBInfo(&BB).CountValue == 0)
954 continue;
955
956 // We have a non-zero Branch BB.
957 const UseBBInfo &BBCountInfo = getBBInfo(&BB);
958 unsigned Size = BBCountInfo.OutEdges.size();
Xinliang David Li63248ab2016-08-19 06:31:45 +0000959 SmallVector<uint64_t, 2> EdgeCounts(Size, 0);
Rong Xuf430ae42015-12-09 18:08:16 +0000960 uint64_t MaxCount = 0;
961 for (unsigned s = 0; s < Size; s++) {
962 const PGOUseEdge *E = BBCountInfo.OutEdges[s];
963 const BasicBlock *SrcBB = E->SrcBB;
964 const BasicBlock *DestBB = E->DestBB;
Eugene Zelenko6ac3f732016-01-26 18:48:36 +0000965 if (DestBB == nullptr)
Rong Xuf430ae42015-12-09 18:08:16 +0000966 continue;
967 unsigned SuccNum = GetSuccessorNumber(SrcBB, DestBB);
968 uint64_t EdgeCount = E->CountValue;
969 if (EdgeCount > MaxCount)
970 MaxCount = EdgeCount;
971 EdgeCounts[SuccNum] = EdgeCount;
972 }
Xinliang David Li2c933682016-08-19 05:31:33 +0000973 setProfMetadata(M, TI, EdgeCounts, MaxCount);
Rong Xuf430ae42015-12-09 18:08:16 +0000974 }
975}
Rong Xu13b01dc2016-02-10 18:24:45 +0000976
Xinliang David Li4ca17332016-09-18 18:34:07 +0000977void SelectInstVisitor::instrumentOneSelectInst(SelectInst &SI) {
978 Module *M = F.getParent();
979 IRBuilder<> Builder(&SI);
980 Type *Int64Ty = Builder.getInt64Ty();
981 Type *I8PtrTy = Builder.getInt8PtrTy();
982 auto *Step = Builder.CreateZExt(SI.getCondition(), Int64Ty);
983 Builder.CreateCall(
984 Intrinsic::getDeclaration(M, Intrinsic::instrprof_increment_step),
985 {llvm::ConstantExpr::getBitCast(FuncNameVar, I8PtrTy),
986 Builder.getInt64(FuncHash),
987 Builder.getInt32(TotalNumCtrs), Builder.getInt32(*CurCtrIdx), Step});
988 ++(*CurCtrIdx);
989}
990
991void SelectInstVisitor::annotateOneSelectInst(SelectInst &SI) {
992 std::vector<uint64_t> &CountFromProfile = UseFunc->getProfileRecord().Counts;
993 assert(*CurCtrIdx < CountFromProfile.size() &&
994 "Out of bound access of counters");
995 uint64_t SCounts[2];
996 SCounts[0] = CountFromProfile[*CurCtrIdx]; // True count
997 ++(*CurCtrIdx);
Rong Xua5b57452016-12-02 19:10:29 +0000998 uint64_t TotalCount = 0;
999 auto BI = UseFunc->findBBInfo(SI.getParent());
1000 if (BI != nullptr)
1001 TotalCount = BI->CountValue;
Xinliang David Li4ca17332016-09-18 18:34:07 +00001002 // False Count
1003 SCounts[1] = (TotalCount > SCounts[0] ? TotalCount - SCounts[0] : 0);
1004 uint64_t MaxCount = std::max(SCounts[0], SCounts[1]);
Xinliang David Lic7368282016-09-20 20:20:01 +00001005 if (MaxCount)
1006 setProfMetadata(F.getParent(), &SI, SCounts, MaxCount);
Xinliang David Li4ca17332016-09-18 18:34:07 +00001007}
1008
1009void SelectInstVisitor::visitSelectInst(SelectInst &SI) {
1010 if (!PGOInstrSelect)
1011 return;
1012 // FIXME: do not handle this yet.
1013 if (SI.getCondition()->getType()->isVectorTy())
1014 return;
1015
1016 NSIs++;
1017 switch (Mode) {
1018 case VM_counting:
1019 return;
1020 case VM_instrument:
1021 instrumentOneSelectInst(SI);
Simon Pilgrimf33a6b72016-09-18 21:08:35 +00001022 return;
Xinliang David Li4ca17332016-09-18 18:34:07 +00001023 case VM_annotate:
1024 annotateOneSelectInst(SI);
Simon Pilgrimf33a6b72016-09-18 21:08:35 +00001025 return;
Xinliang David Li4ca17332016-09-18 18:34:07 +00001026 }
Simon Pilgrimf33a6b72016-09-18 21:08:35 +00001027
1028 llvm_unreachable("Unknown visiting mode");
Xinliang David Li4ca17332016-09-18 18:34:07 +00001029}
1030
Rong Xu13b01dc2016-02-10 18:24:45 +00001031// Traverse all the indirect callsites and annotate the instructions.
1032void PGOUseFunc::annotateIndirectCallSites() {
1033 if (DisableValueProfiling)
1034 return;
1035
Rong Xu8e8fe852016-04-01 16:43:30 +00001036 // Create the PGOFuncName meta data.
Rong Xuf8f051c2016-04-22 21:00:17 +00001037 createPGOFuncNameMetadata(F, FuncInfo.FuncName);
Rong Xub5341662016-03-30 18:37:52 +00001038
Rong Xu13b01dc2016-02-10 18:24:45 +00001039 unsigned IndirectCallSiteIndex = 0;
Xinliang David Li9780fc12016-09-20 22:39:47 +00001040 auto &IndirectCallSites = FuncInfo.IndirectCallSites;
Rong Xu9e926e82016-02-29 19:16:04 +00001041 unsigned NumValueSites =
Rong Xu13b01dc2016-02-10 18:24:45 +00001042 ProfileRecord.getNumValueSites(IPVK_IndirectCallTarget);
Rong Xu0eb36032016-04-01 23:16:44 +00001043 if (NumValueSites != IndirectCallSites.size()) {
Rong Xu13b01dc2016-02-10 18:24:45 +00001044 std::string Msg =
1045 std::string("Inconsistent number of indirect call sites: ") +
Rong Xu9e926e82016-02-29 19:16:04 +00001046 F.getName().str();
Rong Xu13b01dc2016-02-10 18:24:45 +00001047 auto &Ctx = M->getContext();
1048 Ctx.diagnose(
1049 DiagnosticInfoPGOProfile(M->getName().data(), Msg, DS_Warning));
1050 return;
1051 }
1052
Rong Xu0eb36032016-04-01 23:16:44 +00001053 for (auto &I : IndirectCallSites) {
Rong Xu13b01dc2016-02-10 18:24:45 +00001054 DEBUG(dbgs() << "Read one indirect call instrumentation: Index="
Rong Xu9e926e82016-02-29 19:16:04 +00001055 << IndirectCallSiteIndex << " out of " << NumValueSites
1056 << "\n");
Rong Xu13b01dc2016-02-10 18:24:45 +00001057 annotateValueSite(*M, *I, ProfileRecord, IPVK_IndirectCallTarget,
Rong Xuecdc98f2016-03-04 22:08:44 +00001058 IndirectCallSiteIndex, MaxNumAnnotations);
Rong Xu13b01dc2016-02-10 18:24:45 +00001059 IndirectCallSiteIndex++;
1060 }
1061}
Rong Xuf430ae42015-12-09 18:08:16 +00001062} // end anonymous namespace
1063
Xinliang David Lid382e9d2016-07-22 04:46:56 +00001064// Create a COMDAT variable INSTR_PROF_RAW_VERSION_VAR to make the runtime
Rong Xu33c76c02016-02-10 17:18:30 +00001065// aware this is an ir_level profile so it can set the version flag.
1066static void createIRLevelProfileFlagVariable(Module &M) {
1067 Type *IntTy64 = Type::getInt64Ty(M.getContext());
1068 uint64_t ProfileVersion = (INSTR_PROF_RAW_VERSION | VARIANT_MASK_IR_PROF);
Rong Xu9e926e82016-02-29 19:16:04 +00001069 auto IRLevelVersionVariable = new GlobalVariable(
1070 M, IntTy64, true, GlobalVariable::ExternalLinkage,
1071 Constant::getIntegerValue(IntTy64, APInt(64, ProfileVersion)),
Xinliang David Lid382e9d2016-07-22 04:46:56 +00001072 INSTR_PROF_QUOTE(INSTR_PROF_RAW_VERSION_VAR));
Rong Xu33c76c02016-02-10 17:18:30 +00001073 IRLevelVersionVariable->setVisibility(GlobalValue::DefaultVisibility);
1074 Triple TT(M.getTargetTriple());
Xinliang David Li11c849c2016-05-27 16:22:03 +00001075 if (!TT.supportsCOMDAT())
Rong Xuca28a0a2016-05-11 00:31:59 +00001076 IRLevelVersionVariable->setLinkage(GlobalValue::WeakAnyLinkage);
Rong Xu33c76c02016-02-10 17:18:30 +00001077 else
Rong Xu9e926e82016-02-29 19:16:04 +00001078 IRLevelVersionVariable->setComdat(M.getOrInsertComdat(
Xinliang David Lid382e9d2016-07-22 04:46:56 +00001079 StringRef(INSTR_PROF_QUOTE(INSTR_PROF_RAW_VERSION_VAR))));
Rong Xu33c76c02016-02-10 17:18:30 +00001080}
1081
Rong Xu705f7772016-07-25 18:45:37 +00001082// Collect the set of members for each Comdat in module M and store
1083// in ComdatMembers.
1084static void collectComdatMembers(
1085 Module &M,
1086 std::unordered_multimap<Comdat *, GlobalValue *> &ComdatMembers) {
1087 if (!DoComdatRenaming)
1088 return;
1089 for (Function &F : M)
1090 if (Comdat *C = F.getComdat())
1091 ComdatMembers.insert(std::make_pair(C, &F));
1092 for (GlobalVariable &GV : M.globals())
1093 if (Comdat *C = GV.getComdat())
1094 ComdatMembers.insert(std::make_pair(C, &GV));
1095 for (GlobalAlias &GA : M.aliases())
1096 if (Comdat *C = GA.getComdat())
1097 ComdatMembers.insert(std::make_pair(C, &GA));
1098}
1099
Xinliang David Li5ad7c822016-05-02 20:33:59 +00001100static bool InstrumentAllFunctions(
Xinliang David Lidfa21c32016-05-09 21:37:12 +00001101 Module &M, function_ref<BranchProbabilityInfo *(Function &)> LookupBPI,
1102 function_ref<BlockFrequencyInfo *(Function &)> LookupBFI) {
Rong Xu33c76c02016-02-10 17:18:30 +00001103 createIRLevelProfileFlagVariable(M);
Rong Xu705f7772016-07-25 18:45:37 +00001104 std::unordered_multimap<Comdat *, GlobalValue *> ComdatMembers;
1105 collectComdatMembers(M, ComdatMembers);
1106
Rong Xuf430ae42015-12-09 18:08:16 +00001107 for (auto &F : M) {
1108 if (F.isDeclaration())
1109 continue;
Xinliang David Lidfa21c32016-05-09 21:37:12 +00001110 auto *BPI = LookupBPI(F);
1111 auto *BFI = LookupBFI(F);
Rong Xu705f7772016-07-25 18:45:37 +00001112 instrumentOneFunc(F, &M, BPI, BFI, ComdatMembers);
Rong Xuf430ae42015-12-09 18:08:16 +00001113 }
1114 return true;
1115}
1116
Xinliang David Li8aebf442016-05-06 05:49:19 +00001117bool PGOInstrumentationGenLegacyPass::runOnModule(Module &M) {
Xinliang David Li5ad7c822016-05-02 20:33:59 +00001118 if (skipModule(M))
1119 return false;
1120
Xinliang David Lidfa21c32016-05-09 21:37:12 +00001121 auto LookupBPI = [this](Function &F) {
1122 return &this->getAnalysis<BranchProbabilityInfoWrapperPass>(F).getBPI();
Xinliang David Li5ad7c822016-05-02 20:33:59 +00001123 };
Xinliang David Lidfa21c32016-05-09 21:37:12 +00001124 auto LookupBFI = [this](Function &F) {
1125 return &this->getAnalysis<BlockFrequencyInfoWrapperPass>(F).getBFI();
Xinliang David Li5ad7c822016-05-02 20:33:59 +00001126 };
1127 return InstrumentAllFunctions(M, LookupBPI, LookupBFI);
1128}
1129
Xinliang David Li8aebf442016-05-06 05:49:19 +00001130PreservedAnalyses PGOInstrumentationGen::run(Module &M,
Sean Silvafd03ac62016-08-09 00:28:38 +00001131 ModuleAnalysisManager &AM) {
Xinliang David Li8aebf442016-05-06 05:49:19 +00001132
1133 auto &FAM = AM.getResult<FunctionAnalysisManagerModuleProxy>(M).getManager();
Xinliang David Lidfa21c32016-05-09 21:37:12 +00001134 auto LookupBPI = [&FAM](Function &F) {
1135 return &FAM.getResult<BranchProbabilityAnalysis>(F);
Xinliang David Li8aebf442016-05-06 05:49:19 +00001136 };
1137
Xinliang David Lidfa21c32016-05-09 21:37:12 +00001138 auto LookupBFI = [&FAM](Function &F) {
1139 return &FAM.getResult<BlockFrequencyAnalysis>(F);
Xinliang David Li8aebf442016-05-06 05:49:19 +00001140 };
1141
1142 if (!InstrumentAllFunctions(M, LookupBPI, LookupBFI))
1143 return PreservedAnalyses::all();
1144
1145 return PreservedAnalyses::none();
1146}
1147
Xinliang David Lida195582016-05-10 21:59:52 +00001148static bool annotateAllFunctions(
1149 Module &M, StringRef ProfileFileName,
1150 function_ref<BranchProbabilityInfo *(Function &)> LookupBPI,
Xinliang David Lidfa21c32016-05-09 21:37:12 +00001151 function_ref<BlockFrequencyInfo *(Function &)> LookupBFI) {
Rong Xuf430ae42015-12-09 18:08:16 +00001152 DEBUG(dbgs() << "Read in profile counters: ");
1153 auto &Ctx = M.getContext();
1154 // Read the counter array from file.
1155 auto ReaderOrErr = IndexedInstrProfReader::create(ProfileFileName);
Vedant Kumar9152fd12016-05-19 03:54:45 +00001156 if (Error E = ReaderOrErr.takeError()) {
1157 handleAllErrors(std::move(E), [&](const ErrorInfoBase &EI) {
1158 Ctx.diagnose(
1159 DiagnosticInfoPGOProfile(ProfileFileName.data(), EI.message()));
1160 });
Rong Xuf430ae42015-12-09 18:08:16 +00001161 return false;
1162 }
1163
Xinliang David Lida195582016-05-10 21:59:52 +00001164 std::unique_ptr<IndexedInstrProfReader> PGOReader =
1165 std::move(ReaderOrErr.get());
Rong Xuf430ae42015-12-09 18:08:16 +00001166 if (!PGOReader) {
1167 Ctx.diagnose(DiagnosticInfoPGOProfile(ProfileFileName.data(),
Xinliang David Lida195582016-05-10 21:59:52 +00001168 StringRef("Cannot get PGOReader")));
Rong Xuf430ae42015-12-09 18:08:16 +00001169 return false;
1170 }
Rong Xu33c76c02016-02-10 17:18:30 +00001171 // TODO: might need to change the warning once the clang option is finalized.
1172 if (!PGOReader->isIRLevelProfile()) {
1173 Ctx.diagnose(DiagnosticInfoPGOProfile(
1174 ProfileFileName.data(), "Not an IR level instrumentation profile"));
1175 return false;
1176 }
1177
Rong Xu705f7772016-07-25 18:45:37 +00001178 std::unordered_multimap<Comdat *, GlobalValue *> ComdatMembers;
1179 collectComdatMembers(M, ComdatMembers);
Rong Xu6090afd2016-03-28 17:08:56 +00001180 std::vector<Function *> HotFunctions;
1181 std::vector<Function *> ColdFunctions;
Rong Xuf430ae42015-12-09 18:08:16 +00001182 for (auto &F : M) {
1183 if (F.isDeclaration())
1184 continue;
Xinliang David Lidfa21c32016-05-09 21:37:12 +00001185 auto *BPI = LookupBPI(F);
1186 auto *BFI = LookupBFI(F);
Rong Xu705f7772016-07-25 18:45:37 +00001187 PGOUseFunc Func(F, &M, ComdatMembers, BPI, BFI);
Sean Silva2e8f0952016-05-28 04:19:40 +00001188 if (!Func.readCounters(PGOReader.get()))
1189 continue;
1190 Func.populateCounters();
1191 Func.setBranchWeights();
1192 Func.annotateIndirectCallSites();
Sean Silva9dd4b5c2016-05-28 03:56:25 +00001193 PGOUseFunc::FuncFreqAttr FreqAttr = Func.getFuncFreqAttr();
1194 if (FreqAttr == PGOUseFunc::FFA_Cold)
Sean Silva2a730192016-05-28 03:02:50 +00001195 ColdFunctions.push_back(&F);
Sean Silva9dd4b5c2016-05-28 03:56:25 +00001196 else if (FreqAttr == PGOUseFunc::FFA_Hot)
1197 HotFunctions.push_back(&F);
Rong Xuf430ae42015-12-09 18:08:16 +00001198 }
Easwaran Raman8bceb9d2016-06-21 19:29:49 +00001199 M.setProfileSummary(PGOReader->getSummary().getMD(M.getContext()));
Rong Xu6090afd2016-03-28 17:08:56 +00001200 // Set function hotness attribute from the profile.
Sean Silva42cc3422016-05-28 04:24:39 +00001201 // We have to apply these attributes at the end because their presence
1202 // can affect the BranchProbabilityInfo of any callers, resulting in an
1203 // inconsistent MST between prof-gen and prof-use.
Rong Xu6090afd2016-03-28 17:08:56 +00001204 for (auto &F : HotFunctions) {
1205 F->addFnAttr(llvm::Attribute::InlineHint);
1206 DEBUG(dbgs() << "Set inline attribute to function: " << F->getName()
1207 << "\n");
1208 }
1209 for (auto &F : ColdFunctions) {
1210 F->addFnAttr(llvm::Attribute::Cold);
1211 DEBUG(dbgs() << "Set cold attribute to function: " << F->getName() << "\n");
1212 }
Rong Xuf430ae42015-12-09 18:08:16 +00001213 return true;
1214}
Xinliang David Lid55827f2016-05-07 05:39:12 +00001215
Xinliang David Lida195582016-05-10 21:59:52 +00001216PGOInstrumentationUse::PGOInstrumentationUse(std::string Filename)
Benjamin Kramer82de7d32016-05-27 14:27:24 +00001217 : ProfileFileName(std::move(Filename)) {
Xinliang David Lida195582016-05-10 21:59:52 +00001218 if (!PGOTestProfileFile.empty())
1219 ProfileFileName = PGOTestProfileFile;
1220}
1221
1222PreservedAnalyses PGOInstrumentationUse::run(Module &M,
Sean Silvafd03ac62016-08-09 00:28:38 +00001223 ModuleAnalysisManager &AM) {
Xinliang David Lida195582016-05-10 21:59:52 +00001224
1225 auto &FAM = AM.getResult<FunctionAnalysisManagerModuleProxy>(M).getManager();
1226 auto LookupBPI = [&FAM](Function &F) {
1227 return &FAM.getResult<BranchProbabilityAnalysis>(F);
1228 };
1229
1230 auto LookupBFI = [&FAM](Function &F) {
1231 return &FAM.getResult<BlockFrequencyAnalysis>(F);
1232 };
1233
1234 if (!annotateAllFunctions(M, ProfileFileName, LookupBPI, LookupBFI))
1235 return PreservedAnalyses::all();
1236
1237 return PreservedAnalyses::none();
1238}
1239
Xinliang David Lid55827f2016-05-07 05:39:12 +00001240bool PGOInstrumentationUseLegacyPass::runOnModule(Module &M) {
1241 if (skipModule(M))
1242 return false;
1243
Xinliang David Lidfa21c32016-05-09 21:37:12 +00001244 auto LookupBPI = [this](Function &F) {
1245 return &this->getAnalysis<BranchProbabilityInfoWrapperPass>(F).getBPI();
Xinliang David Lid55827f2016-05-07 05:39:12 +00001246 };
Xinliang David Lidfa21c32016-05-09 21:37:12 +00001247 auto LookupBFI = [this](Function &F) {
1248 return &this->getAnalysis<BlockFrequencyInfoWrapperPass>(F).getBFI();
Xinliang David Lid55827f2016-05-07 05:39:12 +00001249 };
1250
Xinliang David Lida195582016-05-10 21:59:52 +00001251 return annotateAllFunctions(M, ProfileFileName, LookupBPI, LookupBFI);
Xinliang David Lid55827f2016-05-07 05:39:12 +00001252}