1 //===- LoopInterchange.cpp - Loop interchange pass------------------------===//
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 handles loop interchange transform.
11 // This pass interchanges loops to provide a more cache-friendly memory access
12 // patterns.
13 //
14 //===----------------------------------------------------------------------===//
15
16 #include "llvm/ADT/SmallVector.h"
17 #include "llvm/Analysis/AliasAnalysis.h"
18 #include "llvm/Analysis/AssumptionCache.h"
19 #include "llvm/Analysis/BlockFrequencyInfo.h"
20 #include "llvm/Analysis/CodeMetrics.h"
21 #include "llvm/Analysis/DependenceAnalysis.h"
22 #include "llvm/Analysis/LoopInfo.h"
23 #include "llvm/Analysis/LoopIterator.h"
24 #include "llvm/Analysis/LoopPass.h"
25 #include "llvm/Analysis/ScalarEvolution.h"
26 #include "llvm/Analysis/ScalarEvolutionExpander.h"
27 #include "llvm/Analysis/ScalarEvolutionExpressions.h"
28 #include "llvm/Analysis/TargetTransformInfo.h"
29 #include "llvm/Analysis/ValueTracking.h"
30 #include "llvm/IR/Dominators.h"
31 #include "llvm/IR/Function.h"
32 #include "llvm/IR/IRBuilder.h"
33 #include "llvm/IR/InstIterator.h"
34 #include "llvm/IR/IntrinsicInst.h"
35 #include "llvm/IR/Module.h"
36 #include "llvm/Pass.h"
37 #include "llvm/Support/Debug.h"
38 #include "llvm/Support/raw_ostream.h"
39 #include "llvm/Transforms/Scalar.h"
40 #include "llvm/Transforms/Utils/BasicBlockUtils.h"
41 #include "llvm/Transforms/Utils/LoopUtils.h"
42 #include "llvm/Transforms/Utils/SSAUpdater.h"
43 using namespace llvm;
44
45 #define DEBUG_TYPE "loop-interchange"
46
47 namespace {
48
49 typedef SmallVector<Loop *, 8> LoopVector;
50
51 // TODO: Check if we can use a sparse matrix here.
52 typedef std::vector<std::vector<char>> CharMatrix;
53
54 // Maximum number of dependencies that can be handled in the dependency matrix.
55 static const unsigned MaxMemInstrCount = 100;
56
57 // Maximum loop depth supported.
58 static const unsigned MaxLoopNestDepth = 10;
59
60 struct LoopInterchange;
61
62 #ifdef DUMP_DEP_MATRICIES
printDepMatrix(CharMatrix & DepMatrix)63 void printDepMatrix(CharMatrix &DepMatrix) {
64 for (auto I = DepMatrix.begin(), E = DepMatrix.end(); I != E; ++I) {
65 std::vector<char> Vec = *I;
66 for (auto II = Vec.begin(), EE = Vec.end(); II != EE; ++II)
67 DEBUG(dbgs() << *II << " ");
68 DEBUG(dbgs() << "\n");
69 }
70 }
71 #endif
72
populateDependencyMatrix(CharMatrix & DepMatrix,unsigned Level,Loop * L,DependenceInfo * DI)73 static bool populateDependencyMatrix(CharMatrix &DepMatrix, unsigned Level,
74 Loop *L, DependenceInfo *DI) {
75 typedef SmallVector<Value *, 16> ValueVector;
76 ValueVector MemInstr;
77
78 if (Level > MaxLoopNestDepth) {
79 DEBUG(dbgs() << "Cannot handle loops of depth greater than "
80 << MaxLoopNestDepth << "\n");
81 return false;
82 }
83
84 // For each block.
85 for (Loop::block_iterator BB = L->block_begin(), BE = L->block_end();
86 BB != BE; ++BB) {
87 // Scan the BB and collect legal loads and stores.
88 for (BasicBlock::iterator I = (*BB)->begin(), E = (*BB)->end(); I != E;
89 ++I) {
90 Instruction *Ins = dyn_cast<Instruction>(I);
91 if (!Ins)
92 return false;
93 LoadInst *Ld = dyn_cast<LoadInst>(I);
94 StoreInst *St = dyn_cast<StoreInst>(I);
95 if (!St && !Ld)
96 continue;
97 if (Ld && !Ld->isSimple())
98 return false;
99 if (St && !St->isSimple())
100 return false;
101 MemInstr.push_back(&*I);
102 }
103 }
104
105 DEBUG(dbgs() << "Found " << MemInstr.size()
106 << " Loads and Stores to analyze\n");
107
108 ValueVector::iterator I, IE, J, JE;
109
110 for (I = MemInstr.begin(), IE = MemInstr.end(); I != IE; ++I) {
111 for (J = I, JE = MemInstr.end(); J != JE; ++J) {
112 std::vector<char> Dep;
113 Instruction *Src = dyn_cast<Instruction>(*I);
114 Instruction *Des = dyn_cast<Instruction>(*J);
115 if (Src == Des)
116 continue;
117 if (isa<LoadInst>(Src) && isa<LoadInst>(Des))
118 continue;
119 if (auto D = DI->depends(Src, Des, true)) {
120 DEBUG(dbgs() << "Found Dependency between Src=" << Src << " Des=" << Des
121 << "\n");
122 if (D->isFlow()) {
123 // TODO: Handle Flow dependence.Check if it is sufficient to populate
124 // the Dependence Matrix with the direction reversed.
125 DEBUG(dbgs() << "Flow dependence not handled");
126 return false;
127 }
128 if (D->isAnti()) {
129 DEBUG(dbgs() << "Found Anti dependence \n");
130 unsigned Levels = D->getLevels();
131 char Direction;
132 for (unsigned II = 1; II <= Levels; ++II) {
133 const SCEV *Distance = D->getDistance(II);
134 const SCEVConstant *SCEVConst =
135 dyn_cast_or_null<SCEVConstant>(Distance);
136 if (SCEVConst) {
137 const ConstantInt *CI = SCEVConst->getValue();
138 if (CI->isNegative())
139 Direction = '<';
140 else if (CI->isZero())
141 Direction = '=';
142 else
143 Direction = '>';
144 Dep.push_back(Direction);
145 } else if (D->isScalar(II)) {
146 Direction = 'S';
147 Dep.push_back(Direction);
148 } else {
149 unsigned Dir = D->getDirection(II);
150 if (Dir == Dependence::DVEntry::LT ||
151 Dir == Dependence::DVEntry::LE)
152 Direction = '<';
153 else if (Dir == Dependence::DVEntry::GT ||
154 Dir == Dependence::DVEntry::GE)
155 Direction = '>';
156 else if (Dir == Dependence::DVEntry::EQ)
157 Direction = '=';
158 else
159 Direction = '*';
160 Dep.push_back(Direction);
161 }
162 }
163 while (Dep.size() != Level) {
164 Dep.push_back('I');
165 }
166
167 DepMatrix.push_back(Dep);
168 if (DepMatrix.size() > MaxMemInstrCount) {
169 DEBUG(dbgs() << "Cannot handle more than " << MaxMemInstrCount
170 << " dependencies inside loop\n");
171 return false;
172 }
173 }
174 }
175 }
176 }
177
178 // We don't have a DepMatrix to check legality return false.
179 if (DepMatrix.size() == 0)
180 return false;
181 return true;
182 }
183
184 // A loop is moved from index 'from' to an index 'to'. Update the Dependence
185 // matrix by exchanging the two columns.
interChangeDepedencies(CharMatrix & DepMatrix,unsigned FromIndx,unsigned ToIndx)186 static void interChangeDepedencies(CharMatrix &DepMatrix, unsigned FromIndx,
187 unsigned ToIndx) {
188 unsigned numRows = DepMatrix.size();
189 for (unsigned i = 0; i < numRows; ++i) {
190 char TmpVal = DepMatrix[i][ToIndx];
191 DepMatrix[i][ToIndx] = DepMatrix[i][FromIndx];
192 DepMatrix[i][FromIndx] = TmpVal;
193 }
194 }
195
196 // Checks if outermost non '=','S'or'I' dependence in the dependence matrix is
197 // '>'
isOuterMostDepPositive(CharMatrix & DepMatrix,unsigned Row,unsigned Column)198 static bool isOuterMostDepPositive(CharMatrix &DepMatrix, unsigned Row,
199 unsigned Column) {
200 for (unsigned i = 0; i <= Column; ++i) {
201 if (DepMatrix[Row][i] == '<')
202 return false;
203 if (DepMatrix[Row][i] == '>')
204 return true;
205 }
206 // All dependencies were '=','S' or 'I'
207 return false;
208 }
209
210 // Checks if no dependence exist in the dependency matrix in Row before Column.
containsNoDependence(CharMatrix & DepMatrix,unsigned Row,unsigned Column)211 static bool containsNoDependence(CharMatrix &DepMatrix, unsigned Row,
212 unsigned Column) {
213 for (unsigned i = 0; i < Column; ++i) {
214 if (DepMatrix[Row][i] != '=' || DepMatrix[Row][i] != 'S' ||
215 DepMatrix[Row][i] != 'I')
216 return false;
217 }
218 return true;
219 }
220
validDepInterchange(CharMatrix & DepMatrix,unsigned Row,unsigned OuterLoopId,char InnerDep,char OuterDep)221 static bool validDepInterchange(CharMatrix &DepMatrix, unsigned Row,
222 unsigned OuterLoopId, char InnerDep,
223 char OuterDep) {
224
225 if (isOuterMostDepPositive(DepMatrix, Row, OuterLoopId))
226 return false;
227
228 if (InnerDep == OuterDep)
229 return true;
230
231 // It is legal to interchange if and only if after interchange no row has a
232 // '>' direction as the leftmost non-'='.
233
234 if (InnerDep == '=' || InnerDep == 'S' || InnerDep == 'I')
235 return true;
236
237 if (InnerDep == '<')
238 return true;
239
240 if (InnerDep == '>') {
241 // If OuterLoopId represents outermost loop then interchanging will make the
242 // 1st dependency as '>'
243 if (OuterLoopId == 0)
244 return false;
245
246 // If all dependencies before OuterloopId are '=','S'or 'I'. Then
247 // interchanging will result in this row having an outermost non '='
248 // dependency of '>'
249 if (!containsNoDependence(DepMatrix, Row, OuterLoopId))
250 return true;
251 }
252
253 return false;
254 }
255
256 // Checks if it is legal to interchange 2 loops.
257 // [Theorem] A permutation of the loops in a perfect nest is legal if and only
258 // if
259 // the direction matrix, after the same permutation is applied to its columns,
260 // has no ">" direction as the leftmost non-"=" direction in any row.
isLegalToInterChangeLoops(CharMatrix & DepMatrix,unsigned InnerLoopId,unsigned OuterLoopId)261 static bool isLegalToInterChangeLoops(CharMatrix &DepMatrix,
262 unsigned InnerLoopId,
263 unsigned OuterLoopId) {
264
265 unsigned NumRows = DepMatrix.size();
266 // For each row check if it is valid to interchange.
267 for (unsigned Row = 0; Row < NumRows; ++Row) {
268 char InnerDep = DepMatrix[Row][InnerLoopId];
269 char OuterDep = DepMatrix[Row][OuterLoopId];
270 if (InnerDep == '*' || OuterDep == '*')
271 return false;
272 else if (!validDepInterchange(DepMatrix, Row, OuterLoopId, InnerDep,
273 OuterDep))
274 return false;
275 }
276 return true;
277 }
278
populateWorklist(Loop & L,SmallVector<LoopVector,8> & V)279 static void populateWorklist(Loop &L, SmallVector<LoopVector, 8> &V) {
280
281 DEBUG(dbgs() << "Calling populateWorklist called\n");
282 LoopVector LoopList;
283 Loop *CurrentLoop = &L;
284 const std::vector<Loop *> *Vec = &CurrentLoop->getSubLoops();
285 while (!Vec->empty()) {
286 // The current loop has multiple subloops in it hence it is not tightly
287 // nested.
288 // Discard all loops above it added into Worklist.
289 if (Vec->size() != 1) {
290 LoopList.clear();
291 return;
292 }
293 LoopList.push_back(CurrentLoop);
294 CurrentLoop = Vec->front();
295 Vec = &CurrentLoop->getSubLoops();
296 }
297 LoopList.push_back(CurrentLoop);
298 V.push_back(std::move(LoopList));
299 }
300
getInductionVariable(Loop * L,ScalarEvolution * SE)301 static PHINode *getInductionVariable(Loop *L, ScalarEvolution *SE) {
302 PHINode *InnerIndexVar = L->getCanonicalInductionVariable();
303 if (InnerIndexVar)
304 return InnerIndexVar;
305 if (L->getLoopLatch() == nullptr || L->getLoopPredecessor() == nullptr)
306 return nullptr;
307 for (BasicBlock::iterator I = L->getHeader()->begin(); isa<PHINode>(I); ++I) {
308 PHINode *PhiVar = cast<PHINode>(I);
309 Type *PhiTy = PhiVar->getType();
310 if (!PhiTy->isIntegerTy() && !PhiTy->isFloatingPointTy() &&
311 !PhiTy->isPointerTy())
312 return nullptr;
313 const SCEVAddRecExpr *AddRec =
314 dyn_cast<SCEVAddRecExpr>(SE->getSCEV(PhiVar));
315 if (!AddRec || !AddRec->isAffine())
316 continue;
317 const SCEV *Step = AddRec->getStepRecurrence(*SE);
318 const SCEVConstant *C = dyn_cast<SCEVConstant>(Step);
319 if (!C)
320 continue;
321 // Found the induction variable.
322 // FIXME: Handle loops with more than one induction variable. Note that,
323 // currently, legality makes sure we have only one induction variable.
324 return PhiVar;
325 }
326 return nullptr;
327 }
328
329 /// LoopInterchangeLegality checks if it is legal to interchange the loop.
330 class LoopInterchangeLegality {
331 public:
LoopInterchangeLegality(Loop * Outer,Loop * Inner,ScalarEvolution * SE,LoopInfo * LI,DominatorTree * DT,bool PreserveLCSSA)332 LoopInterchangeLegality(Loop *Outer, Loop *Inner, ScalarEvolution *SE,
333 LoopInfo *LI, DominatorTree *DT, bool PreserveLCSSA)
334 : OuterLoop(Outer), InnerLoop(Inner), SE(SE), LI(LI), DT(DT),
335 PreserveLCSSA(PreserveLCSSA), InnerLoopHasReduction(false) {}
336
337 /// Check if the loops can be interchanged.
338 bool canInterchangeLoops(unsigned InnerLoopId, unsigned OuterLoopId,
339 CharMatrix &DepMatrix);
340 /// Check if the loop structure is understood. We do not handle triangular
341 /// loops for now.
342 bool isLoopStructureUnderstood(PHINode *InnerInductionVar);
343
344 bool currentLimitations();
345
hasInnerLoopReduction()346 bool hasInnerLoopReduction() { return InnerLoopHasReduction; }
347
348 private:
349 bool tightlyNested(Loop *Outer, Loop *Inner);
350 bool containsUnsafeInstructionsInHeader(BasicBlock *BB);
351 bool areAllUsesReductions(Instruction *Ins, Loop *L);
352 bool containsUnsafeInstructionsInLatch(BasicBlock *BB);
353 bool findInductionAndReductions(Loop *L,
354 SmallVector<PHINode *, 8> &Inductions,
355 SmallVector<PHINode *, 8> &Reductions);
356 Loop *OuterLoop;
357 Loop *InnerLoop;
358
359 ScalarEvolution *SE;
360 LoopInfo *LI;
361 DominatorTree *DT;
362 bool PreserveLCSSA;
363
364 bool InnerLoopHasReduction;
365 };
366
367 /// LoopInterchangeProfitability checks if it is profitable to interchange the
368 /// loop.
369 class LoopInterchangeProfitability {
370 public:
LoopInterchangeProfitability(Loop * Outer,Loop * Inner,ScalarEvolution * SE)371 LoopInterchangeProfitability(Loop *Outer, Loop *Inner, ScalarEvolution *SE)
372 : OuterLoop(Outer), InnerLoop(Inner), SE(SE) {}
373
374 /// Check if the loop interchange is profitable.
375 bool isProfitable(unsigned InnerLoopId, unsigned OuterLoopId,
376 CharMatrix &DepMatrix);
377
378 private:
379 int getInstrOrderCost();
380
381 Loop *OuterLoop;
382 Loop *InnerLoop;
383
384 /// Scev analysis.
385 ScalarEvolution *SE;
386 };
387
388 /// LoopInterchangeTransform interchanges the loop.
389 class LoopInterchangeTransform {
390 public:
LoopInterchangeTransform(Loop * Outer,Loop * Inner,ScalarEvolution * SE,LoopInfo * LI,DominatorTree * DT,BasicBlock * LoopNestExit,bool InnerLoopContainsReductions)391 LoopInterchangeTransform(Loop *Outer, Loop *Inner, ScalarEvolution *SE,
392 LoopInfo *LI, DominatorTree *DT,
393 BasicBlock *LoopNestExit,
394 bool InnerLoopContainsReductions)
395 : OuterLoop(Outer), InnerLoop(Inner), SE(SE), LI(LI), DT(DT),
396 LoopExit(LoopNestExit),
397 InnerLoopHasReduction(InnerLoopContainsReductions) {}
398
399 /// Interchange OuterLoop and InnerLoop.
400 bool transform();
401 void restructureLoops(Loop *InnerLoop, Loop *OuterLoop);
402 void removeChildLoop(Loop *OuterLoop, Loop *InnerLoop);
403
404 private:
405 void splitInnerLoopLatch(Instruction *);
406 void splitInnerLoopHeader();
407 bool adjustLoopLinks();
408 void adjustLoopPreheaders();
409 bool adjustLoopBranches();
410 void updateIncomingBlock(BasicBlock *CurrBlock, BasicBlock *OldPred,
411 BasicBlock *NewPred);
412
413 Loop *OuterLoop;
414 Loop *InnerLoop;
415
416 /// Scev analysis.
417 ScalarEvolution *SE;
418 LoopInfo *LI;
419 DominatorTree *DT;
420 BasicBlock *LoopExit;
421 bool InnerLoopHasReduction;
422 };
423
424 // Main LoopInterchange Pass.
425 struct LoopInterchange : public FunctionPass {
426 static char ID;
427 ScalarEvolution *SE;
428 LoopInfo *LI;
429 DependenceInfo *DI;
430 DominatorTree *DT;
431 bool PreserveLCSSA;
LoopInterchange__anon860498c00111::LoopInterchange432 LoopInterchange()
433 : FunctionPass(ID), SE(nullptr), LI(nullptr), DI(nullptr), DT(nullptr) {
434 initializeLoopInterchangePass(*PassRegistry::getPassRegistry());
435 }
436
getAnalysisUsage__anon860498c00111::LoopInterchange437 void getAnalysisUsage(AnalysisUsage &AU) const override {
438 AU.addRequired<ScalarEvolutionWrapperPass>();
439 AU.addRequired<AAResultsWrapperPass>();
440 AU.addRequired<DominatorTreeWrapperPass>();
441 AU.addRequired<LoopInfoWrapperPass>();
442 AU.addRequired<DependenceAnalysisWrapperPass>();
443 AU.addRequiredID(LoopSimplifyID);
444 AU.addRequiredID(LCSSAID);
445 }
446
runOnFunction__anon860498c00111::LoopInterchange447 bool runOnFunction(Function &F) override {
448 if (skipFunction(F))
449 return false;
450
451 SE = &getAnalysis<ScalarEvolutionWrapperPass>().getSE();
452 LI = &getAnalysis<LoopInfoWrapperPass>().getLoopInfo();
453 DI = &getAnalysis<DependenceAnalysisWrapperPass>().getDI();
454 auto *DTWP = getAnalysisIfAvailable<DominatorTreeWrapperPass>();
455 DT = DTWP ? &DTWP->getDomTree() : nullptr;
456 PreserveLCSSA = mustPreserveAnalysisID(LCSSAID);
457
458 // Build up a worklist of loop pairs to analyze.
459 SmallVector<LoopVector, 8> Worklist;
460
461 for (Loop *L : *LI)
462 populateWorklist(*L, Worklist);
463
464 DEBUG(dbgs() << "Worklist size = " << Worklist.size() << "\n");
465 bool Changed = true;
466 while (!Worklist.empty()) {
467 LoopVector LoopList = Worklist.pop_back_val();
468 Changed = processLoopList(LoopList, F);
469 }
470 return Changed;
471 }
472
isComputableLoopNest__anon860498c00111::LoopInterchange473 bool isComputableLoopNest(LoopVector LoopList) {
474 for (Loop *L : LoopList) {
475 const SCEV *ExitCountOuter = SE->getBackedgeTakenCount(L);
476 if (ExitCountOuter == SE->getCouldNotCompute()) {
477 DEBUG(dbgs() << "Couldn't compute Backedge count\n");
478 return false;
479 }
480 if (L->getNumBackEdges() != 1) {
481 DEBUG(dbgs() << "NumBackEdges is not equal to 1\n");
482 return false;
483 }
484 if (!L->getExitingBlock()) {
485 DEBUG(dbgs() << "Loop Doesn't have unique exit block\n");
486 return false;
487 }
488 }
489 return true;
490 }
491
selectLoopForInterchange__anon860498c00111::LoopInterchange492 unsigned selectLoopForInterchange(const LoopVector &LoopList) {
493 // TODO: Add a better heuristic to select the loop to be interchanged based
494 // on the dependence matrix. Currently we select the innermost loop.
495 return LoopList.size() - 1;
496 }
497
processLoopList__anon860498c00111::LoopInterchange498 bool processLoopList(LoopVector LoopList, Function &F) {
499
500 bool Changed = false;
501 CharMatrix DependencyMatrix;
502 if (LoopList.size() < 2) {
503 DEBUG(dbgs() << "Loop doesn't contain minimum nesting level.\n");
504 return false;
505 }
506 if (!isComputableLoopNest(LoopList)) {
507 DEBUG(dbgs() << "Not vaild loop candidate for interchange\n");
508 return false;
509 }
510 Loop *OuterMostLoop = *(LoopList.begin());
511
512 DEBUG(dbgs() << "Processing LoopList of size = " << LoopList.size()
513 << "\n");
514
515 if (!populateDependencyMatrix(DependencyMatrix, LoopList.size(),
516 OuterMostLoop, DI)) {
517 DEBUG(dbgs() << "Populating Dependency matrix failed\n");
518 return false;
519 }
520 #ifdef DUMP_DEP_MATRICIES
521 DEBUG(dbgs() << "Dependence before inter change \n");
522 printDepMatrix(DependencyMatrix);
523 #endif
524
525 BasicBlock *OuterMostLoopLatch = OuterMostLoop->getLoopLatch();
526 BranchInst *OuterMostLoopLatchBI =
527 dyn_cast<BranchInst>(OuterMostLoopLatch->getTerminator());
528 if (!OuterMostLoopLatchBI)
529 return false;
530
531 // Since we currently do not handle LCSSA PHI's any failure in loop
532 // condition will now branch to LoopNestExit.
533 // TODO: This should be removed once we handle LCSSA PHI nodes.
534
535 // Get the Outermost loop exit.
536 BasicBlock *LoopNestExit;
537 if (OuterMostLoopLatchBI->getSuccessor(0) == OuterMostLoop->getHeader())
538 LoopNestExit = OuterMostLoopLatchBI->getSuccessor(1);
539 else
540 LoopNestExit = OuterMostLoopLatchBI->getSuccessor(0);
541
542 if (isa<PHINode>(LoopNestExit->begin())) {
543 DEBUG(dbgs() << "PHI Nodes in loop nest exit is not handled for now "
544 "since on failure all loops branch to loop nest exit.\n");
545 return false;
546 }
547
548 unsigned SelecLoopId = selectLoopForInterchange(LoopList);
549 // Move the selected loop outwards to the best possible position.
550 for (unsigned i = SelecLoopId; i > 0; i--) {
551 bool Interchanged =
552 processLoop(LoopList, i, i - 1, LoopNestExit, DependencyMatrix);
553 if (!Interchanged)
554 return Changed;
555 // Loops interchanged reflect the same in LoopList
556 std::swap(LoopList[i - 1], LoopList[i]);
557
558 // Update the DependencyMatrix
559 interChangeDepedencies(DependencyMatrix, i, i - 1);
560 DT->recalculate(F);
561 #ifdef DUMP_DEP_MATRICIES
562 DEBUG(dbgs() << "Dependence after inter change \n");
563 printDepMatrix(DependencyMatrix);
564 #endif
565 Changed |= Interchanged;
566 }
567 return Changed;
568 }
569
processLoop__anon860498c00111::LoopInterchange570 bool processLoop(LoopVector LoopList, unsigned InnerLoopId,
571 unsigned OuterLoopId, BasicBlock *LoopNestExit,
572 std::vector<std::vector<char>> &DependencyMatrix) {
573
574 DEBUG(dbgs() << "Processing Innder Loop Id = " << InnerLoopId
575 << " and OuterLoopId = " << OuterLoopId << "\n");
576 Loop *InnerLoop = LoopList[InnerLoopId];
577 Loop *OuterLoop = LoopList[OuterLoopId];
578
579 LoopInterchangeLegality LIL(OuterLoop, InnerLoop, SE, LI, DT,
580 PreserveLCSSA);
581 if (!LIL.canInterchangeLoops(InnerLoopId, OuterLoopId, DependencyMatrix)) {
582 DEBUG(dbgs() << "Not interchanging Loops. Cannot prove legality\n");
583 return false;
584 }
585 DEBUG(dbgs() << "Loops are legal to interchange\n");
586 LoopInterchangeProfitability LIP(OuterLoop, InnerLoop, SE);
587 if (!LIP.isProfitable(InnerLoopId, OuterLoopId, DependencyMatrix)) {
588 DEBUG(dbgs() << "Interchanging Loops not profitable\n");
589 return false;
590 }
591
592 LoopInterchangeTransform LIT(OuterLoop, InnerLoop, SE, LI, DT,
593 LoopNestExit, LIL.hasInnerLoopReduction());
594 LIT.transform();
595 DEBUG(dbgs() << "Loops interchanged\n");
596 return true;
597 }
598 };
599
600 } // end of namespace
areAllUsesReductions(Instruction * Ins,Loop * L)601 bool LoopInterchangeLegality::areAllUsesReductions(Instruction *Ins, Loop *L) {
602 return !std::any_of(Ins->user_begin(), Ins->user_end(), [=](User *U) -> bool {
603 PHINode *UserIns = dyn_cast<PHINode>(U);
604 RecurrenceDescriptor RD;
605 return !UserIns || !RecurrenceDescriptor::isReductionPHI(UserIns, L, RD);
606 });
607 }
608
containsUnsafeInstructionsInHeader(BasicBlock * BB)609 bool LoopInterchangeLegality::containsUnsafeInstructionsInHeader(
610 BasicBlock *BB) {
611 for (auto I = BB->begin(), E = BB->end(); I != E; ++I) {
612 // Load corresponding to reduction PHI's are safe while concluding if
613 // tightly nested.
614 if (LoadInst *L = dyn_cast<LoadInst>(I)) {
615 if (!areAllUsesReductions(L, InnerLoop))
616 return true;
617 } else if (I->mayHaveSideEffects() || I->mayReadFromMemory())
618 return true;
619 }
620 return false;
621 }
622
containsUnsafeInstructionsInLatch(BasicBlock * BB)623 bool LoopInterchangeLegality::containsUnsafeInstructionsInLatch(
624 BasicBlock *BB) {
625 for (auto I = BB->begin(), E = BB->end(); I != E; ++I) {
626 // Stores corresponding to reductions are safe while concluding if tightly
627 // nested.
628 if (StoreInst *L = dyn_cast<StoreInst>(I)) {
629 PHINode *PHI = dyn_cast<PHINode>(L->getOperand(0));
630 if (!PHI)
631 return true;
632 } else if (I->mayHaveSideEffects() || I->mayReadFromMemory())
633 return true;
634 }
635 return false;
636 }
637
tightlyNested(Loop * OuterLoop,Loop * InnerLoop)638 bool LoopInterchangeLegality::tightlyNested(Loop *OuterLoop, Loop *InnerLoop) {
639 BasicBlock *OuterLoopHeader = OuterLoop->getHeader();
640 BasicBlock *InnerLoopPreHeader = InnerLoop->getLoopPreheader();
641 BasicBlock *OuterLoopLatch = OuterLoop->getLoopLatch();
642
643 DEBUG(dbgs() << "Checking if Loops are Tightly Nested\n");
644
645 // A perfectly nested loop will not have any branch in between the outer and
646 // inner block i.e. outer header will branch to either inner preheader and
647 // outerloop latch.
648 BranchInst *outerLoopHeaderBI =
649 dyn_cast<BranchInst>(OuterLoopHeader->getTerminator());
650 if (!outerLoopHeaderBI)
651 return false;
652 unsigned num = outerLoopHeaderBI->getNumSuccessors();
653 for (unsigned i = 0; i < num; i++) {
654 if (outerLoopHeaderBI->getSuccessor(i) != InnerLoopPreHeader &&
655 outerLoopHeaderBI->getSuccessor(i) != OuterLoopLatch)
656 return false;
657 }
658
659 DEBUG(dbgs() << "Checking instructions in Loop header and Loop latch \n");
660 // We do not have any basic block in between now make sure the outer header
661 // and outer loop latch doesn't contain any unsafe instructions.
662 if (containsUnsafeInstructionsInHeader(OuterLoopHeader) ||
663 containsUnsafeInstructionsInLatch(OuterLoopLatch))
664 return false;
665
666 DEBUG(dbgs() << "Loops are perfectly nested \n");
667 // We have a perfect loop nest.
668 return true;
669 }
670
671
isLoopStructureUnderstood(PHINode * InnerInduction)672 bool LoopInterchangeLegality::isLoopStructureUnderstood(
673 PHINode *InnerInduction) {
674
675 unsigned Num = InnerInduction->getNumOperands();
676 BasicBlock *InnerLoopPreheader = InnerLoop->getLoopPreheader();
677 for (unsigned i = 0; i < Num; ++i) {
678 Value *Val = InnerInduction->getOperand(i);
679 if (isa<Constant>(Val))
680 continue;
681 Instruction *I = dyn_cast<Instruction>(Val);
682 if (!I)
683 return false;
684 // TODO: Handle triangular loops.
685 // e.g. for(int i=0;i<N;i++)
686 // for(int j=i;j<N;j++)
687 unsigned IncomBlockIndx = PHINode::getIncomingValueNumForOperand(i);
688 if (InnerInduction->getIncomingBlock(IncomBlockIndx) ==
689 InnerLoopPreheader &&
690 !OuterLoop->isLoopInvariant(I)) {
691 return false;
692 }
693 }
694 return true;
695 }
696
findInductionAndReductions(Loop * L,SmallVector<PHINode *,8> & Inductions,SmallVector<PHINode *,8> & Reductions)697 bool LoopInterchangeLegality::findInductionAndReductions(
698 Loop *L, SmallVector<PHINode *, 8> &Inductions,
699 SmallVector<PHINode *, 8> &Reductions) {
700 if (!L->getLoopLatch() || !L->getLoopPredecessor())
701 return false;
702 for (BasicBlock::iterator I = L->getHeader()->begin(); isa<PHINode>(I); ++I) {
703 RecurrenceDescriptor RD;
704 InductionDescriptor ID;
705 PHINode *PHI = cast<PHINode>(I);
706 if (InductionDescriptor::isInductionPHI(PHI, SE, ID))
707 Inductions.push_back(PHI);
708 else if (RecurrenceDescriptor::isReductionPHI(PHI, L, RD))
709 Reductions.push_back(PHI);
710 else {
711 DEBUG(
712 dbgs() << "Failed to recognize PHI as an induction or reduction.\n");
713 return false;
714 }
715 }
716 return true;
717 }
718
containsSafePHI(BasicBlock * Block,bool isOuterLoopExitBlock)719 static bool containsSafePHI(BasicBlock *Block, bool isOuterLoopExitBlock) {
720 for (auto I = Block->begin(); isa<PHINode>(I); ++I) {
721 PHINode *PHI = cast<PHINode>(I);
722 // Reduction lcssa phi will have only 1 incoming block that from loop latch.
723 if (PHI->getNumIncomingValues() > 1)
724 return false;
725 Instruction *Ins = dyn_cast<Instruction>(PHI->getIncomingValue(0));
726 if (!Ins)
727 return false;
728 // Incoming value for lcssa phi's in outer loop exit can only be inner loop
729 // exits lcssa phi else it would not be tightly nested.
730 if (!isa<PHINode>(Ins) && isOuterLoopExitBlock)
731 return false;
732 }
733 return true;
734 }
735
getLoopLatchExitBlock(BasicBlock * LatchBlock,BasicBlock * LoopHeader)736 static BasicBlock *getLoopLatchExitBlock(BasicBlock *LatchBlock,
737 BasicBlock *LoopHeader) {
738 if (BranchInst *BI = dyn_cast<BranchInst>(LatchBlock->getTerminator())) {
739 unsigned Num = BI->getNumSuccessors();
740 assert(Num == 2);
741 for (unsigned i = 0; i < Num; ++i) {
742 if (BI->getSuccessor(i) == LoopHeader)
743 continue;
744 return BI->getSuccessor(i);
745 }
746 }
747 return nullptr;
748 }
749
750 // This function indicates the current limitations in the transform as a result
751 // of which we do not proceed.
currentLimitations()752 bool LoopInterchangeLegality::currentLimitations() {
753
754 BasicBlock *InnerLoopPreHeader = InnerLoop->getLoopPreheader();
755 BasicBlock *InnerLoopHeader = InnerLoop->getHeader();
756 BasicBlock *InnerLoopLatch = InnerLoop->getLoopLatch();
757 BasicBlock *OuterLoopLatch = OuterLoop->getLoopLatch();
758 BasicBlock *OuterLoopHeader = OuterLoop->getHeader();
759
760 PHINode *InnerInductionVar;
761 SmallVector<PHINode *, 8> Inductions;
762 SmallVector<PHINode *, 8> Reductions;
763 if (!findInductionAndReductions(InnerLoop, Inductions, Reductions))
764 return true;
765
766 // TODO: Currently we handle only loops with 1 induction variable.
767 if (Inductions.size() != 1) {
768 DEBUG(dbgs() << "We currently only support loops with 1 induction variable."
769 << "Failed to interchange due to current limitation\n");
770 return true;
771 }
772 if (Reductions.size() > 0)
773 InnerLoopHasReduction = true;
774
775 InnerInductionVar = Inductions.pop_back_val();
776 Reductions.clear();
777 if (!findInductionAndReductions(OuterLoop, Inductions, Reductions))
778 return true;
779
780 // Outer loop cannot have reduction because then loops will not be tightly
781 // nested.
782 if (!Reductions.empty())
783 return true;
784 // TODO: Currently we handle only loops with 1 induction variable.
785 if (Inductions.size() != 1)
786 return true;
787
788 // TODO: Triangular loops are not handled for now.
789 if (!isLoopStructureUnderstood(InnerInductionVar)) {
790 DEBUG(dbgs() << "Loop structure not understood by pass\n");
791 return true;
792 }
793
794 // TODO: We only handle LCSSA PHI's corresponding to reduction for now.
795 BasicBlock *LoopExitBlock =
796 getLoopLatchExitBlock(OuterLoopLatch, OuterLoopHeader);
797 if (!LoopExitBlock || !containsSafePHI(LoopExitBlock, true))
798 return true;
799
800 LoopExitBlock = getLoopLatchExitBlock(InnerLoopLatch, InnerLoopHeader);
801 if (!LoopExitBlock || !containsSafePHI(LoopExitBlock, false))
802 return true;
803
804 // TODO: Current limitation: Since we split the inner loop latch at the point
805 // were induction variable is incremented (induction.next); We cannot have
806 // more than 1 user of induction.next since it would result in broken code
807 // after split.
808 // e.g.
809 // for(i=0;i<N;i++) {
810 // for(j = 0;j<M;j++) {
811 // A[j+1][i+2] = A[j][i]+k;
812 // }
813 // }
814 Instruction *InnerIndexVarInc = nullptr;
815 if (InnerInductionVar->getIncomingBlock(0) == InnerLoopPreHeader)
816 InnerIndexVarInc =
817 dyn_cast<Instruction>(InnerInductionVar->getIncomingValue(1));
818 else
819 InnerIndexVarInc =
820 dyn_cast<Instruction>(InnerInductionVar->getIncomingValue(0));
821
822 if (!InnerIndexVarInc)
823 return true;
824
825 // Since we split the inner loop latch on this induction variable. Make sure
826 // we do not have any instruction between the induction variable and branch
827 // instruction.
828
829 bool FoundInduction = false;
830 for (const Instruction &I : reverse(*InnerLoopLatch)) {
831 if (isa<BranchInst>(I) || isa<CmpInst>(I) || isa<TruncInst>(I))
832 continue;
833 // We found an instruction. If this is not induction variable then it is not
834 // safe to split this loop latch.
835 if (!I.isIdenticalTo(InnerIndexVarInc))
836 return true;
837
838 FoundInduction = true;
839 break;
840 }
841 // The loop latch ended and we didn't find the induction variable return as
842 // current limitation.
843 if (!FoundInduction)
844 return true;
845
846 return false;
847 }
848
canInterchangeLoops(unsigned InnerLoopId,unsigned OuterLoopId,CharMatrix & DepMatrix)849 bool LoopInterchangeLegality::canInterchangeLoops(unsigned InnerLoopId,
850 unsigned OuterLoopId,
851 CharMatrix &DepMatrix) {
852
853 if (!isLegalToInterChangeLoops(DepMatrix, InnerLoopId, OuterLoopId)) {
854 DEBUG(dbgs() << "Failed interchange InnerLoopId = " << InnerLoopId
855 << "and OuterLoopId = " << OuterLoopId
856 << "due to dependence\n");
857 return false;
858 }
859
860 // Create unique Preheaders if we already do not have one.
861 BasicBlock *OuterLoopPreHeader = OuterLoop->getLoopPreheader();
862 BasicBlock *InnerLoopPreHeader = InnerLoop->getLoopPreheader();
863
864 // Create a unique outer preheader -
865 // 1) If OuterLoop preheader is not present.
866 // 2) If OuterLoop Preheader is same as OuterLoop Header
867 // 3) If OuterLoop Preheader is same as Header of the previous loop.
868 // 4) If OuterLoop Preheader is Entry node.
869 if (!OuterLoopPreHeader || OuterLoopPreHeader == OuterLoop->getHeader() ||
870 isa<PHINode>(OuterLoopPreHeader->begin()) ||
871 !OuterLoopPreHeader->getUniquePredecessor()) {
872 OuterLoopPreHeader =
873 InsertPreheaderForLoop(OuterLoop, DT, LI, PreserveLCSSA);
874 }
875
876 if (!InnerLoopPreHeader || InnerLoopPreHeader == InnerLoop->getHeader() ||
877 InnerLoopPreHeader == OuterLoop->getHeader()) {
878 InnerLoopPreHeader =
879 InsertPreheaderForLoop(InnerLoop, DT, LI, PreserveLCSSA);
880 }
881
882 // TODO: The loops could not be interchanged due to current limitations in the
883 // transform module.
884 if (currentLimitations()) {
885 DEBUG(dbgs() << "Not legal because of current transform limitation\n");
886 return false;
887 }
888
889 // Check if the loops are tightly nested.
890 if (!tightlyNested(OuterLoop, InnerLoop)) {
891 DEBUG(dbgs() << "Loops not tightly nested\n");
892 return false;
893 }
894
895 return true;
896 }
897
getInstrOrderCost()898 int LoopInterchangeProfitability::getInstrOrderCost() {
899 unsigned GoodOrder, BadOrder;
900 BadOrder = GoodOrder = 0;
901 for (auto BI = InnerLoop->block_begin(), BE = InnerLoop->block_end();
902 BI != BE; ++BI) {
903 for (Instruction &Ins : **BI) {
904 if (const GetElementPtrInst *GEP = dyn_cast<GetElementPtrInst>(&Ins)) {
905 unsigned NumOp = GEP->getNumOperands();
906 bool FoundInnerInduction = false;
907 bool FoundOuterInduction = false;
908 for (unsigned i = 0; i < NumOp; ++i) {
909 const SCEV *OperandVal = SE->getSCEV(GEP->getOperand(i));
910 const SCEVAddRecExpr *AR = dyn_cast<SCEVAddRecExpr>(OperandVal);
911 if (!AR)
912 continue;
913
914 // If we find the inner induction after an outer induction e.g.
915 // for(int i=0;i<N;i++)
916 // for(int j=0;j<N;j++)
917 // A[i][j] = A[i-1][j-1]+k;
918 // then it is a good order.
919 if (AR->getLoop() == InnerLoop) {
920 // We found an InnerLoop induction after OuterLoop induction. It is
921 // a good order.
922 FoundInnerInduction = true;
923 if (FoundOuterInduction) {
924 GoodOrder++;
925 break;
926 }
927 }
928 // If we find the outer induction after an inner induction e.g.
929 // for(int i=0;i<N;i++)
930 // for(int j=0;j<N;j++)
931 // A[j][i] = A[j-1][i-1]+k;
932 // then it is a bad order.
933 if (AR->getLoop() == OuterLoop) {
934 // We found an OuterLoop induction after InnerLoop induction. It is
935 // a bad order.
936 FoundOuterInduction = true;
937 if (FoundInnerInduction) {
938 BadOrder++;
939 break;
940 }
941 }
942 }
943 }
944 }
945 }
946 return GoodOrder - BadOrder;
947 }
948
isProfitabileForVectorization(unsigned InnerLoopId,unsigned OuterLoopId,CharMatrix & DepMatrix)949 static bool isProfitabileForVectorization(unsigned InnerLoopId,
950 unsigned OuterLoopId,
951 CharMatrix &DepMatrix) {
952 // TODO: Improve this heuristic to catch more cases.
953 // If the inner loop is loop independent or doesn't carry any dependency it is
954 // profitable to move this to outer position.
955 unsigned Row = DepMatrix.size();
956 for (unsigned i = 0; i < Row; ++i) {
957 if (DepMatrix[i][InnerLoopId] != 'S' && DepMatrix[i][InnerLoopId] != 'I')
958 return false;
959 // TODO: We need to improve this heuristic.
960 if (DepMatrix[i][OuterLoopId] != '=')
961 return false;
962 }
963 // If outer loop has dependence and inner loop is loop independent then it is
964 // profitable to interchange to enable parallelism.
965 return true;
966 }
967
isProfitable(unsigned InnerLoopId,unsigned OuterLoopId,CharMatrix & DepMatrix)968 bool LoopInterchangeProfitability::isProfitable(unsigned InnerLoopId,
969 unsigned OuterLoopId,
970 CharMatrix &DepMatrix) {
971
972 // TODO: Add better profitability checks.
973 // e.g
974 // 1) Construct dependency matrix and move the one with no loop carried dep
975 // inside to enable vectorization.
976
977 // This is rough cost estimation algorithm. It counts the good and bad order
978 // of induction variables in the instruction and allows reordering if number
979 // of bad orders is more than good.
980 int Cost = 0;
981 Cost += getInstrOrderCost();
982 DEBUG(dbgs() << "Cost = " << Cost << "\n");
983 if (Cost < 0)
984 return true;
985
986 // It is not profitable as per current cache profitability model. But check if
987 // we can move this loop outside to improve parallelism.
988 bool ImprovesPar =
989 isProfitabileForVectorization(InnerLoopId, OuterLoopId, DepMatrix);
990 return ImprovesPar;
991 }
992
removeChildLoop(Loop * OuterLoop,Loop * InnerLoop)993 void LoopInterchangeTransform::removeChildLoop(Loop *OuterLoop,
994 Loop *InnerLoop) {
995 for (Loop::iterator I = OuterLoop->begin(), E = OuterLoop->end(); I != E;
996 ++I) {
997 if (*I == InnerLoop) {
998 OuterLoop->removeChildLoop(I);
999 return;
1000 }
1001 }
1002 llvm_unreachable("Couldn't find loop");
1003 }
1004
restructureLoops(Loop * InnerLoop,Loop * OuterLoop)1005 void LoopInterchangeTransform::restructureLoops(Loop *InnerLoop,
1006 Loop *OuterLoop) {
1007 Loop *OuterLoopParent = OuterLoop->getParentLoop();
1008 if (OuterLoopParent) {
1009 // Remove the loop from its parent loop.
1010 removeChildLoop(OuterLoopParent, OuterLoop);
1011 removeChildLoop(OuterLoop, InnerLoop);
1012 OuterLoopParent->addChildLoop(InnerLoop);
1013 } else {
1014 removeChildLoop(OuterLoop, InnerLoop);
1015 LI->changeTopLevelLoop(OuterLoop, InnerLoop);
1016 }
1017
1018 while (!InnerLoop->empty())
1019 OuterLoop->addChildLoop(InnerLoop->removeChildLoop(InnerLoop->begin()));
1020
1021 InnerLoop->addChildLoop(OuterLoop);
1022 }
1023
transform()1024 bool LoopInterchangeTransform::transform() {
1025
1026 DEBUG(dbgs() << "transform\n");
1027 bool Transformed = false;
1028 Instruction *InnerIndexVar;
1029
1030 if (InnerLoop->getSubLoops().size() == 0) {
1031 BasicBlock *InnerLoopPreHeader = InnerLoop->getLoopPreheader();
1032 DEBUG(dbgs() << "Calling Split Inner Loop\n");
1033 PHINode *InductionPHI = getInductionVariable(InnerLoop, SE);
1034 if (!InductionPHI) {
1035 DEBUG(dbgs() << "Failed to find the point to split loop latch \n");
1036 return false;
1037 }
1038
1039 if (InductionPHI->getIncomingBlock(0) == InnerLoopPreHeader)
1040 InnerIndexVar = dyn_cast<Instruction>(InductionPHI->getIncomingValue(1));
1041 else
1042 InnerIndexVar = dyn_cast<Instruction>(InductionPHI->getIncomingValue(0));
1043
1044 //
1045 // Split at the place were the induction variable is
1046 // incremented/decremented.
1047 // TODO: This splitting logic may not work always. Fix this.
1048 splitInnerLoopLatch(InnerIndexVar);
1049 DEBUG(dbgs() << "splitInnerLoopLatch Done\n");
1050
1051 // Splits the inner loops phi nodes out into a separate basic block.
1052 splitInnerLoopHeader();
1053 DEBUG(dbgs() << "splitInnerLoopHeader Done\n");
1054 }
1055
1056 Transformed |= adjustLoopLinks();
1057 if (!Transformed) {
1058 DEBUG(dbgs() << "adjustLoopLinks Failed\n");
1059 return false;
1060 }
1061
1062 restructureLoops(InnerLoop, OuterLoop);
1063 return true;
1064 }
1065
splitInnerLoopLatch(Instruction * Inc)1066 void LoopInterchangeTransform::splitInnerLoopLatch(Instruction *Inc) {
1067 BasicBlock *InnerLoopLatch = InnerLoop->getLoopLatch();
1068 BasicBlock *InnerLoopLatchPred = InnerLoopLatch;
1069 InnerLoopLatch = SplitBlock(InnerLoopLatchPred, Inc, DT, LI);
1070 }
1071
splitInnerLoopHeader()1072 void LoopInterchangeTransform::splitInnerLoopHeader() {
1073
1074 // Split the inner loop header out. Here make sure that the reduction PHI's
1075 // stay in the innerloop body.
1076 BasicBlock *InnerLoopHeader = InnerLoop->getHeader();
1077 BasicBlock *InnerLoopPreHeader = InnerLoop->getLoopPreheader();
1078 if (InnerLoopHasReduction) {
1079 // FIXME: Check if the induction PHI will always be the first PHI.
1080 BasicBlock *New = InnerLoopHeader->splitBasicBlock(
1081 ++(InnerLoopHeader->begin()), InnerLoopHeader->getName() + ".split");
1082 if (LI)
1083 if (Loop *L = LI->getLoopFor(InnerLoopHeader))
1084 L->addBasicBlockToLoop(New, *LI);
1085
1086 // Adjust Reduction PHI's in the block.
1087 SmallVector<PHINode *, 8> PHIVec;
1088 for (auto I = New->begin(); isa<PHINode>(I); ++I) {
1089 PHINode *PHI = dyn_cast<PHINode>(I);
1090 Value *V = PHI->getIncomingValueForBlock(InnerLoopPreHeader);
1091 PHI->replaceAllUsesWith(V);
1092 PHIVec.push_back((PHI));
1093 }
1094 for (PHINode *P : PHIVec) {
1095 P->eraseFromParent();
1096 }
1097 } else {
1098 SplitBlock(InnerLoopHeader, InnerLoopHeader->getFirstNonPHI(), DT, LI);
1099 }
1100
1101 DEBUG(dbgs() << "Output of splitInnerLoopHeader InnerLoopHeaderSucc & "
1102 "InnerLoopHeader \n");
1103 }
1104
1105 /// \brief Move all instructions except the terminator from FromBB right before
1106 /// InsertBefore
moveBBContents(BasicBlock * FromBB,Instruction * InsertBefore)1107 static void moveBBContents(BasicBlock *FromBB, Instruction *InsertBefore) {
1108 auto &ToList = InsertBefore->getParent()->getInstList();
1109 auto &FromList = FromBB->getInstList();
1110
1111 ToList.splice(InsertBefore->getIterator(), FromList, FromList.begin(),
1112 FromBB->getTerminator()->getIterator());
1113 }
1114
updateIncomingBlock(BasicBlock * CurrBlock,BasicBlock * OldPred,BasicBlock * NewPred)1115 void LoopInterchangeTransform::updateIncomingBlock(BasicBlock *CurrBlock,
1116 BasicBlock *OldPred,
1117 BasicBlock *NewPred) {
1118 for (auto I = CurrBlock->begin(); isa<PHINode>(I); ++I) {
1119 PHINode *PHI = cast<PHINode>(I);
1120 unsigned Num = PHI->getNumIncomingValues();
1121 for (unsigned i = 0; i < Num; ++i) {
1122 if (PHI->getIncomingBlock(i) == OldPred)
1123 PHI->setIncomingBlock(i, NewPred);
1124 }
1125 }
1126 }
1127
adjustLoopBranches()1128 bool LoopInterchangeTransform::adjustLoopBranches() {
1129
1130 DEBUG(dbgs() << "adjustLoopBranches called\n");
1131 // Adjust the loop preheader
1132 BasicBlock *InnerLoopHeader = InnerLoop->getHeader();
1133 BasicBlock *OuterLoopHeader = OuterLoop->getHeader();
1134 BasicBlock *InnerLoopLatch = InnerLoop->getLoopLatch();
1135 BasicBlock *OuterLoopLatch = OuterLoop->getLoopLatch();
1136 BasicBlock *OuterLoopPreHeader = OuterLoop->getLoopPreheader();
1137 BasicBlock *InnerLoopPreHeader = InnerLoop->getLoopPreheader();
1138 BasicBlock *OuterLoopPredecessor = OuterLoopPreHeader->getUniquePredecessor();
1139 BasicBlock *InnerLoopLatchPredecessor =
1140 InnerLoopLatch->getUniquePredecessor();
1141 BasicBlock *InnerLoopLatchSuccessor;
1142 BasicBlock *OuterLoopLatchSuccessor;
1143
1144 BranchInst *OuterLoopLatchBI =
1145 dyn_cast<BranchInst>(OuterLoopLatch->getTerminator());
1146 BranchInst *InnerLoopLatchBI =
1147 dyn_cast<BranchInst>(InnerLoopLatch->getTerminator());
1148 BranchInst *OuterLoopHeaderBI =
1149 dyn_cast<BranchInst>(OuterLoopHeader->getTerminator());
1150 BranchInst *InnerLoopHeaderBI =
1151 dyn_cast<BranchInst>(InnerLoopHeader->getTerminator());
1152
1153 if (!OuterLoopPredecessor || !InnerLoopLatchPredecessor ||
1154 !OuterLoopLatchBI || !InnerLoopLatchBI || !OuterLoopHeaderBI ||
1155 !InnerLoopHeaderBI)
1156 return false;
1157
1158 BranchInst *InnerLoopLatchPredecessorBI =
1159 dyn_cast<BranchInst>(InnerLoopLatchPredecessor->getTerminator());
1160 BranchInst *OuterLoopPredecessorBI =
1161 dyn_cast<BranchInst>(OuterLoopPredecessor->getTerminator());
1162
1163 if (!OuterLoopPredecessorBI || !InnerLoopLatchPredecessorBI)
1164 return false;
1165 BasicBlock *InnerLoopHeaderSuccessor = InnerLoopHeader->getUniqueSuccessor();
1166 if (!InnerLoopHeaderSuccessor)
1167 return false;
1168
1169 // Adjust Loop Preheader and headers
1170
1171 unsigned NumSucc = OuterLoopPredecessorBI->getNumSuccessors();
1172 for (unsigned i = 0; i < NumSucc; ++i) {
1173 if (OuterLoopPredecessorBI->getSuccessor(i) == OuterLoopPreHeader)
1174 OuterLoopPredecessorBI->setSuccessor(i, InnerLoopPreHeader);
1175 }
1176
1177 NumSucc = OuterLoopHeaderBI->getNumSuccessors();
1178 for (unsigned i = 0; i < NumSucc; ++i) {
1179 if (OuterLoopHeaderBI->getSuccessor(i) == OuterLoopLatch)
1180 OuterLoopHeaderBI->setSuccessor(i, LoopExit);
1181 else if (OuterLoopHeaderBI->getSuccessor(i) == InnerLoopPreHeader)
1182 OuterLoopHeaderBI->setSuccessor(i, InnerLoopHeaderSuccessor);
1183 }
1184
1185 // Adjust reduction PHI's now that the incoming block has changed.
1186 updateIncomingBlock(InnerLoopHeaderSuccessor, InnerLoopHeader,
1187 OuterLoopHeader);
1188
1189 BranchInst::Create(OuterLoopPreHeader, InnerLoopHeaderBI);
1190 InnerLoopHeaderBI->eraseFromParent();
1191
1192 // -------------Adjust loop latches-----------
1193 if (InnerLoopLatchBI->getSuccessor(0) == InnerLoopHeader)
1194 InnerLoopLatchSuccessor = InnerLoopLatchBI->getSuccessor(1);
1195 else
1196 InnerLoopLatchSuccessor = InnerLoopLatchBI->getSuccessor(0);
1197
1198 NumSucc = InnerLoopLatchPredecessorBI->getNumSuccessors();
1199 for (unsigned i = 0; i < NumSucc; ++i) {
1200 if (InnerLoopLatchPredecessorBI->getSuccessor(i) == InnerLoopLatch)
1201 InnerLoopLatchPredecessorBI->setSuccessor(i, InnerLoopLatchSuccessor);
1202 }
1203
1204 // Adjust PHI nodes in InnerLoopLatchSuccessor. Update all uses of PHI with
1205 // the value and remove this PHI node from inner loop.
1206 SmallVector<PHINode *, 8> LcssaVec;
1207 for (auto I = InnerLoopLatchSuccessor->begin(); isa<PHINode>(I); ++I) {
1208 PHINode *LcssaPhi = cast<PHINode>(I);
1209 LcssaVec.push_back(LcssaPhi);
1210 }
1211 for (PHINode *P : LcssaVec) {
1212 Value *Incoming = P->getIncomingValueForBlock(InnerLoopLatch);
1213 P->replaceAllUsesWith(Incoming);
1214 P->eraseFromParent();
1215 }
1216
1217 if (OuterLoopLatchBI->getSuccessor(0) == OuterLoopHeader)
1218 OuterLoopLatchSuccessor = OuterLoopLatchBI->getSuccessor(1);
1219 else
1220 OuterLoopLatchSuccessor = OuterLoopLatchBI->getSuccessor(0);
1221
1222 if (InnerLoopLatchBI->getSuccessor(1) == InnerLoopLatchSuccessor)
1223 InnerLoopLatchBI->setSuccessor(1, OuterLoopLatchSuccessor);
1224 else
1225 InnerLoopLatchBI->setSuccessor(0, OuterLoopLatchSuccessor);
1226
1227 updateIncomingBlock(OuterLoopLatchSuccessor, OuterLoopLatch, InnerLoopLatch);
1228
1229 if (OuterLoopLatchBI->getSuccessor(0) == OuterLoopLatchSuccessor) {
1230 OuterLoopLatchBI->setSuccessor(0, InnerLoopLatch);
1231 } else {
1232 OuterLoopLatchBI->setSuccessor(1, InnerLoopLatch);
1233 }
1234
1235 return true;
1236 }
adjustLoopPreheaders()1237 void LoopInterchangeTransform::adjustLoopPreheaders() {
1238
1239 // We have interchanged the preheaders so we need to interchange the data in
1240 // the preheader as well.
1241 // This is because the content of inner preheader was previously executed
1242 // inside the outer loop.
1243 BasicBlock *OuterLoopPreHeader = OuterLoop->getLoopPreheader();
1244 BasicBlock *InnerLoopPreHeader = InnerLoop->getLoopPreheader();
1245 BasicBlock *OuterLoopHeader = OuterLoop->getHeader();
1246 BranchInst *InnerTermBI =
1247 cast<BranchInst>(InnerLoopPreHeader->getTerminator());
1248
1249 // These instructions should now be executed inside the loop.
1250 // Move instruction into a new block after outer header.
1251 moveBBContents(InnerLoopPreHeader, OuterLoopHeader->getTerminator());
1252 // These instructions were not executed previously in the loop so move them to
1253 // the older inner loop preheader.
1254 moveBBContents(OuterLoopPreHeader, InnerTermBI);
1255 }
1256
adjustLoopLinks()1257 bool LoopInterchangeTransform::adjustLoopLinks() {
1258
1259 // Adjust all branches in the inner and outer loop.
1260 bool Changed = adjustLoopBranches();
1261 if (Changed)
1262 adjustLoopPreheaders();
1263 return Changed;
1264 }
1265
1266 char LoopInterchange::ID = 0;
1267 INITIALIZE_PASS_BEGIN(LoopInterchange, "loop-interchange",
1268 "Interchanges loops for cache reuse", false, false)
INITIALIZE_PASS_DEPENDENCY(AAResultsWrapperPass)1269 INITIALIZE_PASS_DEPENDENCY(AAResultsWrapperPass)
1270 INITIALIZE_PASS_DEPENDENCY(DependenceAnalysisWrapperPass)
1271 INITIALIZE_PASS_DEPENDENCY(DominatorTreeWrapperPass)
1272 INITIALIZE_PASS_DEPENDENCY(ScalarEvolutionWrapperPass)
1273 INITIALIZE_PASS_DEPENDENCY(LoopSimplify)
1274 INITIALIZE_PASS_DEPENDENCY(LCSSAWrapperPass)
1275 INITIALIZE_PASS_DEPENDENCY(LoopInfoWrapperPass)
1276
1277 INITIALIZE_PASS_END(LoopInterchange, "loop-interchange",
1278 "Interchanges loops for cache reuse", false, false)
1279
1280 Pass *llvm::createLoopInterchangePass() { return new LoopInterchange(); }
1281