1 //===---------------- BPFAdjustOpt.cpp - Adjust Optimization --------------===//
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 //===----------------------------------------------------------------------===//
9 // Adjust optimization to make the code more kernel verifier friendly.
11 //===----------------------------------------------------------------------===//
15 #include "llvm/IR/Instruction.h"
16 #include "llvm/IR/Instructions.h"
17 #include "llvm/IR/IntrinsicsBPF.h"
18 #include "llvm/IR/Module.h"
19 #include "llvm/IR/PatternMatch.h"
20 #include "llvm/IR/Type.h"
21 #include "llvm/IR/User.h"
22 #include "llvm/IR/Value.h"
23 #include "llvm/Pass.h"
24 #include "llvm/Transforms/Utils/BasicBlockUtils.h"
26 #define DEBUG_TYPE "bpf-adjust-opt"
29 using namespace llvm::PatternMatch
;
32 DisableBPFserializeICMP("bpf-disable-serialize-icmp", cl::Hidden
,
33 cl::desc("BPF: Disable Serializing ICMP insns."),
36 static cl::opt
<bool> DisableBPFavoidSpeculation(
37 "bpf-disable-avoid-speculation", cl::Hidden
,
38 cl::desc("BPF: Disable Avoiding Speculative Code Motion."),
42 class BPFAdjustOptImpl
{
43 struct PassThroughInfo
{
45 Instruction
*UsedInst
;
47 PassThroughInfo(Instruction
*I
, Instruction
*U
, uint32_t Idx
)
48 : Input(I
), UsedInst(U
), OpIdx(Idx
) {}
52 BPFAdjustOptImpl(Module
*M
) : M(M
) {}
58 SmallVector
<PassThroughInfo
, 16> PassThroughs
;
60 bool adjustICmpToBuiltin();
61 void adjustBasicBlock(BasicBlock
&BB
);
62 bool serializeICMPCrossBB(BasicBlock
&BB
);
63 void adjustInst(Instruction
&I
);
64 bool serializeICMPInBB(Instruction
&I
);
65 bool avoidSpeculation(Instruction
&I
);
66 bool insertPassThrough();
69 } // End anonymous namespace
71 bool BPFAdjustOptImpl::run() {
72 bool Changed
= adjustICmpToBuiltin();
74 for (Function
&F
: *M
)
80 return insertPassThrough() || Changed
;
83 // Commit acabad9ff6bf ("[InstCombine] try to canonicalize icmp with
84 // trunc op into mask and cmp") added a transformation to
85 // convert "(conv)a < power_2_const" to "a & <const>" in certain
86 // cases and bpf kernel verifier has to handle the resulted code
87 // conservatively and this may reject otherwise legitimate program.
88 // Here, we change related icmp code to a builtin which will
89 // be restored to original icmp code later to prevent that
90 // InstCombine transformatin.
91 bool BPFAdjustOptImpl::adjustICmpToBuiltin() {
93 ICmpInst
*ToBeDeleted
= nullptr;
94 for (Function
&F
: *M
)
98 ToBeDeleted
->eraseFromParent();
99 ToBeDeleted
= nullptr;
102 auto *Icmp
= dyn_cast
<ICmpInst
>(&I
);
106 Value
*Op0
= Icmp
->getOperand(0);
107 if (!isa
<TruncInst
>(Op0
))
110 auto ConstOp1
= dyn_cast
<ConstantInt
>(Icmp
->getOperand(1));
114 auto ConstOp1Val
= ConstOp1
->getValue().getZExtValue();
115 auto Op
= Icmp
->getPredicate();
116 if (Op
== ICmpInst::ICMP_ULT
|| Op
== ICmpInst::ICMP_UGE
) {
117 if ((ConstOp1Val
- 1) & ConstOp1Val
)
119 } else if (Op
== ICmpInst::ICMP_ULE
|| Op
== ICmpInst::ICMP_UGT
) {
120 if (ConstOp1Val
& (ConstOp1Val
+ 1))
127 ConstantInt::get(Type::getInt32Ty(BB
.getContext()), Op
);
128 Function
*Fn
= Intrinsic::getOrInsertDeclaration(
129 M
, Intrinsic::bpf_compare
, {Op0
->getType(), ConstOp1
->getType()});
130 auto *NewInst
= CallInst::Create(Fn
, {Opcode
, Op0
, ConstOp1
});
131 NewInst
->insertBefore(&I
);
132 Icmp
->replaceAllUsesWith(NewInst
);
140 bool BPFAdjustOptImpl::insertPassThrough() {
141 for (auto &Info
: PassThroughs
) {
142 auto *CI
= BPFCoreSharedInfo::insertPassThrough(
143 M
, Info
.UsedInst
->getParent(), Info
.Input
, Info
.UsedInst
);
144 Info
.UsedInst
->setOperand(Info
.OpIdx
, CI
);
147 return !PassThroughs
.empty();
150 // To avoid combining conditionals in the same basic block by
151 // instrcombine optimization.
152 bool BPFAdjustOptImpl::serializeICMPInBB(Instruction
&I
) {
154 // comp1 = icmp <opcode> ...;
155 // comp2 = icmp <opcode> ...;
156 // ... or comp1 comp2 ...
158 // comp1 = icmp <opcode> ...;
159 // comp2 = icmp <opcode> ...;
160 // new_comp1 = __builtin_bpf_passthrough(seq_num, comp1)
161 // ... or new_comp1 comp2 ...
163 // Use LogicalOr (accept `or i1` as well as `select i1 Op0, true, Op1`)
164 if (!match(&I
, m_LogicalOr(m_Value(Op0
), m_Value(Op1
))))
166 auto *Icmp1
= dyn_cast
<ICmpInst
>(Op0
);
169 auto *Icmp2
= dyn_cast
<ICmpInst
>(Op1
);
173 Value
*Icmp1Op0
= Icmp1
->getOperand(0);
174 Value
*Icmp2Op0
= Icmp2
->getOperand(0);
175 if (Icmp1Op0
!= Icmp2Op0
)
178 // Now we got two icmp instructions which feed into
179 // an "or" instruction.
180 PassThroughInfo
Info(Icmp1
, &I
, 0);
181 PassThroughs
.push_back(Info
);
185 // To avoid combining conditionals in the same basic block by
186 // instrcombine optimization.
187 bool BPFAdjustOptImpl::serializeICMPCrossBB(BasicBlock
&BB
) {
190 // comp1 = icmp <opcode> ...;
191 // if (comp1) goto B2 else B3;
193 // comp2 = icmp <opcode> ...;
194 // if (comp2) goto B4 else B5;
199 // comp1 = icmp <opcode> ...;
200 // comp1 = __builtin_bpf_passthrough(seq_num, comp1);
201 // if (comp1) goto B2 else B3;
203 // comp2 = icmp <opcode> ...;
204 // if (comp2) goto B4 else B5;
208 // Check basic predecessors, if two of them (say B1, B2) are using
209 // icmp instructions to generate conditions and one is the predesessor
210 // of another (e.g., B1 is the predecessor of B2). Add a passthrough
211 // barrier after icmp inst of block B1.
212 BasicBlock
*B2
= BB
.getSinglePredecessor();
216 BasicBlock
*B1
= B2
->getSinglePredecessor();
220 Instruction
*TI
= B2
->getTerminator();
221 auto *BI
= dyn_cast
<BranchInst
>(TI
);
222 if (!BI
|| !BI
->isConditional())
224 auto *Cond
= dyn_cast
<ICmpInst
>(BI
->getCondition());
225 if (!Cond
|| B2
->getFirstNonPHI() != Cond
)
227 Value
*B2Op0
= Cond
->getOperand(0);
228 auto Cond2Op
= Cond
->getPredicate();
230 TI
= B1
->getTerminator();
231 BI
= dyn_cast
<BranchInst
>(TI
);
232 if (!BI
|| !BI
->isConditional())
234 Cond
= dyn_cast
<ICmpInst
>(BI
->getCondition());
237 Value
*B1Op0
= Cond
->getOperand(0);
238 auto Cond1Op
= Cond
->getPredicate();
243 if (Cond1Op
== ICmpInst::ICMP_SGT
|| Cond1Op
== ICmpInst::ICMP_SGE
) {
244 if (Cond2Op
!= ICmpInst::ICMP_SLT
&& Cond2Op
!= ICmpInst::ICMP_SLE
)
246 } else if (Cond1Op
== ICmpInst::ICMP_SLT
|| Cond1Op
== ICmpInst::ICMP_SLE
) {
247 if (Cond2Op
!= ICmpInst::ICMP_SGT
&& Cond2Op
!= ICmpInst::ICMP_SGE
)
249 } else if (Cond1Op
== ICmpInst::ICMP_ULT
|| Cond1Op
== ICmpInst::ICMP_ULE
) {
250 if (Cond2Op
!= ICmpInst::ICMP_UGT
&& Cond2Op
!= ICmpInst::ICMP_UGE
)
252 } else if (Cond1Op
== ICmpInst::ICMP_UGT
|| Cond1Op
== ICmpInst::ICMP_UGE
) {
253 if (Cond2Op
!= ICmpInst::ICMP_ULT
&& Cond2Op
!= ICmpInst::ICMP_ULE
)
259 PassThroughInfo
Info(Cond
, BI
, 0);
260 PassThroughs
.push_back(Info
);
265 // To avoid speculative hoisting certain computations out of
267 bool BPFAdjustOptImpl::avoidSpeculation(Instruction
&I
) {
268 if (auto *LdInst
= dyn_cast
<LoadInst
>(&I
)) {
269 if (auto *GV
= dyn_cast
<GlobalVariable
>(LdInst
->getOperand(0))) {
270 if (GV
->hasAttribute(BPFCoreSharedInfo::AmaAttr
) ||
271 GV
->hasAttribute(BPFCoreSharedInfo::TypeIdAttr
))
276 if (!isa
<LoadInst
>(&I
) && !isa
<CallInst
>(&I
))
283 // /* icmp may not be in the same block as var = ... */
284 // comp1 = icmp <opcode> var, <const>;
285 // if (comp1) goto B2 else B3;
292 // /* icmp may not be in the same block as var = ... */
293 // comp1 = icmp <opcode> var, <const>;
294 // if (comp1) goto B2 else B3;
296 // var = __builtin_bpf_passthrough(seq_num, var);
298 bool isCandidate
= false;
299 SmallVector
<PassThroughInfo
, 4> Candidates
;
300 for (User
*U
: I
.users()) {
301 Instruction
*Inst
= dyn_cast
<Instruction
>(U
);
305 // May cover a little bit more than the
307 if (auto *Icmp1
= dyn_cast
<ICmpInst
>(Inst
)) {
308 Value
*Icmp1Op1
= Icmp1
->getOperand(1);
309 if (!isa
<Constant
>(Icmp1Op1
))
315 // Ignore the use in the same basic block as the definition.
316 if (Inst
->getParent() == I
.getParent())
319 // use in a different basic block, If there is a call or
320 // load/store insn before this instruction in this basic
321 // block. Most likely it cannot be hoisted out. Skip it.
322 for (auto &I2
: *Inst
->getParent()) {
323 if (isa
<CallInst
>(&I2
))
325 if (isa
<LoadInst
>(&I2
) || isa
<StoreInst
>(&I2
))
331 // It should be used in a GEP or a simple arithmetic like
332 // ZEXT/SEXT which is used for GEP.
333 if (Inst
->getOpcode() == Instruction::ZExt
||
334 Inst
->getOpcode() == Instruction::SExt
) {
335 PassThroughInfo
Info(&I
, Inst
, 0);
336 Candidates
.push_back(Info
);
337 } else if (auto *GI
= dyn_cast
<GetElementPtrInst
>(Inst
)) {
338 // traverse GEP inst to find Use operand index
340 for (i
= 1, e
= GI
->getNumOperands(); i
!= e
; ++i
) {
341 Value
*V
= GI
->getOperand(i
);
348 PassThroughInfo
Info(&I
, GI
, i
);
349 Candidates
.push_back(Info
);
353 if (!isCandidate
|| Candidates
.empty())
356 llvm::append_range(PassThroughs
, Candidates
);
360 void BPFAdjustOptImpl::adjustBasicBlock(BasicBlock
&BB
) {
361 if (!DisableBPFserializeICMP
&& serializeICMPCrossBB(BB
))
365 void BPFAdjustOptImpl::adjustInst(Instruction
&I
) {
366 if (!DisableBPFserializeICMP
&& serializeICMPInBB(I
))
368 if (!DisableBPFavoidSpeculation
&& avoidSpeculation(I
))
372 PreservedAnalyses
BPFAdjustOptPass::run(Module
&M
, ModuleAnalysisManager
&AM
) {
373 return BPFAdjustOptImpl(&M
).run() ? PreservedAnalyses::none()
374 : PreservedAnalyses::all();