blob: a9d218c5fd78564a02d9ac3a037f8dea2db01ab4 [file] [log] [blame]
Chris Lattner86e44452003-10-05 19:14:42 +00001//===- LowerInvoke.cpp - Eliminate Invoke & Unwind instructions -----------===//
Misha Brukmanfd939082005-04-21 23:48:37 +00002//
John Criswellb576c942003-10-20 19:43:21 +00003// The LLVM Compiler Infrastructure
4//
Chris Lattner4ee451d2007-12-29 20:36:04 +00005// This file is distributed under the University of Illinois Open Source
6// License. See LICENSE.TXT for details.
Misha Brukmanfd939082005-04-21 23:48:37 +00007//
John Criswellb576c942003-10-20 19:43:21 +00008//===----------------------------------------------------------------------===//
Chris Lattner86e44452003-10-05 19:14:42 +00009//
10// This transformation is designed for use by code generators which do not yet
Chris Lattner6d784572004-02-08 19:53:56 +000011// support stack unwinding. This pass supports two models of exception handling
12// lowering, the 'cheap' support and the 'expensive' support.
13//
14// 'Cheap' exception handling support gives the program the ability to execute
15// any program which does not "throw an exception", by turning 'invoke'
16// instructions into calls and by turning 'unwind' instructions into calls to
17// abort(). If the program does dynamically use the unwind instruction, the
18// program will print a message then abort.
19//
20// 'Expensive' exception handling support gives the full exception handling
John Criswellfe3706a2005-05-02 14:47:42 +000021// support to the program at the cost of making the 'invoke' instruction
22// really expensive. It basically inserts setjmp/longjmp calls to emulate the
23// exception handling as necessary.
Chris Lattner6d784572004-02-08 19:53:56 +000024//
25// Because the 'expensive' support slows down programs a lot, and EH is only
26// used for a subset of the programs, it must be specifically enabled by an
27// option.
Chris Lattner86e44452003-10-05 19:14:42 +000028//
Chris Lattner0e28eca2004-03-31 22:00:30 +000029// Note that after this pass runs the CFG is not entirely accurate (exceptional
30// control flow edges are not correct anymore) so only very simple things should
31// be done after the lowerinvoke pass has run (like generation of native code).
32// This should not be used as a general purpose "my LLVM-to-LLVM pass doesn't
33// support the invoke instruction yet" lowering pass.
34//
Chris Lattner86e44452003-10-05 19:14:42 +000035//===----------------------------------------------------------------------===//
36
Chris Lattnerd216e8b2006-12-19 22:17:40 +000037#define DEBUG_TYPE "lowerinvoke"
Chris Lattner86e44452003-10-05 19:14:42 +000038#include "llvm/Transforms/Scalar.h"
Chris Lattnere1c09302004-02-08 07:30:29 +000039#include "llvm/Constants.h"
40#include "llvm/DerivedTypes.h"
Chris Lattner6d784572004-02-08 19:53:56 +000041#include "llvm/Instructions.h"
Duncan Sandsa1220432008-04-07 13:41:19 +000042#include "llvm/Intrinsics.h"
Owen Anderson0a205a42009-07-05 22:41:43 +000043#include "llvm/LLVMContext.h"
Chris Lattnere1c09302004-02-08 07:30:29 +000044#include "llvm/Module.h"
Chris Lattner86e44452003-10-05 19:14:42 +000045#include "llvm/Pass.h"
Chris Lattner6d784572004-02-08 19:53:56 +000046#include "llvm/Transforms/Utils/BasicBlockUtils.h"
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +000047#include "llvm/Transforms/Utils/Local.h"
Reid Spencer551ccae2004-09-01 22:55:40 +000048#include "llvm/ADT/Statistic.h"
49#include "llvm/Support/CommandLine.h"
Chris Lattnera4f0b3a2006-08-27 12:54:02 +000050#include "llvm/Support/Compiler.h"
Duraid Madina2a0013f2006-09-04 06:21:35 +000051#include "llvm/Target/TargetLowering.h"
Chris Lattner6d784572004-02-08 19:53:56 +000052#include <csetjmp>
Reid Spencer6734b572007-02-04 00:40:42 +000053#include <set>
Chris Lattnerdead9932003-12-10 20:22:42 +000054using namespace llvm;
Brian Gaeked0fde302003-11-11 22:41:34 +000055
Chris Lattnerd216e8b2006-12-19 22:17:40 +000056STATISTIC(NumInvokes, "Number of invokes replaced");
57STATISTIC(NumUnwinds, "Number of unwinds replaced");
58STATISTIC(NumSpilled, "Number of registers live across unwind edges");
59
60static cl::opt<bool> ExpensiveEHSupport("enable-correct-eh-support",
Chris Lattner6d784572004-02-08 19:53:56 +000061 cl::desc("Make the -lowerinvoke pass insert expensive, but correct, EH code"));
Chris Lattner86e44452003-10-05 19:14:42 +000062
Chris Lattnerd216e8b2006-12-19 22:17:40 +000063namespace {
Chris Lattnerf4b54612006-06-28 22:08:15 +000064 class VISIBILITY_HIDDEN LowerInvoke : public FunctionPass {
Chris Lattner6d784572004-02-08 19:53:56 +000065 // Used for both models.
Chris Lattnerb76efb72007-01-07 08:12:01 +000066 Constant *WriteFn;
67 Constant *AbortFn;
Chris Lattner6d784572004-02-08 19:53:56 +000068 Value *AbortMessage;
69 unsigned AbortMessageLength;
70
71 // Used for expensive EH support.
72 const Type *JBLinkTy;
73 GlobalVariable *JBListHead;
Chris Lattnerb76efb72007-01-07 08:12:01 +000074 Constant *SetJmpFn, *LongJmpFn;
Jim Grosbach46445382009-04-17 23:30:55 +000075
Duraid Madina2a0013f2006-09-04 06:21:35 +000076 // We peek in TLI to grab the target's jmp_buf size and alignment
77 const TargetLowering *TLI;
Jim Grosbach46445382009-04-17 23:30:55 +000078
Chris Lattner86e44452003-10-05 19:14:42 +000079 public:
Nick Lewyckyecd94c82007-05-06 13:37:16 +000080 static char ID; // Pass identification, replacement for typeid
Dan Gohmanc2bbfc12007-08-01 15:32:29 +000081 explicit LowerInvoke(const TargetLowering *tli = NULL)
Dan Gohmanae73dc12008-09-04 17:05:41 +000082 : FunctionPass(&ID), TLI(tli) { }
Chris Lattner86e44452003-10-05 19:14:42 +000083 bool doInitialization(Module &M);
84 bool runOnFunction(Function &F);
Jim Grosbach46445382009-04-17 23:30:55 +000085
Chris Lattnered96fe82006-05-17 21:05:27 +000086 virtual void getAnalysisUsage(AnalysisUsage &AU) const {
Anton Korobeynikovbed29462007-04-16 18:10:23 +000087 // This is a cluster of orthogonal Transforms
Chris Lattnered96fe82006-05-17 21:05:27 +000088 AU.addPreservedID(PromoteMemoryToRegisterID);
Chris Lattnered96fe82006-05-17 21:05:27 +000089 AU.addPreservedID(LowerSwitchID);
90 AU.addPreservedID(LowerAllocationsID);
91 }
Jim Grosbach46445382009-04-17 23:30:55 +000092
Chris Lattner6d784572004-02-08 19:53:56 +000093 private:
Chris Lattnerb76efb72007-01-07 08:12:01 +000094 void createAbortMessage(Module *M);
Chris Lattner501825e2004-02-08 22:14:44 +000095 void writeAbortMessage(Instruction *IB);
Chris Lattner6d784572004-02-08 19:53:56 +000096 bool insertCheapEHSupport(Function &F);
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +000097 void splitLiveRangesLiveAcrossInvokes(std::vector<InvokeInst*> &Invokes);
98 void rewriteExpensiveInvoke(InvokeInst *II, unsigned InvokeNo,
99 AllocaInst *InvokeNum, SwitchInst *CatchSwitch);
Chris Lattner6d784572004-02-08 19:53:56 +0000100 bool insertExpensiveEHSupport(Function &F);
Chris Lattner86e44452003-10-05 19:14:42 +0000101 };
Chris Lattner86e44452003-10-05 19:14:42 +0000102}
103
Dan Gohman844731a2008-05-13 00:00:25 +0000104char LowerInvoke::ID = 0;
105static RegisterPass<LowerInvoke>
106X("lowerinvoke", "Lower invoke and unwind, for unwindless code generators");
107
Dan Gohman6ddba2b2008-05-13 02:05:11 +0000108const PassInfo *const llvm::LowerInvokePassID = &X;
Chris Lattnercefc18e2004-02-13 16:16:16 +0000109
Brian Gaeked0fde302003-11-11 22:41:34 +0000110// Public Interface To the LowerInvoke pass.
Jim Grosbach46445382009-04-17 23:30:55 +0000111FunctionPass *llvm::createLowerInvokePass(const TargetLowering *TLI) {
112 return new LowerInvoke(TLI);
Nate Begeman14b05292005-11-05 09:21:28 +0000113}
Chris Lattner86e44452003-10-05 19:14:42 +0000114
115// doInitialization - Make sure that there is a prototype for abort in the
116// current module.
117bool LowerInvoke::doInitialization(Module &M) {
Owen Andersone922c022009-07-22 00:24:57 +0000118 LLVMContext &Context = M.getContext();
Owen Anderson001dbfe2009-07-16 18:04:31 +0000119
Owen Andersondebcb012009-07-29 22:17:13 +0000120 const Type *VoidPtrTy = PointerType::getUnqual(Type::Int8Ty);
Jim Laskey7d485382007-02-22 16:21:18 +0000121 AbortMessage = 0;
122 if (ExpensiveEHSupport) {
123 // Insert a type for the linked list of jump buffers.
124 unsigned JBSize = TLI ? TLI->getJumpBufSize() : 0;
125 JBSize = JBSize ? JBSize : 200;
Owen Andersondebcb012009-07-29 22:17:13 +0000126 const Type *JmpBufTy = ArrayType::get(VoidPtrTy, JBSize);
Chris Lattnere1c09302004-02-08 07:30:29 +0000127
Jim Laskey7d485382007-02-22 16:21:18 +0000128 { // The type is recursive, so use a type holder.
129 std::vector<const Type*> Elements;
130 Elements.push_back(JmpBufTy);
Owen Andersondebcb012009-07-29 22:17:13 +0000131 OpaqueType *OT = OpaqueType::get();
132 Elements.push_back(PointerType::getUnqual(OT));
133 PATypeHolder JBLType(StructType::get(Elements));
Jim Laskey7d485382007-02-22 16:21:18 +0000134 OT->refineAbstractTypeTo(JBLType.get()); // Complete the cycle.
135 JBLinkTy = JBLType.get();
136 M.addTypeName("llvm.sjljeh.jmpbufty", JBLinkTy);
Chris Lattner6d784572004-02-08 19:53:56 +0000137 }
138
Owen Andersondebcb012009-07-29 22:17:13 +0000139 const Type *PtrJBList = PointerType::getUnqual(JBLinkTy);
Jim Laskey7d485382007-02-22 16:21:18 +0000140
141 // Now that we've done that, insert the jmpbuf list head global, unless it
142 // already exists.
143 if (!(JBListHead = M.getGlobalVariable("llvm.sjljeh.jblist", PtrJBList))) {
Owen Andersone9b11b42009-07-08 19:03:57 +0000144 JBListHead = new GlobalVariable(M, PtrJBList, false,
Duncan Sands667d4b82009-03-07 15:45:40 +0000145 GlobalValue::LinkOnceAnyLinkage,
Owen Andersone922c022009-07-22 00:24:57 +0000146 Context.getNullValue(PtrJBList),
Owen Andersone9b11b42009-07-08 19:03:57 +0000147 "llvm.sjljeh.jblist");
Jim Laskey7d485382007-02-22 16:21:18 +0000148 }
Chuck Rose IIIcc51c312008-04-15 21:27:11 +0000149
Jim Grosbach46445382009-04-17 23:30:55 +0000150// VisualStudio defines setjmp as _setjmp via #include <csetjmp> / <setjmp.h>,
Chuck Rose IIIcc51c312008-04-15 21:27:11 +0000151// so it looks like Intrinsic::_setjmp
152#if defined(_MSC_VER) && defined(setjmp)
153#define setjmp_undefined_for_visual_studio
154#undef setjmp
155#endif
156
Duncan Sandsa1220432008-04-07 13:41:19 +0000157 SetJmpFn = Intrinsic::getDeclaration(&M, Intrinsic::setjmp);
Chuck Rose IIIcc51c312008-04-15 21:27:11 +0000158
159#if defined(_MSC_VER) && defined(setjmp_undefined_for_visual_studio)
Jim Grosbach46445382009-04-17 23:30:55 +0000160// let's return it to _setjmp state in case anyone ever needs it after this
Chuck Rose IIIcc51c312008-04-15 21:27:11 +0000161// point under VisualStudio
Jim Grosbach46445382009-04-17 23:30:55 +0000162#define setjmp _setjmp
Chuck Rose IIIcc51c312008-04-15 21:27:11 +0000163#endif
164
Duncan Sandsa1220432008-04-07 13:41:19 +0000165 LongJmpFn = Intrinsic::getDeclaration(&M, Intrinsic::longjmp);
Chris Lattner6d784572004-02-08 19:53:56 +0000166 }
Jim Laskey7d485382007-02-22 16:21:18 +0000167
168 // We need the 'write' and 'abort' functions for both models.
169 AbortFn = M.getOrInsertFunction("abort", Type::VoidTy, (Type *)0);
Jeff Cohen09b362c2007-04-20 22:40:10 +0000170#if 0 // "write" is Unix-specific.. code is going away soon anyway.
Jim Laskey7d485382007-02-22 16:21:18 +0000171 WriteFn = M.getOrInsertFunction("write", Type::VoidTy, Type::Int32Ty,
172 VoidPtrTy, Type::Int32Ty, (Type *)0);
Jeff Cohen09b362c2007-04-20 22:40:10 +0000173#else
174 WriteFn = 0;
175#endif
Chris Lattner86e44452003-10-05 19:14:42 +0000176 return true;
177}
178
Chris Lattnerb76efb72007-01-07 08:12:01 +0000179void LowerInvoke::createAbortMessage(Module *M) {
Owen Andersone922c022009-07-22 00:24:57 +0000180 LLVMContext &Context = M->getContext();
181
Chris Lattner0c3b3902004-11-13 19:07:32 +0000182 if (ExpensiveEHSupport) {
183 // The abort message for expensive EH support tells the user that the
184 // program 'unwound' without an 'invoke' instruction.
185 Constant *Msg =
Owen Anderson1fd70962009-07-28 18:32:17 +0000186 ConstantArray::get("ERROR: Exception thrown, but not caught!\n");
Chris Lattner0c3b3902004-11-13 19:07:32 +0000187 AbortMessageLength = Msg->getNumOperands()-1; // don't include \0
Misha Brukmanfd939082005-04-21 23:48:37 +0000188
Owen Andersone9b11b42009-07-08 19:03:57 +0000189 GlobalVariable *MsgGV = new GlobalVariable(*M, Msg->getType(), true,
Chris Lattner0c3b3902004-11-13 19:07:32 +0000190 GlobalValue::InternalLinkage,
Owen Andersone9b11b42009-07-08 19:03:57 +0000191 Msg, "abortmsg");
Owen Andersone922c022009-07-22 00:24:57 +0000192 std::vector<Constant*> GEPIdx(2, Context.getNullValue(Type::Int32Ty));
Owen Andersonbaf3c402009-07-29 18:55:55 +0000193 AbortMessage = ConstantExpr::getGetElementPtr(MsgGV, &GEPIdx[0], 2);
Chris Lattner0c3b3902004-11-13 19:07:32 +0000194 } else {
195 // The abort message for cheap EH support tells the user that EH is not
196 // enabled.
197 Constant *Msg =
Owen Anderson1fd70962009-07-28 18:32:17 +0000198 ConstantArray::get("Exception handler needed, but not enabled."
Owen Anderson0a205a42009-07-05 22:41:43 +0000199 "Recompile program with -enable-correct-eh-support.\n");
Chris Lattner0c3b3902004-11-13 19:07:32 +0000200 AbortMessageLength = Msg->getNumOperands()-1; // don't include \0
201
Owen Andersone9b11b42009-07-08 19:03:57 +0000202 GlobalVariable *MsgGV = new GlobalVariable(*M, Msg->getType(), true,
Chris Lattner0c3b3902004-11-13 19:07:32 +0000203 GlobalValue::InternalLinkage,
Owen Andersone9b11b42009-07-08 19:03:57 +0000204 Msg, "abortmsg");
Owen Andersone922c022009-07-22 00:24:57 +0000205 std::vector<Constant*> GEPIdx(2, Context.getNullValue(Type::Int32Ty));
Chris Lattnerec1f7522007-02-19 07:34:47 +0000206 AbortMessage = ConstantExpr::getGetElementPtr(MsgGV, &GEPIdx[0], 2);
Chris Lattner0c3b3902004-11-13 19:07:32 +0000207 }
208}
209
210
Chris Lattner501825e2004-02-08 22:14:44 +0000211void LowerInvoke::writeAbortMessage(Instruction *IB) {
Jeff Cohen09b362c2007-04-20 22:40:10 +0000212#if 0
Chris Lattnerb76efb72007-01-07 08:12:01 +0000213 if (AbortMessage == 0)
214 createAbortMessage(IB->getParent()->getParent()->getParent());
Chris Lattner0c3b3902004-11-13 19:07:32 +0000215
Chris Lattnerb76efb72007-01-07 08:12:01 +0000216 // These are the arguments we WANT...
Chris Lattner93e985f2007-02-13 02:10:56 +0000217 Value* Args[3];
218 Args[0] = ConstantInt::get(Type::Int32Ty, 2);
219 Args[1] = AbortMessage;
220 Args[2] = ConstantInt::get(Type::Int32Ty, AbortMessageLength);
221 (new CallInst(WriteFn, Args, 3, "", IB))->setTailCall();
Jeff Cohen09b362c2007-04-20 22:40:10 +0000222#endif
Chris Lattner501825e2004-02-08 22:14:44 +0000223}
224
Chris Lattner6d784572004-02-08 19:53:56 +0000225bool LowerInvoke::insertCheapEHSupport(Function &F) {
Owen Andersone922c022009-07-22 00:24:57 +0000226 LLVMContext &Context = F.getContext();
Chris Lattner86e44452003-10-05 19:14:42 +0000227 bool Changed = false;
Chris Lattnerdead9932003-12-10 20:22:42 +0000228 for (Function::iterator BB = F.begin(), E = F.end(); BB != E; ++BB)
229 if (InvokeInst *II = dyn_cast<InvokeInst>(BB->getTerminator())) {
Bill Wendling9a507cd2009-03-13 21:15:59 +0000230 std::vector<Value*> CallArgs(II->op_begin()+3, II->op_end());
Chris Lattner86e44452003-10-05 19:14:42 +0000231 // Insert a normal call instruction...
Gabor Greif051a9502008-04-06 20:25:17 +0000232 CallInst *NewCall = CallInst::Create(II->getCalledValue(),
233 CallArgs.begin(), CallArgs.end(), "",II);
Chris Lattner86cc4232007-02-11 01:37:51 +0000234 NewCall->takeName(II);
Chris Lattnerefd91682005-05-13 06:27:02 +0000235 NewCall->setCallingConv(II->getCallingConv());
Devang Patel05988662008-09-25 21:00:45 +0000236 NewCall->setAttributes(II->getAttributes());
Chris Lattner86e44452003-10-05 19:14:42 +0000237 II->replaceAllUsesWith(NewCall);
Misha Brukmanfd939082005-04-21 23:48:37 +0000238
Chris Lattnerdead9932003-12-10 20:22:42 +0000239 // Insert an unconditional branch to the normal destination.
Gabor Greif051a9502008-04-06 20:25:17 +0000240 BranchInst::Create(II->getNormalDest(), II);
Chris Lattner86e44452003-10-05 19:14:42 +0000241
Chris Lattnerdead9932003-12-10 20:22:42 +0000242 // Remove any PHI node entries from the exception destination.
Chris Lattneraeb2a1d2004-02-08 21:44:31 +0000243 II->getUnwindDest()->removePredecessor(BB);
Chris Lattnerdead9932003-12-10 20:22:42 +0000244
Chris Lattner86e44452003-10-05 19:14:42 +0000245 // Remove the invoke instruction now.
Chris Lattnerdead9932003-12-10 20:22:42 +0000246 BB->getInstList().erase(II);
Chris Lattner86e44452003-10-05 19:14:42 +0000247
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000248 ++NumInvokes; Changed = true;
Chris Lattnerdead9932003-12-10 20:22:42 +0000249 } else if (UnwindInst *UI = dyn_cast<UnwindInst>(BB->getTerminator())) {
Chris Lattnere1c09302004-02-08 07:30:29 +0000250 // Insert a new call to write(2, AbortMessage, AbortMessageLength);
Chris Lattner501825e2004-02-08 22:14:44 +0000251 writeAbortMessage(UI);
Chris Lattnere1c09302004-02-08 07:30:29 +0000252
Chris Lattner86e44452003-10-05 19:14:42 +0000253 // Insert a call to abort()
Gabor Greif051a9502008-04-06 20:25:17 +0000254 CallInst::Create(AbortFn, "", UI)->setTailCall();
Chris Lattner86e44452003-10-05 19:14:42 +0000255
Chris Lattner6d784572004-02-08 19:53:56 +0000256 // Insert a return instruction. This really should be a "barrier", as it
257 // is unreachable.
Gabor Greif051a9502008-04-06 20:25:17 +0000258 ReturnInst::Create(F.getReturnType() == Type::VoidTy ? 0 :
Owen Andersone922c022009-07-22 00:24:57 +0000259 Context.getNullValue(F.getReturnType()), UI);
Chris Lattner86e44452003-10-05 19:14:42 +0000260
261 // Remove the unwind instruction now.
Chris Lattnerdead9932003-12-10 20:22:42 +0000262 BB->getInstList().erase(UI);
Chris Lattner86e44452003-10-05 19:14:42 +0000263
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000264 ++NumUnwinds; Changed = true;
Chris Lattner86e44452003-10-05 19:14:42 +0000265 }
266 return Changed;
267}
Chris Lattner6d784572004-02-08 19:53:56 +0000268
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000269/// rewriteExpensiveInvoke - Insert code and hack the function to replace the
270/// specified invoke instruction with a call.
271void LowerInvoke::rewriteExpensiveInvoke(InvokeInst *II, unsigned InvokeNo,
272 AllocaInst *InvokeNum,
273 SwitchInst *CatchSwitch) {
Owen Andersone922c022009-07-22 00:24:57 +0000274 LLVMContext &Context = II->getContext();
Owen Andersoneed707b2009-07-24 23:12:02 +0000275 ConstantInt *InvokeNoC = ConstantInt::get(Type::Int32Ty, InvokeNo);
Chris Lattner6d784572004-02-08 19:53:56 +0000276
Chris Lattner8c5c22f2008-02-14 19:18:13 +0000277 // If the unwind edge has phi nodes, split the edge.
278 if (isa<PHINode>(II->getUnwindDest()->begin())) {
279 SplitCriticalEdge(II, 1, this);
Jim Grosbach46445382009-04-17 23:30:55 +0000280
Chris Lattner8c5c22f2008-02-14 19:18:13 +0000281 // If there are any phi nodes left, they must have a single predecessor.
282 while (PHINode *PN = dyn_cast<PHINode>(II->getUnwindDest()->begin())) {
283 PN->replaceAllUsesWith(PN->getIncomingValue(0));
284 PN->eraseFromParent();
285 }
286 }
Jim Grosbach46445382009-04-17 23:30:55 +0000287
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000288 // Insert a store of the invoke num before the invoke and store zero into the
289 // location afterward.
290 new StoreInst(InvokeNoC, InvokeNum, true, II); // volatile
Jim Grosbach46445382009-04-17 23:30:55 +0000291
Dan Gohman02dea8b2008-05-23 21:05:58 +0000292 BasicBlock::iterator NI = II->getNormalDest()->getFirstNonPHI();
Chris Lattner93e50ce2005-09-29 17:44:20 +0000293 // nonvolatile.
Owen Andersone922c022009-07-22 00:24:57 +0000294 new StoreInst(Context.getNullValue(Type::Int32Ty), InvokeNum, false, NI);
Jim Grosbach46445382009-04-17 23:30:55 +0000295
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000296 // Add a switch case to our unwind block.
297 CatchSwitch->addCase(InvokeNoC, II->getUnwindDest());
Jim Grosbach46445382009-04-17 23:30:55 +0000298
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000299 // Insert a normal call instruction.
Bill Wendling9a507cd2009-03-13 21:15:59 +0000300 std::vector<Value*> CallArgs(II->op_begin()+3, II->op_end());
Gabor Greif051a9502008-04-06 20:25:17 +0000301 CallInst *NewCall = CallInst::Create(II->getCalledValue(),
302 CallArgs.begin(), CallArgs.end(), "",
303 II);
Chris Lattner86cc4232007-02-11 01:37:51 +0000304 NewCall->takeName(II);
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000305 NewCall->setCallingConv(II->getCallingConv());
Devang Patel05988662008-09-25 21:00:45 +0000306 NewCall->setAttributes(II->getAttributes());
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000307 II->replaceAllUsesWith(NewCall);
Jim Grosbach46445382009-04-17 23:30:55 +0000308
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000309 // Replace the invoke with an uncond branch.
Gabor Greif051a9502008-04-06 20:25:17 +0000310 BranchInst::Create(II->getNormalDest(), NewCall->getParent());
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000311 II->eraseFromParent();
312}
Chris Lattner6d784572004-02-08 19:53:56 +0000313
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000314/// MarkBlocksLiveIn - Insert BB and all of its predescessors into LiveBBs until
315/// we reach blocks we've already seen.
316static void MarkBlocksLiveIn(BasicBlock *BB, std::set<BasicBlock*> &LiveBBs) {
317 if (!LiveBBs.insert(BB).second) return; // already been here.
Jim Grosbach46445382009-04-17 23:30:55 +0000318
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000319 for (pred_iterator PI = pred_begin(BB), E = pred_end(BB); PI != E; ++PI)
Jim Grosbach46445382009-04-17 23:30:55 +0000320 MarkBlocksLiveIn(*PI, LiveBBs);
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000321}
Chris Lattner6d784572004-02-08 19:53:56 +0000322
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000323// First thing we need to do is scan the whole function for values that are
324// live across unwind edges. Each value that is live across an unwind edge
325// we spill into a stack location, guaranteeing that there is nothing live
326// across the unwind edge. This process also splits all critical edges
327// coming out of invoke's.
328void LowerInvoke::
329splitLiveRangesLiveAcrossInvokes(std::vector<InvokeInst*> &Invokes) {
330 // First step, split all critical edges from invoke instructions.
331 for (unsigned i = 0, e = Invokes.size(); i != e; ++i) {
332 InvokeInst *II = Invokes[i];
333 SplitCriticalEdge(II, 0, this);
334 SplitCriticalEdge(II, 1, this);
335 assert(!isa<PHINode>(II->getNormalDest()) &&
336 !isa<PHINode>(II->getUnwindDest()) &&
337 "critical edge splitting left single entry phi nodes?");
Chris Lattner6d784572004-02-08 19:53:56 +0000338 }
339
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000340 Function *F = Invokes.back()->getParent()->getParent();
Jim Grosbach46445382009-04-17 23:30:55 +0000341
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000342 // To avoid having to handle incoming arguments specially, we lower each arg
Reid Spencer3da59db2006-11-27 01:05:10 +0000343 // to a copy instruction in the entry block. This ensures that the argument
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000344 // value itself cannot be live across the entry block.
345 BasicBlock::iterator AfterAllocaInsertPt = F->begin()->begin();
346 while (isa<AllocaInst>(AfterAllocaInsertPt) &&
347 isa<ConstantInt>(cast<AllocaInst>(AfterAllocaInsertPt)->getArraySize()))
348 ++AfterAllocaInsertPt;
349 for (Function::arg_iterator AI = F->arg_begin(), E = F->arg_end();
350 AI != E; ++AI) {
Reid Spencer3da59db2006-11-27 01:05:10 +0000351 // This is always a no-op cast because we're casting AI to AI->getType() so
352 // src and destination types are identical. BitCast is the only possibility.
353 CastInst *NC = new BitCastInst(
354 AI, AI->getType(), AI->getName()+".tmp", AfterAllocaInsertPt);
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000355 AI->replaceAllUsesWith(NC);
Reid Spencer3da59db2006-11-27 01:05:10 +0000356 // Normally its is forbidden to replace a CastInst's operand because it
357 // could cause the opcode to reflect an illegal conversion. However, we're
358 // replacing it here with the same value it was constructed with to simply
359 // make NC its user.
Jim Grosbach46445382009-04-17 23:30:55 +0000360 NC->setOperand(0, AI);
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000361 }
Jim Grosbach46445382009-04-17 23:30:55 +0000362
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000363 // Finally, scan the code looking for instructions with bad live ranges.
364 for (Function::iterator BB = F->begin(), E = F->end(); BB != E; ++BB)
365 for (BasicBlock::iterator II = BB->begin(), E = BB->end(); II != E; ++II) {
366 // Ignore obvious cases we don't have to handle. In particular, most
367 // instructions either have no uses or only have a single use inside the
368 // current block. Ignore them quickly.
369 Instruction *Inst = II;
370 if (Inst->use_empty()) continue;
371 if (Inst->hasOneUse() &&
372 cast<Instruction>(Inst->use_back())->getParent() == BB &&
373 !isa<PHINode>(Inst->use_back())) continue;
Jim Grosbach46445382009-04-17 23:30:55 +0000374
Chris Lattner45313712005-09-27 21:33:12 +0000375 // If this is an alloca in the entry block, it's not a real register
376 // value.
377 if (AllocaInst *AI = dyn_cast<AllocaInst>(Inst))
378 if (isa<ConstantInt>(AI->getArraySize()) && BB == F->begin())
379 continue;
Jim Grosbach46445382009-04-17 23:30:55 +0000380
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000381 // Avoid iterator invalidation by copying users to a temporary vector.
382 std::vector<Instruction*> Users;
383 for (Value::use_iterator UI = Inst->use_begin(), E = Inst->use_end();
384 UI != E; ++UI) {
385 Instruction *User = cast<Instruction>(*UI);
386 if (User->getParent() != BB || isa<PHINode>(User))
387 Users.push_back(User);
388 }
389
390 // Scan all of the uses and see if the live range is live across an unwind
391 // edge. If we find a use live across an invoke edge, create an alloca
392 // and spill the value.
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000393 std::set<InvokeInst*> InvokesWithStoreInserted;
394
395 // Find all of the blocks that this value is live in.
396 std::set<BasicBlock*> LiveBBs;
397 LiveBBs.insert(Inst->getParent());
398 while (!Users.empty()) {
399 Instruction *U = Users.back();
400 Users.pop_back();
Jim Grosbach46445382009-04-17 23:30:55 +0000401
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000402 if (!isa<PHINode>(U)) {
403 MarkBlocksLiveIn(U->getParent(), LiveBBs);
404 } else {
405 // Uses for a PHI node occur in their predecessor block.
406 PHINode *PN = cast<PHINode>(U);
407 for (unsigned i = 0, e = PN->getNumIncomingValues(); i != e; ++i)
408 if (PN->getIncomingValue(i) == Inst)
409 MarkBlocksLiveIn(PN->getIncomingBlock(i), LiveBBs);
410 }
411 }
Jim Grosbach46445382009-04-17 23:30:55 +0000412
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000413 // Now that we know all of the blocks that this thing is live in, see if
414 // it includes any of the unwind locations.
415 bool NeedsSpill = false;
416 for (unsigned i = 0, e = Invokes.size(); i != e; ++i) {
417 BasicBlock *UnwindBlock = Invokes[i]->getUnwindDest();
418 if (UnwindBlock != BB && LiveBBs.count(UnwindBlock)) {
419 NeedsSpill = true;
420 }
421 }
422
423 // If we decided we need a spill, do it.
424 if (NeedsSpill) {
425 ++NumSpilled;
Owen Anderson50dead02009-07-15 23:53:25 +0000426 DemoteRegToStack(*Inst, true);
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000427 }
428 }
429}
430
431bool LowerInvoke::insertExpensiveEHSupport(Function &F) {
432 std::vector<ReturnInst*> Returns;
433 std::vector<UnwindInst*> Unwinds;
434 std::vector<InvokeInst*> Invokes;
435
Owen Andersone922c022009-07-22 00:24:57 +0000436 LLVMContext &Context = F.getContext();
437
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000438 for (Function::iterator BB = F.begin(), E = F.end(); BB != E; ++BB)
439 if (ReturnInst *RI = dyn_cast<ReturnInst>(BB->getTerminator())) {
440 // Remember all return instructions in case we insert an invoke into this
441 // function.
442 Returns.push_back(RI);
443 } else if (InvokeInst *II = dyn_cast<InvokeInst>(BB->getTerminator())) {
444 Invokes.push_back(II);
445 } else if (UnwindInst *UI = dyn_cast<UnwindInst>(BB->getTerminator())) {
446 Unwinds.push_back(UI);
447 }
448
449 if (Unwinds.empty() && Invokes.empty()) return false;
450
451 NumInvokes += Invokes.size();
452 NumUnwinds += Unwinds.size();
Jim Grosbach46445382009-04-17 23:30:55 +0000453
Chris Lattner5b3c7022005-09-27 22:44:59 +0000454 // TODO: This is not an optimal way to do this. In particular, this always
455 // inserts setjmp calls into the entries of functions with invoke instructions
456 // even though there are possibly paths through the function that do not
457 // execute any invokes. In particular, for functions with early exits, e.g.
458 // the 'addMove' method in hexxagon, it would be nice to not have to do the
459 // setjmp stuff on the early exit path. This requires a bit of dataflow, but
460 // would not be too hard to do.
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000461
462 // If we have an invoke instruction, insert a setjmp that dominates all
463 // invokes. After the setjmp, use a cond branch that goes to the original
464 // code path on zero, and to a designated 'catch' block of nonzero.
465 Value *OldJmpBufPtr = 0;
466 if (!Invokes.empty()) {
467 // First thing we need to do is scan the whole function for values that are
468 // live across unwind edges. Each value that is live across an unwind edge
469 // we spill into a stack location, guaranteeing that there is nothing live
470 // across the unwind edge. This process also splits all critical edges
471 // coming out of invoke's.
Jim Grosbach46445382009-04-17 23:30:55 +0000472 splitLiveRangesLiveAcrossInvokes(Invokes);
473
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000474 BasicBlock *EntryBB = F.begin();
Jim Grosbach46445382009-04-17 23:30:55 +0000475
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000476 // Create an alloca for the incoming jump buffer ptr and the new jump buffer
477 // that needs to be restored on all exits from the function. This is an
478 // alloca because the value needs to be live across invokes.
Chris Lattner97d2dbd2006-09-05 17:48:07 +0000479 unsigned Align = TLI ? TLI->getJumpBufAlignment() : 0;
Jim Grosbach46445382009-04-17 23:30:55 +0000480 AllocaInst *JmpBuf =
Owen Anderson50dead02009-07-15 23:53:25 +0000481 new AllocaInst(JBLinkTy, 0, Align,
Owen Anderson9adc0ab2009-07-14 23:09:55 +0000482 "jblink", F.begin()->begin());
Jim Grosbach46445382009-04-17 23:30:55 +0000483
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000484 std::vector<Value*> Idx;
Owen Andersone922c022009-07-22 00:24:57 +0000485 Idx.push_back(Context.getNullValue(Type::Int32Ty));
Owen Andersoneed707b2009-07-24 23:12:02 +0000486 Idx.push_back(ConstantInt::get(Type::Int32Ty, 1));
Gabor Greif051a9502008-04-06 20:25:17 +0000487 OldJmpBufPtr = GetElementPtrInst::Create(JmpBuf, Idx.begin(), Idx.end(),
Owen Anderson9adc0ab2009-07-14 23:09:55 +0000488 "OldBuf",
489 EntryBB->getTerminator());
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000490
491 // Copy the JBListHead to the alloca.
492 Value *OldBuf = new LoadInst(JBListHead, "oldjmpbufptr", true,
493 EntryBB->getTerminator());
494 new StoreInst(OldBuf, OldJmpBufPtr, true, EntryBB->getTerminator());
Jim Grosbach46445382009-04-17 23:30:55 +0000495
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000496 // Add the new jumpbuf to the list.
497 new StoreInst(JmpBuf, JBListHead, true, EntryBB->getTerminator());
498
499 // Create the catch block. The catch block is basically a big switch
500 // statement that goes to all of the invoke catch blocks.
Gabor Greif051a9502008-04-06 20:25:17 +0000501 BasicBlock *CatchBB = BasicBlock::Create("setjmp.catch", &F);
Jim Grosbach46445382009-04-17 23:30:55 +0000502
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000503 // Create an alloca which keeps track of which invoke is currently
504 // executing. For normal calls it contains zero.
Owen Anderson50dead02009-07-15 23:53:25 +0000505 AllocaInst *InvokeNum = new AllocaInst(Type::Int32Ty, 0,
Owen Anderson9adc0ab2009-07-14 23:09:55 +0000506 "invokenum",EntryBB->begin());
Owen Andersoneed707b2009-07-24 23:12:02 +0000507 new StoreInst(ConstantInt::get(Type::Int32Ty, 0), InvokeNum, true,
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000508 EntryBB->getTerminator());
Jim Grosbach46445382009-04-17 23:30:55 +0000509
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000510 // Insert a load in the Catch block, and a switch on its value. By default,
511 // we go to a block that just does an unwind (which is the correct action
512 // for a standard call).
Gabor Greif051a9502008-04-06 20:25:17 +0000513 BasicBlock *UnwindBB = BasicBlock::Create("unwindbb", &F);
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000514 Unwinds.push_back(new UnwindInst(UnwindBB));
Jim Grosbach46445382009-04-17 23:30:55 +0000515
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000516 Value *CatchLoad = new LoadInst(InvokeNum, "invoke.num", true, CatchBB);
Gabor Greif051a9502008-04-06 20:25:17 +0000517 SwitchInst *CatchSwitch =
518 SwitchInst::Create(CatchLoad, UnwindBB, Invokes.size(), CatchBB);
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000519
520 // Now that things are set up, insert the setjmp call itself.
Jim Grosbach46445382009-04-17 23:30:55 +0000521
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000522 // Split the entry block to insert the conditional branch for the setjmp.
523 BasicBlock *ContBlock = EntryBB->splitBasicBlock(EntryBB->getTerminator(),
524 "setjmp.cont");
525
Owen Andersoneed707b2009-07-24 23:12:02 +0000526 Idx[1] = ConstantInt::get(Type::Int32Ty, 0);
Gabor Greif051a9502008-04-06 20:25:17 +0000527 Value *JmpBufPtr = GetElementPtrInst::Create(JmpBuf, Idx.begin(), Idx.end(),
528 "TheJmpBuf",
529 EntryBB->getTerminator());
Duncan Sandsa1220432008-04-07 13:41:19 +0000530 JmpBufPtr = new BitCastInst(JmpBufPtr, PointerType::getUnqual(Type::Int8Ty),
531 "tmp", EntryBB->getTerminator());
Gabor Greif051a9502008-04-06 20:25:17 +0000532 Value *SJRet = CallInst::Create(SetJmpFn, JmpBufPtr, "sjret",
533 EntryBB->getTerminator());
Duncan Sandsa1220432008-04-07 13:41:19 +0000534
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000535 // Compare the return value to zero.
Owen Anderson333c4002009-07-09 23:48:35 +0000536 Value *IsNormal = new ICmpInst(EntryBB->getTerminator(),
537 ICmpInst::ICMP_EQ, SJRet,
Owen Andersone922c022009-07-22 00:24:57 +0000538 Context.getNullValue(SJRet->getType()),
Owen Anderson333c4002009-07-09 23:48:35 +0000539 "notunwind");
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000540 // Nuke the uncond branch.
541 EntryBB->getTerminator()->eraseFromParent();
Jim Grosbach46445382009-04-17 23:30:55 +0000542
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000543 // Put in a new condbranch in its place.
Gabor Greif051a9502008-04-06 20:25:17 +0000544 BranchInst::Create(ContBlock, CatchBB, IsNormal, EntryBB);
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000545
546 // At this point, we are all set up, rewrite each invoke instruction.
547 for (unsigned i = 0, e = Invokes.size(); i != e; ++i)
548 rewriteExpensiveInvoke(Invokes[i], i+1, InvokeNum, CatchSwitch);
549 }
550
551 // We know that there is at least one unwind.
Jim Grosbach46445382009-04-17 23:30:55 +0000552
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000553 // Create three new blocks, the block to load the jmpbuf ptr and compare
554 // against null, the block to do the longjmp, and the error block for if it
555 // is null. Add them at the end of the function because they are not hot.
Gabor Greif051a9502008-04-06 20:25:17 +0000556 BasicBlock *UnwindHandler = BasicBlock::Create("dounwind", &F);
557 BasicBlock *UnwindBlock = BasicBlock::Create("unwind", &F);
558 BasicBlock *TermBlock = BasicBlock::Create("unwinderror", &F);
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000559
560 // If this function contains an invoke, restore the old jumpbuf ptr.
561 Value *BufPtr;
562 if (OldJmpBufPtr) {
563 // Before the return, insert a copy from the saved value to the new value.
564 BufPtr = new LoadInst(OldJmpBufPtr, "oldjmpbufptr", UnwindHandler);
565 new StoreInst(BufPtr, JBListHead, UnwindHandler);
566 } else {
567 BufPtr = new LoadInst(JBListHead, "ehlist", UnwindHandler);
568 }
Jim Grosbach46445382009-04-17 23:30:55 +0000569
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000570 // Load the JBList, if it's null, then there was no catch!
Owen Anderson333c4002009-07-09 23:48:35 +0000571 Value *NotNull = new ICmpInst(*UnwindHandler, ICmpInst::ICMP_NE, BufPtr,
Owen Andersone922c022009-07-22 00:24:57 +0000572 Context.getNullValue(BufPtr->getType()),
Owen Anderson333c4002009-07-09 23:48:35 +0000573 "notnull");
Gabor Greif051a9502008-04-06 20:25:17 +0000574 BranchInst::Create(UnwindBlock, TermBlock, NotNull, UnwindHandler);
Jim Grosbach46445382009-04-17 23:30:55 +0000575
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000576 // Create the block to do the longjmp.
577 // Get a pointer to the jmpbuf and longjmp.
578 std::vector<Value*> Idx;
Owen Andersone922c022009-07-22 00:24:57 +0000579 Idx.push_back(Context.getNullValue(Type::Int32Ty));
Owen Andersoneed707b2009-07-24 23:12:02 +0000580 Idx.push_back(ConstantInt::get(Type::Int32Ty, 0));
Gabor Greif051a9502008-04-06 20:25:17 +0000581 Idx[0] = GetElementPtrInst::Create(BufPtr, Idx.begin(), Idx.end(), "JmpBuf",
582 UnwindBlock);
Duncan Sandsa1220432008-04-07 13:41:19 +0000583 Idx[0] = new BitCastInst(Idx[0], PointerType::getUnqual(Type::Int8Ty),
584 "tmp", UnwindBlock);
Owen Andersoneed707b2009-07-24 23:12:02 +0000585 Idx[1] = ConstantInt::get(Type::Int32Ty, 1);
Gabor Greif051a9502008-04-06 20:25:17 +0000586 CallInst::Create(LongJmpFn, Idx.begin(), Idx.end(), "", UnwindBlock);
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000587 new UnreachableInst(UnwindBlock);
Jim Grosbach46445382009-04-17 23:30:55 +0000588
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000589 // Set up the term block ("throw without a catch").
590 new UnreachableInst(TermBlock);
591
592 // Insert a new call to write(2, AbortMessage, AbortMessageLength);
593 writeAbortMessage(TermBlock->getTerminator());
Jim Grosbach46445382009-04-17 23:30:55 +0000594
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000595 // Insert a call to abort()
Gabor Greif051a9502008-04-06 20:25:17 +0000596 CallInst::Create(AbortFn, "",
597 TermBlock->getTerminator())->setTailCall();
Jim Grosbach46445382009-04-17 23:30:55 +0000598
599
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000600 // Replace all unwinds with a branch to the unwind handler.
601 for (unsigned i = 0, e = Unwinds.size(); i != e; ++i) {
Gabor Greif051a9502008-04-06 20:25:17 +0000602 BranchInst::Create(UnwindHandler, Unwinds[i]);
Jim Grosbach46445382009-04-17 23:30:55 +0000603 Unwinds[i]->eraseFromParent();
604 }
605
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000606 // Finally, for any returns from this function, if this function contains an
607 // invoke, restore the old jmpbuf pointer to its input value.
608 if (OldJmpBufPtr) {
609 for (unsigned i = 0, e = Returns.size(); i != e; ++i) {
610 ReturnInst *R = Returns[i];
Jim Grosbach46445382009-04-17 23:30:55 +0000611
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000612 // Before the return, insert a copy from the saved value to the new value.
613 Value *OldBuf = new LoadInst(OldJmpBufPtr, "oldjmpbufptr", true, R);
614 new StoreInst(OldBuf, JBListHead, true, R);
615 }
616 }
Jim Grosbach46445382009-04-17 23:30:55 +0000617
Chris Lattnerf4e6c3a2005-09-27 21:18:17 +0000618 return true;
Chris Lattner6d784572004-02-08 19:53:56 +0000619}
620
621bool LowerInvoke::runOnFunction(Function &F) {
622 if (ExpensiveEHSupport)
623 return insertExpensiveEHSupport(F);
624 else
625 return insertCheapEHSupport(F);
626}