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