1 //===- InstructionCombining.cpp - Combine multiple instructions -----------===//
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 // InstructionCombining - Combine instructions to form fewer, simple
10 // instructions.  This pass does not modify the CFG.  This pass is where
11 // algebraic simplification happens.
12 //
13 // This pass combines things like:
14 //    %Y = add i32 %X, 1
15 //    %Z = add i32 %Y, 1
16 // into:
17 //    %Z = add i32 %X, 2
18 //
19 // This is a simple worklist driven algorithm.
20 //
21 // This pass guarantees that the following canonicalizations are performed on
22 // the program:
23 //    1. If a binary operator has a constant operand, it is moved to the RHS
24 //    2. Bitwise operators with constant operands are always grouped so that
25 //       shifts are performed first, then or's, then and's, then xor's.
26 //    3. Compare instructions are converted from <,>,<=,>= to ==,!= if possible
27 //    4. All cmp instructions on boolean values are replaced with logical ops
28 //    5. add X, X is represented as (X*2) => (X << 1)
29 //    6. Multiplies with a power-of-two constant argument are transformed into
30 //       shifts.
31 //   ... etc.
32 //
33 //===----------------------------------------------------------------------===//
34 
35 #include "InstCombineInternal.h"
36 #include "llvm-c/Initialization.h"
37 #include "llvm-c/Transforms/InstCombine.h"
38 #include "llvm/ADT/APInt.h"
39 #include "llvm/ADT/ArrayRef.h"
40 #include "llvm/ADT/DenseMap.h"
41 #include "llvm/ADT/None.h"
42 #include "llvm/ADT/SmallPtrSet.h"
43 #include "llvm/ADT/SmallVector.h"
44 #include "llvm/ADT/Statistic.h"
45 #include "llvm/ADT/TinyPtrVector.h"
46 #include "llvm/Analysis/AliasAnalysis.h"
47 #include "llvm/Analysis/AssumptionCache.h"
48 #include "llvm/Analysis/BasicAliasAnalysis.h"
49 #include "llvm/Analysis/CFG.h"
50 #include "llvm/Analysis/ConstantFolding.h"
51 #include "llvm/Analysis/EHPersonalities.h"
52 #include "llvm/Analysis/GlobalsModRef.h"
53 #include "llvm/Analysis/InstructionSimplify.h"
54 #include "llvm/Analysis/LoopInfo.h"
55 #include "llvm/Analysis/MemoryBuiltins.h"
56 #include "llvm/Analysis/OptimizationRemarkEmitter.h"
57 #include "llvm/Analysis/TargetFolder.h"
58 #include "llvm/Analysis/TargetLibraryInfo.h"
59 #include "llvm/Analysis/ValueTracking.h"
60 #include "llvm/IR/BasicBlock.h"
61 #include "llvm/IR/CFG.h"
62 #include "llvm/IR/Constant.h"
63 #include "llvm/IR/Constants.h"
64 #include "llvm/IR/DIBuilder.h"
65 #include "llvm/IR/DataLayout.h"
66 #include "llvm/IR/DerivedTypes.h"
67 #include "llvm/IR/Dominators.h"
68 #include "llvm/IR/Function.h"
69 #include "llvm/IR/GetElementPtrTypeIterator.h"
70 #include "llvm/IR/IRBuilder.h"
71 #include "llvm/IR/InstrTypes.h"
72 #include "llvm/IR/Instruction.h"
73 #include "llvm/IR/Instructions.h"
74 #include "llvm/IR/IntrinsicInst.h"
75 #include "llvm/IR/Intrinsics.h"
76 #include "llvm/IR/LegacyPassManager.h"
77 #include "llvm/IR/Metadata.h"
78 #include "llvm/IR/Operator.h"
79 #include "llvm/IR/PassManager.h"
80 #include "llvm/IR/PatternMatch.h"
81 #include "llvm/IR/Type.h"
82 #include "llvm/IR/Use.h"
83 #include "llvm/IR/User.h"
84 #include "llvm/IR/Value.h"
85 #include "llvm/IR/ValueHandle.h"
86 #include "llvm/Pass.h"
87 #include "llvm/Support/CBindingWrapping.h"
88 #include "llvm/Support/Casting.h"
89 #include "llvm/Support/CommandLine.h"
90 #include "llvm/Support/Compiler.h"
91 #include "llvm/Support/Debug.h"
92 #include "llvm/Support/DebugCounter.h"
93 #include "llvm/Support/ErrorHandling.h"
94 #include "llvm/Support/KnownBits.h"
95 #include "llvm/Support/raw_ostream.h"
96 #include "llvm/Transforms/InstCombine/InstCombine.h"
97 #include "llvm/Transforms/InstCombine/InstCombineWorklist.h"
98 #include "llvm/Transforms/Utils/Local.h"
99 #include <algorithm>
100 #include <cassert>
101 #include <cstdint>
102 #include <memory>
103 #include <string>
104 #include <utility>
105 
106 using namespace llvm;
107 using namespace llvm::PatternMatch;
108 
109 #define DEBUG_TYPE "instcombine"
110 
111 STATISTIC(NumCombined , "Number of insts combined");
112 STATISTIC(NumConstProp, "Number of constant folds");
113 STATISTIC(NumDeadInst , "Number of dead inst eliminated");
114 STATISTIC(NumSunkInst , "Number of instructions sunk");
115 STATISTIC(NumExpand,    "Number of expansions");
116 STATISTIC(NumFactor   , "Number of factorizations");
117 STATISTIC(NumReassoc  , "Number of reassociations");
118 DEBUG_COUNTER(VisitCounter, "instcombine-visit",
119               "Controls which instructions are visited");
120 
121 static cl::opt<bool>
122 EnableCodeSinking("instcombine-code-sinking", cl::desc("Enable code sinking"),
123                                               cl::init(true));
124 
125 static cl::opt<bool>
126 EnableExpensiveCombines("expensive-combines",
127                         cl::desc("Enable expensive instruction combines"));
128 
129 static cl::opt<unsigned>
130 MaxArraySize("instcombine-maxarray-size", cl::init(1024),
131              cl::desc("Maximum array size considered when doing a combine"));
132 
133 // FIXME: Remove this flag when it is no longer necessary to convert
134 // llvm.dbg.declare to avoid inaccurate debug info. Setting this to false
135 // increases variable availability at the cost of accuracy. Variables that
136 // cannot be promoted by mem2reg or SROA will be described as living in memory
137 // for their entire lifetime. However, passes like DSE and instcombine can
138 // delete stores to the alloca, leading to misleading and inaccurate debug
139 // information. This flag can be removed when those passes are fixed.
140 static cl::opt<unsigned> ShouldLowerDbgDeclare("instcombine-lower-dbg-declare",
141                                                cl::Hidden, cl::init(true));
142 
143 Value *InstCombiner::EmitGEPOffset(User *GEP) {
144   return llvm::EmitGEPOffset(&Builder, DL, GEP);
145 }
146 
147 /// Return true if it is desirable to convert an integer computation from a
148 /// given bit width to a new bit width.
149 /// We don't want to convert from a legal to an illegal type or from a smaller
150 /// to a larger illegal type. A width of '1' is always treated as a legal type
151 /// because i1 is a fundamental type in IR, and there are many specialized
152 /// optimizations for i1 types. Widths of 8, 16 or 32 are equally treated as
153 /// legal to convert to, in order to open up more combining opportunities.
154 /// NOTE: this treats i8, i16 and i32 specially, due to them being so common
155 /// from frontend languages.
156 bool InstCombiner::shouldChangeType(unsigned FromWidth,
157                                     unsigned ToWidth) const {
158   bool FromLegal = FromWidth == 1 || DL.isLegalInteger(FromWidth);
159   bool ToLegal = ToWidth == 1 || DL.isLegalInteger(ToWidth);
160 
161   // Convert to widths of 8, 16 or 32 even if they are not legal types. Only
162   // shrink types, to prevent infinite loops.
163   if (ToWidth < FromWidth && (ToWidth == 8 || ToWidth == 16 || ToWidth == 32))
164     return true;
165 
166   // If this is a legal integer from type, and the result would be an illegal
167   // type, don't do the transformation.
168   if (FromLegal && !ToLegal)
169     return false;
170 
171   // Otherwise, if both are illegal, do not increase the size of the result. We
172   // do allow things like i160 -> i64, but not i64 -> i160.
173   if (!FromLegal && !ToLegal && ToWidth > FromWidth)
174     return false;
175 
176   return true;
177 }
178 
179 /// Return true if it is desirable to convert a computation from 'From' to 'To'.
180 /// We don't want to convert from a legal to an illegal type or from a smaller
181 /// to a larger illegal type. i1 is always treated as a legal type because it is
182 /// a fundamental type in IR, and there are many specialized optimizations for
183 /// i1 types.
184 bool InstCombiner::shouldChangeType(Type *From, Type *To) const {
185   // TODO: This could be extended to allow vectors. Datalayout changes might be
186   // needed to properly support that.
187   if (!From->isIntegerTy() || !To->isIntegerTy())
188     return false;
189 
190   unsigned FromWidth = From->getPrimitiveSizeInBits();
191   unsigned ToWidth = To->getPrimitiveSizeInBits();
192   return shouldChangeType(FromWidth, ToWidth);
193 }
194 
195 // Return true, if No Signed Wrap should be maintained for I.
196 // The No Signed Wrap flag can be kept if the operation "B (I.getOpcode) C",
197 // where both B and C should be ConstantInts, results in a constant that does
198 // not overflow. This function only handles the Add and Sub opcodes. For
199 // all other opcodes, the function conservatively returns false.
200 static bool MaintainNoSignedWrap(BinaryOperator &I, Value *B, Value *C) {
201   OverflowingBinaryOperator *OBO = dyn_cast<OverflowingBinaryOperator>(&I);
202   if (!OBO || !OBO->hasNoSignedWrap())
203     return false;
204 
205   // We reason about Add and Sub Only.
206   Instruction::BinaryOps Opcode = I.getOpcode();
207   if (Opcode != Instruction::Add && Opcode != Instruction::Sub)
208     return false;
209 
210   const APInt *BVal, *CVal;
211   if (!match(B, m_APInt(BVal)) || !match(C, m_APInt(CVal)))
212     return false;
213 
214   bool Overflow = false;
215   if (Opcode == Instruction::Add)
216     (void)BVal->sadd_ov(*CVal, Overflow);
217   else
218     (void)BVal->ssub_ov(*CVal, Overflow);
219 
220   return !Overflow;
221 }
222 
223 /// Conservatively clears subclassOptionalData after a reassociation or
224 /// commutation. We preserve fast-math flags when applicable as they can be
225 /// preserved.
226 static void ClearSubclassDataAfterReassociation(BinaryOperator &I) {
227   FPMathOperator *FPMO = dyn_cast<FPMathOperator>(&I);
228   if (!FPMO) {
229     I.clearSubclassOptionalData();
230     return;
231   }
232 
233   FastMathFlags FMF = I.getFastMathFlags();
234   I.clearSubclassOptionalData();
235   I.setFastMathFlags(FMF);
236 }
237 
238 /// Combine constant operands of associative operations either before or after a
239 /// cast to eliminate one of the associative operations:
240 /// (op (cast (op X, C2)), C1) --> (cast (op X, op (C1, C2)))
241 /// (op (cast (op X, C2)), C1) --> (op (cast X), op (C1, C2))
242 static bool simplifyAssocCastAssoc(BinaryOperator *BinOp1) {
243   auto *Cast = dyn_cast<CastInst>(BinOp1->getOperand(0));
244   if (!Cast || !Cast->hasOneUse())
245     return false;
246 
247   // TODO: Enhance logic for other casts and remove this check.
248   auto CastOpcode = Cast->getOpcode();
249   if (CastOpcode != Instruction::ZExt)
250     return false;
251 
252   // TODO: Enhance logic for other BinOps and remove this check.
253   if (!BinOp1->isBitwiseLogicOp())
254     return false;
255 
256   auto AssocOpcode = BinOp1->getOpcode();
257   auto *BinOp2 = dyn_cast<BinaryOperator>(Cast->getOperand(0));
258   if (!BinOp2 || !BinOp2->hasOneUse() || BinOp2->getOpcode() != AssocOpcode)
259     return false;
260 
261   Constant *C1, *C2;
262   if (!match(BinOp1->getOperand(1), m_Constant(C1)) ||
263       !match(BinOp2->getOperand(1), m_Constant(C2)))
264     return false;
265 
266   // TODO: This assumes a zext cast.
267   // Eg, if it was a trunc, we'd cast C1 to the source type because casting C2
268   // to the destination type might lose bits.
269 
270   // Fold the constants together in the destination type:
271   // (op (cast (op X, C2)), C1) --> (op (cast X), FoldedC)
272   Type *DestTy = C1->getType();
273   Constant *CastC2 = ConstantExpr::getCast(CastOpcode, C2, DestTy);
274   Constant *FoldedC = ConstantExpr::get(AssocOpcode, C1, CastC2);
275   Cast->setOperand(0, BinOp2->getOperand(0));
276   BinOp1->setOperand(1, FoldedC);
277   return true;
278 }
279 
280 /// This performs a few simplifications for operators that are associative or
281 /// commutative:
282 ///
283 ///  Commutative operators:
284 ///
285 ///  1. Order operands such that they are listed from right (least complex) to
286 ///     left (most complex).  This puts constants before unary operators before
287 ///     binary operators.
288 ///
289 ///  Associative operators:
290 ///
291 ///  2. Transform: "(A op B) op C" ==> "A op (B op C)" if "B op C" simplifies.
292 ///  3. Transform: "A op (B op C)" ==> "(A op B) op C" if "A op B" simplifies.
293 ///
294 ///  Associative and commutative operators:
295 ///
296 ///  4. Transform: "(A op B) op C" ==> "(C op A) op B" if "C op A" simplifies.
297 ///  5. Transform: "A op (B op C)" ==> "B op (C op A)" if "C op A" simplifies.
298 ///  6. Transform: "(A op C1) op (B op C2)" ==> "(A op B) op (C1 op C2)"
299 ///     if C1 and C2 are constants.
300 bool InstCombiner::SimplifyAssociativeOrCommutative(BinaryOperator &I) {
301   Instruction::BinaryOps Opcode = I.getOpcode();
302   bool Changed = false;
303 
304   do {
305     // Order operands such that they are listed from right (least complex) to
306     // left (most complex).  This puts constants before unary operators before
307     // binary operators.
308     if (I.isCommutative() && getComplexity(I.getOperand(0)) <
309         getComplexity(I.getOperand(1)))
310       Changed = !I.swapOperands();
311 
312     BinaryOperator *Op0 = dyn_cast<BinaryOperator>(I.getOperand(0));
313     BinaryOperator *Op1 = dyn_cast<BinaryOperator>(I.getOperand(1));
314 
315     if (I.isAssociative()) {
316       // Transform: "(A op B) op C" ==> "A op (B op C)" if "B op C" simplifies.
317       if (Op0 && Op0->getOpcode() == Opcode) {
318         Value *A = Op0->getOperand(0);
319         Value *B = Op0->getOperand(1);
320         Value *C = I.getOperand(1);
321 
322         // Does "B op C" simplify?
323         if (Value *V = SimplifyBinOp(Opcode, B, C, SQ.getWithInstruction(&I))) {
324           // It simplifies to V.  Form "A op V".
325           I.setOperand(0, A);
326           I.setOperand(1, V);
327           // Conservatively clear the optional flags, since they may not be
328           // preserved by the reassociation.
329           if (MaintainNoSignedWrap(I, B, C) &&
330               (!Op0 || (isa<BinaryOperator>(Op0) && Op0->hasNoSignedWrap()))) {
331             // Note: this is only valid because SimplifyBinOp doesn't look at
332             // the operands to Op0.
333             I.clearSubclassOptionalData();
334             I.setHasNoSignedWrap(true);
335           } else {
336             ClearSubclassDataAfterReassociation(I);
337           }
338 
339           Changed = true;
340           ++NumReassoc;
341           continue;
342         }
343       }
344 
345       // Transform: "A op (B op C)" ==> "(A op B) op C" if "A op B" simplifies.
346       if (Op1 && Op1->getOpcode() == Opcode) {
347         Value *A = I.getOperand(0);
348         Value *B = Op1->getOperand(0);
349         Value *C = Op1->getOperand(1);
350 
351         // Does "A op B" simplify?
352         if (Value *V = SimplifyBinOp(Opcode, A, B, SQ.getWithInstruction(&I))) {
353           // It simplifies to V.  Form "V op C".
354           I.setOperand(0, V);
355           I.setOperand(1, C);
356           // Conservatively clear the optional flags, since they may not be
357           // preserved by the reassociation.
358           ClearSubclassDataAfterReassociation(I);
359           Changed = true;
360           ++NumReassoc;
361           continue;
362         }
363       }
364     }
365 
366     if (I.isAssociative() && I.isCommutative()) {
367       if (simplifyAssocCastAssoc(&I)) {
368         Changed = true;
369         ++NumReassoc;
370         continue;
371       }
372 
373       // Transform: "(A op B) op C" ==> "(C op A) op B" if "C op A" simplifies.
374       if (Op0 && Op0->getOpcode() == Opcode) {
375         Value *A = Op0->getOperand(0);
376         Value *B = Op0->getOperand(1);
377         Value *C = I.getOperand(1);
378 
379         // Does "C op A" simplify?
380         if (Value *V = SimplifyBinOp(Opcode, C, A, SQ.getWithInstruction(&I))) {
381           // It simplifies to V.  Form "V op B".
382           I.setOperand(0, V);
383           I.setOperand(1, B);
384           // Conservatively clear the optional flags, since they may not be
385           // preserved by the reassociation.
386           ClearSubclassDataAfterReassociation(I);
387           Changed = true;
388           ++NumReassoc;
389           continue;
390         }
391       }
392 
393       // Transform: "A op (B op C)" ==> "B op (C op A)" if "C op A" simplifies.
394       if (Op1 && Op1->getOpcode() == Opcode) {
395         Value *A = I.getOperand(0);
396         Value *B = Op1->getOperand(0);
397         Value *C = Op1->getOperand(1);
398 
399         // Does "C op A" simplify?
400         if (Value *V = SimplifyBinOp(Opcode, C, A, SQ.getWithInstruction(&I))) {
401           // It simplifies to V.  Form "B op V".
402           I.setOperand(0, B);
403           I.setOperand(1, V);
404           // Conservatively clear the optional flags, since they may not be
405           // preserved by the reassociation.
406           ClearSubclassDataAfterReassociation(I);
407           Changed = true;
408           ++NumReassoc;
409           continue;
410         }
411       }
412 
413       // Transform: "(A op C1) op (B op C2)" ==> "(A op B) op (C1 op C2)"
414       // if C1 and C2 are constants.
415       Value *A, *B;
416       Constant *C1, *C2;
417       if (Op0 && Op1 &&
418           Op0->getOpcode() == Opcode && Op1->getOpcode() == Opcode &&
419           match(Op0, m_OneUse(m_BinOp(m_Value(A), m_Constant(C1)))) &&
420           match(Op1, m_OneUse(m_BinOp(m_Value(B), m_Constant(C2))))) {
421         BinaryOperator *NewBO = BinaryOperator::Create(Opcode, A, B);
422         if (isa<FPMathOperator>(NewBO)) {
423           FastMathFlags Flags = I.getFastMathFlags();
424           Flags &= Op0->getFastMathFlags();
425           Flags &= Op1->getFastMathFlags();
426           NewBO->setFastMathFlags(Flags);
427         }
428         InsertNewInstWith(NewBO, I);
429         NewBO->takeName(Op1);
430         I.setOperand(0, NewBO);
431         I.setOperand(1, ConstantExpr::get(Opcode, C1, C2));
432         // Conservatively clear the optional flags, since they may not be
433         // preserved by the reassociation.
434         ClearSubclassDataAfterReassociation(I);
435 
436         Changed = true;
437         continue;
438       }
439     }
440 
441     // No further simplifications.
442     return Changed;
443   } while (true);
444 }
445 
446 /// Return whether "X LOp (Y ROp Z)" is always equal to
447 /// "(X LOp Y) ROp (X LOp Z)".
448 static bool leftDistributesOverRight(Instruction::BinaryOps LOp,
449                                      Instruction::BinaryOps ROp) {
450   // X & (Y | Z) <--> (X & Y) | (X & Z)
451   // X & (Y ^ Z) <--> (X & Y) ^ (X & Z)
452   if (LOp == Instruction::And)
453     return ROp == Instruction::Or || ROp == Instruction::Xor;
454 
455   // X | (Y & Z) <--> (X | Y) & (X | Z)
456   if (LOp == Instruction::Or)
457     return ROp == Instruction::And;
458 
459   // X * (Y + Z) <--> (X * Y) + (X * Z)
460   // X * (Y - Z) <--> (X * Y) - (X * Z)
461   if (LOp == Instruction::Mul)
462     return ROp == Instruction::Add || ROp == Instruction::Sub;
463 
464   return false;
465 }
466 
467 /// Return whether "(X LOp Y) ROp Z" is always equal to
468 /// "(X ROp Z) LOp (Y ROp Z)".
469 static bool rightDistributesOverLeft(Instruction::BinaryOps LOp,
470                                      Instruction::BinaryOps ROp) {
471   if (Instruction::isCommutative(ROp))
472     return leftDistributesOverRight(ROp, LOp);
473 
474   // (X {&|^} Y) >> Z <--> (X >> Z) {&|^} (Y >> Z) for all shifts.
475   return Instruction::isBitwiseLogicOp(LOp) && Instruction::isShift(ROp);
476 
477   // TODO: It would be nice to handle division, aka "(X + Y)/Z = X/Z + Y/Z",
478   // but this requires knowing that the addition does not overflow and other
479   // such subtleties.
480 }
481 
482 /// This function returns identity value for given opcode, which can be used to
483 /// factor patterns like (X * 2) + X ==> (X * 2) + (X * 1) ==> X * (2 + 1).
484 static Value *getIdentityValue(Instruction::BinaryOps Opcode, Value *V) {
485   if (isa<Constant>(V))
486     return nullptr;
487 
488   return ConstantExpr::getBinOpIdentity(Opcode, V->getType());
489 }
490 
491 /// This function predicates factorization using distributive laws. By default,
492 /// it just returns the 'Op' inputs. But for special-cases like
493 /// 'add(shl(X, 5), ...)', this function will have TopOpcode == Instruction::Add
494 /// and Op = shl(X, 5). The 'shl' is treated as the more general 'mul X, 32' to
495 /// allow more factorization opportunities.
496 static Instruction::BinaryOps
497 getBinOpsForFactorization(Instruction::BinaryOps TopOpcode, BinaryOperator *Op,
498                           Value *&LHS, Value *&RHS) {
499   assert(Op && "Expected a binary operator");
500   LHS = Op->getOperand(0);
501   RHS = Op->getOperand(1);
502   if (TopOpcode == Instruction::Add || TopOpcode == Instruction::Sub) {
503     Constant *C;
504     if (match(Op, m_Shl(m_Value(), m_Constant(C)))) {
505       // X << C --> X * (1 << C)
506       RHS = ConstantExpr::getShl(ConstantInt::get(Op->getType(), 1), C);
507       return Instruction::Mul;
508     }
509     // TODO: We can add other conversions e.g. shr => div etc.
510   }
511   return Op->getOpcode();
512 }
513 
514 /// This tries to simplify binary operations by factorizing out common terms
515 /// (e. g. "(A*B)+(A*C)" -> "A*(B+C)").
516 Value *InstCombiner::tryFactorization(BinaryOperator &I,
517                                       Instruction::BinaryOps InnerOpcode,
518                                       Value *A, Value *B, Value *C, Value *D) {
519   assert(A && B && C && D && "All values must be provided");
520 
521   Value *V = nullptr;
522   Value *SimplifiedInst = nullptr;
523   Value *LHS = I.getOperand(0), *RHS = I.getOperand(1);
524   Instruction::BinaryOps TopLevelOpcode = I.getOpcode();
525 
526   // Does "X op' Y" always equal "Y op' X"?
527   bool InnerCommutative = Instruction::isCommutative(InnerOpcode);
528 
529   // Does "X op' (Y op Z)" always equal "(X op' Y) op (X op' Z)"?
530   if (leftDistributesOverRight(InnerOpcode, TopLevelOpcode))
531     // Does the instruction have the form "(A op' B) op (A op' D)" or, in the
532     // commutative case, "(A op' B) op (C op' A)"?
533     if (A == C || (InnerCommutative && A == D)) {
534       if (A != C)
535         std::swap(C, D);
536       // Consider forming "A op' (B op D)".
537       // If "B op D" simplifies then it can be formed with no cost.
538       V = SimplifyBinOp(TopLevelOpcode, B, D, SQ.getWithInstruction(&I));
539       // If "B op D" doesn't simplify then only go on if both of the existing
540       // operations "A op' B" and "C op' D" will be zapped as no longer used.
541       if (!V && LHS->hasOneUse() && RHS->hasOneUse())
542         V = Builder.CreateBinOp(TopLevelOpcode, B, D, RHS->getName());
543       if (V) {
544         SimplifiedInst = Builder.CreateBinOp(InnerOpcode, A, V);
545       }
546     }
547 
548   // Does "(X op Y) op' Z" always equal "(X op' Z) op (Y op' Z)"?
549   if (!SimplifiedInst && rightDistributesOverLeft(TopLevelOpcode, InnerOpcode))
550     // Does the instruction have the form "(A op' B) op (C op' B)" or, in the
551     // commutative case, "(A op' B) op (B op' D)"?
552     if (B == D || (InnerCommutative && B == C)) {
553       if (B != D)
554         std::swap(C, D);
555       // Consider forming "(A op C) op' B".
556       // If "A op C" simplifies then it can be formed with no cost.
557       V = SimplifyBinOp(TopLevelOpcode, A, C, SQ.getWithInstruction(&I));
558 
559       // If "A op C" doesn't simplify then only go on if both of the existing
560       // operations "A op' B" and "C op' D" will be zapped as no longer used.
561       if (!V && LHS->hasOneUse() && RHS->hasOneUse())
562         V = Builder.CreateBinOp(TopLevelOpcode, A, C, LHS->getName());
563       if (V) {
564         SimplifiedInst = Builder.CreateBinOp(InnerOpcode, V, B);
565       }
566     }
567 
568   if (SimplifiedInst) {
569     ++NumFactor;
570     SimplifiedInst->takeName(&I);
571 
572     // Check if we can add NSW flag to SimplifiedInst. If so, set NSW flag.
573     // TODO: Check for NUW.
574     if (BinaryOperator *BO = dyn_cast<BinaryOperator>(SimplifiedInst)) {
575       if (isa<OverflowingBinaryOperator>(SimplifiedInst)) {
576         bool HasNSW = false;
577         if (isa<OverflowingBinaryOperator>(&I))
578           HasNSW = I.hasNoSignedWrap();
579 
580         if (auto *LOBO = dyn_cast<OverflowingBinaryOperator>(LHS))
581           HasNSW &= LOBO->hasNoSignedWrap();
582 
583         if (auto *ROBO = dyn_cast<OverflowingBinaryOperator>(RHS))
584           HasNSW &= ROBO->hasNoSignedWrap();
585 
586         // We can propagate 'nsw' if we know that
587         //  %Y = mul nsw i16 %X, C
588         //  %Z = add nsw i16 %Y, %X
589         // =>
590         //  %Z = mul nsw i16 %X, C+1
591         //
592         // iff C+1 isn't INT_MIN
593         const APInt *CInt;
594         if (TopLevelOpcode == Instruction::Add &&
595             InnerOpcode == Instruction::Mul)
596           if (match(V, m_APInt(CInt)) && !CInt->isMinSignedValue())
597             BO->setHasNoSignedWrap(HasNSW);
598       }
599     }
600   }
601   return SimplifiedInst;
602 }
603 
604 /// This tries to simplify binary operations which some other binary operation
605 /// distributes over either by factorizing out common terms
606 /// (eg "(A*B)+(A*C)" -> "A*(B+C)") or expanding out if this results in
607 /// simplifications (eg: "A & (B | C) -> (A&B) | (A&C)" if this is a win).
608 /// Returns the simplified value, or null if it didn't simplify.
609 Value *InstCombiner::SimplifyUsingDistributiveLaws(BinaryOperator &I) {
610   Value *LHS = I.getOperand(0), *RHS = I.getOperand(1);
611   BinaryOperator *Op0 = dyn_cast<BinaryOperator>(LHS);
612   BinaryOperator *Op1 = dyn_cast<BinaryOperator>(RHS);
613   Instruction::BinaryOps TopLevelOpcode = I.getOpcode();
614 
615   {
616     // Factorization.
617     Value *A, *B, *C, *D;
618     Instruction::BinaryOps LHSOpcode, RHSOpcode;
619     if (Op0)
620       LHSOpcode = getBinOpsForFactorization(TopLevelOpcode, Op0, A, B);
621     if (Op1)
622       RHSOpcode = getBinOpsForFactorization(TopLevelOpcode, Op1, C, D);
623 
624     // The instruction has the form "(A op' B) op (C op' D)".  Try to factorize
625     // a common term.
626     if (Op0 && Op1 && LHSOpcode == RHSOpcode)
627       if (Value *V = tryFactorization(I, LHSOpcode, A, B, C, D))
628         return V;
629 
630     // The instruction has the form "(A op' B) op (C)".  Try to factorize common
631     // term.
632     if (Op0)
633       if (Value *Ident = getIdentityValue(LHSOpcode, RHS))
634         if (Value *V = tryFactorization(I, LHSOpcode, A, B, RHS, Ident))
635           return V;
636 
637     // The instruction has the form "(B) op (C op' D)".  Try to factorize common
638     // term.
639     if (Op1)
640       if (Value *Ident = getIdentityValue(RHSOpcode, LHS))
641         if (Value *V = tryFactorization(I, RHSOpcode, LHS, Ident, C, D))
642           return V;
643   }
644 
645   // Expansion.
646   if (Op0 && rightDistributesOverLeft(Op0->getOpcode(), TopLevelOpcode)) {
647     // The instruction has the form "(A op' B) op C".  See if expanding it out
648     // to "(A op C) op' (B op C)" results in simplifications.
649     Value *A = Op0->getOperand(0), *B = Op0->getOperand(1), *C = RHS;
650     Instruction::BinaryOps InnerOpcode = Op0->getOpcode(); // op'
651 
652     Value *L = SimplifyBinOp(TopLevelOpcode, A, C, SQ.getWithInstruction(&I));
653     Value *R = SimplifyBinOp(TopLevelOpcode, B, C, SQ.getWithInstruction(&I));
654 
655     // Do "A op C" and "B op C" both simplify?
656     if (L && R) {
657       // They do! Return "L op' R".
658       ++NumExpand;
659       C = Builder.CreateBinOp(InnerOpcode, L, R);
660       C->takeName(&I);
661       return C;
662     }
663 
664     // Does "A op C" simplify to the identity value for the inner opcode?
665     if (L && L == ConstantExpr::getBinOpIdentity(InnerOpcode, L->getType())) {
666       // They do! Return "B op C".
667       ++NumExpand;
668       C = Builder.CreateBinOp(TopLevelOpcode, B, C);
669       C->takeName(&I);
670       return C;
671     }
672 
673     // Does "B op C" simplify to the identity value for the inner opcode?
674     if (R && R == ConstantExpr::getBinOpIdentity(InnerOpcode, R->getType())) {
675       // They do! Return "A op C".
676       ++NumExpand;
677       C = Builder.CreateBinOp(TopLevelOpcode, A, C);
678       C->takeName(&I);
679       return C;
680     }
681   }
682 
683   if (Op1 && leftDistributesOverRight(TopLevelOpcode, Op1->getOpcode())) {
684     // The instruction has the form "A op (B op' C)".  See if expanding it out
685     // to "(A op B) op' (A op C)" results in simplifications.
686     Value *A = LHS, *B = Op1->getOperand(0), *C = Op1->getOperand(1);
687     Instruction::BinaryOps InnerOpcode = Op1->getOpcode(); // op'
688 
689     Value *L = SimplifyBinOp(TopLevelOpcode, A, B, SQ.getWithInstruction(&I));
690     Value *R = SimplifyBinOp(TopLevelOpcode, A, C, SQ.getWithInstruction(&I));
691 
692     // Do "A op B" and "A op C" both simplify?
693     if (L && R) {
694       // They do! Return "L op' R".
695       ++NumExpand;
696       A = Builder.CreateBinOp(InnerOpcode, L, R);
697       A->takeName(&I);
698       return A;
699     }
700 
701     // Does "A op B" simplify to the identity value for the inner opcode?
702     if (L && L == ConstantExpr::getBinOpIdentity(InnerOpcode, L->getType())) {
703       // They do! Return "A op C".
704       ++NumExpand;
705       A = Builder.CreateBinOp(TopLevelOpcode, A, C);
706       A->takeName(&I);
707       return A;
708     }
709 
710     // Does "A op C" simplify to the identity value for the inner opcode?
711     if (R && R == ConstantExpr::getBinOpIdentity(InnerOpcode, R->getType())) {
712       // They do! Return "A op B".
713       ++NumExpand;
714       A = Builder.CreateBinOp(TopLevelOpcode, A, B);
715       A->takeName(&I);
716       return A;
717     }
718   }
719 
720   return SimplifySelectsFeedingBinaryOp(I, LHS, RHS);
721 }
722 
723 Value *InstCombiner::SimplifySelectsFeedingBinaryOp(BinaryOperator &I,
724                                                     Value *LHS, Value *RHS) {
725   Instruction::BinaryOps Opcode = I.getOpcode();
726   // (op (select (a, b, c)), (select (a, d, e))) -> (select (a, (op b, d), (op
727   // c, e)))
728   Value *A, *B, *C, *D, *E;
729   Value *SI = nullptr;
730   if (match(LHS, m_Select(m_Value(A), m_Value(B), m_Value(C))) &&
731       match(RHS, m_Select(m_Specific(A), m_Value(D), m_Value(E)))) {
732     bool SelectsHaveOneUse = LHS->hasOneUse() && RHS->hasOneUse();
733     BuilderTy::FastMathFlagGuard Guard(Builder);
734     if (isa<FPMathOperator>(&I))
735       Builder.setFastMathFlags(I.getFastMathFlags());
736 
737     Value *V1 = SimplifyBinOp(Opcode, C, E, SQ.getWithInstruction(&I));
738     Value *V2 = SimplifyBinOp(Opcode, B, D, SQ.getWithInstruction(&I));
739     if (V1 && V2)
740       SI = Builder.CreateSelect(A, V2, V1);
741     else if (V2 && SelectsHaveOneUse)
742       SI = Builder.CreateSelect(A, V2, Builder.CreateBinOp(Opcode, C, E));
743     else if (V1 && SelectsHaveOneUse)
744       SI = Builder.CreateSelect(A, Builder.CreateBinOp(Opcode, B, D), V1);
745 
746     if (SI)
747       SI->takeName(&I);
748   }
749 
750   return SI;
751 }
752 
753 /// Given a 'sub' instruction, return the RHS of the instruction if the LHS is a
754 /// constant zero (which is the 'negate' form).
755 Value *InstCombiner::dyn_castNegVal(Value *V) const {
756   Value *NegV;
757   if (match(V, m_Neg(m_Value(NegV))))
758     return NegV;
759 
760   // Constants can be considered to be negated values if they can be folded.
761   if (ConstantInt *C = dyn_cast<ConstantInt>(V))
762     return ConstantExpr::getNeg(C);
763 
764   if (ConstantDataVector *C = dyn_cast<ConstantDataVector>(V))
765     if (C->getType()->getElementType()->isIntegerTy())
766       return ConstantExpr::getNeg(C);
767 
768   if (ConstantVector *CV = dyn_cast<ConstantVector>(V)) {
769     for (unsigned i = 0, e = CV->getNumOperands(); i != e; ++i) {
770       Constant *Elt = CV->getAggregateElement(i);
771       if (!Elt)
772         return nullptr;
773 
774       if (isa<UndefValue>(Elt))
775         continue;
776 
777       if (!isa<ConstantInt>(Elt))
778         return nullptr;
779     }
780     return ConstantExpr::getNeg(CV);
781   }
782 
783   return nullptr;
784 }
785 
786 static Value *foldOperationIntoSelectOperand(Instruction &I, Value *SO,
787                                              InstCombiner::BuilderTy &Builder) {
788   if (auto *Cast = dyn_cast<CastInst>(&I))
789     return Builder.CreateCast(Cast->getOpcode(), SO, I.getType());
790 
791   assert(I.isBinaryOp() && "Unexpected opcode for select folding");
792 
793   // Figure out if the constant is the left or the right argument.
794   bool ConstIsRHS = isa<Constant>(I.getOperand(1));
795   Constant *ConstOperand = cast<Constant>(I.getOperand(ConstIsRHS));
796 
797   if (auto *SOC = dyn_cast<Constant>(SO)) {
798     if (ConstIsRHS)
799       return ConstantExpr::get(I.getOpcode(), SOC, ConstOperand);
800     return ConstantExpr::get(I.getOpcode(), ConstOperand, SOC);
801   }
802 
803   Value *Op0 = SO, *Op1 = ConstOperand;
804   if (!ConstIsRHS)
805     std::swap(Op0, Op1);
806 
807   auto *BO = cast<BinaryOperator>(&I);
808   Value *RI = Builder.CreateBinOp(BO->getOpcode(), Op0, Op1,
809                                   SO->getName() + ".op");
810   auto *FPInst = dyn_cast<Instruction>(RI);
811   if (FPInst && isa<FPMathOperator>(FPInst))
812     FPInst->copyFastMathFlags(BO);
813   return RI;
814 }
815 
816 Instruction *InstCombiner::FoldOpIntoSelect(Instruction &Op, SelectInst *SI) {
817   // Don't modify shared select instructions.
818   if (!SI->hasOneUse())
819     return nullptr;
820 
821   Value *TV = SI->getTrueValue();
822   Value *FV = SI->getFalseValue();
823   if (!(isa<Constant>(TV) || isa<Constant>(FV)))
824     return nullptr;
825 
826   // Bool selects with constant operands can be folded to logical ops.
827   if (SI->getType()->isIntOrIntVectorTy(1))
828     return nullptr;
829 
830   // If it's a bitcast involving vectors, make sure it has the same number of
831   // elements on both sides.
832   if (auto *BC = dyn_cast<BitCastInst>(&Op)) {
833     VectorType *DestTy = dyn_cast<VectorType>(BC->getDestTy());
834     VectorType *SrcTy = dyn_cast<VectorType>(BC->getSrcTy());
835 
836     // Verify that either both or neither are vectors.
837     if ((SrcTy == nullptr) != (DestTy == nullptr))
838       return nullptr;
839 
840     // If vectors, verify that they have the same number of elements.
841     if (SrcTy && SrcTy->getNumElements() != DestTy->getNumElements())
842       return nullptr;
843   }
844 
845   // Test if a CmpInst instruction is used exclusively by a select as
846   // part of a minimum or maximum operation. If so, refrain from doing
847   // any other folding. This helps out other analyses which understand
848   // non-obfuscated minimum and maximum idioms, such as ScalarEvolution
849   // and CodeGen. And in this case, at least one of the comparison
850   // operands has at least one user besides the compare (the select),
851   // which would often largely negate the benefit of folding anyway.
852   if (auto *CI = dyn_cast<CmpInst>(SI->getCondition())) {
853     if (CI->hasOneUse()) {
854       Value *Op0 = CI->getOperand(0), *Op1 = CI->getOperand(1);
855       if ((SI->getOperand(1) == Op0 && SI->getOperand(2) == Op1) ||
856           (SI->getOperand(2) == Op0 && SI->getOperand(1) == Op1))
857         return nullptr;
858     }
859   }
860 
861   Value *NewTV = foldOperationIntoSelectOperand(Op, TV, Builder);
862   Value *NewFV = foldOperationIntoSelectOperand(Op, FV, Builder);
863   return SelectInst::Create(SI->getCondition(), NewTV, NewFV, "", nullptr, SI);
864 }
865 
866 static Value *foldOperationIntoPhiValue(BinaryOperator *I, Value *InV,
867                                         InstCombiner::BuilderTy &Builder) {
868   bool ConstIsRHS = isa<Constant>(I->getOperand(1));
869   Constant *C = cast<Constant>(I->getOperand(ConstIsRHS));
870 
871   if (auto *InC = dyn_cast<Constant>(InV)) {
872     if (ConstIsRHS)
873       return ConstantExpr::get(I->getOpcode(), InC, C);
874     return ConstantExpr::get(I->getOpcode(), C, InC);
875   }
876 
877   Value *Op0 = InV, *Op1 = C;
878   if (!ConstIsRHS)
879     std::swap(Op0, Op1);
880 
881   Value *RI = Builder.CreateBinOp(I->getOpcode(), Op0, Op1, "phitmp");
882   auto *FPInst = dyn_cast<Instruction>(RI);
883   if (FPInst && isa<FPMathOperator>(FPInst))
884     FPInst->copyFastMathFlags(I);
885   return RI;
886 }
887 
888 Instruction *InstCombiner::foldOpIntoPhi(Instruction &I, PHINode *PN) {
889   unsigned NumPHIValues = PN->getNumIncomingValues();
890   if (NumPHIValues == 0)
891     return nullptr;
892 
893   // We normally only transform phis with a single use.  However, if a PHI has
894   // multiple uses and they are all the same operation, we can fold *all* of the
895   // uses into the PHI.
896   if (!PN->hasOneUse()) {
897     // Walk the use list for the instruction, comparing them to I.
898     for (User *U : PN->users()) {
899       Instruction *UI = cast<Instruction>(U);
900       if (UI != &I && !I.isIdenticalTo(UI))
901         return nullptr;
902     }
903     // Otherwise, we can replace *all* users with the new PHI we form.
904   }
905 
906   // Check to see if all of the operands of the PHI are simple constants
907   // (constantint/constantfp/undef).  If there is one non-constant value,
908   // remember the BB it is in.  If there is more than one or if *it* is a PHI,
909   // bail out.  We don't do arbitrary constant expressions here because moving
910   // their computation can be expensive without a cost model.
911   BasicBlock *NonConstBB = nullptr;
912   for (unsigned i = 0; i != NumPHIValues; ++i) {
913     Value *InVal = PN->getIncomingValue(i);
914     if (isa<Constant>(InVal) && !isa<ConstantExpr>(InVal))
915       continue;
916 
917     if (isa<PHINode>(InVal)) return nullptr;  // Itself a phi.
918     if (NonConstBB) return nullptr;  // More than one non-const value.
919 
920     NonConstBB = PN->getIncomingBlock(i);
921 
922     // If the InVal is an invoke at the end of the pred block, then we can't
923     // insert a computation after it without breaking the edge.
924     if (isa<InvokeInst>(InVal))
925       if (cast<Instruction>(InVal)->getParent() == NonConstBB)
926         return nullptr;
927 
928     // If the incoming non-constant value is in I's block, we will remove one
929     // instruction, but insert another equivalent one, leading to infinite
930     // instcombine.
931     if (isPotentiallyReachable(I.getParent(), NonConstBB, &DT, LI))
932       return nullptr;
933   }
934 
935   // If there is exactly one non-constant value, we can insert a copy of the
936   // operation in that block.  However, if this is a critical edge, we would be
937   // inserting the computation on some other paths (e.g. inside a loop).  Only
938   // do this if the pred block is unconditionally branching into the phi block.
939   if (NonConstBB != nullptr) {
940     BranchInst *BI = dyn_cast<BranchInst>(NonConstBB->getTerminator());
941     if (!BI || !BI->isUnconditional()) return nullptr;
942   }
943 
944   // Okay, we can do the transformation: create the new PHI node.
945   PHINode *NewPN = PHINode::Create(I.getType(), PN->getNumIncomingValues());
946   InsertNewInstBefore(NewPN, *PN);
947   NewPN->takeName(PN);
948 
949   // If we are going to have to insert a new computation, do so right before the
950   // predecessor's terminator.
951   if (NonConstBB)
952     Builder.SetInsertPoint(NonConstBB->getTerminator());
953 
954   // Next, add all of the operands to the PHI.
955   if (SelectInst *SI = dyn_cast<SelectInst>(&I)) {
956     // We only currently try to fold the condition of a select when it is a phi,
957     // not the true/false values.
958     Value *TrueV = SI->getTrueValue();
959     Value *FalseV = SI->getFalseValue();
960     BasicBlock *PhiTransBB = PN->getParent();
961     for (unsigned i = 0; i != NumPHIValues; ++i) {
962       BasicBlock *ThisBB = PN->getIncomingBlock(i);
963       Value *TrueVInPred = TrueV->DoPHITranslation(PhiTransBB, ThisBB);
964       Value *FalseVInPred = FalseV->DoPHITranslation(PhiTransBB, ThisBB);
965       Value *InV = nullptr;
966       // Beware of ConstantExpr:  it may eventually evaluate to getNullValue,
967       // even if currently isNullValue gives false.
968       Constant *InC = dyn_cast<Constant>(PN->getIncomingValue(i));
969       // For vector constants, we cannot use isNullValue to fold into
970       // FalseVInPred versus TrueVInPred. When we have individual nonzero
971       // elements in the vector, we will incorrectly fold InC to
972       // `TrueVInPred`.
973       if (InC && !isa<ConstantExpr>(InC) && isa<ConstantInt>(InC))
974         InV = InC->isNullValue() ? FalseVInPred : TrueVInPred;
975       else {
976         // Generate the select in the same block as PN's current incoming block.
977         // Note: ThisBB need not be the NonConstBB because vector constants
978         // which are constants by definition are handled here.
979         // FIXME: This can lead to an increase in IR generation because we might
980         // generate selects for vector constant phi operand, that could not be
981         // folded to TrueVInPred or FalseVInPred as done for ConstantInt. For
982         // non-vector phis, this transformation was always profitable because
983         // the select would be generated exactly once in the NonConstBB.
984         Builder.SetInsertPoint(ThisBB->getTerminator());
985         InV = Builder.CreateSelect(PN->getIncomingValue(i), TrueVInPred,
986                                    FalseVInPred, "phitmp");
987       }
988       NewPN->addIncoming(InV, ThisBB);
989     }
990   } else if (CmpInst *CI = dyn_cast<CmpInst>(&I)) {
991     Constant *C = cast<Constant>(I.getOperand(1));
992     for (unsigned i = 0; i != NumPHIValues; ++i) {
993       Value *InV = nullptr;
994       if (Constant *InC = dyn_cast<Constant>(PN->getIncomingValue(i)))
995         InV = ConstantExpr::getCompare(CI->getPredicate(), InC, C);
996       else if (isa<ICmpInst>(CI))
997         InV = Builder.CreateICmp(CI->getPredicate(), PN->getIncomingValue(i),
998                                  C, "phitmp");
999       else
1000         InV = Builder.CreateFCmp(CI->getPredicate(), PN->getIncomingValue(i),
1001                                  C, "phitmp");
1002       NewPN->addIncoming(InV, PN->getIncomingBlock(i));
1003     }
1004   } else if (auto *BO = dyn_cast<BinaryOperator>(&I)) {
1005     for (unsigned i = 0; i != NumPHIValues; ++i) {
1006       Value *InV = foldOperationIntoPhiValue(BO, PN->getIncomingValue(i),
1007                                              Builder);
1008       NewPN->addIncoming(InV, PN->getIncomingBlock(i));
1009     }
1010   } else {
1011     CastInst *CI = cast<CastInst>(&I);
1012     Type *RetTy = CI->getType();
1013     for (unsigned i = 0; i != NumPHIValues; ++i) {
1014       Value *InV;
1015       if (Constant *InC = dyn_cast<Constant>(PN->getIncomingValue(i)))
1016         InV = ConstantExpr::getCast(CI->getOpcode(), InC, RetTy);
1017       else
1018         InV = Builder.CreateCast(CI->getOpcode(), PN->getIncomingValue(i),
1019                                  I.getType(), "phitmp");
1020       NewPN->addIncoming(InV, PN->getIncomingBlock(i));
1021     }
1022   }
1023 
1024   for (auto UI = PN->user_begin(), E = PN->user_end(); UI != E;) {
1025     Instruction *User = cast<Instruction>(*UI++);
1026     if (User == &I) continue;
1027     replaceInstUsesWith(*User, NewPN);
1028     eraseInstFromFunction(*User);
1029   }
1030   return replaceInstUsesWith(I, NewPN);
1031 }
1032 
1033 Instruction *InstCombiner::foldBinOpIntoSelectOrPhi(BinaryOperator &I) {
1034   if (!isa<Constant>(I.getOperand(1)))
1035     return nullptr;
1036 
1037   if (auto *Sel = dyn_cast<SelectInst>(I.getOperand(0))) {
1038     if (Instruction *NewSel = FoldOpIntoSelect(I, Sel))
1039       return NewSel;
1040   } else if (auto *PN = dyn_cast<PHINode>(I.getOperand(0))) {
1041     if (Instruction *NewPhi = foldOpIntoPhi(I, PN))
1042       return NewPhi;
1043   }
1044   return nullptr;
1045 }
1046 
1047 /// Given a pointer type and a constant offset, determine whether or not there
1048 /// is a sequence of GEP indices into the pointed type that will land us at the
1049 /// specified offset. If so, fill them into NewIndices and return the resultant
1050 /// element type, otherwise return null.
1051 Type *InstCombiner::FindElementAtOffset(PointerType *PtrTy, int64_t Offset,
1052                                         SmallVectorImpl<Value *> &NewIndices) {
1053   Type *Ty = PtrTy->getElementType();
1054   if (!Ty->isSized())
1055     return nullptr;
1056 
1057   // Start with the index over the outer type.  Note that the type size
1058   // might be zero (even if the offset isn't zero) if the indexed type
1059   // is something like [0 x {int, int}]
1060   Type *IndexTy = DL.getIndexType(PtrTy);
1061   int64_t FirstIdx = 0;
1062   if (int64_t TySize = DL.getTypeAllocSize(Ty)) {
1063     FirstIdx = Offset/TySize;
1064     Offset -= FirstIdx*TySize;
1065 
1066     // Handle hosts where % returns negative instead of values [0..TySize).
1067     if (Offset < 0) {
1068       --FirstIdx;
1069       Offset += TySize;
1070       assert(Offset >= 0);
1071     }
1072     assert((uint64_t)Offset < (uint64_t)TySize && "Out of range offset");
1073   }
1074 
1075   NewIndices.push_back(ConstantInt::get(IndexTy, FirstIdx));
1076 
1077   // Index into the types.  If we fail, set OrigBase to null.
1078   while (Offset) {
1079     // Indexing into tail padding between struct/array elements.
1080     if (uint64_t(Offset * 8) >= DL.getTypeSizeInBits(Ty))
1081       return nullptr;
1082 
1083     if (StructType *STy = dyn_cast<StructType>(Ty)) {
1084       const StructLayout *SL = DL.getStructLayout(STy);
1085       assert(Offset < (int64_t)SL->getSizeInBytes() &&
1086              "Offset must stay within the indexed type");
1087 
1088       unsigned Elt = SL->getElementContainingOffset(Offset);
1089       NewIndices.push_back(ConstantInt::get(Type::getInt32Ty(Ty->getContext()),
1090                                             Elt));
1091 
1092       Offset -= SL->getElementOffset(Elt);
1093       Ty = STy->getElementType(Elt);
1094     } else if (ArrayType *AT = dyn_cast<ArrayType>(Ty)) {
1095       uint64_t EltSize = DL.getTypeAllocSize(AT->getElementType());
1096       assert(EltSize && "Cannot index into a zero-sized array");
1097       NewIndices.push_back(ConstantInt::get(IndexTy,Offset/EltSize));
1098       Offset %= EltSize;
1099       Ty = AT->getElementType();
1100     } else {
1101       // Otherwise, we can't index into the middle of this atomic type, bail.
1102       return nullptr;
1103     }
1104   }
1105 
1106   return Ty;
1107 }
1108 
1109 static bool shouldMergeGEPs(GEPOperator &GEP, GEPOperator &Src) {
1110   // If this GEP has only 0 indices, it is the same pointer as
1111   // Src. If Src is not a trivial GEP too, don't combine
1112   // the indices.
1113   if (GEP.hasAllZeroIndices() && !Src.hasAllZeroIndices() &&
1114       !Src.hasOneUse())
1115     return false;
1116   return true;
1117 }
1118 
1119 /// Return a value X such that Val = X * Scale, or null if none.
1120 /// If the multiplication is known not to overflow, then NoSignedWrap is set.
1121 Value *InstCombiner::Descale(Value *Val, APInt Scale, bool &NoSignedWrap) {
1122   assert(isa<IntegerType>(Val->getType()) && "Can only descale integers!");
1123   assert(cast<IntegerType>(Val->getType())->getBitWidth() ==
1124          Scale.getBitWidth() && "Scale not compatible with value!");
1125 
1126   // If Val is zero or Scale is one then Val = Val * Scale.
1127   if (match(Val, m_Zero()) || Scale == 1) {
1128     NoSignedWrap = true;
1129     return Val;
1130   }
1131 
1132   // If Scale is zero then it does not divide Val.
1133   if (Scale.isMinValue())
1134     return nullptr;
1135 
1136   // Look through chains of multiplications, searching for a constant that is
1137   // divisible by Scale.  For example, descaling X*(Y*(Z*4)) by a factor of 4
1138   // will find the constant factor 4 and produce X*(Y*Z).  Descaling X*(Y*8) by
1139   // a factor of 4 will produce X*(Y*2).  The principle of operation is to bore
1140   // down from Val:
1141   //
1142   //     Val = M1 * X          ||   Analysis starts here and works down
1143   //      M1 = M2 * Y          ||   Doesn't descend into terms with more
1144   //      M2 =  Z * 4          \/   than one use
1145   //
1146   // Then to modify a term at the bottom:
1147   //
1148   //     Val = M1 * X
1149   //      M1 =  Z * Y          ||   Replaced M2 with Z
1150   //
1151   // Then to work back up correcting nsw flags.
1152 
1153   // Op - the term we are currently analyzing.  Starts at Val then drills down.
1154   // Replaced with its descaled value before exiting from the drill down loop.
1155   Value *Op = Val;
1156 
1157   // Parent - initially null, but after drilling down notes where Op came from.
1158   // In the example above, Parent is (Val, 0) when Op is M1, because M1 is the
1159   // 0'th operand of Val.
1160   std::pair<Instruction *, unsigned> Parent;
1161 
1162   // Set if the transform requires a descaling at deeper levels that doesn't
1163   // overflow.
1164   bool RequireNoSignedWrap = false;
1165 
1166   // Log base 2 of the scale. Negative if not a power of 2.
1167   int32_t logScale = Scale.exactLogBase2();
1168 
1169   for (;; Op = Parent.first->getOperand(Parent.second)) { // Drill down
1170     if (ConstantInt *CI = dyn_cast<ConstantInt>(Op)) {
1171       // If Op is a constant divisible by Scale then descale to the quotient.
1172       APInt Quotient(Scale), Remainder(Scale); // Init ensures right bitwidth.
1173       APInt::sdivrem(CI->getValue(), Scale, Quotient, Remainder);
1174       if (!Remainder.isMinValue())
1175         // Not divisible by Scale.
1176         return nullptr;
1177       // Replace with the quotient in the parent.
1178       Op = ConstantInt::get(CI->getType(), Quotient);
1179       NoSignedWrap = true;
1180       break;
1181     }
1182 
1183     if (BinaryOperator *BO = dyn_cast<BinaryOperator>(Op)) {
1184       if (BO->getOpcode() == Instruction::Mul) {
1185         // Multiplication.
1186         NoSignedWrap = BO->hasNoSignedWrap();
1187         if (RequireNoSignedWrap && !NoSignedWrap)
1188           return nullptr;
1189 
1190         // There are three cases for multiplication: multiplication by exactly
1191         // the scale, multiplication by a constant different to the scale, and
1192         // multiplication by something else.
1193         Value *LHS = BO->getOperand(0);
1194         Value *RHS = BO->getOperand(1);
1195 
1196         if (ConstantInt *CI = dyn_cast<ConstantInt>(RHS)) {
1197           // Multiplication by a constant.
1198           if (CI->getValue() == Scale) {
1199             // Multiplication by exactly the scale, replace the multiplication
1200             // by its left-hand side in the parent.
1201             Op = LHS;
1202             break;
1203           }
1204 
1205           // Otherwise drill down into the constant.
1206           if (!Op->hasOneUse())
1207             return nullptr;
1208 
1209           Parent = std::make_pair(BO, 1);
1210           continue;
1211         }
1212 
1213         // Multiplication by something else. Drill down into the left-hand side
1214         // since that's where the reassociate pass puts the good stuff.
1215         if (!Op->hasOneUse())
1216           return nullptr;
1217 
1218         Parent = std::make_pair(BO, 0);
1219         continue;
1220       }
1221 
1222       if (logScale > 0 && BO->getOpcode() == Instruction::Shl &&
1223           isa<ConstantInt>(BO->getOperand(1))) {
1224         // Multiplication by a power of 2.
1225         NoSignedWrap = BO->hasNoSignedWrap();
1226         if (RequireNoSignedWrap && !NoSignedWrap)
1227           return nullptr;
1228 
1229         Value *LHS = BO->getOperand(0);
1230         int32_t Amt = cast<ConstantInt>(BO->getOperand(1))->
1231           getLimitedValue(Scale.getBitWidth());
1232         // Op = LHS << Amt.
1233 
1234         if (Amt == logScale) {
1235           // Multiplication by exactly the scale, replace the multiplication
1236           // by its left-hand side in the parent.
1237           Op = LHS;
1238           break;
1239         }
1240         if (Amt < logScale || !Op->hasOneUse())
1241           return nullptr;
1242 
1243         // Multiplication by more than the scale.  Reduce the multiplying amount
1244         // by the scale in the parent.
1245         Parent = std::make_pair(BO, 1);
1246         Op = ConstantInt::get(BO->getType(), Amt - logScale);
1247         break;
1248       }
1249     }
1250 
1251     if (!Op->hasOneUse())
1252       return nullptr;
1253 
1254     if (CastInst *Cast = dyn_cast<CastInst>(Op)) {
1255       if (Cast->getOpcode() == Instruction::SExt) {
1256         // Op is sign-extended from a smaller type, descale in the smaller type.
1257         unsigned SmallSize = Cast->getSrcTy()->getPrimitiveSizeInBits();
1258         APInt SmallScale = Scale.trunc(SmallSize);
1259         // Suppose Op = sext X, and we descale X as Y * SmallScale.  We want to
1260         // descale Op as (sext Y) * Scale.  In order to have
1261         //   sext (Y * SmallScale) = (sext Y) * Scale
1262         // some conditions need to hold however: SmallScale must sign-extend to
1263         // Scale and the multiplication Y * SmallScale should not overflow.
1264         if (SmallScale.sext(Scale.getBitWidth()) != Scale)
1265           // SmallScale does not sign-extend to Scale.
1266           return nullptr;
1267         assert(SmallScale.exactLogBase2() == logScale);
1268         // Require that Y * SmallScale must not overflow.
1269         RequireNoSignedWrap = true;
1270 
1271         // Drill down through the cast.
1272         Parent = std::make_pair(Cast, 0);
1273         Scale = SmallScale;
1274         continue;
1275       }
1276 
1277       if (Cast->getOpcode() == Instruction::Trunc) {
1278         // Op is truncated from a larger type, descale in the larger type.
1279         // Suppose Op = trunc X, and we descale X as Y * sext Scale.  Then
1280         //   trunc (Y * sext Scale) = (trunc Y) * Scale
1281         // always holds.  However (trunc Y) * Scale may overflow even if
1282         // trunc (Y * sext Scale) does not, so nsw flags need to be cleared
1283         // from this point up in the expression (see later).
1284         if (RequireNoSignedWrap)
1285           return nullptr;
1286 
1287         // Drill down through the cast.
1288         unsigned LargeSize = Cast->getSrcTy()->getPrimitiveSizeInBits();
1289         Parent = std::make_pair(Cast, 0);
1290         Scale = Scale.sext(LargeSize);
1291         if (logScale + 1 == (int32_t)Cast->getType()->getPrimitiveSizeInBits())
1292           logScale = -1;
1293         assert(Scale.exactLogBase2() == logScale);
1294         continue;
1295       }
1296     }
1297 
1298     // Unsupported expression, bail out.
1299     return nullptr;
1300   }
1301 
1302   // If Op is zero then Val = Op * Scale.
1303   if (match(Op, m_Zero())) {
1304     NoSignedWrap = true;
1305     return Op;
1306   }
1307 
1308   // We know that we can successfully descale, so from here on we can safely
1309   // modify the IR.  Op holds the descaled version of the deepest term in the
1310   // expression.  NoSignedWrap is 'true' if multiplying Op by Scale is known
1311   // not to overflow.
1312 
1313   if (!Parent.first)
1314     // The expression only had one term.
1315     return Op;
1316 
1317   // Rewrite the parent using the descaled version of its operand.
1318   assert(Parent.first->hasOneUse() && "Drilled down when more than one use!");
1319   assert(Op != Parent.first->getOperand(Parent.second) &&
1320          "Descaling was a no-op?");
1321   Parent.first->setOperand(Parent.second, Op);
1322   Worklist.Add(Parent.first);
1323 
1324   // Now work back up the expression correcting nsw flags.  The logic is based
1325   // on the following observation: if X * Y is known not to overflow as a signed
1326   // multiplication, and Y is replaced by a value Z with smaller absolute value,
1327   // then X * Z will not overflow as a signed multiplication either.  As we work
1328   // our way up, having NoSignedWrap 'true' means that the descaled value at the
1329   // current level has strictly smaller absolute value than the original.
1330   Instruction *Ancestor = Parent.first;
1331   do {
1332     if (BinaryOperator *BO = dyn_cast<BinaryOperator>(Ancestor)) {
1333       // If the multiplication wasn't nsw then we can't say anything about the
1334       // value of the descaled multiplication, and we have to clear nsw flags
1335       // from this point on up.
1336       bool OpNoSignedWrap = BO->hasNoSignedWrap();
1337       NoSignedWrap &= OpNoSignedWrap;
1338       if (NoSignedWrap != OpNoSignedWrap) {
1339         BO->setHasNoSignedWrap(NoSignedWrap);
1340         Worklist.Add(Ancestor);
1341       }
1342     } else if (Ancestor->getOpcode() == Instruction::Trunc) {
1343       // The fact that the descaled input to the trunc has smaller absolute
1344       // value than the original input doesn't tell us anything useful about
1345       // the absolute values of the truncations.
1346       NoSignedWrap = false;
1347     }
1348     assert((Ancestor->getOpcode() != Instruction::SExt || NoSignedWrap) &&
1349            "Failed to keep proper track of nsw flags while drilling down?");
1350 
1351     if (Ancestor == Val)
1352       // Got to the top, all done!
1353       return Val;
1354 
1355     // Move up one level in the expression.
1356     assert(Ancestor->hasOneUse() && "Drilled down when more than one use!");
1357     Ancestor = Ancestor->user_back();
1358   } while (true);
1359 }
1360 
1361 Instruction *InstCombiner::foldVectorBinop(BinaryOperator &Inst) {
1362   if (!Inst.getType()->isVectorTy()) return nullptr;
1363 
1364   BinaryOperator::BinaryOps Opcode = Inst.getOpcode();
1365   unsigned NumElts = cast<VectorType>(Inst.getType())->getNumElements();
1366   Value *LHS = Inst.getOperand(0), *RHS = Inst.getOperand(1);
1367   assert(cast<VectorType>(LHS->getType())->getNumElements() == NumElts);
1368   assert(cast<VectorType>(RHS->getType())->getNumElements() == NumElts);
1369 
1370   // If both operands of the binop are vector concatenations, then perform the
1371   // narrow binop on each pair of the source operands followed by concatenation
1372   // of the results.
1373   Value *L0, *L1, *R0, *R1;
1374   Constant *Mask;
1375   if (match(LHS, m_ShuffleVector(m_Value(L0), m_Value(L1), m_Constant(Mask))) &&
1376       match(RHS, m_ShuffleVector(m_Value(R0), m_Value(R1), m_Specific(Mask))) &&
1377       LHS->hasOneUse() && RHS->hasOneUse() &&
1378       cast<ShuffleVectorInst>(LHS)->isConcat() &&
1379       cast<ShuffleVectorInst>(RHS)->isConcat()) {
1380     // This transform does not have the speculative execution constraint as
1381     // below because the shuffle is a concatenation. The new binops are
1382     // operating on exactly the same elements as the existing binop.
1383     // TODO: We could ease the mask requirement to allow different undef lanes,
1384     //       but that requires an analysis of the binop-with-undef output value.
1385     Value *NewBO0 = Builder.CreateBinOp(Opcode, L0, R0);
1386     if (auto *BO = dyn_cast<BinaryOperator>(NewBO0))
1387       BO->copyIRFlags(&Inst);
1388     Value *NewBO1 = Builder.CreateBinOp(Opcode, L1, R1);
1389     if (auto *BO = dyn_cast<BinaryOperator>(NewBO1))
1390       BO->copyIRFlags(&Inst);
1391     return new ShuffleVectorInst(NewBO0, NewBO1, Mask);
1392   }
1393 
1394   // It may not be safe to reorder shuffles and things like div, urem, etc.
1395   // because we may trap when executing those ops on unknown vector elements.
1396   // See PR20059.
1397   if (!isSafeToSpeculativelyExecute(&Inst))
1398     return nullptr;
1399 
1400   auto createBinOpShuffle = [&](Value *X, Value *Y, Constant *M) {
1401     Value *XY = Builder.CreateBinOp(Opcode, X, Y);
1402     if (auto *BO = dyn_cast<BinaryOperator>(XY))
1403       BO->copyIRFlags(&Inst);
1404     return new ShuffleVectorInst(XY, UndefValue::get(XY->getType()), M);
1405   };
1406 
1407   // If both arguments of the binary operation are shuffles that use the same
1408   // mask and shuffle within a single vector, move the shuffle after the binop.
1409   Value *V1, *V2;
1410   if (match(LHS, m_ShuffleVector(m_Value(V1), m_Undef(), m_Constant(Mask))) &&
1411       match(RHS, m_ShuffleVector(m_Value(V2), m_Undef(), m_Specific(Mask))) &&
1412       V1->getType() == V2->getType() &&
1413       (LHS->hasOneUse() || RHS->hasOneUse() || LHS == RHS)) {
1414     // Op(shuffle(V1, Mask), shuffle(V2, Mask)) -> shuffle(Op(V1, V2), Mask)
1415     return createBinOpShuffle(V1, V2, Mask);
1416   }
1417 
1418   // If one argument is a shuffle within one vector and the other is a constant,
1419   // try moving the shuffle after the binary operation. This canonicalization
1420   // intends to move shuffles closer to other shuffles and binops closer to
1421   // other binops, so they can be folded. It may also enable demanded elements
1422   // transforms.
1423   Constant *C;
1424   if (match(&Inst, m_c_BinOp(
1425           m_OneUse(m_ShuffleVector(m_Value(V1), m_Undef(), m_Constant(Mask))),
1426           m_Constant(C))) &&
1427       V1->getType()->getVectorNumElements() <= NumElts) {
1428     assert(Inst.getType()->getScalarType() == V1->getType()->getScalarType() &&
1429            "Shuffle should not change scalar type");
1430 
1431     // Find constant NewC that has property:
1432     //   shuffle(NewC, ShMask) = C
1433     // If such constant does not exist (example: ShMask=<0,0> and C=<1,2>)
1434     // reorder is not possible. A 1-to-1 mapping is not required. Example:
1435     // ShMask = <1,1,2,2> and C = <5,5,6,6> --> NewC = <undef,5,6,undef>
1436     bool ConstOp1 = isa<Constant>(RHS);
1437     SmallVector<int, 16> ShMask;
1438     ShuffleVectorInst::getShuffleMask(Mask, ShMask);
1439     unsigned SrcVecNumElts = V1->getType()->getVectorNumElements();
1440     UndefValue *UndefScalar = UndefValue::get(C->getType()->getScalarType());
1441     SmallVector<Constant *, 16> NewVecC(SrcVecNumElts, UndefScalar);
1442     bool MayChange = true;
1443     for (unsigned I = 0; I < NumElts; ++I) {
1444       Constant *CElt = C->getAggregateElement(I);
1445       if (ShMask[I] >= 0) {
1446         assert(ShMask[I] < (int)NumElts && "Not expecting narrowing shuffle");
1447         Constant *NewCElt = NewVecC[ShMask[I]];
1448         // Bail out if:
1449         // 1. The constant vector contains a constant expression.
1450         // 2. The shuffle needs an element of the constant vector that can't
1451         //    be mapped to a new constant vector.
1452         // 3. This is a widening shuffle that copies elements of V1 into the
1453         //    extended elements (extending with undef is allowed).
1454         if (!CElt || (!isa<UndefValue>(NewCElt) && NewCElt != CElt) ||
1455             I >= SrcVecNumElts) {
1456           MayChange = false;
1457           break;
1458         }
1459         NewVecC[ShMask[I]] = CElt;
1460       }
1461       // If this is a widening shuffle, we must be able to extend with undef
1462       // elements. If the original binop does not produce an undef in the high
1463       // lanes, then this transform is not safe.
1464       // TODO: We could shuffle those non-undef constant values into the
1465       //       result by using a constant vector (rather than an undef vector)
1466       //       as operand 1 of the new binop, but that might be too aggressive
1467       //       for target-independent shuffle creation.
1468       if (I >= SrcVecNumElts) {
1469         Constant *MaybeUndef =
1470             ConstOp1 ? ConstantExpr::get(Opcode, UndefScalar, CElt)
1471                      : ConstantExpr::get(Opcode, CElt, UndefScalar);
1472         if (!isa<UndefValue>(MaybeUndef)) {
1473           MayChange = false;
1474           break;
1475         }
1476       }
1477     }
1478     if (MayChange) {
1479       Constant *NewC = ConstantVector::get(NewVecC);
1480       // It may not be safe to execute a binop on a vector with undef elements
1481       // because the entire instruction can be folded to undef or create poison
1482       // that did not exist in the original code.
1483       if (Inst.isIntDivRem() || (Inst.isShift() && ConstOp1))
1484         NewC = getSafeVectorConstantForBinop(Opcode, NewC, ConstOp1);
1485 
1486       // Op(shuffle(V1, Mask), C) -> shuffle(Op(V1, NewC), Mask)
1487       // Op(C, shuffle(V1, Mask)) -> shuffle(Op(NewC, V1), Mask)
1488       Value *NewLHS = ConstOp1 ? V1 : NewC;
1489       Value *NewRHS = ConstOp1 ? NewC : V1;
1490       return createBinOpShuffle(NewLHS, NewRHS, Mask);
1491     }
1492   }
1493 
1494   return nullptr;
1495 }
1496 
1497 /// Try to narrow the width of a binop if at least 1 operand is an extend of
1498 /// of a value. This requires a potentially expensive known bits check to make
1499 /// sure the narrow op does not overflow.
1500 Instruction *InstCombiner::narrowMathIfNoOverflow(BinaryOperator &BO) {
1501   // We need at least one extended operand.
1502   Value *Op0 = BO.getOperand(0), *Op1 = BO.getOperand(1);
1503 
1504   // If this is a sub, we swap the operands since we always want an extension
1505   // on the RHS. The LHS can be an extension or a constant.
1506   if (BO.getOpcode() == Instruction::Sub)
1507     std::swap(Op0, Op1);
1508 
1509   Value *X;
1510   bool IsSext = match(Op0, m_SExt(m_Value(X)));
1511   if (!IsSext && !match(Op0, m_ZExt(m_Value(X))))
1512     return nullptr;
1513 
1514   // If both operands are the same extension from the same source type and we
1515   // can eliminate at least one (hasOneUse), this might work.
1516   CastInst::CastOps CastOpc = IsSext ? Instruction::SExt : Instruction::ZExt;
1517   Value *Y;
1518   if (!(match(Op1, m_ZExtOrSExt(m_Value(Y))) && X->getType() == Y->getType() &&
1519         cast<Operator>(Op1)->getOpcode() == CastOpc &&
1520         (Op0->hasOneUse() || Op1->hasOneUse()))) {
1521     // If that did not match, see if we have a suitable constant operand.
1522     // Truncating and extending must produce the same constant.
1523     Constant *WideC;
1524     if (!Op0->hasOneUse() || !match(Op1, m_Constant(WideC)))
1525       return nullptr;
1526     Constant *NarrowC = ConstantExpr::getTrunc(WideC, X->getType());
1527     if (ConstantExpr::getCast(CastOpc, NarrowC, BO.getType()) != WideC)
1528       return nullptr;
1529     Y = NarrowC;
1530   }
1531 
1532   // Swap back now that we found our operands.
1533   if (BO.getOpcode() == Instruction::Sub)
1534     std::swap(X, Y);
1535 
1536   // Both operands have narrow versions. Last step: the math must not overflow
1537   // in the narrow width.
1538   if (!willNotOverflow(BO.getOpcode(), X, Y, BO, IsSext))
1539     return nullptr;
1540 
1541   // bo (ext X), (ext Y) --> ext (bo X, Y)
1542   // bo (ext X), C       --> ext (bo X, C')
1543   Value *NarrowBO = Builder.CreateBinOp(BO.getOpcode(), X, Y, "narrow");
1544   if (auto *NewBinOp = dyn_cast<BinaryOperator>(NarrowBO)) {
1545     if (IsSext)
1546       NewBinOp->setHasNoSignedWrap();
1547     else
1548       NewBinOp->setHasNoUnsignedWrap();
1549   }
1550   return CastInst::Create(CastOpc, NarrowBO, BO.getType());
1551 }
1552 
1553 Instruction *InstCombiner::visitGetElementPtrInst(GetElementPtrInst &GEP) {
1554   SmallVector<Value*, 8> Ops(GEP.op_begin(), GEP.op_end());
1555   Type *GEPType = GEP.getType();
1556   Type *GEPEltType = GEP.getSourceElementType();
1557   if (Value *V = SimplifyGEPInst(GEPEltType, Ops, SQ.getWithInstruction(&GEP)))
1558     return replaceInstUsesWith(GEP, V);
1559 
1560   // For vector geps, use the generic demanded vector support.
1561   if (GEP.getType()->isVectorTy()) {
1562     auto VWidth = GEP.getType()->getVectorNumElements();
1563     APInt UndefElts(VWidth, 0);
1564     APInt AllOnesEltMask(APInt::getAllOnesValue(VWidth));
1565     if (Value *V = SimplifyDemandedVectorElts(&GEP, AllOnesEltMask,
1566                                               UndefElts)) {
1567       if (V != &GEP)
1568         return replaceInstUsesWith(GEP, V);
1569       return &GEP;
1570     }
1571   }
1572 
1573   Value *PtrOp = GEP.getOperand(0);
1574 
1575   // Eliminate unneeded casts for indices, and replace indices which displace
1576   // by multiples of a zero size type with zero.
1577   bool MadeChange = false;
1578 
1579   // Index width may not be the same width as pointer width.
1580   // Data layout chooses the right type based on supported integer types.
1581   Type *NewScalarIndexTy =
1582       DL.getIndexType(GEP.getPointerOperandType()->getScalarType());
1583 
1584   gep_type_iterator GTI = gep_type_begin(GEP);
1585   for (User::op_iterator I = GEP.op_begin() + 1, E = GEP.op_end(); I != E;
1586        ++I, ++GTI) {
1587     // Skip indices into struct types.
1588     if (GTI.isStruct())
1589       continue;
1590 
1591     Type *IndexTy = (*I)->getType();
1592     Type *NewIndexType =
1593         IndexTy->isVectorTy()
1594             ? VectorType::get(NewScalarIndexTy, IndexTy->getVectorNumElements())
1595             : NewScalarIndexTy;
1596 
1597     // If the element type has zero size then any index over it is equivalent
1598     // to an index of zero, so replace it with zero if it is not zero already.
1599     Type *EltTy = GTI.getIndexedType();
1600     if (EltTy->isSized() && DL.getTypeAllocSize(EltTy) == 0)
1601       if (!isa<Constant>(*I) || !cast<Constant>(*I)->isNullValue()) {
1602         *I = Constant::getNullValue(NewIndexType);
1603         MadeChange = true;
1604       }
1605 
1606     if (IndexTy != NewIndexType) {
1607       // If we are using a wider index than needed for this platform, shrink
1608       // it to what we need.  If narrower, sign-extend it to what we need.
1609       // This explicit cast can make subsequent optimizations more obvious.
1610       *I = Builder.CreateIntCast(*I, NewIndexType, true);
1611       MadeChange = true;
1612     }
1613   }
1614   if (MadeChange)
1615     return &GEP;
1616 
1617   // Check to see if the inputs to the PHI node are getelementptr instructions.
1618   if (auto *PN = dyn_cast<PHINode>(PtrOp)) {
1619     auto *Op1 = dyn_cast<GetElementPtrInst>(PN->getOperand(0));
1620     if (!Op1)
1621       return nullptr;
1622 
1623     // Don't fold a GEP into itself through a PHI node. This can only happen
1624     // through the back-edge of a loop. Folding a GEP into itself means that
1625     // the value of the previous iteration needs to be stored in the meantime,
1626     // thus requiring an additional register variable to be live, but not
1627     // actually achieving anything (the GEP still needs to be executed once per
1628     // loop iteration).
1629     if (Op1 == &GEP)
1630       return nullptr;
1631 
1632     int DI = -1;
1633 
1634     for (auto I = PN->op_begin()+1, E = PN->op_end(); I !=E; ++I) {
1635       auto *Op2 = dyn_cast<GetElementPtrInst>(*I);
1636       if (!Op2 || Op1->getNumOperands() != Op2->getNumOperands())
1637         return nullptr;
1638 
1639       // As for Op1 above, don't try to fold a GEP into itself.
1640       if (Op2 == &GEP)
1641         return nullptr;
1642 
1643       // Keep track of the type as we walk the GEP.
1644       Type *CurTy = nullptr;
1645 
1646       for (unsigned J = 0, F = Op1->getNumOperands(); J != F; ++J) {
1647         if (Op1->getOperand(J)->getType() != Op2->getOperand(J)->getType())
1648           return nullptr;
1649 
1650         if (Op1->getOperand(J) != Op2->getOperand(J)) {
1651           if (DI == -1) {
1652             // We have not seen any differences yet in the GEPs feeding the
1653             // PHI yet, so we record this one if it is allowed to be a
1654             // variable.
1655 
1656             // The first two arguments can vary for any GEP, the rest have to be
1657             // static for struct slots
1658             if (J > 1 && CurTy->isStructTy())
1659               return nullptr;
1660 
1661             DI = J;
1662           } else {
1663             // The GEP is different by more than one input. While this could be
1664             // extended to support GEPs that vary by more than one variable it
1665             // doesn't make sense since it greatly increases the complexity and
1666             // would result in an R+R+R addressing mode which no backend
1667             // directly supports and would need to be broken into several
1668             // simpler instructions anyway.
1669             return nullptr;
1670           }
1671         }
1672 
1673         // Sink down a layer of the type for the next iteration.
1674         if (J > 0) {
1675           if (J == 1) {
1676             CurTy = Op1->getSourceElementType();
1677           } else if (auto *CT = dyn_cast<CompositeType>(CurTy)) {
1678             CurTy = CT->getTypeAtIndex(Op1->getOperand(J));
1679           } else {
1680             CurTy = nullptr;
1681           }
1682         }
1683       }
1684     }
1685 
1686     // If not all GEPs are identical we'll have to create a new PHI node.
1687     // Check that the old PHI node has only one use so that it will get
1688     // removed.
1689     if (DI != -1 && !PN->hasOneUse())
1690       return nullptr;
1691 
1692     auto *NewGEP = cast<GetElementPtrInst>(Op1->clone());
1693     if (DI == -1) {
1694       // All the GEPs feeding the PHI are identical. Clone one down into our
1695       // BB so that it can be merged with the current GEP.
1696       GEP.getParent()->getInstList().insert(
1697           GEP.getParent()->getFirstInsertionPt(), NewGEP);
1698     } else {
1699       // All the GEPs feeding the PHI differ at a single offset. Clone a GEP
1700       // into the current block so it can be merged, and create a new PHI to
1701       // set that index.
1702       PHINode *NewPN;
1703       {
1704         IRBuilderBase::InsertPointGuard Guard(Builder);
1705         Builder.SetInsertPoint(PN);
1706         NewPN = Builder.CreatePHI(Op1->getOperand(DI)->getType(),
1707                                   PN->getNumOperands());
1708       }
1709 
1710       for (auto &I : PN->operands())
1711         NewPN->addIncoming(cast<GEPOperator>(I)->getOperand(DI),
1712                            PN->getIncomingBlock(I));
1713 
1714       NewGEP->setOperand(DI, NewPN);
1715       GEP.getParent()->getInstList().insert(
1716           GEP.getParent()->getFirstInsertionPt(), NewGEP);
1717       NewGEP->setOperand(DI, NewPN);
1718     }
1719 
1720     GEP.setOperand(0, NewGEP);
1721     PtrOp = NewGEP;
1722   }
1723 
1724   // Combine Indices - If the source pointer to this getelementptr instruction
1725   // is a getelementptr instruction, combine the indices of the two
1726   // getelementptr instructions into a single instruction.
1727   if (auto *Src = dyn_cast<GEPOperator>(PtrOp)) {
1728     if (!shouldMergeGEPs(*cast<GEPOperator>(&GEP), *Src))
1729       return nullptr;
1730 
1731     // Try to reassociate loop invariant GEP chains to enable LICM.
1732     if (LI && Src->getNumOperands() == 2 && GEP.getNumOperands() == 2 &&
1733         Src->hasOneUse()) {
1734       if (Loop *L = LI->getLoopFor(GEP.getParent())) {
1735         Value *GO1 = GEP.getOperand(1);
1736         Value *SO1 = Src->getOperand(1);
1737         // Reassociate the two GEPs if SO1 is variant in the loop and GO1 is
1738         // invariant: this breaks the dependence between GEPs and allows LICM
1739         // to hoist the invariant part out of the loop.
1740         if (L->isLoopInvariant(GO1) && !L->isLoopInvariant(SO1)) {
1741           // We have to be careful here.
1742           // We have something like:
1743           //  %src = getelementptr <ty>, <ty>* %base, <ty> %idx
1744           //  %gep = getelementptr <ty>, <ty>* %src, <ty> %idx2
1745           // If we just swap idx & idx2 then we could inadvertantly
1746           // change %src from a vector to a scalar, or vice versa.
1747           // Cases:
1748           //  1) %base a scalar & idx a scalar & idx2 a vector
1749           //      => Swapping idx & idx2 turns %src into a vector type.
1750           //  2) %base a scalar & idx a vector & idx2 a scalar
1751           //      => Swapping idx & idx2 turns %src in a scalar type
1752           //  3) %base, %idx, and %idx2 are scalars
1753           //      => %src & %gep are scalars
1754           //      => swapping idx & idx2 is safe
1755           //  4) %base a vector
1756           //      => %src is a vector
1757           //      => swapping idx & idx2 is safe.
1758           auto *SO0 = Src->getOperand(0);
1759           auto *SO0Ty = SO0->getType();
1760           if (!isa<VectorType>(GEPType) || // case 3
1761               isa<VectorType>(SO0Ty)) {    // case 4
1762             Src->setOperand(1, GO1);
1763             GEP.setOperand(1, SO1);
1764             return &GEP;
1765           } else {
1766             // Case 1 or 2
1767             // -- have to recreate %src & %gep
1768             // put NewSrc at same location as %src
1769             Builder.SetInsertPoint(cast<Instruction>(PtrOp));
1770             auto *NewSrc = cast<GetElementPtrInst>(
1771                 Builder.CreateGEP(GEPEltType, SO0, GO1, Src->getName()));
1772             NewSrc->setIsInBounds(Src->isInBounds());
1773             auto *NewGEP = GetElementPtrInst::Create(GEPEltType, NewSrc, {SO1});
1774             NewGEP->setIsInBounds(GEP.isInBounds());
1775             return NewGEP;
1776           }
1777         }
1778       }
1779     }
1780 
1781     // Note that if our source is a gep chain itself then we wait for that
1782     // chain to be resolved before we perform this transformation.  This
1783     // avoids us creating a TON of code in some cases.
1784     if (auto *SrcGEP = dyn_cast<GEPOperator>(Src->getOperand(0)))
1785       if (SrcGEP->getNumOperands() == 2 && shouldMergeGEPs(*Src, *SrcGEP))
1786         return nullptr;   // Wait until our source is folded to completion.
1787 
1788     SmallVector<Value*, 8> Indices;
1789 
1790     // Find out whether the last index in the source GEP is a sequential idx.
1791     bool EndsWithSequential = false;
1792     for (gep_type_iterator I = gep_type_begin(*Src), E = gep_type_end(*Src);
1793          I != E; ++I)
1794       EndsWithSequential = I.isSequential();
1795 
1796     // Can we combine the two pointer arithmetics offsets?
1797     if (EndsWithSequential) {
1798       // Replace: gep (gep %P, long B), long A, ...
1799       // With:    T = long A+B; gep %P, T, ...
1800       Value *SO1 = Src->getOperand(Src->getNumOperands()-1);
1801       Value *GO1 = GEP.getOperand(1);
1802 
1803       // If they aren't the same type, then the input hasn't been processed
1804       // by the loop above yet (which canonicalizes sequential index types to
1805       // intptr_t).  Just avoid transforming this until the input has been
1806       // normalized.
1807       if (SO1->getType() != GO1->getType())
1808         return nullptr;
1809 
1810       Value *Sum =
1811           SimplifyAddInst(GO1, SO1, false, false, SQ.getWithInstruction(&GEP));
1812       // Only do the combine when we are sure the cost after the
1813       // merge is never more than that before the merge.
1814       if (Sum == nullptr)
1815         return nullptr;
1816 
1817       // Update the GEP in place if possible.
1818       if (Src->getNumOperands() == 2) {
1819         GEP.setOperand(0, Src->getOperand(0));
1820         GEP.setOperand(1, Sum);
1821         return &GEP;
1822       }
1823       Indices.append(Src->op_begin()+1, Src->op_end()-1);
1824       Indices.push_back(Sum);
1825       Indices.append(GEP.op_begin()+2, GEP.op_end());
1826     } else if (isa<Constant>(*GEP.idx_begin()) &&
1827                cast<Constant>(*GEP.idx_begin())->isNullValue() &&
1828                Src->getNumOperands() != 1) {
1829       // Otherwise we can do the fold if the first index of the GEP is a zero
1830       Indices.append(Src->op_begin()+1, Src->op_end());
1831       Indices.append(GEP.idx_begin()+1, GEP.idx_end());
1832     }
1833 
1834     if (!Indices.empty())
1835       return GEP.isInBounds() && Src->isInBounds()
1836                  ? GetElementPtrInst::CreateInBounds(
1837                        Src->getSourceElementType(), Src->getOperand(0), Indices,
1838                        GEP.getName())
1839                  : GetElementPtrInst::Create(Src->getSourceElementType(),
1840                                              Src->getOperand(0), Indices,
1841                                              GEP.getName());
1842   }
1843 
1844   if (GEP.getNumIndices() == 1) {
1845     unsigned AS = GEP.getPointerAddressSpace();
1846     if (GEP.getOperand(1)->getType()->getScalarSizeInBits() ==
1847         DL.getIndexSizeInBits(AS)) {
1848       uint64_t TyAllocSize = DL.getTypeAllocSize(GEPEltType);
1849 
1850       bool Matched = false;
1851       uint64_t C;
1852       Value *V = nullptr;
1853       if (TyAllocSize == 1) {
1854         V = GEP.getOperand(1);
1855         Matched = true;
1856       } else if (match(GEP.getOperand(1),
1857                        m_AShr(m_Value(V), m_ConstantInt(C)))) {
1858         if (TyAllocSize == 1ULL << C)
1859           Matched = true;
1860       } else if (match(GEP.getOperand(1),
1861                        m_SDiv(m_Value(V), m_ConstantInt(C)))) {
1862         if (TyAllocSize == C)
1863           Matched = true;
1864       }
1865 
1866       if (Matched) {
1867         // Canonicalize (gep i8* X, -(ptrtoint Y))
1868         // to (inttoptr (sub (ptrtoint X), (ptrtoint Y)))
1869         // The GEP pattern is emitted by the SCEV expander for certain kinds of
1870         // pointer arithmetic.
1871         if (match(V, m_Neg(m_PtrToInt(m_Value())))) {
1872           Operator *Index = cast<Operator>(V);
1873           Value *PtrToInt = Builder.CreatePtrToInt(PtrOp, Index->getType());
1874           Value *NewSub = Builder.CreateSub(PtrToInt, Index->getOperand(1));
1875           return CastInst::Create(Instruction::IntToPtr, NewSub, GEPType);
1876         }
1877         // Canonicalize (gep i8* X, (ptrtoint Y)-(ptrtoint X))
1878         // to (bitcast Y)
1879         Value *Y;
1880         if (match(V, m_Sub(m_PtrToInt(m_Value(Y)),
1881                            m_PtrToInt(m_Specific(GEP.getOperand(0))))))
1882           return CastInst::CreatePointerBitCastOrAddrSpaceCast(Y, GEPType);
1883       }
1884     }
1885   }
1886 
1887   // We do not handle pointer-vector geps here.
1888   if (GEPType->isVectorTy())
1889     return nullptr;
1890 
1891   // Handle gep(bitcast x) and gep(gep x, 0, 0, 0).
1892   Value *StrippedPtr = PtrOp->stripPointerCasts();
1893   PointerType *StrippedPtrTy = cast<PointerType>(StrippedPtr->getType());
1894 
1895   if (StrippedPtr != PtrOp) {
1896     bool HasZeroPointerIndex = false;
1897     Type *StrippedPtrEltTy = StrippedPtrTy->getElementType();
1898 
1899     if (auto *C = dyn_cast<ConstantInt>(GEP.getOperand(1)))
1900       HasZeroPointerIndex = C->isZero();
1901 
1902     // Transform: GEP (bitcast [10 x i8]* X to [0 x i8]*), i32 0, ...
1903     // into     : GEP [10 x i8]* X, i32 0, ...
1904     //
1905     // Likewise, transform: GEP (bitcast i8* X to [0 x i8]*), i32 0, ...
1906     //           into     : GEP i8* X, ...
1907     //
1908     // This occurs when the program declares an array extern like "int X[];"
1909     if (HasZeroPointerIndex) {
1910       if (auto *CATy = dyn_cast<ArrayType>(GEPEltType)) {
1911         // GEP (bitcast i8* X to [0 x i8]*), i32 0, ... ?
1912         if (CATy->getElementType() == StrippedPtrEltTy) {
1913           // -> GEP i8* X, ...
1914           SmallVector<Value*, 8> Idx(GEP.idx_begin()+1, GEP.idx_end());
1915           GetElementPtrInst *Res = GetElementPtrInst::Create(
1916               StrippedPtrEltTy, StrippedPtr, Idx, GEP.getName());
1917           Res->setIsInBounds(GEP.isInBounds());
1918           if (StrippedPtrTy->getAddressSpace() == GEP.getAddressSpace())
1919             return Res;
1920           // Insert Res, and create an addrspacecast.
1921           // e.g.,
1922           // GEP (addrspacecast i8 addrspace(1)* X to [0 x i8]*), i32 0, ...
1923           // ->
1924           // %0 = GEP i8 addrspace(1)* X, ...
1925           // addrspacecast i8 addrspace(1)* %0 to i8*
1926           return new AddrSpaceCastInst(Builder.Insert(Res), GEPType);
1927         }
1928 
1929         if (auto *XATy = dyn_cast<ArrayType>(StrippedPtrEltTy)) {
1930           // GEP (bitcast [10 x i8]* X to [0 x i8]*), i32 0, ... ?
1931           if (CATy->getElementType() == XATy->getElementType()) {
1932             // -> GEP [10 x i8]* X, i32 0, ...
1933             // At this point, we know that the cast source type is a pointer
1934             // to an array of the same type as the destination pointer
1935             // array.  Because the array type is never stepped over (there
1936             // is a leading zero) we can fold the cast into this GEP.
1937             if (StrippedPtrTy->getAddressSpace() == GEP.getAddressSpace()) {
1938               GEP.setOperand(0, StrippedPtr);
1939               GEP.setSourceElementType(XATy);
1940               return &GEP;
1941             }
1942             // Cannot replace the base pointer directly because StrippedPtr's
1943             // address space is different. Instead, create a new GEP followed by
1944             // an addrspacecast.
1945             // e.g.,
1946             // GEP (addrspacecast [10 x i8] addrspace(1)* X to [0 x i8]*),
1947             //   i32 0, ...
1948             // ->
1949             // %0 = GEP [10 x i8] addrspace(1)* X, ...
1950             // addrspacecast i8 addrspace(1)* %0 to i8*
1951             SmallVector<Value*, 8> Idx(GEP.idx_begin(), GEP.idx_end());
1952             Value *NewGEP =
1953                 GEP.isInBounds()
1954                     ? Builder.CreateInBoundsGEP(StrippedPtrEltTy, StrippedPtr,
1955                                                 Idx, GEP.getName())
1956                     : Builder.CreateGEP(StrippedPtrEltTy, StrippedPtr, Idx,
1957                                         GEP.getName());
1958             return new AddrSpaceCastInst(NewGEP, GEPType);
1959           }
1960         }
1961       }
1962     } else if (GEP.getNumOperands() == 2) {
1963       // Transform things like:
1964       // %t = getelementptr i32* bitcast ([2 x i32]* %str to i32*), i32 %V
1965       // into:  %t1 = getelementptr [2 x i32]* %str, i32 0, i32 %V; bitcast
1966       if (StrippedPtrEltTy->isArrayTy() &&
1967           DL.getTypeAllocSize(StrippedPtrEltTy->getArrayElementType()) ==
1968               DL.getTypeAllocSize(GEPEltType)) {
1969         Type *IdxType = DL.getIndexType(GEPType);
1970         Value *Idx[2] = { Constant::getNullValue(IdxType), GEP.getOperand(1) };
1971         Value *NewGEP =
1972             GEP.isInBounds()
1973                 ? Builder.CreateInBoundsGEP(StrippedPtrEltTy, StrippedPtr, Idx,
1974                                             GEP.getName())
1975                 : Builder.CreateGEP(StrippedPtrEltTy, StrippedPtr, Idx,
1976                                     GEP.getName());
1977 
1978         // V and GEP are both pointer types --> BitCast
1979         return CastInst::CreatePointerBitCastOrAddrSpaceCast(NewGEP, GEPType);
1980       }
1981 
1982       // Transform things like:
1983       // %V = mul i64 %N, 4
1984       // %t = getelementptr i8* bitcast (i32* %arr to i8*), i32 %V
1985       // into:  %t1 = getelementptr i32* %arr, i32 %N; bitcast
1986       if (GEPEltType->isSized() && StrippedPtrEltTy->isSized()) {
1987         // Check that changing the type amounts to dividing the index by a scale
1988         // factor.
1989         uint64_t ResSize = DL.getTypeAllocSize(GEPEltType);
1990         uint64_t SrcSize = DL.getTypeAllocSize(StrippedPtrEltTy);
1991         if (ResSize && SrcSize % ResSize == 0) {
1992           Value *Idx = GEP.getOperand(1);
1993           unsigned BitWidth = Idx->getType()->getPrimitiveSizeInBits();
1994           uint64_t Scale = SrcSize / ResSize;
1995 
1996           // Earlier transforms ensure that the index has the right type
1997           // according to Data Layout, which considerably simplifies the
1998           // logic by eliminating implicit casts.
1999           assert(Idx->getType() == DL.getIndexType(GEPType) &&
2000                  "Index type does not match the Data Layout preferences");
2001 
2002           bool NSW;
2003           if (Value *NewIdx = Descale(Idx, APInt(BitWidth, Scale), NSW)) {
2004             // Successfully decomposed Idx as NewIdx * Scale, form a new GEP.
2005             // If the multiplication NewIdx * Scale may overflow then the new
2006             // GEP may not be "inbounds".
2007             Value *NewGEP =
2008                 GEP.isInBounds() && NSW
2009                     ? Builder.CreateInBoundsGEP(StrippedPtrEltTy, StrippedPtr,
2010                                                 NewIdx, GEP.getName())
2011                     : Builder.CreateGEP(StrippedPtrEltTy, StrippedPtr, NewIdx,
2012                                         GEP.getName());
2013 
2014             // The NewGEP must be pointer typed, so must the old one -> BitCast
2015             return CastInst::CreatePointerBitCastOrAddrSpaceCast(NewGEP,
2016                                                                  GEPType);
2017           }
2018         }
2019       }
2020 
2021       // Similarly, transform things like:
2022       // getelementptr i8* bitcast ([100 x double]* X to i8*), i32 %tmp
2023       //   (where tmp = 8*tmp2) into:
2024       // getelementptr [100 x double]* %arr, i32 0, i32 %tmp2; bitcast
2025       if (GEPEltType->isSized() && StrippedPtrEltTy->isSized() &&
2026           StrippedPtrEltTy->isArrayTy()) {
2027         // Check that changing to the array element type amounts to dividing the
2028         // index by a scale factor.
2029         uint64_t ResSize = DL.getTypeAllocSize(GEPEltType);
2030         uint64_t ArrayEltSize =
2031             DL.getTypeAllocSize(StrippedPtrEltTy->getArrayElementType());
2032         if (ResSize && ArrayEltSize % ResSize == 0) {
2033           Value *Idx = GEP.getOperand(1);
2034           unsigned BitWidth = Idx->getType()->getPrimitiveSizeInBits();
2035           uint64_t Scale = ArrayEltSize / ResSize;
2036 
2037           // Earlier transforms ensure that the index has the right type
2038           // according to the Data Layout, which considerably simplifies
2039           // the logic by eliminating implicit casts.
2040           assert(Idx->getType() == DL.getIndexType(GEPType) &&
2041                  "Index type does not match the Data Layout preferences");
2042 
2043           bool NSW;
2044           if (Value *NewIdx = Descale(Idx, APInt(BitWidth, Scale), NSW)) {
2045             // Successfully decomposed Idx as NewIdx * Scale, form a new GEP.
2046             // If the multiplication NewIdx * Scale may overflow then the new
2047             // GEP may not be "inbounds".
2048             Type *IndTy = DL.getIndexType(GEPType);
2049             Value *Off[2] = {Constant::getNullValue(IndTy), NewIdx};
2050 
2051             Value *NewGEP =
2052                 GEP.isInBounds() && NSW
2053                     ? Builder.CreateInBoundsGEP(StrippedPtrEltTy, StrippedPtr,
2054                                                 Off, GEP.getName())
2055                     : Builder.CreateGEP(StrippedPtrEltTy, StrippedPtr, Off,
2056                                         GEP.getName());
2057             // The NewGEP must be pointer typed, so must the old one -> BitCast
2058             return CastInst::CreatePointerBitCastOrAddrSpaceCast(NewGEP,
2059                                                                  GEPType);
2060           }
2061         }
2062       }
2063     }
2064   }
2065 
2066   // addrspacecast between types is canonicalized as a bitcast, then an
2067   // addrspacecast. To take advantage of the below bitcast + struct GEP, look
2068   // through the addrspacecast.
2069   Value *ASCStrippedPtrOp = PtrOp;
2070   if (auto *ASC = dyn_cast<AddrSpaceCastInst>(PtrOp)) {
2071     //   X = bitcast A addrspace(1)* to B addrspace(1)*
2072     //   Y = addrspacecast A addrspace(1)* to B addrspace(2)*
2073     //   Z = gep Y, <...constant indices...>
2074     // Into an addrspacecasted GEP of the struct.
2075     if (auto *BC = dyn_cast<BitCastInst>(ASC->getOperand(0)))
2076       ASCStrippedPtrOp = BC;
2077   }
2078 
2079   if (auto *BCI = dyn_cast<BitCastInst>(ASCStrippedPtrOp)) {
2080     Value *SrcOp = BCI->getOperand(0);
2081     PointerType *SrcType = cast<PointerType>(BCI->getSrcTy());
2082     Type *SrcEltType = SrcType->getElementType();
2083 
2084     // GEP directly using the source operand if this GEP is accessing an element
2085     // of a bitcasted pointer to vector or array of the same dimensions:
2086     // gep (bitcast <c x ty>* X to [c x ty]*), Y, Z --> gep X, Y, Z
2087     // gep (bitcast [c x ty]* X to <c x ty>*), Y, Z --> gep X, Y, Z
2088     auto areMatchingArrayAndVecTypes = [](Type *ArrTy, Type *VecTy) {
2089       return ArrTy->getArrayElementType() == VecTy->getVectorElementType() &&
2090              ArrTy->getArrayNumElements() == VecTy->getVectorNumElements();
2091     };
2092     if (GEP.getNumOperands() == 3 &&
2093         ((GEPEltType->isArrayTy() && SrcEltType->isVectorTy() &&
2094           areMatchingArrayAndVecTypes(GEPEltType, SrcEltType)) ||
2095          (GEPEltType->isVectorTy() && SrcEltType->isArrayTy() &&
2096           areMatchingArrayAndVecTypes(SrcEltType, GEPEltType)))) {
2097 
2098       // Create a new GEP here, as using `setOperand()` followed by
2099       // `setSourceElementType()` won't actually update the type of the
2100       // existing GEP Value. Causing issues if this Value is accessed when
2101       // constructing an AddrSpaceCastInst
2102       Value *NGEP =
2103           GEP.isInBounds()
2104               ? Builder.CreateInBoundsGEP(SrcEltType, SrcOp, {Ops[1], Ops[2]})
2105               : Builder.CreateGEP(SrcEltType, SrcOp, {Ops[1], Ops[2]});
2106       NGEP->takeName(&GEP);
2107 
2108       // Preserve GEP address space to satisfy users
2109       if (NGEP->getType()->getPointerAddressSpace() != GEP.getAddressSpace())
2110         return new AddrSpaceCastInst(NGEP, GEPType);
2111 
2112       return replaceInstUsesWith(GEP, NGEP);
2113     }
2114 
2115     // See if we can simplify:
2116     //   X = bitcast A* to B*
2117     //   Y = gep X, <...constant indices...>
2118     // into a gep of the original struct. This is important for SROA and alias
2119     // analysis of unions. If "A" is also a bitcast, wait for A/X to be merged.
2120     unsigned OffsetBits = DL.getIndexTypeSizeInBits(GEPType);
2121     APInt Offset(OffsetBits, 0);
2122     if (!isa<BitCastInst>(SrcOp) && GEP.accumulateConstantOffset(DL, Offset)) {
2123       // If this GEP instruction doesn't move the pointer, just replace the GEP
2124       // with a bitcast of the real input to the dest type.
2125       if (!Offset) {
2126         // If the bitcast is of an allocation, and the allocation will be
2127         // converted to match the type of the cast, don't touch this.
2128         if (isa<AllocaInst>(SrcOp) || isAllocationFn(SrcOp, &TLI)) {
2129           // See if the bitcast simplifies, if so, don't nuke this GEP yet.
2130           if (Instruction *I = visitBitCast(*BCI)) {
2131             if (I != BCI) {
2132               I->takeName(BCI);
2133               BCI->getParent()->getInstList().insert(BCI->getIterator(), I);
2134               replaceInstUsesWith(*BCI, I);
2135             }
2136             return &GEP;
2137           }
2138         }
2139 
2140         if (SrcType->getPointerAddressSpace() != GEP.getAddressSpace())
2141           return new AddrSpaceCastInst(SrcOp, GEPType);
2142         return new BitCastInst(SrcOp, GEPType);
2143       }
2144 
2145       // Otherwise, if the offset is non-zero, we need to find out if there is a
2146       // field at Offset in 'A's type.  If so, we can pull the cast through the
2147       // GEP.
2148       SmallVector<Value*, 8> NewIndices;
2149       if (FindElementAtOffset(SrcType, Offset.getSExtValue(), NewIndices)) {
2150         Value *NGEP =
2151             GEP.isInBounds()
2152                 ? Builder.CreateInBoundsGEP(SrcEltType, SrcOp, NewIndices)
2153                 : Builder.CreateGEP(SrcEltType, SrcOp, NewIndices);
2154 
2155         if (NGEP->getType() == GEPType)
2156           return replaceInstUsesWith(GEP, NGEP);
2157         NGEP->takeName(&GEP);
2158 
2159         if (NGEP->getType()->getPointerAddressSpace() != GEP.getAddressSpace())
2160           return new AddrSpaceCastInst(NGEP, GEPType);
2161         return new BitCastInst(NGEP, GEPType);
2162       }
2163     }
2164   }
2165 
2166   if (!GEP.isInBounds()) {
2167     unsigned IdxWidth =
2168         DL.getIndexSizeInBits(PtrOp->getType()->getPointerAddressSpace());
2169     APInt BasePtrOffset(IdxWidth, 0);
2170     Value *UnderlyingPtrOp =
2171             PtrOp->stripAndAccumulateInBoundsConstantOffsets(DL,
2172                                                              BasePtrOffset);
2173     if (auto *AI = dyn_cast<AllocaInst>(UnderlyingPtrOp)) {
2174       if (GEP.accumulateConstantOffset(DL, BasePtrOffset) &&
2175           BasePtrOffset.isNonNegative()) {
2176         APInt AllocSize(IdxWidth, DL.getTypeAllocSize(AI->getAllocatedType()));
2177         if (BasePtrOffset.ule(AllocSize)) {
2178           return GetElementPtrInst::CreateInBounds(
2179               GEP.getSourceElementType(), PtrOp, makeArrayRef(Ops).slice(1),
2180               GEP.getName());
2181         }
2182       }
2183     }
2184   }
2185 
2186   return nullptr;
2187 }
2188 
2189 static bool isNeverEqualToUnescapedAlloc(Value *V, const TargetLibraryInfo *TLI,
2190                                          Instruction *AI) {
2191   if (isa<ConstantPointerNull>(V))
2192     return true;
2193   if (auto *LI = dyn_cast<LoadInst>(V))
2194     return isa<GlobalVariable>(LI->getPointerOperand());
2195   // Two distinct allocations will never be equal.
2196   // We rely on LookThroughBitCast in isAllocLikeFn being false, since looking
2197   // through bitcasts of V can cause
2198   // the result statement below to be true, even when AI and V (ex:
2199   // i8* ->i32* ->i8* of AI) are the same allocations.
2200   return isAllocLikeFn(V, TLI) && V != AI;
2201 }
2202 
2203 static bool isAllocSiteRemovable(Instruction *AI,
2204                                  SmallVectorImpl<WeakTrackingVH> &Users,
2205                                  const TargetLibraryInfo *TLI) {
2206   SmallVector<Instruction*, 4> Worklist;
2207   Worklist.push_back(AI);
2208 
2209   do {
2210     Instruction *PI = Worklist.pop_back_val();
2211     for (User *U : PI->users()) {
2212       Instruction *I = cast<Instruction>(U);
2213       switch (I->getOpcode()) {
2214       default:
2215         // Give up the moment we see something we can't handle.
2216         return false;
2217 
2218       case Instruction::AddrSpaceCast:
2219       case Instruction::BitCast:
2220       case Instruction::GetElementPtr:
2221         Users.emplace_back(I);
2222         Worklist.push_back(I);
2223         continue;
2224 
2225       case Instruction::ICmp: {
2226         ICmpInst *ICI = cast<ICmpInst>(I);
2227         // We can fold eq/ne comparisons with null to false/true, respectively.
2228         // We also fold comparisons in some conditions provided the alloc has
2229         // not escaped (see isNeverEqualToUnescapedAlloc).
2230         if (!ICI->isEquality())
2231           return false;
2232         unsigned OtherIndex = (ICI->getOperand(0) == PI) ? 1 : 0;
2233         if (!isNeverEqualToUnescapedAlloc(ICI->getOperand(OtherIndex), TLI, AI))
2234           return false;
2235         Users.emplace_back(I);
2236         continue;
2237       }
2238 
2239       case Instruction::Call:
2240         // Ignore no-op and store intrinsics.
2241         if (IntrinsicInst *II = dyn_cast<IntrinsicInst>(I)) {
2242           switch (II->getIntrinsicID()) {
2243           default:
2244             return false;
2245 
2246           case Intrinsic::memmove:
2247           case Intrinsic::memcpy:
2248           case Intrinsic::memset: {
2249             MemIntrinsic *MI = cast<MemIntrinsic>(II);
2250             if (MI->isVolatile() || MI->getRawDest() != PI)
2251               return false;
2252             LLVM_FALLTHROUGH;
2253           }
2254           case Intrinsic::invariant_start:
2255           case Intrinsic::invariant_end:
2256           case Intrinsic::lifetime_start:
2257           case Intrinsic::lifetime_end:
2258           case Intrinsic::objectsize:
2259             Users.emplace_back(I);
2260             continue;
2261           }
2262         }
2263 
2264         if (isFreeCall(I, TLI)) {
2265           Users.emplace_back(I);
2266           continue;
2267         }
2268         return false;
2269 
2270       case Instruction::Store: {
2271         StoreInst *SI = cast<StoreInst>(I);
2272         if (SI->isVolatile() || SI->getPointerOperand() != PI)
2273           return false;
2274         Users.emplace_back(I);
2275         continue;
2276       }
2277       }
2278       llvm_unreachable("missing a return?");
2279     }
2280   } while (!Worklist.empty());
2281   return true;
2282 }
2283 
2284 Instruction *InstCombiner::visitAllocSite(Instruction &MI) {
2285   // If we have a malloc call which is only used in any amount of comparisons to
2286   // null and free calls, delete the calls and replace the comparisons with true
2287   // or false as appropriate.
2288 
2289   // This is based on the principle that we can substitute our own allocation
2290   // function (which will never return null) rather than knowledge of the
2291   // specific function being called. In some sense this can change the permitted
2292   // outputs of a program (when we convert a malloc to an alloca, the fact that
2293   // the allocation is now on the stack is potentially visible, for example),
2294   // but we believe in a permissible manner.
2295   SmallVector<WeakTrackingVH, 64> Users;
2296 
2297   // If we are removing an alloca with a dbg.declare, insert dbg.value calls
2298   // before each store.
2299   TinyPtrVector<DbgVariableIntrinsic *> DIIs;
2300   std::unique_ptr<DIBuilder> DIB;
2301   if (isa<AllocaInst>(MI)) {
2302     DIIs = FindDbgAddrUses(&MI);
2303     DIB.reset(new DIBuilder(*MI.getModule(), /*AllowUnresolved=*/false));
2304   }
2305 
2306   if (isAllocSiteRemovable(&MI, Users, &TLI)) {
2307     for (unsigned i = 0, e = Users.size(); i != e; ++i) {
2308       // Lowering all @llvm.objectsize calls first because they may
2309       // use a bitcast/GEP of the alloca we are removing.
2310       if (!Users[i])
2311        continue;
2312 
2313       Instruction *I = cast<Instruction>(&*Users[i]);
2314 
2315       if (IntrinsicInst *II = dyn_cast<IntrinsicInst>(I)) {
2316         if (II->getIntrinsicID() == Intrinsic::objectsize) {
2317           Value *Result =
2318               lowerObjectSizeCall(II, DL, &TLI, /*MustSucceed=*/true);
2319           replaceInstUsesWith(*I, Result);
2320           eraseInstFromFunction(*I);
2321           Users[i] = nullptr; // Skip examining in the next loop.
2322         }
2323       }
2324     }
2325     for (unsigned i = 0, e = Users.size(); i != e; ++i) {
2326       if (!Users[i])
2327         continue;
2328 
2329       Instruction *I = cast<Instruction>(&*Users[i]);
2330 
2331       if (ICmpInst *C = dyn_cast<ICmpInst>(I)) {
2332         replaceInstUsesWith(*C,
2333                             ConstantInt::get(Type::getInt1Ty(C->getContext()),
2334                                              C->isFalseWhenEqual()));
2335       } else if (isa<BitCastInst>(I) || isa<GetElementPtrInst>(I) ||
2336                  isa<AddrSpaceCastInst>(I)) {
2337         replaceInstUsesWith(*I, UndefValue::get(I->getType()));
2338       } else if (auto *SI = dyn_cast<StoreInst>(I)) {
2339         for (auto *DII : DIIs)
2340           ConvertDebugDeclareToDebugValue(DII, SI, *DIB);
2341       }
2342       eraseInstFromFunction(*I);
2343     }
2344 
2345     if (InvokeInst *II = dyn_cast<InvokeInst>(&MI)) {
2346       // Replace invoke with a NOP intrinsic to maintain the original CFG
2347       Module *M = II->getModule();
2348       Function *F = Intrinsic::getDeclaration(M, Intrinsic::donothing);
2349       InvokeInst::Create(F, II->getNormalDest(), II->getUnwindDest(),
2350                          None, "", II->getParent());
2351     }
2352 
2353     for (auto *DII : DIIs)
2354       eraseInstFromFunction(*DII);
2355 
2356     return eraseInstFromFunction(MI);
2357   }
2358   return nullptr;
2359 }
2360 
2361 /// Move the call to free before a NULL test.
2362 ///
2363 /// Check if this free is accessed after its argument has been test
2364 /// against NULL (property 0).
2365 /// If yes, it is legal to move this call in its predecessor block.
2366 ///
2367 /// The move is performed only if the block containing the call to free
2368 /// will be removed, i.e.:
2369 /// 1. it has only one predecessor P, and P has two successors
2370 /// 2. it contains the call, noops, and an unconditional branch
2371 /// 3. its successor is the same as its predecessor's successor
2372 ///
2373 /// The profitability is out-of concern here and this function should
2374 /// be called only if the caller knows this transformation would be
2375 /// profitable (e.g., for code size).
2376 static Instruction *tryToMoveFreeBeforeNullTest(CallInst &FI,
2377                                                 const DataLayout &DL) {
2378   Value *Op = FI.getArgOperand(0);
2379   BasicBlock *FreeInstrBB = FI.getParent();
2380   BasicBlock *PredBB = FreeInstrBB->getSinglePredecessor();
2381 
2382   // Validate part of constraint #1: Only one predecessor
2383   // FIXME: We can extend the number of predecessor, but in that case, we
2384   //        would duplicate the call to free in each predecessor and it may
2385   //        not be profitable even for code size.
2386   if (!PredBB)
2387     return nullptr;
2388 
2389   // Validate constraint #2: Does this block contains only the call to
2390   //                         free, noops, and an unconditional branch?
2391   BasicBlock *SuccBB;
2392   Instruction *FreeInstrBBTerminator = FreeInstrBB->getTerminator();
2393   if (!match(FreeInstrBBTerminator, m_UnconditionalBr(SuccBB)))
2394     return nullptr;
2395 
2396   // If there are only 2 instructions in the block, at this point,
2397   // this is the call to free and unconditional.
2398   // If there are more than 2 instructions, check that they are noops
2399   // i.e., they won't hurt the performance of the generated code.
2400   if (FreeInstrBB->size() != 2) {
2401     for (const Instruction &Inst : *FreeInstrBB) {
2402       if (&Inst == &FI || &Inst == FreeInstrBBTerminator)
2403         continue;
2404       auto *Cast = dyn_cast<CastInst>(&Inst);
2405       if (!Cast || !Cast->isNoopCast(DL))
2406         return nullptr;
2407     }
2408   }
2409   // Validate the rest of constraint #1 by matching on the pred branch.
2410   Instruction *TI = PredBB->getTerminator();
2411   BasicBlock *TrueBB, *FalseBB;
2412   ICmpInst::Predicate Pred;
2413   if (!match(TI, m_Br(m_ICmp(Pred,
2414                              m_CombineOr(m_Specific(Op),
2415                                          m_Specific(Op->stripPointerCasts())),
2416                              m_Zero()),
2417                       TrueBB, FalseBB)))
2418     return nullptr;
2419   if (Pred != ICmpInst::ICMP_EQ && Pred != ICmpInst::ICMP_NE)
2420     return nullptr;
2421 
2422   // Validate constraint #3: Ensure the null case just falls through.
2423   if (SuccBB != (Pred == ICmpInst::ICMP_EQ ? TrueBB : FalseBB))
2424     return nullptr;
2425   assert(FreeInstrBB == (Pred == ICmpInst::ICMP_EQ ? FalseBB : TrueBB) &&
2426          "Broken CFG: missing edge from predecessor to successor");
2427 
2428   // At this point, we know that everything in FreeInstrBB can be moved
2429   // before TI.
2430   for (BasicBlock::iterator It = FreeInstrBB->begin(), End = FreeInstrBB->end();
2431        It != End;) {
2432     Instruction &Instr = *It++;
2433     if (&Instr == FreeInstrBBTerminator)
2434       break;
2435     Instr.moveBefore(TI);
2436   }
2437   assert(FreeInstrBB->size() == 1 &&
2438          "Only the branch instruction should remain");
2439   return &FI;
2440 }
2441 
2442 Instruction *InstCombiner::visitFree(CallInst &FI) {
2443   Value *Op = FI.getArgOperand(0);
2444 
2445   // free undef -> unreachable.
2446   if (isa<UndefValue>(Op)) {
2447     // Insert a new store to null because we cannot modify the CFG here.
2448     Builder.CreateStore(ConstantInt::getTrue(FI.getContext()),
2449                         UndefValue::get(Type::getInt1PtrTy(FI.getContext())));
2450     return eraseInstFromFunction(FI);
2451   }
2452 
2453   // If we have 'free null' delete the instruction.  This can happen in stl code
2454   // when lots of inlining happens.
2455   if (isa<ConstantPointerNull>(Op))
2456     return eraseInstFromFunction(FI);
2457 
2458   // If we optimize for code size, try to move the call to free before the null
2459   // test so that simplify cfg can remove the empty block and dead code
2460   // elimination the branch. I.e., helps to turn something like:
2461   // if (foo) free(foo);
2462   // into
2463   // free(foo);
2464   if (MinimizeSize)
2465     if (Instruction *I = tryToMoveFreeBeforeNullTest(FI, DL))
2466       return I;
2467 
2468   return nullptr;
2469 }
2470 
2471 Instruction *InstCombiner::visitReturnInst(ReturnInst &RI) {
2472   if (RI.getNumOperands() == 0) // ret void
2473     return nullptr;
2474 
2475   Value *ResultOp = RI.getOperand(0);
2476   Type *VTy = ResultOp->getType();
2477   if (!VTy->isIntegerTy())
2478     return nullptr;
2479 
2480   // There might be assume intrinsics dominating this return that completely
2481   // determine the value. If so, constant fold it.
2482   KnownBits Known = computeKnownBits(ResultOp, 0, &RI);
2483   if (Known.isConstant())
2484     RI.setOperand(0, Constant::getIntegerValue(VTy, Known.getConstant()));
2485 
2486   return nullptr;
2487 }
2488 
2489 Instruction *InstCombiner::visitBranchInst(BranchInst &BI) {
2490   // Change br (not X), label True, label False to: br X, label False, True
2491   Value *X = nullptr;
2492   BasicBlock *TrueDest;
2493   BasicBlock *FalseDest;
2494   if (match(&BI, m_Br(m_Not(m_Value(X)), TrueDest, FalseDest)) &&
2495       !isa<Constant>(X)) {
2496     // Swap Destinations and condition...
2497     BI.setCondition(X);
2498     BI.swapSuccessors();
2499     return &BI;
2500   }
2501 
2502   // If the condition is irrelevant, remove the use so that other
2503   // transforms on the condition become more effective.
2504   if (BI.isConditional() && !isa<ConstantInt>(BI.getCondition()) &&
2505       BI.getSuccessor(0) == BI.getSuccessor(1)) {
2506     BI.setCondition(ConstantInt::getFalse(BI.getCondition()->getType()));
2507     return &BI;
2508   }
2509 
2510   // Canonicalize, for example, icmp_ne -> icmp_eq or fcmp_one -> fcmp_oeq.
2511   CmpInst::Predicate Pred;
2512   if (match(&BI, m_Br(m_OneUse(m_Cmp(Pred, m_Value(), m_Value())), TrueDest,
2513                       FalseDest)) &&
2514       !isCanonicalPredicate(Pred)) {
2515     // Swap destinations and condition.
2516     CmpInst *Cond = cast<CmpInst>(BI.getCondition());
2517     Cond->setPredicate(CmpInst::getInversePredicate(Pred));
2518     BI.swapSuccessors();
2519     Worklist.Add(Cond);
2520     return &BI;
2521   }
2522 
2523   return nullptr;
2524 }
2525 
2526 Instruction *InstCombiner::visitSwitchInst(SwitchInst &SI) {
2527   Value *Cond = SI.getCondition();
2528   Value *Op0;
2529   ConstantInt *AddRHS;
2530   if (match(Cond, m_Add(m_Value(Op0), m_ConstantInt(AddRHS)))) {
2531     // Change 'switch (X+4) case 1:' into 'switch (X) case -3'.
2532     for (auto Case : SI.cases()) {
2533       Constant *NewCase = ConstantExpr::getSub(Case.getCaseValue(), AddRHS);
2534       assert(isa<ConstantInt>(NewCase) &&
2535              "Result of expression should be constant");
2536       Case.setValue(cast<ConstantInt>(NewCase));
2537     }
2538     SI.setCondition(Op0);
2539     return &SI;
2540   }
2541 
2542   KnownBits Known = computeKnownBits(Cond, 0, &SI);
2543   unsigned LeadingKnownZeros = Known.countMinLeadingZeros();
2544   unsigned LeadingKnownOnes = Known.countMinLeadingOnes();
2545 
2546   // Compute the number of leading bits we can ignore.
2547   // TODO: A better way to determine this would use ComputeNumSignBits().
2548   for (auto &C : SI.cases()) {
2549     LeadingKnownZeros = std::min(
2550         LeadingKnownZeros, C.getCaseValue()->getValue().countLeadingZeros());
2551     LeadingKnownOnes = std::min(
2552         LeadingKnownOnes, C.getCaseValue()->getValue().countLeadingOnes());
2553   }
2554 
2555   unsigned NewWidth = Known.getBitWidth() - std::max(LeadingKnownZeros, LeadingKnownOnes);
2556 
2557   // Shrink the condition operand if the new type is smaller than the old type.
2558   // But do not shrink to a non-standard type, because backend can't generate
2559   // good code for that yet.
2560   // TODO: We can make it aggressive again after fixing PR39569.
2561   if (NewWidth > 0 && NewWidth < Known.getBitWidth() &&
2562       shouldChangeType(Known.getBitWidth(), NewWidth)) {
2563     IntegerType *Ty = IntegerType::get(SI.getContext(), NewWidth);
2564     Builder.SetInsertPoint(&SI);
2565     Value *NewCond = Builder.CreateTrunc(Cond, Ty, "trunc");
2566     SI.setCondition(NewCond);
2567 
2568     for (auto Case : SI.cases()) {
2569       APInt TruncatedCase = Case.getCaseValue()->getValue().trunc(NewWidth);
2570       Case.setValue(ConstantInt::get(SI.getContext(), TruncatedCase));
2571     }
2572     return &SI;
2573   }
2574 
2575   return nullptr;
2576 }
2577 
2578 Instruction *InstCombiner::visitExtractValueInst(ExtractValueInst &EV) {
2579   Value *Agg = EV.getAggregateOperand();
2580 
2581   if (!EV.hasIndices())
2582     return replaceInstUsesWith(EV, Agg);
2583 
2584   if (Value *V = SimplifyExtractValueInst(Agg, EV.getIndices(),
2585                                           SQ.getWithInstruction(&EV)))
2586     return replaceInstUsesWith(EV, V);
2587 
2588   if (InsertValueInst *IV = dyn_cast<InsertValueInst>(Agg)) {
2589     // We're extracting from an insertvalue instruction, compare the indices
2590     const unsigned *exti, *exte, *insi, *inse;
2591     for (exti = EV.idx_begin(), insi = IV->idx_begin(),
2592          exte = EV.idx_end(), inse = IV->idx_end();
2593          exti != exte && insi != inse;
2594          ++exti, ++insi) {
2595       if (*insi != *exti)
2596         // The insert and extract both reference distinctly different elements.
2597         // This means the extract is not influenced by the insert, and we can
2598         // replace the aggregate operand of the extract with the aggregate
2599         // operand of the insert. i.e., replace
2600         // %I = insertvalue { i32, { i32 } } %A, { i32 } { i32 42 }, 1
2601         // %E = extractvalue { i32, { i32 } } %I, 0
2602         // with
2603         // %E = extractvalue { i32, { i32 } } %A, 0
2604         return ExtractValueInst::Create(IV->getAggregateOperand(),
2605                                         EV.getIndices());
2606     }
2607     if (exti == exte && insi == inse)
2608       // Both iterators are at the end: Index lists are identical. Replace
2609       // %B = insertvalue { i32, { i32 } } %A, i32 42, 1, 0
2610       // %C = extractvalue { i32, { i32 } } %B, 1, 0
2611       // with "i32 42"
2612       return replaceInstUsesWith(EV, IV->getInsertedValueOperand());
2613     if (exti == exte) {
2614       // The extract list is a prefix of the insert list. i.e. replace
2615       // %I = insertvalue { i32, { i32 } } %A, i32 42, 1, 0
2616       // %E = extractvalue { i32, { i32 } } %I, 1
2617       // with
2618       // %X = extractvalue { i32, { i32 } } %A, 1
2619       // %E = insertvalue { i32 } %X, i32 42, 0
2620       // by switching the order of the insert and extract (though the
2621       // insertvalue should be left in, since it may have other uses).
2622       Value *NewEV = Builder.CreateExtractValue(IV->getAggregateOperand(),
2623                                                 EV.getIndices());
2624       return InsertValueInst::Create(NewEV, IV->getInsertedValueOperand(),
2625                                      makeArrayRef(insi, inse));
2626     }
2627     if (insi == inse)
2628       // The insert list is a prefix of the extract list
2629       // We can simply remove the common indices from the extract and make it
2630       // operate on the inserted value instead of the insertvalue result.
2631       // i.e., replace
2632       // %I = insertvalue { i32, { i32 } } %A, { i32 } { i32 42 }, 1
2633       // %E = extractvalue { i32, { i32 } } %I, 1, 0
2634       // with
2635       // %E extractvalue { i32 } { i32 42 }, 0
2636       return ExtractValueInst::Create(IV->getInsertedValueOperand(),
2637                                       makeArrayRef(exti, exte));
2638   }
2639   if (IntrinsicInst *II = dyn_cast<IntrinsicInst>(Agg)) {
2640     // We're extracting from an intrinsic, see if we're the only user, which
2641     // allows us to simplify multiple result intrinsics to simpler things that
2642     // just get one value.
2643     if (II->hasOneUse()) {
2644       // Check if we're grabbing the overflow bit or the result of a 'with
2645       // overflow' intrinsic.  If it's the latter we can remove the intrinsic
2646       // and replace it with a traditional binary instruction.
2647       switch (II->getIntrinsicID()) {
2648       case Intrinsic::uadd_with_overflow:
2649       case Intrinsic::sadd_with_overflow:
2650         if (*EV.idx_begin() == 0) {  // Normal result.
2651           Value *LHS = II->getArgOperand(0), *RHS = II->getArgOperand(1);
2652           replaceInstUsesWith(*II, UndefValue::get(II->getType()));
2653           eraseInstFromFunction(*II);
2654           return BinaryOperator::CreateAdd(LHS, RHS);
2655         }
2656 
2657         // If the normal result of the add is dead, and the RHS is a constant,
2658         // we can transform this into a range comparison.
2659         // overflow = uadd a, -4  -->  overflow = icmp ugt a, 3
2660         if (II->getIntrinsicID() == Intrinsic::uadd_with_overflow)
2661           if (ConstantInt *CI = dyn_cast<ConstantInt>(II->getArgOperand(1)))
2662             return new ICmpInst(ICmpInst::ICMP_UGT, II->getArgOperand(0),
2663                                 ConstantExpr::getNot(CI));
2664         break;
2665       case Intrinsic::usub_with_overflow:
2666       case Intrinsic::ssub_with_overflow:
2667         if (*EV.idx_begin() == 0) {  // Normal result.
2668           Value *LHS = II->getArgOperand(0), *RHS = II->getArgOperand(1);
2669           replaceInstUsesWith(*II, UndefValue::get(II->getType()));
2670           eraseInstFromFunction(*II);
2671           return BinaryOperator::CreateSub(LHS, RHS);
2672         }
2673         break;
2674       case Intrinsic::umul_with_overflow:
2675       case Intrinsic::smul_with_overflow:
2676         if (*EV.idx_begin() == 0) {  // Normal result.
2677           Value *LHS = II->getArgOperand(0), *RHS = II->getArgOperand(1);
2678           replaceInstUsesWith(*II, UndefValue::get(II->getType()));
2679           eraseInstFromFunction(*II);
2680           return BinaryOperator::CreateMul(LHS, RHS);
2681         }
2682         break;
2683       default:
2684         break;
2685       }
2686     }
2687   }
2688   if (LoadInst *L = dyn_cast<LoadInst>(Agg))
2689     // If the (non-volatile) load only has one use, we can rewrite this to a
2690     // load from a GEP. This reduces the size of the load. If a load is used
2691     // only by extractvalue instructions then this either must have been
2692     // optimized before, or it is a struct with padding, in which case we
2693     // don't want to do the transformation as it loses padding knowledge.
2694     if (L->isSimple() && L->hasOneUse()) {
2695       // extractvalue has integer indices, getelementptr has Value*s. Convert.
2696       SmallVector<Value*, 4> Indices;
2697       // Prefix an i32 0 since we need the first element.
2698       Indices.push_back(Builder.getInt32(0));
2699       for (ExtractValueInst::idx_iterator I = EV.idx_begin(), E = EV.idx_end();
2700             I != E; ++I)
2701         Indices.push_back(Builder.getInt32(*I));
2702 
2703       // We need to insert these at the location of the old load, not at that of
2704       // the extractvalue.
2705       Builder.SetInsertPoint(L);
2706       Value *GEP = Builder.CreateInBoundsGEP(L->getType(),
2707                                              L->getPointerOperand(), Indices);
2708       Instruction *NL = Builder.CreateLoad(EV.getType(), GEP);
2709       // Whatever aliasing information we had for the orignal load must also
2710       // hold for the smaller load, so propagate the annotations.
2711       AAMDNodes Nodes;
2712       L->getAAMetadata(Nodes);
2713       NL->setAAMetadata(Nodes);
2714       // Returning the load directly will cause the main loop to insert it in
2715       // the wrong spot, so use replaceInstUsesWith().
2716       return replaceInstUsesWith(EV, NL);
2717     }
2718   // We could simplify extracts from other values. Note that nested extracts may
2719   // already be simplified implicitly by the above: extract (extract (insert) )
2720   // will be translated into extract ( insert ( extract ) ) first and then just
2721   // the value inserted, if appropriate. Similarly for extracts from single-use
2722   // loads: extract (extract (load)) will be translated to extract (load (gep))
2723   // and if again single-use then via load (gep (gep)) to load (gep).
2724   // However, double extracts from e.g. function arguments or return values
2725   // aren't handled yet.
2726   return nullptr;
2727 }
2728 
2729 /// Return 'true' if the given typeinfo will match anything.
2730 static bool isCatchAll(EHPersonality Personality, Constant *TypeInfo) {
2731   switch (Personality) {
2732   case EHPersonality::GNU_C:
2733   case EHPersonality::GNU_C_SjLj:
2734   case EHPersonality::Rust:
2735     // The GCC C EH and Rust personality only exists to support cleanups, so
2736     // it's not clear what the semantics of catch clauses are.
2737     return false;
2738   case EHPersonality::Unknown:
2739     return false;
2740   case EHPersonality::GNU_Ada:
2741     // While __gnat_all_others_value will match any Ada exception, it doesn't
2742     // match foreign exceptions (or didn't, before gcc-4.7).
2743     return false;
2744   case EHPersonality::GNU_CXX:
2745   case EHPersonality::GNU_CXX_SjLj:
2746   case EHPersonality::GNU_ObjC:
2747   case EHPersonality::MSVC_X86SEH:
2748   case EHPersonality::MSVC_Win64SEH:
2749   case EHPersonality::MSVC_CXX:
2750   case EHPersonality::CoreCLR:
2751   case EHPersonality::Wasm_CXX:
2752     return TypeInfo->isNullValue();
2753   }
2754   llvm_unreachable("invalid enum");
2755 }
2756 
2757 static bool shorter_filter(const Value *LHS, const Value *RHS) {
2758   return
2759     cast<ArrayType>(LHS->getType())->getNumElements()
2760   <
2761     cast<ArrayType>(RHS->getType())->getNumElements();
2762 }
2763 
2764 Instruction *InstCombiner::visitLandingPadInst(LandingPadInst &LI) {
2765   // The logic here should be correct for any real-world personality function.
2766   // However if that turns out not to be true, the offending logic can always
2767   // be conditioned on the personality function, like the catch-all logic is.
2768   EHPersonality Personality =
2769       classifyEHPersonality(LI.getParent()->getParent()->getPersonalityFn());
2770 
2771   // Simplify the list of clauses, eg by removing repeated catch clauses
2772   // (these are often created by inlining).
2773   bool MakeNewInstruction = false; // If true, recreate using the following:
2774   SmallVector<Constant *, 16> NewClauses; // - Clauses for the new instruction;
2775   bool CleanupFlag = LI.isCleanup();   // - The new instruction is a cleanup.
2776 
2777   SmallPtrSet<Value *, 16> AlreadyCaught; // Typeinfos known caught already.
2778   for (unsigned i = 0, e = LI.getNumClauses(); i != e; ++i) {
2779     bool isLastClause = i + 1 == e;
2780     if (LI.isCatch(i)) {
2781       // A catch clause.
2782       Constant *CatchClause = LI.getClause(i);
2783       Constant *TypeInfo = CatchClause->stripPointerCasts();
2784 
2785       // If we already saw this clause, there is no point in having a second
2786       // copy of it.
2787       if (AlreadyCaught.insert(TypeInfo).second) {
2788         // This catch clause was not already seen.
2789         NewClauses.push_back(CatchClause);
2790       } else {
2791         // Repeated catch clause - drop the redundant copy.
2792         MakeNewInstruction = true;
2793       }
2794 
2795       // If this is a catch-all then there is no point in keeping any following
2796       // clauses or marking the landingpad as having a cleanup.
2797       if (isCatchAll(Personality, TypeInfo)) {
2798         if (!isLastClause)
2799           MakeNewInstruction = true;
2800         CleanupFlag = false;
2801         break;
2802       }
2803     } else {
2804       // A filter clause.  If any of the filter elements were already caught
2805       // then they can be dropped from the filter.  It is tempting to try to
2806       // exploit the filter further by saying that any typeinfo that does not
2807       // occur in the filter can't be caught later (and thus can be dropped).
2808       // However this would be wrong, since typeinfos can match without being
2809       // equal (for example if one represents a C++ class, and the other some
2810       // class derived from it).
2811       assert(LI.isFilter(i) && "Unsupported landingpad clause!");
2812       Constant *FilterClause = LI.getClause(i);
2813       ArrayType *FilterType = cast<ArrayType>(FilterClause->getType());
2814       unsigned NumTypeInfos = FilterType->getNumElements();
2815 
2816       // An empty filter catches everything, so there is no point in keeping any
2817       // following clauses or marking the landingpad as having a cleanup.  By
2818       // dealing with this case here the following code is made a bit simpler.
2819       if (!NumTypeInfos) {
2820         NewClauses.push_back(FilterClause);
2821         if (!isLastClause)
2822           MakeNewInstruction = true;
2823         CleanupFlag = false;
2824         break;
2825       }
2826 
2827       bool MakeNewFilter = false; // If true, make a new filter.
2828       SmallVector<Constant *, 16> NewFilterElts; // New elements.
2829       if (isa<ConstantAggregateZero>(FilterClause)) {
2830         // Not an empty filter - it contains at least one null typeinfo.
2831         assert(NumTypeInfos > 0 && "Should have handled empty filter already!");
2832         Constant *TypeInfo =
2833           Constant::getNullValue(FilterType->getElementType());
2834         // If this typeinfo is a catch-all then the filter can never match.
2835         if (isCatchAll(Personality, TypeInfo)) {
2836           // Throw the filter away.
2837           MakeNewInstruction = true;
2838           continue;
2839         }
2840 
2841         // There is no point in having multiple copies of this typeinfo, so
2842         // discard all but the first copy if there is more than one.
2843         NewFilterElts.push_back(TypeInfo);
2844         if (NumTypeInfos > 1)
2845           MakeNewFilter = true;
2846       } else {
2847         ConstantArray *Filter = cast<ConstantArray>(FilterClause);
2848         SmallPtrSet<Value *, 16> SeenInFilter; // For uniquing the elements.
2849         NewFilterElts.reserve(NumTypeInfos);
2850 
2851         // Remove any filter elements that were already caught or that already
2852         // occurred in the filter.  While there, see if any of the elements are
2853         // catch-alls.  If so, the filter can be discarded.
2854         bool SawCatchAll = false;
2855         for (unsigned j = 0; j != NumTypeInfos; ++j) {
2856           Constant *Elt = Filter->getOperand(j);
2857           Constant *TypeInfo = Elt->stripPointerCasts();
2858           if (isCatchAll(Personality, TypeInfo)) {
2859             // This element is a catch-all.  Bail out, noting this fact.
2860             SawCatchAll = true;
2861             break;
2862           }
2863 
2864           // Even if we've seen a type in a catch clause, we don't want to
2865           // remove it from the filter.  An unexpected type handler may be
2866           // set up for a call site which throws an exception of the same
2867           // type caught.  In order for the exception thrown by the unexpected
2868           // handler to propagate correctly, the filter must be correctly
2869           // described for the call site.
2870           //
2871           // Example:
2872           //
2873           // void unexpected() { throw 1;}
2874           // void foo() throw (int) {
2875           //   std::set_unexpected(unexpected);
2876           //   try {
2877           //     throw 2.0;
2878           //   } catch (int i) {}
2879           // }
2880 
2881           // There is no point in having multiple copies of the same typeinfo in
2882           // a filter, so only add it if we didn't already.
2883           if (SeenInFilter.insert(TypeInfo).second)
2884             NewFilterElts.push_back(cast<Constant>(Elt));
2885         }
2886         // A filter containing a catch-all cannot match anything by definition.
2887         if (SawCatchAll) {
2888           // Throw the filter away.
2889           MakeNewInstruction = true;
2890           continue;
2891         }
2892 
2893         // If we dropped something from the filter, make a new one.
2894         if (NewFilterElts.size() < NumTypeInfos)
2895           MakeNewFilter = true;
2896       }
2897       if (MakeNewFilter) {
2898         FilterType = ArrayType::get(FilterType->getElementType(),
2899                                     NewFilterElts.size());
2900         FilterClause = ConstantArray::get(FilterType, NewFilterElts);
2901         MakeNewInstruction = true;
2902       }
2903 
2904       NewClauses.push_back(FilterClause);
2905 
2906       // If the new filter is empty then it will catch everything so there is
2907       // no point in keeping any following clauses or marking the landingpad
2908       // as having a cleanup.  The case of the original filter being empty was
2909       // already handled above.
2910       if (MakeNewFilter && !NewFilterElts.size()) {
2911         assert(MakeNewInstruction && "New filter but not a new instruction!");
2912         CleanupFlag = false;
2913         break;
2914       }
2915     }
2916   }
2917 
2918   // If several filters occur in a row then reorder them so that the shortest
2919   // filters come first (those with the smallest number of elements).  This is
2920   // advantageous because shorter filters are more likely to match, speeding up
2921   // unwinding, but mostly because it increases the effectiveness of the other
2922   // filter optimizations below.
2923   for (unsigned i = 0, e = NewClauses.size(); i + 1 < e; ) {
2924     unsigned j;
2925     // Find the maximal 'j' s.t. the range [i, j) consists entirely of filters.
2926     for (j = i; j != e; ++j)
2927       if (!isa<ArrayType>(NewClauses[j]->getType()))
2928         break;
2929 
2930     // Check whether the filters are already sorted by length.  We need to know
2931     // if sorting them is actually going to do anything so that we only make a
2932     // new landingpad instruction if it does.
2933     for (unsigned k = i; k + 1 < j; ++k)
2934       if (shorter_filter(NewClauses[k+1], NewClauses[k])) {
2935         // Not sorted, so sort the filters now.  Doing an unstable sort would be
2936         // correct too but reordering filters pointlessly might confuse users.
2937         std::stable_sort(NewClauses.begin() + i, NewClauses.begin() + j,
2938                          shorter_filter);
2939         MakeNewInstruction = true;
2940         break;
2941       }
2942 
2943     // Look for the next batch of filters.
2944     i = j + 1;
2945   }
2946 
2947   // If typeinfos matched if and only if equal, then the elements of a filter L
2948   // that occurs later than a filter F could be replaced by the intersection of
2949   // the elements of F and L.  In reality two typeinfos can match without being
2950   // equal (for example if one represents a C++ class, and the other some class
2951   // derived from it) so it would be wrong to perform this transform in general.
2952   // However the transform is correct and useful if F is a subset of L.  In that
2953   // case L can be replaced by F, and thus removed altogether since repeating a
2954   // filter is pointless.  So here we look at all pairs of filters F and L where
2955   // L follows F in the list of clauses, and remove L if every element of F is
2956   // an element of L.  This can occur when inlining C++ functions with exception
2957   // specifications.
2958   for (unsigned i = 0; i + 1 < NewClauses.size(); ++i) {
2959     // Examine each filter in turn.
2960     Value *Filter = NewClauses[i];
2961     ArrayType *FTy = dyn_cast<ArrayType>(Filter->getType());
2962     if (!FTy)
2963       // Not a filter - skip it.
2964       continue;
2965     unsigned FElts = FTy->getNumElements();
2966     // Examine each filter following this one.  Doing this backwards means that
2967     // we don't have to worry about filters disappearing under us when removed.
2968     for (unsigned j = NewClauses.size() - 1; j != i; --j) {
2969       Value *LFilter = NewClauses[j];
2970       ArrayType *LTy = dyn_cast<ArrayType>(LFilter->getType());
2971       if (!LTy)
2972         // Not a filter - skip it.
2973         continue;
2974       // If Filter is a subset of LFilter, i.e. every element of Filter is also
2975       // an element of LFilter, then discard LFilter.
2976       SmallVectorImpl<Constant *>::iterator J = NewClauses.begin() + j;
2977       // If Filter is empty then it is a subset of LFilter.
2978       if (!FElts) {
2979         // Discard LFilter.
2980         NewClauses.erase(J);
2981         MakeNewInstruction = true;
2982         // Move on to the next filter.
2983         continue;
2984       }
2985       unsigned LElts = LTy->getNumElements();
2986       // If Filter is longer than LFilter then it cannot be a subset of it.
2987       if (FElts > LElts)
2988         // Move on to the next filter.
2989         continue;
2990       // At this point we know that LFilter has at least one element.
2991       if (isa<ConstantAggregateZero>(LFilter)) { // LFilter only contains zeros.
2992         // Filter is a subset of LFilter iff Filter contains only zeros (as we
2993         // already know that Filter is not longer than LFilter).
2994         if (isa<ConstantAggregateZero>(Filter)) {
2995           assert(FElts <= LElts && "Should have handled this case earlier!");
2996           // Discard LFilter.
2997           NewClauses.erase(J);
2998           MakeNewInstruction = true;
2999         }
3000         // Move on to the next filter.
3001         continue;
3002       }
3003       ConstantArray *LArray = cast<ConstantArray>(LFilter);
3004       if (isa<ConstantAggregateZero>(Filter)) { // Filter only contains zeros.
3005         // Since Filter is non-empty and contains only zeros, it is a subset of
3006         // LFilter iff LFilter contains a zero.
3007         assert(FElts > 0 && "Should have eliminated the empty filter earlier!");
3008         for (unsigned l = 0; l != LElts; ++l)
3009           if (LArray->getOperand(l)->isNullValue()) {
3010             // LFilter contains a zero - discard it.
3011             NewClauses.erase(J);
3012             MakeNewInstruction = true;
3013             break;
3014           }
3015         // Move on to the next filter.
3016         continue;
3017       }
3018       // At this point we know that both filters are ConstantArrays.  Loop over
3019       // operands to see whether every element of Filter is also an element of
3020       // LFilter.  Since filters tend to be short this is probably faster than
3021       // using a method that scales nicely.
3022       ConstantArray *FArray = cast<ConstantArray>(Filter);
3023       bool AllFound = true;
3024       for (unsigned f = 0; f != FElts; ++f) {
3025         Value *FTypeInfo = FArray->getOperand(f)->stripPointerCasts();
3026         AllFound = false;
3027         for (unsigned l = 0; l != LElts; ++l) {
3028           Value *LTypeInfo = LArray->getOperand(l)->stripPointerCasts();
3029           if (LTypeInfo == FTypeInfo) {
3030             AllFound = true;
3031             break;
3032           }
3033         }
3034         if (!AllFound)
3035           break;
3036       }
3037       if (AllFound) {
3038         // Discard LFilter.
3039         NewClauses.erase(J);
3040         MakeNewInstruction = true;
3041       }
3042       // Move on to the next filter.
3043     }
3044   }
3045 
3046   // If we changed any of the clauses, replace the old landingpad instruction
3047   // with a new one.
3048   if (MakeNewInstruction) {
3049     LandingPadInst *NLI = LandingPadInst::Create(LI.getType(),
3050                                                  NewClauses.size());
3051     for (unsigned i = 0, e = NewClauses.size(); i != e; ++i)
3052       NLI->addClause(NewClauses[i]);
3053     // A landing pad with no clauses must have the cleanup flag set.  It is
3054     // theoretically possible, though highly unlikely, that we eliminated all
3055     // clauses.  If so, force the cleanup flag to true.
3056     if (NewClauses.empty())
3057       CleanupFlag = true;
3058     NLI->setCleanup(CleanupFlag);
3059     return NLI;
3060   }
3061 
3062   // Even if none of the clauses changed, we may nonetheless have understood
3063   // that the cleanup flag is pointless.  Clear it if so.
3064   if (LI.isCleanup() != CleanupFlag) {
3065     assert(!CleanupFlag && "Adding a cleanup, not removing one?!");
3066     LI.setCleanup(CleanupFlag);
3067     return &LI;
3068   }
3069 
3070   return nullptr;
3071 }
3072 
3073 /// Try to move the specified instruction from its current block into the
3074 /// beginning of DestBlock, which can only happen if it's safe to move the
3075 /// instruction past all of the instructions between it and the end of its
3076 /// block.
3077 static bool TryToSinkInstruction(Instruction *I, BasicBlock *DestBlock) {
3078   assert(I->hasOneUse() && "Invariants didn't hold!");
3079   BasicBlock *SrcBlock = I->getParent();
3080 
3081   // Cannot move control-flow-involving, volatile loads, vaarg, etc.
3082   if (isa<PHINode>(I) || I->isEHPad() || I->mayHaveSideEffects() ||
3083       I->isTerminator())
3084     return false;
3085 
3086   // Do not sink static or dynamic alloca instructions. Static allocas must
3087   // remain in the entry block, and dynamic allocas must not be sunk in between
3088   // a stacksave / stackrestore pair, which would incorrectly shorten its
3089   // lifetime.
3090   if (isa<AllocaInst>(I))
3091     return false;
3092 
3093   // Do not sink into catchswitch blocks.
3094   if (isa<CatchSwitchInst>(DestBlock->getTerminator()))
3095     return false;
3096 
3097   // Do not sink convergent call instructions.
3098   if (auto *CI = dyn_cast<CallInst>(I)) {
3099     if (CI->isConvergent())
3100       return false;
3101   }
3102   // We can only sink load instructions if there is nothing between the load and
3103   // the end of block that could change the value.
3104   if (I->mayReadFromMemory()) {
3105     for (BasicBlock::iterator Scan = I->getIterator(),
3106                               E = I->getParent()->end();
3107          Scan != E; ++Scan)
3108       if (Scan->mayWriteToMemory())
3109         return false;
3110   }
3111   BasicBlock::iterator InsertPos = DestBlock->getFirstInsertionPt();
3112   I->moveBefore(&*InsertPos);
3113   ++NumSunkInst;
3114 
3115   // Also sink all related debug uses from the source basic block. Otherwise we
3116   // get debug use before the def. Attempt to salvage debug uses first, to
3117   // maximise the range variables have location for. If we cannot salvage, then
3118   // mark the location undef: we know it was supposed to receive a new location
3119   // here, but that computation has been sunk.
3120   SmallVector<DbgVariableIntrinsic *, 2> DbgUsers;
3121   findDbgUsers(DbgUsers, I);
3122   for (auto *DII : reverse(DbgUsers)) {
3123     if (DII->getParent() == SrcBlock) {
3124       // dbg.value is in the same basic block as the sunk inst, see if we can
3125       // salvage it. Clone a new copy of the instruction: on success we need
3126       // both salvaged and unsalvaged copies.
3127       SmallVector<DbgVariableIntrinsic *, 1> TmpUser{
3128           cast<DbgVariableIntrinsic>(DII->clone())};
3129 
3130       if (!salvageDebugInfoForDbgValues(*I, TmpUser)) {
3131         // We are unable to salvage: sink the cloned dbg.value, and mark the
3132         // original as undef, terminating any earlier variable location.
3133         LLVM_DEBUG(dbgs() << "SINK: " << *DII << '\n');
3134         TmpUser[0]->insertBefore(&*InsertPos);
3135         Value *Undef = UndefValue::get(I->getType());
3136         DII->setOperand(0, MetadataAsValue::get(DII->getContext(),
3137                                                 ValueAsMetadata::get(Undef)));
3138       } else {
3139         // We successfully salvaged: place the salvaged dbg.value in the
3140         // original location, and move the unmodified dbg.value to sink with
3141         // the sunk inst.
3142         TmpUser[0]->insertBefore(DII);
3143         DII->moveBefore(&*InsertPos);
3144       }
3145     }
3146   }
3147   return true;
3148 }
3149 
3150 bool InstCombiner::run() {
3151   while (!Worklist.isEmpty()) {
3152     Instruction *I = Worklist.RemoveOne();
3153     if (I == nullptr) continue;  // skip null values.
3154 
3155     // Check to see if we can DCE the instruction.
3156     if (isInstructionTriviallyDead(I, &TLI)) {
3157       LLVM_DEBUG(dbgs() << "IC: DCE: " << *I << '\n');
3158       eraseInstFromFunction(*I);
3159       ++NumDeadInst;
3160       MadeIRChange = true;
3161       continue;
3162     }
3163 
3164     if (!DebugCounter::shouldExecute(VisitCounter))
3165       continue;
3166 
3167     // Instruction isn't dead, see if we can constant propagate it.
3168     if (!I->use_empty() &&
3169         (I->getNumOperands() == 0 || isa<Constant>(I->getOperand(0)))) {
3170       if (Constant *C = ConstantFoldInstruction(I, DL, &TLI)) {
3171         LLVM_DEBUG(dbgs() << "IC: ConstFold to: " << *C << " from: " << *I
3172                           << '\n');
3173 
3174         // Add operands to the worklist.
3175         replaceInstUsesWith(*I, C);
3176         ++NumConstProp;
3177         if (isInstructionTriviallyDead(I, &TLI))
3178           eraseInstFromFunction(*I);
3179         MadeIRChange = true;
3180         continue;
3181       }
3182     }
3183 
3184     // In general, it is possible for computeKnownBits to determine all bits in
3185     // a value even when the operands are not all constants.
3186     Type *Ty = I->getType();
3187     if (ExpensiveCombines && !I->use_empty() && Ty->isIntOrIntVectorTy()) {
3188       KnownBits Known = computeKnownBits(I, /*Depth*/0, I);
3189       if (Known.isConstant()) {
3190         Constant *C = ConstantInt::get(Ty, Known.getConstant());
3191         LLVM_DEBUG(dbgs() << "IC: ConstFold (all bits known) to: " << *C
3192                           << " from: " << *I << '\n');
3193 
3194         // Add operands to the worklist.
3195         replaceInstUsesWith(*I, C);
3196         ++NumConstProp;
3197         if (isInstructionTriviallyDead(I, &TLI))
3198           eraseInstFromFunction(*I);
3199         MadeIRChange = true;
3200         continue;
3201       }
3202     }
3203 
3204     // See if we can trivially sink this instruction to a successor basic block.
3205     if (EnableCodeSinking && I->hasOneUse()) {
3206       BasicBlock *BB = I->getParent();
3207       Instruction *UserInst = cast<Instruction>(*I->user_begin());
3208       BasicBlock *UserParent;
3209 
3210       // Get the block the use occurs in.
3211       if (PHINode *PN = dyn_cast<PHINode>(UserInst))
3212         UserParent = PN->getIncomingBlock(*I->use_begin());
3213       else
3214         UserParent = UserInst->getParent();
3215 
3216       if (UserParent != BB) {
3217         bool UserIsSuccessor = false;
3218         // See if the user is one of our successors.
3219         for (succ_iterator SI = succ_begin(BB), E = succ_end(BB); SI != E; ++SI)
3220           if (*SI == UserParent) {
3221             UserIsSuccessor = true;
3222             break;
3223           }
3224 
3225         // If the user is one of our immediate successors, and if that successor
3226         // only has us as a predecessors (we'd have to split the critical edge
3227         // otherwise), we can keep going.
3228         if (UserIsSuccessor && UserParent->getUniquePredecessor()) {
3229           // Okay, the CFG is simple enough, try to sink this instruction.
3230           if (TryToSinkInstruction(I, UserParent)) {
3231             LLVM_DEBUG(dbgs() << "IC: Sink: " << *I << '\n');
3232             MadeIRChange = true;
3233             // We'll add uses of the sunk instruction below, but since sinking
3234             // can expose opportunities for it's *operands* add them to the
3235             // worklist
3236             for (Use &U : I->operands())
3237               if (Instruction *OpI = dyn_cast<Instruction>(U.get()))
3238                 Worklist.Add(OpI);
3239           }
3240         }
3241       }
3242     }
3243 
3244     // Now that we have an instruction, try combining it to simplify it.
3245     Builder.SetInsertPoint(I);
3246     Builder.SetCurrentDebugLocation(I->getDebugLoc());
3247 
3248 #ifndef NDEBUG
3249     std::string OrigI;
3250 #endif
3251     LLVM_DEBUG(raw_string_ostream SS(OrigI); I->print(SS); OrigI = SS.str(););
3252     LLVM_DEBUG(dbgs() << "IC: Visiting: " << OrigI << '\n');
3253 
3254     if (Instruction *Result = visit(*I)) {
3255       ++NumCombined;
3256       // Should we replace the old instruction with a new one?
3257       if (Result != I) {
3258         LLVM_DEBUG(dbgs() << "IC: Old = " << *I << '\n'
3259                           << "    New = " << *Result << '\n');
3260 
3261         if (I->getDebugLoc())
3262           Result->setDebugLoc(I->getDebugLoc());
3263         // Everything uses the new instruction now.
3264         I->replaceAllUsesWith(Result);
3265 
3266         // Move the name to the new instruction first.
3267         Result->takeName(I);
3268 
3269         // Push the new instruction and any users onto the worklist.
3270         Worklist.AddUsersToWorkList(*Result);
3271         Worklist.Add(Result);
3272 
3273         // Insert the new instruction into the basic block...
3274         BasicBlock *InstParent = I->getParent();
3275         BasicBlock::iterator InsertPos = I->getIterator();
3276 
3277         // If we replace a PHI with something that isn't a PHI, fix up the
3278         // insertion point.
3279         if (!isa<PHINode>(Result) && isa<PHINode>(InsertPos))
3280           InsertPos = InstParent->getFirstInsertionPt();
3281 
3282         InstParent->getInstList().insert(InsertPos, Result);
3283 
3284         eraseInstFromFunction(*I);
3285       } else {
3286         LLVM_DEBUG(dbgs() << "IC: Mod = " << OrigI << '\n'
3287                           << "    New = " << *I << '\n');
3288 
3289         // If the instruction was modified, it's possible that it is now dead.
3290         // if so, remove it.
3291         if (isInstructionTriviallyDead(I, &TLI)) {
3292           eraseInstFromFunction(*I);
3293         } else {
3294           Worklist.AddUsersToWorkList(*I);
3295           Worklist.Add(I);
3296         }
3297       }
3298       MadeIRChange = true;
3299     }
3300   }
3301 
3302   Worklist.Zap();
3303   return MadeIRChange;
3304 }
3305 
3306 /// Walk the function in depth-first order, adding all reachable code to the
3307 /// worklist.
3308 ///
3309 /// This has a couple of tricks to make the code faster and more powerful.  In
3310 /// particular, we constant fold and DCE instructions as we go, to avoid adding
3311 /// them to the worklist (this significantly speeds up instcombine on code where
3312 /// many instructions are dead or constant).  Additionally, if we find a branch
3313 /// whose condition is a known constant, we only visit the reachable successors.
3314 static bool AddReachableCodeToWorklist(BasicBlock *BB, const DataLayout &DL,
3315                                        SmallPtrSetImpl<BasicBlock *> &Visited,
3316                                        InstCombineWorklist &ICWorklist,
3317                                        const TargetLibraryInfo *TLI) {
3318   bool MadeIRChange = false;
3319   SmallVector<BasicBlock*, 256> Worklist;
3320   Worklist.push_back(BB);
3321 
3322   SmallVector<Instruction*, 128> InstrsForInstCombineWorklist;
3323   DenseMap<Constant *, Constant *> FoldedConstants;
3324 
3325   do {
3326     BB = Worklist.pop_back_val();
3327 
3328     // We have now visited this block!  If we've already been here, ignore it.
3329     if (!Visited.insert(BB).second)
3330       continue;
3331 
3332     for (BasicBlock::iterator BBI = BB->begin(), E = BB->end(); BBI != E; ) {
3333       Instruction *Inst = &*BBI++;
3334 
3335       // DCE instruction if trivially dead.
3336       if (isInstructionTriviallyDead(Inst, TLI)) {
3337         ++NumDeadInst;
3338         LLVM_DEBUG(dbgs() << "IC: DCE: " << *Inst << '\n');
3339         if (!salvageDebugInfo(*Inst))
3340           replaceDbgUsesWithUndef(Inst);
3341         Inst->eraseFromParent();
3342         MadeIRChange = true;
3343         continue;
3344       }
3345 
3346       // ConstantProp instruction if trivially constant.
3347       if (!Inst->use_empty() &&
3348           (Inst->getNumOperands() == 0 || isa<Constant>(Inst->getOperand(0))))
3349         if (Constant *C = ConstantFoldInstruction(Inst, DL, TLI)) {
3350           LLVM_DEBUG(dbgs() << "IC: ConstFold to: " << *C << " from: " << *Inst
3351                             << '\n');
3352           Inst->replaceAllUsesWith(C);
3353           ++NumConstProp;
3354           if (isInstructionTriviallyDead(Inst, TLI))
3355             Inst->eraseFromParent();
3356           MadeIRChange = true;
3357           continue;
3358         }
3359 
3360       // See if we can constant fold its operands.
3361       for (Use &U : Inst->operands()) {
3362         if (!isa<ConstantVector>(U) && !isa<ConstantExpr>(U))
3363           continue;
3364 
3365         auto *C = cast<Constant>(U);
3366         Constant *&FoldRes = FoldedConstants[C];
3367         if (!FoldRes)
3368           FoldRes = ConstantFoldConstant(C, DL, TLI);
3369         if (!FoldRes)
3370           FoldRes = C;
3371 
3372         if (FoldRes != C) {
3373           LLVM_DEBUG(dbgs() << "IC: ConstFold operand of: " << *Inst
3374                             << "\n    Old = " << *C
3375                             << "\n    New = " << *FoldRes << '\n');
3376           U = FoldRes;
3377           MadeIRChange = true;
3378         }
3379       }
3380 
3381       // Skip processing debug intrinsics in InstCombine. Processing these call instructions
3382       // consumes non-trivial amount of time and provides no value for the optimization.
3383       if (!isa<DbgInfoIntrinsic>(Inst))
3384         InstrsForInstCombineWorklist.push_back(Inst);
3385     }
3386 
3387     // Recursively visit successors.  If this is a branch or switch on a
3388     // constant, only visit the reachable successor.
3389     Instruction *TI = BB->getTerminator();
3390     if (BranchInst *BI = dyn_cast<BranchInst>(TI)) {
3391       if (BI->isConditional() && isa<ConstantInt>(BI->getCondition())) {
3392         bool CondVal = cast<ConstantInt>(BI->getCondition())->getZExtValue();
3393         BasicBlock *ReachableBB = BI->getSuccessor(!CondVal);
3394         Worklist.push_back(ReachableBB);
3395         continue;
3396       }
3397     } else if (SwitchInst *SI = dyn_cast<SwitchInst>(TI)) {
3398       if (ConstantInt *Cond = dyn_cast<ConstantInt>(SI->getCondition())) {
3399         Worklist.push_back(SI->findCaseValue(Cond)->getCaseSuccessor());
3400         continue;
3401       }
3402     }
3403 
3404     for (BasicBlock *SuccBB : successors(TI))
3405       Worklist.push_back(SuccBB);
3406   } while (!Worklist.empty());
3407 
3408   // Once we've found all of the instructions to add to instcombine's worklist,
3409   // add them in reverse order.  This way instcombine will visit from the top
3410   // of the function down.  This jives well with the way that it adds all uses
3411   // of instructions to the worklist after doing a transformation, thus avoiding
3412   // some N^2 behavior in pathological cases.
3413   ICWorklist.AddInitialGroup(InstrsForInstCombineWorklist);
3414 
3415   return MadeIRChange;
3416 }
3417 
3418 /// Populate the IC worklist from a function, and prune any dead basic
3419 /// blocks discovered in the process.
3420 ///
3421 /// This also does basic constant propagation and other forward fixing to make
3422 /// the combiner itself run much faster.
3423 static bool prepareICWorklistFromFunction(Function &F, const DataLayout &DL,
3424                                           TargetLibraryInfo *TLI,
3425                                           InstCombineWorklist &ICWorklist) {
3426   bool MadeIRChange = false;
3427 
3428   // Do a depth-first traversal of the function, populate the worklist with
3429   // the reachable instructions.  Ignore blocks that are not reachable.  Keep
3430   // track of which blocks we visit.
3431   SmallPtrSet<BasicBlock *, 32> Visited;
3432   MadeIRChange |=
3433       AddReachableCodeToWorklist(&F.front(), DL, Visited, ICWorklist, TLI);
3434 
3435   // Do a quick scan over the function.  If we find any blocks that are
3436   // unreachable, remove any instructions inside of them.  This prevents
3437   // the instcombine code from having to deal with some bad special cases.
3438   for (BasicBlock &BB : F) {
3439     if (Visited.count(&BB))
3440       continue;
3441 
3442     unsigned NumDeadInstInBB = removeAllNonTerminatorAndEHPadInstructions(&BB);
3443     MadeIRChange |= NumDeadInstInBB > 0;
3444     NumDeadInst += NumDeadInstInBB;
3445   }
3446 
3447   return MadeIRChange;
3448 }
3449 
3450 static bool combineInstructionsOverFunction(
3451     Function &F, InstCombineWorklist &Worklist, AliasAnalysis *AA,
3452     AssumptionCache &AC, TargetLibraryInfo &TLI, DominatorTree &DT,
3453     OptimizationRemarkEmitter &ORE, bool ExpensiveCombines = true,
3454     LoopInfo *LI = nullptr) {
3455   auto &DL = F.getParent()->getDataLayout();
3456   ExpensiveCombines |= EnableExpensiveCombines;
3457 
3458   /// Builder - This is an IRBuilder that automatically inserts new
3459   /// instructions into the worklist when they are created.
3460   IRBuilder<TargetFolder, IRBuilderCallbackInserter> Builder(
3461       F.getContext(), TargetFolder(DL),
3462       IRBuilderCallbackInserter([&Worklist, &AC](Instruction *I) {
3463         Worklist.Add(I);
3464         if (match(I, m_Intrinsic<Intrinsic::assume>()))
3465           AC.registerAssumption(cast<CallInst>(I));
3466       }));
3467 
3468   // Lower dbg.declare intrinsics otherwise their value may be clobbered
3469   // by instcombiner.
3470   bool MadeIRChange = false;
3471   if (ShouldLowerDbgDeclare)
3472     MadeIRChange = LowerDbgDeclare(F);
3473 
3474   // Iterate while there is work to do.
3475   int Iteration = 0;
3476   while (true) {
3477     ++Iteration;
3478     LLVM_DEBUG(dbgs() << "\n\nINSTCOMBINE ITERATION #" << Iteration << " on "
3479                       << F.getName() << "\n");
3480 
3481     MadeIRChange |= prepareICWorklistFromFunction(F, DL, &TLI, Worklist);
3482 
3483     InstCombiner IC(Worklist, Builder, F.optForMinSize(), ExpensiveCombines, AA,
3484                     AC, TLI, DT, ORE, DL, LI);
3485     IC.MaxArraySizeForCombine = MaxArraySize;
3486 
3487     if (!IC.run())
3488       break;
3489   }
3490 
3491   return MadeIRChange || Iteration > 1;
3492 }
3493 
3494 PreservedAnalyses InstCombinePass::run(Function &F,
3495                                        FunctionAnalysisManager &AM) {
3496   auto &AC = AM.getResult<AssumptionAnalysis>(F);
3497   auto &DT = AM.getResult<DominatorTreeAnalysis>(F);
3498   auto &TLI = AM.getResult<TargetLibraryAnalysis>(F);
3499   auto &ORE = AM.getResult<OptimizationRemarkEmitterAnalysis>(F);
3500 
3501   auto *LI = AM.getCachedResult<LoopAnalysis>(F);
3502 
3503   auto *AA = &AM.getResult<AAManager>(F);
3504   if (!combineInstructionsOverFunction(F, Worklist, AA, AC, TLI, DT, ORE,
3505                                        ExpensiveCombines, LI))
3506     // No changes, all analyses are preserved.
3507     return PreservedAnalyses::all();
3508 
3509   // Mark all the analyses that instcombine updates as preserved.
3510   PreservedAnalyses PA;
3511   PA.preserveSet<CFGAnalyses>();
3512   PA.preserve<AAManager>();
3513   PA.preserve<BasicAA>();
3514   PA.preserve<GlobalsAA>();
3515   return PA;
3516 }
3517 
3518 void InstructionCombiningPass::getAnalysisUsage(AnalysisUsage &AU) const {
3519   AU.setPreservesCFG();
3520   AU.addRequired<AAResultsWrapperPass>();
3521   AU.addRequired<AssumptionCacheTracker>();
3522   AU.addRequired<TargetLibraryInfoWrapperPass>();
3523   AU.addRequired<DominatorTreeWrapperPass>();
3524   AU.addRequired<OptimizationRemarkEmitterWrapperPass>();
3525   AU.addPreserved<DominatorTreeWrapperPass>();
3526   AU.addPreserved<AAResultsWrapperPass>();
3527   AU.addPreserved<BasicAAWrapperPass>();
3528   AU.addPreserved<GlobalsAAWrapperPass>();
3529 }
3530 
3531 bool InstructionCombiningPass::runOnFunction(Function &F) {
3532   if (skipFunction(F))
3533     return false;
3534 
3535   // Required analyses.
3536   auto AA = &getAnalysis<AAResultsWrapperPass>().getAAResults();
3537   auto &AC = getAnalysis<AssumptionCacheTracker>().getAssumptionCache(F);
3538   auto &TLI = getAnalysis<TargetLibraryInfoWrapperPass>().getTLI();
3539   auto &DT = getAnalysis<DominatorTreeWrapperPass>().getDomTree();
3540   auto &ORE = getAnalysis<OptimizationRemarkEmitterWrapperPass>().getORE();
3541 
3542   // Optional analyses.
3543   auto *LIWP = getAnalysisIfAvailable<LoopInfoWrapperPass>();
3544   auto *LI = LIWP ? &LIWP->getLoopInfo() : nullptr;
3545 
3546   return combineInstructionsOverFunction(F, Worklist, AA, AC, TLI, DT, ORE,
3547                                          ExpensiveCombines, LI);
3548 }
3549 
3550 char InstructionCombiningPass::ID = 0;
3551 
3552 INITIALIZE_PASS_BEGIN(InstructionCombiningPass, "instcombine",
3553                       "Combine redundant instructions", false, false)
3554 INITIALIZE_PASS_DEPENDENCY(AssumptionCacheTracker)
3555 INITIALIZE_PASS_DEPENDENCY(TargetLibraryInfoWrapperPass)
3556 INITIALIZE_PASS_DEPENDENCY(DominatorTreeWrapperPass)
3557 INITIALIZE_PASS_DEPENDENCY(AAResultsWrapperPass)
3558 INITIALIZE_PASS_DEPENDENCY(GlobalsAAWrapperPass)
3559 INITIALIZE_PASS_DEPENDENCY(OptimizationRemarkEmitterWrapperPass)
3560 INITIALIZE_PASS_END(InstructionCombiningPass, "instcombine",
3561                     "Combine redundant instructions", false, false)
3562 
3563 // Initialization Routines
3564 void llvm::initializeInstCombine(PassRegistry &Registry) {
3565   initializeInstructionCombiningPassPass(Registry);
3566 }
3567 
3568 void LLVMInitializeInstCombine(LLVMPassRegistryRef R) {
3569   initializeInstructionCombiningPassPass(*unwrap(R));
3570 }
3571 
3572 FunctionPass *llvm::createInstructionCombiningPass(bool ExpensiveCombines) {
3573   return new InstructionCombiningPass(ExpensiveCombines);
3574 }
3575 
3576 void LLVMAddInstructionCombiningPass(LLVMPassManagerRef PM) {
3577   unwrap(PM)->add(createInstructionCombiningPass());
3578 }
3579