xref: /freebsd-src/contrib/llvm-project/llvm/lib/Transforms/Utils/LoopUtils.cpp (revision 4824e7fd18a1223177218d4aec1b3c6c5c4a444e)
1 //===-- LoopUtils.cpp - Loop Utility functions -------------------------===//
2 //
3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4 // See https://llvm.org/LICENSE.txt for license information.
5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6 //
7 //===----------------------------------------------------------------------===//
8 //
9 // This file defines common loop utility functions.
10 //
11 //===----------------------------------------------------------------------===//
12 
13 #include "llvm/Transforms/Utils/LoopUtils.h"
14 #include "llvm/ADT/DenseSet.h"
15 #include "llvm/ADT/Optional.h"
16 #include "llvm/ADT/PriorityWorklist.h"
17 #include "llvm/ADT/ScopeExit.h"
18 #include "llvm/ADT/SetVector.h"
19 #include "llvm/ADT/SmallPtrSet.h"
20 #include "llvm/ADT/SmallVector.h"
21 #include "llvm/Analysis/AliasAnalysis.h"
22 #include "llvm/Analysis/BasicAliasAnalysis.h"
23 #include "llvm/Analysis/DomTreeUpdater.h"
24 #include "llvm/Analysis/GlobalsModRef.h"
25 #include "llvm/Analysis/InstructionSimplify.h"
26 #include "llvm/Analysis/LoopAccessAnalysis.h"
27 #include "llvm/Analysis/LoopInfo.h"
28 #include "llvm/Analysis/LoopPass.h"
29 #include "llvm/Analysis/MemorySSA.h"
30 #include "llvm/Analysis/MemorySSAUpdater.h"
31 #include "llvm/Analysis/MustExecute.h"
32 #include "llvm/Analysis/ScalarEvolution.h"
33 #include "llvm/Analysis/ScalarEvolutionAliasAnalysis.h"
34 #include "llvm/Analysis/ScalarEvolutionExpressions.h"
35 #include "llvm/Analysis/TargetTransformInfo.h"
36 #include "llvm/Analysis/ValueTracking.h"
37 #include "llvm/IR/DIBuilder.h"
38 #include "llvm/IR/Dominators.h"
39 #include "llvm/IR/Instructions.h"
40 #include "llvm/IR/IntrinsicInst.h"
41 #include "llvm/IR/MDBuilder.h"
42 #include "llvm/IR/Module.h"
43 #include "llvm/IR/Operator.h"
44 #include "llvm/IR/PatternMatch.h"
45 #include "llvm/IR/ValueHandle.h"
46 #include "llvm/InitializePasses.h"
47 #include "llvm/Pass.h"
48 #include "llvm/Support/Debug.h"
49 #include "llvm/Support/KnownBits.h"
50 #include "llvm/Transforms/Utils/BasicBlockUtils.h"
51 #include "llvm/Transforms/Utils/Local.h"
52 #include "llvm/Transforms/Utils/ScalarEvolutionExpander.h"
53 
54 using namespace llvm;
55 using namespace llvm::PatternMatch;
56 
57 #define DEBUG_TYPE "loop-utils"
58 
59 static const char *LLVMLoopDisableNonforced = "llvm.loop.disable_nonforced";
60 static const char *LLVMLoopDisableLICM = "llvm.licm.disable";
61 
62 bool llvm::formDedicatedExitBlocks(Loop *L, DominatorTree *DT, LoopInfo *LI,
63                                    MemorySSAUpdater *MSSAU,
64                                    bool PreserveLCSSA) {
65   bool Changed = false;
66 
67   // We re-use a vector for the in-loop predecesosrs.
68   SmallVector<BasicBlock *, 4> InLoopPredecessors;
69 
70   auto RewriteExit = [&](BasicBlock *BB) {
71     assert(InLoopPredecessors.empty() &&
72            "Must start with an empty predecessors list!");
73     auto Cleanup = make_scope_exit([&] { InLoopPredecessors.clear(); });
74 
75     // See if there are any non-loop predecessors of this exit block and
76     // keep track of the in-loop predecessors.
77     bool IsDedicatedExit = true;
78     for (auto *PredBB : predecessors(BB))
79       if (L->contains(PredBB)) {
80         if (isa<IndirectBrInst>(PredBB->getTerminator()))
81           // We cannot rewrite exiting edges from an indirectbr.
82           return false;
83         if (isa<CallBrInst>(PredBB->getTerminator()))
84           // We cannot rewrite exiting edges from a callbr.
85           return false;
86 
87         InLoopPredecessors.push_back(PredBB);
88       } else {
89         IsDedicatedExit = false;
90       }
91 
92     assert(!InLoopPredecessors.empty() && "Must have *some* loop predecessor!");
93 
94     // Nothing to do if this is already a dedicated exit.
95     if (IsDedicatedExit)
96       return false;
97 
98     auto *NewExitBB = SplitBlockPredecessors(
99         BB, InLoopPredecessors, ".loopexit", DT, LI, MSSAU, PreserveLCSSA);
100 
101     if (!NewExitBB)
102       LLVM_DEBUG(
103           dbgs() << "WARNING: Can't create a dedicated exit block for loop: "
104                  << *L << "\n");
105     else
106       LLVM_DEBUG(dbgs() << "LoopSimplify: Creating dedicated exit block "
107                         << NewExitBB->getName() << "\n");
108     return true;
109   };
110 
111   // Walk the exit blocks directly rather than building up a data structure for
112   // them, but only visit each one once.
113   SmallPtrSet<BasicBlock *, 4> Visited;
114   for (auto *BB : L->blocks())
115     for (auto *SuccBB : successors(BB)) {
116       // We're looking for exit blocks so skip in-loop successors.
117       if (L->contains(SuccBB))
118         continue;
119 
120       // Visit each exit block exactly once.
121       if (!Visited.insert(SuccBB).second)
122         continue;
123 
124       Changed |= RewriteExit(SuccBB);
125     }
126 
127   return Changed;
128 }
129 
130 /// Returns the instructions that use values defined in the loop.
131 SmallVector<Instruction *, 8> llvm::findDefsUsedOutsideOfLoop(Loop *L) {
132   SmallVector<Instruction *, 8> UsedOutside;
133 
134   for (auto *Block : L->getBlocks())
135     // FIXME: I believe that this could use copy_if if the Inst reference could
136     // be adapted into a pointer.
137     for (auto &Inst : *Block) {
138       auto Users = Inst.users();
139       if (any_of(Users, [&](User *U) {
140             auto *Use = cast<Instruction>(U);
141             return !L->contains(Use->getParent());
142           }))
143         UsedOutside.push_back(&Inst);
144     }
145 
146   return UsedOutside;
147 }
148 
149 void llvm::getLoopAnalysisUsage(AnalysisUsage &AU) {
150   // By definition, all loop passes need the LoopInfo analysis and the
151   // Dominator tree it depends on. Because they all participate in the loop
152   // pass manager, they must also preserve these.
153   AU.addRequired<DominatorTreeWrapperPass>();
154   AU.addPreserved<DominatorTreeWrapperPass>();
155   AU.addRequired<LoopInfoWrapperPass>();
156   AU.addPreserved<LoopInfoWrapperPass>();
157 
158   // We must also preserve LoopSimplify and LCSSA. We locally access their IDs
159   // here because users shouldn't directly get them from this header.
160   extern char &LoopSimplifyID;
161   extern char &LCSSAID;
162   AU.addRequiredID(LoopSimplifyID);
163   AU.addPreservedID(LoopSimplifyID);
164   AU.addRequiredID(LCSSAID);
165   AU.addPreservedID(LCSSAID);
166   // This is used in the LPPassManager to perform LCSSA verification on passes
167   // which preserve lcssa form
168   AU.addRequired<LCSSAVerificationPass>();
169   AU.addPreserved<LCSSAVerificationPass>();
170 
171   // Loop passes are designed to run inside of a loop pass manager which means
172   // that any function analyses they require must be required by the first loop
173   // pass in the manager (so that it is computed before the loop pass manager
174   // runs) and preserved by all loop pasess in the manager. To make this
175   // reasonably robust, the set needed for most loop passes is maintained here.
176   // If your loop pass requires an analysis not listed here, you will need to
177   // carefully audit the loop pass manager nesting structure that results.
178   AU.addRequired<AAResultsWrapperPass>();
179   AU.addPreserved<AAResultsWrapperPass>();
180   AU.addPreserved<BasicAAWrapperPass>();
181   AU.addPreserved<GlobalsAAWrapperPass>();
182   AU.addPreserved<SCEVAAWrapperPass>();
183   AU.addRequired<ScalarEvolutionWrapperPass>();
184   AU.addPreserved<ScalarEvolutionWrapperPass>();
185   // FIXME: When all loop passes preserve MemorySSA, it can be required and
186   // preserved here instead of the individual handling in each pass.
187 }
188 
189 /// Manually defined generic "LoopPass" dependency initialization. This is used
190 /// to initialize the exact set of passes from above in \c
191 /// getLoopAnalysisUsage. It can be used within a loop pass's initialization
192 /// with:
193 ///
194 ///   INITIALIZE_PASS_DEPENDENCY(LoopPass)
195 ///
196 /// As-if "LoopPass" were a pass.
197 void llvm::initializeLoopPassPass(PassRegistry &Registry) {
198   INITIALIZE_PASS_DEPENDENCY(DominatorTreeWrapperPass)
199   INITIALIZE_PASS_DEPENDENCY(LoopInfoWrapperPass)
200   INITIALIZE_PASS_DEPENDENCY(LoopSimplify)
201   INITIALIZE_PASS_DEPENDENCY(LCSSAWrapperPass)
202   INITIALIZE_PASS_DEPENDENCY(AAResultsWrapperPass)
203   INITIALIZE_PASS_DEPENDENCY(BasicAAWrapperPass)
204   INITIALIZE_PASS_DEPENDENCY(GlobalsAAWrapperPass)
205   INITIALIZE_PASS_DEPENDENCY(SCEVAAWrapperPass)
206   INITIALIZE_PASS_DEPENDENCY(ScalarEvolutionWrapperPass)
207   INITIALIZE_PASS_DEPENDENCY(MemorySSAWrapperPass)
208 }
209 
210 /// Create MDNode for input string.
211 static MDNode *createStringMetadata(Loop *TheLoop, StringRef Name, unsigned V) {
212   LLVMContext &Context = TheLoop->getHeader()->getContext();
213   Metadata *MDs[] = {
214       MDString::get(Context, Name),
215       ConstantAsMetadata::get(ConstantInt::get(Type::getInt32Ty(Context), V))};
216   return MDNode::get(Context, MDs);
217 }
218 
219 /// Set input string into loop metadata by keeping other values intact.
220 /// If the string is already in loop metadata update value if it is
221 /// different.
222 void llvm::addStringMetadataToLoop(Loop *TheLoop, const char *StringMD,
223                                    unsigned V) {
224   SmallVector<Metadata *, 4> MDs(1);
225   // If the loop already has metadata, retain it.
226   MDNode *LoopID = TheLoop->getLoopID();
227   if (LoopID) {
228     for (unsigned i = 1, ie = LoopID->getNumOperands(); i < ie; ++i) {
229       MDNode *Node = cast<MDNode>(LoopID->getOperand(i));
230       // If it is of form key = value, try to parse it.
231       if (Node->getNumOperands() == 2) {
232         MDString *S = dyn_cast<MDString>(Node->getOperand(0));
233         if (S && S->getString().equals(StringMD)) {
234           ConstantInt *IntMD =
235               mdconst::extract_or_null<ConstantInt>(Node->getOperand(1));
236           if (IntMD && IntMD->getSExtValue() == V)
237             // It is already in place. Do nothing.
238             return;
239           // We need to update the value, so just skip it here and it will
240           // be added after copying other existed nodes.
241           continue;
242         }
243       }
244       MDs.push_back(Node);
245     }
246   }
247   // Add new metadata.
248   MDs.push_back(createStringMetadata(TheLoop, StringMD, V));
249   // Replace current metadata node with new one.
250   LLVMContext &Context = TheLoop->getHeader()->getContext();
251   MDNode *NewLoopID = MDNode::get(Context, MDs);
252   // Set operand 0 to refer to the loop id itself.
253   NewLoopID->replaceOperandWith(0, NewLoopID);
254   TheLoop->setLoopID(NewLoopID);
255 }
256 
257 Optional<ElementCount>
258 llvm::getOptionalElementCountLoopAttribute(const Loop *TheLoop) {
259   Optional<int> Width =
260       getOptionalIntLoopAttribute(TheLoop, "llvm.loop.vectorize.width");
261 
262   if (Width.hasValue()) {
263     Optional<int> IsScalable = getOptionalIntLoopAttribute(
264         TheLoop, "llvm.loop.vectorize.scalable.enable");
265     return ElementCount::get(*Width, IsScalable.getValueOr(false));
266   }
267 
268   return None;
269 }
270 
271 Optional<MDNode *> llvm::makeFollowupLoopID(
272     MDNode *OrigLoopID, ArrayRef<StringRef> FollowupOptions,
273     const char *InheritOptionsExceptPrefix, bool AlwaysNew) {
274   if (!OrigLoopID) {
275     if (AlwaysNew)
276       return nullptr;
277     return None;
278   }
279 
280   assert(OrigLoopID->getOperand(0) == OrigLoopID);
281 
282   bool InheritAllAttrs = !InheritOptionsExceptPrefix;
283   bool InheritSomeAttrs =
284       InheritOptionsExceptPrefix && InheritOptionsExceptPrefix[0] != '\0';
285   SmallVector<Metadata *, 8> MDs;
286   MDs.push_back(nullptr);
287 
288   bool Changed = false;
289   if (InheritAllAttrs || InheritSomeAttrs) {
290     for (const MDOperand &Existing : drop_begin(OrigLoopID->operands())) {
291       MDNode *Op = cast<MDNode>(Existing.get());
292 
293       auto InheritThisAttribute = [InheritSomeAttrs,
294                                    InheritOptionsExceptPrefix](MDNode *Op) {
295         if (!InheritSomeAttrs)
296           return false;
297 
298         // Skip malformatted attribute metadata nodes.
299         if (Op->getNumOperands() == 0)
300           return true;
301         Metadata *NameMD = Op->getOperand(0).get();
302         if (!isa<MDString>(NameMD))
303           return true;
304         StringRef AttrName = cast<MDString>(NameMD)->getString();
305 
306         // Do not inherit excluded attributes.
307         return !AttrName.startswith(InheritOptionsExceptPrefix);
308       };
309 
310       if (InheritThisAttribute(Op))
311         MDs.push_back(Op);
312       else
313         Changed = true;
314     }
315   } else {
316     // Modified if we dropped at least one attribute.
317     Changed = OrigLoopID->getNumOperands() > 1;
318   }
319 
320   bool HasAnyFollowup = false;
321   for (StringRef OptionName : FollowupOptions) {
322     MDNode *FollowupNode = findOptionMDForLoopID(OrigLoopID, OptionName);
323     if (!FollowupNode)
324       continue;
325 
326     HasAnyFollowup = true;
327     for (const MDOperand &Option : drop_begin(FollowupNode->operands())) {
328       MDs.push_back(Option.get());
329       Changed = true;
330     }
331   }
332 
333   // Attributes of the followup loop not specified explicity, so signal to the
334   // transformation pass to add suitable attributes.
335   if (!AlwaysNew && !HasAnyFollowup)
336     return None;
337 
338   // If no attributes were added or remove, the previous loop Id can be reused.
339   if (!AlwaysNew && !Changed)
340     return OrigLoopID;
341 
342   // No attributes is equivalent to having no !llvm.loop metadata at all.
343   if (MDs.size() == 1)
344     return nullptr;
345 
346   // Build the new loop ID.
347   MDTuple *FollowupLoopID = MDNode::get(OrigLoopID->getContext(), MDs);
348   FollowupLoopID->replaceOperandWith(0, FollowupLoopID);
349   return FollowupLoopID;
350 }
351 
352 bool llvm::hasDisableAllTransformsHint(const Loop *L) {
353   return getBooleanLoopAttribute(L, LLVMLoopDisableNonforced);
354 }
355 
356 bool llvm::hasDisableLICMTransformsHint(const Loop *L) {
357   return getBooleanLoopAttribute(L, LLVMLoopDisableLICM);
358 }
359 
360 TransformationMode llvm::hasUnrollTransformation(const Loop *L) {
361   if (getBooleanLoopAttribute(L, "llvm.loop.unroll.disable"))
362     return TM_SuppressedByUser;
363 
364   Optional<int> Count =
365       getOptionalIntLoopAttribute(L, "llvm.loop.unroll.count");
366   if (Count.hasValue())
367     return Count.getValue() == 1 ? TM_SuppressedByUser : TM_ForcedByUser;
368 
369   if (getBooleanLoopAttribute(L, "llvm.loop.unroll.enable"))
370     return TM_ForcedByUser;
371 
372   if (getBooleanLoopAttribute(L, "llvm.loop.unroll.full"))
373     return TM_ForcedByUser;
374 
375   if (hasDisableAllTransformsHint(L))
376     return TM_Disable;
377 
378   return TM_Unspecified;
379 }
380 
381 TransformationMode llvm::hasUnrollAndJamTransformation(const Loop *L) {
382   if (getBooleanLoopAttribute(L, "llvm.loop.unroll_and_jam.disable"))
383     return TM_SuppressedByUser;
384 
385   Optional<int> Count =
386       getOptionalIntLoopAttribute(L, "llvm.loop.unroll_and_jam.count");
387   if (Count.hasValue())
388     return Count.getValue() == 1 ? TM_SuppressedByUser : TM_ForcedByUser;
389 
390   if (getBooleanLoopAttribute(L, "llvm.loop.unroll_and_jam.enable"))
391     return TM_ForcedByUser;
392 
393   if (hasDisableAllTransformsHint(L))
394     return TM_Disable;
395 
396   return TM_Unspecified;
397 }
398 
399 TransformationMode llvm::hasVectorizeTransformation(const Loop *L) {
400   Optional<bool> Enable =
401       getOptionalBoolLoopAttribute(L, "llvm.loop.vectorize.enable");
402 
403   if (Enable == false)
404     return TM_SuppressedByUser;
405 
406   Optional<ElementCount> VectorizeWidth =
407       getOptionalElementCountLoopAttribute(L);
408   Optional<int> InterleaveCount =
409       getOptionalIntLoopAttribute(L, "llvm.loop.interleave.count");
410 
411   // 'Forcing' vector width and interleave count to one effectively disables
412   // this tranformation.
413   if (Enable == true && VectorizeWidth && VectorizeWidth->isScalar() &&
414       InterleaveCount == 1)
415     return TM_SuppressedByUser;
416 
417   if (getBooleanLoopAttribute(L, "llvm.loop.isvectorized"))
418     return TM_Disable;
419 
420   if (Enable == true)
421     return TM_ForcedByUser;
422 
423   if ((VectorizeWidth && VectorizeWidth->isScalar()) && InterleaveCount == 1)
424     return TM_Disable;
425 
426   if ((VectorizeWidth && VectorizeWidth->isVector()) || InterleaveCount > 1)
427     return TM_Enable;
428 
429   if (hasDisableAllTransformsHint(L))
430     return TM_Disable;
431 
432   return TM_Unspecified;
433 }
434 
435 TransformationMode llvm::hasDistributeTransformation(const Loop *L) {
436   if (getBooleanLoopAttribute(L, "llvm.loop.distribute.enable"))
437     return TM_ForcedByUser;
438 
439   if (hasDisableAllTransformsHint(L))
440     return TM_Disable;
441 
442   return TM_Unspecified;
443 }
444 
445 TransformationMode llvm::hasLICMVersioningTransformation(const Loop *L) {
446   if (getBooleanLoopAttribute(L, "llvm.loop.licm_versioning.disable"))
447     return TM_SuppressedByUser;
448 
449   if (hasDisableAllTransformsHint(L))
450     return TM_Disable;
451 
452   return TM_Unspecified;
453 }
454 
455 /// Does a BFS from a given node to all of its children inside a given loop.
456 /// The returned vector of nodes includes the starting point.
457 SmallVector<DomTreeNode *, 16>
458 llvm::collectChildrenInLoop(DomTreeNode *N, const Loop *CurLoop) {
459   SmallVector<DomTreeNode *, 16> Worklist;
460   auto AddRegionToWorklist = [&](DomTreeNode *DTN) {
461     // Only include subregions in the top level loop.
462     BasicBlock *BB = DTN->getBlock();
463     if (CurLoop->contains(BB))
464       Worklist.push_back(DTN);
465   };
466 
467   AddRegionToWorklist(N);
468 
469   for (size_t I = 0; I < Worklist.size(); I++) {
470     for (DomTreeNode *Child : Worklist[I]->children())
471       AddRegionToWorklist(Child);
472   }
473 
474   return Worklist;
475 }
476 
477 void llvm::deleteDeadLoop(Loop *L, DominatorTree *DT, ScalarEvolution *SE,
478                           LoopInfo *LI, MemorySSA *MSSA) {
479   assert((!DT || L->isLCSSAForm(*DT)) && "Expected LCSSA!");
480   auto *Preheader = L->getLoopPreheader();
481   assert(Preheader && "Preheader should exist!");
482 
483   std::unique_ptr<MemorySSAUpdater> MSSAU;
484   if (MSSA)
485     MSSAU = std::make_unique<MemorySSAUpdater>(MSSA);
486 
487   // Now that we know the removal is safe, remove the loop by changing the
488   // branch from the preheader to go to the single exit block.
489   //
490   // Because we're deleting a large chunk of code at once, the sequence in which
491   // we remove things is very important to avoid invalidation issues.
492 
493   // Tell ScalarEvolution that the loop is deleted. Do this before
494   // deleting the loop so that ScalarEvolution can look at the loop
495   // to determine what it needs to clean up.
496   if (SE)
497     SE->forgetLoop(L);
498 
499   auto *OldBr = dyn_cast<BranchInst>(Preheader->getTerminator());
500   assert(OldBr && "Preheader must end with a branch");
501   assert(OldBr->isUnconditional() && "Preheader must have a single successor");
502   // Connect the preheader to the exit block. Keep the old edge to the header
503   // around to perform the dominator tree update in two separate steps
504   // -- #1 insertion of the edge preheader -> exit and #2 deletion of the edge
505   // preheader -> header.
506   //
507   //
508   // 0.  Preheader          1.  Preheader           2.  Preheader
509   //        |                    |   |                   |
510   //        V                    |   V                   |
511   //      Header <--\            | Header <--\           | Header <--\
512   //       |  |     |            |  |  |     |           |  |  |     |
513   //       |  V     |            |  |  V     |           |  |  V     |
514   //       | Body --/            |  | Body --/           |  | Body --/
515   //       V                     V  V                    V  V
516   //      Exit                   Exit                    Exit
517   //
518   // By doing this is two separate steps we can perform the dominator tree
519   // update without using the batch update API.
520   //
521   // Even when the loop is never executed, we cannot remove the edge from the
522   // source block to the exit block. Consider the case where the unexecuted loop
523   // branches back to an outer loop. If we deleted the loop and removed the edge
524   // coming to this inner loop, this will break the outer loop structure (by
525   // deleting the backedge of the outer loop). If the outer loop is indeed a
526   // non-loop, it will be deleted in a future iteration of loop deletion pass.
527   IRBuilder<> Builder(OldBr);
528 
529   auto *ExitBlock = L->getUniqueExitBlock();
530   DomTreeUpdater DTU(DT, DomTreeUpdater::UpdateStrategy::Eager);
531   if (ExitBlock) {
532     assert(ExitBlock && "Should have a unique exit block!");
533     assert(L->hasDedicatedExits() && "Loop should have dedicated exits!");
534 
535     Builder.CreateCondBr(Builder.getFalse(), L->getHeader(), ExitBlock);
536     // Remove the old branch. The conditional branch becomes a new terminator.
537     OldBr->eraseFromParent();
538 
539     // Rewrite phis in the exit block to get their inputs from the Preheader
540     // instead of the exiting block.
541     for (PHINode &P : ExitBlock->phis()) {
542       // Set the zero'th element of Phi to be from the preheader and remove all
543       // other incoming values. Given the loop has dedicated exits, all other
544       // incoming values must be from the exiting blocks.
545       int PredIndex = 0;
546       P.setIncomingBlock(PredIndex, Preheader);
547       // Removes all incoming values from all other exiting blocks (including
548       // duplicate values from an exiting block).
549       // Nuke all entries except the zero'th entry which is the preheader entry.
550       // NOTE! We need to remove Incoming Values in the reverse order as done
551       // below, to keep the indices valid for deletion (removeIncomingValues
552       // updates getNumIncomingValues and shifts all values down into the
553       // operand being deleted).
554       for (unsigned i = 0, e = P.getNumIncomingValues() - 1; i != e; ++i)
555         P.removeIncomingValue(e - i, false);
556 
557       assert((P.getNumIncomingValues() == 1 &&
558               P.getIncomingBlock(PredIndex) == Preheader) &&
559              "Should have exactly one value and that's from the preheader!");
560     }
561 
562     if (DT) {
563       DTU.applyUpdates({{DominatorTree::Insert, Preheader, ExitBlock}});
564       if (MSSA) {
565         MSSAU->applyUpdates({{DominatorTree::Insert, Preheader, ExitBlock}},
566                             *DT);
567         if (VerifyMemorySSA)
568           MSSA->verifyMemorySSA();
569       }
570     }
571 
572     // Disconnect the loop body by branching directly to its exit.
573     Builder.SetInsertPoint(Preheader->getTerminator());
574     Builder.CreateBr(ExitBlock);
575     // Remove the old branch.
576     Preheader->getTerminator()->eraseFromParent();
577   } else {
578     assert(L->hasNoExitBlocks() &&
579            "Loop should have either zero or one exit blocks.");
580 
581     Builder.SetInsertPoint(OldBr);
582     Builder.CreateUnreachable();
583     Preheader->getTerminator()->eraseFromParent();
584   }
585 
586   if (DT) {
587     DTU.applyUpdates({{DominatorTree::Delete, Preheader, L->getHeader()}});
588     if (MSSA) {
589       MSSAU->applyUpdates({{DominatorTree::Delete, Preheader, L->getHeader()}},
590                           *DT);
591       SmallSetVector<BasicBlock *, 8> DeadBlockSet(L->block_begin(),
592                                                    L->block_end());
593       MSSAU->removeBlocks(DeadBlockSet);
594       if (VerifyMemorySSA)
595         MSSA->verifyMemorySSA();
596     }
597   }
598 
599   // Use a map to unique and a vector to guarantee deterministic ordering.
600   llvm::SmallDenseSet<std::pair<DIVariable *, DIExpression *>, 4> DeadDebugSet;
601   llvm::SmallVector<DbgVariableIntrinsic *, 4> DeadDebugInst;
602 
603   if (ExitBlock) {
604     // Given LCSSA form is satisfied, we should not have users of instructions
605     // within the dead loop outside of the loop. However, LCSSA doesn't take
606     // unreachable uses into account. We handle them here.
607     // We could do it after drop all references (in this case all users in the
608     // loop will be already eliminated and we have less work to do but according
609     // to API doc of User::dropAllReferences only valid operation after dropping
610     // references, is deletion. So let's substitute all usages of
611     // instruction from the loop with undef value of corresponding type first.
612     for (auto *Block : L->blocks())
613       for (Instruction &I : *Block) {
614         auto *Undef = UndefValue::get(I.getType());
615         for (Use &U : llvm::make_early_inc_range(I.uses())) {
616           if (auto *Usr = dyn_cast<Instruction>(U.getUser()))
617             if (L->contains(Usr->getParent()))
618               continue;
619           // If we have a DT then we can check that uses outside a loop only in
620           // unreachable block.
621           if (DT)
622             assert(!DT->isReachableFromEntry(U) &&
623                    "Unexpected user in reachable block");
624           U.set(Undef);
625         }
626         auto *DVI = dyn_cast<DbgVariableIntrinsic>(&I);
627         if (!DVI)
628           continue;
629         auto Key =
630             DeadDebugSet.find({DVI->getVariable(), DVI->getExpression()});
631         if (Key != DeadDebugSet.end())
632           continue;
633         DeadDebugSet.insert({DVI->getVariable(), DVI->getExpression()});
634         DeadDebugInst.push_back(DVI);
635       }
636 
637     // After the loop has been deleted all the values defined and modified
638     // inside the loop are going to be unavailable.
639     // Since debug values in the loop have been deleted, inserting an undef
640     // dbg.value truncates the range of any dbg.value before the loop where the
641     // loop used to be. This is particularly important for constant values.
642     DIBuilder DIB(*ExitBlock->getModule());
643     Instruction *InsertDbgValueBefore = ExitBlock->getFirstNonPHI();
644     assert(InsertDbgValueBefore &&
645            "There should be a non-PHI instruction in exit block, else these "
646            "instructions will have no parent.");
647     for (auto *DVI : DeadDebugInst)
648       DIB.insertDbgValueIntrinsic(UndefValue::get(Builder.getInt32Ty()),
649                                   DVI->getVariable(), DVI->getExpression(),
650                                   DVI->getDebugLoc(), InsertDbgValueBefore);
651   }
652 
653   // Remove the block from the reference counting scheme, so that we can
654   // delete it freely later.
655   for (auto *Block : L->blocks())
656     Block->dropAllReferences();
657 
658   if (MSSA && VerifyMemorySSA)
659     MSSA->verifyMemorySSA();
660 
661   if (LI) {
662     // Erase the instructions and the blocks without having to worry
663     // about ordering because we already dropped the references.
664     // NOTE: This iteration is safe because erasing the block does not remove
665     // its entry from the loop's block list.  We do that in the next section.
666     for (BasicBlock *BB : L->blocks())
667       BB->eraseFromParent();
668 
669     // Finally, the blocks from loopinfo.  This has to happen late because
670     // otherwise our loop iterators won't work.
671 
672     SmallPtrSet<BasicBlock *, 8> blocks;
673     blocks.insert(L->block_begin(), L->block_end());
674     for (BasicBlock *BB : blocks)
675       LI->removeBlock(BB);
676 
677     // The last step is to update LoopInfo now that we've eliminated this loop.
678     // Note: LoopInfo::erase remove the given loop and relink its subloops with
679     // its parent. While removeLoop/removeChildLoop remove the given loop but
680     // not relink its subloops, which is what we want.
681     if (Loop *ParentLoop = L->getParentLoop()) {
682       Loop::iterator I = find(*ParentLoop, L);
683       assert(I != ParentLoop->end() && "Couldn't find loop");
684       ParentLoop->removeChildLoop(I);
685     } else {
686       Loop::iterator I = find(*LI, L);
687       assert(I != LI->end() && "Couldn't find loop");
688       LI->removeLoop(I);
689     }
690     LI->destroy(L);
691   }
692 }
693 
694 static Loop *getOutermostLoop(Loop *L) {
695   while (Loop *Parent = L->getParentLoop())
696     L = Parent;
697   return L;
698 }
699 
700 void llvm::breakLoopBackedge(Loop *L, DominatorTree &DT, ScalarEvolution &SE,
701                              LoopInfo &LI, MemorySSA *MSSA) {
702   auto *Latch = L->getLoopLatch();
703   assert(Latch && "multiple latches not yet supported");
704   auto *Header = L->getHeader();
705   Loop *OutermostLoop = getOutermostLoop(L);
706 
707   SE.forgetLoop(L);
708 
709   std::unique_ptr<MemorySSAUpdater> MSSAU;
710   if (MSSA)
711     MSSAU = std::make_unique<MemorySSAUpdater>(MSSA);
712 
713   // Update the CFG and domtree.  We chose to special case a couple of
714   // of common cases for code quality and test readability reasons.
715   [&]() -> void {
716     if (auto *BI = dyn_cast<BranchInst>(Latch->getTerminator())) {
717       if (!BI->isConditional()) {
718         DomTreeUpdater DTU(&DT, DomTreeUpdater::UpdateStrategy::Eager);
719         (void)changeToUnreachable(BI, /*PreserveLCSSA*/ true, &DTU,
720                                   MSSAU.get());
721         return;
722       }
723 
724       // Conditional latch/exit - note that latch can be shared by inner
725       // and outer loop so the other target doesn't need to an exit
726       if (L->isLoopExiting(Latch)) {
727         // TODO: Generalize ConstantFoldTerminator so that it can be used
728         // here without invalidating LCSSA or MemorySSA.  (Tricky case for
729         // LCSSA: header is an exit block of a preceeding sibling loop w/o
730         // dedicated exits.)
731         const unsigned ExitIdx = L->contains(BI->getSuccessor(0)) ? 1 : 0;
732         BasicBlock *ExitBB = BI->getSuccessor(ExitIdx);
733 
734         DomTreeUpdater DTU(&DT, DomTreeUpdater::UpdateStrategy::Eager);
735         Header->removePredecessor(Latch, true);
736 
737         IRBuilder<> Builder(BI);
738         auto *NewBI = Builder.CreateBr(ExitBB);
739         // Transfer the metadata to the new branch instruction (minus the
740         // loop info since this is no longer a loop)
741         NewBI->copyMetadata(*BI, {LLVMContext::MD_dbg,
742                                   LLVMContext::MD_annotation});
743 
744         BI->eraseFromParent();
745         DTU.applyUpdates({{DominatorTree::Delete, Latch, Header}});
746         if (MSSA)
747           MSSAU->applyUpdates({{DominatorTree::Delete, Latch, Header}}, DT);
748         return;
749       }
750     }
751 
752     // General case.  By splitting the backedge, and then explicitly making it
753     // unreachable we gracefully handle corner cases such as switch and invoke
754     // termiantors.
755     auto *BackedgeBB = SplitEdge(Latch, Header, &DT, &LI, MSSAU.get());
756 
757     DomTreeUpdater DTU(&DT, DomTreeUpdater::UpdateStrategy::Eager);
758     (void)changeToUnreachable(BackedgeBB->getTerminator(),
759                               /*PreserveLCSSA*/ true, &DTU, MSSAU.get());
760   }();
761 
762   // Erase (and destroy) this loop instance.  Handles relinking sub-loops
763   // and blocks within the loop as needed.
764   LI.erase(L);
765 
766   // If the loop we broke had a parent, then changeToUnreachable might have
767   // caused a block to be removed from the parent loop (see loop_nest_lcssa
768   // test case in zero-btc.ll for an example), thus changing the parent's
769   // exit blocks.  If that happened, we need to rebuild LCSSA on the outermost
770   // loop which might have a had a block removed.
771   if (OutermostLoop != L)
772     formLCSSARecursively(*OutermostLoop, DT, &LI, &SE);
773 }
774 
775 
776 /// Checks if \p L has single exit through latch block except possibly
777 /// "deoptimizing" exits. Returns branch instruction terminating the loop
778 /// latch if above check is successful, nullptr otherwise.
779 static BranchInst *getExpectedExitLoopLatchBranch(Loop *L) {
780   BasicBlock *Latch = L->getLoopLatch();
781   if (!Latch)
782     return nullptr;
783 
784   BranchInst *LatchBR = dyn_cast<BranchInst>(Latch->getTerminator());
785   if (!LatchBR || LatchBR->getNumSuccessors() != 2 || !L->isLoopExiting(Latch))
786     return nullptr;
787 
788   assert((LatchBR->getSuccessor(0) == L->getHeader() ||
789           LatchBR->getSuccessor(1) == L->getHeader()) &&
790          "At least one edge out of the latch must go to the header");
791 
792   SmallVector<BasicBlock *, 4> ExitBlocks;
793   L->getUniqueNonLatchExitBlocks(ExitBlocks);
794   if (any_of(ExitBlocks, [](const BasicBlock *EB) {
795         return !EB->getTerminatingDeoptimizeCall();
796       }))
797     return nullptr;
798 
799   return LatchBR;
800 }
801 
802 Optional<unsigned>
803 llvm::getLoopEstimatedTripCount(Loop *L,
804                                 unsigned *EstimatedLoopInvocationWeight) {
805   // Support loops with an exiting latch and other existing exists only
806   // deoptimize.
807   BranchInst *LatchBranch = getExpectedExitLoopLatchBranch(L);
808   if (!LatchBranch)
809     return None;
810 
811   // To estimate the number of times the loop body was executed, we want to
812   // know the number of times the backedge was taken, vs. the number of times
813   // we exited the loop.
814   uint64_t BackedgeTakenWeight, LatchExitWeight;
815   if (!LatchBranch->extractProfMetadata(BackedgeTakenWeight, LatchExitWeight))
816     return None;
817 
818   if (LatchBranch->getSuccessor(0) != L->getHeader())
819     std::swap(BackedgeTakenWeight, LatchExitWeight);
820 
821   if (!LatchExitWeight)
822     return None;
823 
824   if (EstimatedLoopInvocationWeight)
825     *EstimatedLoopInvocationWeight = LatchExitWeight;
826 
827   // Estimated backedge taken count is a ratio of the backedge taken weight by
828   // the weight of the edge exiting the loop, rounded to nearest.
829   uint64_t BackedgeTakenCount =
830       llvm::divideNearest(BackedgeTakenWeight, LatchExitWeight);
831   // Estimated trip count is one plus estimated backedge taken count.
832   return BackedgeTakenCount + 1;
833 }
834 
835 bool llvm::setLoopEstimatedTripCount(Loop *L, unsigned EstimatedTripCount,
836                                      unsigned EstimatedloopInvocationWeight) {
837   // Support loops with an exiting latch and other existing exists only
838   // deoptimize.
839   BranchInst *LatchBranch = getExpectedExitLoopLatchBranch(L);
840   if (!LatchBranch)
841     return false;
842 
843   // Calculate taken and exit weights.
844   unsigned LatchExitWeight = 0;
845   unsigned BackedgeTakenWeight = 0;
846 
847   if (EstimatedTripCount > 0) {
848     LatchExitWeight = EstimatedloopInvocationWeight;
849     BackedgeTakenWeight = (EstimatedTripCount - 1) * LatchExitWeight;
850   }
851 
852   // Make a swap if back edge is taken when condition is "false".
853   if (LatchBranch->getSuccessor(0) != L->getHeader())
854     std::swap(BackedgeTakenWeight, LatchExitWeight);
855 
856   MDBuilder MDB(LatchBranch->getContext());
857 
858   // Set/Update profile metadata.
859   LatchBranch->setMetadata(
860       LLVMContext::MD_prof,
861       MDB.createBranchWeights(BackedgeTakenWeight, LatchExitWeight));
862 
863   return true;
864 }
865 
866 bool llvm::hasIterationCountInvariantInParent(Loop *InnerLoop,
867                                               ScalarEvolution &SE) {
868   Loop *OuterL = InnerLoop->getParentLoop();
869   if (!OuterL)
870     return true;
871 
872   // Get the backedge taken count for the inner loop
873   BasicBlock *InnerLoopLatch = InnerLoop->getLoopLatch();
874   const SCEV *InnerLoopBECountSC = SE.getExitCount(InnerLoop, InnerLoopLatch);
875   if (isa<SCEVCouldNotCompute>(InnerLoopBECountSC) ||
876       !InnerLoopBECountSC->getType()->isIntegerTy())
877     return false;
878 
879   // Get whether count is invariant to the outer loop
880   ScalarEvolution::LoopDisposition LD =
881       SE.getLoopDisposition(InnerLoopBECountSC, OuterL);
882   if (LD != ScalarEvolution::LoopInvariant)
883     return false;
884 
885   return true;
886 }
887 
888 CmpInst::Predicate llvm::getMinMaxReductionPredicate(RecurKind RK) {
889   switch (RK) {
890   default:
891     llvm_unreachable("Unknown min/max recurrence kind");
892   case RecurKind::UMin:
893     return CmpInst::ICMP_ULT;
894   case RecurKind::UMax:
895     return CmpInst::ICMP_UGT;
896   case RecurKind::SMin:
897     return CmpInst::ICMP_SLT;
898   case RecurKind::SMax:
899     return CmpInst::ICMP_SGT;
900   case RecurKind::FMin:
901     return CmpInst::FCMP_OLT;
902   case RecurKind::FMax:
903     return CmpInst::FCMP_OGT;
904   }
905 }
906 
907 Value *llvm::createSelectCmpOp(IRBuilderBase &Builder, Value *StartVal,
908                                RecurKind RK, Value *Left, Value *Right) {
909   if (auto VTy = dyn_cast<VectorType>(Left->getType()))
910     StartVal = Builder.CreateVectorSplat(VTy->getElementCount(), StartVal);
911   Value *Cmp =
912       Builder.CreateCmp(CmpInst::ICMP_NE, Left, StartVal, "rdx.select.cmp");
913   return Builder.CreateSelect(Cmp, Left, Right, "rdx.select");
914 }
915 
916 Value *llvm::createMinMaxOp(IRBuilderBase &Builder, RecurKind RK, Value *Left,
917                             Value *Right) {
918   CmpInst::Predicate Pred = getMinMaxReductionPredicate(RK);
919   Value *Cmp = Builder.CreateCmp(Pred, Left, Right, "rdx.minmax.cmp");
920   Value *Select = Builder.CreateSelect(Cmp, Left, Right, "rdx.minmax.select");
921   return Select;
922 }
923 
924 // Helper to generate an ordered reduction.
925 Value *llvm::getOrderedReduction(IRBuilderBase &Builder, Value *Acc, Value *Src,
926                                  unsigned Op, RecurKind RdxKind,
927                                  ArrayRef<Value *> RedOps) {
928   unsigned VF = cast<FixedVectorType>(Src->getType())->getNumElements();
929 
930   // Extract and apply reduction ops in ascending order:
931   // e.g. ((((Acc + Scl[0]) + Scl[1]) + Scl[2]) + ) ... + Scl[VF-1]
932   Value *Result = Acc;
933   for (unsigned ExtractIdx = 0; ExtractIdx != VF; ++ExtractIdx) {
934     Value *Ext =
935         Builder.CreateExtractElement(Src, Builder.getInt32(ExtractIdx));
936 
937     if (Op != Instruction::ICmp && Op != Instruction::FCmp) {
938       Result = Builder.CreateBinOp((Instruction::BinaryOps)Op, Result, Ext,
939                                    "bin.rdx");
940     } else {
941       assert(RecurrenceDescriptor::isMinMaxRecurrenceKind(RdxKind) &&
942              "Invalid min/max");
943       Result = createMinMaxOp(Builder, RdxKind, Result, Ext);
944     }
945 
946     if (!RedOps.empty())
947       propagateIRFlags(Result, RedOps);
948   }
949 
950   return Result;
951 }
952 
953 // Helper to generate a log2 shuffle reduction.
954 Value *llvm::getShuffleReduction(IRBuilderBase &Builder, Value *Src,
955                                  unsigned Op, RecurKind RdxKind,
956                                  ArrayRef<Value *> RedOps) {
957   unsigned VF = cast<FixedVectorType>(Src->getType())->getNumElements();
958   // VF is a power of 2 so we can emit the reduction using log2(VF) shuffles
959   // and vector ops, reducing the set of values being computed by half each
960   // round.
961   assert(isPowerOf2_32(VF) &&
962          "Reduction emission only supported for pow2 vectors!");
963   Value *TmpVec = Src;
964   SmallVector<int, 32> ShuffleMask(VF);
965   for (unsigned i = VF; i != 1; i >>= 1) {
966     // Move the upper half of the vector to the lower half.
967     for (unsigned j = 0; j != i / 2; ++j)
968       ShuffleMask[j] = i / 2 + j;
969 
970     // Fill the rest of the mask with undef.
971     std::fill(&ShuffleMask[i / 2], ShuffleMask.end(), -1);
972 
973     Value *Shuf = Builder.CreateShuffleVector(TmpVec, ShuffleMask, "rdx.shuf");
974 
975     if (Op != Instruction::ICmp && Op != Instruction::FCmp) {
976       // The builder propagates its fast-math-flags setting.
977       TmpVec = Builder.CreateBinOp((Instruction::BinaryOps)Op, TmpVec, Shuf,
978                                    "bin.rdx");
979     } else {
980       assert(RecurrenceDescriptor::isMinMaxRecurrenceKind(RdxKind) &&
981              "Invalid min/max");
982       TmpVec = createMinMaxOp(Builder, RdxKind, TmpVec, Shuf);
983     }
984     if (!RedOps.empty())
985       propagateIRFlags(TmpVec, RedOps);
986 
987     // We may compute the reassociated scalar ops in a way that does not
988     // preserve nsw/nuw etc. Conservatively, drop those flags.
989     if (auto *ReductionInst = dyn_cast<Instruction>(TmpVec))
990       ReductionInst->dropPoisonGeneratingFlags();
991   }
992   // The result is in the first element of the vector.
993   return Builder.CreateExtractElement(TmpVec, Builder.getInt32(0));
994 }
995 
996 Value *llvm::createSelectCmpTargetReduction(IRBuilderBase &Builder,
997                                             const TargetTransformInfo *TTI,
998                                             Value *Src,
999                                             const RecurrenceDescriptor &Desc,
1000                                             PHINode *OrigPhi) {
1001   assert(RecurrenceDescriptor::isSelectCmpRecurrenceKind(
1002              Desc.getRecurrenceKind()) &&
1003          "Unexpected reduction kind");
1004   Value *InitVal = Desc.getRecurrenceStartValue();
1005   Value *NewVal = nullptr;
1006 
1007   // First use the original phi to determine the new value we're trying to
1008   // select from in the loop.
1009   SelectInst *SI = nullptr;
1010   for (auto *U : OrigPhi->users()) {
1011     if ((SI = dyn_cast<SelectInst>(U)))
1012       break;
1013   }
1014   assert(SI && "One user of the original phi should be a select");
1015 
1016   if (SI->getTrueValue() == OrigPhi)
1017     NewVal = SI->getFalseValue();
1018   else {
1019     assert(SI->getFalseValue() == OrigPhi &&
1020            "At least one input to the select should be the original Phi");
1021     NewVal = SI->getTrueValue();
1022   }
1023 
1024   // Create a splat vector with the new value and compare this to the vector
1025   // we want to reduce.
1026   ElementCount EC = cast<VectorType>(Src->getType())->getElementCount();
1027   Value *Right = Builder.CreateVectorSplat(EC, InitVal);
1028   Value *Cmp =
1029       Builder.CreateCmp(CmpInst::ICMP_NE, Src, Right, "rdx.select.cmp");
1030 
1031   // If any predicate is true it means that we want to select the new value.
1032   Cmp = Builder.CreateOrReduce(Cmp);
1033   return Builder.CreateSelect(Cmp, NewVal, InitVal, "rdx.select");
1034 }
1035 
1036 Value *llvm::createSimpleTargetReduction(IRBuilderBase &Builder,
1037                                          const TargetTransformInfo *TTI,
1038                                          Value *Src, RecurKind RdxKind,
1039                                          ArrayRef<Value *> RedOps) {
1040   auto *SrcVecEltTy = cast<VectorType>(Src->getType())->getElementType();
1041   switch (RdxKind) {
1042   case RecurKind::Add:
1043     return Builder.CreateAddReduce(Src);
1044   case RecurKind::Mul:
1045     return Builder.CreateMulReduce(Src);
1046   case RecurKind::And:
1047     return Builder.CreateAndReduce(Src);
1048   case RecurKind::Or:
1049     return Builder.CreateOrReduce(Src);
1050   case RecurKind::Xor:
1051     return Builder.CreateXorReduce(Src);
1052   case RecurKind::FMulAdd:
1053   case RecurKind::FAdd:
1054     return Builder.CreateFAddReduce(ConstantFP::getNegativeZero(SrcVecEltTy),
1055                                     Src);
1056   case RecurKind::FMul:
1057     return Builder.CreateFMulReduce(ConstantFP::get(SrcVecEltTy, 1.0), Src);
1058   case RecurKind::SMax:
1059     return Builder.CreateIntMaxReduce(Src, true);
1060   case RecurKind::SMin:
1061     return Builder.CreateIntMinReduce(Src, true);
1062   case RecurKind::UMax:
1063     return Builder.CreateIntMaxReduce(Src, false);
1064   case RecurKind::UMin:
1065     return Builder.CreateIntMinReduce(Src, false);
1066   case RecurKind::FMax:
1067     return Builder.CreateFPMaxReduce(Src);
1068   case RecurKind::FMin:
1069     return Builder.CreateFPMinReduce(Src);
1070   default:
1071     llvm_unreachable("Unhandled opcode");
1072   }
1073 }
1074 
1075 Value *llvm::createTargetReduction(IRBuilderBase &B,
1076                                    const TargetTransformInfo *TTI,
1077                                    const RecurrenceDescriptor &Desc, Value *Src,
1078                                    PHINode *OrigPhi) {
1079   // TODO: Support in-order reductions based on the recurrence descriptor.
1080   // All ops in the reduction inherit fast-math-flags from the recurrence
1081   // descriptor.
1082   IRBuilderBase::FastMathFlagGuard FMFGuard(B);
1083   B.setFastMathFlags(Desc.getFastMathFlags());
1084 
1085   RecurKind RK = Desc.getRecurrenceKind();
1086   if (RecurrenceDescriptor::isSelectCmpRecurrenceKind(RK))
1087     return createSelectCmpTargetReduction(B, TTI, Src, Desc, OrigPhi);
1088 
1089   return createSimpleTargetReduction(B, TTI, Src, RK);
1090 }
1091 
1092 Value *llvm::createOrderedReduction(IRBuilderBase &B,
1093                                     const RecurrenceDescriptor &Desc,
1094                                     Value *Src, Value *Start) {
1095   assert((Desc.getRecurrenceKind() == RecurKind::FAdd ||
1096           Desc.getRecurrenceKind() == RecurKind::FMulAdd) &&
1097          "Unexpected reduction kind");
1098   assert(Src->getType()->isVectorTy() && "Expected a vector type");
1099   assert(!Start->getType()->isVectorTy() && "Expected a scalar type");
1100 
1101   return B.CreateFAddReduce(Start, Src);
1102 }
1103 
1104 void llvm::propagateIRFlags(Value *I, ArrayRef<Value *> VL, Value *OpValue) {
1105   auto *VecOp = dyn_cast<Instruction>(I);
1106   if (!VecOp)
1107     return;
1108   auto *Intersection = (OpValue == nullptr) ? dyn_cast<Instruction>(VL[0])
1109                                             : dyn_cast<Instruction>(OpValue);
1110   if (!Intersection)
1111     return;
1112   const unsigned Opcode = Intersection->getOpcode();
1113   VecOp->copyIRFlags(Intersection);
1114   for (auto *V : VL) {
1115     auto *Instr = dyn_cast<Instruction>(V);
1116     if (!Instr)
1117       continue;
1118     if (OpValue == nullptr || Opcode == Instr->getOpcode())
1119       VecOp->andIRFlags(V);
1120   }
1121 }
1122 
1123 bool llvm::isKnownNegativeInLoop(const SCEV *S, const Loop *L,
1124                                  ScalarEvolution &SE) {
1125   const SCEV *Zero = SE.getZero(S->getType());
1126   return SE.isAvailableAtLoopEntry(S, L) &&
1127          SE.isLoopEntryGuardedByCond(L, ICmpInst::ICMP_SLT, S, Zero);
1128 }
1129 
1130 bool llvm::isKnownNonNegativeInLoop(const SCEV *S, const Loop *L,
1131                                     ScalarEvolution &SE) {
1132   const SCEV *Zero = SE.getZero(S->getType());
1133   return SE.isAvailableAtLoopEntry(S, L) &&
1134          SE.isLoopEntryGuardedByCond(L, ICmpInst::ICMP_SGE, S, Zero);
1135 }
1136 
1137 bool llvm::cannotBeMinInLoop(const SCEV *S, const Loop *L, ScalarEvolution &SE,
1138                              bool Signed) {
1139   unsigned BitWidth = cast<IntegerType>(S->getType())->getBitWidth();
1140   APInt Min = Signed ? APInt::getSignedMinValue(BitWidth) :
1141     APInt::getMinValue(BitWidth);
1142   auto Predicate = Signed ? ICmpInst::ICMP_SGT : ICmpInst::ICMP_UGT;
1143   return SE.isAvailableAtLoopEntry(S, L) &&
1144          SE.isLoopEntryGuardedByCond(L, Predicate, S,
1145                                      SE.getConstant(Min));
1146 }
1147 
1148 bool llvm::cannotBeMaxInLoop(const SCEV *S, const Loop *L, ScalarEvolution &SE,
1149                              bool Signed) {
1150   unsigned BitWidth = cast<IntegerType>(S->getType())->getBitWidth();
1151   APInt Max = Signed ? APInt::getSignedMaxValue(BitWidth) :
1152     APInt::getMaxValue(BitWidth);
1153   auto Predicate = Signed ? ICmpInst::ICMP_SLT : ICmpInst::ICMP_ULT;
1154   return SE.isAvailableAtLoopEntry(S, L) &&
1155          SE.isLoopEntryGuardedByCond(L, Predicate, S,
1156                                      SE.getConstant(Max));
1157 }
1158 
1159 //===----------------------------------------------------------------------===//
1160 // rewriteLoopExitValues - Optimize IV users outside the loop.
1161 // As a side effect, reduces the amount of IV processing within the loop.
1162 //===----------------------------------------------------------------------===//
1163 
1164 static bool hasHardUserWithinLoop(const Loop *L, const Instruction *I) {
1165   SmallPtrSet<const Instruction *, 8> Visited;
1166   SmallVector<const Instruction *, 8> WorkList;
1167   Visited.insert(I);
1168   WorkList.push_back(I);
1169   while (!WorkList.empty()) {
1170     const Instruction *Curr = WorkList.pop_back_val();
1171     // This use is outside the loop, nothing to do.
1172     if (!L->contains(Curr))
1173       continue;
1174     // Do we assume it is a "hard" use which will not be eliminated easily?
1175     if (Curr->mayHaveSideEffects())
1176       return true;
1177     // Otherwise, add all its users to worklist.
1178     for (auto U : Curr->users()) {
1179       auto *UI = cast<Instruction>(U);
1180       if (Visited.insert(UI).second)
1181         WorkList.push_back(UI);
1182     }
1183   }
1184   return false;
1185 }
1186 
1187 // Collect information about PHI nodes which can be transformed in
1188 // rewriteLoopExitValues.
1189 struct RewritePhi {
1190   PHINode *PN;               // For which PHI node is this replacement?
1191   unsigned Ith;              // For which incoming value?
1192   const SCEV *ExpansionSCEV; // The SCEV of the incoming value we are rewriting.
1193   Instruction *ExpansionPoint; // Where we'd like to expand that SCEV?
1194   bool HighCost;               // Is this expansion a high-cost?
1195 
1196   RewritePhi(PHINode *P, unsigned I, const SCEV *Val, Instruction *ExpansionPt,
1197              bool H)
1198       : PN(P), Ith(I), ExpansionSCEV(Val), ExpansionPoint(ExpansionPt),
1199         HighCost(H) {}
1200 };
1201 
1202 // Check whether it is possible to delete the loop after rewriting exit
1203 // value. If it is possible, ignore ReplaceExitValue and do rewriting
1204 // aggressively.
1205 static bool canLoopBeDeleted(Loop *L, SmallVector<RewritePhi, 8> &RewritePhiSet) {
1206   BasicBlock *Preheader = L->getLoopPreheader();
1207   // If there is no preheader, the loop will not be deleted.
1208   if (!Preheader)
1209     return false;
1210 
1211   // In LoopDeletion pass Loop can be deleted when ExitingBlocks.size() > 1.
1212   // We obviate multiple ExitingBlocks case for simplicity.
1213   // TODO: If we see testcase with multiple ExitingBlocks can be deleted
1214   // after exit value rewriting, we can enhance the logic here.
1215   SmallVector<BasicBlock *, 4> ExitingBlocks;
1216   L->getExitingBlocks(ExitingBlocks);
1217   SmallVector<BasicBlock *, 8> ExitBlocks;
1218   L->getUniqueExitBlocks(ExitBlocks);
1219   if (ExitBlocks.size() != 1 || ExitingBlocks.size() != 1)
1220     return false;
1221 
1222   BasicBlock *ExitBlock = ExitBlocks[0];
1223   BasicBlock::iterator BI = ExitBlock->begin();
1224   while (PHINode *P = dyn_cast<PHINode>(BI)) {
1225     Value *Incoming = P->getIncomingValueForBlock(ExitingBlocks[0]);
1226 
1227     // If the Incoming value of P is found in RewritePhiSet, we know it
1228     // could be rewritten to use a loop invariant value in transformation
1229     // phase later. Skip it in the loop invariant check below.
1230     bool found = false;
1231     for (const RewritePhi &Phi : RewritePhiSet) {
1232       unsigned i = Phi.Ith;
1233       if (Phi.PN == P && (Phi.PN)->getIncomingValue(i) == Incoming) {
1234         found = true;
1235         break;
1236       }
1237     }
1238 
1239     Instruction *I;
1240     if (!found && (I = dyn_cast<Instruction>(Incoming)))
1241       if (!L->hasLoopInvariantOperands(I))
1242         return false;
1243 
1244     ++BI;
1245   }
1246 
1247   for (auto *BB : L->blocks())
1248     if (llvm::any_of(*BB, [](Instruction &I) {
1249           return I.mayHaveSideEffects();
1250         }))
1251       return false;
1252 
1253   return true;
1254 }
1255 
1256 int llvm::rewriteLoopExitValues(Loop *L, LoopInfo *LI, TargetLibraryInfo *TLI,
1257                                 ScalarEvolution *SE,
1258                                 const TargetTransformInfo *TTI,
1259                                 SCEVExpander &Rewriter, DominatorTree *DT,
1260                                 ReplaceExitVal ReplaceExitValue,
1261                                 SmallVector<WeakTrackingVH, 16> &DeadInsts) {
1262   // Check a pre-condition.
1263   assert(L->isRecursivelyLCSSAForm(*DT, *LI) &&
1264          "Indvars did not preserve LCSSA!");
1265 
1266   SmallVector<BasicBlock*, 8> ExitBlocks;
1267   L->getUniqueExitBlocks(ExitBlocks);
1268 
1269   SmallVector<RewritePhi, 8> RewritePhiSet;
1270   // Find all values that are computed inside the loop, but used outside of it.
1271   // Because of LCSSA, these values will only occur in LCSSA PHI Nodes.  Scan
1272   // the exit blocks of the loop to find them.
1273   for (BasicBlock *ExitBB : ExitBlocks) {
1274     // If there are no PHI nodes in this exit block, then no values defined
1275     // inside the loop are used on this path, skip it.
1276     PHINode *PN = dyn_cast<PHINode>(ExitBB->begin());
1277     if (!PN) continue;
1278 
1279     unsigned NumPreds = PN->getNumIncomingValues();
1280 
1281     // Iterate over all of the PHI nodes.
1282     BasicBlock::iterator BBI = ExitBB->begin();
1283     while ((PN = dyn_cast<PHINode>(BBI++))) {
1284       if (PN->use_empty())
1285         continue; // dead use, don't replace it
1286 
1287       if (!SE->isSCEVable(PN->getType()))
1288         continue;
1289 
1290       // Iterate over all of the values in all the PHI nodes.
1291       for (unsigned i = 0; i != NumPreds; ++i) {
1292         // If the value being merged in is not integer or is not defined
1293         // in the loop, skip it.
1294         Value *InVal = PN->getIncomingValue(i);
1295         if (!isa<Instruction>(InVal))
1296           continue;
1297 
1298         // If this pred is for a subloop, not L itself, skip it.
1299         if (LI->getLoopFor(PN->getIncomingBlock(i)) != L)
1300           continue; // The Block is in a subloop, skip it.
1301 
1302         // Check that InVal is defined in the loop.
1303         Instruction *Inst = cast<Instruction>(InVal);
1304         if (!L->contains(Inst))
1305           continue;
1306 
1307         // Okay, this instruction has a user outside of the current loop
1308         // and varies predictably *inside* the loop.  Evaluate the value it
1309         // contains when the loop exits, if possible.  We prefer to start with
1310         // expressions which are true for all exits (so as to maximize
1311         // expression reuse by the SCEVExpander), but resort to per-exit
1312         // evaluation if that fails.
1313         const SCEV *ExitValue = SE->getSCEVAtScope(Inst, L->getParentLoop());
1314         if (isa<SCEVCouldNotCompute>(ExitValue) ||
1315             !SE->isLoopInvariant(ExitValue, L) ||
1316             !isSafeToExpand(ExitValue, *SE)) {
1317           // TODO: This should probably be sunk into SCEV in some way; maybe a
1318           // getSCEVForExit(SCEV*, L, ExitingBB)?  It can be generalized for
1319           // most SCEV expressions and other recurrence types (e.g. shift
1320           // recurrences).  Is there existing code we can reuse?
1321           const SCEV *ExitCount = SE->getExitCount(L, PN->getIncomingBlock(i));
1322           if (isa<SCEVCouldNotCompute>(ExitCount))
1323             continue;
1324           if (auto *AddRec = dyn_cast<SCEVAddRecExpr>(SE->getSCEV(Inst)))
1325             if (AddRec->getLoop() == L)
1326               ExitValue = AddRec->evaluateAtIteration(ExitCount, *SE);
1327           if (isa<SCEVCouldNotCompute>(ExitValue) ||
1328               !SE->isLoopInvariant(ExitValue, L) ||
1329               !isSafeToExpand(ExitValue, *SE))
1330             continue;
1331         }
1332 
1333         // Computing the value outside of the loop brings no benefit if it is
1334         // definitely used inside the loop in a way which can not be optimized
1335         // away. Avoid doing so unless we know we have a value which computes
1336         // the ExitValue already. TODO: This should be merged into SCEV
1337         // expander to leverage its knowledge of existing expressions.
1338         if (ReplaceExitValue != AlwaysRepl && !isa<SCEVConstant>(ExitValue) &&
1339             !isa<SCEVUnknown>(ExitValue) && hasHardUserWithinLoop(L, Inst))
1340           continue;
1341 
1342         // Check if expansions of this SCEV would count as being high cost.
1343         bool HighCost = Rewriter.isHighCostExpansion(
1344             ExitValue, L, SCEVCheapExpansionBudget, TTI, Inst);
1345 
1346         // Note that we must not perform expansions until after
1347         // we query *all* the costs, because if we perform temporary expansion
1348         // inbetween, one that we might not intend to keep, said expansion
1349         // *may* affect cost calculation of the the next SCEV's we'll query,
1350         // and next SCEV may errneously get smaller cost.
1351 
1352         // Collect all the candidate PHINodes to be rewritten.
1353         RewritePhiSet.emplace_back(PN, i, ExitValue, Inst, HighCost);
1354       }
1355     }
1356   }
1357 
1358   // TODO: evaluate whether it is beneficial to change how we calculate
1359   // high-cost: if we have SCEV 'A' which we know we will expand, should we
1360   // calculate the cost of other SCEV's after expanding SCEV 'A', thus
1361   // potentially giving cost bonus to those other SCEV's?
1362 
1363   bool LoopCanBeDel = canLoopBeDeleted(L, RewritePhiSet);
1364   int NumReplaced = 0;
1365 
1366   // Transformation.
1367   for (const RewritePhi &Phi : RewritePhiSet) {
1368     PHINode *PN = Phi.PN;
1369 
1370     // Only do the rewrite when the ExitValue can be expanded cheaply.
1371     // If LoopCanBeDel is true, rewrite exit value aggressively.
1372     if (ReplaceExitValue == OnlyCheapRepl && !LoopCanBeDel && Phi.HighCost)
1373       continue;
1374 
1375     Value *ExitVal = Rewriter.expandCodeFor(
1376         Phi.ExpansionSCEV, Phi.PN->getType(), Phi.ExpansionPoint);
1377 
1378     LLVM_DEBUG(dbgs() << "rewriteLoopExitValues: AfterLoopVal = " << *ExitVal
1379                       << '\n'
1380                       << "  LoopVal = " << *(Phi.ExpansionPoint) << "\n");
1381 
1382 #ifndef NDEBUG
1383     // If we reuse an instruction from a loop which is neither L nor one of
1384     // its containing loops, we end up breaking LCSSA form for this loop by
1385     // creating a new use of its instruction.
1386     if (auto *ExitInsn = dyn_cast<Instruction>(ExitVal))
1387       if (auto *EVL = LI->getLoopFor(ExitInsn->getParent()))
1388         if (EVL != L)
1389           assert(EVL->contains(L) && "LCSSA breach detected!");
1390 #endif
1391 
1392     NumReplaced++;
1393     Instruction *Inst = cast<Instruction>(PN->getIncomingValue(Phi.Ith));
1394     PN->setIncomingValue(Phi.Ith, ExitVal);
1395     // It's necessary to tell ScalarEvolution about this explicitly so that
1396     // it can walk the def-use list and forget all SCEVs, as it may not be
1397     // watching the PHI itself. Once the new exit value is in place, there
1398     // may not be a def-use connection between the loop and every instruction
1399     // which got a SCEVAddRecExpr for that loop.
1400     SE->forgetValue(PN);
1401 
1402     // If this instruction is dead now, delete it. Don't do it now to avoid
1403     // invalidating iterators.
1404     if (isInstructionTriviallyDead(Inst, TLI))
1405       DeadInsts.push_back(Inst);
1406 
1407     // Replace PN with ExitVal if that is legal and does not break LCSSA.
1408     if (PN->getNumIncomingValues() == 1 &&
1409         LI->replacementPreservesLCSSAForm(PN, ExitVal)) {
1410       PN->replaceAllUsesWith(ExitVal);
1411       PN->eraseFromParent();
1412     }
1413   }
1414 
1415   // The insertion point instruction may have been deleted; clear it out
1416   // so that the rewriter doesn't trip over it later.
1417   Rewriter.clearInsertPoint();
1418   return NumReplaced;
1419 }
1420 
1421 /// Set weights for \p UnrolledLoop and \p RemainderLoop based on weights for
1422 /// \p OrigLoop.
1423 void llvm::setProfileInfoAfterUnrolling(Loop *OrigLoop, Loop *UnrolledLoop,
1424                                         Loop *RemainderLoop, uint64_t UF) {
1425   assert(UF > 0 && "Zero unrolled factor is not supported");
1426   assert(UnrolledLoop != RemainderLoop &&
1427          "Unrolled and Remainder loops are expected to distinct");
1428 
1429   // Get number of iterations in the original scalar loop.
1430   unsigned OrigLoopInvocationWeight = 0;
1431   Optional<unsigned> OrigAverageTripCount =
1432       getLoopEstimatedTripCount(OrigLoop, &OrigLoopInvocationWeight);
1433   if (!OrigAverageTripCount)
1434     return;
1435 
1436   // Calculate number of iterations in unrolled loop.
1437   unsigned UnrolledAverageTripCount = *OrigAverageTripCount / UF;
1438   // Calculate number of iterations for remainder loop.
1439   unsigned RemainderAverageTripCount = *OrigAverageTripCount % UF;
1440 
1441   setLoopEstimatedTripCount(UnrolledLoop, UnrolledAverageTripCount,
1442                             OrigLoopInvocationWeight);
1443   setLoopEstimatedTripCount(RemainderLoop, RemainderAverageTripCount,
1444                             OrigLoopInvocationWeight);
1445 }
1446 
1447 /// Utility that implements appending of loops onto a worklist.
1448 /// Loops are added in preorder (analogous for reverse postorder for trees),
1449 /// and the worklist is processed LIFO.
1450 template <typename RangeT>
1451 void llvm::appendReversedLoopsToWorklist(
1452     RangeT &&Loops, SmallPriorityWorklist<Loop *, 4> &Worklist) {
1453   // We use an internal worklist to build up the preorder traversal without
1454   // recursion.
1455   SmallVector<Loop *, 4> PreOrderLoops, PreOrderWorklist;
1456 
1457   // We walk the initial sequence of loops in reverse because we generally want
1458   // to visit defs before uses and the worklist is LIFO.
1459   for (Loop *RootL : Loops) {
1460     assert(PreOrderLoops.empty() && "Must start with an empty preorder walk.");
1461     assert(PreOrderWorklist.empty() &&
1462            "Must start with an empty preorder walk worklist.");
1463     PreOrderWorklist.push_back(RootL);
1464     do {
1465       Loop *L = PreOrderWorklist.pop_back_val();
1466       PreOrderWorklist.append(L->begin(), L->end());
1467       PreOrderLoops.push_back(L);
1468     } while (!PreOrderWorklist.empty());
1469 
1470     Worklist.insert(std::move(PreOrderLoops));
1471     PreOrderLoops.clear();
1472   }
1473 }
1474 
1475 template <typename RangeT>
1476 void llvm::appendLoopsToWorklist(RangeT &&Loops,
1477                                  SmallPriorityWorklist<Loop *, 4> &Worklist) {
1478   appendReversedLoopsToWorklist(reverse(Loops), Worklist);
1479 }
1480 
1481 template void llvm::appendLoopsToWorklist<ArrayRef<Loop *> &>(
1482     ArrayRef<Loop *> &Loops, SmallPriorityWorklist<Loop *, 4> &Worklist);
1483 
1484 template void
1485 llvm::appendLoopsToWorklist<Loop &>(Loop &L,
1486                                     SmallPriorityWorklist<Loop *, 4> &Worklist);
1487 
1488 void llvm::appendLoopsToWorklist(LoopInfo &LI,
1489                                  SmallPriorityWorklist<Loop *, 4> &Worklist) {
1490   appendReversedLoopsToWorklist(LI, Worklist);
1491 }
1492 
1493 Loop *llvm::cloneLoop(Loop *L, Loop *PL, ValueToValueMapTy &VM,
1494                       LoopInfo *LI, LPPassManager *LPM) {
1495   Loop &New = *LI->AllocateLoop();
1496   if (PL)
1497     PL->addChildLoop(&New);
1498   else
1499     LI->addTopLevelLoop(&New);
1500 
1501   if (LPM)
1502     LPM->addLoop(New);
1503 
1504   // Add all of the blocks in L to the new loop.
1505   for (BasicBlock *BB : L->blocks())
1506     if (LI->getLoopFor(BB) == L)
1507       New.addBasicBlockToLoop(cast<BasicBlock>(VM[BB]), *LI);
1508 
1509   // Add all of the subloops to the new loop.
1510   for (Loop *I : *L)
1511     cloneLoop(I, &New, VM, LI, LPM);
1512 
1513   return &New;
1514 }
1515 
1516 /// IR Values for the lower and upper bounds of a pointer evolution.  We
1517 /// need to use value-handles because SCEV expansion can invalidate previously
1518 /// expanded values.  Thus expansion of a pointer can invalidate the bounds for
1519 /// a previous one.
1520 struct PointerBounds {
1521   TrackingVH<Value> Start;
1522   TrackingVH<Value> End;
1523 };
1524 
1525 /// Expand code for the lower and upper bound of the pointer group \p CG
1526 /// in \p TheLoop.  \return the values for the bounds.
1527 static PointerBounds expandBounds(const RuntimeCheckingPtrGroup *CG,
1528                                   Loop *TheLoop, Instruction *Loc,
1529                                   SCEVExpander &Exp) {
1530   LLVMContext &Ctx = Loc->getContext();
1531   Type *PtrArithTy = Type::getInt8PtrTy(Ctx, CG->AddressSpace);
1532 
1533   Value *Start = nullptr, *End = nullptr;
1534   LLVM_DEBUG(dbgs() << "LAA: Adding RT check for range:\n");
1535   Start = Exp.expandCodeFor(CG->Low, PtrArithTy, Loc);
1536   End = Exp.expandCodeFor(CG->High, PtrArithTy, Loc);
1537   LLVM_DEBUG(dbgs() << "Start: " << *CG->Low << " End: " << *CG->High << "\n");
1538   return {Start, End};
1539 }
1540 
1541 /// Turns a collection of checks into a collection of expanded upper and
1542 /// lower bounds for both pointers in the check.
1543 static SmallVector<std::pair<PointerBounds, PointerBounds>, 4>
1544 expandBounds(const SmallVectorImpl<RuntimePointerCheck> &PointerChecks, Loop *L,
1545              Instruction *Loc, SCEVExpander &Exp) {
1546   SmallVector<std::pair<PointerBounds, PointerBounds>, 4> ChecksWithBounds;
1547 
1548   // Here we're relying on the SCEV Expander's cache to only emit code for the
1549   // same bounds once.
1550   transform(PointerChecks, std::back_inserter(ChecksWithBounds),
1551             [&](const RuntimePointerCheck &Check) {
1552               PointerBounds First = expandBounds(Check.first, L, Loc, Exp),
1553                             Second = expandBounds(Check.second, L, Loc, Exp);
1554               return std::make_pair(First, Second);
1555             });
1556 
1557   return ChecksWithBounds;
1558 }
1559 
1560 Value *llvm::addRuntimeChecks(
1561     Instruction *Loc, Loop *TheLoop,
1562     const SmallVectorImpl<RuntimePointerCheck> &PointerChecks,
1563     SCEVExpander &Exp) {
1564   // TODO: Move noalias annotation code from LoopVersioning here and share with LV if possible.
1565   // TODO: Pass  RtPtrChecking instead of PointerChecks and SE separately, if possible
1566   auto ExpandedChecks = expandBounds(PointerChecks, TheLoop, Loc, Exp);
1567 
1568   LLVMContext &Ctx = Loc->getContext();
1569   IRBuilder<> ChkBuilder(Loc);
1570   // Our instructions might fold to a constant.
1571   Value *MemoryRuntimeCheck = nullptr;
1572 
1573   for (const auto &Check : ExpandedChecks) {
1574     const PointerBounds &A = Check.first, &B = Check.second;
1575     // Check if two pointers (A and B) conflict where conflict is computed as:
1576     // start(A) <= end(B) && start(B) <= end(A)
1577     unsigned AS0 = A.Start->getType()->getPointerAddressSpace();
1578     unsigned AS1 = B.Start->getType()->getPointerAddressSpace();
1579 
1580     assert((AS0 == B.End->getType()->getPointerAddressSpace()) &&
1581            (AS1 == A.End->getType()->getPointerAddressSpace()) &&
1582            "Trying to bounds check pointers with different address spaces");
1583 
1584     Type *PtrArithTy0 = Type::getInt8PtrTy(Ctx, AS0);
1585     Type *PtrArithTy1 = Type::getInt8PtrTy(Ctx, AS1);
1586 
1587     Value *Start0 = ChkBuilder.CreateBitCast(A.Start, PtrArithTy0, "bc");
1588     Value *Start1 = ChkBuilder.CreateBitCast(B.Start, PtrArithTy1, "bc");
1589     Value *End0 = ChkBuilder.CreateBitCast(A.End, PtrArithTy1, "bc");
1590     Value *End1 = ChkBuilder.CreateBitCast(B.End, PtrArithTy0, "bc");
1591 
1592     // [A|B].Start points to the first accessed byte under base [A|B].
1593     // [A|B].End points to the last accessed byte, plus one.
1594     // There is no conflict when the intervals are disjoint:
1595     // NoConflict = (B.Start >= A.End) || (A.Start >= B.End)
1596     //
1597     // bound0 = (B.Start < A.End)
1598     // bound1 = (A.Start < B.End)
1599     //  IsConflict = bound0 & bound1
1600     Value *Cmp0 = ChkBuilder.CreateICmpULT(Start0, End1, "bound0");
1601     Value *Cmp1 = ChkBuilder.CreateICmpULT(Start1, End0, "bound1");
1602     Value *IsConflict = ChkBuilder.CreateAnd(Cmp0, Cmp1, "found.conflict");
1603     if (MemoryRuntimeCheck) {
1604       IsConflict =
1605           ChkBuilder.CreateOr(MemoryRuntimeCheck, IsConflict, "conflict.rdx");
1606     }
1607     MemoryRuntimeCheck = IsConflict;
1608   }
1609 
1610   return MemoryRuntimeCheck;
1611 }
1612 
1613 Optional<IVConditionInfo> llvm::hasPartialIVCondition(Loop &L,
1614                                                       unsigned MSSAThreshold,
1615                                                       MemorySSA &MSSA,
1616                                                       AAResults &AA) {
1617   auto *TI = dyn_cast<BranchInst>(L.getHeader()->getTerminator());
1618   if (!TI || !TI->isConditional())
1619     return {};
1620 
1621   auto *CondI = dyn_cast<CmpInst>(TI->getCondition());
1622   // The case with the condition outside the loop should already be handled
1623   // earlier.
1624   if (!CondI || !L.contains(CondI))
1625     return {};
1626 
1627   SmallVector<Instruction *> InstToDuplicate;
1628   InstToDuplicate.push_back(CondI);
1629 
1630   SmallVector<Value *, 4> WorkList;
1631   WorkList.append(CondI->op_begin(), CondI->op_end());
1632 
1633   SmallVector<MemoryAccess *, 4> AccessesToCheck;
1634   SmallVector<MemoryLocation, 4> AccessedLocs;
1635   while (!WorkList.empty()) {
1636     Instruction *I = dyn_cast<Instruction>(WorkList.pop_back_val());
1637     if (!I || !L.contains(I))
1638       continue;
1639 
1640     // TODO: support additional instructions.
1641     if (!isa<LoadInst>(I) && !isa<GetElementPtrInst>(I))
1642       return {};
1643 
1644     // Do not duplicate volatile and atomic loads.
1645     if (auto *LI = dyn_cast<LoadInst>(I))
1646       if (LI->isVolatile() || LI->isAtomic())
1647         return {};
1648 
1649     InstToDuplicate.push_back(I);
1650     if (MemoryAccess *MA = MSSA.getMemoryAccess(I)) {
1651       if (auto *MemUse = dyn_cast_or_null<MemoryUse>(MA)) {
1652         // Queue the defining access to check for alias checks.
1653         AccessesToCheck.push_back(MemUse->getDefiningAccess());
1654         AccessedLocs.push_back(MemoryLocation::get(I));
1655       } else {
1656         // MemoryDefs may clobber the location or may be atomic memory
1657         // operations. Bail out.
1658         return {};
1659       }
1660     }
1661     WorkList.append(I->op_begin(), I->op_end());
1662   }
1663 
1664   if (InstToDuplicate.empty())
1665     return {};
1666 
1667   SmallVector<BasicBlock *, 4> ExitingBlocks;
1668   L.getExitingBlocks(ExitingBlocks);
1669   auto HasNoClobbersOnPath =
1670       [&L, &AA, &AccessedLocs, &ExitingBlocks, &InstToDuplicate,
1671        MSSAThreshold](BasicBlock *Succ, BasicBlock *Header,
1672                       SmallVector<MemoryAccess *, 4> AccessesToCheck)
1673       -> Optional<IVConditionInfo> {
1674     IVConditionInfo Info;
1675     // First, collect all blocks in the loop that are on a patch from Succ
1676     // to the header.
1677     SmallVector<BasicBlock *, 4> WorkList;
1678     WorkList.push_back(Succ);
1679     WorkList.push_back(Header);
1680     SmallPtrSet<BasicBlock *, 4> Seen;
1681     Seen.insert(Header);
1682     Info.PathIsNoop &=
1683         all_of(*Header, [](Instruction &I) { return !I.mayHaveSideEffects(); });
1684 
1685     while (!WorkList.empty()) {
1686       BasicBlock *Current = WorkList.pop_back_val();
1687       if (!L.contains(Current))
1688         continue;
1689       const auto &SeenIns = Seen.insert(Current);
1690       if (!SeenIns.second)
1691         continue;
1692 
1693       Info.PathIsNoop &= all_of(
1694           *Current, [](Instruction &I) { return !I.mayHaveSideEffects(); });
1695       WorkList.append(succ_begin(Current), succ_end(Current));
1696     }
1697 
1698     // Require at least 2 blocks on a path through the loop. This skips
1699     // paths that directly exit the loop.
1700     if (Seen.size() < 2)
1701       return {};
1702 
1703     // Next, check if there are any MemoryDefs that are on the path through
1704     // the loop (in the Seen set) and they may-alias any of the locations in
1705     // AccessedLocs. If that is the case, they may modify the condition and
1706     // partial unswitching is not possible.
1707     SmallPtrSet<MemoryAccess *, 4> SeenAccesses;
1708     while (!AccessesToCheck.empty()) {
1709       MemoryAccess *Current = AccessesToCheck.pop_back_val();
1710       auto SeenI = SeenAccesses.insert(Current);
1711       if (!SeenI.second || !Seen.contains(Current->getBlock()))
1712         continue;
1713 
1714       // Bail out if exceeded the threshold.
1715       if (SeenAccesses.size() >= MSSAThreshold)
1716         return {};
1717 
1718       // MemoryUse are read-only accesses.
1719       if (isa<MemoryUse>(Current))
1720         continue;
1721 
1722       // For a MemoryDef, check if is aliases any of the location feeding
1723       // the original condition.
1724       if (auto *CurrentDef = dyn_cast<MemoryDef>(Current)) {
1725         if (any_of(AccessedLocs, [&AA, CurrentDef](MemoryLocation &Loc) {
1726               return isModSet(
1727                   AA.getModRefInfo(CurrentDef->getMemoryInst(), Loc));
1728             }))
1729           return {};
1730       }
1731 
1732       for (Use &U : Current->uses())
1733         AccessesToCheck.push_back(cast<MemoryAccess>(U.getUser()));
1734     }
1735 
1736     // We could also allow loops with known trip counts without mustprogress,
1737     // but ScalarEvolution may not be available.
1738     Info.PathIsNoop &= isMustProgress(&L);
1739 
1740     // If the path is considered a no-op so far, check if it reaches a
1741     // single exit block without any phis. This ensures no values from the
1742     // loop are used outside of the loop.
1743     if (Info.PathIsNoop) {
1744       for (auto *Exiting : ExitingBlocks) {
1745         if (!Seen.contains(Exiting))
1746           continue;
1747         for (auto *Succ : successors(Exiting)) {
1748           if (L.contains(Succ))
1749             continue;
1750 
1751           Info.PathIsNoop &= llvm::empty(Succ->phis()) &&
1752                              (!Info.ExitForPath || Info.ExitForPath == Succ);
1753           if (!Info.PathIsNoop)
1754             break;
1755           assert((!Info.ExitForPath || Info.ExitForPath == Succ) &&
1756                  "cannot have multiple exit blocks");
1757           Info.ExitForPath = Succ;
1758         }
1759       }
1760     }
1761     if (!Info.ExitForPath)
1762       Info.PathIsNoop = false;
1763 
1764     Info.InstToDuplicate = InstToDuplicate;
1765     return Info;
1766   };
1767 
1768   // If we branch to the same successor, partial unswitching will not be
1769   // beneficial.
1770   if (TI->getSuccessor(0) == TI->getSuccessor(1))
1771     return {};
1772 
1773   if (auto Info = HasNoClobbersOnPath(TI->getSuccessor(0), L.getHeader(),
1774                                       AccessesToCheck)) {
1775     Info->KnownValue = ConstantInt::getTrue(TI->getContext());
1776     return Info;
1777   }
1778   if (auto Info = HasNoClobbersOnPath(TI->getSuccessor(1), L.getHeader(),
1779                                       AccessesToCheck)) {
1780     Info->KnownValue = ConstantInt::getFalse(TI->getContext());
1781     return Info;
1782   }
1783 
1784   return {};
1785 }
1786