LLVM 19.0.0git
CodeExtractor.cpp
Go to the documentation of this file.
1//===- CodeExtractor.cpp - Pull code region into a new function -----------===//
2//
3// 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
6//
7//===----------------------------------------------------------------------===//
8//
9// This file implements the interface to tear out a code region, such as an
10// individual loop or a parallel section, into a new function, replacing it with
11// a call to the new function.
12//
13//===----------------------------------------------------------------------===//
14
16#include "llvm/ADT/ArrayRef.h"
17#include "llvm/ADT/DenseMap.h"
18#include "llvm/ADT/STLExtras.h"
19#include "llvm/ADT/SetVector.h"
27#include "llvm/IR/Argument.h"
28#include "llvm/IR/Attributes.h"
29#include "llvm/IR/BasicBlock.h"
30#include "llvm/IR/CFG.h"
31#include "llvm/IR/Constant.h"
32#include "llvm/IR/Constants.h"
33#include "llvm/IR/DIBuilder.h"
34#include "llvm/IR/DataLayout.h"
35#include "llvm/IR/DebugInfo.h"
38#include "llvm/IR/Dominators.h"
39#include "llvm/IR/Function.h"
40#include "llvm/IR/GlobalValue.h"
42#include "llvm/IR/InstrTypes.h"
43#include "llvm/IR/Instruction.h"
46#include "llvm/IR/Intrinsics.h"
47#include "llvm/IR/LLVMContext.h"
48#include "llvm/IR/MDBuilder.h"
49#include "llvm/IR/Module.h"
51#include "llvm/IR/Type.h"
52#include "llvm/IR/User.h"
53#include "llvm/IR/Value.h"
54#include "llvm/IR/Verifier.h"
59#include "llvm/Support/Debug.h"
63#include <cassert>
64#include <cstdint>
65#include <iterator>
66#include <map>
67#include <utility>
68#include <vector>
69
70using namespace llvm;
71using namespace llvm::PatternMatch;
73
74#define DEBUG_TYPE "code-extractor"
75
76// Provide a command-line option to aggregate function arguments into a struct
77// for functions produced by the code extractor. This is useful when converting
78// extracted functions to pthread-based code, as only one argument (void*) can
79// be passed in to pthread_create().
80static cl::opt<bool>
81AggregateArgsOpt("aggregate-extracted-args", cl::Hidden,
82 cl::desc("Aggregate arguments to code-extracted functions"));
83
84/// Test whether a block is valid for extraction.
86 const SetVector<BasicBlock *> &Result,
87 bool AllowVarArgs, bool AllowAlloca) {
88 // taking the address of a basic block moved to another function is illegal
89 if (BB.hasAddressTaken())
90 return false;
91
92 // don't hoist code that uses another basicblock address, as it's likely to
93 // lead to unexpected behavior, like cross-function jumps
96
97 for (Instruction const &Inst : BB)
98 ToVisit.push_back(&Inst);
99
100 while (!ToVisit.empty()) {
101 User const *Curr = ToVisit.pop_back_val();
102 if (!Visited.insert(Curr).second)
103 continue;
104 if (isa<BlockAddress const>(Curr))
105 return false; // even a reference to self is likely to be not compatible
106
107 if (isa<Instruction>(Curr) && cast<Instruction>(Curr)->getParent() != &BB)
108 continue;
109
110 for (auto const &U : Curr->operands()) {
111 if (auto *UU = dyn_cast<User>(U))
112 ToVisit.push_back(UU);
113 }
114 }
115
116 // If explicitly requested, allow vastart and alloca. For invoke instructions
117 // verify that extraction is valid.
118 for (BasicBlock::const_iterator I = BB.begin(), E = BB.end(); I != E; ++I) {
119 if (isa<AllocaInst>(I)) {
120 if (!AllowAlloca)
121 return false;
122 continue;
123 }
124
125 if (const auto *II = dyn_cast<InvokeInst>(I)) {
126 // Unwind destination (either a landingpad, catchswitch, or cleanuppad)
127 // must be a part of the subgraph which is being extracted.
128 if (auto *UBB = II->getUnwindDest())
129 if (!Result.count(UBB))
130 return false;
131 continue;
132 }
133
134 // All catch handlers of a catchswitch instruction as well as the unwind
135 // destination must be in the subgraph.
136 if (const auto *CSI = dyn_cast<CatchSwitchInst>(I)) {
137 if (auto *UBB = CSI->getUnwindDest())
138 if (!Result.count(UBB))
139 return false;
140 for (const auto *HBB : CSI->handlers())
141 if (!Result.count(const_cast<BasicBlock*>(HBB)))
142 return false;
143 continue;
144 }
145
146 // Make sure that entire catch handler is within subgraph. It is sufficient
147 // to check that catch return's block is in the list.
148 if (const auto *CPI = dyn_cast<CatchPadInst>(I)) {
149 for (const auto *U : CPI->users())
150 if (const auto *CRI = dyn_cast<CatchReturnInst>(U))
151 if (!Result.count(const_cast<BasicBlock*>(CRI->getParent())))
152 return false;
153 continue;
154 }
155
156 // And do similar checks for cleanup handler - the entire handler must be
157 // in subgraph which is going to be extracted. For cleanup return should
158 // additionally check that the unwind destination is also in the subgraph.
159 if (const auto *CPI = dyn_cast<CleanupPadInst>(I)) {
160 for (const auto *U : CPI->users())
161 if (const auto *CRI = dyn_cast<CleanupReturnInst>(U))
162 if (!Result.count(const_cast<BasicBlock*>(CRI->getParent())))
163 return false;
164 continue;
165 }
166 if (const auto *CRI = dyn_cast<CleanupReturnInst>(I)) {
167 if (auto *UBB = CRI->getUnwindDest())
168 if (!Result.count(UBB))
169 return false;
170 continue;
171 }
172
173 if (const CallInst *CI = dyn_cast<CallInst>(I)) {
174 if (const Function *F = CI->getCalledFunction()) {
175 auto IID = F->getIntrinsicID();
176 if (IID == Intrinsic::vastart) {
177 if (AllowVarArgs)
178 continue;
179 else
180 return false;
181 }
182
183 // Currently, we miscompile outlined copies of eh_typid_for. There are
184 // proposals for fixing this in llvm.org/PR39545.
185 if (IID == Intrinsic::eh_typeid_for)
186 return false;
187 }
188 }
189 }
190
191 return true;
192}
193
194/// Build a set of blocks to extract if the input blocks are viable.
197 bool AllowVarArgs, bool AllowAlloca) {
198 assert(!BBs.empty() && "The set of blocks to extract must be non-empty");
200
201 // Loop over the blocks, adding them to our set-vector, and aborting with an
202 // empty set if we encounter invalid blocks.
203 for (BasicBlock *BB : BBs) {
204 // If this block is dead, don't process it.
205 if (DT && !DT->isReachableFromEntry(BB))
206 continue;
207
208 if (!Result.insert(BB))
209 llvm_unreachable("Repeated basic blocks in extraction input");
210 }
211
212 LLVM_DEBUG(dbgs() << "Region front block: " << Result.front()->getName()
213 << '\n');
214
215 for (auto *BB : Result) {
216 if (!isBlockValidForExtraction(*BB, Result, AllowVarArgs, AllowAlloca))
217 return {};
218
219 // Make sure that the first block is not a landing pad.
220 if (BB == Result.front()) {
221 if (BB->isEHPad()) {
222 LLVM_DEBUG(dbgs() << "The first block cannot be an unwind block\n");
223 return {};
224 }
225 continue;
226 }
227
228 // All blocks other than the first must not have predecessors outside of
229 // the subgraph which is being extracted.
230 for (auto *PBB : predecessors(BB))
231 if (!Result.count(PBB)) {
232 LLVM_DEBUG(dbgs() << "No blocks in this region may have entries from "
233 "outside the region except for the first block!\n"
234 << "Problematic source BB: " << BB->getName() << "\n"
235 << "Problematic destination BB: " << PBB->getName()
236 << "\n");
237 return {};
238 }
239 }
240
241 return Result;
242}
243
245 bool AggregateArgs, BlockFrequencyInfo *BFI,
247 bool AllowVarArgs, bool AllowAlloca,
248 BasicBlock *AllocationBlock, std::string Suffix,
249 bool ArgsInZeroAddressSpace)
250 : DT(DT), AggregateArgs(AggregateArgs || AggregateArgsOpt), BFI(BFI),
251 BPI(BPI), AC(AC), AllocationBlock(AllocationBlock),
252 AllowVarArgs(AllowVarArgs),
253 Blocks(buildExtractionBlockSet(BBs, DT, AllowVarArgs, AllowAlloca)),
254 Suffix(Suffix), ArgsInZeroAddressSpace(ArgsInZeroAddressSpace) {}
255
259 std::string Suffix)
260 : DT(&DT), AggregateArgs(AggregateArgs || AggregateArgsOpt), BFI(BFI),
261 BPI(BPI), AC(AC), AllocationBlock(nullptr), AllowVarArgs(false),
262 Blocks(buildExtractionBlockSet(L.getBlocks(), &DT,
263 /* AllowVarArgs */ false,
264 /* AllowAlloca */ false)),
265 Suffix(Suffix) {}
266
267/// definedInRegion - Return true if the specified value is defined in the
268/// extracted region.
270 if (Instruction *I = dyn_cast<Instruction>(V))
271 if (Blocks.count(I->getParent()))
272 return true;
273 return false;
274}
275
276/// definedInCaller - Return true if the specified value is defined in the
277/// function being code extracted, but not in the region being extracted.
278/// These values must be passed in as live-ins to the function.
280 if (isa<Argument>(V)) return true;
281 if (Instruction *I = dyn_cast<Instruction>(V))
282 if (!Blocks.count(I->getParent()))
283 return true;
284 return false;
285}
286
288 BasicBlock *CommonExitBlock = nullptr;
289 auto hasNonCommonExitSucc = [&](BasicBlock *Block) {
290 for (auto *Succ : successors(Block)) {
291 // Internal edges, ok.
292 if (Blocks.count(Succ))
293 continue;
294 if (!CommonExitBlock) {
295 CommonExitBlock = Succ;
296 continue;
297 }
298 if (CommonExitBlock != Succ)
299 return true;
300 }
301 return false;
302 };
303
304 if (any_of(Blocks, hasNonCommonExitSucc))
305 return nullptr;
306
307 return CommonExitBlock;
308}
309
311 for (BasicBlock &BB : F) {
312 for (Instruction &II : BB.instructionsWithoutDebug())
313 if (auto *AI = dyn_cast<AllocaInst>(&II))
314 Allocas.push_back(AI);
315
316 findSideEffectInfoForBlock(BB);
317 }
318}
319
320void CodeExtractorAnalysisCache::findSideEffectInfoForBlock(BasicBlock &BB) {
322 unsigned Opcode = II.getOpcode();
323 Value *MemAddr = nullptr;
324 switch (Opcode) {
325 case Instruction::Store:
326 case Instruction::Load: {
327 if (Opcode == Instruction::Store) {
328 StoreInst *SI = cast<StoreInst>(&II);
329 MemAddr = SI->getPointerOperand();
330 } else {
331 LoadInst *LI = cast<LoadInst>(&II);
332 MemAddr = LI->getPointerOperand();
333 }
334 // Global variable can not be aliased with locals.
335 if (isa<Constant>(MemAddr))
336 break;
338 if (!isa<AllocaInst>(Base)) {
339 SideEffectingBlocks.insert(&BB);
340 return;
341 }
342 BaseMemAddrs[&BB].insert(Base);
343 break;
344 }
345 default: {
346 IntrinsicInst *IntrInst = dyn_cast<IntrinsicInst>(&II);
347 if (IntrInst) {
348 if (IntrInst->isLifetimeStartOrEnd())
349 break;
350 SideEffectingBlocks.insert(&BB);
351 return;
352 }
353 // Treat all the other cases conservatively if it has side effects.
354 if (II.mayHaveSideEffects()) {
355 SideEffectingBlocks.insert(&BB);
356 return;
357 }
358 }
359 }
360 }
361}
362
364 BasicBlock &BB, AllocaInst *Addr) const {
365 if (SideEffectingBlocks.count(&BB))
366 return true;
367 auto It = BaseMemAddrs.find(&BB);
368 if (It != BaseMemAddrs.end())
369 return It->second.count(Addr);
370 return false;
371}
372
374 const CodeExtractorAnalysisCache &CEAC, Instruction *Addr) const {
375 AllocaInst *AI = cast<AllocaInst>(Addr->stripInBoundsConstantOffsets());
376 Function *Func = (*Blocks.begin())->getParent();
377 for (BasicBlock &BB : *Func) {
378 if (Blocks.count(&BB))
379 continue;
380 if (CEAC.doesBlockContainClobberOfAddr(BB, AI))
381 return false;
382 }
383 return true;
384}
385
388 BasicBlock *SinglePredFromOutlineRegion = nullptr;
389 assert(!Blocks.count(CommonExitBlock) &&
390 "Expect a block outside the region!");
391 for (auto *Pred : predecessors(CommonExitBlock)) {
392 if (!Blocks.count(Pred))
393 continue;
394 if (!SinglePredFromOutlineRegion) {
395 SinglePredFromOutlineRegion = Pred;
396 } else if (SinglePredFromOutlineRegion != Pred) {
397 SinglePredFromOutlineRegion = nullptr;
398 break;
399 }
400 }
401
402 if (SinglePredFromOutlineRegion)
403 return SinglePredFromOutlineRegion;
404
405#ifndef NDEBUG
406 auto getFirstPHI = [](BasicBlock *BB) {
408 PHINode *FirstPhi = nullptr;
409 while (I != BB->end()) {
410 PHINode *Phi = dyn_cast<PHINode>(I);
411 if (!Phi)
412 break;
413 if (!FirstPhi) {
414 FirstPhi = Phi;
415 break;
416 }
417 }
418 return FirstPhi;
419 };
420 // If there are any phi nodes, the single pred either exists or has already
421 // be created before code extraction.
422 assert(!getFirstPHI(CommonExitBlock) && "Phi not expected");
423#endif
424
425 BasicBlock *NewExitBlock = CommonExitBlock->splitBasicBlock(
426 CommonExitBlock->getFirstNonPHI()->getIterator());
427
428 for (BasicBlock *Pred :
429 llvm::make_early_inc_range(predecessors(CommonExitBlock))) {
430 if (Blocks.count(Pred))
431 continue;
432 Pred->getTerminator()->replaceUsesOfWith(CommonExitBlock, NewExitBlock);
433 }
434 // Now add the old exit block to the outline region.
435 Blocks.insert(CommonExitBlock);
436 OldTargets.push_back(NewExitBlock);
437 return CommonExitBlock;
438}
439
440// Find the pair of life time markers for address 'Addr' that are either
441// defined inside the outline region or can legally be shrinkwrapped into the
442// outline region. If there are not other untracked uses of the address, return
443// the pair of markers if found; otherwise return a pair of nullptr.
444CodeExtractor::LifetimeMarkerInfo
445CodeExtractor::getLifetimeMarkers(const CodeExtractorAnalysisCache &CEAC,
447 BasicBlock *ExitBlock) const {
448 LifetimeMarkerInfo Info;
449
450 for (User *U : Addr->users()) {
451 IntrinsicInst *IntrInst = dyn_cast<IntrinsicInst>(U);
452 if (IntrInst) {
453 // We don't model addresses with multiple start/end markers, but the
454 // markers do not need to be in the region.
455 if (IntrInst->getIntrinsicID() == Intrinsic::lifetime_start) {
456 if (Info.LifeStart)
457 return {};
458 Info.LifeStart = IntrInst;
459 continue;
460 }
461 if (IntrInst->getIntrinsicID() == Intrinsic::lifetime_end) {
462 if (Info.LifeEnd)
463 return {};
464 Info.LifeEnd = IntrInst;
465 continue;
466 }
467 // At this point, permit debug uses outside of the region.
468 // This is fixed in a later call to fixupDebugInfoPostExtraction().
469 if (isa<DbgInfoIntrinsic>(IntrInst))
470 continue;
471 }
472 // Find untracked uses of the address, bail.
473 if (!definedInRegion(Blocks, U))
474 return {};
475 }
476
477 if (!Info.LifeStart || !Info.LifeEnd)
478 return {};
479
480 Info.SinkLifeStart = !definedInRegion(Blocks, Info.LifeStart);
481 Info.HoistLifeEnd = !definedInRegion(Blocks, Info.LifeEnd);
482 // Do legality check.
483 if ((Info.SinkLifeStart || Info.HoistLifeEnd) &&
485 return {};
486
487 // Check to see if we have a place to do hoisting, if not, bail.
488 if (Info.HoistLifeEnd && !ExitBlock)
489 return {};
490
491 return Info;
492}
493
495 ValueSet &SinkCands, ValueSet &HoistCands,
496 BasicBlock *&ExitBlock) const {
497 Function *Func = (*Blocks.begin())->getParent();
498 ExitBlock = getCommonExitBlock(Blocks);
499
500 auto moveOrIgnoreLifetimeMarkers =
501 [&](const LifetimeMarkerInfo &LMI) -> bool {
502 if (!LMI.LifeStart)
503 return false;
504 if (LMI.SinkLifeStart) {
505 LLVM_DEBUG(dbgs() << "Sinking lifetime.start: " << *LMI.LifeStart
506 << "\n");
507 SinkCands.insert(LMI.LifeStart);
508 }
509 if (LMI.HoistLifeEnd) {
510 LLVM_DEBUG(dbgs() << "Hoisting lifetime.end: " << *LMI.LifeEnd << "\n");
511 HoistCands.insert(LMI.LifeEnd);
512 }
513 return true;
514 };
515
516 // Look up allocas in the original function in CodeExtractorAnalysisCache, as
517 // this is much faster than walking all the instructions.
518 for (AllocaInst *AI : CEAC.getAllocas()) {
519 BasicBlock *BB = AI->getParent();
520 if (Blocks.count(BB))
521 continue;
522
523 // As a prior call to extractCodeRegion() may have shrinkwrapped the alloca,
524 // check whether it is actually still in the original function.
525 Function *AIFunc = BB->getParent();
526 if (AIFunc != Func)
527 continue;
528
529 LifetimeMarkerInfo MarkerInfo = getLifetimeMarkers(CEAC, AI, ExitBlock);
530 bool Moved = moveOrIgnoreLifetimeMarkers(MarkerInfo);
531 if (Moved) {
532 LLVM_DEBUG(dbgs() << "Sinking alloca: " << *AI << "\n");
533 SinkCands.insert(AI);
534 continue;
535 }
536
537 // Find bitcasts in the outlined region that have lifetime marker users
538 // outside that region. Replace the lifetime marker use with an
539 // outside region bitcast to avoid unnecessary alloca/reload instructions
540 // and extra lifetime markers.
541 SmallVector<Instruction *, 2> LifetimeBitcastUsers;
542 for (User *U : AI->users()) {
543 if (!definedInRegion(Blocks, U))
544 continue;
545
546 if (U->stripInBoundsConstantOffsets() != AI)
547 continue;
548
549 Instruction *Bitcast = cast<Instruction>(U);
550 for (User *BU : Bitcast->users()) {
551 IntrinsicInst *IntrInst = dyn_cast<IntrinsicInst>(BU);
552 if (!IntrInst)
553 continue;
554
555 if (!IntrInst->isLifetimeStartOrEnd())
556 continue;
557
558 if (definedInRegion(Blocks, IntrInst))
559 continue;
560
561 LLVM_DEBUG(dbgs() << "Replace use of extracted region bitcast"
562 << *Bitcast << " in out-of-region lifetime marker "
563 << *IntrInst << "\n");
564 LifetimeBitcastUsers.push_back(IntrInst);
565 }
566 }
567
568 for (Instruction *I : LifetimeBitcastUsers) {
569 Module *M = AIFunc->getParent();
570 LLVMContext &Ctx = M->getContext();
571 auto *Int8PtrTy = PointerType::getUnqual(Ctx);
572 CastInst *CastI =
573 CastInst::CreatePointerCast(AI, Int8PtrTy, "lt.cast", I->getIterator());
574 I->replaceUsesOfWith(I->getOperand(1), CastI);
575 }
576
577 // Follow any bitcasts.
579 SmallVector<LifetimeMarkerInfo, 2> BitcastLifetimeInfo;
580 for (User *U : AI->users()) {
581 if (U->stripInBoundsConstantOffsets() == AI) {
582 Instruction *Bitcast = cast<Instruction>(U);
583 LifetimeMarkerInfo LMI = getLifetimeMarkers(CEAC, Bitcast, ExitBlock);
584 if (LMI.LifeStart) {
585 Bitcasts.push_back(Bitcast);
586 BitcastLifetimeInfo.push_back(LMI);
587 continue;
588 }
589 }
590
591 // Found unknown use of AI.
592 if (!definedInRegion(Blocks, U)) {
593 Bitcasts.clear();
594 break;
595 }
596 }
597
598 // Either no bitcasts reference the alloca or there are unknown uses.
599 if (Bitcasts.empty())
600 continue;
601
602 LLVM_DEBUG(dbgs() << "Sinking alloca (via bitcast): " << *AI << "\n");
603 SinkCands.insert(AI);
604 for (unsigned I = 0, E = Bitcasts.size(); I != E; ++I) {
605 Instruction *BitcastAddr = Bitcasts[I];
606 const LifetimeMarkerInfo &LMI = BitcastLifetimeInfo[I];
607 assert(LMI.LifeStart &&
608 "Unsafe to sink bitcast without lifetime markers");
609 moveOrIgnoreLifetimeMarkers(LMI);
610 if (!definedInRegion(Blocks, BitcastAddr)) {
611 LLVM_DEBUG(dbgs() << "Sinking bitcast-of-alloca: " << *BitcastAddr
612 << "\n");
613 SinkCands.insert(BitcastAddr);
614 }
615 }
616 }
617}
618
620 if (Blocks.empty())
621 return false;
622 BasicBlock *Header = *Blocks.begin();
623 Function *F = Header->getParent();
624
625 // For functions with varargs, check that varargs handling is only done in the
626 // outlined function, i.e vastart and vaend are only used in outlined blocks.
627 if (AllowVarArgs && F->getFunctionType()->isVarArg()) {
628 auto containsVarArgIntrinsic = [](const Instruction &I) {
629 if (const CallInst *CI = dyn_cast<CallInst>(&I))
630 if (const Function *Callee = CI->getCalledFunction())
631 return Callee->getIntrinsicID() == Intrinsic::vastart ||
632 Callee->getIntrinsicID() == Intrinsic::vaend;
633 return false;
634 };
635
636 for (auto &BB : *F) {
637 if (Blocks.count(&BB))
638 continue;
639 if (llvm::any_of(BB, containsVarArgIntrinsic))
640 return false;
641 }
642 }
643 return true;
644}
645
647 const ValueSet &SinkCands) const {
648 for (BasicBlock *BB : Blocks) {
649 // If a used value is defined outside the region, it's an input. If an
650 // instruction is used outside the region, it's an output.
651 for (Instruction &II : *BB) {
652 for (auto &OI : II.operands()) {
653 Value *V = OI;
654 if (!SinkCands.count(V) && definedInCaller(Blocks, V))
655 Inputs.insert(V);
656 }
657
658 for (User *U : II.users())
659 if (!definedInRegion(Blocks, U)) {
660 Outputs.insert(&II);
661 break;
662 }
663 }
664 }
665}
666
667/// severSplitPHINodesOfEntry - If a PHI node has multiple inputs from outside
668/// of the region, we need to split the entry block of the region so that the
669/// PHI node is easier to deal with.
670void CodeExtractor::severSplitPHINodesOfEntry(BasicBlock *&Header) {
671 unsigned NumPredsFromRegion = 0;
672 unsigned NumPredsOutsideRegion = 0;
673
674 if (Header != &Header->getParent()->getEntryBlock()) {
675 PHINode *PN = dyn_cast<PHINode>(Header->begin());
676 if (!PN) return; // No PHI nodes.
677
678 // If the header node contains any PHI nodes, check to see if there is more
679 // than one entry from outside the region. If so, we need to sever the
680 // header block into two.
681 for (unsigned i = 0, e = PN->getNumIncomingValues(); i != e; ++i)
682 if (Blocks.count(PN->getIncomingBlock(i)))
683 ++NumPredsFromRegion;
684 else
685 ++NumPredsOutsideRegion;
686
687 // If there is one (or fewer) predecessor from outside the region, we don't
688 // need to do anything special.
689 if (NumPredsOutsideRegion <= 1) return;
690 }
691
692 // Otherwise, we need to split the header block into two pieces: one
693 // containing PHI nodes merging values from outside of the region, and a
694 // second that contains all of the code for the block and merges back any
695 // incoming values from inside of the region.
696 BasicBlock *NewBB = SplitBlock(Header, Header->getFirstNonPHI(), DT);
697
698 // We only want to code extract the second block now, and it becomes the new
699 // header of the region.
700 BasicBlock *OldPred = Header;
701 Blocks.remove(OldPred);
702 Blocks.insert(NewBB);
703 Header = NewBB;
704
705 // Okay, now we need to adjust the PHI nodes and any branches from within the
706 // region to go to the new header block instead of the old header block.
707 if (NumPredsFromRegion) {
708 PHINode *PN = cast<PHINode>(OldPred->begin());
709 // Loop over all of the predecessors of OldPred that are in the region,
710 // changing them to branch to NewBB instead.
711 for (unsigned i = 0, e = PN->getNumIncomingValues(); i != e; ++i)
712 if (Blocks.count(PN->getIncomingBlock(i))) {
714 TI->replaceUsesOfWith(OldPred, NewBB);
715 }
716
717 // Okay, everything within the region is now branching to the right block, we
718 // just have to update the PHI nodes now, inserting PHI nodes into NewBB.
719 BasicBlock::iterator AfterPHIs;
720 for (AfterPHIs = OldPred->begin(); isa<PHINode>(AfterPHIs); ++AfterPHIs) {
721 PHINode *PN = cast<PHINode>(AfterPHIs);
722 // Create a new PHI node in the new region, which has an incoming value
723 // from OldPred of PN.
724 PHINode *NewPN = PHINode::Create(PN->getType(), 1 + NumPredsFromRegion,
725 PN->getName() + ".ce");
726 NewPN->insertBefore(NewBB->begin());
727 PN->replaceAllUsesWith(NewPN);
728 NewPN->addIncoming(PN, OldPred);
729
730 // Loop over all of the incoming value in PN, moving them to NewPN if they
731 // are from the extracted region.
732 for (unsigned i = 0; i != PN->getNumIncomingValues(); ++i) {
733 if (Blocks.count(PN->getIncomingBlock(i))) {
734 NewPN->addIncoming(PN->getIncomingValue(i), PN->getIncomingBlock(i));
735 PN->removeIncomingValue(i);
736 --i;
737 }
738 }
739 }
740 }
741}
742
743/// severSplitPHINodesOfExits - if PHI nodes in exit blocks have inputs from
744/// outlined region, we split these PHIs on two: one with inputs from region
745/// and other with remaining incoming blocks; then first PHIs are placed in
746/// outlined region.
747void CodeExtractor::severSplitPHINodesOfExits(
748 const SetVector<BasicBlock *> &Exits) {
749 for (BasicBlock *ExitBB : Exits) {
750 BasicBlock *NewBB = nullptr;
751
752 for (PHINode &PN : ExitBB->phis()) {
753 // Find all incoming values from the outlining region.
754 SmallVector<unsigned, 2> IncomingVals;
755 for (unsigned i = 0; i < PN.getNumIncomingValues(); ++i)
756 if (Blocks.count(PN.getIncomingBlock(i)))
757 IncomingVals.push_back(i);
758
759 // Do not process PHI if there is one (or fewer) predecessor from region.
760 // If PHI has exactly one predecessor from region, only this one incoming
761 // will be replaced on codeRepl block, so it should be safe to skip PHI.
762 if (IncomingVals.size() <= 1)
763 continue;
764
765 // Create block for new PHIs and add it to the list of outlined if it
766 // wasn't done before.
767 if (!NewBB) {
768 NewBB = BasicBlock::Create(ExitBB->getContext(),
769 ExitBB->getName() + ".split",
770 ExitBB->getParent(), ExitBB);
771 NewBB->IsNewDbgInfoFormat = ExitBB->IsNewDbgInfoFormat;
773 for (BasicBlock *PredBB : Preds)
774 if (Blocks.count(PredBB))
775 PredBB->getTerminator()->replaceUsesOfWith(ExitBB, NewBB);
776 BranchInst::Create(ExitBB, NewBB);
777 Blocks.insert(NewBB);
778 }
779
780 // Split this PHI.
781 PHINode *NewPN = PHINode::Create(PN.getType(), IncomingVals.size(),
782 PN.getName() + ".ce");
783 NewPN->insertBefore(NewBB->getFirstNonPHIIt());
784 for (unsigned i : IncomingVals)
785 NewPN->addIncoming(PN.getIncomingValue(i), PN.getIncomingBlock(i));
786 for (unsigned i : reverse(IncomingVals))
787 PN.removeIncomingValue(i, false);
788 PN.addIncoming(NewPN, NewBB);
789 }
790 }
791}
792
793void CodeExtractor::splitReturnBlocks() {
794 for (BasicBlock *Block : Blocks)
795 if (ReturnInst *RI = dyn_cast<ReturnInst>(Block->getTerminator())) {
796 BasicBlock *New =
797 Block->splitBasicBlock(RI->getIterator(), Block->getName() + ".ret");
798 if (DT) {
799 // Old dominates New. New node dominates all other nodes dominated
800 // by Old.
801 DomTreeNode *OldNode = DT->getNode(Block);
803 OldNode->end());
804
805 DomTreeNode *NewNode = DT->addNewBlock(New, Block);
806
807 for (DomTreeNode *I : Children)
808 DT->changeImmediateDominator(I, NewNode);
809 }
810 }
811}
812
813/// constructFunction - make a function based on inputs and outputs, as follows:
814/// f(in0, ..., inN, out0, ..., outN)
815Function *CodeExtractor::constructFunction(const ValueSet &inputs,
816 const ValueSet &outputs,
817 BasicBlock *header,
818 BasicBlock *newRootNode,
819 BasicBlock *newHeader,
820 Function *oldFunction,
821 Module *M) {
822 LLVM_DEBUG(dbgs() << "inputs: " << inputs.size() << "\n");
823 LLVM_DEBUG(dbgs() << "outputs: " << outputs.size() << "\n");
824
825 // This function returns unsigned, outputs will go back by reference.
826 switch (NumExitBlocks) {
827 case 0:
828 case 1: RetTy = Type::getVoidTy(header->getContext()); break;
829 case 2: RetTy = Type::getInt1Ty(header->getContext()); break;
830 default: RetTy = Type::getInt16Ty(header->getContext()); break;
831 }
832
833 std::vector<Type *> ParamTy;
834 std::vector<Type *> AggParamTy;
835 ValueSet StructValues;
836 const DataLayout &DL = M->getDataLayout();
837
838 // Add the types of the input values to the function's argument list
839 for (Value *value : inputs) {
840 LLVM_DEBUG(dbgs() << "value used in func: " << *value << "\n");
841 if (AggregateArgs && !ExcludeArgsFromAggregate.contains(value)) {
842 AggParamTy.push_back(value->getType());
843 StructValues.insert(value);
844 } else
845 ParamTy.push_back(value->getType());
846 }
847
848 // Add the types of the output values to the function's argument list.
849 for (Value *output : outputs) {
850 LLVM_DEBUG(dbgs() << "instr used in func: " << *output << "\n");
851 if (AggregateArgs && !ExcludeArgsFromAggregate.contains(output)) {
852 AggParamTy.push_back(output->getType());
853 StructValues.insert(output);
854 } else
855 ParamTy.push_back(
856 PointerType::get(output->getType(), DL.getAllocaAddrSpace()));
857 }
858
859 assert(
860 (ParamTy.size() + AggParamTy.size()) ==
861 (inputs.size() + outputs.size()) &&
862 "Number of scalar and aggregate params does not match inputs, outputs");
863 assert((StructValues.empty() || AggregateArgs) &&
864 "Expeced StructValues only with AggregateArgs set");
865
866 // Concatenate scalar and aggregate params in ParamTy.
867 size_t NumScalarParams = ParamTy.size();
868 StructType *StructTy = nullptr;
869 if (AggregateArgs && !AggParamTy.empty()) {
870 StructTy = StructType::get(M->getContext(), AggParamTy);
871 ParamTy.push_back(PointerType::get(
872 StructTy, ArgsInZeroAddressSpace ? 0 : DL.getAllocaAddrSpace()));
873 }
874
875 LLVM_DEBUG({
876 dbgs() << "Function type: " << *RetTy << " f(";
877 for (Type *i : ParamTy)
878 dbgs() << *i << ", ";
879 dbgs() << ")\n";
880 });
881
883 RetTy, ParamTy, AllowVarArgs && oldFunction->isVarArg());
884
885 std::string SuffixToUse =
886 Suffix.empty()
887 ? (header->getName().empty() ? "extracted" : header->getName().str())
888 : Suffix;
889 // Create the new function
890 Function *newFunction = Function::Create(
891 funcType, GlobalValue::InternalLinkage, oldFunction->getAddressSpace(),
892 oldFunction->getName() + "." + SuffixToUse, M);
893 newFunction->IsNewDbgInfoFormat = oldFunction->IsNewDbgInfoFormat;
894
895 // Inherit all of the target dependent attributes and white-listed
896 // target independent attributes.
897 // (e.g. If the extracted region contains a call to an x86.sse
898 // instruction we need to make sure that the extracted region has the
899 // "target-features" attribute allowing it to be lowered.
900 // FIXME: This should be changed to check to see if a specific
901 // attribute can not be inherited.
902 for (const auto &Attr : oldFunction->getAttributes().getFnAttrs()) {
903 if (Attr.isStringAttribute()) {
904 if (Attr.getKindAsString() == "thunk")
905 continue;
906 } else
907 switch (Attr.getKindAsEnum()) {
908 // Those attributes cannot be propagated safely. Explicitly list them
909 // here so we get a warning if new attributes are added.
910 case Attribute::AllocSize:
911 case Attribute::Builtin:
912 case Attribute::Convergent:
913 case Attribute::JumpTable:
914 case Attribute::Naked:
915 case Attribute::NoBuiltin:
916 case Attribute::NoMerge:
917 case Attribute::NoReturn:
918 case Attribute::NoSync:
919 case Attribute::ReturnsTwice:
920 case Attribute::Speculatable:
921 case Attribute::StackAlignment:
922 case Attribute::WillReturn:
923 case Attribute::AllocKind:
924 case Attribute::PresplitCoroutine:
925 case Attribute::Memory:
926 case Attribute::NoFPClass:
927 case Attribute::CoroDestroyOnlyWhenComplete:
928 continue;
929 // Those attributes should be safe to propagate to the extracted function.
930 case Attribute::AlwaysInline:
931 case Attribute::Cold:
932 case Attribute::DisableSanitizerInstrumentation:
933 case Attribute::FnRetThunkExtern:
934 case Attribute::Hot:
935 case Attribute::NoRecurse:
936 case Attribute::InlineHint:
937 case Attribute::MinSize:
938 case Attribute::NoCallback:
939 case Attribute::NoDuplicate:
940 case Attribute::NoFree:
941 case Attribute::NoImplicitFloat:
942 case Attribute::NoInline:
943 case Attribute::NonLazyBind:
944 case Attribute::NoRedZone:
945 case Attribute::NoUnwind:
946 case Attribute::NoSanitizeBounds:
947 case Attribute::NoSanitizeCoverage:
948 case Attribute::NullPointerIsValid:
949 case Attribute::OptimizeForDebugging:
950 case Attribute::OptForFuzzing:
951 case Attribute::OptimizeNone:
952 case Attribute::OptimizeForSize:
953 case Attribute::SafeStack:
954 case Attribute::ShadowCallStack:
955 case Attribute::SanitizeAddress:
956 case Attribute::SanitizeMemory:
957 case Attribute::SanitizeNumericalStability:
958 case Attribute::SanitizeThread:
959 case Attribute::SanitizeHWAddress:
960 case Attribute::SanitizeMemTag:
961 case Attribute::SpeculativeLoadHardening:
962 case Attribute::StackProtect:
963 case Attribute::StackProtectReq:
964 case Attribute::StackProtectStrong:
965 case Attribute::StrictFP:
966 case Attribute::UWTable:
967 case Attribute::VScaleRange:
968 case Attribute::NoCfCheck:
969 case Attribute::MustProgress:
970 case Attribute::NoProfile:
971 case Attribute::SkipProfile:
972 break;
973 // These attributes cannot be applied to functions.
974 case Attribute::Alignment:
975 case Attribute::AllocatedPointer:
976 case Attribute::AllocAlign:
977 case Attribute::ByVal:
978 case Attribute::Dereferenceable:
979 case Attribute::DereferenceableOrNull:
980 case Attribute::ElementType:
981 case Attribute::InAlloca:
982 case Attribute::InReg:
983 case Attribute::Nest:
984 case Attribute::NoAlias:
985 case Attribute::NoCapture:
986 case Attribute::NoUndef:
987 case Attribute::NonNull:
988 case Attribute::Preallocated:
989 case Attribute::ReadNone:
990 case Attribute::ReadOnly:
991 case Attribute::Returned:
992 case Attribute::SExt:
993 case Attribute::StructRet:
994 case Attribute::SwiftError:
995 case Attribute::SwiftSelf:
996 case Attribute::SwiftAsync:
997 case Attribute::ZExt:
998 case Attribute::ImmArg:
999 case Attribute::ByRef:
1000 case Attribute::WriteOnly:
1001 case Attribute::Writable:
1002 case Attribute::DeadOnUnwind:
1003 case Attribute::Range:
1004 case Attribute::Initializes:
1005 // These are not really attributes.
1006 case Attribute::None:
1010 llvm_unreachable("Not a function attribute");
1011 }
1012
1013 newFunction->addFnAttr(Attr);
1014 }
1015
1016 if (NumExitBlocks == 0) {
1017 // Mark the new function `noreturn` if applicable. Terminators which resume
1018 // exception propagation are treated as returning instructions. This is to
1019 // avoid inserting traps after calls to outlined functions which unwind.
1020 if (none_of(Blocks, [](const BasicBlock *BB) {
1021 const Instruction *Term = BB->getTerminator();
1022 return isa<ReturnInst>(Term) || isa<ResumeInst>(Term);
1023 }))
1024 newFunction->setDoesNotReturn();
1025 }
1026
1027 newFunction->insert(newFunction->end(), newRootNode);
1028
1029 // Create scalar and aggregate iterators to name all of the arguments we
1030 // inserted.
1031 Function::arg_iterator ScalarAI = newFunction->arg_begin();
1032 Function::arg_iterator AggAI = std::next(ScalarAI, NumScalarParams);
1033
1034 // Rewrite all users of the inputs in the extracted region to use the
1035 // arguments (or appropriate addressing into struct) instead.
1036 for (unsigned i = 0, e = inputs.size(), aggIdx = 0; i != e; ++i) {
1037 Value *RewriteVal;
1038 if (AggregateArgs && StructValues.contains(inputs[i])) {
1039 Value *Idx[2];
1041 Idx[1] = ConstantInt::get(Type::getInt32Ty(header->getContext()), aggIdx);
1042 BasicBlock::iterator TI = newFunction->begin()->getTerminator()->getIterator();
1044 StructTy, &*AggAI, Idx, "gep_" + inputs[i]->getName(), TI);
1045 RewriteVal = new LoadInst(StructTy->getElementType(aggIdx), GEP,
1046 "loadgep_" + inputs[i]->getName(), TI);
1047 ++aggIdx;
1048 } else
1049 RewriteVal = &*ScalarAI++;
1050
1051 std::vector<User *> Users(inputs[i]->user_begin(), inputs[i]->user_end());
1052 for (User *use : Users)
1053 if (Instruction *inst = dyn_cast<Instruction>(use))
1054 if (Blocks.count(inst->getParent()))
1055 inst->replaceUsesOfWith(inputs[i], RewriteVal);
1056 }
1057
1058 // Set names for input and output arguments.
1059 if (NumScalarParams) {
1060 ScalarAI = newFunction->arg_begin();
1061 for (unsigned i = 0, e = inputs.size(); i != e; ++i, ++ScalarAI)
1062 if (!StructValues.contains(inputs[i]))
1063 ScalarAI->setName(inputs[i]->getName());
1064 for (unsigned i = 0, e = outputs.size(); i != e; ++i, ++ScalarAI)
1065 if (!StructValues.contains(outputs[i]))
1066 ScalarAI->setName(outputs[i]->getName() + ".out");
1067 }
1068
1069 // Rewrite branches to basic blocks outside of the loop to new dummy blocks
1070 // within the new function. This must be done before we lose track of which
1071 // blocks were originally in the code region.
1072 std::vector<User *> Users(header->user_begin(), header->user_end());
1073 for (auto &U : Users)
1074 // The BasicBlock which contains the branch is not in the region
1075 // modify the branch target to a new block
1076 if (Instruction *I = dyn_cast<Instruction>(U))
1077 if (I->isTerminator() && I->getFunction() == oldFunction &&
1078 !Blocks.count(I->getParent()))
1079 I->replaceUsesOfWith(header, newHeader);
1080
1081 return newFunction;
1082}
1083
1084/// Erase lifetime.start markers which reference inputs to the extraction
1085/// region, and insert the referenced memory into \p LifetimesStart.
1086///
1087/// The extraction region is defined by a set of blocks (\p Blocks), and a set
1088/// of allocas which will be moved from the caller function into the extracted
1089/// function (\p SunkAllocas).
1091 const SetVector<Value *> &SunkAllocas,
1092 SetVector<Value *> &LifetimesStart) {
1093 for (BasicBlock *BB : Blocks) {
1095 auto *II = dyn_cast<IntrinsicInst>(&I);
1096 if (!II || !II->isLifetimeStartOrEnd())
1097 continue;
1098
1099 // Get the memory operand of the lifetime marker. If the underlying
1100 // object is a sunk alloca, or is otherwise defined in the extraction
1101 // region, the lifetime marker must not be erased.
1102 Value *Mem = II->getOperand(1)->stripInBoundsOffsets();
1103 if (SunkAllocas.count(Mem) || definedInRegion(Blocks, Mem))
1104 continue;
1105
1106 if (II->getIntrinsicID() == Intrinsic::lifetime_start)
1107 LifetimesStart.insert(Mem);
1108 II->eraseFromParent();
1109 }
1110 }
1111}
1112
1113/// Insert lifetime start/end markers surrounding the call to the new function
1114/// for objects defined in the caller.
1116 Module *M, ArrayRef<Value *> LifetimesStart, ArrayRef<Value *> LifetimesEnd,
1117 CallInst *TheCall) {
1118 LLVMContext &Ctx = M->getContext();
1119 auto NegativeOne = ConstantInt::getSigned(Type::getInt64Ty(Ctx), -1);
1120 Instruction *Term = TheCall->getParent()->getTerminator();
1121
1122 // Emit lifetime markers for the pointers given in \p Objects. Insert the
1123 // markers before the call if \p InsertBefore, and after the call otherwise.
1124 auto insertMarkers = [&](Intrinsic::ID MarkerFunc, ArrayRef<Value *> Objects,
1125 bool InsertBefore) {
1126 for (Value *Mem : Objects) {
1127 assert((!isa<Instruction>(Mem) || cast<Instruction>(Mem)->getFunction() ==
1128 TheCall->getFunction()) &&
1129 "Input memory not defined in original function");
1130
1131 Function *Func = Intrinsic::getDeclaration(M, MarkerFunc, Mem->getType());
1132 auto Marker = CallInst::Create(Func, {NegativeOne, Mem});
1133 if (InsertBefore)
1134 Marker->insertBefore(TheCall);
1135 else
1136 Marker->insertBefore(Term);
1137 }
1138 };
1139
1140 if (!LifetimesStart.empty()) {
1141 insertMarkers(Intrinsic::lifetime_start, LifetimesStart,
1142 /*InsertBefore=*/true);
1143 }
1144
1145 if (!LifetimesEnd.empty()) {
1146 insertMarkers(Intrinsic::lifetime_end, LifetimesEnd,
1147 /*InsertBefore=*/false);
1148 }
1149}
1150
1151/// emitCallAndSwitchStatement - This method sets up the caller side by adding
1152/// the call instruction, splitting any PHI nodes in the header block as
1153/// necessary.
1154CallInst *CodeExtractor::emitCallAndSwitchStatement(Function *newFunction,
1155 BasicBlock *codeReplacer,
1156 ValueSet &inputs,
1157 ValueSet &outputs) {
1158 // Emit a call to the new function, passing in: *pointer to struct (if
1159 // aggregating parameters), or plan inputs and allocated memory for outputs
1160 std::vector<Value *> params, ReloadOutputs, Reloads;
1161 ValueSet StructValues;
1162
1163 Module *M = newFunction->getParent();
1164 LLVMContext &Context = M->getContext();
1165 const DataLayout &DL = M->getDataLayout();
1166 CallInst *call = nullptr;
1167
1168 // Add inputs as params, or to be filled into the struct
1169 unsigned ScalarInputArgNo = 0;
1170 SmallVector<unsigned, 1> SwiftErrorArgs;
1171 for (Value *input : inputs) {
1172 if (AggregateArgs && !ExcludeArgsFromAggregate.contains(input))
1173 StructValues.insert(input);
1174 else {
1175 params.push_back(input);
1176 if (input->isSwiftError())
1177 SwiftErrorArgs.push_back(ScalarInputArgNo);
1178 }
1179 ++ScalarInputArgNo;
1180 }
1181
1182 // Create allocas for the outputs
1183 unsigned ScalarOutputArgNo = 0;
1184 for (Value *output : outputs) {
1185 if (AggregateArgs && !ExcludeArgsFromAggregate.contains(output)) {
1186 StructValues.insert(output);
1187 } else {
1188 AllocaInst *alloca =
1189 new AllocaInst(output->getType(), DL.getAllocaAddrSpace(),
1190 nullptr, output->getName() + ".loc",
1191 codeReplacer->getParent()->front().begin());
1192 ReloadOutputs.push_back(alloca);
1193 params.push_back(alloca);
1194 ++ScalarOutputArgNo;
1195 }
1196 }
1197
1198 StructType *StructArgTy = nullptr;
1199 AllocaInst *Struct = nullptr;
1200 unsigned NumAggregatedInputs = 0;
1201 if (AggregateArgs && !StructValues.empty()) {
1202 std::vector<Type *> ArgTypes;
1203 for (Value *V : StructValues)
1204 ArgTypes.push_back(V->getType());
1205
1206 // Allocate a struct at the beginning of this function
1207 StructArgTy = StructType::get(newFunction->getContext(), ArgTypes);
1208 Struct = new AllocaInst(
1209 StructArgTy, DL.getAllocaAddrSpace(), nullptr, "structArg",
1210 AllocationBlock ? AllocationBlock->getFirstInsertionPt()
1211 : codeReplacer->getParent()->front().begin());
1212
1213 if (ArgsInZeroAddressSpace && DL.getAllocaAddrSpace() != 0) {
1214 auto *StructSpaceCast = new AddrSpaceCastInst(
1215 Struct, PointerType ::get(Context, 0), "structArg.ascast");
1216 StructSpaceCast->insertAfter(Struct);
1217 params.push_back(StructSpaceCast);
1218 } else {
1219 params.push_back(Struct);
1220 }
1221 // Store aggregated inputs in the struct.
1222 for (unsigned i = 0, e = StructValues.size(); i != e; ++i) {
1223 if (inputs.contains(StructValues[i])) {
1224 Value *Idx[2];
1226 Idx[1] = ConstantInt::get(Type::getInt32Ty(Context), i);
1228 StructArgTy, Struct, Idx, "gep_" + StructValues[i]->getName());
1229 GEP->insertInto(codeReplacer, codeReplacer->end());
1230 new StoreInst(StructValues[i], GEP, codeReplacer);
1231 NumAggregatedInputs++;
1232 }
1233 }
1234 }
1235
1236 // Emit the call to the function
1237 call = CallInst::Create(newFunction, params,
1238 NumExitBlocks > 1 ? "targetBlock" : "");
1239 // Add debug location to the new call, if the original function has debug
1240 // info. In that case, the terminator of the entry block of the extracted
1241 // function contains the first debug location of the extracted function,
1242 // set in extractCodeRegion.
1243 if (codeReplacer->getParent()->getSubprogram()) {
1244 if (auto DL = newFunction->getEntryBlock().getTerminator()->getDebugLoc())
1245 call->setDebugLoc(DL);
1246 }
1247 call->insertInto(codeReplacer, codeReplacer->end());
1248
1249 // Set swifterror parameter attributes.
1250 for (unsigned SwiftErrArgNo : SwiftErrorArgs) {
1251 call->addParamAttr(SwiftErrArgNo, Attribute::SwiftError);
1252 newFunction->addParamAttr(SwiftErrArgNo, Attribute::SwiftError);
1253 }
1254
1255 // Reload the outputs passed in by reference, use the struct if output is in
1256 // the aggregate or reload from the scalar argument.
1257 for (unsigned i = 0, e = outputs.size(), scalarIdx = 0,
1258 aggIdx = NumAggregatedInputs;
1259 i != e; ++i) {
1260 Value *Output = nullptr;
1261 if (AggregateArgs && StructValues.contains(outputs[i])) {
1262 Value *Idx[2];
1264 Idx[1] = ConstantInt::get(Type::getInt32Ty(Context), aggIdx);
1266 StructArgTy, Struct, Idx, "gep_reload_" + outputs[i]->getName());
1267 GEP->insertInto(codeReplacer, codeReplacer->end());
1268 Output = GEP;
1269 ++aggIdx;
1270 } else {
1271 Output = ReloadOutputs[scalarIdx];
1272 ++scalarIdx;
1273 }
1274 LoadInst *load = new LoadInst(outputs[i]->getType(), Output,
1275 outputs[i]->getName() + ".reload",
1276 codeReplacer);
1277 Reloads.push_back(load);
1278 std::vector<User *> Users(outputs[i]->user_begin(), outputs[i]->user_end());
1279 for (User *U : Users) {
1280 Instruction *inst = cast<Instruction>(U);
1281 if (!Blocks.count(inst->getParent()))
1282 inst->replaceUsesOfWith(outputs[i], load);
1283 }
1284 }
1285
1286 // Now we can emit a switch statement using the call as a value.
1287 SwitchInst *TheSwitch =
1289 codeReplacer, 0, codeReplacer);
1290
1291 // Since there may be multiple exits from the original region, make the new
1292 // function return an unsigned, switch on that number. This loop iterates
1293 // over all of the blocks in the extracted region, updating any terminator
1294 // instructions in the to-be-extracted region that branch to blocks that are
1295 // not in the region to be extracted.
1296 std::map<BasicBlock *, BasicBlock *> ExitBlockMap;
1297
1298 // Iterate over the previously collected targets, and create new blocks inside
1299 // the function to branch to.
1300 unsigned switchVal = 0;
1301 for (BasicBlock *OldTarget : OldTargets) {
1302 if (Blocks.count(OldTarget))
1303 continue;
1304 BasicBlock *&NewTarget = ExitBlockMap[OldTarget];
1305 if (NewTarget)
1306 continue;
1307
1308 // If we don't already have an exit stub for this non-extracted
1309 // destination, create one now!
1310 NewTarget = BasicBlock::Create(Context,
1311 OldTarget->getName() + ".exitStub",
1312 newFunction);
1313 unsigned SuccNum = switchVal++;
1314
1315 Value *brVal = nullptr;
1316 assert(NumExitBlocks < 0xffff && "too many exit blocks for switch");
1317 switch (NumExitBlocks) {
1318 case 0:
1319 case 1: break; // No value needed.
1320 case 2: // Conditional branch, return a bool
1321 brVal = ConstantInt::get(Type::getInt1Ty(Context), !SuccNum);
1322 break;
1323 default:
1324 brVal = ConstantInt::get(Type::getInt16Ty(Context), SuccNum);
1325 break;
1326 }
1327
1328 ReturnInst::Create(Context, brVal, NewTarget);
1329
1330 // Update the switch instruction.
1331 TheSwitch->addCase(ConstantInt::get(Type::getInt16Ty(Context),
1332 SuccNum),
1333 OldTarget);
1334 }
1335
1336 for (BasicBlock *Block : Blocks) {
1337 Instruction *TI = Block->getTerminator();
1338 for (unsigned i = 0, e = TI->getNumSuccessors(); i != e; ++i) {
1339 if (Blocks.count(TI->getSuccessor(i)))
1340 continue;
1341 BasicBlock *OldTarget = TI->getSuccessor(i);
1342 // add a new basic block which returns the appropriate value
1343 BasicBlock *NewTarget = ExitBlockMap[OldTarget];
1344 assert(NewTarget && "Unknown target block!");
1345
1346 // rewrite the original branch instruction with this new target
1347 TI->setSuccessor(i, NewTarget);
1348 }
1349 }
1350
1351 // Store the arguments right after the definition of output value.
1352 // This should be proceeded after creating exit stubs to be ensure that invoke
1353 // result restore will be placed in the outlined function.
1354 Function::arg_iterator ScalarOutputArgBegin = newFunction->arg_begin();
1355 std::advance(ScalarOutputArgBegin, ScalarInputArgNo);
1356 Function::arg_iterator AggOutputArgBegin = newFunction->arg_begin();
1357 std::advance(AggOutputArgBegin, ScalarInputArgNo + ScalarOutputArgNo);
1358
1359 for (unsigned i = 0, e = outputs.size(), aggIdx = NumAggregatedInputs; i != e;
1360 ++i) {
1361 auto *OutI = dyn_cast<Instruction>(outputs[i]);
1362 if (!OutI)
1363 continue;
1364
1365 // Find proper insertion point.
1366 BasicBlock::iterator InsertPt;
1367 // In case OutI is an invoke, we insert the store at the beginning in the
1368 // 'normal destination' BB. Otherwise we insert the store right after OutI.
1369 if (auto *InvokeI = dyn_cast<InvokeInst>(OutI))
1370 InsertPt = InvokeI->getNormalDest()->getFirstInsertionPt();
1371 else if (auto *Phi = dyn_cast<PHINode>(OutI))
1372 InsertPt = Phi->getParent()->getFirstInsertionPt();
1373 else
1374 InsertPt = std::next(OutI->getIterator());
1375
1376 assert((InsertPt->getFunction() == newFunction ||
1377 Blocks.count(InsertPt->getParent())) &&
1378 "InsertPt should be in new function");
1379 if (AggregateArgs && StructValues.contains(outputs[i])) {
1380 assert(AggOutputArgBegin != newFunction->arg_end() &&
1381 "Number of aggregate output arguments should match "
1382 "the number of defined values");
1383 Value *Idx[2];
1385 Idx[1] = ConstantInt::get(Type::getInt32Ty(Context), aggIdx);
1387 StructArgTy, &*AggOutputArgBegin, Idx, "gep_" + outputs[i]->getName(),
1388 InsertPt);
1389 new StoreInst(outputs[i], GEP, InsertPt);
1390 ++aggIdx;
1391 // Since there should be only one struct argument aggregating
1392 // all the output values, we shouldn't increment AggOutputArgBegin, which
1393 // always points to the struct argument, in this case.
1394 } else {
1395 assert(ScalarOutputArgBegin != newFunction->arg_end() &&
1396 "Number of scalar output arguments should match "
1397 "the number of defined values");
1398 new StoreInst(outputs[i], &*ScalarOutputArgBegin, InsertPt);
1399 ++ScalarOutputArgBegin;
1400 }
1401 }
1402
1403 // Now that we've done the deed, simplify the switch instruction.
1404 Type *OldFnRetTy = TheSwitch->getParent()->getParent()->getReturnType();
1405 switch (NumExitBlocks) {
1406 case 0:
1407 // There are no successors (the block containing the switch itself), which
1408 // means that previously this was the last part of the function, and hence
1409 // this should be rewritten as a `ret` or `unreachable`.
1410 if (newFunction->doesNotReturn()) {
1411 // If fn is no return, end with an unreachable terminator.
1412 (void)new UnreachableInst(Context, TheSwitch->getIterator());
1413 } else if (OldFnRetTy->isVoidTy()) {
1414 // We have no return value.
1415 ReturnInst::Create(Context, nullptr,
1416 TheSwitch->getIterator()); // Return void
1417 } else if (OldFnRetTy == TheSwitch->getCondition()->getType()) {
1418 // return what we have
1419 ReturnInst::Create(Context, TheSwitch->getCondition(),
1420 TheSwitch->getIterator());
1421 } else {
1422 // Otherwise we must have code extracted an unwind or something, just
1423 // return whatever we want.
1424 ReturnInst::Create(Context, Constant::getNullValue(OldFnRetTy),
1425 TheSwitch->getIterator());
1426 }
1427
1428 TheSwitch->eraseFromParent();
1429 break;
1430 case 1:
1431 // Only a single destination, change the switch into an unconditional
1432 // branch.
1433 BranchInst::Create(TheSwitch->getSuccessor(1), TheSwitch->getIterator());
1434 TheSwitch->eraseFromParent();
1435 break;
1436 case 2:
1437 BranchInst::Create(TheSwitch->getSuccessor(1), TheSwitch->getSuccessor(2),
1438 call, TheSwitch->getIterator());
1439 TheSwitch->eraseFromParent();
1440 break;
1441 default:
1442 // Otherwise, make the default destination of the switch instruction be one
1443 // of the other successors.
1444 TheSwitch->setCondition(call);
1445 TheSwitch->setDefaultDest(TheSwitch->getSuccessor(NumExitBlocks));
1446 // Remove redundant case
1447 TheSwitch->removeCase(SwitchInst::CaseIt(TheSwitch, NumExitBlocks-1));
1448 break;
1449 }
1450
1451 // Insert lifetime markers around the reloads of any output values. The
1452 // allocas output values are stored in are only in-use in the codeRepl block.
1453 insertLifetimeMarkersSurroundingCall(M, ReloadOutputs, ReloadOutputs, call);
1454
1455 return call;
1456}
1457
1458void CodeExtractor::moveCodeToFunction(Function *newFunction) {
1459 auto newFuncIt = newFunction->front().getIterator();
1460 for (BasicBlock *Block : Blocks) {
1461 // Delete the basic block from the old function, and the list of blocks
1462 Block->removeFromParent();
1463
1464 // Insert this basic block into the new function
1465 // Insert the original blocks after the entry block created
1466 // for the new function. The entry block may be followed
1467 // by a set of exit blocks at this point, but these exit
1468 // blocks better be placed at the end of the new function.
1469 newFuncIt = newFunction->insert(std::next(newFuncIt), Block);
1470 }
1471}
1472
1473void CodeExtractor::calculateNewCallTerminatorWeights(
1474 BasicBlock *CodeReplacer,
1476 BranchProbabilityInfo *BPI) {
1477 using Distribution = BlockFrequencyInfoImplBase::Distribution;
1478 using BlockNode = BlockFrequencyInfoImplBase::BlockNode;
1479
1480 // Update the branch weights for the exit block.
1481 Instruction *TI = CodeReplacer->getTerminator();
1482 SmallVector<unsigned, 8> BranchWeights(TI->getNumSuccessors(), 0);
1483
1484 // Block Frequency distribution with dummy node.
1485 Distribution BranchDist;
1486
1487 SmallVector<BranchProbability, 4> EdgeProbabilities(
1489
1490 // Add each of the frequencies of the successors.
1491 for (unsigned i = 0, e = TI->getNumSuccessors(); i < e; ++i) {
1492 BlockNode ExitNode(i);
1493 uint64_t ExitFreq = ExitWeights[TI->getSuccessor(i)].getFrequency();
1494 if (ExitFreq != 0)
1495 BranchDist.addExit(ExitNode, ExitFreq);
1496 else
1497 EdgeProbabilities[i] = BranchProbability::getZero();
1498 }
1499
1500 // Check for no total weight.
1501 if (BranchDist.Total == 0) {
1502 BPI->setEdgeProbability(CodeReplacer, EdgeProbabilities);
1503 return;
1504 }
1505
1506 // Normalize the distribution so that they can fit in unsigned.
1507 BranchDist.normalize();
1508
1509 // Create normalized branch weights and set the metadata.
1510 for (unsigned I = 0, E = BranchDist.Weights.size(); I < E; ++I) {
1511 const auto &Weight = BranchDist.Weights[I];
1512
1513 // Get the weight and update the current BFI.
1514 BranchWeights[Weight.TargetNode.Index] = Weight.Amount;
1515 BranchProbability BP(Weight.Amount, BranchDist.Total);
1516 EdgeProbabilities[Weight.TargetNode.Index] = BP;
1517 }
1518 BPI->setEdgeProbability(CodeReplacer, EdgeProbabilities);
1519 TI->setMetadata(
1520 LLVMContext::MD_prof,
1521 MDBuilder(TI->getContext()).createBranchWeights(BranchWeights));
1522}
1523
1524/// Erase debug info intrinsics which refer to values in \p F but aren't in
1525/// \p F.
1527 for (Instruction &I : instructions(F)) {
1529 SmallVector<DbgVariableRecord *, 4> DbgVariableRecords;
1530 findDbgUsers(DbgUsers, &I, &DbgVariableRecords);
1531 for (DbgVariableIntrinsic *DVI : DbgUsers)
1532 if (DVI->getFunction() != &F)
1533 DVI->eraseFromParent();
1534 for (DbgVariableRecord *DVR : DbgVariableRecords)
1535 if (DVR->getFunction() != &F)
1536 DVR->eraseFromParent();
1537 }
1538}
1539
1540/// Fix up the debug info in the old and new functions by pointing line
1541/// locations and debug intrinsics to the new subprogram scope, and by deleting
1542/// intrinsics which point to values outside of the new function.
1543static void fixupDebugInfoPostExtraction(Function &OldFunc, Function &NewFunc,
1544 CallInst &TheCall) {
1545 DISubprogram *OldSP = OldFunc.getSubprogram();
1546 LLVMContext &Ctx = OldFunc.getContext();
1547
1548 if (!OldSP) {
1549 // Erase any debug info the new function contains.
1550 stripDebugInfo(NewFunc);
1551 // Make sure the old function doesn't contain any non-local metadata refs.
1553 return;
1554 }
1555
1556 // Create a subprogram for the new function. Leave out a description of the
1557 // function arguments, as the parameters don't correspond to anything at the
1558 // source level.
1559 assert(OldSP->getUnit() && "Missing compile unit for subprogram");
1560 DIBuilder DIB(*OldFunc.getParent(), /*AllowUnresolved=*/false,
1561 OldSP->getUnit());
1562 auto SPType =
1563 DIB.createSubroutineType(DIB.getOrCreateTypeArray(std::nullopt));
1564 DISubprogram::DISPFlags SPFlags = DISubprogram::SPFlagDefinition |
1565 DISubprogram::SPFlagOptimized |
1566 DISubprogram::SPFlagLocalToUnit;
1567 auto NewSP = DIB.createFunction(
1568 OldSP->getUnit(), NewFunc.getName(), NewFunc.getName(), OldSP->getFile(),
1569 /*LineNo=*/0, SPType, /*ScopeLine=*/0, DINode::FlagZero, SPFlags);
1570 NewFunc.setSubprogram(NewSP);
1571
1572 auto IsInvalidLocation = [&NewFunc](Value *Location) {
1573 // Location is invalid if it isn't a constant or an instruction, or is an
1574 // instruction but isn't in the new function.
1575 if (!Location ||
1576 (!isa<Constant>(Location) && !isa<Instruction>(Location)))
1577 return true;
1578 Instruction *LocationInst = dyn_cast<Instruction>(Location);
1579 return LocationInst && LocationInst->getFunction() != &NewFunc;
1580 };
1581
1582 // Debug intrinsics in the new function need to be updated in one of two
1583 // ways:
1584 // 1) They need to be deleted, because they describe a value in the old
1585 // function.
1586 // 2) They need to point to fresh metadata, e.g. because they currently
1587 // point to a variable in the wrong scope.
1588 SmallDenseMap<DINode *, DINode *> RemappedMetadata;
1589 SmallVector<Instruction *, 4> DebugIntrinsicsToDelete;
1592
1593 auto GetUpdatedDIVariable = [&](DILocalVariable *OldVar) {
1594 DINode *&NewVar = RemappedMetadata[OldVar];
1595 if (!NewVar) {
1597 *OldVar->getScope(), *NewSP, Ctx, Cache);
1598 NewVar = DIB.createAutoVariable(
1599 NewScope, OldVar->getName(), OldVar->getFile(), OldVar->getLine(),
1600 OldVar->getType(), /*AlwaysPreserve=*/false, DINode::FlagZero,
1601 OldVar->getAlignInBits());
1602 }
1603 return cast<DILocalVariable>(NewVar);
1604 };
1605
1606 auto UpdateDbgLabel = [&](auto *LabelRecord) {
1607 // Point the label record to a fresh label within the new function if
1608 // the record was not inlined from some other function.
1609 if (LabelRecord->getDebugLoc().getInlinedAt())
1610 return;
1611 DILabel *OldLabel = LabelRecord->getLabel();
1612 DINode *&NewLabel = RemappedMetadata[OldLabel];
1613 if (!NewLabel) {
1615 *OldLabel->getScope(), *NewSP, Ctx, Cache);
1616 NewLabel = DILabel::get(Ctx, NewScope, OldLabel->getName(),
1617 OldLabel->getFile(), OldLabel->getLine());
1618 }
1619 LabelRecord->setLabel(cast<DILabel>(NewLabel));
1620 };
1621
1622 auto UpdateDbgRecordsOnInst = [&](Instruction &I) -> void {
1623 for (DbgRecord &DR : I.getDbgRecordRange()) {
1624 if (DbgLabelRecord *DLR = dyn_cast<DbgLabelRecord>(&DR)) {
1625 UpdateDbgLabel(DLR);
1626 continue;
1627 }
1628
1629 DbgVariableRecord &DVR = cast<DbgVariableRecord>(DR);
1630 // Apply the two updates that dbg.values get: invalid operands, and
1631 // variable metadata fixup.
1632 if (any_of(DVR.location_ops(), IsInvalidLocation)) {
1633 DVRsToDelete.push_back(&DVR);
1634 continue;
1635 }
1636 if (DVR.isDbgAssign() && IsInvalidLocation(DVR.getAddress())) {
1637 DVRsToDelete.push_back(&DVR);
1638 continue;
1639 }
1640 if (!DVR.getDebugLoc().getInlinedAt())
1641 DVR.setVariable(GetUpdatedDIVariable(DVR.getVariable()));
1642 }
1643 };
1644
1645 for (Instruction &I : instructions(NewFunc)) {
1646 UpdateDbgRecordsOnInst(I);
1647
1648 auto *DII = dyn_cast<DbgInfoIntrinsic>(&I);
1649 if (!DII)
1650 continue;
1651
1652 // Point the intrinsic to a fresh label within the new function if the
1653 // intrinsic was not inlined from some other function.
1654 if (auto *DLI = dyn_cast<DbgLabelInst>(&I)) {
1655 UpdateDbgLabel(DLI);
1656 continue;
1657 }
1658
1659 auto *DVI = cast<DbgVariableIntrinsic>(DII);
1660 // If any of the used locations are invalid, delete the intrinsic.
1661 if (any_of(DVI->location_ops(), IsInvalidLocation)) {
1662 DebugIntrinsicsToDelete.push_back(DVI);
1663 continue;
1664 }
1665 // DbgAssign intrinsics have an extra Value argument:
1666 if (auto *DAI = dyn_cast<DbgAssignIntrinsic>(DVI);
1667 DAI && IsInvalidLocation(DAI->getAddress())) {
1668 DebugIntrinsicsToDelete.push_back(DVI);
1669 continue;
1670 }
1671 // If the variable was in the scope of the old function, i.e. it was not
1672 // inlined, point the intrinsic to a fresh variable within the new function.
1673 if (!DVI->getDebugLoc().getInlinedAt())
1674 DVI->setVariable(GetUpdatedDIVariable(DVI->getVariable()));
1675 }
1676
1677 for (auto *DII : DebugIntrinsicsToDelete)
1678 DII->eraseFromParent();
1679 for (auto *DVR : DVRsToDelete)
1680 DVR->getMarker()->MarkedInstr->dropOneDbgRecord(DVR);
1681 DIB.finalizeSubprogram(NewSP);
1682
1683 // Fix up the scope information attached to the line locations and the
1684 // debug assignment metadata in the new function.
1686 for (Instruction &I : instructions(NewFunc)) {
1687 if (const DebugLoc &DL = I.getDebugLoc())
1688 I.setDebugLoc(
1689 DebugLoc::replaceInlinedAtSubprogram(DL, *NewSP, Ctx, Cache));
1690 for (DbgRecord &DR : I.getDbgRecordRange())
1691 DR.setDebugLoc(DebugLoc::replaceInlinedAtSubprogram(DR.getDebugLoc(),
1692 *NewSP, Ctx, Cache));
1693
1694 // Loop info metadata may contain line locations. Fix them up.
1695 auto updateLoopInfoLoc = [&Ctx, &Cache, NewSP](Metadata *MD) -> Metadata * {
1696 if (auto *Loc = dyn_cast_or_null<DILocation>(MD))
1697 return DebugLoc::replaceInlinedAtSubprogram(Loc, *NewSP, Ctx, Cache);
1698 return MD;
1699 };
1700 updateLoopMetadataDebugLocations(I, updateLoopInfoLoc);
1701 at::remapAssignID(AssignmentIDMap, I);
1702 }
1703 if (!TheCall.getDebugLoc())
1704 TheCall.setDebugLoc(DILocation::get(Ctx, 0, 0, OldSP));
1705
1707}
1708
1709Function *
1711 ValueSet Inputs, Outputs;
1712 return extractCodeRegion(CEAC, Inputs, Outputs);
1713}
1714
1715Function *
1717 ValueSet &inputs, ValueSet &outputs) {
1718 if (!isEligible())
1719 return nullptr;
1720
1721 // Assumption: this is a single-entry code region, and the header is the first
1722 // block in the region.
1723 BasicBlock *header = *Blocks.begin();
1724 Function *oldFunction = header->getParent();
1725
1726 // Calculate the entry frequency of the new function before we change the root
1727 // block.
1728 BlockFrequency EntryFreq;
1729 if (BFI) {
1730 assert(BPI && "Both BPI and BFI are required to preserve profile info");
1731 for (BasicBlock *Pred : predecessors(header)) {
1732 if (Blocks.count(Pred))
1733 continue;
1734 EntryFreq +=
1735 BFI->getBlockFreq(Pred) * BPI->getEdgeProbability(Pred, header);
1736 }
1737 }
1738
1739 // Remove @llvm.assume calls that will be moved to the new function from the
1740 // old function's assumption cache.
1741 for (BasicBlock *Block : Blocks) {
1743 if (auto *AI = dyn_cast<AssumeInst>(&I)) {
1744 if (AC)
1745 AC->unregisterAssumption(AI);
1746 AI->eraseFromParent();
1747 }
1748 }
1749 }
1750
1751 // If we have any return instructions in the region, split those blocks so
1752 // that the return is not in the region.
1753 splitReturnBlocks();
1754
1755 // Calculate the exit blocks for the extracted region and the total exit
1756 // weights for each of those blocks.
1758 SetVector<BasicBlock *> ExitBlocks;
1759 for (BasicBlock *Block : Blocks) {
1760 for (BasicBlock *Succ : successors(Block)) {
1761 if (!Blocks.count(Succ)) {
1762 // Update the branch weight for this successor.
1763 if (BFI) {
1764 BlockFrequency &BF = ExitWeights[Succ];
1765 BF += BFI->getBlockFreq(Block) * BPI->getEdgeProbability(Block, Succ);
1766 }
1767 ExitBlocks.insert(Succ);
1768 }
1769 }
1770 }
1771 NumExitBlocks = ExitBlocks.size();
1772
1773 for (BasicBlock *Block : Blocks) {
1774 for (BasicBlock *OldTarget : successors(Block))
1775 if (!Blocks.contains(OldTarget))
1776 OldTargets.push_back(OldTarget);
1777 }
1778
1779 // If we have to split PHI nodes of the entry or exit blocks, do so now.
1780 severSplitPHINodesOfEntry(header);
1781 severSplitPHINodesOfExits(ExitBlocks);
1782
1783 // This takes place of the original loop
1784 BasicBlock *codeReplacer = BasicBlock::Create(header->getContext(),
1785 "codeRepl", oldFunction,
1786 header);
1787 codeReplacer->IsNewDbgInfoFormat = oldFunction->IsNewDbgInfoFormat;
1788
1789 // The new function needs a root node because other nodes can branch to the
1790 // head of the region, but the entry node of a function cannot have preds.
1791 BasicBlock *newFuncRoot = BasicBlock::Create(header->getContext(),
1792 "newFuncRoot");
1793 newFuncRoot->IsNewDbgInfoFormat = oldFunction->IsNewDbgInfoFormat;
1794
1795 auto *BranchI = BranchInst::Create(header);
1796 // If the original function has debug info, we have to add a debug location
1797 // to the new branch instruction from the artificial entry block.
1798 // We use the debug location of the first instruction in the extracted
1799 // blocks, as there is no other equivalent line in the source code.
1800 if (oldFunction->getSubprogram()) {
1801 any_of(Blocks, [&BranchI](const BasicBlock *BB) {
1802 return any_of(*BB, [&BranchI](const Instruction &I) {
1803 if (!I.getDebugLoc())
1804 return false;
1805 // Don't use source locations attached to debug-intrinsics: they could
1806 // be from completely unrelated scopes.
1807 if (isa<DbgInfoIntrinsic>(I))
1808 return false;
1809 BranchI->setDebugLoc(I.getDebugLoc());
1810 return true;
1811 });
1812 });
1813 }
1814 BranchI->insertInto(newFuncRoot, newFuncRoot->end());
1815
1816 ValueSet SinkingCands, HoistingCands;
1817 BasicBlock *CommonExit = nullptr;
1818 findAllocas(CEAC, SinkingCands, HoistingCands, CommonExit);
1819 assert(HoistingCands.empty() || CommonExit);
1820
1821 // Find inputs to, outputs from the code region.
1822 findInputsOutputs(inputs, outputs, SinkingCands);
1823
1824 // Now sink all instructions which only have non-phi uses inside the region.
1825 // Group the allocas at the start of the block, so that any bitcast uses of
1826 // the allocas are well-defined.
1827 AllocaInst *FirstSunkAlloca = nullptr;
1828 for (auto *II : SinkingCands) {
1829 if (auto *AI = dyn_cast<AllocaInst>(II)) {
1830 AI->moveBefore(*newFuncRoot, newFuncRoot->getFirstInsertionPt());
1831 if (!FirstSunkAlloca)
1832 FirstSunkAlloca = AI;
1833 }
1834 }
1835 assert((SinkingCands.empty() || FirstSunkAlloca) &&
1836 "Did not expect a sink candidate without any allocas");
1837 for (auto *II : SinkingCands) {
1838 if (!isa<AllocaInst>(II)) {
1839 cast<Instruction>(II)->moveAfter(FirstSunkAlloca);
1840 }
1841 }
1842
1843 if (!HoistingCands.empty()) {
1844 auto *HoistToBlock = findOrCreateBlockForHoisting(CommonExit);
1845 Instruction *TI = HoistToBlock->getTerminator();
1846 for (auto *II : HoistingCands)
1847 cast<Instruction>(II)->moveBefore(TI);
1848 }
1849
1850 // Collect objects which are inputs to the extraction region and also
1851 // referenced by lifetime start markers within it. The effects of these
1852 // markers must be replicated in the calling function to prevent the stack
1853 // coloring pass from merging slots which store input objects.
1854 ValueSet LifetimesStart;
1855 eraseLifetimeMarkersOnInputs(Blocks, SinkingCands, LifetimesStart);
1856
1857 // Construct new function based on inputs/outputs & add allocas for all defs.
1858 Function *newFunction =
1859 constructFunction(inputs, outputs, header, newFuncRoot, codeReplacer,
1860 oldFunction, oldFunction->getParent());
1861
1862 // Update the entry count of the function.
1863 if (BFI) {
1864 auto Count = BFI->getProfileCountFromFreq(EntryFreq);
1865 if (Count)
1866 newFunction->setEntryCount(
1867 ProfileCount(*Count, Function::PCT_Real)); // FIXME
1868 BFI->setBlockFreq(codeReplacer, EntryFreq);
1869 }
1870
1871 CallInst *TheCall =
1872 emitCallAndSwitchStatement(newFunction, codeReplacer, inputs, outputs);
1873
1874 moveCodeToFunction(newFunction);
1875
1876 // Replicate the effects of any lifetime start/end markers which referenced
1877 // input objects in the extraction region by placing markers around the call.
1879 oldFunction->getParent(), LifetimesStart.getArrayRef(), {}, TheCall);
1880
1881 // Propagate personality info to the new function if there is one.
1882 if (oldFunction->hasPersonalityFn())
1883 newFunction->setPersonalityFn(oldFunction->getPersonalityFn());
1884
1885 // Update the branch weights for the exit block.
1886 if (BFI && NumExitBlocks > 1)
1887 calculateNewCallTerminatorWeights(codeReplacer, ExitWeights, BPI);
1888
1889 // Loop over all of the PHI nodes in the header and exit blocks, and change
1890 // any references to the old incoming edge to be the new incoming edge.
1891 for (BasicBlock::iterator I = header->begin(); isa<PHINode>(I); ++I) {
1892 PHINode *PN = cast<PHINode>(I);
1893 for (unsigned i = 0, e = PN->getNumIncomingValues(); i != e; ++i)
1894 if (!Blocks.count(PN->getIncomingBlock(i)))
1895 PN->setIncomingBlock(i, newFuncRoot);
1896 }
1897
1898 for (BasicBlock *ExitBB : ExitBlocks)
1899 for (PHINode &PN : ExitBB->phis()) {
1900 Value *IncomingCodeReplacerVal = nullptr;
1901 for (unsigned i = 0, e = PN.getNumIncomingValues(); i != e; ++i) {
1902 // Ignore incoming values from outside of the extracted region.
1903 if (!Blocks.count(PN.getIncomingBlock(i)))
1904 continue;
1905
1906 // Ensure that there is only one incoming value from codeReplacer.
1907 if (!IncomingCodeReplacerVal) {
1908 PN.setIncomingBlock(i, codeReplacer);
1909 IncomingCodeReplacerVal = PN.getIncomingValue(i);
1910 } else
1911 assert(IncomingCodeReplacerVal == PN.getIncomingValue(i) &&
1912 "PHI has two incompatbile incoming values from codeRepl");
1913 }
1914 }
1915
1916 fixupDebugInfoPostExtraction(*oldFunction, *newFunction, *TheCall);
1917
1918 LLVM_DEBUG(if (verifyFunction(*newFunction, &errs())) {
1919 newFunction->dump();
1920 report_fatal_error("verification of newFunction failed!");
1921 });
1922 LLVM_DEBUG(if (verifyFunction(*oldFunction))
1923 report_fatal_error("verification of oldFunction failed!"));
1924 LLVM_DEBUG(if (AC && verifyAssumptionCache(*oldFunction, *newFunction, AC))
1925 report_fatal_error("Stale Asumption cache for old Function!"));
1926 return newFunction;
1927}
1928
1930 const Function &NewFunc,
1931 AssumptionCache *AC) {
1932 for (auto AssumeVH : AC->assumptions()) {
1933 auto *I = dyn_cast_or_null<CallInst>(AssumeVH);
1934 if (!I)
1935 continue;
1936
1937 // There shouldn't be any llvm.assume intrinsics in the new function.
1938 if (I->getFunction() != &OldFunc)
1939 return true;
1940
1941 // There shouldn't be any stale affected values in the assumption cache
1942 // that were previously in the old function, but that have now been moved
1943 // to the new function.
1944 for (auto AffectedValVH : AC->assumptionsFor(I->getOperand(0))) {
1945 auto *AffectedCI = dyn_cast_or_null<CallInst>(AffectedValVH);
1946 if (!AffectedCI)
1947 continue;
1948 if (AffectedCI->getFunction() != &OldFunc)
1949 return true;
1950 auto *AssumedInst = cast<Instruction>(AffectedCI->getOperand(0));
1951 if (AssumedInst->getFunction() != &OldFunc)
1952 return true;
1953 }
1954 }
1955 return false;
1956}
1957
1959 ExcludeArgsFromAggregate.insert(Arg);
1960}
MachineBasicBlock MachineBasicBlock::iterator DebugLoc DL
AMDGPU Mark last scratch load
Expand Atomic instructions
This file contains the simple types necessary to represent the attributes associated with functions a...
static const Function * getParent(const Value *V)
Analysis containing CSE Info
Definition: CSEInfo.cpp:27
static void eraseDebugIntrinsicsWithNonLocalRefs(Function &F)
Erase debug info intrinsics which refer to values in F but aren't in F.
static SetVector< BasicBlock * > buildExtractionBlockSet(ArrayRef< BasicBlock * > BBs, DominatorTree *DT, bool AllowVarArgs, bool AllowAlloca)
Build a set of blocks to extract if the input blocks are viable.
static bool definedInRegion(const SetVector< BasicBlock * > &Blocks, Value *V)
definedInRegion - Return true if the specified value is defined in the extracted region.
static bool definedInCaller(const SetVector< BasicBlock * > &Blocks, Value *V)
definedInCaller - Return true if the specified value is defined in the function being code extracted,...
static bool isBlockValidForExtraction(const BasicBlock &BB, const SetVector< BasicBlock * > &Result, bool AllowVarArgs, bool AllowAlloca)
Test whether a block is valid for extraction.
static BasicBlock * getCommonExitBlock(const SetVector< BasicBlock * > &Blocks)
static void eraseLifetimeMarkersOnInputs(const SetVector< BasicBlock * > &Blocks, const SetVector< Value * > &SunkAllocas, SetVector< Value * > &LifetimesStart)
Erase lifetime.start markers which reference inputs to the extraction region, and insert the referenc...
static void fixupDebugInfoPostExtraction(Function &OldFunc, Function &NewFunc, CallInst &TheCall)
Fix up the debug info in the old and new functions by pointing line locations and debug intrinsics to...
static cl::opt< bool > AggregateArgsOpt("aggregate-extracted-args", cl::Hidden, cl::desc("Aggregate arguments to code-extracted functions"))
static void insertLifetimeMarkersSurroundingCall(Module *M, ArrayRef< Value * > LifetimesStart, ArrayRef< Value * > LifetimesEnd, CallInst *TheCall)
Insert lifetime start/end markers surrounding the call to the new function for objects defined in the...
This file contains the declarations for the subclasses of Constant, which represent the different fla...
Returns the sub type a function will return at a given Idx Should correspond to the result type of an ExtractValue instruction executed with just that one unsigned Idx
Given that RA is a live value
#define LLVM_DEBUG(X)
Definition: Debug.h:101
This file defines the DenseMap class.
uint64_t Addr
DenseMap< Block *, BlockRelaxAux > Blocks
Definition: ELF_riscv.cpp:507
static Function * getFunction(Constant *C)
Definition: Evaluator.cpp:236
Hexagon Common GEP
This file provides various utilities for inspecting and working with the control flow graph in LLVM I...
iv Induction Variable Users
Definition: IVUsers.cpp:48
Move duplicate certain instructions close to their use
Definition: Localizer.cpp:33
#define F(x, y, z)
Definition: MD5.cpp:55
#define I(x, y, z)
Definition: MD5.cpp:58
Module.h This file contains the declarations for the Module class.
uint64_t IntrinsicInst * II
if(VerifyEach)
static StringRef getName(Value *V)
assert(ImpDefSCC.getReg()==AMDGPU::SCC &&ImpDefSCC.isDef())
This file contains some templates that are useful if you are working with the STL at all.
This file implements a set that has insertion order iteration characteristics.
This file defines the SmallPtrSet class.
This file defines the SmallVector class.
static SymbolRef::Type getType(const Symbol *Sym)
Definition: TapiFile.cpp:40
@ Struct
This class represents a conversion between pointers from one address space to another.
an instruction to allocate memory on the stack
Definition: Instructions.h:60
This class represents an incoming formal argument to a Function.
Definition: Argument.h:31
ArrayRef - Represent a constant reference to an array (0 or more elements consecutively in memory),...
Definition: ArrayRef.h:41
bool empty() const
empty - Check if the array is empty.
Definition: ArrayRef.h:160
A cache of @llvm.assume calls within a function.
MutableArrayRef< ResultElem > assumptions()
Access the list of assumption handles currently tracked for this function.
void unregisterAssumption(AssumeInst *CI)
Remove an @llvm.assume intrinsic from this function's cache if it has been added to the cache earlier...
MutableArrayRef< ResultElem > assumptionsFor(const Value *V)
Access the list of assumptions which affect this value.
AttributeSet getFnAttrs() const
The function attributes are returned.
@ TombstoneKey
Use as Tombstone key for DenseMap of AttrKind.
Definition: Attributes.h:93
@ None
No attributes have been set.
Definition: Attributes.h:88
@ EmptyKey
Use as Empty key for DenseMap of AttrKind.
Definition: Attributes.h:92
@ EndAttrKinds
Sentinel value useful for loops.
Definition: Attributes.h:91
LLVM Basic Block Representation.
Definition: BasicBlock.h:61
iterator end()
Definition: BasicBlock.h:451
iterator begin()
Instruction iterator methods.
Definition: BasicBlock.h:438
const_iterator getFirstInsertionPt() const
Returns an iterator to the first instruction in this block that is suitable for inserting a non-PHI i...
Definition: BasicBlock.cpp:414
iterator_range< filter_iterator< BasicBlock::const_iterator, std::function< bool(const Instruction &)> > > instructionsWithoutDebug(bool SkipPseudoOp=true) const
Return a const iterator range over the instructions in the block, skipping any debug instructions.
Definition: BasicBlock.cpp:248
bool hasAddressTaken() const
Returns true if there are any uses of this basic block other than direct branches,...
Definition: BasicBlock.h:648
InstListType::const_iterator getFirstNonPHIIt() const
Iterator returning form of getFirstNonPHI.
Definition: BasicBlock.cpp:372
InstListType::const_iterator const_iterator
Definition: BasicBlock.h:168
const Instruction * getFirstNonPHI() const
Returns a pointer to the first instruction in this block that is not a PHINode instruction.
Definition: BasicBlock.cpp:365
static BasicBlock * Create(LLVMContext &Context, const Twine &Name="", Function *Parent=nullptr, BasicBlock *InsertBefore=nullptr)
Creates a new BasicBlock.
Definition: BasicBlock.h:202
BasicBlock * splitBasicBlock(iterator I, const Twine &BBName="", bool Before=false)
Split the basic block into two basic blocks at the specified instruction.
Definition: BasicBlock.cpp:575
const Function * getParent() const
Return the enclosing method, or null if none.
Definition: BasicBlock.h:209
InstListType::iterator iterator
Instruction iterators...
Definition: BasicBlock.h:167
LLVMContext & getContext() const
Get the context in which this basic block lives.
Definition: BasicBlock.cpp:168
bool IsNewDbgInfoFormat
Flag recording whether or not this block stores debug-info in the form of intrinsic instructions (fal...
Definition: BasicBlock.h:67
const Instruction * getTerminator() const LLVM_READONLY
Returns the terminator instruction if the block is well formed or null if the block is not well forme...
Definition: BasicBlock.h:229
BlockFrequencyInfo pass uses BlockFrequencyInfoImpl implementation to estimate IR basic block frequen...
std::optional< uint64_t > getProfileCountFromFreq(BlockFrequency Freq) const
Returns the estimated profile count of Freq.
void setBlockFreq(const BasicBlock *BB, BlockFrequency Freq)
BlockFrequency getBlockFreq(const BasicBlock *BB) const
getblockFreq - Return block frequency.
static BranchInst * Create(BasicBlock *IfTrue, InsertPosition InsertBefore=nullptr)
Analysis providing branch probability information.
void setEdgeProbability(const BasicBlock *Src, const SmallVectorImpl< BranchProbability > &Probs)
Set the raw probabilities for all edges from the given block.
BranchProbability getEdgeProbability(const BasicBlock *Src, unsigned IndexInSuccessors) const
Get an edge's probability, relative to other out-edges of the Src.
static BranchProbability getUnknown()
static BranchProbability getZero()
void addParamAttr(unsigned ArgNo, Attribute::AttrKind Kind)
Adds the attribute to the indicated argument.
Definition: InstrTypes.h:1594
This class represents a function call, abstracting a target machine's calling convention.
static CallInst * Create(FunctionType *Ty, Value *F, const Twine &NameStr="", InsertPosition InsertBefore=nullptr)
This is the base class for all instructions that perform data casts.
Definition: InstrTypes.h:530
static CastInst * CreatePointerCast(Value *S, Type *Ty, const Twine &Name="", InsertPosition InsertBefore=nullptr)
Create a BitCast, AddrSpaceCast or a PtrToInt cast instruction.
A cache for the CodeExtractor analysis.
Definition: CodeExtractor.h:46
ArrayRef< AllocaInst * > getAllocas() const
Get the allocas in the function at the time the analysis was created.
Definition: CodeExtractor.h:65
bool doesBlockContainClobberOfAddr(BasicBlock &BB, AllocaInst *Addr) const
Check whether BB contains an instruction thought to load from, store to, or otherwise clobber the all...
CodeExtractor(ArrayRef< BasicBlock * > BBs, DominatorTree *DT=nullptr, bool AggregateArgs=false, BlockFrequencyInfo *BFI=nullptr, BranchProbabilityInfo *BPI=nullptr, AssumptionCache *AC=nullptr, bool AllowVarArgs=false, bool AllowAlloca=false, BasicBlock *AllocationBlock=nullptr, std::string Suffix="", bool ArgsInZeroAddressSpace=false)
Create a code extractor for a sequence of blocks.
BasicBlock * findOrCreateBlockForHoisting(BasicBlock *CommonExitBlock)
Find or create a block within the outline region for placing hoisted code.
void findInputsOutputs(ValueSet &Inputs, ValueSet &Outputs, const ValueSet &Allocas) const
Compute the set of input values and output values for the code.
void findAllocas(const CodeExtractorAnalysisCache &CEAC, ValueSet &SinkCands, ValueSet &HoistCands, BasicBlock *&ExitBlock) const
Find the set of allocas whose life ranges are contained within the outlined region.
Function * extractCodeRegion(const CodeExtractorAnalysisCache &CEAC)
Perform the extraction, returning the new function.
static bool verifyAssumptionCache(const Function &OldFunc, const Function &NewFunc, AssumptionCache *AC)
Verify that assumption cache isn't stale after a region is extracted.
bool isEligible() const
Test whether this code extractor is eligible.
void excludeArgFromAggregate(Value *Arg)
Exclude a value from aggregate argument passing when extracting a code region, passing it instead as ...
bool isLegalToShrinkwrapLifetimeMarkers(const CodeExtractorAnalysisCache &CEAC, Instruction *AllocaAddr) const
Check if life time marker nodes can be hoisted/sunk into the outline region.
static ConstantInt * getSigned(IntegerType *Ty, int64_t V)
Return a ConstantInt with the specified value for the specified type.
Definition: Constants.h:124
static Constant * getNullValue(Type *Ty)
Constructor to create a '0' constant of arbitrary type.
Definition: Constants.cpp:370
DISubroutineType * createSubroutineType(DITypeRefArray ParameterTypes, DINode::DIFlags Flags=DINode::FlagZero, unsigned CC=0)
Create subroutine type.
Definition: DIBuilder.cpp:559
void finalizeSubprogram(DISubprogram *SP)
Finalize a specific subprogram - no new variables may be added to this subprogram afterwards.
Definition: DIBuilder.cpp:56
DISubprogram * createFunction(DIScope *Scope, StringRef Name, StringRef LinkageName, DIFile *File, unsigned LineNo, DISubroutineType *Ty, unsigned ScopeLine, DINode::DIFlags Flags=DINode::FlagZero, DISubprogram::DISPFlags SPFlags=DISubprogram::SPFlagZero, DITemplateParameterArray TParams=nullptr, DISubprogram *Decl=nullptr, DITypeArray ThrownTypes=nullptr, DINodeArray Annotations=nullptr, StringRef TargetFuncName="")
Create a new descriptor for the specified subprogram.
Definition: DIBuilder.cpp:855
DITypeRefArray getOrCreateTypeArray(ArrayRef< Metadata * > Elements)
Get a DITypeRefArray, create one if required.
Definition: DIBuilder.cpp:702
DILocalVariable * createAutoVariable(DIScope *Scope, StringRef Name, DIFile *File, unsigned LineNo, DIType *Ty, bool AlwaysPreserve=false, DINode::DIFlags Flags=DINode::FlagZero, uint32_t AlignInBits=0)
Create a new descriptor for an auto variable.
Definition: DIBuilder.cpp:806
DIFile * getFile() const
StringRef getName() const
unsigned getLine() const
DILocalScope * getScope() const
Get the local scope for this label.
A scope for locals.
static DILocalScope * cloneScopeForSubprogram(DILocalScope &RootScope, DISubprogram &NewSP, LLVMContext &Ctx, DenseMap< const MDNode *, MDNode * > &Cache)
Traverses the scope chain rooted at RootScope until it hits a Subprogram, recreating the chain with "...
Tagged DWARF-like metadata node.
StringRef getName() const
DIFile * getFile() const
Subprogram description.
DISPFlags
Debug info subprogram flags.
A parsed version of the target data layout string in and methods for querying it.
Definition: DataLayout.h:110
Records a position in IR for a source label (DILabel).
Base class for non-instruction debug metadata records that have positions within IR.
DebugLoc getDebugLoc() const
This is the common base class for debug info intrinsics for variables.
Record of a variable value-assignment, aka a non instruction representation of the dbg....
void setVariable(DILocalVariable *NewVar)
DILocalVariable * getVariable() const
iterator_range< location_op_iterator > location_ops() const
Get the locations corresponding to the variable referenced by the debug info intrinsic.
A debug info location.
Definition: DebugLoc.h:33
static DebugLoc replaceInlinedAtSubprogram(const DebugLoc &DL, DISubprogram &NewSP, LLVMContext &Ctx, DenseMap< const MDNode *, MDNode * > &Cache)
Rebuild the entire inline-at chain by replacing the subprogram at the end of the chain with NewSP.
Definition: DebugLoc.cpp:70
DILocation * getInlinedAt() const
Definition: DebugLoc.cpp:39
void changeImmediateDominator(DomTreeNodeBase< NodeT > *N, DomTreeNodeBase< NodeT > *NewIDom)
changeImmediateDominator - This method is used to update the dominator tree information when a node's...
DomTreeNodeBase< NodeT > * addNewBlock(NodeT *BB, NodeT *DomBB)
Add a new node to the dominator tree information.
DomTreeNodeBase< NodeT > * getNode(const NodeT *BB) const
getNode - return the (Post)DominatorTree node for the specified basic block.
Concrete subclass of DominatorTreeBase that is used to compute a normal dominator tree.
Definition: Dominators.h:162
bool isReachableFromEntry(const Use &U) const
Provide an overload for a Use.
Definition: Dominators.cpp:321
static FunctionType * get(Type *Result, ArrayRef< Type * > Params, bool isVarArg)
This static method is the primary way of constructing a FunctionType.
Class to represent profile counts.
Definition: Function.h:289
void addFnAttr(Attribute::AttrKind Kind)
Add function attributes to this function.
Definition: Function.cpp:600
void setSubprogram(DISubprogram *SP)
Set the attached subprogram.
Definition: Metadata.cpp:1826
static Function * Create(FunctionType *Ty, LinkageTypes Linkage, unsigned AddrSpace, const Twine &N="", Module *M=nullptr)
Definition: Function.h:165
const BasicBlock & getEntryBlock() const
Definition: Function.h:800
const BasicBlock & front() const
Definition: Function.h:823
DISubprogram * getSubprogram() const
Get the attached subprogram.
Definition: Metadata.cpp:1830
void setDoesNotReturn()
Definition: Function.h:578
bool IsNewDbgInfoFormat
Is this function using intrinsics to record the position of debugging information,...
Definition: Function.h:108
bool hasPersonalityFn() const
Check whether this function has a personality function.
Definition: Function.h:868
Constant * getPersonalityFn() const
Get the personality function associated with this function.
Definition: Function.cpp:1934
void setPersonalityFn(Constant *Fn)
Definition: Function.cpp:1939
AttributeList getAttributes() const
Return the attribute list for this Function.
Definition: Function.h:350
arg_iterator arg_end()
Definition: Function.h:840
iterator begin()
Definition: Function.h:816
arg_iterator arg_begin()
Definition: Function.h:831
LLVMContext & getContext() const
getContext - Return a reference to the LLVMContext associated with this function.
Definition: Function.cpp:358
void addParamAttr(unsigned ArgNo, Attribute::AttrKind Kind)
adds the attribute to the list of attributes for the given arg.
Definition: Function.cpp:628
Function::iterator insert(Function::iterator Position, BasicBlock *BB)
Insert BB in the basic block list at Position.
Definition: Function.h:745
bool doesNotReturn() const
Determine if the function cannot return.
Definition: Function.h:575
iterator end()
Definition: Function.h:818
void setEntryCount(ProfileCount Count, const DenseSet< GlobalValue::GUID > *Imports=nullptr)
Set the entry count for this function.
Definition: Function.cpp:1997
bool isVarArg() const
isVarArg - Return true if this function takes a variable number of arguments.
Definition: Function.h:225
an instruction for type-safe pointer arithmetic to access elements of arrays and structs
Definition: Instructions.h:914
static GetElementPtrInst * Create(Type *PointeeType, Value *Ptr, ArrayRef< Value * > IdxList, const Twine &NameStr="", InsertPosition InsertBefore=nullptr)
Definition: Instructions.h:937
unsigned getAddressSpace() const
Definition: GlobalValue.h:205
Module * getParent()
Get the module that this global value is contained inside of...
Definition: GlobalValue.h:656
@ InternalLinkage
Rename collisions when linking (static functions).
Definition: GlobalValue.h:59
bool isLifetimeStartOrEnd() const LLVM_READONLY
Return true if the instruction is a llvm.lifetime.start or llvm.lifetime.end marker.
unsigned getNumSuccessors() const LLVM_READONLY
Return the number of successors that this instruction has.
void insertBefore(Instruction *InsertPos)
Insert an unlinked instruction into a basic block immediately before the specified instruction.
Definition: Instruction.cpp:97
const DebugLoc & getDebugLoc() const
Return the debug location for this node as a DebugLoc.
Definition: Instruction.h:476
InstListType::iterator eraseFromParent()
This method unlinks 'this' from the containing basic block and deletes it.
Definition: Instruction.cpp:92
const Function * getFunction() const
Return the function this instruction belongs to.
Definition: Instruction.cpp:70
BasicBlock * getSuccessor(unsigned Idx) const LLVM_READONLY
Return the specified successor. This instruction must be a terminator.
void setMetadata(unsigned KindID, MDNode *Node)
Set the metadata of the specified kind to the specified node.
Definition: Metadata.cpp:1635
void setDebugLoc(DebugLoc Loc)
Set the debug location information for this instruction.
Definition: Instruction.h:473
void setSuccessor(unsigned Idx, BasicBlock *BB)
Update the specified successor to point at the provided block.
void moveBefore(Instruction *MovePos)
Unlink this instruction from its current basic block and insert it into the basic block that MovePos ...
InstListType::iterator insertInto(BasicBlock *ParentBB, InstListType::iterator It)
Inserts an unlinked instruction into ParentBB at position It and returns the iterator of the inserted...
A wrapper class for inspecting calls to intrinsic functions.
Definition: IntrinsicInst.h:48
Intrinsic::ID getIntrinsicID() const
Return the intrinsic ID of this intrinsic.
Definition: IntrinsicInst.h:55
This is an important class for using LLVM in a threaded context.
Definition: LLVMContext.h:67
An instruction for reading from memory.
Definition: Instructions.h:173
Value * getPointerOperand()
Definition: Instructions.h:252
Represents a single loop in the control flow graph.
Definition: LoopInfo.h:44
MDNode * createBranchWeights(uint32_t TrueWeight, uint32_t FalseWeight, bool IsExpected=false)
Return metadata containing two branch weights.
Definition: MDBuilder.cpp:37
static MDTuple * get(LLVMContext &Context, ArrayRef< Metadata * > MDs)
Definition: Metadata.h:1541
StringRef getName() const
Return the name of the corresponding LLVM basic block, or an empty string.
Root of the metadata hierarchy.
Definition: Metadata.h:62
A Module instance is used to store all the information related to an LLVM module.
Definition: Module.h:65
void addIncoming(Value *V, BasicBlock *BB)
Add an incoming value to the end of the PHI list.
void setIncomingBlock(unsigned i, BasicBlock *BB)
Value * removeIncomingValue(unsigned Idx, bool DeletePHIIfEmpty=true)
Remove an incoming value.
BasicBlock * getIncomingBlock(unsigned i) const
Return incoming basic block number i.
Value * getIncomingValue(unsigned i) const
Return incoming value number x.
unsigned getNumIncomingValues() const
Return the number of incoming edges.
static PHINode * Create(Type *Ty, unsigned NumReservedValues, const Twine &NameStr="", InsertPosition InsertBefore=nullptr)
Constructors - NumReservedValues is a hint for the number of incoming edges that this phi node will h...
static PointerType * get(Type *ElementType, unsigned AddressSpace)
This constructs a pointer to an object of the specified type in a numbered address space.
static PointerType * getUnqual(Type *ElementType)
This constructs a pointer to an object of the specified type in the default address space (address sp...
Definition: DerivedTypes.h:662
Return a value (possibly void), from a function.
static ReturnInst * Create(LLVMContext &C, Value *retVal=nullptr, InsertPosition InsertBefore=nullptr)
A vector that has set insertion semantics.
Definition: SetVector.h:57
ArrayRef< value_type > getArrayRef() const
Definition: SetVector.h:84
size_type size() const
Determine the number of elements in the SetVector.
Definition: SetVector.h:98
size_type count(const key_type &key) const
Count the number of elements of a given key in the SetVector.
Definition: SetVector.h:264
bool empty() const
Determine if the SetVector is empty or not.
Definition: SetVector.h:93
bool insert(const value_type &X)
Insert a new element into the SetVector.
Definition: SetVector.h:162
bool contains(const key_type &key) const
Check if the SetVector contains the given key.
Definition: SetVector.h:254
std::pair< iterator, bool > insert(PtrType Ptr)
Inserts Ptr if and only if there is no element in the container equal to Ptr.
Definition: SmallPtrSet.h:344
SmallPtrSet - This class implements a set which is optimized for holding SmallSize or less elements.
Definition: SmallPtrSet.h:479
bool empty() const
Definition: SmallVector.h:94
size_t size() const
Definition: SmallVector.h:91
iterator insert(iterator I, T &&Elt)
Definition: SmallVector.h:818
void push_back(const T &Elt)
Definition: SmallVector.h:426
This is a 'vector' (really, a variable-sized array), optimized for the case when the array is small.
Definition: SmallVector.h:1209
An instruction for storing to memory.
Definition: Instructions.h:289
std::string str() const
str - Get the contents as an std::string.
Definition: StringRef.h:223
constexpr bool empty() const
empty - Check if the string is empty.
Definition: StringRef.h:134
Class to represent struct types.
Definition: DerivedTypes.h:216
static StructType * get(LLVMContext &Context, ArrayRef< Type * > Elements, bool isPacked=false)
This static method is the primary way to create a literal StructType.
Definition: Type.cpp:373
Type * getElementType(unsigned N) const
Definition: DerivedTypes.h:342
Multiway switch.
BasicBlock * getSuccessor(unsigned idx) const
static SwitchInst * Create(Value *Value, BasicBlock *Default, unsigned NumCases, InsertPosition InsertBefore=nullptr)
void setCondition(Value *V)
void addCase(ConstantInt *OnVal, BasicBlock *Dest)
Add an entry to the switch instruction.
void setDefaultDest(BasicBlock *DefaultCase)
Value * getCondition() const
CaseIt removeCase(CaseIt I)
This method removes the specified case and its successor from the switch instruction.
The instances of the Type class are immutable: once they are created, they are never changed.
Definition: Type.h:45
static IntegerType * getInt1Ty(LLVMContext &C)
static Type * getVoidTy(LLVMContext &C)
static IntegerType * getInt16Ty(LLVMContext &C)
static IntegerType * getInt32Ty(LLVMContext &C)
static IntegerType * getInt64Ty(LLVMContext &C)
bool isVoidTy() const
Return true if this is 'void'.
Definition: Type.h:140
This function has undefined behavior.
op_range operands()
Definition: User.h:242
bool replaceUsesOfWith(Value *From, Value *To)
Replace uses of one Value with another.
Definition: User.cpp:21
LLVM Value Representation.
Definition: Value.h:74
Type * getType() const
All values are typed, get the type of this value.
Definition: Value.h:255
user_iterator user_begin()
Definition: Value.h:397
void setName(const Twine &Name)
Change the name of the value.
Definition: Value.cpp:377
const Value * stripInBoundsConstantOffsets() const
Strip off pointer casts and all-constant inbounds GEPs.
Definition: Value.cpp:705
void replaceAllUsesWith(Value *V)
Change all uses of this to point to a new Value.
Definition: Value.cpp:534
user_iterator user_end()
Definition: Value.h:405
LLVMContext & getContext() const
All values hold a context through their type.
Definition: Value.cpp:1074
StringRef getName() const
Return a constant reference to the value's name.
Definition: Value.cpp:309
void dump() const
Support for debugging, callable in GDB: V->dump()
Definition: AsmWriter.cpp:5265
const ParentTy * getParent() const
Definition: ilist_node.h:32
self_iterator getIterator()
Definition: ilist_node.h:132
#define llvm_unreachable(msg)
Marks that the current location is not supposed to be reachable.
Function * getDeclaration(Module *M, ID id, ArrayRef< Type * > Tys=std::nullopt)
Create or insert an LLVM Function declaration for an intrinsic, and return it.
Definition: Function.cpp:1484
void remapAssignID(DenseMap< DIAssignID *, DIAssignID * > &Map, Instruction &I)
Replace DIAssignID uses and attachments with IDs from Map.
Definition: DebugInfo.cpp:2049
NodeAddr< PhiNode * > Phi
Definition: RDFGraph.h:390
This is an optimization pass for GlobalISel generic memory operations.
Definition: AddressRanges.h:18
bool stripDebugInfo(Function &F)
Definition: DebugInfo.cpp:552
Function::ProfileCount ProfileCount
bool verifyFunction(const Function &F, raw_ostream *OS=nullptr)
Check a function for errors, useful for use when debugging a pass.
Definition: Verifier.cpp:7095
void findDbgUsers(SmallVectorImpl< DbgVariableIntrinsic * > &DbgInsts, Value *V, SmallVectorImpl< DbgVariableRecord * > *DbgVariableRecords=nullptr)
Finds the debug info intrinsics describing a value.
Definition: DebugInfo.cpp:145
auto successors(const MachineBasicBlock *BB)
iterator_range< early_inc_iterator_impl< detail::IterOfRange< RangeT > > > make_early_inc_range(RangeT &&Range)
Make a range that does early increment to allow mutation of the underlying range without disrupting i...
Definition: STLExtras.h:656
bool any_of(R &&range, UnaryPredicate P)
Provide wrappers to std::any_of which take ranges instead of having to pass begin/end explicitly.
Definition: STLExtras.h:1729
auto reverse(ContainerTy &&C)
Definition: STLExtras.h:419
raw_ostream & dbgs()
dbgs() - This returns a reference to a raw_ostream for debugging messages.
Definition: Debug.cpp:163
bool none_of(R &&Range, UnaryPredicate P)
Provide wrappers to std::none_of which take ranges instead of having to pass begin/end explicitly.
Definition: STLExtras.h:1736
void report_fatal_error(Error Err, bool gen_crash_diag=true)
Report a serious error, calling any installed error handler.
Definition: Error.cpp:167
raw_fd_ostream & errs()
This returns a reference to a raw_ostream for standard error.
BasicBlock * SplitBlock(BasicBlock *Old, BasicBlock::iterator SplitPt, DominatorTree *DT, LoopInfo *LI=nullptr, MemorySSAUpdater *MSSAU=nullptr, const Twine &BBName="", bool Before=false)
Split the specified block at the specified instruction.
auto predecessors(const MachineBasicBlock *BB)
void updateLoopMetadataDebugLocations(Instruction &I, function_ref< Metadata *(Metadata *)> Updater)
Update the debug locations contained within the MD_loop metadata attached to the instruction I,...
Definition: DebugInfo.cpp:422
Distribution of unscaled probability weight.