1 //===--------- LoopSimplifyCFG.cpp - Loop CFG Simplification Pass ---------===//
2 //
3 //                     The LLVM Compiler Infrastructure
4 //
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
7 //
8 //===----------------------------------------------------------------------===//
9 //
10 // This file implements the Loop SimplifyCFG Pass. This pass is responsible for
11 // basic loop CFG cleanup, primarily to assist other loop passes. If you
12 // encounter a noncanonical CFG construct that causes another loop pass to
13 // perform suboptimally, this is the place to fix it up.
14 //
15 //===----------------------------------------------------------------------===//
16 
17 #include "llvm/Transforms/Scalar/LoopSimplifyCFG.h"
18 #include "llvm/ADT/SmallVector.h"
19 #include "llvm/ADT/Statistic.h"
20 #include "llvm/Analysis/AliasAnalysis.h"
21 #include "llvm/Analysis/AssumptionCache.h"
22 #include "llvm/Analysis/BasicAliasAnalysis.h"
23 #include "llvm/Analysis/DependenceAnalysis.h"
24 #include "llvm/Analysis/GlobalsModRef.h"
25 #include "llvm/Analysis/LoopInfo.h"
26 #include "llvm/Analysis/LoopPass.h"
27 #include "llvm/Analysis/MemorySSA.h"
28 #include "llvm/Analysis/MemorySSAUpdater.h"
29 #include "llvm/Analysis/ScalarEvolution.h"
30 #include "llvm/Analysis/ScalarEvolutionAliasAnalysis.h"
31 #include "llvm/Analysis/TargetTransformInfo.h"
32 #include "llvm/IR/DomTreeUpdater.h"
33 #include "llvm/IR/Dominators.h"
34 #include "llvm/Transforms/Scalar.h"
35 #include "llvm/Transforms/Scalar/LoopPassManager.h"
36 #include "llvm/Transforms/Utils.h"
37 #include "llvm/Transforms/Utils/BasicBlockUtils.h"
38 #include "llvm/Transforms/Utils/Local.h"
39 #include "llvm/Transforms/Utils/LoopUtils.h"
40 using namespace llvm;
41 
42 #define DEBUG_TYPE "loop-simplifycfg"
43 
44 static bool simplifyLoopCFG(Loop &L, DominatorTree &DT, LoopInfo &LI,
45                             ScalarEvolution &SE, MemorySSAUpdater *MSSAU) {
46   bool Changed = false;
47   DomTreeUpdater DTU(DT, DomTreeUpdater::UpdateStrategy::Eager);
48   // Copy blocks into a temporary array to avoid iterator invalidation issues
49   // as we remove them.
50   SmallVector<WeakTrackingVH, 16> Blocks(L.blocks());
51 
52   for (auto &Block : Blocks) {
53     // Attempt to merge blocks in the trivial case. Don't modify blocks which
54     // belong to other loops.
55     BasicBlock *Succ = cast_or_null<BasicBlock>(Block);
56     if (!Succ)
57       continue;
58 
59     BasicBlock *Pred = Succ->getSinglePredecessor();
60     if (!Pred || !Pred->getSingleSuccessor() || LI.getLoopFor(Pred) != &L)
61       continue;
62 
63     // Merge Succ into Pred and delete it.
64     MergeBlockIntoPredecessor(Succ, &DTU, &LI, MSSAU);
65 
66     SE.forgetTopmostLoop(&L);
67 
68     Changed = true;
69   }
70 
71   return Changed;
72 }
73 
74 PreservedAnalyses LoopSimplifyCFGPass::run(Loop &L, LoopAnalysisManager &AM,
75                                            LoopStandardAnalysisResults &AR,
76                                            LPMUpdater &) {
77   Optional<MemorySSAUpdater> MSSAU;
78   if (EnableMSSALoopDependency && AR.MSSA)
79     MSSAU = MemorySSAUpdater(AR.MSSA);
80   if (!simplifyLoopCFG(L, AR.DT, AR.LI, AR.SE,
81                        MSSAU.hasValue() ? MSSAU.getPointer() : nullptr))
82     return PreservedAnalyses::all();
83 
84   return getLoopPassPreservedAnalyses();
85 }
86 
87 namespace {
88 class LoopSimplifyCFGLegacyPass : public LoopPass {
89 public:
90   static char ID; // Pass ID, replacement for typeid
91   LoopSimplifyCFGLegacyPass() : LoopPass(ID) {
92     initializeLoopSimplifyCFGLegacyPassPass(*PassRegistry::getPassRegistry());
93   }
94 
95   bool runOnLoop(Loop *L, LPPassManager &) override {
96     if (skipLoop(L))
97       return false;
98 
99     DominatorTree &DT = getAnalysis<DominatorTreeWrapperPass>().getDomTree();
100     LoopInfo &LI = getAnalysis<LoopInfoWrapperPass>().getLoopInfo();
101     ScalarEvolution &SE = getAnalysis<ScalarEvolutionWrapperPass>().getSE();
102     Optional<MemorySSAUpdater> MSSAU;
103     if (EnableMSSALoopDependency) {
104       MemorySSA *MSSA = &getAnalysis<MemorySSAWrapperPass>().getMSSA();
105       MSSAU = MemorySSAUpdater(MSSA);
106       if (VerifyMemorySSA)
107         MSSA->verifyMemorySSA();
108     }
109     return simplifyLoopCFG(*L, DT, LI, SE,
110                            MSSAU.hasValue() ? MSSAU.getPointer() : nullptr);
111   }
112 
113   void getAnalysisUsage(AnalysisUsage &AU) const override {
114     if (EnableMSSALoopDependency) {
115       AU.addRequired<MemorySSAWrapperPass>();
116       AU.addPreserved<MemorySSAWrapperPass>();
117     }
118     AU.addPreserved<DependenceAnalysisWrapperPass>();
119     getLoopAnalysisUsage(AU);
120   }
121 };
122 }
123 
124 char LoopSimplifyCFGLegacyPass::ID = 0;
125 INITIALIZE_PASS_BEGIN(LoopSimplifyCFGLegacyPass, "loop-simplifycfg",
126                       "Simplify loop CFG", false, false)
127 INITIALIZE_PASS_DEPENDENCY(LoopPass)
128 INITIALIZE_PASS_DEPENDENCY(MemorySSAWrapperPass)
129 INITIALIZE_PASS_END(LoopSimplifyCFGLegacyPass, "loop-simplifycfg",
130                     "Simplify loop CFG", false, false)
131 
132 Pass *llvm::createLoopSimplifyCFGPass() {
133   return new LoopSimplifyCFGLegacyPass();
134 }
135