LLVM API Documentation
00001 //===- IndVarSimplify.cpp - Induction Variable Elimination ----------------===// 00002 // 00003 // The LLVM Compiler Infrastructure 00004 // 00005 // This file is distributed under the University of Illinois Open Source 00006 // License. See LICENSE.TXT for details. 00007 // 00008 //===----------------------------------------------------------------------===// 00009 // 00010 // This transformation analyzes and transforms the induction variables (and 00011 // computations derived from them) into simpler forms suitable for subsequent 00012 // analysis and transformation. 00013 // 00014 // If the trip count of a loop is computable, this pass also makes the following 00015 // changes: 00016 // 1. The exit condition for the loop is canonicalized to compare the 00017 // induction value against the exit value. This turns loops like: 00018 // 'for (i = 7; i*i < 1000; ++i)' into 'for (i = 0; i != 25; ++i)' 00019 // 2. Any use outside of the loop of an expression derived from the indvar 00020 // is changed to compute the derived value outside of the loop, eliminating 00021 // the dependence on the exit value of the induction variable. If the only 00022 // purpose of the loop is to compute the exit value of some derived 00023 // expression, this transformation will make the loop dead. 00024 // 00025 //===----------------------------------------------------------------------===// 00026 00027 #define DEBUG_TYPE "indvars" 00028 #include "llvm/Transforms/Scalar.h" 00029 #include "llvm/ADT/DenseMap.h" 00030 #include "llvm/ADT/SmallVector.h" 00031 #include "llvm/ADT/Statistic.h" 00032 #include "llvm/Analysis/Dominators.h" 00033 #include "llvm/Analysis/LoopInfo.h" 00034 #include "llvm/Analysis/LoopPass.h" 00035 #include "llvm/Analysis/ScalarEvolutionExpander.h" 00036 #include "llvm/IR/BasicBlock.h" 00037 #include "llvm/IR/Constants.h" 00038 #include "llvm/IR/DataLayout.h" 00039 #include "llvm/IR/Instructions.h" 00040 #include "llvm/IR/IntrinsicInst.h" 00041 #include "llvm/IR/LLVMContext.h" 00042 #include "llvm/IR/Type.h" 00043 #include "llvm/Support/CFG.h" 00044 #include "llvm/Support/CommandLine.h" 00045 #include "llvm/Support/Debug.h" 00046 #include "llvm/Support/raw_ostream.h" 00047 #include "llvm/Target/TargetLibraryInfo.h" 00048 #include "llvm/Transforms/Utils/BasicBlockUtils.h" 00049 #include "llvm/Transforms/Utils/Local.h" 00050 #include "llvm/Transforms/Utils/SimplifyIndVar.h" 00051 using namespace llvm; 00052 00053 STATISTIC(NumWidened , "Number of indvars widened"); 00054 STATISTIC(NumReplaced , "Number of exit values replaced"); 00055 STATISTIC(NumLFTR , "Number of loop exit tests replaced"); 00056 STATISTIC(NumElimExt , "Number of IV sign/zero extends eliminated"); 00057 STATISTIC(NumElimIV , "Number of congruent IVs eliminated"); 00058 00059 // Trip count verification can be enabled by default under NDEBUG if we 00060 // implement a strong expression equivalence checker in SCEV. Until then, we 00061 // use the verify-indvars flag, which may assert in some cases. 00062 static cl::opt<bool> VerifyIndvars( 00063 "verify-indvars", cl::Hidden, 00064 cl::desc("Verify the ScalarEvolution result after running indvars")); 00065 00066 namespace { 00067 class IndVarSimplify : public LoopPass { 00068 LoopInfo *LI; 00069 ScalarEvolution *SE; 00070 DominatorTree *DT; 00071 DataLayout *TD; 00072 TargetLibraryInfo *TLI; 00073 00074 SmallVector<WeakVH, 16> DeadInsts; 00075 bool Changed; 00076 public: 00077 00078 static char ID; // Pass identification, replacement for typeid 00079 IndVarSimplify() : LoopPass(ID), LI(0), SE(0), DT(0), TD(0), 00080 Changed(false) { 00081 initializeIndVarSimplifyPass(*PassRegistry::getPassRegistry()); 00082 } 00083 00084 virtual bool runOnLoop(Loop *L, LPPassManager &LPM); 00085 00086 virtual void getAnalysisUsage(AnalysisUsage &AU) const { 00087 AU.addRequired<DominatorTree>(); 00088 AU.addRequired<LoopInfo>(); 00089 AU.addRequired<ScalarEvolution>(); 00090 AU.addRequiredID(LoopSimplifyID); 00091 AU.addRequiredID(LCSSAID); 00092 AU.addPreserved<ScalarEvolution>(); 00093 AU.addPreservedID(LoopSimplifyID); 00094 AU.addPreservedID(LCSSAID); 00095 AU.setPreservesCFG(); 00096 } 00097 00098 private: 00099 virtual void releaseMemory() { 00100 DeadInsts.clear(); 00101 } 00102 00103 bool isValidRewrite(Value *FromVal, Value *ToVal); 00104 00105 void HandleFloatingPointIV(Loop *L, PHINode *PH); 00106 void RewriteNonIntegerIVs(Loop *L); 00107 00108 void SimplifyAndExtend(Loop *L, SCEVExpander &Rewriter, LPPassManager &LPM); 00109 00110 void RewriteLoopExitValues(Loop *L, SCEVExpander &Rewriter); 00111 00112 Value *LinearFunctionTestReplace(Loop *L, const SCEV *BackedgeTakenCount, 00113 PHINode *IndVar, SCEVExpander &Rewriter); 00114 00115 void SinkUnusedInvariants(Loop *L); 00116 }; 00117 } 00118 00119 char IndVarSimplify::ID = 0; 00120 INITIALIZE_PASS_BEGIN(IndVarSimplify, "indvars", 00121 "Induction Variable Simplification", false, false) 00122 INITIALIZE_PASS_DEPENDENCY(DominatorTree) 00123 INITIALIZE_PASS_DEPENDENCY(LoopInfo) 00124 INITIALIZE_PASS_DEPENDENCY(ScalarEvolution) 00125 INITIALIZE_PASS_DEPENDENCY(LoopSimplify) 00126 INITIALIZE_PASS_DEPENDENCY(LCSSA) 00127 INITIALIZE_PASS_END(IndVarSimplify, "indvars", 00128 "Induction Variable Simplification", false, false) 00129 00130 Pass *llvm::createIndVarSimplifyPass() { 00131 return new IndVarSimplify(); 00132 } 00133 00134 /// isValidRewrite - Return true if the SCEV expansion generated by the 00135 /// rewriter can replace the original value. SCEV guarantees that it 00136 /// produces the same value, but the way it is produced may be illegal IR. 00137 /// Ideally, this function will only be called for verification. 00138 bool IndVarSimplify::isValidRewrite(Value *FromVal, Value *ToVal) { 00139 // If an SCEV expression subsumed multiple pointers, its expansion could 00140 // reassociate the GEP changing the base pointer. This is illegal because the 00141 // final address produced by a GEP chain must be inbounds relative to its 00142 // underlying object. Otherwise basic alias analysis, among other things, 00143 // could fail in a dangerous way. Ultimately, SCEV will be improved to avoid 00144 // producing an expression involving multiple pointers. Until then, we must 00145 // bail out here. 00146 // 00147 // Retrieve the pointer operand of the GEP. Don't use GetUnderlyingObject 00148 // because it understands lcssa phis while SCEV does not. 00149 Value *FromPtr = FromVal; 00150 Value *ToPtr = ToVal; 00151 if (GEPOperator *GEP = dyn_cast<GEPOperator>(FromVal)) { 00152 FromPtr = GEP->getPointerOperand(); 00153 } 00154 if (GEPOperator *GEP = dyn_cast<GEPOperator>(ToVal)) { 00155 ToPtr = GEP->getPointerOperand(); 00156 } 00157 if (FromPtr != FromVal || ToPtr != ToVal) { 00158 // Quickly check the common case 00159 if (FromPtr == ToPtr) 00160 return true; 00161 00162 // SCEV may have rewritten an expression that produces the GEP's pointer 00163 // operand. That's ok as long as the pointer operand has the same base 00164 // pointer. Unlike GetUnderlyingObject(), getPointerBase() will find the 00165 // base of a recurrence. This handles the case in which SCEV expansion 00166 // converts a pointer type recurrence into a nonrecurrent pointer base 00167 // indexed by an integer recurrence. 00168 00169 // If the GEP base pointer is a vector of pointers, abort. 00170 if (!FromPtr->getType()->isPointerTy() || !ToPtr->getType()->isPointerTy()) 00171 return false; 00172 00173 const SCEV *FromBase = SE->getPointerBase(SE->getSCEV(FromPtr)); 00174 const SCEV *ToBase = SE->getPointerBase(SE->getSCEV(ToPtr)); 00175 if (FromBase == ToBase) 00176 return true; 00177 00178 DEBUG(dbgs() << "INDVARS: GEP rewrite bail out " 00179 << *FromBase << " != " << *ToBase << "\n"); 00180 00181 return false; 00182 } 00183 return true; 00184 } 00185 00186 /// Determine the insertion point for this user. By default, insert immediately 00187 /// before the user. SCEVExpander or LICM will hoist loop invariants out of the 00188 /// loop. For PHI nodes, there may be multiple uses, so compute the nearest 00189 /// common dominator for the incoming blocks. 00190 static Instruction *getInsertPointForUses(Instruction *User, Value *Def, 00191 DominatorTree *DT) { 00192 PHINode *PHI = dyn_cast<PHINode>(User); 00193 if (!PHI) 00194 return User; 00195 00196 Instruction *InsertPt = 0; 00197 for (unsigned i = 0, e = PHI->getNumIncomingValues(); i != e; ++i) { 00198 if (PHI->getIncomingValue(i) != Def) 00199 continue; 00200 00201 BasicBlock *InsertBB = PHI->getIncomingBlock(i); 00202 if (!InsertPt) { 00203 InsertPt = InsertBB->getTerminator(); 00204 continue; 00205 } 00206 InsertBB = DT->findNearestCommonDominator(InsertPt->getParent(), InsertBB); 00207 InsertPt = InsertBB->getTerminator(); 00208 } 00209 assert(InsertPt && "Missing phi operand"); 00210 assert((!isa<Instruction>(Def) || 00211 DT->dominates(cast<Instruction>(Def), InsertPt)) && 00212 "def does not dominate all uses"); 00213 return InsertPt; 00214 } 00215 00216 //===----------------------------------------------------------------------===// 00217 // RewriteNonIntegerIVs and helpers. Prefer integer IVs. 00218 //===----------------------------------------------------------------------===// 00219 00220 /// ConvertToSInt - Convert APF to an integer, if possible. 00221 static bool ConvertToSInt(const APFloat &APF, int64_t &IntVal) { 00222 bool isExact = false; 00223 // See if we can convert this to an int64_t 00224 uint64_t UIntVal; 00225 if (APF.convertToInteger(&UIntVal, 64, true, APFloat::rmTowardZero, 00226 &isExact) != APFloat::opOK || !isExact) 00227 return false; 00228 IntVal = UIntVal; 00229 return true; 00230 } 00231 00232 /// HandleFloatingPointIV - If the loop has floating induction variable 00233 /// then insert corresponding integer induction variable if possible. 00234 /// For example, 00235 /// for(double i = 0; i < 10000; ++i) 00236 /// bar(i) 00237 /// is converted into 00238 /// for(int i = 0; i < 10000; ++i) 00239 /// bar((double)i); 00240 /// 00241 void IndVarSimplify::HandleFloatingPointIV(Loop *L, PHINode *PN) { 00242 unsigned IncomingEdge = L->contains(PN->getIncomingBlock(0)); 00243 unsigned BackEdge = IncomingEdge^1; 00244 00245 // Check incoming value. 00246 ConstantFP *InitValueVal = 00247 dyn_cast<ConstantFP>(PN->getIncomingValue(IncomingEdge)); 00248 00249 int64_t InitValue; 00250 if (!InitValueVal || !ConvertToSInt(InitValueVal->getValueAPF(), InitValue)) 00251 return; 00252 00253 // Check IV increment. Reject this PN if increment operation is not 00254 // an add or increment value can not be represented by an integer. 00255 BinaryOperator *Incr = 00256 dyn_cast<BinaryOperator>(PN->getIncomingValue(BackEdge)); 00257 if (Incr == 0 || Incr->getOpcode() != Instruction::FAdd) return; 00258 00259 // If this is not an add of the PHI with a constantfp, or if the constant fp 00260 // is not an integer, bail out. 00261 ConstantFP *IncValueVal = dyn_cast<ConstantFP>(Incr->getOperand(1)); 00262 int64_t IncValue; 00263 if (IncValueVal == 0 || Incr->getOperand(0) != PN || 00264 !ConvertToSInt(IncValueVal->getValueAPF(), IncValue)) 00265 return; 00266 00267 // Check Incr uses. One user is PN and the other user is an exit condition 00268 // used by the conditional terminator. 00269 Value::use_iterator IncrUse = Incr->use_begin(); 00270 Instruction *U1 = cast<Instruction>(*IncrUse++); 00271 if (IncrUse == Incr->use_end()) return; 00272 Instruction *U2 = cast<Instruction>(*IncrUse++); 00273 if (IncrUse != Incr->use_end()) return; 00274 00275 // Find exit condition, which is an fcmp. If it doesn't exist, or if it isn't 00276 // only used by a branch, we can't transform it. 00277 FCmpInst *Compare = dyn_cast<FCmpInst>(U1); 00278 if (!Compare) 00279 Compare = dyn_cast<FCmpInst>(U2); 00280 if (Compare == 0 || !Compare->hasOneUse() || 00281 !isa<BranchInst>(Compare->use_back())) 00282 return; 00283 00284 BranchInst *TheBr = cast<BranchInst>(Compare->use_back()); 00285 00286 // We need to verify that the branch actually controls the iteration count 00287 // of the loop. If not, the new IV can overflow and no one will notice. 00288 // The branch block must be in the loop and one of the successors must be out 00289 // of the loop. 00290 assert(TheBr->isConditional() && "Can't use fcmp if not conditional"); 00291 if (!L->contains(TheBr->getParent()) || 00292 (L->contains(TheBr->getSuccessor(0)) && 00293 L->contains(TheBr->getSuccessor(1)))) 00294 return; 00295 00296 00297 // If it isn't a comparison with an integer-as-fp (the exit value), we can't 00298 // transform it. 00299 ConstantFP *ExitValueVal = dyn_cast<ConstantFP>(Compare->getOperand(1)); 00300 int64_t ExitValue; 00301 if (ExitValueVal == 0 || 00302 !ConvertToSInt(ExitValueVal->getValueAPF(), ExitValue)) 00303 return; 00304 00305 // Find new predicate for integer comparison. 00306 CmpInst::Predicate NewPred = CmpInst::BAD_ICMP_PREDICATE; 00307 switch (Compare->getPredicate()) { 00308 default: return; // Unknown comparison. 00309 case CmpInst::FCMP_OEQ: 00310 case CmpInst::FCMP_UEQ: NewPred = CmpInst::ICMP_EQ; break; 00311 case CmpInst::FCMP_ONE: 00312 case CmpInst::FCMP_UNE: NewPred = CmpInst::ICMP_NE; break; 00313 case CmpInst::FCMP_OGT: 00314 case CmpInst::FCMP_UGT: NewPred = CmpInst::ICMP_SGT; break; 00315 case CmpInst::FCMP_OGE: 00316 case CmpInst::FCMP_UGE: NewPred = CmpInst::ICMP_SGE; break; 00317 case CmpInst::FCMP_OLT: 00318 case CmpInst::FCMP_ULT: NewPred = CmpInst::ICMP_SLT; break; 00319 case CmpInst::FCMP_OLE: 00320 case CmpInst::FCMP_ULE: NewPred = CmpInst::ICMP_SLE; break; 00321 } 00322 00323 // We convert the floating point induction variable to a signed i32 value if 00324 // we can. This is only safe if the comparison will not overflow in a way 00325 // that won't be trapped by the integer equivalent operations. Check for this 00326 // now. 00327 // TODO: We could use i64 if it is native and the range requires it. 00328 00329 // The start/stride/exit values must all fit in signed i32. 00330 if (!isInt<32>(InitValue) || !isInt<32>(IncValue) || !isInt<32>(ExitValue)) 00331 return; 00332 00333 // If not actually striding (add x, 0.0), avoid touching the code. 00334 if (IncValue == 0) 00335 return; 00336 00337 // Positive and negative strides have different safety conditions. 00338 if (IncValue > 0) { 00339 // If we have a positive stride, we require the init to be less than the 00340 // exit value. 00341 if (InitValue >= ExitValue) 00342 return; 00343 00344 uint32_t Range = uint32_t(ExitValue-InitValue); 00345 // Check for infinite loop, either: 00346 // while (i <= Exit) or until (i > Exit) 00347 if (NewPred == CmpInst::ICMP_SLE || NewPred == CmpInst::ICMP_SGT) { 00348 if (++Range == 0) return; // Range overflows. 00349 } 00350 00351 unsigned Leftover = Range % uint32_t(IncValue); 00352 00353 // If this is an equality comparison, we require that the strided value 00354 // exactly land on the exit value, otherwise the IV condition will wrap 00355 // around and do things the fp IV wouldn't. 00356 if ((NewPred == CmpInst::ICMP_EQ || NewPred == CmpInst::ICMP_NE) && 00357 Leftover != 0) 00358 return; 00359 00360 // If the stride would wrap around the i32 before exiting, we can't 00361 // transform the IV. 00362 if (Leftover != 0 && int32_t(ExitValue+IncValue) < ExitValue) 00363 return; 00364 00365 } else { 00366 // If we have a negative stride, we require the init to be greater than the 00367 // exit value. 00368 if (InitValue <= ExitValue) 00369 return; 00370 00371 uint32_t Range = uint32_t(InitValue-ExitValue); 00372 // Check for infinite loop, either: 00373 // while (i >= Exit) or until (i < Exit) 00374 if (NewPred == CmpInst::ICMP_SGE || NewPred == CmpInst::ICMP_SLT) { 00375 if (++Range == 0) return; // Range overflows. 00376 } 00377 00378 unsigned Leftover = Range % uint32_t(-IncValue); 00379 00380 // If this is an equality comparison, we require that the strided value 00381 // exactly land on the exit value, otherwise the IV condition will wrap 00382 // around and do things the fp IV wouldn't. 00383 if ((NewPred == CmpInst::ICMP_EQ || NewPred == CmpInst::ICMP_NE) && 00384 Leftover != 0) 00385 return; 00386 00387 // If the stride would wrap around the i32 before exiting, we can't 00388 // transform the IV. 00389 if (Leftover != 0 && int32_t(ExitValue+IncValue) > ExitValue) 00390 return; 00391 } 00392 00393 IntegerType *Int32Ty = Type::getInt32Ty(PN->getContext()); 00394 00395 // Insert new integer induction variable. 00396 PHINode *NewPHI = PHINode::Create(Int32Ty, 2, PN->getName()+".int", PN); 00397 NewPHI->addIncoming(ConstantInt::get(Int32Ty, InitValue), 00398 PN->getIncomingBlock(IncomingEdge)); 00399 00400 Value *NewAdd = 00401 BinaryOperator::CreateAdd(NewPHI, ConstantInt::get(Int32Ty, IncValue), 00402 Incr->getName()+".int", Incr); 00403 NewPHI->addIncoming(NewAdd, PN->getIncomingBlock(BackEdge)); 00404 00405 ICmpInst *NewCompare = new ICmpInst(TheBr, NewPred, NewAdd, 00406 ConstantInt::get(Int32Ty, ExitValue), 00407 Compare->getName()); 00408 00409 // In the following deletions, PN may become dead and may be deleted. 00410 // Use a WeakVH to observe whether this happens. 00411 WeakVH WeakPH = PN; 00412 00413 // Delete the old floating point exit comparison. The branch starts using the 00414 // new comparison. 00415 NewCompare->takeName(Compare); 00416 Compare->replaceAllUsesWith(NewCompare); 00417 RecursivelyDeleteTriviallyDeadInstructions(Compare, TLI); 00418 00419 // Delete the old floating point increment. 00420 Incr->replaceAllUsesWith(UndefValue::get(Incr->getType())); 00421 RecursivelyDeleteTriviallyDeadInstructions(Incr, TLI); 00422 00423 // If the FP induction variable still has uses, this is because something else 00424 // in the loop uses its value. In order to canonicalize the induction 00425 // variable, we chose to eliminate the IV and rewrite it in terms of an 00426 // int->fp cast. 00427 // 00428 // We give preference to sitofp over uitofp because it is faster on most 00429 // platforms. 00430 if (WeakPH) { 00431 Value *Conv = new SIToFPInst(NewPHI, PN->getType(), "indvar.conv", 00432 PN->getParent()->getFirstInsertionPt()); 00433 PN->replaceAllUsesWith(Conv); 00434 RecursivelyDeleteTriviallyDeadInstructions(PN, TLI); 00435 } 00436 Changed = true; 00437 } 00438 00439 void IndVarSimplify::RewriteNonIntegerIVs(Loop *L) { 00440 // First step. Check to see if there are any floating-point recurrences. 00441 // If there are, change them into integer recurrences, permitting analysis by 00442 // the SCEV routines. 00443 // 00444 BasicBlock *Header = L->getHeader(); 00445 00446 SmallVector<WeakVH, 8> PHIs; 00447 for (BasicBlock::iterator I = Header->begin(); 00448 PHINode *PN = dyn_cast<PHINode>(I); ++I) 00449 PHIs.push_back(PN); 00450 00451 for (unsigned i = 0, e = PHIs.size(); i != e; ++i) 00452 if (PHINode *PN = dyn_cast_or_null<PHINode>(&*PHIs[i])) 00453 HandleFloatingPointIV(L, PN); 00454 00455 // If the loop previously had floating-point IV, ScalarEvolution 00456 // may not have been able to compute a trip count. Now that we've done some 00457 // re-writing, the trip count may be computable. 00458 if (Changed) 00459 SE->forgetLoop(L); 00460 } 00461 00462 //===----------------------------------------------------------------------===// 00463 // RewriteLoopExitValues - Optimize IV users outside the loop. 00464 // As a side effect, reduces the amount of IV processing within the loop. 00465 //===----------------------------------------------------------------------===// 00466 00467 /// RewriteLoopExitValues - Check to see if this loop has a computable 00468 /// loop-invariant execution count. If so, this means that we can compute the 00469 /// final value of any expressions that are recurrent in the loop, and 00470 /// substitute the exit values from the loop into any instructions outside of 00471 /// the loop that use the final values of the current expressions. 00472 /// 00473 /// This is mostly redundant with the regular IndVarSimplify activities that 00474 /// happen later, except that it's more powerful in some cases, because it's 00475 /// able to brute-force evaluate arbitrary instructions as long as they have 00476 /// constant operands at the beginning of the loop. 00477 void IndVarSimplify::RewriteLoopExitValues(Loop *L, SCEVExpander &Rewriter) { 00478 // Verify the input to the pass in already in LCSSA form. 00479 assert(L->isLCSSAForm(*DT)); 00480 00481 SmallVector<BasicBlock*, 8> ExitBlocks; 00482 L->getUniqueExitBlocks(ExitBlocks); 00483 00484 // Find all values that are computed inside the loop, but used outside of it. 00485 // Because of LCSSA, these values will only occur in LCSSA PHI Nodes. Scan 00486 // the exit blocks of the loop to find them. 00487 for (unsigned i = 0, e = ExitBlocks.size(); i != e; ++i) { 00488 BasicBlock *ExitBB = ExitBlocks[i]; 00489 00490 // If there are no PHI nodes in this exit block, then no values defined 00491 // inside the loop are used on this path, skip it. 00492 PHINode *PN = dyn_cast<PHINode>(ExitBB->begin()); 00493 if (!PN) continue; 00494 00495 unsigned NumPreds = PN->getNumIncomingValues(); 00496 00497 // Iterate over all of the PHI nodes. 00498 BasicBlock::iterator BBI = ExitBB->begin(); 00499 while ((PN = dyn_cast<PHINode>(BBI++))) { 00500 if (PN->use_empty()) 00501 continue; // dead use, don't replace it 00502 00503 // SCEV only supports integer expressions for now. 00504 if (!PN->getType()->isIntegerTy() && !PN->getType()->isPointerTy()) 00505 continue; 00506 00507 // It's necessary to tell ScalarEvolution about this explicitly so that 00508 // it can walk the def-use list and forget all SCEVs, as it may not be 00509 // watching the PHI itself. Once the new exit value is in place, there 00510 // may not be a def-use connection between the loop and every instruction 00511 // which got a SCEVAddRecExpr for that loop. 00512 SE->forgetValue(PN); 00513 00514 // Iterate over all of the values in all the PHI nodes. 00515 for (unsigned i = 0; i != NumPreds; ++i) { 00516 // If the value being merged in is not integer or is not defined 00517 // in the loop, skip it. 00518 Value *InVal = PN->getIncomingValue(i); 00519 if (!isa<Instruction>(InVal)) 00520 continue; 00521 00522 // If this pred is for a subloop, not L itself, skip it. 00523 if (LI->getLoopFor(PN->getIncomingBlock(i)) != L) 00524 continue; // The Block is in a subloop, skip it. 00525 00526 // Check that InVal is defined in the loop. 00527 Instruction *Inst = cast<Instruction>(InVal); 00528 if (!L->contains(Inst)) 00529 continue; 00530 00531 // Okay, this instruction has a user outside of the current loop 00532 // and varies predictably *inside* the loop. Evaluate the value it 00533 // contains when the loop exits, if possible. 00534 const SCEV *ExitValue = SE->getSCEVAtScope(Inst, L->getParentLoop()); 00535 if (!SE->isLoopInvariant(ExitValue, L)) 00536 continue; 00537 00538 // Computing the value outside of the loop brings no benefit if : 00539 // - it is definitely used inside the loop in a way which can not be 00540 // optimized away. 00541 // - no use outside of the loop can take advantage of hoisting the 00542 // computation out of the loop 00543 if (ExitValue->getSCEVType()>=scMulExpr) { 00544 unsigned NumHardInternalUses = 0; 00545 unsigned NumSoftExternalUses = 0; 00546 unsigned NumUses = 0; 00547 for (Value::use_iterator IB=Inst->use_begin(), IE=Inst->use_end(); 00548 IB!=IE && NumUses<=6 ; ++IB) { 00549 Instruction *UseInstr = cast<Instruction>(*IB); 00550 unsigned Opc = UseInstr->getOpcode(); 00551 NumUses++; 00552 if (L->contains(UseInstr)) { 00553 if (Opc == Instruction::Call || Opc == Instruction::Ret) 00554 NumHardInternalUses++; 00555 } else { 00556 if (Opc == Instruction::PHI) { 00557 // Do not count the Phi as a use. LCSSA may have inserted 00558 // plenty of trivial ones. 00559 NumUses--; 00560 for (Value::use_iterator PB=UseInstr->use_begin(), 00561 PE=UseInstr->use_end(); 00562 PB!=PE && NumUses<=6 ; ++PB, ++NumUses) { 00563 unsigned PhiOpc = cast<Instruction>(*PB)->getOpcode(); 00564 if (PhiOpc != Instruction::Call && PhiOpc != Instruction::Ret) 00565 NumSoftExternalUses++; 00566 } 00567 continue; 00568 } 00569 if (Opc != Instruction::Call && Opc != Instruction::Ret) 00570 NumSoftExternalUses++; 00571 } 00572 } 00573 if (NumUses <= 6 && NumHardInternalUses && !NumSoftExternalUses) 00574 continue; 00575 } 00576 00577 Value *ExitVal = Rewriter.expandCodeFor(ExitValue, PN->getType(), Inst); 00578 00579 DEBUG(dbgs() << "INDVARS: RLEV: AfterLoopVal = " << *ExitVal << '\n' 00580 << " LoopVal = " << *Inst << "\n"); 00581 00582 if (!isValidRewrite(Inst, ExitVal)) { 00583 DeadInsts.push_back(ExitVal); 00584 continue; 00585 } 00586 Changed = true; 00587 ++NumReplaced; 00588 00589 PN->setIncomingValue(i, ExitVal); 00590 00591 // If this instruction is dead now, delete it. Don't do it now to avoid 00592 // invalidating iterators. 00593 if (isInstructionTriviallyDead(Inst, TLI)) 00594 DeadInsts.push_back(Inst); 00595 00596 if (NumPreds == 1) { 00597 // Completely replace a single-pred PHI. This is safe, because the 00598 // NewVal won't be variant in the loop, so we don't need an LCSSA phi 00599 // node anymore. 00600 PN->replaceAllUsesWith(ExitVal); 00601 PN->eraseFromParent(); 00602 } 00603 } 00604 if (NumPreds != 1) { 00605 // Clone the PHI and delete the original one. This lets IVUsers and 00606 // any other maps purge the original user from their records. 00607 PHINode *NewPN = cast<PHINode>(PN->clone()); 00608 NewPN->takeName(PN); 00609 NewPN->insertBefore(PN); 00610 PN->replaceAllUsesWith(NewPN); 00611 PN->eraseFromParent(); 00612 } 00613 } 00614 } 00615 00616 // The insertion point instruction may have been deleted; clear it out 00617 // so that the rewriter doesn't trip over it later. 00618 Rewriter.clearInsertPoint(); 00619 } 00620 00621 //===----------------------------------------------------------------------===// 00622 // IV Widening - Extend the width of an IV to cover its widest uses. 00623 //===----------------------------------------------------------------------===// 00624 00625 namespace { 00626 // Collect information about induction variables that are used by sign/zero 00627 // extend operations. This information is recorded by CollectExtend and 00628 // provides the input to WidenIV. 00629 struct WideIVInfo { 00630 PHINode *NarrowIV; 00631 Type *WidestNativeType; // Widest integer type created [sz]ext 00632 bool IsSigned; // Was an sext user seen before a zext? 00633 00634 WideIVInfo() : NarrowIV(0), WidestNativeType(0), IsSigned(false) {} 00635 }; 00636 00637 class WideIVVisitor : public IVVisitor { 00638 ScalarEvolution *SE; 00639 const DataLayout *TD; 00640 00641 public: 00642 WideIVInfo WI; 00643 00644 WideIVVisitor(PHINode *NarrowIV, ScalarEvolution *SCEV, 00645 const DataLayout *TData) : 00646 SE(SCEV), TD(TData) { WI.NarrowIV = NarrowIV; } 00647 00648 // Implement the interface used by simplifyUsersOfIV. 00649 virtual void visitCast(CastInst *Cast); 00650 }; 00651 } 00652 00653 /// visitCast - Update information about the induction variable that is 00654 /// extended by this sign or zero extend operation. This is used to determine 00655 /// the final width of the IV before actually widening it. 00656 void WideIVVisitor::visitCast(CastInst *Cast) { 00657 bool IsSigned = Cast->getOpcode() == Instruction::SExt; 00658 if (!IsSigned && Cast->getOpcode() != Instruction::ZExt) 00659 return; 00660 00661 Type *Ty = Cast->getType(); 00662 uint64_t Width = SE->getTypeSizeInBits(Ty); 00663 if (TD && !TD->isLegalInteger(Width)) 00664 return; 00665 00666 if (!WI.WidestNativeType) { 00667 WI.WidestNativeType = SE->getEffectiveSCEVType(Ty); 00668 WI.IsSigned = IsSigned; 00669 return; 00670 } 00671 00672 // We extend the IV to satisfy the sign of its first user, arbitrarily. 00673 if (WI.IsSigned != IsSigned) 00674 return; 00675 00676 if (Width > SE->getTypeSizeInBits(WI.WidestNativeType)) 00677 WI.WidestNativeType = SE->getEffectiveSCEVType(Ty); 00678 } 00679 00680 namespace { 00681 00682 /// NarrowIVDefUse - Record a link in the Narrow IV def-use chain along with the 00683 /// WideIV that computes the same value as the Narrow IV def. This avoids 00684 /// caching Use* pointers. 00685 struct NarrowIVDefUse { 00686 Instruction *NarrowDef; 00687 Instruction *NarrowUse; 00688 Instruction *WideDef; 00689 00690 NarrowIVDefUse(): NarrowDef(0), NarrowUse(0), WideDef(0) {} 00691 00692 NarrowIVDefUse(Instruction *ND, Instruction *NU, Instruction *WD): 00693 NarrowDef(ND), NarrowUse(NU), WideDef(WD) {} 00694 }; 00695 00696 /// WidenIV - The goal of this transform is to remove sign and zero extends 00697 /// without creating any new induction variables. To do this, it creates a new 00698 /// phi of the wider type and redirects all users, either removing extends or 00699 /// inserting truncs whenever we stop propagating the type. 00700 /// 00701 class WidenIV { 00702 // Parameters 00703 PHINode *OrigPhi; 00704 Type *WideType; 00705 bool IsSigned; 00706 00707 // Context 00708 LoopInfo *LI; 00709 Loop *L; 00710 ScalarEvolution *SE; 00711 DominatorTree *DT; 00712 00713 // Result 00714 PHINode *WidePhi; 00715 Instruction *WideInc; 00716 const SCEV *WideIncExpr; 00717 SmallVectorImpl<WeakVH> &DeadInsts; 00718 00719 SmallPtrSet<Instruction*,16> Widened; 00720 SmallVector<NarrowIVDefUse, 8> NarrowIVUsers; 00721 00722 public: 00723 WidenIV(const WideIVInfo &WI, LoopInfo *LInfo, 00724 ScalarEvolution *SEv, DominatorTree *DTree, 00725 SmallVectorImpl<WeakVH> &DI) : 00726 OrigPhi(WI.NarrowIV), 00727 WideType(WI.WidestNativeType), 00728 IsSigned(WI.IsSigned), 00729 LI(LInfo), 00730 L(LI->getLoopFor(OrigPhi->getParent())), 00731 SE(SEv), 00732 DT(DTree), 00733 WidePhi(0), 00734 WideInc(0), 00735 WideIncExpr(0), 00736 DeadInsts(DI) { 00737 assert(L->getHeader() == OrigPhi->getParent() && "Phi must be an IV"); 00738 } 00739 00740 PHINode *CreateWideIV(SCEVExpander &Rewriter); 00741 00742 protected: 00743 Value *getExtend(Value *NarrowOper, Type *WideType, bool IsSigned, 00744 Instruction *Use); 00745 00746 Instruction *CloneIVUser(NarrowIVDefUse DU); 00747 00748 const SCEVAddRecExpr *GetWideRecurrence(Instruction *NarrowUse); 00749 00750 const SCEVAddRecExpr* GetExtendedOperandRecurrence(NarrowIVDefUse DU); 00751 00752 Instruction *WidenIVUse(NarrowIVDefUse DU, SCEVExpander &Rewriter); 00753 00754 void pushNarrowIVUsers(Instruction *NarrowDef, Instruction *WideDef); 00755 }; 00756 } // anonymous namespace 00757 00758 /// isLoopInvariant - Perform a quick domtree based check for loop invariance 00759 /// assuming that V is used within the loop. LoopInfo::isLoopInvariant() seems 00760 /// gratuitous for this purpose. 00761 static bool isLoopInvariant(Value *V, const Loop *L, const DominatorTree *DT) { 00762 Instruction *Inst = dyn_cast<Instruction>(V); 00763 if (!Inst) 00764 return true; 00765 00766 return DT->properlyDominates(Inst->getParent(), L->getHeader()); 00767 } 00768 00769 Value *WidenIV::getExtend(Value *NarrowOper, Type *WideType, bool IsSigned, 00770 Instruction *Use) { 00771 // Set the debug location and conservative insertion point. 00772 IRBuilder<> Builder(Use); 00773 // Hoist the insertion point into loop preheaders as far as possible. 00774 for (const Loop *L = LI->getLoopFor(Use->getParent()); 00775 L && L->getLoopPreheader() && isLoopInvariant(NarrowOper, L, DT); 00776 L = L->getParentLoop()) 00777 Builder.SetInsertPoint(L->getLoopPreheader()->getTerminator()); 00778 00779 return IsSigned ? Builder.CreateSExt(NarrowOper, WideType) : 00780 Builder.CreateZExt(NarrowOper, WideType); 00781 } 00782 00783 /// CloneIVUser - Instantiate a wide operation to replace a narrow 00784 /// operation. This only needs to handle operations that can evaluation to 00785 /// SCEVAddRec. It can safely return 0 for any operation we decide not to clone. 00786 Instruction *WidenIV::CloneIVUser(NarrowIVDefUse DU) { 00787 unsigned Opcode = DU.NarrowUse->getOpcode(); 00788 switch (Opcode) { 00789 default: 00790 return 0; 00791 case Instruction::Add: 00792 case Instruction::Mul: 00793 case Instruction::UDiv: 00794 case Instruction::Sub: 00795 case Instruction::And: 00796 case Instruction::Or: 00797 case Instruction::Xor: 00798 case Instruction::Shl: 00799 case Instruction::LShr: 00800 case Instruction::AShr: 00801 DEBUG(dbgs() << "Cloning IVUser: " << *DU.NarrowUse << "\n"); 00802 00803 // Replace NarrowDef operands with WideDef. Otherwise, we don't know 00804 // anything about the narrow operand yet so must insert a [sz]ext. It is 00805 // probably loop invariant and will be folded or hoisted. If it actually 00806 // comes from a widened IV, it should be removed during a future call to 00807 // WidenIVUse. 00808 Value *LHS = (DU.NarrowUse->getOperand(0) == DU.NarrowDef) ? DU.WideDef : 00809 getExtend(DU.NarrowUse->getOperand(0), WideType, IsSigned, DU.NarrowUse); 00810 Value *RHS = (DU.NarrowUse->getOperand(1) == DU.NarrowDef) ? DU.WideDef : 00811 getExtend(DU.NarrowUse->getOperand(1), WideType, IsSigned, DU.NarrowUse); 00812 00813 BinaryOperator *NarrowBO = cast<BinaryOperator>(DU.NarrowUse); 00814 BinaryOperator *WideBO = BinaryOperator::Create(NarrowBO->getOpcode(), 00815 LHS, RHS, 00816 NarrowBO->getName()); 00817 IRBuilder<> Builder(DU.NarrowUse); 00818 Builder.Insert(WideBO); 00819 if (const OverflowingBinaryOperator *OBO = 00820 dyn_cast<OverflowingBinaryOperator>(NarrowBO)) { 00821 if (OBO->hasNoUnsignedWrap()) WideBO->setHasNoUnsignedWrap(); 00822 if (OBO->hasNoSignedWrap()) WideBO->setHasNoSignedWrap(); 00823 } 00824 return WideBO; 00825 } 00826 } 00827 00828 /// No-wrap operations can transfer sign extension of their result to their 00829 /// operands. Generate the SCEV value for the widened operation without 00830 /// actually modifying the IR yet. If the expression after extending the 00831 /// operands is an AddRec for this loop, return it. 00832 const SCEVAddRecExpr* WidenIV::GetExtendedOperandRecurrence(NarrowIVDefUse DU) { 00833 // Handle the common case of add<nsw/nuw> 00834 if (DU.NarrowUse->getOpcode() != Instruction::Add) 00835 return 0; 00836 00837 // One operand (NarrowDef) has already been extended to WideDef. Now determine 00838 // if extending the other will lead to a recurrence. 00839 unsigned ExtendOperIdx = DU.NarrowUse->getOperand(0) == DU.NarrowDef ? 1 : 0; 00840 assert(DU.NarrowUse->getOperand(1-ExtendOperIdx) == DU.NarrowDef && "bad DU"); 00841 00842 const SCEV *ExtendOperExpr = 0; 00843 const OverflowingBinaryOperator *OBO = 00844 cast<OverflowingBinaryOperator>(DU.NarrowUse); 00845 if (IsSigned && OBO->hasNoSignedWrap()) 00846 ExtendOperExpr = SE->getSignExtendExpr( 00847 SE->getSCEV(DU.NarrowUse->getOperand(ExtendOperIdx)), WideType); 00848 else if(!IsSigned && OBO->hasNoUnsignedWrap()) 00849 ExtendOperExpr = SE->getZeroExtendExpr( 00850 SE->getSCEV(DU.NarrowUse->getOperand(ExtendOperIdx)), WideType); 00851 else 00852 return 0; 00853 00854 // When creating this AddExpr, don't apply the current operations NSW or NUW 00855 // flags. This instruction may be guarded by control flow that the no-wrap 00856 // behavior depends on. Non-control-equivalent instructions can be mapped to 00857 // the same SCEV expression, and it would be incorrect to transfer NSW/NUW 00858 // semantics to those operations. 00859 const SCEVAddRecExpr *AddRec = dyn_cast<SCEVAddRecExpr>( 00860 SE->getAddExpr(SE->getSCEV(DU.WideDef), ExtendOperExpr)); 00861 00862 if (!AddRec || AddRec->getLoop() != L) 00863 return 0; 00864 return AddRec; 00865 } 00866 00867 /// GetWideRecurrence - Is this instruction potentially interesting from 00868 /// IVUsers' perspective after widening it's type? In other words, can the 00869 /// extend be safely hoisted out of the loop with SCEV reducing the value to a 00870 /// recurrence on the same loop. If so, return the sign or zero extended 00871 /// recurrence. Otherwise return NULL. 00872 const SCEVAddRecExpr *WidenIV::GetWideRecurrence(Instruction *NarrowUse) { 00873 if (!SE->isSCEVable(NarrowUse->getType())) 00874 return 0; 00875 00876 const SCEV *NarrowExpr = SE->getSCEV(NarrowUse); 00877 if (SE->getTypeSizeInBits(NarrowExpr->getType()) 00878 >= SE->getTypeSizeInBits(WideType)) { 00879 // NarrowUse implicitly widens its operand. e.g. a gep with a narrow 00880 // index. So don't follow this use. 00881 return 0; 00882 } 00883 00884 const SCEV *WideExpr = IsSigned ? 00885 SE->getSignExtendExpr(NarrowExpr, WideType) : 00886 SE->getZeroExtendExpr(NarrowExpr, WideType); 00887 const SCEVAddRecExpr *AddRec = dyn_cast<SCEVAddRecExpr>(WideExpr); 00888 if (!AddRec || AddRec->getLoop() != L) 00889 return 0; 00890 return AddRec; 00891 } 00892 00893 /// WidenIVUse - Determine whether an individual user of the narrow IV can be 00894 /// widened. If so, return the wide clone of the user. 00895 Instruction *WidenIV::WidenIVUse(NarrowIVDefUse DU, SCEVExpander &Rewriter) { 00896 00897 // Stop traversing the def-use chain at inner-loop phis or post-loop phis. 00898 if (isa<PHINode>(DU.NarrowUse) && 00899 LI->getLoopFor(DU.NarrowUse->getParent()) != L) 00900 return 0; 00901 00902 // Our raison d'etre! Eliminate sign and zero extension. 00903 if (IsSigned ? isa<SExtInst>(DU.NarrowUse) : isa<ZExtInst>(DU.NarrowUse)) { 00904 Value *NewDef = DU.WideDef; 00905 if (DU.NarrowUse->getType() != WideType) { 00906 unsigned CastWidth = SE->getTypeSizeInBits(DU.NarrowUse->getType()); 00907 unsigned IVWidth = SE->getTypeSizeInBits(WideType); 00908 if (CastWidth < IVWidth) { 00909 // The cast isn't as wide as the IV, so insert a Trunc. 00910 IRBuilder<> Builder(DU.NarrowUse); 00911 NewDef = Builder.CreateTrunc(DU.WideDef, DU.NarrowUse->getType()); 00912 } 00913 else { 00914 // A wider extend was hidden behind a narrower one. This may induce 00915 // another round of IV widening in which the intermediate IV becomes 00916 // dead. It should be very rare. 00917 DEBUG(dbgs() << "INDVARS: New IV " << *WidePhi 00918 << " not wide enough to subsume " << *DU.NarrowUse << "\n"); 00919 DU.NarrowUse->replaceUsesOfWith(DU.NarrowDef, DU.WideDef); 00920 NewDef = DU.NarrowUse; 00921 } 00922 } 00923 if (NewDef != DU.NarrowUse) { 00924 DEBUG(dbgs() << "INDVARS: eliminating " << *DU.NarrowUse 00925 << " replaced by " << *DU.WideDef << "\n"); 00926 ++NumElimExt; 00927 DU.NarrowUse->replaceAllUsesWith(NewDef); 00928 DeadInsts.push_back(DU.NarrowUse); 00929 } 00930 // Now that the extend is gone, we want to expose it's uses for potential 00931 // further simplification. We don't need to directly inform SimplifyIVUsers 00932 // of the new users, because their parent IV will be processed later as a 00933 // new loop phi. If we preserved IVUsers analysis, we would also want to 00934 // push the uses of WideDef here. 00935 00936 // No further widening is needed. The deceased [sz]ext had done it for us. 00937 return 0; 00938 } 00939 00940 // Does this user itself evaluate to a recurrence after widening? 00941 const SCEVAddRecExpr *WideAddRec = GetWideRecurrence(DU.NarrowUse); 00942 if (!WideAddRec) { 00943 WideAddRec = GetExtendedOperandRecurrence(DU); 00944 } 00945 if (!WideAddRec) { 00946 // This user does not evaluate to a recurence after widening, so don't 00947 // follow it. Instead insert a Trunc to kill off the original use, 00948 // eventually isolating the original narrow IV so it can be removed. 00949 IRBuilder<> Builder(getInsertPointForUses(DU.NarrowUse, DU.NarrowDef, DT)); 00950 Value *Trunc = Builder.CreateTrunc(DU.WideDef, DU.NarrowDef->getType()); 00951 DU.NarrowUse->replaceUsesOfWith(DU.NarrowDef, Trunc); 00952 return 0; 00953 } 00954 // Assume block terminators cannot evaluate to a recurrence. We can't to 00955 // insert a Trunc after a terminator if there happens to be a critical edge. 00956 assert(DU.NarrowUse != DU.NarrowUse->getParent()->getTerminator() && 00957 "SCEV is not expected to evaluate a block terminator"); 00958 00959 // Reuse the IV increment that SCEVExpander created as long as it dominates 00960 // NarrowUse. 00961 Instruction *WideUse = 0; 00962 if (WideAddRec == WideIncExpr 00963 && Rewriter.hoistIVInc(WideInc, DU.NarrowUse)) 00964 WideUse = WideInc; 00965 else { 00966 WideUse = CloneIVUser(DU); 00967 if (!WideUse) 00968 return 0; 00969 } 00970 // Evaluation of WideAddRec ensured that the narrow expression could be 00971 // extended outside the loop without overflow. This suggests that the wide use 00972 // evaluates to the same expression as the extended narrow use, but doesn't 00973 // absolutely guarantee it. Hence the following failsafe check. In rare cases 00974 // where it fails, we simply throw away the newly created wide use. 00975 if (WideAddRec != SE->getSCEV(WideUse)) { 00976 DEBUG(dbgs() << "Wide use expression mismatch: " << *WideUse 00977 << ": " << *SE->getSCEV(WideUse) << " != " << *WideAddRec << "\n"); 00978 DeadInsts.push_back(WideUse); 00979 return 0; 00980 } 00981 00982 // Returning WideUse pushes it on the worklist. 00983 return WideUse; 00984 } 00985 00986 /// pushNarrowIVUsers - Add eligible users of NarrowDef to NarrowIVUsers. 00987 /// 00988 void WidenIV::pushNarrowIVUsers(Instruction *NarrowDef, Instruction *WideDef) { 00989 for (Value::use_iterator UI = NarrowDef->use_begin(), 00990 UE = NarrowDef->use_end(); UI != UE; ++UI) { 00991 Instruction *NarrowUse = cast<Instruction>(*UI); 00992 00993 // Handle data flow merges and bizarre phi cycles. 00994 if (!Widened.insert(NarrowUse)) 00995 continue; 00996 00997 NarrowIVUsers.push_back(NarrowIVDefUse(NarrowDef, NarrowUse, WideDef)); 00998 } 00999 } 01000 01001 /// CreateWideIV - Process a single induction variable. First use the 01002 /// SCEVExpander to create a wide induction variable that evaluates to the same 01003 /// recurrence as the original narrow IV. Then use a worklist to forward 01004 /// traverse the narrow IV's def-use chain. After WidenIVUse has processed all 01005 /// interesting IV users, the narrow IV will be isolated for removal by 01006 /// DeleteDeadPHIs. 01007 /// 01008 /// It would be simpler to delete uses as they are processed, but we must avoid 01009 /// invalidating SCEV expressions. 01010 /// 01011 PHINode *WidenIV::CreateWideIV(SCEVExpander &Rewriter) { 01012 // Is this phi an induction variable? 01013 const SCEVAddRecExpr *AddRec = dyn_cast<SCEVAddRecExpr>(SE->getSCEV(OrigPhi)); 01014 if (!AddRec) 01015 return NULL; 01016 01017 // Widen the induction variable expression. 01018 const SCEV *WideIVExpr = IsSigned ? 01019 SE->getSignExtendExpr(AddRec, WideType) : 01020 SE->getZeroExtendExpr(AddRec, WideType); 01021 01022 assert(SE->getEffectiveSCEVType(WideIVExpr->getType()) == WideType && 01023 "Expect the new IV expression to preserve its type"); 01024 01025 // Can the IV be extended outside the loop without overflow? 01026 AddRec = dyn_cast<SCEVAddRecExpr>(WideIVExpr); 01027 if (!AddRec || AddRec->getLoop() != L) 01028 return NULL; 01029 01030 // An AddRec must have loop-invariant operands. Since this AddRec is 01031 // materialized by a loop header phi, the expression cannot have any post-loop 01032 // operands, so they must dominate the loop header. 01033 assert(SE->properlyDominates(AddRec->getStart(), L->getHeader()) && 01034 SE->properlyDominates(AddRec->getStepRecurrence(*SE), L->getHeader()) 01035 && "Loop header phi recurrence inputs do not dominate the loop"); 01036 01037 // The rewriter provides a value for the desired IV expression. This may 01038 // either find an existing phi or materialize a new one. Either way, we 01039 // expect a well-formed cyclic phi-with-increments. i.e. any operand not part 01040 // of the phi-SCC dominates the loop entry. 01041 Instruction *InsertPt = L->getHeader()->begin(); 01042 WidePhi = cast<PHINode>(Rewriter.expandCodeFor(AddRec, WideType, InsertPt)); 01043 01044 // Remembering the WideIV increment generated by SCEVExpander allows 01045 // WidenIVUse to reuse it when widening the narrow IV's increment. We don't 01046 // employ a general reuse mechanism because the call above is the only call to 01047 // SCEVExpander. Henceforth, we produce 1-to-1 narrow to wide uses. 01048 if (BasicBlock *LatchBlock = L->getLoopLatch()) { 01049 WideInc = 01050 cast<Instruction>(WidePhi->getIncomingValueForBlock(LatchBlock)); 01051 WideIncExpr = SE->getSCEV(WideInc); 01052 } 01053 01054 DEBUG(dbgs() << "Wide IV: " << *WidePhi << "\n"); 01055 ++NumWidened; 01056 01057 // Traverse the def-use chain using a worklist starting at the original IV. 01058 assert(Widened.empty() && NarrowIVUsers.empty() && "expect initial state" ); 01059 01060 Widened.insert(OrigPhi); 01061 pushNarrowIVUsers(OrigPhi, WidePhi); 01062 01063 while (!NarrowIVUsers.empty()) { 01064 NarrowIVDefUse DU = NarrowIVUsers.pop_back_val(); 01065 01066 // Process a def-use edge. This may replace the use, so don't hold a 01067 // use_iterator across it. 01068 Instruction *WideUse = WidenIVUse(DU, Rewriter); 01069 01070 // Follow all def-use edges from the previous narrow use. 01071 if (WideUse) 01072 pushNarrowIVUsers(DU.NarrowUse, WideUse); 01073 01074 // WidenIVUse may have removed the def-use edge. 01075 if (DU.NarrowDef->use_empty()) 01076 DeadInsts.push_back(DU.NarrowDef); 01077 } 01078 return WidePhi; 01079 } 01080 01081 //===----------------------------------------------------------------------===// 01082 // Simplification of IV users based on SCEV evaluation. 01083 //===----------------------------------------------------------------------===// 01084 01085 01086 /// SimplifyAndExtend - Iteratively perform simplification on a worklist of IV 01087 /// users. Each successive simplification may push more users which may 01088 /// themselves be candidates for simplification. 01089 /// 01090 /// Sign/Zero extend elimination is interleaved with IV simplification. 01091 /// 01092 void IndVarSimplify::SimplifyAndExtend(Loop *L, 01093 SCEVExpander &Rewriter, 01094 LPPassManager &LPM) { 01095 SmallVector<WideIVInfo, 8> WideIVs; 01096 01097 SmallVector<PHINode*, 8> LoopPhis; 01098 for (BasicBlock::iterator I = L->getHeader()->begin(); isa<PHINode>(I); ++I) { 01099 LoopPhis.push_back(cast<PHINode>(I)); 01100 } 01101 // Each round of simplification iterates through the SimplifyIVUsers worklist 01102 // for all current phis, then determines whether any IVs can be 01103 // widened. Widening adds new phis to LoopPhis, inducing another round of 01104 // simplification on the wide IVs. 01105 while (!LoopPhis.empty()) { 01106 // Evaluate as many IV expressions as possible before widening any IVs. This 01107 // forces SCEV to set no-wrap flags before evaluating sign/zero 01108 // extension. The first time SCEV attempts to normalize sign/zero extension, 01109 // the result becomes final. So for the most predictable results, we delay 01110 // evaluation of sign/zero extend evaluation until needed, and avoid running 01111 // other SCEV based analysis prior to SimplifyAndExtend. 01112 do { 01113 PHINode *CurrIV = LoopPhis.pop_back_val(); 01114 01115 // Information about sign/zero extensions of CurrIV. 01116 WideIVVisitor WIV(CurrIV, SE, TD); 01117 01118 Changed |= simplifyUsersOfIV(CurrIV, SE, &LPM, DeadInsts, &WIV); 01119 01120 if (WIV.WI.WidestNativeType) { 01121 WideIVs.push_back(WIV.WI); 01122 } 01123 } while(!LoopPhis.empty()); 01124 01125 for (; !WideIVs.empty(); WideIVs.pop_back()) { 01126 WidenIV Widener(WideIVs.back(), LI, SE, DT, DeadInsts); 01127 if (PHINode *WidePhi = Widener.CreateWideIV(Rewriter)) { 01128 Changed = true; 01129 LoopPhis.push_back(WidePhi); 01130 } 01131 } 01132 } 01133 } 01134 01135 //===----------------------------------------------------------------------===// 01136 // LinearFunctionTestReplace and its kin. Rewrite the loop exit condition. 01137 //===----------------------------------------------------------------------===// 01138 01139 /// Check for expressions that ScalarEvolution generates to compute 01140 /// BackedgeTakenInfo. If these expressions have not been reduced, then 01141 /// expanding them may incur additional cost (albeit in the loop preheader). 01142 static bool isHighCostExpansion(const SCEV *S, BranchInst *BI, 01143 SmallPtrSet<const SCEV*, 8> &Processed, 01144 ScalarEvolution *SE) { 01145 if (!Processed.insert(S)) 01146 return false; 01147 01148 // If the backedge-taken count is a UDiv, it's very likely a UDiv that 01149 // ScalarEvolution's HowFarToZero or HowManyLessThans produced to compute a 01150 // precise expression, rather than a UDiv from the user's code. If we can't 01151 // find a UDiv in the code with some simple searching, assume the former and 01152 // forego rewriting the loop. 01153 if (isa<SCEVUDivExpr>(S)) { 01154 ICmpInst *OrigCond = dyn_cast<ICmpInst>(BI->getCondition()); 01155 if (!OrigCond) return true; 01156 const SCEV *R = SE->getSCEV(OrigCond->getOperand(1)); 01157 R = SE->getMinusSCEV(R, SE->getConstant(R->getType(), 1)); 01158 if (R != S) { 01159 const SCEV *L = SE->getSCEV(OrigCond->getOperand(0)); 01160 L = SE->getMinusSCEV(L, SE->getConstant(L->getType(), 1)); 01161 if (L != S) 01162 return true; 01163 } 01164 } 01165 01166 // Recurse past add expressions, which commonly occur in the 01167 // BackedgeTakenCount. They may already exist in program code, and if not, 01168 // they are not too expensive rematerialize. 01169 if (const SCEVAddExpr *Add = dyn_cast<SCEVAddExpr>(S)) { 01170 for (SCEVAddExpr::op_iterator I = Add->op_begin(), E = Add->op_end(); 01171 I != E; ++I) { 01172 if (isHighCostExpansion(*I, BI, Processed, SE)) 01173 return true; 01174 } 01175 return false; 01176 } 01177 01178 // HowManyLessThans uses a Max expression whenever the loop is not guarded by 01179 // the exit condition. 01180 if (isa<SCEVSMaxExpr>(S) || isa<SCEVUMaxExpr>(S)) 01181 return true; 01182 01183 // If we haven't recognized an expensive SCEV pattern, assume it's an 01184 // expression produced by program code. 01185 return false; 01186 } 01187 01188 /// canExpandBackedgeTakenCount - Return true if this loop's backedge taken 01189 /// count expression can be safely and cheaply expanded into an instruction 01190 /// sequence that can be used by LinearFunctionTestReplace. 01191 /// 01192 /// TODO: This fails for pointer-type loop counters with greater than one byte 01193 /// strides, consequently preventing LFTR from running. For the purpose of LFTR 01194 /// we could skip this check in the case that the LFTR loop counter (chosen by 01195 /// FindLoopCounter) is also pointer type. Instead, we could directly convert 01196 /// the loop test to an inequality test by checking the target data's alignment 01197 /// of element types (given that the initial pointer value originates from or is 01198 /// used by ABI constrained operation, as opposed to inttoptr/ptrtoint). 01199 /// However, we don't yet have a strong motivation for converting loop tests 01200 /// into inequality tests. 01201 static bool canExpandBackedgeTakenCount(Loop *L, ScalarEvolution *SE) { 01202 const SCEV *BackedgeTakenCount = SE->getBackedgeTakenCount(L); 01203 if (isa<SCEVCouldNotCompute>(BackedgeTakenCount) || 01204 BackedgeTakenCount->isZero()) 01205 return false; 01206 01207 if (!L->getExitingBlock()) 01208 return false; 01209 01210 // Can't rewrite non-branch yet. 01211 BranchInst *BI = dyn_cast<BranchInst>(L->getExitingBlock()->getTerminator()); 01212 if (!BI) 01213 return false; 01214 01215 SmallPtrSet<const SCEV*, 8> Processed; 01216 if (isHighCostExpansion(BackedgeTakenCount, BI, Processed, SE)) 01217 return false; 01218 01219 return true; 01220 } 01221 01222 /// getLoopPhiForCounter - Return the loop header phi IFF IncV adds a loop 01223 /// invariant value to the phi. 01224 static PHINode *getLoopPhiForCounter(Value *IncV, Loop *L, DominatorTree *DT) { 01225 Instruction *IncI = dyn_cast<Instruction>(IncV); 01226 if (!IncI) 01227 return 0; 01228 01229 switch (IncI->getOpcode()) { 01230 case Instruction::Add: 01231 case Instruction::Sub: 01232 break; 01233 case Instruction::GetElementPtr: 01234 // An IV counter must preserve its type. 01235 if (IncI->getNumOperands() == 2) 01236 break; 01237 default: 01238 return 0; 01239 } 01240 01241 PHINode *Phi = dyn_cast<PHINode>(IncI->getOperand(0)); 01242 if (Phi && Phi->getParent() == L->getHeader()) { 01243 if (isLoopInvariant(IncI->getOperand(1), L, DT)) 01244 return Phi; 01245 return 0; 01246 } 01247 if (IncI->getOpcode() == Instruction::GetElementPtr) 01248 return 0; 01249 01250 // Allow add/sub to be commuted. 01251 Phi = dyn_cast<PHINode>(IncI->getOperand(1)); 01252 if (Phi && Phi->getParent() == L->getHeader()) { 01253 if (isLoopInvariant(IncI->getOperand(0), L, DT)) 01254 return Phi; 01255 } 01256 return 0; 01257 } 01258 01259 /// Return the compare guarding the loop latch, or NULL for unrecognized tests. 01260 static ICmpInst *getLoopTest(Loop *L) { 01261 assert(L->getExitingBlock() && "expected loop exit"); 01262 01263 BasicBlock *LatchBlock = L->getLoopLatch(); 01264 // Don't bother with LFTR if the loop is not properly simplified. 01265 if (!LatchBlock) 01266 return 0; 01267 01268 BranchInst *BI = dyn_cast<BranchInst>(L->getExitingBlock()->getTerminator()); 01269 assert(BI && "expected exit branch"); 01270 01271 return dyn_cast<ICmpInst>(BI->getCondition()); 01272 } 01273 01274 /// needsLFTR - LinearFunctionTestReplace policy. Return true unless we can show 01275 /// that the current exit test is already sufficiently canonical. 01276 static bool needsLFTR(Loop *L, DominatorTree *DT) { 01277 // Do LFTR to simplify the exit condition to an ICMP. 01278 ICmpInst *Cond = getLoopTest(L); 01279 if (!Cond) 01280 return true; 01281 01282 // Do LFTR to simplify the exit ICMP to EQ/NE 01283 ICmpInst::Predicate Pred = Cond->getPredicate(); 01284 if (Pred != ICmpInst::ICMP_NE && Pred != ICmpInst::ICMP_EQ) 01285 return true; 01286 01287 // Look for a loop invariant RHS 01288 Value *LHS = Cond->getOperand(0); 01289 Value *RHS = Cond->getOperand(1); 01290 if (!isLoopInvariant(RHS, L, DT)) { 01291 if (!isLoopInvariant(LHS, L, DT)) 01292 return true; 01293 std::swap(LHS, RHS); 01294 } 01295 // Look for a simple IV counter LHS 01296 PHINode *Phi = dyn_cast<PHINode>(LHS); 01297 if (!Phi) 01298 Phi = getLoopPhiForCounter(LHS, L, DT); 01299 01300 if (!Phi) 01301 return true; 01302 01303 // Do LFTR if PHI node is defined in the loop, but is *not* a counter. 01304 int Idx = Phi->getBasicBlockIndex(L->getLoopLatch()); 01305 if (Idx < 0) 01306 return true; 01307 01308 // Do LFTR if the exit condition's IV is *not* a simple counter. 01309 Value *IncV = Phi->getIncomingValue(Idx); 01310 return Phi != getLoopPhiForCounter(IncV, L, DT); 01311 } 01312 01313 /// Recursive helper for hasConcreteDef(). Unfortunately, this currently boils 01314 /// down to checking that all operands are constant and listing instructions 01315 /// that may hide undef. 01316 static bool hasConcreteDefImpl(Value *V, SmallPtrSet<Value*, 8> &Visited, 01317 unsigned Depth) { 01318 if (isa<Constant>(V)) 01319 return !isa<UndefValue>(V); 01320 01321 if (Depth >= 6) 01322 return false; 01323 01324 // Conservatively handle non-constant non-instructions. For example, Arguments 01325 // may be undef. 01326 Instruction *I = dyn_cast<Instruction>(V); 01327 if (!I) 01328 return false; 01329 01330 // Load and return values may be undef. 01331 if(I->mayReadFromMemory() || isa<CallInst>(I) || isa<InvokeInst>(I)) 01332 return false; 01333 01334 // Optimistically handle other instructions. 01335 for (User::op_iterator OI = I->op_begin(), E = I->op_end(); OI != E; ++OI) { 01336 if (!Visited.insert(*OI)) 01337 continue; 01338 if (!hasConcreteDefImpl(*OI, Visited, Depth+1)) 01339 return false; 01340 } 01341 return true; 01342 } 01343 01344 /// Return true if the given value is concrete. We must prove that undef can 01345 /// never reach it. 01346 /// 01347 /// TODO: If we decide that this is a good approach to checking for undef, we 01348 /// may factor it into a common location. 01349 static bool hasConcreteDef(Value *V) { 01350 SmallPtrSet<Value*, 8> Visited; 01351 Visited.insert(V); 01352 return hasConcreteDefImpl(V, Visited, 0); 01353 } 01354 01355 /// AlmostDeadIV - Return true if this IV has any uses other than the (soon to 01356 /// be rewritten) loop exit test. 01357 static bool AlmostDeadIV(PHINode *Phi, BasicBlock *LatchBlock, Value *Cond) { 01358 int LatchIdx = Phi->getBasicBlockIndex(LatchBlock); 01359 Value *IncV = Phi->getIncomingValue(LatchIdx); 01360 01361 for (Value::use_iterator UI = Phi->use_begin(), UE = Phi->use_end(); 01362 UI != UE; ++UI) { 01363 if (*UI != Cond && *UI != IncV) return false; 01364 } 01365 01366 for (Value::use_iterator UI = IncV->use_begin(), UE = IncV->use_end(); 01367 UI != UE; ++UI) { 01368 if (*UI != Cond && *UI != Phi) return false; 01369 } 01370 return true; 01371 } 01372 01373 /// FindLoopCounter - Find an affine IV in canonical form. 01374 /// 01375 /// BECount may be an i8* pointer type. The pointer difference is already 01376 /// valid count without scaling the address stride, so it remains a pointer 01377 /// expression as far as SCEV is concerned. 01378 /// 01379 /// Currently only valid for LFTR. See the comments on hasConcreteDef below. 01380 /// 01381 /// FIXME: Accept -1 stride and set IVLimit = IVInit - BECount 01382 /// 01383 /// FIXME: Accept non-unit stride as long as SCEV can reduce BECount * Stride. 01384 /// This is difficult in general for SCEV because of potential overflow. But we 01385 /// could at least handle constant BECounts. 01386 static PHINode * 01387 FindLoopCounter(Loop *L, const SCEV *BECount, 01388 ScalarEvolution *SE, DominatorTree *DT, const DataLayout *TD) { 01389 uint64_t BCWidth = SE->getTypeSizeInBits(BECount->getType()); 01390 01391 Value *Cond = 01392 cast<BranchInst>(L->getExitingBlock()->getTerminator())->getCondition(); 01393 01394 // Loop over all of the PHI nodes, looking for a simple counter. 01395 PHINode *BestPhi = 0; 01396 const SCEV *BestInit = 0; 01397 BasicBlock *LatchBlock = L->getLoopLatch(); 01398 assert(LatchBlock && "needsLFTR should guarantee a loop latch"); 01399 01400 for (BasicBlock::iterator I = L->getHeader()->begin(); isa<PHINode>(I); ++I) { 01401 PHINode *Phi = cast<PHINode>(I); 01402 if (!SE->isSCEVable(Phi->getType())) 01403 continue; 01404 01405 // Avoid comparing an integer IV against a pointer Limit. 01406 if (BECount->getType()->isPointerTy() && !Phi->getType()->isPointerTy()) 01407 continue; 01408 01409 const SCEVAddRecExpr *AR = dyn_cast<SCEVAddRecExpr>(SE->getSCEV(Phi)); 01410 if (!AR || AR->getLoop() != L || !AR->isAffine()) 01411 continue; 01412 01413 // AR may be a pointer type, while BECount is an integer type. 01414 // AR may be wider than BECount. With eq/ne tests overflow is immaterial. 01415 // AR may not be a narrower type, or we may never exit. 01416 uint64_t PhiWidth = SE->getTypeSizeInBits(AR->getType()); 01417 if (PhiWidth < BCWidth || (TD && !TD->isLegalInteger(PhiWidth))) 01418 continue; 01419 01420 const SCEV *Step = dyn_cast<SCEVConstant>(AR->getStepRecurrence(*SE)); 01421 if (!Step || !Step->isOne()) 01422 continue; 01423 01424 int LatchIdx = Phi->getBasicBlockIndex(LatchBlock); 01425 Value *IncV = Phi->getIncomingValue(LatchIdx); 01426 if (getLoopPhiForCounter(IncV, L, DT) != Phi) 01427 continue; 01428 01429 // Avoid reusing a potentially undef value to compute other values that may 01430 // have originally had a concrete definition. 01431 if (!hasConcreteDef(Phi)) { 01432 // We explicitly allow unknown phis as long as they are already used by 01433 // the loop test. In this case we assume that performing LFTR could not 01434 // increase the number of undef users. 01435 if (ICmpInst *Cond = getLoopTest(L)) { 01436 if (Phi != getLoopPhiForCounter(Cond->getOperand(0), L, DT) 01437 && Phi != getLoopPhiForCounter(Cond->getOperand(1), L, DT)) { 01438 continue; 01439 } 01440 } 01441 } 01442 const SCEV *Init = AR->getStart(); 01443 01444 if (BestPhi && !AlmostDeadIV(BestPhi, LatchBlock, Cond)) { 01445 // Don't force a live loop counter if another IV can be used. 01446 if (AlmostDeadIV(Phi, LatchBlock, Cond)) 01447 continue; 01448 01449 // Prefer to count-from-zero. This is a more "canonical" counter form. It 01450 // also prefers integer to pointer IVs. 01451 if (BestInit->isZero() != Init->isZero()) { 01452 if (BestInit->isZero()) 01453 continue; 01454 } 01455 // If two IVs both count from zero or both count from nonzero then the 01456 // narrower is likely a dead phi that has been widened. Use the wider phi 01457 // to allow the other to be eliminated. 01458 else if (PhiWidth <= SE->getTypeSizeInBits(BestPhi->getType())) 01459 continue; 01460 } 01461 BestPhi = Phi; 01462 BestInit = Init; 01463 } 01464 return BestPhi; 01465 } 01466 01467 /// genLoopLimit - Help LinearFunctionTestReplace by generating a value that 01468 /// holds the RHS of the new loop test. 01469 static Value *genLoopLimit(PHINode *IndVar, const SCEV *IVCount, Loop *L, 01470 SCEVExpander &Rewriter, ScalarEvolution *SE) { 01471 const SCEVAddRecExpr *AR = dyn_cast<SCEVAddRecExpr>(SE->getSCEV(IndVar)); 01472 assert(AR && AR->getLoop() == L && AR->isAffine() && "bad loop counter"); 01473 const SCEV *IVInit = AR->getStart(); 01474 01475 // IVInit may be a pointer while IVCount is an integer when FindLoopCounter 01476 // finds a valid pointer IV. Sign extend BECount in order to materialize a 01477 // GEP. Avoid running SCEVExpander on a new pointer value, instead reusing 01478 // the existing GEPs whenever possible. 01479 if (IndVar->getType()->isPointerTy() 01480 && !IVCount->getType()->isPointerTy()) { 01481 01482 Type *OfsTy = SE->getEffectiveSCEVType(IVInit->getType()); 01483 const SCEV *IVOffset = SE->getTruncateOrSignExtend(IVCount, OfsTy); 01484 01485 // Expand the code for the iteration count. 01486 assert(SE->isLoopInvariant(IVOffset, L) && 01487 "Computed iteration count is not loop invariant!"); 01488 BranchInst *BI = cast<BranchInst>(L->getExitingBlock()->getTerminator()); 01489 Value *GEPOffset = Rewriter.expandCodeFor(IVOffset, OfsTy, BI); 01490 01491 Value *GEPBase = IndVar->getIncomingValueForBlock(L->getLoopPreheader()); 01492 assert(AR->getStart() == SE->getSCEV(GEPBase) && "bad loop counter"); 01493 // We could handle pointer IVs other than i8*, but we need to compensate for 01494 // gep index scaling. See canExpandBackedgeTakenCount comments. 01495 assert(SE->getSizeOfExpr( 01496 cast<PointerType>(GEPBase->getType())->getElementType())->isOne() 01497 && "unit stride pointer IV must be i8*"); 01498 01499 IRBuilder<> Builder(L->getLoopPreheader()->getTerminator()); 01500 return Builder.CreateGEP(GEPBase, GEPOffset, "lftr.limit"); 01501 } 01502 else { 01503 // In any other case, convert both IVInit and IVCount to integers before 01504 // comparing. This may result in SCEV expension of pointers, but in practice 01505 // SCEV will fold the pointer arithmetic away as such: 01506 // BECount = (IVEnd - IVInit - 1) => IVLimit = IVInit (postinc). 01507 // 01508 // Valid Cases: (1) both integers is most common; (2) both may be pointers 01509 // for simple memset-style loops; (3) IVInit is an integer and IVCount is a 01510 // pointer may occur when enable-iv-rewrite generates a canonical IV on top 01511 // of case #2. 01512 01513 const SCEV *IVLimit = 0; 01514 // For unit stride, IVCount = Start + BECount with 2's complement overflow. 01515 // For non-zero Start, compute IVCount here. 01516 if (AR->getStart()->isZero()) 01517 IVLimit = IVCount; 01518 else { 01519 assert(AR->getStepRecurrence(*SE)->isOne() && "only handles unit stride"); 01520 const SCEV *IVInit = AR->getStart(); 01521 01522 // For integer IVs, truncate the IV before computing IVInit + BECount. 01523 if (SE->getTypeSizeInBits(IVInit->getType()) 01524 > SE->getTypeSizeInBits(IVCount->getType())) 01525 IVInit = SE->getTruncateExpr(IVInit, IVCount->getType()); 01526 01527 IVLimit = SE->getAddExpr(IVInit, IVCount); 01528 } 01529 // Expand the code for the iteration count. 01530 BranchInst *BI = cast<BranchInst>(L->getExitingBlock()->getTerminator()); 01531 IRBuilder<> Builder(BI); 01532 assert(SE->isLoopInvariant(IVLimit, L) && 01533 "Computed iteration count is not loop invariant!"); 01534 // Ensure that we generate the same type as IndVar, or a smaller integer 01535 // type. In the presence of null pointer values, we have an integer type 01536 // SCEV expression (IVInit) for a pointer type IV value (IndVar). 01537 Type *LimitTy = IVCount->getType()->isPointerTy() ? 01538 IndVar->getType() : IVCount->getType(); 01539 return Rewriter.expandCodeFor(IVLimit, LimitTy, BI); 01540 } 01541 } 01542 01543 /// LinearFunctionTestReplace - This method rewrites the exit condition of the 01544 /// loop to be a canonical != comparison against the incremented loop induction 01545 /// variable. This pass is able to rewrite the exit tests of any loop where the 01546 /// SCEV analysis can determine a loop-invariant trip count of the loop, which 01547 /// is actually a much broader range than just linear tests. 01548 Value *IndVarSimplify:: 01549 LinearFunctionTestReplace(Loop *L, 01550 const SCEV *BackedgeTakenCount, 01551 PHINode *IndVar, 01552 SCEVExpander &Rewriter) { 01553 assert(canExpandBackedgeTakenCount(L, SE) && "precondition"); 01554 01555 // LFTR can ignore IV overflow and truncate to the width of 01556 // BECount. This avoids materializing the add(zext(add)) expression. 01557 Type *CntTy = BackedgeTakenCount->getType(); 01558 01559 const SCEV *IVCount = BackedgeTakenCount; 01560 01561 // If the exiting block is the same as the backedge block, we prefer to 01562 // compare against the post-incremented value, otherwise we must compare 01563 // against the preincremented value. 01564 Value *CmpIndVar; 01565 if (L->getExitingBlock() == L->getLoopLatch()) { 01566 // Add one to the "backedge-taken" count to get the trip count. 01567 // If this addition may overflow, we have to be more pessimistic and 01568 // cast the induction variable before doing the add. 01569 const SCEV *N = 01570 SE->getAddExpr(IVCount, SE->getConstant(IVCount->getType(), 1)); 01571 if (CntTy == IVCount->getType()) 01572 IVCount = N; 01573 else { 01574 const SCEV *Zero = SE->getConstant(IVCount->getType(), 0); 01575 if ((isa<SCEVConstant>(N) && !N->isZero()) || 01576 SE->isLoopEntryGuardedByCond(L, ICmpInst::ICMP_NE, N, Zero)) { 01577 // No overflow. Cast the sum. 01578 IVCount = SE->getTruncateOrZeroExtend(N, CntTy); 01579 } else { 01580 // Potential overflow. Cast before doing the add. 01581 IVCount = SE->getTruncateOrZeroExtend(IVCount, CntTy); 01582 IVCount = SE->getAddExpr(IVCount, SE->getConstant(CntTy, 1)); 01583 } 01584 } 01585 // The BackedgeTaken expression contains the number of times that the 01586 // backedge branches to the loop header. This is one less than the 01587 // number of times the loop executes, so use the incremented indvar. 01588 CmpIndVar = IndVar->getIncomingValueForBlock(L->getExitingBlock()); 01589 } else { 01590 // We must use the preincremented value... 01591 IVCount = SE->getTruncateOrZeroExtend(IVCount, CntTy); 01592 CmpIndVar = IndVar; 01593 } 01594 01595 Value *ExitCnt = genLoopLimit(IndVar, IVCount, L, Rewriter, SE); 01596 assert(ExitCnt->getType()->isPointerTy() == IndVar->getType()->isPointerTy() 01597 && "genLoopLimit missed a cast"); 01598 01599 // Insert a new icmp_ne or icmp_eq instruction before the branch. 01600 BranchInst *BI = cast<BranchInst>(L->getExitingBlock()->getTerminator()); 01601 ICmpInst::Predicate P; 01602 if (L->contains(BI->getSuccessor(0))) 01603 P = ICmpInst::ICMP_NE; 01604 else 01605 P = ICmpInst::ICMP_EQ; 01606 01607 DEBUG(dbgs() << "INDVARS: Rewriting loop exit condition to:\n" 01608 << " LHS:" << *CmpIndVar << '\n' 01609 << " op:\t" 01610 << (P == ICmpInst::ICMP_NE ? "!=" : "==") << "\n" 01611 << " RHS:\t" << *ExitCnt << "\n" 01612 << " IVCount:\t" << *IVCount << "\n"); 01613 01614 IRBuilder<> Builder(BI); 01615 if (SE->getTypeSizeInBits(CmpIndVar->getType()) 01616 > SE->getTypeSizeInBits(ExitCnt->getType())) { 01617 CmpIndVar = Builder.CreateTrunc(CmpIndVar, ExitCnt->getType(), 01618 "lftr.wideiv"); 01619 } 01620 01621 Value *Cond = Builder.CreateICmp(P, CmpIndVar, ExitCnt, "exitcond"); 01622 Value *OrigCond = BI->getCondition(); 01623 // It's tempting to use replaceAllUsesWith here to fully replace the old 01624 // comparison, but that's not immediately safe, since users of the old 01625 // comparison may not be dominated by the new comparison. Instead, just 01626 // update the branch to use the new comparison; in the common case this 01627 // will make old comparison dead. 01628 BI->setCondition(Cond); 01629 DeadInsts.push_back(OrigCond); 01630 01631 ++NumLFTR; 01632 Changed = true; 01633 return Cond; 01634 } 01635 01636 //===----------------------------------------------------------------------===// 01637 // SinkUnusedInvariants. A late subpass to cleanup loop preheaders. 01638 //===----------------------------------------------------------------------===// 01639 01640 /// If there's a single exit block, sink any loop-invariant values that 01641 /// were defined in the preheader but not used inside the loop into the 01642 /// exit block to reduce register pressure in the loop. 01643 void IndVarSimplify::SinkUnusedInvariants(Loop *L) { 01644 BasicBlock *ExitBlock = L->getExitBlock(); 01645 if (!ExitBlock) return; 01646 01647 BasicBlock *Preheader = L->getLoopPreheader(); 01648 if (!Preheader) return; 01649 01650 Instruction *InsertPt = ExitBlock->getFirstInsertionPt(); 01651 BasicBlock::iterator I = Preheader->getTerminator(); 01652 while (I != Preheader->begin()) { 01653 --I; 01654 // New instructions were inserted at the end of the preheader. 01655 if (isa<PHINode>(I)) 01656 break; 01657 01658 // Don't move instructions which might have side effects, since the side 01659 // effects need to complete before instructions inside the loop. Also don't 01660 // move instructions which might read memory, since the loop may modify 01661 // memory. Note that it's okay if the instruction might have undefined 01662 // behavior: LoopSimplify guarantees that the preheader dominates the exit 01663 // block. 01664 if (I->mayHaveSideEffects() || I->mayReadFromMemory()) 01665 continue; 01666 01667 // Skip debug info intrinsics. 01668 if (isa<DbgInfoIntrinsic>(I)) 01669 continue; 01670 01671 // Skip landingpad instructions. 01672 if (isa<LandingPadInst>(I)) 01673 continue; 01674 01675 // Don't sink alloca: we never want to sink static alloca's out of the 01676 // entry block, and correctly sinking dynamic alloca's requires 01677 // checks for stacksave/stackrestore intrinsics. 01678 // FIXME: Refactor this check somehow? 01679 if (isa<AllocaInst>(I)) 01680 continue; 01681 01682 // Determine if there is a use in or before the loop (direct or 01683 // otherwise). 01684 bool UsedInLoop = false; 01685 for (Value::use_iterator UI = I->use_begin(), UE = I->use_end(); 01686 UI != UE; ++UI) { 01687 User *U = *UI; 01688 BasicBlock *UseBB = cast<Instruction>(U)->getParent(); 01689 if (PHINode *P = dyn_cast<PHINode>(U)) { 01690 unsigned i = 01691 PHINode::getIncomingValueNumForOperand(UI.getOperandNo()); 01692 UseBB = P->getIncomingBlock(i); 01693 } 01694 if (UseBB == Preheader || L->contains(UseBB)) { 01695 UsedInLoop = true; 01696 break; 01697 } 01698 } 01699 01700 // If there is, the def must remain in the preheader. 01701 if (UsedInLoop) 01702 continue; 01703 01704 // Otherwise, sink it to the exit block. 01705 Instruction *ToMove = I; 01706 bool Done = false; 01707 01708 if (I != Preheader->begin()) { 01709 // Skip debug info intrinsics. 01710 do { 01711 --I; 01712 } while (isa<DbgInfoIntrinsic>(I) && I != Preheader->begin()); 01713 01714 if (isa<DbgInfoIntrinsic>(I) && I == Preheader->begin()) 01715 Done = true; 01716 } else { 01717 Done = true; 01718 } 01719 01720 ToMove->moveBefore(InsertPt); 01721 if (Done) break; 01722 InsertPt = ToMove; 01723 } 01724 } 01725 01726 //===----------------------------------------------------------------------===// 01727 // IndVarSimplify driver. Manage several subpasses of IV simplification. 01728 //===----------------------------------------------------------------------===// 01729 01730 bool IndVarSimplify::runOnLoop(Loop *L, LPPassManager &LPM) { 01731 // If LoopSimplify form is not available, stay out of trouble. Some notes: 01732 // - LSR currently only supports LoopSimplify-form loops. Indvars' 01733 // canonicalization can be a pessimization without LSR to "clean up" 01734 // afterwards. 01735 // - We depend on having a preheader; in particular, 01736 // Loop::getCanonicalInductionVariable only supports loops with preheaders, 01737 // and we're in trouble if we can't find the induction variable even when 01738 // we've manually inserted one. 01739 if (!L->isLoopSimplifyForm()) 01740 return false; 01741 01742 LI = &getAnalysis<LoopInfo>(); 01743 SE = &getAnalysis<ScalarEvolution>(); 01744 DT = &getAnalysis<DominatorTree>(); 01745 TD = getAnalysisIfAvailable<DataLayout>(); 01746 TLI = getAnalysisIfAvailable<TargetLibraryInfo>(); 01747 01748 DeadInsts.clear(); 01749 Changed = false; 01750 01751 // If there are any floating-point recurrences, attempt to 01752 // transform them to use integer recurrences. 01753 RewriteNonIntegerIVs(L); 01754 01755 const SCEV *BackedgeTakenCount = SE->getBackedgeTakenCount(L); 01756 01757 // Create a rewriter object which we'll use to transform the code with. 01758 SCEVExpander Rewriter(*SE, "indvars"); 01759 #ifndef NDEBUG 01760 Rewriter.setDebugType(DEBUG_TYPE); 01761 #endif 01762 01763 // Eliminate redundant IV users. 01764 // 01765 // Simplification works best when run before other consumers of SCEV. We 01766 // attempt to avoid evaluating SCEVs for sign/zero extend operations until 01767 // other expressions involving loop IVs have been evaluated. This helps SCEV 01768 // set no-wrap flags before normalizing sign/zero extension. 01769 Rewriter.disableCanonicalMode(); 01770 SimplifyAndExtend(L, Rewriter, LPM); 01771 01772 // Check to see if this loop has a computable loop-invariant execution count. 01773 // If so, this means that we can compute the final value of any expressions 01774 // that are recurrent in the loop, and substitute the exit values from the 01775 // loop into any instructions outside of the loop that use the final values of 01776 // the current expressions. 01777 // 01778 if (!isa<SCEVCouldNotCompute>(BackedgeTakenCount)) 01779 RewriteLoopExitValues(L, Rewriter); 01780 01781 // Eliminate redundant IV cycles. 01782 NumElimIV += Rewriter.replaceCongruentIVs(L, DT, DeadInsts); 01783 01784 // If we have a trip count expression, rewrite the loop's exit condition 01785 // using it. We can currently only handle loops with a single exit. 01786 if (canExpandBackedgeTakenCount(L, SE) && needsLFTR(L, DT)) { 01787 PHINode *IndVar = FindLoopCounter(L, BackedgeTakenCount, SE, DT, TD); 01788 if (IndVar) { 01789 // Check preconditions for proper SCEVExpander operation. SCEV does not 01790 // express SCEVExpander's dependencies, such as LoopSimplify. Instead any 01791 // pass that uses the SCEVExpander must do it. This does not work well for 01792 // loop passes because SCEVExpander makes assumptions about all loops, while 01793 // LoopPassManager only forces the current loop to be simplified. 01794 // 01795 // FIXME: SCEV expansion has no way to bail out, so the caller must 01796 // explicitly check any assumptions made by SCEV. Brittle. 01797 const SCEVAddRecExpr *AR = dyn_cast<SCEVAddRecExpr>(BackedgeTakenCount); 01798 if (!AR || AR->getLoop()->getLoopPreheader()) 01799 (void)LinearFunctionTestReplace(L, BackedgeTakenCount, IndVar, 01800 Rewriter); 01801 } 01802 } 01803 // Clear the rewriter cache, because values that are in the rewriter's cache 01804 // can be deleted in the loop below, causing the AssertingVH in the cache to 01805 // trigger. 01806 Rewriter.clear(); 01807 01808 // Now that we're done iterating through lists, clean up any instructions 01809 // which are now dead. 01810 while (!DeadInsts.empty()) 01811 if (Instruction *Inst = 01812 dyn_cast_or_null<Instruction>(&*DeadInsts.pop_back_val())) 01813 RecursivelyDeleteTriviallyDeadInstructions(Inst, TLI); 01814 01815 // The Rewriter may not be used from this point on. 01816 01817 // Loop-invariant instructions in the preheader that aren't used in the 01818 // loop may be sunk below the loop to reduce register pressure. 01819 SinkUnusedInvariants(L); 01820 01821 // Clean up dead instructions. 01822 Changed |= DeleteDeadPHIs(L->getHeader(), TLI); 01823 // Check a post-condition. 01824 assert(L->isLCSSAForm(*DT) && 01825 "Indvars did not leave the loop in lcssa form!"); 01826 01827 // Verify that LFTR, and any other change have not interfered with SCEV's 01828 // ability to compute trip count. 01829 #ifndef NDEBUG 01830 if (VerifyIndvars && !isa<SCEVCouldNotCompute>(BackedgeTakenCount)) { 01831 SE->forgetLoop(L); 01832 const SCEV *NewBECount = SE->getBackedgeTakenCount(L); 01833 if (SE->getTypeSizeInBits(BackedgeTakenCount->getType()) < 01834 SE->getTypeSizeInBits(NewBECount->getType())) 01835 NewBECount = SE->getTruncateOrNoop(NewBECount, 01836 BackedgeTakenCount->getType()); 01837 else 01838 BackedgeTakenCount = SE->getTruncateOrNoop(BackedgeTakenCount, 01839 NewBECount->getType()); 01840 assert(BackedgeTakenCount == NewBECount && "indvars must preserve SCEV"); 01841 } 01842 #endif 01843 01844 return Changed; 01845 }