1 //===-- CFG.cpp - BasicBlock analysis --------------------------------------==//
3 // The LLVM Compiler Infrastructure
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
8 //===----------------------------------------------------------------------===//
10 // This family of functions performs analyses on basic blocks, and instructions
11 // contained within basic blocks.
13 //===----------------------------------------------------------------------===//
15 #include "llvm/Analysis/CFG.h"
17 #include "llvm/ADT/SmallSet.h"
18 #include "llvm/Analysis/Dominators.h"
19 #include "llvm/Analysis/LoopInfo.h"
23 /// FindFunctionBackedges - Analyze the specified function to find all of the
24 /// loop backedges in the function and return them. This is a relatively cheap
25 /// (compared to computing dominators and loop info) analysis.
27 /// The output is added to Result, as pairs of <from,to> edge info.
28 void llvm::FindFunctionBackedges(const Function &F,
29 SmallVectorImpl<std::pair<const BasicBlock*,const BasicBlock*> > &Result) {
30 const BasicBlock *BB = &F.getEntryBlock();
31 if (succ_begin(BB) == succ_end(BB))
34 SmallPtrSet<const BasicBlock*, 8> Visited;
35 SmallVector<std::pair<const BasicBlock*, succ_const_iterator>, 8> VisitStack;
36 SmallPtrSet<const BasicBlock*, 8> InStack;
39 VisitStack.push_back(std::make_pair(BB, succ_begin(BB)));
42 std::pair<const BasicBlock*, succ_const_iterator> &Top = VisitStack.back();
43 const BasicBlock *ParentBB = Top.first;
44 succ_const_iterator &I = Top.second;
46 bool FoundNew = false;
47 while (I != succ_end(ParentBB)) {
49 if (Visited.insert(BB)) {
53 // Successor is in VisitStack, it's a back edge.
54 if (InStack.count(BB))
55 Result.push_back(std::make_pair(ParentBB, BB));
59 // Go down one level if there is a unvisited successor.
61 VisitStack.push_back(std::make_pair(BB, succ_begin(BB)));
64 InStack.erase(VisitStack.pop_back_val().first);
66 } while (!VisitStack.empty());
69 /// GetSuccessorNumber - Search for the specified successor of basic block BB
70 /// and return its position in the terminator instruction's list of
71 /// successors. It is an error to call this with a block that is not a
73 unsigned llvm::GetSuccessorNumber(BasicBlock *BB, BasicBlock *Succ) {
74 TerminatorInst *Term = BB->getTerminator();
76 unsigned e = Term->getNumSuccessors();
78 for (unsigned i = 0; ; ++i) {
79 assert(i != e && "Didn't find edge?");
80 if (Term->getSuccessor(i) == Succ)
85 /// isCriticalEdge - Return true if the specified edge is a critical edge.
86 /// Critical edges are edges from a block with multiple successors to a block
87 /// with multiple predecessors.
88 bool llvm::isCriticalEdge(const TerminatorInst *TI, unsigned SuccNum,
89 bool AllowIdenticalEdges) {
90 assert(SuccNum < TI->getNumSuccessors() && "Illegal edge specification!");
91 if (TI->getNumSuccessors() == 1) return false;
93 const BasicBlock *Dest = TI->getSuccessor(SuccNum);
94 const_pred_iterator I = pred_begin(Dest), E = pred_end(Dest);
96 // If there is more than one predecessor, this is a critical edge...
97 assert(I != E && "No preds, but we have an edge to the block?");
98 const BasicBlock *FirstPred = *I;
99 ++I; // Skip one edge due to the incoming arc from TI.
100 if (!AllowIdenticalEdges)
103 // If AllowIdenticalEdges is true, then we allow this edge to be considered
104 // non-critical iff all preds come from TI's block.
106 const BasicBlock *P = *I;
109 // Note: leave this as is until no one ever compiles with either gcc 4.0.1
110 // or Xcode 2. This seems to work around the pred_iterator assert in PR 2207
117 // LoopInfo contains a mapping from basic block to the innermost loop. Find
118 // the outermost loop in the loop nest that contains BB.
119 static const Loop *getOutermostLoop(LoopInfo *LI, const BasicBlock *BB) {
120 const Loop *L = LI->getLoopFor(BB);
122 while (const Loop *Parent = L->getParentLoop())
128 // True if there is a loop which contains both BB1 and BB2.
129 static bool loopContainsBoth(LoopInfo *LI,
130 const BasicBlock *BB1, const BasicBlock *BB2) {
131 const Loop *L1 = getOutermostLoop(LI, BB1);
132 const Loop *L2 = getOutermostLoop(LI, BB2);
133 return L1 != NULL && L1 == L2;
136 static bool isPotentiallyReachableSameBlock(const Instruction *A,
137 const Instruction *B,
139 // The same block case is special because it's the only time we're looking
140 // within a single block to see which comes first. Once we start looking at
141 // multiple blocks, the first instruction of the block is reachable, so we
142 // only need to determine reachability between whole blocks.
144 const BasicBlock *BB = A->getParent();
145 // If the block is in a loop then we can reach any instruction in the block
146 // from any other instruction in the block by going around the backedge.
147 // Check whether we're in a loop (or aren't sure).
149 // Can't be in a loop if it's the entry block -- the entry block may not
150 // have predecessors.
151 bool HasLoop = BB != &BB->getParent()->getEntryBlock();
153 // Can't be in a loop if LoopInfo doesn't know about it.
155 HasLoop = LI->getLoopFor(BB) != 0;
160 // Linear scan, start at 'A', see whether we hit 'B' or the end first.
161 for (BasicBlock::const_iterator I = A, E = BB->end(); I != E; ++I) {
168 bool llvm::isPotentiallyReachable(const Instruction *A, const Instruction *B,
169 DominatorTree *DT, LoopInfo *LI) {
170 assert(A->getParent()->getParent() == B->getParent()->getParent() &&
171 "This analysis is function-local!");
173 const BasicBlock *StopBB = B->getParent();
175 if (A->getParent() == B->getParent())
176 return isPotentiallyReachableSameBlock(A, B, LI);
178 if (A->getParent() == &A->getParent()->getParent()->getEntryBlock())
180 if (B->getParent() == &A->getParent()->getParent()->getEntryBlock())
183 // When the stop block is unreachable, it's dominated from everywhere,
184 // regardless of whether there's a path between the two blocks.
185 if (DT && !DT->isReachableFromEntry(StopBB))
188 // Limit the number of blocks we visit. The goal is to avoid run-away compile
189 // times on large CFGs without hampering sensible code. Arbitrarily chosen.
192 SmallSet<const BasicBlock*, 64> Visited;
193 SmallVector<BasicBlock*, 32> Worklist;
194 Worklist.push_back(const_cast<BasicBlock*>(A->getParent()));
197 BasicBlock *BB = Worklist.pop_back_val();
198 if (!Visited.insert(BB))
202 if (DT && DT->dominates(BB, StopBB))
204 if (LI && loopContainsBoth(LI, BB, StopBB))
208 // We haven't been able to prove it one way or the other. Conservatively
209 // answer true -- that there is potentially a path.
213 if (const Loop *Outer = LI ? getOutermostLoop(LI, BB) : 0) {
214 // All blocks in a single loop are reachable from all other blocks. From
215 // any of these blocks, we can skip directly to the exits of the loop,
216 // ignoring any other blocks inside the loop body.
217 Outer->getExitBlocks(Worklist);
219 for (succ_iterator I = succ_begin(BB), E = succ_end(BB); I != E; ++I)
220 Worklist.push_back(*I);
222 } while (!Worklist.empty());
224 // We have exhaustived all possible paths and are certain that 'To' can not
225 // be reached from 'From'.