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