1 //===- IndirectBrExpandPass.cpp - Expand indirectbr to switch -------------===//
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
7 //===----------------------------------------------------------------------===//
10 /// Implements an expansion pass to turn `indirectbr` instructions in the IR
11 /// into `switch` instructions. This works by enumerating the basic blocks in
12 /// a dense range of integers, replacing each `blockaddr` constant with the
13 /// corresponding integer constant, and then building a switch that maps from
14 /// the integers to the actual blocks. All of the indirectbr instructions in the
15 /// function are redirected to this common switch.
17 /// While this is generically useful if a target is unable to codegen
18 /// `indirectbr` natively, it is primarily useful when there is some desire to
19 /// get the builtin non-jump-table lowering of a switch even when the input
20 /// source contained an explicit indirect branch construct.
22 /// Note that it doesn't make any sense to enable this pass unless a target also
23 /// disables jump-table lowering of switches. Doing that is likely to pessimize
26 //===----------------------------------------------------------------------===//
28 #include "llvm/ADT/STLExtras.h"
29 #include "llvm/ADT/Sequence.h"
30 #include "llvm/ADT/SmallVector.h"
31 #include "llvm/CodeGen/TargetPassConfig.h"
32 #include "llvm/CodeGen/TargetSubtargetInfo.h"
33 #include "llvm/IR/BasicBlock.h"
34 #include "llvm/IR/Function.h"
35 #include "llvm/IR/IRBuilder.h"
36 #include "llvm/IR/InstIterator.h"
37 #include "llvm/IR/Instruction.h"
38 #include "llvm/IR/Instructions.h"
39 #include "llvm/Pass.h"
40 #include "llvm/Support/Debug.h"
41 #include "llvm/Support/ErrorHandling.h"
42 #include "llvm/Support/raw_ostream.h"
43 #include "llvm/Target/TargetMachine.h"
47 #define DEBUG_TYPE "indirectbr-expand"
51 class IndirectBrExpandPass
: public FunctionPass
{
52 const TargetLowering
*TLI
= nullptr;
55 static char ID
; // Pass identification, replacement for typeid
57 IndirectBrExpandPass() : FunctionPass(ID
) {
58 initializeIndirectBrExpandPassPass(*PassRegistry::getPassRegistry());
61 bool runOnFunction(Function
&F
) override
;
64 } // end anonymous namespace
66 char IndirectBrExpandPass::ID
= 0;
68 INITIALIZE_PASS(IndirectBrExpandPass
, DEBUG_TYPE
,
69 "Expand indirectbr instructions", false, false)
71 FunctionPass
*llvm::createIndirectBrExpandPass() {
72 return new IndirectBrExpandPass();
75 bool IndirectBrExpandPass::runOnFunction(Function
&F
) {
76 auto &DL
= F
.getParent()->getDataLayout();
77 auto *TPC
= getAnalysisIfAvailable
<TargetPassConfig
>();
81 auto &TM
= TPC
->getTM
<TargetMachine
>();
82 auto &STI
= *TM
.getSubtargetImpl(F
);
83 if (!STI
.enableIndirectBrExpand())
85 TLI
= STI
.getTargetLowering();
87 SmallVector
<IndirectBrInst
*, 1> IndirectBrs
;
89 // Set of all potential successors for indirectbr instructions.
90 SmallPtrSet
<BasicBlock
*, 4> IndirectBrSuccs
;
92 // Build a list of indirectbrs that we want to rewrite.
93 for (BasicBlock
&BB
: F
)
94 if (auto *IBr
= dyn_cast
<IndirectBrInst
>(BB
.getTerminator())) {
95 // Handle the degenerate case of no successors by replacing the indirectbr
96 // with unreachable as there is no successor available.
97 if (IBr
->getNumSuccessors() == 0) {
98 (void)new UnreachableInst(F
.getContext(), IBr
);
99 IBr
->eraseFromParent();
103 IndirectBrs
.push_back(IBr
);
104 for (BasicBlock
*SuccBB
: IBr
->successors())
105 IndirectBrSuccs
.insert(SuccBB
);
108 if (IndirectBrs
.empty())
111 // If we need to replace any indirectbrs we need to establish integer
112 // constants that will correspond to each of the basic blocks in the function
113 // whose address escapes. We do that here and rewrite all the blockaddress
114 // constants to just be those integer constants cast to a pointer type.
115 SmallVector
<BasicBlock
*, 4> BBs
;
117 for (BasicBlock
&BB
: F
) {
118 // Skip blocks that aren't successors to an indirectbr we're going to
120 if (!IndirectBrSuccs
.count(&BB
))
123 auto IsBlockAddressUse
= [&](const Use
&U
) {
124 return isa
<BlockAddress
>(U
.getUser());
126 auto BlockAddressUseIt
= llvm::find_if(BB
.uses(), IsBlockAddressUse
);
127 if (BlockAddressUseIt
== BB
.use_end())
130 assert(std::find_if(std::next(BlockAddressUseIt
), BB
.use_end(),
131 IsBlockAddressUse
) == BB
.use_end() &&
132 "There should only ever be a single blockaddress use because it is "
133 "a constant and should be uniqued.");
135 auto *BA
= cast
<BlockAddress
>(BlockAddressUseIt
->getUser());
137 // Skip if the constant was formed but ended up not being used (due to DCE
139 if (!BA
->isConstantUsed())
142 // Compute the index we want to use for this basic block. We can't use zero
143 // because null can be compared with block addresses.
144 int BBIndex
= BBs
.size() + 1;
147 auto *ITy
= cast
<IntegerType
>(DL
.getIntPtrType(BA
->getType()));
148 ConstantInt
*BBIndexC
= ConstantInt::get(ITy
, BBIndex
);
150 // Now rewrite the blockaddress to an integer constant based on the index.
151 // FIXME: This part doesn't properly recognize other uses of blockaddress
152 // expressions, for instance, where they are used to pass labels to
153 // asm-goto. This part of the pass needs a rework.
154 BA
->replaceAllUsesWith(ConstantExpr::getIntToPtr(BBIndexC
, BA
->getType()));
158 // There are no blocks whose address is taken, so any indirectbr instruction
159 // cannot get a valid input and we can replace all of them with unreachable.
160 for (auto *IBr
: IndirectBrs
) {
161 (void)new UnreachableInst(F
.getContext(), IBr
);
162 IBr
->eraseFromParent();
167 BasicBlock
*SwitchBB
;
170 // Compute a common integer type across all the indirectbr instructions.
171 IntegerType
*CommonITy
= nullptr;
172 for (auto *IBr
: IndirectBrs
) {
174 cast
<IntegerType
>(DL
.getIntPtrType(IBr
->getAddress()->getType()));
175 if (!CommonITy
|| ITy
->getBitWidth() > CommonITy
->getBitWidth())
179 auto GetSwitchValue
= [DL
, CommonITy
](IndirectBrInst
*IBr
) {
180 return CastInst::CreatePointerCast(
181 IBr
->getAddress(), CommonITy
,
182 Twine(IBr
->getAddress()->getName()) + ".switch_cast", IBr
);
185 if (IndirectBrs
.size() == 1) {
186 // If we only have one indirectbr, we can just directly replace it within
188 SwitchBB
= IndirectBrs
[0]->getParent();
189 SwitchValue
= GetSwitchValue(IndirectBrs
[0]);
190 IndirectBrs
[0]->eraseFromParent();
192 // Otherwise we need to create a new block to hold the switch across BBs,
193 // jump to that block instead of each indirectbr, and phi together the
194 // values for the switch.
195 SwitchBB
= BasicBlock::Create(F
.getContext(), "switch_bb", &F
);
196 auto *SwitchPN
= PHINode::Create(CommonITy
, IndirectBrs
.size(),
197 "switch_value_phi", SwitchBB
);
198 SwitchValue
= SwitchPN
;
200 // Now replace the indirectbr instructions with direct branches to the
201 // switch block and fill out the PHI operands.
202 for (auto *IBr
: IndirectBrs
) {
203 SwitchPN
->addIncoming(GetSwitchValue(IBr
), IBr
->getParent());
204 BranchInst::Create(SwitchBB
, IBr
);
205 IBr
->eraseFromParent();
209 // Now build the switch in the block. The block will have no terminator
211 auto *SI
= SwitchInst::Create(SwitchValue
, BBs
[0], BBs
.size(), SwitchBB
);
213 // Add a case for each block.
214 for (int i
: llvm::seq
<int>(1, BBs
.size()))
215 SI
->addCase(ConstantInt::get(CommonITy
, i
+ 1), BBs
[i
]);