1 //===-- DwarfEHPrepare - Prepare exception handling for code generation ---===//
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 pass mulches exception handling code into a form adapted to code
11 // generation. Required if using dwarf exception handling.
13 //===----------------------------------------------------------------------===//
15 #define DEBUG_TYPE "dwarfehprepare"
16 #include "llvm/ADT/Statistic.h"
17 #include "llvm/Analysis/Dominators.h"
18 #include "llvm/CodeGen/Passes.h"
19 #include "llvm/Function.h"
20 #include "llvm/Instructions.h"
21 #include "llvm/IntrinsicInst.h"
22 #include "llvm/Module.h"
23 #include "llvm/Pass.h"
24 #include "llvm/Support/Compiler.h"
25 #include "llvm/Target/TargetLowering.h"
26 #include "llvm/Transforms/Utils/BasicBlockUtils.h"
27 #include "llvm/Transforms/Utils/PromoteMemToReg.h"
30 STATISTIC(NumLandingPadsSplit
, "Number of landing pads split");
31 STATISTIC(NumUnwindsLowered
, "Number of unwind instructions lowered");
32 STATISTIC(NumExceptionValuesMoved
, "Number of eh.exception calls moved");
33 STATISTIC(NumStackTempsIntroduced
, "Number of stack temporaries introduced");
36 class VISIBILITY_HIDDEN DwarfEHPrepare
: public FunctionPass
{
37 const TargetLowering
*TLI
;
40 // The eh.exception intrinsic.
41 Function
*ExceptionValueIntrinsic
;
43 // _Unwind_Resume or the target equivalent.
44 Constant
*RewindFunction
;
46 // Dominator info is used when turning stack temporaries into registers.
48 DominanceFrontier
*DF
;
50 // The function we are running on.
53 // The landing pads for this function.
54 typedef SmallPtrSet
<BasicBlock
*, 8> BBSet
;
57 // Stack temporary used to hold eh.exception values.
58 AllocaInst
*ExceptionValueVar
;
60 bool NormalizeLandingPads();
62 bool MoveExceptionValueCalls();
63 bool FinishStackTemporaries();
64 bool PromoteStackTemporaries();
66 Instruction
*CreateExceptionValueCall(BasicBlock
*BB
);
67 Instruction
*CreateValueLoad(BasicBlock
*BB
);
69 /// CreateReadOfExceptionValue - Return the result of the eh.exception
70 /// intrinsic by calling the intrinsic if in a landing pad, or loading
71 /// it from the exception value variable otherwise.
72 Instruction
*CreateReadOfExceptionValue(BasicBlock
*BB
) {
73 return LandingPads
.count(BB
) ?
74 CreateExceptionValueCall(BB
) : CreateValueLoad(BB
);
78 static char ID
; // Pass identification, replacement for typeid.
79 DwarfEHPrepare(const TargetLowering
*tli
, bool fast
) :
80 FunctionPass(&ID
), TLI(tli
), CompileFast(fast
),
81 ExceptionValueIntrinsic(0), RewindFunction(0) {}
83 virtual bool runOnFunction(Function
&Fn
);
85 // getAnalysisUsage - We need dominance frontiers for memory promotion.
86 virtual void getAnalysisUsage(AnalysisUsage
&AU
) const {
88 AU
.addRequired
<DominatorTree
>();
89 AU
.addPreserved
<DominatorTree
>();
91 AU
.addRequired
<DominanceFrontier
>();
92 AU
.addPreserved
<DominanceFrontier
>();
95 const char *getPassName() const {
96 return "Exception handling preparation";
100 } // end anonymous namespace
102 char DwarfEHPrepare::ID
= 0;
104 FunctionPass
*llvm::createDwarfEHPass(const TargetLowering
*tli
, bool fast
) {
105 return new DwarfEHPrepare(tli
, fast
);
108 /// NormalizeLandingPads - Normalize and discover landing pads, noting them
109 /// in the LandingPads set. A landing pad is normal if the only CFG edges
110 /// that end at it are unwind edges from invoke instructions.
111 /// Abnormal landing pads are fixed up by redirecting all unwind edges to
112 /// a new basic block which falls through to the original.
113 bool DwarfEHPrepare::NormalizeLandingPads() {
114 bool Changed
= false;
116 for (Function::iterator I
= F
->begin(), E
= F
->end(); I
!= E
; ++I
) {
117 TerminatorInst
*TI
= I
->getTerminator();
118 if (!isa
<InvokeInst
>(TI
))
120 BasicBlock
*LPad
= TI
->getSuccessor(1);
121 // Skip landing pads that have already been normalized.
122 if (LandingPads
.count(LPad
))
125 // Check that only invoke unwind edges end at the landing pad.
126 bool OnlyUnwoundTo
= true;
127 for (pred_iterator PI
= pred_begin(LPad
), PE
= pred_end(LPad
);
129 TerminatorInst
*PT
= (*PI
)->getTerminator();
130 if (!isa
<InvokeInst
>(PT
) || LPad
== PT
->getSuccessor(0)) {
131 OnlyUnwoundTo
= false;
136 // Only unwind edges lead to the landing pad. Remember the landing pad.
137 LandingPads
.insert(LPad
);
141 // At least one normal edge ends at the landing pad. Redirect the unwind
142 // edges to a new basic block which falls through into this one.
144 // Create the new basic block.
145 BasicBlock
*NewBB
= BasicBlock::Create(LPad
->getName() + "_unwind_edge");
147 // Insert it into the function right before the original landing pad.
148 LPad
->getParent()->getBasicBlockList().insert(LPad
, NewBB
);
150 // Redirect unwind edges from the original landing pad to NewBB.
151 for (pred_iterator PI
= pred_begin(LPad
), PE
= pred_end(LPad
); PI
!= PE
; ) {
152 TerminatorInst
*PT
= (*PI
++)->getTerminator();
153 if (isa
<InvokeInst
>(PT
) && PT
->getSuccessor(1) == LPad
)
154 // Unwind to the new block.
155 PT
->setSuccessor(1, NewBB
);
158 // If there are any PHI nodes in LPad, we need to update them so that they
159 // merge incoming values from NewBB instead.
160 for (BasicBlock::iterator II
= LPad
->begin(); isa
<PHINode
>(II
); ++II
) {
161 PHINode
*PN
= cast
<PHINode
>(II
);
162 pred_iterator PB
= pred_begin(NewBB
), PE
= pred_end(NewBB
);
164 // Check to see if all of the values coming in via unwind edges are the
165 // same. If so, we don't need to create a new PHI node.
166 Value
*InVal
= PN
->getIncomingValueForBlock(*PB
);
167 for (pred_iterator PI
= PB
; PI
!= PE
; ++PI
) {
168 if (PI
!= PB
&& InVal
!= PN
->getIncomingValueForBlock(*PI
)) {
175 // Different unwind edges have different values. Create a new PHI node
177 PHINode
*NewPN
= PHINode::Create(PN
->getType(), PN
->getName()+".unwind",
179 // Add an entry for each unwind edge, using the value from the old PHI.
180 for (pred_iterator PI
= PB
; PI
!= PE
; ++PI
)
181 NewPN
->addIncoming(PN
->getIncomingValueForBlock(*PI
), *PI
);
183 // Now use this new PHI as the common incoming value for NewBB in PN.
187 // Revector exactly one entry in the PHI node to come from NewBB
188 // and delete all other entries that come from unwind edges. If
189 // there are both normal and unwind edges from the same predecessor,
190 // this leaves an entry for the normal edge.
191 for (pred_iterator PI
= PB
; PI
!= PE
; ++PI
)
192 PN
->removeIncomingValue(*PI
);
193 PN
->addIncoming(InVal
, NewBB
);
196 // Add a fallthrough from NewBB to the original landing pad.
197 BranchInst::Create(LPad
, NewBB
);
199 // Now update DominatorTree and DominanceFrontier analysis information.
201 DT
->splitBlock(NewBB
);
203 DF
->splitBlock(NewBB
);
205 // Remember the newly constructed landing pad. The original landing pad
206 // LPad is no longer a landing pad now that all unwind edges have been
207 // revectored to NewBB.
208 LandingPads
.insert(NewBB
);
209 ++NumLandingPadsSplit
;
216 /// LowerUnwinds - Turn unwind instructions into calls to _Unwind_Resume,
217 /// rethrowing any previously caught exception. This will crash horribly
218 /// at runtime if there is no such exception: using unwind to throw a new
219 /// exception is currently not supported.
220 bool DwarfEHPrepare::LowerUnwinds() {
221 bool Changed
= false;
223 for (Function::iterator I
= F
->begin(), E
= F
->end(); I
!= E
; ++I
) {
224 TerminatorInst
*TI
= I
->getTerminator();
225 if (!isa
<UnwindInst
>(TI
))
228 // Replace the unwind instruction with a call to _Unwind_Resume (or the
229 // appropriate target equivalent) followed by an UnreachableInst.
231 // Find the rewind function if we didn't already.
232 if (!RewindFunction
) {
233 std::vector
<const Type
*> Params(1, PointerType::getUnqual(Type::Int8Ty
));
234 FunctionType
*FTy
= FunctionType::get(Type::VoidTy
, Params
, false);
235 const char *RewindName
= TLI
->getLibcallName(RTLIB::UNWIND_RESUME
);
236 RewindFunction
= F
->getParent()->getOrInsertFunction(RewindName
, FTy
);
239 // Create the call...
240 CallInst::Create(RewindFunction
, CreateReadOfExceptionValue(I
), "", TI
);
241 // ...followed by an UnreachableInst.
242 new UnreachableInst(TI
);
244 // Nuke the unwind instruction.
245 TI
->eraseFromParent();
253 /// MoveExceptionValueCalls - Ensure that eh.exception is only ever called from
254 /// landing pads by replacing calls outside of landing pads with loads from a
255 /// stack temporary. Move eh.exception calls inside landing pads to the start
256 /// of the landing pad (optional, but may make things simpler for later passes).
257 bool DwarfEHPrepare::MoveExceptionValueCalls() {
258 // If the eh.exception intrinsic is not declared in the module then there is
259 // nothing to do. Speed up compilation by checking for this common case.
260 if (!ExceptionValueIntrinsic
&&
261 !F
->getParent()->getFunction(Intrinsic::getName(Intrinsic::eh_exception
)))
264 bool Changed
= false;
266 for (Function::iterator BB
= F
->begin(), E
= F
->end(); BB
!= E
; ++BB
) {
267 for (BasicBlock::iterator II
= BB
->begin(), E
= BB
->end(); II
!= E
;)
268 if (IntrinsicInst
*CI
= dyn_cast
<IntrinsicInst
>(II
++))
269 if (CI
->getIntrinsicID() == Intrinsic::eh_exception
) {
270 if (!CI
->use_empty()) {
271 Value
*ExceptionValue
= CreateReadOfExceptionValue(BB
);
272 if (CI
== ExceptionValue
) {
273 // The call was at the start of a landing pad - leave it alone.
274 assert(LandingPads
.count(BB
) &&
275 "Created eh.exception call outside landing pad!");
278 CI
->replaceAllUsesWith(ExceptionValue
);
280 CI
->eraseFromParent();
281 ++NumExceptionValuesMoved
;
289 /// FinishStackTemporaries - If we introduced a stack variable to hold the
290 /// exception value then initialize it in each landing pad.
291 bool DwarfEHPrepare::FinishStackTemporaries() {
292 if (!ExceptionValueVar
)
296 bool Changed
= false;
298 // Make sure that there is a store of the exception value at the start of
300 for (BBSet::iterator LI
= LandingPads
.begin(), LE
= LandingPads
.end();
302 Instruction
*ExceptionValue
= CreateReadOfExceptionValue(*LI
);
303 Instruction
*Store
= new StoreInst(ExceptionValue
, ExceptionValueVar
);
304 Store
->insertAfter(ExceptionValue
);
311 /// PromoteStackTemporaries - Turn any stack temporaries we introduced into
312 /// registers if possible.
313 bool DwarfEHPrepare::PromoteStackTemporaries() {
314 if (ExceptionValueVar
&& DT
&& DF
&& isAllocaPromotable(ExceptionValueVar
)) {
315 // Turn the exception temporary into registers and phi nodes if possible.
316 std::vector
<AllocaInst
*> Allocas(1, ExceptionValueVar
);
317 PromoteMemToReg(Allocas
, *DT
, *DF
, ExceptionValueVar
->getContext());
323 /// CreateExceptionValueCall - Insert a call to the eh.exception intrinsic at
324 /// the start of the basic block (unless there already is one, in which case
325 /// the existing call is returned).
326 Instruction
*DwarfEHPrepare::CreateExceptionValueCall(BasicBlock
*BB
) {
327 Instruction
*Start
= BB
->getFirstNonPHI();
328 // Is this a call to eh.exception?
329 if (IntrinsicInst
*CI
= dyn_cast
<IntrinsicInst
>(Start
))
330 if (CI
->getIntrinsicID() == Intrinsic::eh_exception
)
331 // Reuse the existing call.
334 // Find the eh.exception intrinsic if we didn't already.
335 if (!ExceptionValueIntrinsic
)
336 ExceptionValueIntrinsic
= Intrinsic::getDeclaration(F
->getParent(),
337 Intrinsic::eh_exception
);
340 return CallInst::Create(ExceptionValueIntrinsic
, "eh.value.call", Start
);
343 /// CreateValueLoad - Insert a load of the exception value stack variable
344 /// (creating it if necessary) at the start of the basic block (unless
345 /// there already is a load, in which case the existing load is returned).
346 Instruction
*DwarfEHPrepare::CreateValueLoad(BasicBlock
*BB
) {
347 Instruction
*Start
= BB
->getFirstNonPHI();
348 // Is this a load of the exception temporary?
349 if (ExceptionValueVar
)
350 if (LoadInst
* LI
= dyn_cast
<LoadInst
>(Start
))
351 if (LI
->getPointerOperand() == ExceptionValueVar
)
352 // Reuse the existing load.
355 // Create the temporary if we didn't already.
356 if (!ExceptionValueVar
) {
357 ExceptionValueVar
= new AllocaInst(PointerType::getUnqual(Type::Int8Ty
),
358 "eh.value", F
->begin()->begin());
359 ++NumStackTempsIntroduced
;
363 return new LoadInst(ExceptionValueVar
, "eh.value.load", Start
);
366 bool DwarfEHPrepare::runOnFunction(Function
&Fn
) {
367 bool Changed
= false;
369 // Initialize internal state.
370 DT
= getAnalysisIfAvailable
<DominatorTree
>();
371 DF
= getAnalysisIfAvailable
<DominanceFrontier
>();
372 ExceptionValueVar
= 0;
375 // Ensure that only unwind edges end at landing pads (a landing pad is a
376 // basic block where an invoke unwind edge ends).
377 Changed
|= NormalizeLandingPads();
379 // Turn unwind instructions into libcalls.
380 Changed
|= LowerUnwinds();
382 // TODO: Move eh.selector calls to landing pads and combine them.
384 // Move eh.exception calls to landing pads.
385 Changed
|= MoveExceptionValueCalls();
387 // Initialize any stack temporaries we introduced.
388 Changed
|= FinishStackTemporaries();
390 // Turn any stack temporaries into registers if possible.
392 Changed
|= PromoteStackTemporaries();