1 //===- LoopPass.cpp - Loop Pass and Loop Pass Manager ---------------------===//
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 file implements LoopPass and LPPassManager. All loop optimization
11 // and transformation passes are derived from LoopPass. LPPassManager is
12 // responsible for managing LoopPasses.
14 //===----------------------------------------------------------------------===//
16 #include "llvm/Analysis/LoopPass.h"
17 #include "llvm/Assembly/PrintModulePass.h"
18 #include "llvm/Support/Debug.h"
19 #include "llvm/Support/Timer.h"
24 /// PrintLoopPass - Print a Function corresponding to a Loop.
26 class PrintLoopPass
: public LoopPass
{
29 raw_ostream
&Out
; // raw_ostream to print on.
33 PrintLoopPass(const std::string
&B
, raw_ostream
&o
)
34 : LoopPass(ID
), Banner(B
), Out(o
) {}
36 virtual void getAnalysisUsage(AnalysisUsage
&AU
) const {
40 bool runOnLoop(Loop
*L
, LPPassManager
&) {
42 for (Loop::block_iterator b
= L
->block_begin(), be
= L
->block_end();
51 char PrintLoopPass::ID
= 0;
54 //===----------------------------------------------------------------------===//
58 char LPPassManager::ID
= 0;
60 LPPassManager::LPPassManager(int Depth
)
61 : FunctionPass(ID
), PMDataManager(Depth
) {
68 /// Delete loop from the loop queue and loop hierarchy (LoopInfo).
69 void LPPassManager::deleteLoopFromQueue(Loop
*L
) {
71 if (Loop
*ParentLoop
= L
->getParentLoop()) { // Not a top-level loop.
72 // Reparent all of the blocks in this loop. Since BBLoop had a parent,
73 // they are now all in it.
74 for (Loop::block_iterator I
= L
->block_begin(), E
= L
->block_end();
76 if (LI
->getLoopFor(*I
) == L
) // Don't change blocks in subloops.
77 LI
->changeLoopFor(*I
, ParentLoop
);
79 // Remove the loop from its parent loop.
80 for (Loop::iterator I
= ParentLoop
->begin(), E
= ParentLoop
->end();;
82 assert(I
!= E
&& "Couldn't find loop");
84 ParentLoop
->removeChildLoop(I
);
89 // Move all subloops into the parent loop.
91 ParentLoop
->addChildLoop(L
->removeChildLoop(L
->end()-1));
93 // Reparent all of the blocks in this loop. Since BBLoop had no parent,
94 // they no longer in a loop at all.
96 for (unsigned i
= 0; i
!= L
->getBlocks().size(); ++i
) {
97 // Don't change blocks in subloops.
98 if (LI
->getLoopFor(L
->getBlocks()[i
]) == L
) {
99 LI
->removeBlock(L
->getBlocks()[i
]);
104 // Remove the loop from the top-level LoopInfo object.
105 for (LoopInfo::iterator I
= LI
->begin(), E
= LI
->end();; ++I
) {
106 assert(I
!= E
&& "Couldn't find loop");
113 // Move all of the subloops to the top-level.
115 LI
->addTopLevelLoop(L
->removeChildLoop(L
->end()-1));
120 // If L is current loop then skip rest of the passes and let
121 // runOnFunction remove L from LQ. Otherwise, remove L from LQ now
122 // and continue applying other passes on CurrentLoop.
123 if (CurrentLoop
== L
) {
128 for (std::deque
<Loop
*>::iterator I
= LQ
.begin(),
129 E
= LQ
.end(); I
!= E
; ++I
) {
137 // Inset loop into loop nest (LoopInfo) and loop queue (LQ).
138 void LPPassManager::insertLoop(Loop
*L
, Loop
*ParentLoop
) {
140 assert (CurrentLoop
!= L
&& "Cannot insert CurrentLoop");
142 // Insert into loop nest
144 ParentLoop
->addChildLoop(L
);
146 LI
->addTopLevelLoop(L
);
148 insertLoopIntoQueue(L
);
151 void LPPassManager::insertLoopIntoQueue(Loop
*L
) {
152 // Insert L into loop queue
153 if (L
== CurrentLoop
)
155 else if (!L
->getParentLoop())
156 // This is top level loop.
159 // Insert L after the parent loop.
160 for (std::deque
<Loop
*>::iterator I
= LQ
.begin(),
161 E
= LQ
.end(); I
!= E
; ++I
) {
162 if (*I
== L
->getParentLoop()) {
163 // deque does not support insert after.
172 // Reoptimize this loop. LPPassManager will re-insert this loop into the
173 // queue. This allows LoopPass to change loop nest for the loop. This
174 // utility may send LPPassManager into infinite loops so use caution.
175 void LPPassManager::redoLoop(Loop
*L
) {
176 assert (CurrentLoop
== L
&& "Can redo only CurrentLoop");
180 /// cloneBasicBlockSimpleAnalysis - Invoke cloneBasicBlockAnalysis hook for
182 void LPPassManager::cloneBasicBlockSimpleAnalysis(BasicBlock
*From
,
183 BasicBlock
*To
, Loop
*L
) {
184 for (unsigned Index
= 0; Index
< getNumContainedPasses(); ++Index
) {
185 LoopPass
*LP
= getContainedPass(Index
);
186 LP
->cloneBasicBlockAnalysis(From
, To
, L
);
190 /// deleteSimpleAnalysisValue - Invoke deleteAnalysisValue hook for all passes.
191 void LPPassManager::deleteSimpleAnalysisValue(Value
*V
, Loop
*L
) {
192 if (BasicBlock
*BB
= dyn_cast
<BasicBlock
>(V
)) {
193 for (BasicBlock::iterator BI
= BB
->begin(), BE
= BB
->end(); BI
!= BE
;
195 Instruction
&I
= *BI
;
196 deleteSimpleAnalysisValue(&I
, L
);
199 for (unsigned Index
= 0; Index
< getNumContainedPasses(); ++Index
) {
200 LoopPass
*LP
= getContainedPass(Index
);
201 LP
->deleteAnalysisValue(V
, L
);
206 // Recurse through all subloops and all loops into LQ.
207 static void addLoopIntoQueue(Loop
*L
, std::deque
<Loop
*> &LQ
) {
209 for (Loop::iterator I
= L
->begin(), E
= L
->end(); I
!= E
; ++I
)
210 addLoopIntoQueue(*I
, LQ
);
213 /// Pass Manager itself does not invalidate any analysis info.
214 void LPPassManager::getAnalysisUsage(AnalysisUsage
&Info
) const {
215 // LPPassManager needs LoopInfo. In the long term LoopInfo class will
216 // become part of LPPassManager.
217 Info
.addRequired
<LoopInfo
>();
218 Info
.setPreservesAll();
221 /// run - Execute all of the passes scheduled for execution. Keep track of
222 /// whether any of the passes modifies the function, and if so, return true.
223 bool LPPassManager::runOnFunction(Function
&F
) {
224 LI
= &getAnalysis
<LoopInfo
>();
225 bool Changed
= false;
227 // Collect inherited analysis from Module level pass manager.
228 populateInheritedAnalysis(TPM
->activeStack
);
230 // Populate Loop Queue
231 for (LoopInfo::iterator I
= LI
->begin(), E
= LI
->end(); I
!= E
; ++I
)
232 addLoopIntoQueue(*I
, LQ
);
234 if (LQ
.empty()) // No loops, skip calling finalizers
238 for (std::deque
<Loop
*>::const_iterator I
= LQ
.begin(), E
= LQ
.end();
241 for (unsigned Index
= 0; Index
< getNumContainedPasses(); ++Index
) {
242 LoopPass
*P
= getContainedPass(Index
);
243 Changed
|= P
->doInitialization(L
, *this);
248 while (!LQ
.empty()) {
250 CurrentLoop
= LQ
.back();
251 skipThisLoop
= false;
252 redoThisLoop
= false;
254 // Run all passes on the current Loop.
255 for (unsigned Index
= 0; Index
< getNumContainedPasses(); ++Index
) {
256 LoopPass
*P
= getContainedPass(Index
);
258 dumpPassInfo(P
, EXECUTION_MSG
, ON_LOOP_MSG
,
259 CurrentLoop
->getHeader()->getName());
262 initializeAnalysisImpl(P
);
265 PassManagerPrettyStackEntry
X(P
, *CurrentLoop
->getHeader());
266 TimeRegion
PassTimer(getPassTimer(P
));
268 Changed
|= P
->runOnLoop(CurrentLoop
, *this);
272 dumpPassInfo(P
, MODIFICATION_MSG
, ON_LOOP_MSG
,
273 skipThisLoop
? "<deleted>" :
274 CurrentLoop
->getHeader()->getName());
278 // Manually check that this loop is still healthy. This is done
279 // instead of relying on LoopInfo::verifyLoop since LoopInfo
280 // is a function pass and it's really expensive to verify every
281 // loop in the function every time. That level of checking can be
282 // enabled with the -verify-loop-info option.
284 TimeRegion
PassTimer(getPassTimer(LI
));
285 CurrentLoop
->verifyLoop();
288 // Then call the regular verifyAnalysis functions.
289 verifyPreservedAnalysis(P
);
292 removeNotPreservedAnalysis(P
);
293 recordAvailableAnalysis(P
);
295 skipThisLoop
? "<deleted>" :
296 CurrentLoop
->getHeader()->getName(),
300 // Do not run other passes on this loop.
304 // If the loop was deleted, release all the loop passes. This frees up
305 // some memory, and avoids trouble with the pass manager trying to call
306 // verifyAnalysis on them.
308 for (unsigned Index
= 0; Index
< getNumContainedPasses(); ++Index
) {
309 Pass
*P
= getContainedPass(Index
);
310 freePass(P
, "<deleted>", ON_LOOP_MSG
);
313 // Pop the loop from queue after running all passes.
317 LQ
.push_back(CurrentLoop
);
321 for (unsigned Index
= 0; Index
< getNumContainedPasses(); ++Index
) {
322 LoopPass
*P
= getContainedPass(Index
);
323 Changed
|= P
->doFinalization();
329 /// Print passes managed by this manager
330 void LPPassManager::dumpPassStructure(unsigned Offset
) {
331 errs().indent(Offset
*2) << "Loop Pass Manager\n";
332 for (unsigned Index
= 0; Index
< getNumContainedPasses(); ++Index
) {
333 Pass
*P
= getContainedPass(Index
);
334 P
->dumpPassStructure(Offset
+ 1);
335 dumpLastUses(P
, Offset
+1);
340 //===----------------------------------------------------------------------===//
343 Pass
*LoopPass::createPrinterPass(raw_ostream
&O
,
344 const std::string
&Banner
) const {
345 return new PrintLoopPass(Banner
, O
);
348 // Check if this pass is suitable for the current LPPassManager, if
349 // available. This pass P is not suitable for a LPPassManager if P
350 // is not preserving higher level analysis info used by other
351 // LPPassManager passes. In such case, pop LPPassManager from the
352 // stack. This will force assignPassManager() to create new
353 // LPPassManger as expected.
354 void LoopPass::preparePassManager(PMStack
&PMS
) {
356 // Find LPPassManager
357 while (!PMS
.empty() &&
358 PMS
.top()->getPassManagerType() > PMT_LoopPassManager
)
361 // If this pass is destroying high level information that is used
362 // by other passes that are managed by LPM then do not insert
363 // this pass in current LPM. Use new LPPassManager.
364 if (PMS
.top()->getPassManagerType() == PMT_LoopPassManager
&&
365 !PMS
.top()->preserveHigherLevelAnalysis(this))
369 /// Assign pass manager to manage this pass.
370 void LoopPass::assignPassManager(PMStack
&PMS
,
371 PassManagerType PreferredType
) {
372 // Find LPPassManager
373 while (!PMS
.empty() &&
374 PMS
.top()->getPassManagerType() > PMT_LoopPassManager
)
378 if (PMS
.top()->getPassManagerType() == PMT_LoopPassManager
)
379 LPPM
= (LPPassManager
*)PMS
.top();
381 // Create new Loop Pass Manager if it does not exist.
382 assert (!PMS
.empty() && "Unable to create Loop Pass Manager");
383 PMDataManager
*PMD
= PMS
.top();
385 // [1] Create new Call Graph Pass Manager
386 LPPM
= new LPPassManager(PMD
->getDepth() + 1);
387 LPPM
->populateInheritedAnalysis(PMS
);
389 // [2] Set up new manager's top level manager
390 PMTopLevelManager
*TPM
= PMD
->getTopLevelManager();
391 TPM
->addIndirectPassManager(LPPM
);
393 // [3] Assign manager to manage this new manager. This may create
394 // and push new managers into PMS
395 Pass
*P
= LPPM
->getAsPass();
396 TPM
->schedulePass(P
);
398 // [4] Push new manager into PMS