blob: 55cf20a2936c041b3a2db466437d5c0134b34bcf [file] [log] [blame]
Fiona Glaserb417d462016-01-29 22:35:36 +00001//===--------- LoopSimplifyCFG.cpp - Loop CFG Simplification Pass ---------===//
2//
Chandler Carruth2946cd72019-01-19 08:50:56 +00003// 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
Fiona Glaserb417d462016-01-29 22:35:36 +00006//
7//===----------------------------------------------------------------------===//
8//
9// This file implements the Loop SimplifyCFG Pass. This pass is responsible for
10// basic loop CFG cleanup, primarily to assist other loop passes. If you
11// encounter a noncanonical CFG construct that causes another loop pass to
12// perform suboptimally, this is the place to fix it up.
13//
14//===----------------------------------------------------------------------===//
15
Justin Bognerab6a5132016-05-03 21:47:32 +000016#include "llvm/Transforms/Scalar/LoopSimplifyCFG.h"
Fiona Glaserb417d462016-01-29 22:35:36 +000017#include "llvm/ADT/SmallVector.h"
18#include "llvm/ADT/Statistic.h"
19#include "llvm/Analysis/AliasAnalysis.h"
Daniel Jasperaec2fa32016-12-19 08:22:17 +000020#include "llvm/Analysis/AssumptionCache.h"
Chandler Carruth3bab7e12017-01-11 09:43:56 +000021#include "llvm/Analysis/BasicAliasAnalysis.h"
Fiona Glaserb417d462016-01-29 22:35:36 +000022#include "llvm/Analysis/DependenceAnalysis.h"
Richard Trieu5f436fc2019-02-06 02:52:52 +000023#include "llvm/Analysis/DomTreeUpdater.h"
Fiona Glaserb417d462016-01-29 22:35:36 +000024#include "llvm/Analysis/GlobalsModRef.h"
25#include "llvm/Analysis/LoopInfo.h"
26#include "llvm/Analysis/LoopPass.h"
Alina Sbirlea8b83d682018-08-22 20:10:21 +000027#include "llvm/Analysis/MemorySSA.h"
28#include "llvm/Analysis/MemorySSAUpdater.h"
Fiona Glaserb417d462016-01-29 22:35:36 +000029#include "llvm/Analysis/ScalarEvolution.h"
30#include "llvm/Analysis/ScalarEvolutionAliasAnalysis.h"
31#include "llvm/Analysis/TargetTransformInfo.h"
32#include "llvm/IR/Dominators.h"
Justin Bognerab6a5132016-05-03 21:47:32 +000033#include "llvm/Transforms/Scalar.h"
Chandler Carruth3bab7e12017-01-11 09:43:56 +000034#include "llvm/Transforms/Scalar/LoopPassManager.h"
David Blaikiea373d182018-03-28 17:44:36 +000035#include "llvm/Transforms/Utils.h"
Alina Sbirleadfd14ad2018-06-20 22:01:04 +000036#include "llvm/Transforms/Utils/BasicBlockUtils.h"
37#include "llvm/Transforms/Utils/Local.h"
Chandler Carruth31088a92016-02-19 10:45:18 +000038#include "llvm/Transforms/Utils/LoopUtils.h"
Fiona Glaserb417d462016-01-29 22:35:36 +000039using namespace llvm;
40
41#define DEBUG_TYPE "loop-simplifycfg"
42
Max Kazantseve1c2dc22018-11-23 09:14:53 +000043static cl::opt<bool> EnableTermFolding("enable-loop-simplifycfg-term-folding",
Max Kazantsev5cf777e2019-02-13 06:12:48 +000044 cl::init(true));
Max Kazantseve1c2dc22018-11-23 09:14:53 +000045
Max Kazantsevc04b5302018-11-20 05:43:32 +000046STATISTIC(NumTerminatorsFolded,
47 "Number of terminators folded to unconditional branches");
Max Kazantsev347c5832018-12-24 06:06:17 +000048STATISTIC(NumLoopBlocksDeleted,
49 "Number of loop blocks deleted");
Max Kazantsevedabb9a2018-12-24 07:41:33 +000050STATISTIC(NumLoopExitsDeleted,
51 "Number of loop exiting edges deleted");
Max Kazantsevc04b5302018-11-20 05:43:32 +000052
53/// If \p BB is a switch or a conditional branch, but only one of its successors
54/// can be reached from this block in runtime, return this successor. Otherwise,
55/// return nullptr.
56static BasicBlock *getOnlyLiveSuccessor(BasicBlock *BB) {
57 Instruction *TI = BB->getTerminator();
58 if (BranchInst *BI = dyn_cast<BranchInst>(TI)) {
59 if (BI->isUnconditional())
60 return nullptr;
61 if (BI->getSuccessor(0) == BI->getSuccessor(1))
62 return BI->getSuccessor(0);
63 ConstantInt *Cond = dyn_cast<ConstantInt>(BI->getCondition());
64 if (!Cond)
65 return nullptr;
66 return Cond->isZero() ? BI->getSuccessor(1) : BI->getSuccessor(0);
67 }
68
69 if (SwitchInst *SI = dyn_cast<SwitchInst>(TI)) {
70 auto *CI = dyn_cast<ConstantInt>(SI->getCondition());
71 if (!CI)
72 return nullptr;
73 for (auto Case : SI->cases())
74 if (Case.getCaseValue() == CI)
75 return Case.getCaseSuccessor();
76 return SI->getDefaultDest();
77 }
78
79 return nullptr;
80}
81
Max Kazantsevc065b022019-02-15 12:18:10 +000082/// Removes \p BB from all loops from [FirstLoop, LastLoop) in parent chain.
83static void removeBlockFromLoops(BasicBlock *BB, Loop *FirstLoop,
84 Loop *LastLoop = nullptr) {
85 assert((!LastLoop || LastLoop->contains(FirstLoop->getHeader())) &&
86 "First loop is supposed to be inside of last loop!");
87 assert(FirstLoop->contains(BB) && "Must be a loop block!");
88 for (Loop *Current = FirstLoop; Current != LastLoop;
89 Current = Current->getParentLoop())
90 Current->removeBlockFromLoop(BB);
91}
92
Max Kazantsevd72c1a02019-02-17 15:22:48 +000093/// Find innermost loop that contains at least one block from \p BBs and
94/// contains the header of loop \p L.
95static Loop *getInnermostLoopFor(SmallPtrSetImpl<BasicBlock *> &BBs,
96 Loop &L, LoopInfo &LI) {
Max Kazantsev45614752019-02-17 18:21:51 +000097 Loop *Innermost = nullptr;
Max Kazantsev0f943262019-02-17 15:04:09 +000098 for (BasicBlock *BB : BBs) {
99 Loop *BBL = LI.getLoopFor(BB);
Max Kazantsev45614752019-02-17 18:21:51 +0000100 while (BBL && !BBL->contains(L.getHeader()))
101 BBL = BBL->getParentLoop();
102 if (BBL == &L)
103 BBL = BBL->getParentLoop();
104 if (!BBL)
105 continue;
106 if (!Innermost || BBL->getLoopDepth() > Innermost->getLoopDepth())
107 Innermost = BBL;
Max Kazantsev0f943262019-02-17 15:04:09 +0000108 }
Max Kazantsev45614752019-02-17 18:21:51 +0000109 return Innermost;
Max Kazantsev0f943262019-02-17 15:04:09 +0000110}
111
Benjamin Kramerb17d2132019-01-12 18:36:22 +0000112namespace {
Max Kazantsevc04b5302018-11-20 05:43:32 +0000113/// Helper class that can turn branches and switches with constant conditions
114/// into unconditional branches.
115class ConstantTerminatorFoldingImpl {
116private:
117 Loop &L;
118 LoopInfo &LI;
119 DominatorTree &DT;
Max Kazantsev201534d2018-12-29 04:26:22 +0000120 ScalarEvolution &SE;
Max Kazantsev9cf417d2018-11-30 10:06:23 +0000121 MemorySSAUpdater *MSSAU;
Max Kazantsev136f09b2019-02-15 11:39:35 +0000122 LoopBlocksDFS DFS;
Simon Pilgrim623c38d2019-02-15 12:13:16 +0000123 DomTreeUpdater DTU;
Max Kazantsev6b63d3a2019-02-08 08:12:41 +0000124 SmallVector<DominatorTree::UpdateType, 16> DTUpdates;
Max Kazantsevc04b5302018-11-20 05:43:32 +0000125
Max Kazantseva523a212018-12-07 05:44:45 +0000126 // Whether or not the current loop has irreducible CFG.
127 bool HasIrreducibleCFG = false;
Max Kazantsevc04b5302018-11-20 05:43:32 +0000128 // Whether or not the current loop will still exist after terminator constant
129 // folding will be done. In theory, there are two ways how it can happen:
130 // 1. Loop's latch(es) become unreachable from loop header;
131 // 2. Loop's header becomes unreachable from method entry.
132 // In practice, the second situation is impossible because we only modify the
133 // current loop and its preheader and do not affect preheader's reachibility
134 // from any other block. So this variable set to true means that loop's latch
135 // has become unreachable from loop header.
136 bool DeleteCurrentLoop = false;
137
138 // The blocks of the original loop that will still be reachable from entry
139 // after the constant folding.
140 SmallPtrSet<BasicBlock *, 8> LiveLoopBlocks;
141 // The blocks of the original loop that will become unreachable from entry
142 // after the constant folding.
Max Kazantsev80e4b402018-12-28 06:08:51 +0000143 SmallVector<BasicBlock *, 8> DeadLoopBlocks;
Max Kazantsevc04b5302018-11-20 05:43:32 +0000144 // The exits of the original loop that will still be reachable from entry
145 // after the constant folding.
146 SmallPtrSet<BasicBlock *, 8> LiveExitBlocks;
147 // The exits of the original loop that will become unreachable from entry
148 // after the constant folding.
Max Kazantsev56a24432018-11-22 12:33:41 +0000149 SmallVector<BasicBlock *, 8> DeadExitBlocks;
Max Kazantsevc04b5302018-11-20 05:43:32 +0000150 // The blocks that will still be a part of the current loop after folding.
151 SmallPtrSet<BasicBlock *, 8> BlocksInLoopAfterFolding;
152 // The blocks that have terminators with constant condition that can be
153 // folded. Note: fold candidates should be in L but not in any of its
154 // subloops to avoid complex LI updates.
155 SmallVector<BasicBlock *, 8> FoldCandidates;
156
157 void dump() const {
158 dbgs() << "Constant terminator folding for loop " << L << "\n";
159 dbgs() << "After terminator constant-folding, the loop will";
160 if (!DeleteCurrentLoop)
161 dbgs() << " not";
162 dbgs() << " be destroyed\n";
Max Kazantsev56a24432018-11-22 12:33:41 +0000163 auto PrintOutVector = [&](const char *Message,
164 const SmallVectorImpl<BasicBlock *> &S) {
165 dbgs() << Message << "\n";
166 for (const BasicBlock *BB : S)
167 dbgs() << "\t" << BB->getName() << "\n";
168 };
Max Kazantsevc04b5302018-11-20 05:43:32 +0000169 auto PrintOutSet = [&](const char *Message,
170 const SmallPtrSetImpl<BasicBlock *> &S) {
171 dbgs() << Message << "\n";
172 for (const BasicBlock *BB : S)
173 dbgs() << "\t" << BB->getName() << "\n";
174 };
Max Kazantsev56a24432018-11-22 12:33:41 +0000175 PrintOutVector("Blocks in which we can constant-fold terminator:",
176 FoldCandidates);
Max Kazantsevc04b5302018-11-20 05:43:32 +0000177 PrintOutSet("Live blocks from the original loop:", LiveLoopBlocks);
Max Kazantsev80e4b402018-12-28 06:08:51 +0000178 PrintOutVector("Dead blocks from the original loop:", DeadLoopBlocks);
Max Kazantsevc04b5302018-11-20 05:43:32 +0000179 PrintOutSet("Live exit blocks:", LiveExitBlocks);
Max Kazantsev56a24432018-11-22 12:33:41 +0000180 PrintOutVector("Dead exit blocks:", DeadExitBlocks);
Max Kazantsevc04b5302018-11-20 05:43:32 +0000181 if (!DeleteCurrentLoop)
182 PrintOutSet("The following blocks will still be part of the loop:",
183 BlocksInLoopAfterFolding);
184 }
185
Max Kazantseva523a212018-12-07 05:44:45 +0000186 /// Whether or not the current loop has irreducible CFG.
187 bool hasIrreducibleCFG(LoopBlocksDFS &DFS) {
188 assert(DFS.isComplete() && "DFS is expected to be finished");
189 // Index of a basic block in RPO traversal.
190 DenseMap<const BasicBlock *, unsigned> RPO;
191 unsigned Current = 0;
192 for (auto I = DFS.beginRPO(), E = DFS.endRPO(); I != E; ++I)
193 RPO[*I] = Current++;
194
195 for (auto I = DFS.beginRPO(), E = DFS.endRPO(); I != E; ++I) {
196 BasicBlock *BB = *I;
197 for (auto *Succ : successors(BB))
198 if (L.contains(Succ) && !LI.isLoopHeader(Succ) && RPO[BB] > RPO[Succ])
199 // If an edge goes from a block with greater order number into a block
200 // with lesses number, and it is not a loop backedge, then it can only
201 // be a part of irreducible non-loop cycle.
202 return true;
203 }
204 return false;
205 }
206
Max Kazantsevc04b5302018-11-20 05:43:32 +0000207 /// Fill all information about status of blocks and exits of the current loop
208 /// if constant folding of all branches will be done.
209 void analyze() {
Max Kazantsevc04b5302018-11-20 05:43:32 +0000210 DFS.perform(&LI);
211 assert(DFS.isComplete() && "DFS is expected to be finished");
212
Max Kazantseva523a212018-12-07 05:44:45 +0000213 // TODO: The algorithm below relies on both RPO and Postorder traversals.
214 // When the loop has only reducible CFG inside, then the invariant "all
215 // predecessors of X are processed before X in RPO" is preserved. However
216 // an irreducible loop can break this invariant (e.g. latch does not have to
217 // be the last block in the traversal in this case, and the algorithm relies
218 // on this). We can later decide to support such cases by altering the
219 // algorithms, but so far we just give up analyzing them.
220 if (hasIrreducibleCFG(DFS)) {
221 HasIrreducibleCFG = true;
222 return;
223 }
224
Max Kazantsevc04b5302018-11-20 05:43:32 +0000225 // Collect live and dead loop blocks and exits.
Max Kazantsevc04b5302018-11-20 05:43:32 +0000226 LiveLoopBlocks.insert(L.getHeader());
227 for (auto I = DFS.beginRPO(), E = DFS.endRPO(); I != E; ++I) {
228 BasicBlock *BB = *I;
229
230 // If a loop block wasn't marked as live so far, then it's dead.
231 if (!LiveLoopBlocks.count(BB)) {
Max Kazantsev80e4b402018-12-28 06:08:51 +0000232 DeadLoopBlocks.push_back(BB);
Max Kazantsevc04b5302018-11-20 05:43:32 +0000233 continue;
234 }
235
236 BasicBlock *TheOnlySucc = getOnlyLiveSuccessor(BB);
237
238 // If a block has only one live successor, it's a candidate on constant
239 // folding. Only handle blocks from current loop: branches in child loops
240 // are skipped because if they can be folded, they should be folded during
241 // the processing of child loops.
Max Kazantsev56515a22019-01-24 05:20:29 +0000242 bool TakeFoldCandidate = TheOnlySucc && LI.getLoopFor(BB) == &L;
243 if (TakeFoldCandidate)
Max Kazantsevc04b5302018-11-20 05:43:32 +0000244 FoldCandidates.push_back(BB);
245
246 // Handle successors.
Max Kazantsevc04b5302018-11-20 05:43:32 +0000247 for (BasicBlock *Succ : successors(BB))
Max Kazantsev56515a22019-01-24 05:20:29 +0000248 if (!TakeFoldCandidate || TheOnlySucc == Succ) {
Max Kazantsevd9f59f82018-11-22 10:48:30 +0000249 if (L.contains(Succ))
250 LiveLoopBlocks.insert(Succ);
251 else
252 LiveExitBlocks.insert(Succ);
253 }
Max Kazantsevc04b5302018-11-20 05:43:32 +0000254 }
255
256 // Sanity check: amount of dead and live loop blocks should match the total
257 // number of blocks in loop.
258 assert(L.getNumBlocks() == LiveLoopBlocks.size() + DeadLoopBlocks.size() &&
259 "Malformed block sets?");
260
261 // Now, all exit blocks that are not marked as live are dead.
Max Kazantsevd9f59f82018-11-22 10:48:30 +0000262 SmallVector<BasicBlock *, 8> ExitBlocks;
263 L.getExitBlocks(ExitBlocks);
Max Kazantseva4ccfc12019-02-06 07:49:17 +0000264 SmallPtrSet<BasicBlock *, 8> UniqueDeadExits;
Max Kazantsevc04b5302018-11-20 05:43:32 +0000265 for (auto *ExitBlock : ExitBlocks)
Max Kazantseva4ccfc12019-02-06 07:49:17 +0000266 if (!LiveExitBlocks.count(ExitBlock) &&
267 UniqueDeadExits.insert(ExitBlock).second)
Max Kazantsev56a24432018-11-22 12:33:41 +0000268 DeadExitBlocks.push_back(ExitBlock);
Max Kazantsevc04b5302018-11-20 05:43:32 +0000269
270 // Whether or not the edge From->To will still be present in graph after the
271 // folding.
272 auto IsEdgeLive = [&](BasicBlock *From, BasicBlock *To) {
273 if (!LiveLoopBlocks.count(From))
274 return false;
275 BasicBlock *TheOnlySucc = getOnlyLiveSuccessor(From);
Max Kazantsev38cd9ac2019-01-25 05:05:02 +0000276 return !TheOnlySucc || TheOnlySucc == To || LI.getLoopFor(From) != &L;
Max Kazantsevc04b5302018-11-20 05:43:32 +0000277 };
278
279 // The loop will not be destroyed if its latch is live.
280 DeleteCurrentLoop = !IsEdgeLive(L.getLoopLatch(), L.getHeader());
281
282 // If we are going to delete the current loop completely, no extra analysis
283 // is needed.
284 if (DeleteCurrentLoop)
285 return;
286
287 // Otherwise, we should check which blocks will still be a part of the
288 // current loop after the transform.
289 BlocksInLoopAfterFolding.insert(L.getLoopLatch());
290 // If the loop is live, then we should compute what blocks are still in
291 // loop after all branch folding has been done. A block is in loop if
292 // it has a live edge to another block that is in the loop; by definition,
293 // latch is in the loop.
294 auto BlockIsInLoop = [&](BasicBlock *BB) {
295 return any_of(successors(BB), [&](BasicBlock *Succ) {
296 return BlocksInLoopAfterFolding.count(Succ) && IsEdgeLive(BB, Succ);
297 });
298 };
299 for (auto I = DFS.beginPostorder(), E = DFS.endPostorder(); I != E; ++I) {
300 BasicBlock *BB = *I;
301 if (BlockIsInLoop(BB))
302 BlocksInLoopAfterFolding.insert(BB);
303 }
304
305 // Sanity check: header must be in loop.
306 assert(BlocksInLoopAfterFolding.count(L.getHeader()) &&
307 "Header not in loop?");
Max Kazantsevb565e602018-11-22 12:43:27 +0000308 assert(BlocksInLoopAfterFolding.size() <= LiveLoopBlocks.size() &&
309 "All blocks that stay in loop should be live!");
Max Kazantsevc04b5302018-11-20 05:43:32 +0000310 }
311
Max Kazantsevedabb9a2018-12-24 07:41:33 +0000312 /// We need to preserve static reachibility of all loop exit blocks (this is)
313 /// required by loop pass manager. In order to do it, we make the following
314 /// trick:
315 ///
316 /// preheader:
317 /// <preheader code>
318 /// br label %loop_header
319 ///
320 /// loop_header:
321 /// ...
322 /// br i1 false, label %dead_exit, label %loop_block
323 /// ...
324 ///
325 /// We cannot simply remove edge from the loop to dead exit because in this
326 /// case dead_exit (and its successors) may become unreachable. To avoid that,
327 /// we insert the following fictive preheader:
328 ///
329 /// preheader:
330 /// <preheader code>
331 /// switch i32 0, label %preheader-split,
332 /// [i32 1, label %dead_exit_1],
333 /// [i32 2, label %dead_exit_2],
334 /// ...
335 /// [i32 N, label %dead_exit_N],
336 ///
337 /// preheader-split:
338 /// br label %loop_header
339 ///
340 /// loop_header:
341 /// ...
342 /// br i1 false, label %dead_exit_N, label %loop_block
343 /// ...
344 ///
345 /// Doing so, we preserve static reachibility of all dead exits and can later
346 /// remove edges from the loop to these blocks.
347 void handleDeadExits() {
348 // If no dead exits, nothing to do.
349 if (DeadExitBlocks.empty())
350 return;
351
352 // Construct split preheader and the dummy switch to thread edges from it to
353 // dead exits.
Max Kazantsevedabb9a2018-12-24 07:41:33 +0000354 BasicBlock *Preheader = L.getLoopPreheader();
355 BasicBlock *NewPreheader = Preheader->splitBasicBlock(
356 Preheader->getTerminator(),
357 Twine(Preheader->getName()).concat("-split"));
Max Kazantsev6b63d3a2019-02-08 08:12:41 +0000358 DTUpdates.push_back({DominatorTree::Delete, Preheader, L.getHeader()});
359 DTUpdates.push_back({DominatorTree::Insert, NewPreheader, L.getHeader()});
360 DTUpdates.push_back({DominatorTree::Insert, Preheader, NewPreheader});
Max Kazantsevedabb9a2018-12-24 07:41:33 +0000361 IRBuilder<> Builder(Preheader->getTerminator());
362 SwitchInst *DummySwitch =
363 Builder.CreateSwitch(Builder.getInt32(0), NewPreheader);
364 Preheader->getTerminator()->eraseFromParent();
365
366 unsigned DummyIdx = 1;
367 for (BasicBlock *BB : DeadExitBlocks) {
368 SmallVector<Instruction *, 4> DeadPhis;
369 for (auto &PN : BB->phis())
370 DeadPhis.push_back(&PN);
371
372 // Eliminate all Phis from dead exits.
373 for (Instruction *PN : DeadPhis) {
374 PN->replaceAllUsesWith(UndefValue::get(PN->getType()));
375 PN->eraseFromParent();
376 }
377 assert(DummyIdx != 0 && "Too many dead exits!");
378 DummySwitch->addCase(Builder.getInt32(DummyIdx++), BB);
Max Kazantsev6b63d3a2019-02-08 08:12:41 +0000379 DTUpdates.push_back({DominatorTree::Insert, Preheader, BB});
Max Kazantsevedabb9a2018-12-24 07:41:33 +0000380 ++NumLoopExitsDeleted;
381 }
382
383 assert(L.getLoopPreheader() == NewPreheader && "Malformed CFG?");
384 if (Loop *OuterLoop = LI.getLoopFor(Preheader)) {
385 OuterLoop->addBasicBlockToLoop(NewPreheader, LI);
386
387 // When we break dead edges, the outer loop may become unreachable from
388 // the current loop. We need to fix loop info accordingly. For this, we
389 // find the most nested loop that still contains L and remove L from all
390 // loops that are inside of it.
Max Kazantsevd72c1a02019-02-17 15:22:48 +0000391 Loop *StillReachable = getInnermostLoopFor(LiveExitBlocks, L, LI);
Max Kazantsevedabb9a2018-12-24 07:41:33 +0000392
393 // Okay, our loop is no longer in the outer loop (and maybe not in some of
394 // its parents as well). Make the fixup.
395 if (StillReachable != OuterLoop) {
396 LI.changeLoopFor(NewPreheader, StillReachable);
Max Kazantsevc065b022019-02-15 12:18:10 +0000397 removeBlockFromLoops(NewPreheader, OuterLoop, StillReachable);
398 for (auto *BB : L.blocks())
399 removeBlockFromLoops(BB, OuterLoop, StillReachable);
Max Kazantsevedabb9a2018-12-24 07:41:33 +0000400 OuterLoop->removeChildLoop(&L);
401 if (StillReachable)
402 StillReachable->addChildLoop(&L);
403 else
404 LI.addTopLevelLoop(&L);
Max Kazantsev61a8d3f2019-01-17 12:51:10 +0000405
406 // Some values from loops in [OuterLoop, StillReachable) could be used
407 // in the current loop. Now it is not their child anymore, so such uses
408 // require LCSSA Phis.
409 Loop *FixLCSSALoop = OuterLoop;
410 while (FixLCSSALoop->getParentLoop() != StillReachable)
411 FixLCSSALoop = FixLCSSALoop->getParentLoop();
412 assert(FixLCSSALoop && "Should be a loop!");
Max Kazantsev6b63d3a2019-02-08 08:12:41 +0000413 // We need all DT updates to be done before forming LCSSA.
414 DTU.applyUpdates(DTUpdates);
415 DTUpdates.clear();
Max Kazantsev61a8d3f2019-01-17 12:51:10 +0000416 formLCSSARecursively(*FixLCSSALoop, DT, &LI, &SE);
Max Kazantsevedabb9a2018-12-24 07:41:33 +0000417 }
418 }
419 }
420
Max Kazantsev347c5832018-12-24 06:06:17 +0000421 /// Delete loop blocks that have become unreachable after folding. Make all
422 /// relevant updates to DT and LI.
423 void deleteDeadLoopBlocks() {
Max Kazantsev80e4b402018-12-28 06:08:51 +0000424 if (MSSAU) {
425 SmallPtrSet<BasicBlock *, 8> DeadLoopBlocksSet(DeadLoopBlocks.begin(),
426 DeadLoopBlocks.end());
427 MSSAU->removeBlocks(DeadLoopBlocksSet);
428 }
Max Kazantsevbf6af8f2019-02-12 09:37:00 +0000429
430 // The function LI.erase has some invariants that need to be preserved when
431 // it tries to remove a loop which is not the top-level loop. In particular,
432 // it requires loop's preheader to be strictly in loop's parent. We cannot
433 // just remove blocks one by one, because after removal of preheader we may
434 // break this invariant for the dead loop. So we detatch and erase all dead
435 // loops beforehand.
436 for (auto *BB : DeadLoopBlocks)
437 if (LI.isLoopHeader(BB)) {
438 assert(LI.getLoopFor(BB) != &L && "Attempt to remove current loop!");
439 Loop *DL = LI.getLoopFor(BB);
440 if (DL->getParentLoop()) {
441 for (auto *PL = DL->getParentLoop(); PL; PL = PL->getParentLoop())
442 for (auto *BB : DL->getBlocks())
443 PL->removeBlockFromLoop(BB);
444 DL->getParentLoop()->removeChildLoop(DL);
445 LI.addTopLevelLoop(DL);
446 }
447 LI.erase(DL);
448 }
449
Max Kazantsev347c5832018-12-24 06:06:17 +0000450 for (auto *BB : DeadLoopBlocks) {
451 assert(BB != L.getHeader() &&
452 "Header of the current loop cannot be dead!");
453 LLVM_DEBUG(dbgs() << "Deleting dead loop block " << BB->getName()
454 << "\n");
Max Kazantsev347c5832018-12-24 06:06:17 +0000455 LI.removeBlock(BB);
Max Kazantsev347c5832018-12-24 06:06:17 +0000456 }
Max Kazantsev8b134162019-01-17 12:25:40 +0000457
Max Kazantsev6bf86152019-02-12 07:48:07 +0000458 DetatchDeadBlocks(DeadLoopBlocks, &DTUpdates, /*KeepOneInputPHIs*/true);
Max Kazantsev6b63d3a2019-02-08 08:12:41 +0000459 DTU.applyUpdates(DTUpdates);
460 DTUpdates.clear();
461 for (auto *BB : DeadLoopBlocks)
Max Kazantsev9aae9da2019-02-12 08:10:29 +0000462 DTU.deleteBB(BB);
Max Kazantsev6b63d3a2019-02-08 08:12:41 +0000463
Max Kazantsev8b134162019-01-17 12:25:40 +0000464 NumLoopBlocksDeleted += DeadLoopBlocks.size();
Max Kazantsev347c5832018-12-24 06:06:17 +0000465 }
466
Max Kazantsevc04b5302018-11-20 05:43:32 +0000467 /// Constant-fold terminators of blocks acculumated in FoldCandidates into the
468 /// unconditional branches.
469 void foldTerminators() {
Max Kazantsevc04b5302018-11-20 05:43:32 +0000470 for (BasicBlock *BB : FoldCandidates) {
471 assert(LI.getLoopFor(BB) == &L && "Should be a loop block!");
472 BasicBlock *TheOnlySucc = getOnlyLiveSuccessor(BB);
473 assert(TheOnlySucc && "Should have one live successor!");
474
475 LLVM_DEBUG(dbgs() << "Replacing terminator of " << BB->getName()
476 << " with an unconditional branch to the block "
477 << TheOnlySucc->getName() << "\n");
478
479 SmallPtrSet<BasicBlock *, 2> DeadSuccessors;
480 // Remove all BB's successors except for the live one.
Max Kazantsevc4e4d642018-11-27 06:17:21 +0000481 unsigned TheOnlySuccDuplicates = 0;
Max Kazantsevc04b5302018-11-20 05:43:32 +0000482 for (auto *Succ : successors(BB))
483 if (Succ != TheOnlySucc) {
484 DeadSuccessors.insert(Succ);
Max Kazantsevcb8e2402018-11-23 07:56:47 +0000485 // If our successor lies in a different loop, we don't want to remove
486 // the one-input Phi because it is a LCSSA Phi.
487 bool PreserveLCSSAPhi = !L.contains(Succ);
488 Succ->removePredecessor(BB, PreserveLCSSAPhi);
Max Kazantsev9cf417d2018-11-30 10:06:23 +0000489 if (MSSAU)
490 MSSAU->removeEdge(BB, Succ);
Max Kazantsevc4e4d642018-11-27 06:17:21 +0000491 } else
492 ++TheOnlySuccDuplicates;
493
494 assert(TheOnlySuccDuplicates > 0 && "Should be!");
495 // If TheOnlySucc was BB's successor more than once, after transform it
496 // will be its successor only once. Remove redundant inputs from
497 // TheOnlySucc's Phis.
498 bool PreserveLCSSAPhi = !L.contains(TheOnlySucc);
499 for (unsigned Dup = 1; Dup < TheOnlySuccDuplicates; ++Dup)
500 TheOnlySucc->removePredecessor(BB, PreserveLCSSAPhi);
Max Kazantsev9cf417d2018-11-30 10:06:23 +0000501 if (MSSAU && TheOnlySuccDuplicates > 1)
502 MSSAU->removeDuplicatePhiEdgesBetween(BB, TheOnlySucc);
Max Kazantsevc04b5302018-11-20 05:43:32 +0000503
504 IRBuilder<> Builder(BB->getContext());
505 Instruction *Term = BB->getTerminator();
506 Builder.SetInsertPoint(Term);
507 Builder.CreateBr(TheOnlySucc);
508 Term->eraseFromParent();
509
510 for (auto *DeadSucc : DeadSuccessors)
Max Kazantsev6b63d3a2019-02-08 08:12:41 +0000511 DTUpdates.push_back({DominatorTree::Delete, BB, DeadSucc});
Max Kazantsevc04b5302018-11-20 05:43:32 +0000512
513 ++NumTerminatorsFolded;
514 }
515 }
516
517public:
Max Kazantsev9cf417d2018-11-30 10:06:23 +0000518 ConstantTerminatorFoldingImpl(Loop &L, LoopInfo &LI, DominatorTree &DT,
Max Kazantsev201534d2018-12-29 04:26:22 +0000519 ScalarEvolution &SE,
Max Kazantsev9cf417d2018-11-30 10:06:23 +0000520 MemorySSAUpdater *MSSAU)
Max Kazantsev136f09b2019-02-15 11:39:35 +0000521 : L(L), LI(LI), DT(DT), SE(SE), MSSAU(MSSAU), DFS(&L),
Max Kazantsev6b63d3a2019-02-08 08:12:41 +0000522 DTU(DT, DomTreeUpdater::UpdateStrategy::Eager) {}
Max Kazantsevc04b5302018-11-20 05:43:32 +0000523 bool run() {
524 assert(L.getLoopLatch() && "Should be single latch!");
525
526 // Collect all available information about status of blocks after constant
527 // folding.
528 analyze();
Max Kazantsev30095d92019-02-19 11:13:58 +0000529 BasicBlock *Header = L.getHeader();
530 (void)Header;
Max Kazantsevc04b5302018-11-20 05:43:32 +0000531
Max Kazantsev30095d92019-02-19 11:13:58 +0000532 LLVM_DEBUG(dbgs() << "In function " << Header->getParent()->getName()
Max Kazantsevc04b5302018-11-20 05:43:32 +0000533 << ": ");
534
Max Kazantseva523a212018-12-07 05:44:45 +0000535 if (HasIrreducibleCFG) {
536 LLVM_DEBUG(dbgs() << "Loops with irreducible CFG are not supported!\n");
537 return false;
538 }
539
Max Kazantsevc04b5302018-11-20 05:43:32 +0000540 // Nothing to constant-fold.
541 if (FoldCandidates.empty()) {
542 LLVM_DEBUG(
543 dbgs() << "No constant terminator folding candidates found in loop "
Max Kazantsev30095d92019-02-19 11:13:58 +0000544 << Header->getName() << "\n");
Max Kazantsevc04b5302018-11-20 05:43:32 +0000545 return false;
546 }
547
548 // TODO: Support deletion of the current loop.
549 if (DeleteCurrentLoop) {
550 LLVM_DEBUG(
551 dbgs()
Max Kazantsev30095d92019-02-19 11:13:58 +0000552 << "Give up constant terminator folding in loop " << Header->getName()
Max Kazantsevc04b5302018-11-20 05:43:32 +0000553 << ": we don't currently support deletion of the current loop.\n");
554 return false;
555 }
556
Max Kazantsevc04b5302018-11-20 05:43:32 +0000557 // TODO: Support blocks that are not dead, but also not in loop after the
558 // folding.
Max Kazantsev347c5832018-12-24 06:06:17 +0000559 if (BlocksInLoopAfterFolding.size() + DeadLoopBlocks.size() !=
560 L.getNumBlocks()) {
Max Kazantsevc04b5302018-11-20 05:43:32 +0000561 LLVM_DEBUG(
562 dbgs() << "Give up constant terminator folding in loop "
Max Kazantsev30095d92019-02-19 11:13:58 +0000563 << Header->getName() << ": we don't currently"
Max Kazantsevc04b5302018-11-20 05:43:32 +0000564 " support blocks that are not dead, but will stop "
565 "being a part of the loop after constant-folding.\n");
566 return false;
567 }
568
Max Kazantsev201534d2018-12-29 04:26:22 +0000569 SE.forgetTopmostLoop(&L);
Max Kazantsevc04b5302018-11-20 05:43:32 +0000570 // Dump analysis results.
571 LLVM_DEBUG(dump());
572
573 LLVM_DEBUG(dbgs() << "Constant-folding " << FoldCandidates.size()
Max Kazantsev30095d92019-02-19 11:13:58 +0000574 << " terminators in loop " << Header->getName() << "\n");
Max Kazantsevc04b5302018-11-20 05:43:32 +0000575
576 // Make the actual transforms.
Max Kazantsevedabb9a2018-12-24 07:41:33 +0000577 handleDeadExits();
Max Kazantsevc04b5302018-11-20 05:43:32 +0000578 foldTerminators();
579
Max Kazantsev347c5832018-12-24 06:06:17 +0000580 if (!DeadLoopBlocks.empty()) {
581 LLVM_DEBUG(dbgs() << "Deleting " << DeadLoopBlocks.size()
Max Kazantsev30095d92019-02-19 11:13:58 +0000582 << " dead blocks in loop " << Header->getName() << "\n");
Max Kazantsev347c5832018-12-24 06:06:17 +0000583 deleteDeadLoopBlocks();
Max Kazantsev6b63d3a2019-02-08 08:12:41 +0000584 } else {
585 // If we didn't do updates inside deleteDeadLoopBlocks, do them here.
586 DTU.applyUpdates(DTUpdates);
587 DTUpdates.clear();
Max Kazantsev347c5832018-12-24 06:06:17 +0000588 }
589
Max Kazantsevc04b5302018-11-20 05:43:32 +0000590#ifndef NDEBUG
591 // Make sure that we have preserved all data structures after the transform.
Max Kazantsev365021c2019-01-30 12:32:19 +0000592 assert(DT.verify() && "DT broken after transform!");
Max Kazantsev30095d92019-02-19 11:13:58 +0000593 assert(DT.isReachableFromEntry(Header));
Max Kazantsevc04b5302018-11-20 05:43:32 +0000594 LI.verify(DT);
595#endif
596
597 return true;
598 }
Max Kazantsevebd95ea2019-02-19 11:14:05 +0000599
600 bool foldingBreaksCurrentLoop() const {
601 return DeleteCurrentLoop;
602 }
Max Kazantsevc04b5302018-11-20 05:43:32 +0000603};
Benjamin Kramerb17d2132019-01-12 18:36:22 +0000604} // namespace
Max Kazantsevc04b5302018-11-20 05:43:32 +0000605
606/// Turn branches and switches with known constant conditions into unconditional
607/// branches.
Max Kazantsev9cf417d2018-11-30 10:06:23 +0000608static bool constantFoldTerminators(Loop &L, DominatorTree &DT, LoopInfo &LI,
Max Kazantsev201534d2018-12-29 04:26:22 +0000609 ScalarEvolution &SE,
Max Kazantsevebd95ea2019-02-19 11:14:05 +0000610 MemorySSAUpdater *MSSAU,
611 bool &IsLoopDeleted) {
Max Kazantseve1c2dc22018-11-23 09:14:53 +0000612 if (!EnableTermFolding)
613 return false;
614
Max Kazantsevc04b5302018-11-20 05:43:32 +0000615 // To keep things simple, only process loops with single latch. We
616 // canonicalize most loops to this form. We can support multi-latch if needed.
617 if (!L.getLoopLatch())
618 return false;
619
Max Kazantsev201534d2018-12-29 04:26:22 +0000620 ConstantTerminatorFoldingImpl BranchFolder(L, LI, DT, SE, MSSAU);
Max Kazantsevebd95ea2019-02-19 11:14:05 +0000621 bool Changed = BranchFolder.run();
622 IsLoopDeleted = Changed && BranchFolder.foldingBreaksCurrentLoop();
623 return Changed;
Max Kazantsevc04b5302018-11-20 05:43:32 +0000624}
625
Max Kazantsev46955b52018-11-01 09:42:50 +0000626static bool mergeBlocksIntoPredecessors(Loop &L, DominatorTree &DT,
627 LoopInfo &LI, MemorySSAUpdater *MSSAU) {
Fiona Glaserb417d462016-01-29 22:35:36 +0000628 bool Changed = false;
Chijun Sima21a8b602018-08-03 05:08:17 +0000629 DomTreeUpdater DTU(DT, DomTreeUpdater::UpdateStrategy::Eager);
Fiona Glaserb417d462016-01-29 22:35:36 +0000630 // Copy blocks into a temporary array to avoid iterator invalidation issues
631 // as we remove them.
Sanjoy Dase6bca0e2017-05-01 17:07:49 +0000632 SmallVector<WeakTrackingVH, 16> Blocks(L.blocks());
Fiona Glaserb417d462016-01-29 22:35:36 +0000633
634 for (auto &Block : Blocks) {
635 // Attempt to merge blocks in the trivial case. Don't modify blocks which
636 // belong to other loops.
Fiona Glaser36e82302016-01-29 23:12:52 +0000637 BasicBlock *Succ = cast_or_null<BasicBlock>(Block);
Fiona Glaserb417d462016-01-29 22:35:36 +0000638 if (!Succ)
639 continue;
640
641 BasicBlock *Pred = Succ->getSinglePredecessor();
Justin Bognerab6a5132016-05-03 21:47:32 +0000642 if (!Pred || !Pred->getSingleSuccessor() || LI.getLoopFor(Pred) != &L)
Fiona Glaserb417d462016-01-29 22:35:36 +0000643 continue;
644
Alina Sbirleadfd14ad2018-06-20 22:01:04 +0000645 // Merge Succ into Pred and delete it.
Alina Sbirlea8b83d682018-08-22 20:10:21 +0000646 MergeBlockIntoPredecessor(Succ, &DTU, &LI, MSSAU);
David Greene6a9c242018-06-19 09:43:36 +0000647
Fiona Glaserb417d462016-01-29 22:35:36 +0000648 Changed = true;
649 }
650
651 return Changed;
652}
653
Max Kazantsev46955b52018-11-01 09:42:50 +0000654static bool simplifyLoopCFG(Loop &L, DominatorTree &DT, LoopInfo &LI,
Max Kazantsevebd95ea2019-02-19 11:14:05 +0000655 ScalarEvolution &SE, MemorySSAUpdater *MSSAU,
656 bool &isLoopDeleted) {
Max Kazantsev46955b52018-11-01 09:42:50 +0000657 bool Changed = false;
658
Max Kazantsevc04b5302018-11-20 05:43:32 +0000659 // Constant-fold terminators with known constant conditions.
Max Kazantsevebd95ea2019-02-19 11:14:05 +0000660 Changed |= constantFoldTerminators(L, DT, LI, SE, MSSAU, isLoopDeleted);
661
662 if (isLoopDeleted)
663 return true;
Max Kazantsevc04b5302018-11-20 05:43:32 +0000664
Max Kazantsev46955b52018-11-01 09:42:50 +0000665 // Eliminate unconditional branches by merging blocks into their predecessors.
666 Changed |= mergeBlocksIntoPredecessors(L, DT, LI, MSSAU);
667
668 if (Changed)
669 SE.forgetTopmostLoop(&L);
670
671 return Changed;
672}
673
Chandler Carruth410eaeb2017-01-11 06:23:21 +0000674PreservedAnalyses LoopSimplifyCFGPass::run(Loop &L, LoopAnalysisManager &AM,
675 LoopStandardAnalysisResults &AR,
Max Kazantsevebd95ea2019-02-19 11:14:05 +0000676 LPMUpdater &LPMU) {
Alina Sbirlea8b83d682018-08-22 20:10:21 +0000677 Optional<MemorySSAUpdater> MSSAU;
678 if (EnableMSSALoopDependency && AR.MSSA)
679 MSSAU = MemorySSAUpdater(AR.MSSA);
Max Kazantsevebd95ea2019-02-19 11:14:05 +0000680 bool DeleteCurrentLoop = false;
Alina Sbirlea8b83d682018-08-22 20:10:21 +0000681 if (!simplifyLoopCFG(L, AR.DT, AR.LI, AR.SE,
Max Kazantsevebd95ea2019-02-19 11:14:05 +0000682 MSSAU.hasValue() ? MSSAU.getPointer() : nullptr,
683 DeleteCurrentLoop))
Justin Bognerab6a5132016-05-03 21:47:32 +0000684 return PreservedAnalyses::all();
Chandler Carruthca68a3e2017-01-15 06:32:49 +0000685
Max Kazantsevebd95ea2019-02-19 11:14:05 +0000686 if (DeleteCurrentLoop)
687 LPMU.markLoopAsDeleted(L, "loop-simplifycfg");
688
Justin Bognerab6a5132016-05-03 21:47:32 +0000689 return getLoopPassPreservedAnalyses();
690}
691
692namespace {
693class LoopSimplifyCFGLegacyPass : public LoopPass {
694public:
695 static char ID; // Pass ID, replacement for typeid
696 LoopSimplifyCFGLegacyPass() : LoopPass(ID) {
697 initializeLoopSimplifyCFGLegacyPassPass(*PassRegistry::getPassRegistry());
698 }
699
Max Kazantsevebd95ea2019-02-19 11:14:05 +0000700 bool runOnLoop(Loop *L, LPPassManager &LPM) override {
Justin Bognerab6a5132016-05-03 21:47:32 +0000701 if (skipLoop(L))
702 return false;
703
704 DominatorTree &DT = getAnalysis<DominatorTreeWrapperPass>().getDomTree();
705 LoopInfo &LI = getAnalysis<LoopInfoWrapperPass>().getLoopInfo();
David Greene6a9c242018-06-19 09:43:36 +0000706 ScalarEvolution &SE = getAnalysis<ScalarEvolutionWrapperPass>().getSE();
Alina Sbirlea8b83d682018-08-22 20:10:21 +0000707 Optional<MemorySSAUpdater> MSSAU;
708 if (EnableMSSALoopDependency) {
709 MemorySSA *MSSA = &getAnalysis<MemorySSAWrapperPass>().getMSSA();
710 MSSAU = MemorySSAUpdater(MSSA);
711 if (VerifyMemorySSA)
712 MSSA->verifyMemorySSA();
713 }
Max Kazantsevebd95ea2019-02-19 11:14:05 +0000714 bool DeleteCurrentLoop = false;
715 bool Changed = simplifyLoopCFG(
716 *L, DT, LI, SE, MSSAU.hasValue() ? MSSAU.getPointer() : nullptr,
717 DeleteCurrentLoop);
718 if (DeleteCurrentLoop)
719 LPM.markLoopAsDeleted(*L);
720 return Changed;
Justin Bognerab6a5132016-05-03 21:47:32 +0000721 }
722
723 void getAnalysisUsage(AnalysisUsage &AU) const override {
Alina Sbirlea8b83d682018-08-22 20:10:21 +0000724 if (EnableMSSALoopDependency) {
725 AU.addRequired<MemorySSAWrapperPass>();
726 AU.addPreserved<MemorySSAWrapperPass>();
727 }
Chandler Carruth49c22192016-05-12 22:19:39 +0000728 AU.addPreserved<DependenceAnalysisWrapperPass>();
Justin Bognerab6a5132016-05-03 21:47:32 +0000729 getLoopAnalysisUsage(AU);
730 }
731};
732}
733
734char LoopSimplifyCFGLegacyPass::ID = 0;
735INITIALIZE_PASS_BEGIN(LoopSimplifyCFGLegacyPass, "loop-simplifycfg",
736 "Simplify loop CFG", false, false)
737INITIALIZE_PASS_DEPENDENCY(LoopPass)
Alina Sbirlea8b83d682018-08-22 20:10:21 +0000738INITIALIZE_PASS_DEPENDENCY(MemorySSAWrapperPass)
Justin Bognerab6a5132016-05-03 21:47:32 +0000739INITIALIZE_PASS_END(LoopSimplifyCFGLegacyPass, "loop-simplifycfg",
740 "Simplify loop CFG", false, false)
741
742Pass *llvm::createLoopSimplifyCFGPass() {
743 return new LoopSimplifyCFGLegacyPass();
Fiona Glaserb417d462016-01-29 22:35:36 +0000744}