1 //===---- DemandedBits.cpp - Determine demanded bits ----------------------===//
2 //
3 // The LLVM Compiler Infrastructure
4 //
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
7 //
8 //===----------------------------------------------------------------------===//
9 //
10 // This pass implements a demanded bits analysis. A demanded bit is one that
11 // contributes to a result; bits that are not demanded can be either zero or
12 // one without affecting control or data flow. For example in this sequence:
13 //
14 // %1 = add i32 %x, %y
15 // %2 = trunc i32 %1 to i16
16 //
17 // Only the lowest 16 bits of %1 are demanded; the rest are removed by the
18 // trunc.
19 //
20 //===----------------------------------------------------------------------===//
21
22 #include "llvm/Analysis/DemandedBits.h"
23 #include "llvm/Transforms/Scalar.h"
24 #include "llvm/ADT/DenseMap.h"
25 #include "llvm/ADT/DepthFirstIterator.h"
26 #include "llvm/ADT/SmallPtrSet.h"
27 #include "llvm/ADT/SmallVector.h"
28 #include "llvm/ADT/StringExtras.h"
29 #include "llvm/Analysis/AssumptionCache.h"
30 #include "llvm/Analysis/ValueTracking.h"
31 #include "llvm/IR/BasicBlock.h"
32 #include "llvm/IR/CFG.h"
33 #include "llvm/IR/DataLayout.h"
34 #include "llvm/IR/Dominators.h"
35 #include "llvm/IR/InstIterator.h"
36 #include "llvm/IR/Instructions.h"
37 #include "llvm/IR/IntrinsicInst.h"
38 #include "llvm/IR/Module.h"
39 #include "llvm/IR/Operator.h"
40 #include "llvm/Pass.h"
41 #include "llvm/Support/Debug.h"
42 #include "llvm/Support/raw_ostream.h"
43 using namespace llvm;
44
45 #define DEBUG_TYPE "demanded-bits"
46
47 char DemandedBits::ID = 0;
48 INITIALIZE_PASS_BEGIN(DemandedBits, "demanded-bits", "Demanded bits analysis",
49 false, false)
INITIALIZE_PASS_DEPENDENCY(AssumptionCacheTracker)50 INITIALIZE_PASS_DEPENDENCY(AssumptionCacheTracker)
51 INITIALIZE_PASS_DEPENDENCY(DominatorTreeWrapperPass)
52 INITIALIZE_PASS_END(DemandedBits, "demanded-bits", "Demanded bits analysis",
53 false, false)
54
55 DemandedBits::DemandedBits() : FunctionPass(ID), F(nullptr), Analyzed(false) {
56 initializeDemandedBitsPass(*PassRegistry::getPassRegistry());
57 }
58
getAnalysisUsage(AnalysisUsage & AU) const59 void DemandedBits::getAnalysisUsage(AnalysisUsage &AU) const {
60 AU.setPreservesCFG();
61 AU.addRequired<AssumptionCacheTracker>();
62 AU.addRequired<DominatorTreeWrapperPass>();
63 AU.setPreservesAll();
64 }
65
isAlwaysLive(Instruction * I)66 static bool isAlwaysLive(Instruction *I) {
67 return isa<TerminatorInst>(I) || isa<DbgInfoIntrinsic>(I) ||
68 I->isEHPad() || I->mayHaveSideEffects();
69 }
70
determineLiveOperandBits(const Instruction * UserI,const Instruction * I,unsigned OperandNo,const APInt & AOut,APInt & AB,APInt & KnownZero,APInt & KnownOne,APInt & KnownZero2,APInt & KnownOne2)71 void DemandedBits::determineLiveOperandBits(
72 const Instruction *UserI, const Instruction *I, unsigned OperandNo,
73 const APInt &AOut, APInt &AB, APInt &KnownZero, APInt &KnownOne,
74 APInt &KnownZero2, APInt &KnownOne2) {
75 unsigned BitWidth = AB.getBitWidth();
76
77 // We're called once per operand, but for some instructions, we need to
78 // compute known bits of both operands in order to determine the live bits of
79 // either (when both operands are instructions themselves). We don't,
80 // however, want to do this twice, so we cache the result in APInts that live
81 // in the caller. For the two-relevant-operands case, both operand values are
82 // provided here.
83 auto ComputeKnownBits =
84 [&](unsigned BitWidth, const Value *V1, const Value *V2) {
85 const DataLayout &DL = I->getModule()->getDataLayout();
86 KnownZero = APInt(BitWidth, 0);
87 KnownOne = APInt(BitWidth, 0);
88 computeKnownBits(const_cast<Value *>(V1), KnownZero, KnownOne, DL, 0,
89 AC, UserI, DT);
90
91 if (V2) {
92 KnownZero2 = APInt(BitWidth, 0);
93 KnownOne2 = APInt(BitWidth, 0);
94 computeKnownBits(const_cast<Value *>(V2), KnownZero2, KnownOne2, DL,
95 0, AC, UserI, DT);
96 }
97 };
98
99 switch (UserI->getOpcode()) {
100 default: break;
101 case Instruction::Call:
102 case Instruction::Invoke:
103 if (const IntrinsicInst *II = dyn_cast<IntrinsicInst>(UserI))
104 switch (II->getIntrinsicID()) {
105 default: break;
106 case Intrinsic::bswap:
107 // The alive bits of the input are the swapped alive bits of
108 // the output.
109 AB = AOut.byteSwap();
110 break;
111 case Intrinsic::ctlz:
112 if (OperandNo == 0) {
113 // We need some output bits, so we need all bits of the
114 // input to the left of, and including, the leftmost bit
115 // known to be one.
116 ComputeKnownBits(BitWidth, I, nullptr);
117 AB = APInt::getHighBitsSet(BitWidth,
118 std::min(BitWidth, KnownOne.countLeadingZeros()+1));
119 }
120 break;
121 case Intrinsic::cttz:
122 if (OperandNo == 0) {
123 // We need some output bits, so we need all bits of the
124 // input to the right of, and including, the rightmost bit
125 // known to be one.
126 ComputeKnownBits(BitWidth, I, nullptr);
127 AB = APInt::getLowBitsSet(BitWidth,
128 std::min(BitWidth, KnownOne.countTrailingZeros()+1));
129 }
130 break;
131 }
132 break;
133 case Instruction::Add:
134 case Instruction::Sub:
135 case Instruction::Mul:
136 // Find the highest live output bit. We don't need any more input
137 // bits than that (adds, and thus subtracts, ripple only to the
138 // left).
139 AB = APInt::getLowBitsSet(BitWidth, AOut.getActiveBits());
140 break;
141 case Instruction::Shl:
142 if (OperandNo == 0)
143 if (ConstantInt *CI =
144 dyn_cast<ConstantInt>(UserI->getOperand(1))) {
145 uint64_t ShiftAmt = CI->getLimitedValue(BitWidth-1);
146 AB = AOut.lshr(ShiftAmt);
147
148 // If the shift is nuw/nsw, then the high bits are not dead
149 // (because we've promised that they *must* be zero).
150 const ShlOperator *S = cast<ShlOperator>(UserI);
151 if (S->hasNoSignedWrap())
152 AB |= APInt::getHighBitsSet(BitWidth, ShiftAmt+1);
153 else if (S->hasNoUnsignedWrap())
154 AB |= APInt::getHighBitsSet(BitWidth, ShiftAmt);
155 }
156 break;
157 case Instruction::LShr:
158 if (OperandNo == 0)
159 if (ConstantInt *CI =
160 dyn_cast<ConstantInt>(UserI->getOperand(1))) {
161 uint64_t ShiftAmt = CI->getLimitedValue(BitWidth-1);
162 AB = AOut.shl(ShiftAmt);
163
164 // If the shift is exact, then the low bits are not dead
165 // (they must be zero).
166 if (cast<LShrOperator>(UserI)->isExact())
167 AB |= APInt::getLowBitsSet(BitWidth, ShiftAmt);
168 }
169 break;
170 case Instruction::AShr:
171 if (OperandNo == 0)
172 if (ConstantInt *CI =
173 dyn_cast<ConstantInt>(UserI->getOperand(1))) {
174 uint64_t ShiftAmt = CI->getLimitedValue(BitWidth-1);
175 AB = AOut.shl(ShiftAmt);
176 // Because the high input bit is replicated into the
177 // high-order bits of the result, if we need any of those
178 // bits, then we must keep the highest input bit.
179 if ((AOut & APInt::getHighBitsSet(BitWidth, ShiftAmt))
180 .getBoolValue())
181 AB.setBit(BitWidth-1);
182
183 // If the shift is exact, then the low bits are not dead
184 // (they must be zero).
185 if (cast<AShrOperator>(UserI)->isExact())
186 AB |= APInt::getLowBitsSet(BitWidth, ShiftAmt);
187 }
188 break;
189 case Instruction::And:
190 AB = AOut;
191
192 // For bits that are known zero, the corresponding bits in the
193 // other operand are dead (unless they're both zero, in which
194 // case they can't both be dead, so just mark the LHS bits as
195 // dead).
196 if (OperandNo == 0) {
197 ComputeKnownBits(BitWidth, I, UserI->getOperand(1));
198 AB &= ~KnownZero2;
199 } else {
200 if (!isa<Instruction>(UserI->getOperand(0)))
201 ComputeKnownBits(BitWidth, UserI->getOperand(0), I);
202 AB &= ~(KnownZero & ~KnownZero2);
203 }
204 break;
205 case Instruction::Or:
206 AB = AOut;
207
208 // For bits that are known one, the corresponding bits in the
209 // other operand are dead (unless they're both one, in which
210 // case they can't both be dead, so just mark the LHS bits as
211 // dead).
212 if (OperandNo == 0) {
213 ComputeKnownBits(BitWidth, I, UserI->getOperand(1));
214 AB &= ~KnownOne2;
215 } else {
216 if (!isa<Instruction>(UserI->getOperand(0)))
217 ComputeKnownBits(BitWidth, UserI->getOperand(0), I);
218 AB &= ~(KnownOne & ~KnownOne2);
219 }
220 break;
221 case Instruction::Xor:
222 case Instruction::PHI:
223 AB = AOut;
224 break;
225 case Instruction::Trunc:
226 AB = AOut.zext(BitWidth);
227 break;
228 case Instruction::ZExt:
229 AB = AOut.trunc(BitWidth);
230 break;
231 case Instruction::SExt:
232 AB = AOut.trunc(BitWidth);
233 // Because the high input bit is replicated into the
234 // high-order bits of the result, if we need any of those
235 // bits, then we must keep the highest input bit.
236 if ((AOut & APInt::getHighBitsSet(AOut.getBitWidth(),
237 AOut.getBitWidth() - BitWidth))
238 .getBoolValue())
239 AB.setBit(BitWidth-1);
240 break;
241 case Instruction::Select:
242 if (OperandNo != 0)
243 AB = AOut;
244 break;
245 case Instruction::ICmp:
246 // Count the number of leading zeroes in each operand.
247 ComputeKnownBits(BitWidth, I, UserI->getOperand(1));
248 auto NumLeadingZeroes = std::min(KnownZero.countLeadingOnes(),
249 KnownZero2.countLeadingOnes());
250 AB = ~APInt::getHighBitsSet(BitWidth, NumLeadingZeroes);
251 break;
252 }
253 }
254
runOnFunction(Function & Fn)255 bool DemandedBits::runOnFunction(Function& Fn) {
256 F = &Fn;
257 Analyzed = false;
258 return false;
259 }
260
performAnalysis()261 void DemandedBits::performAnalysis() {
262 if (Analyzed)
263 // Analysis already completed for this function.
264 return;
265 Analyzed = true;
266 AC = &getAnalysis<AssumptionCacheTracker>().getAssumptionCache(*F);
267 DT = &getAnalysis<DominatorTreeWrapperPass>().getDomTree();
268
269 Visited.clear();
270 AliveBits.clear();
271
272 SmallVector<Instruction*, 128> Worklist;
273
274 // Collect the set of "root" instructions that are known live.
275 for (Instruction &I : instructions(*F)) {
276 if (!isAlwaysLive(&I))
277 continue;
278
279 DEBUG(dbgs() << "DemandedBits: Root: " << I << "\n");
280 // For integer-valued instructions, set up an initial empty set of alive
281 // bits and add the instruction to the work list. For other instructions
282 // add their operands to the work list (for integer values operands, mark
283 // all bits as live).
284 if (IntegerType *IT = dyn_cast<IntegerType>(I.getType())) {
285 if (!AliveBits.count(&I)) {
286 AliveBits[&I] = APInt(IT->getBitWidth(), 0);
287 Worklist.push_back(&I);
288 }
289
290 continue;
291 }
292
293 // Non-integer-typed instructions...
294 for (Use &OI : I.operands()) {
295 if (Instruction *J = dyn_cast<Instruction>(OI)) {
296 if (IntegerType *IT = dyn_cast<IntegerType>(J->getType()))
297 AliveBits[J] = APInt::getAllOnesValue(IT->getBitWidth());
298 Worklist.push_back(J);
299 }
300 }
301 // To save memory, we don't add I to the Visited set here. Instead, we
302 // check isAlwaysLive on every instruction when searching for dead
303 // instructions later (we need to check isAlwaysLive for the
304 // integer-typed instructions anyway).
305 }
306
307 // Propagate liveness backwards to operands.
308 while (!Worklist.empty()) {
309 Instruction *UserI = Worklist.pop_back_val();
310
311 DEBUG(dbgs() << "DemandedBits: Visiting: " << *UserI);
312 APInt AOut;
313 if (UserI->getType()->isIntegerTy()) {
314 AOut = AliveBits[UserI];
315 DEBUG(dbgs() << " Alive Out: " << AOut);
316 }
317 DEBUG(dbgs() << "\n");
318
319 if (!UserI->getType()->isIntegerTy())
320 Visited.insert(UserI);
321
322 APInt KnownZero, KnownOne, KnownZero2, KnownOne2;
323 // Compute the set of alive bits for each operand. These are anded into the
324 // existing set, if any, and if that changes the set of alive bits, the
325 // operand is added to the work-list.
326 for (Use &OI : UserI->operands()) {
327 if (Instruction *I = dyn_cast<Instruction>(OI)) {
328 if (IntegerType *IT = dyn_cast<IntegerType>(I->getType())) {
329 unsigned BitWidth = IT->getBitWidth();
330 APInt AB = APInt::getAllOnesValue(BitWidth);
331 if (UserI->getType()->isIntegerTy() && !AOut &&
332 !isAlwaysLive(UserI)) {
333 AB = APInt(BitWidth, 0);
334 } else {
335 // If all bits of the output are dead, then all bits of the input
336 // Bits of each operand that are used to compute alive bits of the
337 // output are alive, all others are dead.
338 determineLiveOperandBits(UserI, I, OI.getOperandNo(), AOut, AB,
339 KnownZero, KnownOne,
340 KnownZero2, KnownOne2);
341 }
342
343 // If we've added to the set of alive bits (or the operand has not
344 // been previously visited), then re-queue the operand to be visited
345 // again.
346 APInt ABPrev(BitWidth, 0);
347 auto ABI = AliveBits.find(I);
348 if (ABI != AliveBits.end())
349 ABPrev = ABI->second;
350
351 APInt ABNew = AB | ABPrev;
352 if (ABNew != ABPrev || ABI == AliveBits.end()) {
353 AliveBits[I] = std::move(ABNew);
354 Worklist.push_back(I);
355 }
356 } else if (!Visited.count(I)) {
357 Worklist.push_back(I);
358 }
359 }
360 }
361 }
362 }
363
getDemandedBits(Instruction * I)364 APInt DemandedBits::getDemandedBits(Instruction *I) {
365 performAnalysis();
366
367 const DataLayout &DL = I->getParent()->getModule()->getDataLayout();
368 if (AliveBits.count(I))
369 return AliveBits[I];
370 return APInt::getAllOnesValue(DL.getTypeSizeInBits(I->getType()));
371 }
372
isInstructionDead(Instruction * I)373 bool DemandedBits::isInstructionDead(Instruction *I) {
374 performAnalysis();
375
376 return !Visited.count(I) && AliveBits.find(I) == AliveBits.end() &&
377 !isAlwaysLive(I);
378 }
379
print(raw_ostream & OS,const Module * M) const380 void DemandedBits::print(raw_ostream &OS, const Module *M) const {
381 // This is gross. But the alternative is making all the state mutable
382 // just because of this one debugging method.
383 const_cast<DemandedBits*>(this)->performAnalysis();
384 for (auto &KV : AliveBits) {
385 OS << "DemandedBits: 0x" << utohexstr(KV.second.getLimitedValue()) << " for "
386 << *KV.first << "\n";
387 }
388 }
389
createDemandedBitsPass()390 FunctionPass *llvm::createDemandedBitsPass() {
391 return new DemandedBits();
392 }
393