1 //===- DeadStoreElimination.cpp - Fast Dead Store Elimination -------------===//
2 //
3 //                     The LLVM Compiler Infrastructure
4 //
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
7 //
8 //===----------------------------------------------------------------------===//
9 //
10 // This file implements a trivial dead store elimination that only considers
11 // basic-block local redundant stores.
12 //
13 // FIXME: This should eventually be extended to be a post-dominator tree
14 // traversal.  Doing so would be pretty trivial.
15 //
16 //===----------------------------------------------------------------------===//
17 
18 #include "llvm/Transforms/Scalar/DeadStoreElimination.h"
19 #include "llvm/ADT/APInt.h"
20 #include "llvm/ADT/DenseMap.h"
21 #include "llvm/ADT/SetVector.h"
22 #include "llvm/ADT/SmallPtrSet.h"
23 #include "llvm/ADT/SmallVector.h"
24 #include "llvm/ADT/Statistic.h"
25 #include "llvm/ADT/StringRef.h"
26 #include "llvm/Analysis/AliasAnalysis.h"
27 #include "llvm/Analysis/CaptureTracking.h"
28 #include "llvm/Analysis/GlobalsModRef.h"
29 #include "llvm/Analysis/MemoryBuiltins.h"
30 #include "llvm/Analysis/MemoryDependenceAnalysis.h"
31 #include "llvm/Analysis/MemoryLocation.h"
32 #include "llvm/Analysis/TargetLibraryInfo.h"
33 #include "llvm/Transforms/Utils/Local.h"
34 #include "llvm/Analysis/ValueTracking.h"
35 #include "llvm/IR/Argument.h"
36 #include "llvm/IR/BasicBlock.h"
37 #include "llvm/IR/CallSite.h"
38 #include "llvm/IR/Constant.h"
39 #include "llvm/IR/Constants.h"
40 #include "llvm/IR/DataLayout.h"
41 #include "llvm/IR/Dominators.h"
42 #include "llvm/IR/Function.h"
43 #include "llvm/IR/InstrTypes.h"
44 #include "llvm/IR/Instruction.h"
45 #include "llvm/IR/Instructions.h"
46 #include "llvm/IR/IntrinsicInst.h"
47 #include "llvm/IR/Intrinsics.h"
48 #include "llvm/IR/LLVMContext.h"
49 #include "llvm/IR/Module.h"
50 #include "llvm/IR/PassManager.h"
51 #include "llvm/IR/Value.h"
52 #include "llvm/Pass.h"
53 #include "llvm/Support/Casting.h"
54 #include "llvm/Support/CommandLine.h"
55 #include "llvm/Support/Debug.h"
56 #include "llvm/Support/ErrorHandling.h"
57 #include "llvm/Support/MathExtras.h"
58 #include "llvm/Support/raw_ostream.h"
59 #include "llvm/Transforms/Scalar.h"
60 #include <algorithm>
61 #include <cassert>
62 #include <cstddef>
63 #include <cstdint>
64 #include <iterator>
65 #include <map>
66 #include <utility>
67 
68 using namespace llvm;
69 
70 #define DEBUG_TYPE "dse"
71 
72 STATISTIC(NumRedundantStores, "Number of redundant stores deleted");
73 STATISTIC(NumFastStores, "Number of stores deleted");
74 STATISTIC(NumFastOther , "Number of other instrs removed");
75 STATISTIC(NumCompletePartials, "Number of stores dead by later partials");
76 STATISTIC(NumModifiedStores, "Number of stores modified");
77 
78 static cl::opt<bool>
79 EnablePartialOverwriteTracking("enable-dse-partial-overwrite-tracking",
80   cl::init(true), cl::Hidden,
81   cl::desc("Enable partial-overwrite tracking in DSE"));
82 
83 static cl::opt<bool>
84 EnablePartialStoreMerging("enable-dse-partial-store-merging",
85   cl::init(true), cl::Hidden,
86   cl::desc("Enable partial store merging in DSE"));
87 
88 //===----------------------------------------------------------------------===//
89 // Helper functions
90 //===----------------------------------------------------------------------===//
91 using OverlapIntervalsTy = std::map<int64_t, int64_t>;
92 using InstOverlapIntervalsTy = DenseMap<Instruction *, OverlapIntervalsTy>;
93 
94 /// Delete this instruction.  Before we do, go through and zero out all the
95 /// operands of this instruction.  If any of them become dead, delete them and
96 /// the computation tree that feeds them.
97 /// If ValueSet is non-null, remove any deleted instructions from it as well.
98 static void
99 deleteDeadInstruction(Instruction *I, BasicBlock::iterator *BBI,
100                       MemoryDependenceResults &MD, const TargetLibraryInfo &TLI,
101                       InstOverlapIntervalsTy &IOL,
102                       DenseMap<Instruction*, size_t> *InstrOrdering,
103                       SmallSetVector<Value *, 16> *ValueSet = nullptr) {
104   SmallVector<Instruction*, 32> NowDeadInsts;
105 
106   NowDeadInsts.push_back(I);
107   --NumFastOther;
108 
109   // Keeping the iterator straight is a pain, so we let this routine tell the
110   // caller what the next instruction is after we're done mucking about.
111   BasicBlock::iterator NewIter = *BBI;
112 
113   // Before we touch this instruction, remove it from memdep!
114   do {
115     Instruction *DeadInst = NowDeadInsts.pop_back_val();
116     ++NumFastOther;
117 
118     // Try to preserve debug information attached to the dead instruction.
119     salvageDebugInfo(*DeadInst);
120 
121     // This instruction is dead, zap it, in stages.  Start by removing it from
122     // MemDep, which needs to know the operands and needs it to be in the
123     // function.
124     MD.removeInstruction(DeadInst);
125 
126     for (unsigned op = 0, e = DeadInst->getNumOperands(); op != e; ++op) {
127       Value *Op = DeadInst->getOperand(op);
128       DeadInst->setOperand(op, nullptr);
129 
130       // If this operand just became dead, add it to the NowDeadInsts list.
131       if (!Op->use_empty()) continue;
132 
133       if (Instruction *OpI = dyn_cast<Instruction>(Op))
134         if (isInstructionTriviallyDead(OpI, &TLI))
135           NowDeadInsts.push_back(OpI);
136     }
137 
138     if (ValueSet) ValueSet->remove(DeadInst);
139     InstrOrdering->erase(DeadInst);
140     IOL.erase(DeadInst);
141 
142     if (NewIter == DeadInst->getIterator())
143       NewIter = DeadInst->eraseFromParent();
144     else
145       DeadInst->eraseFromParent();
146   } while (!NowDeadInsts.empty());
147   *BBI = NewIter;
148 }
149 
150 /// Does this instruction write some memory?  This only returns true for things
151 /// that we can analyze with other helpers below.
152 static bool hasAnalyzableMemoryWrite(Instruction *I,
153                                      const TargetLibraryInfo &TLI) {
154   if (isa<StoreInst>(I))
155     return true;
156   if (IntrinsicInst *II = dyn_cast<IntrinsicInst>(I)) {
157     switch (II->getIntrinsicID()) {
158     default:
159       return false;
160     case Intrinsic::memset:
161     case Intrinsic::memmove:
162     case Intrinsic::memcpy:
163     case Intrinsic::memcpy_element_unordered_atomic:
164     case Intrinsic::memmove_element_unordered_atomic:
165     case Intrinsic::memset_element_unordered_atomic:
166     case Intrinsic::init_trampoline:
167     case Intrinsic::lifetime_end:
168       return true;
169     }
170   }
171   if (auto CS = CallSite(I)) {
172     if (Function *F = CS.getCalledFunction()) {
173       StringRef FnName = F->getName();
174       if (TLI.has(LibFunc_strcpy) && FnName == TLI.getName(LibFunc_strcpy))
175         return true;
176       if (TLI.has(LibFunc_strncpy) && FnName == TLI.getName(LibFunc_strncpy))
177         return true;
178       if (TLI.has(LibFunc_strcat) && FnName == TLI.getName(LibFunc_strcat))
179         return true;
180       if (TLI.has(LibFunc_strncat) && FnName == TLI.getName(LibFunc_strncat))
181         return true;
182     }
183   }
184   return false;
185 }
186 
187 /// Return a Location stored to by the specified instruction. If isRemovable
188 /// returns true, this function and getLocForRead completely describe the memory
189 /// operations for this instruction.
190 static MemoryLocation getLocForWrite(Instruction *Inst) {
191 
192   if (StoreInst *SI = dyn_cast<StoreInst>(Inst))
193     return MemoryLocation::get(SI);
194 
195   if (auto *MI = dyn_cast<AnyMemIntrinsic>(Inst)) {
196     // memcpy/memmove/memset.
197     MemoryLocation Loc = MemoryLocation::getForDest(MI);
198     return Loc;
199   }
200 
201   if (IntrinsicInst *II = dyn_cast<IntrinsicInst>(Inst)) {
202     switch (II->getIntrinsicID()) {
203     default:
204       return MemoryLocation(); // Unhandled intrinsic.
205     case Intrinsic::init_trampoline:
206       return MemoryLocation(II->getArgOperand(0));
207     case Intrinsic::lifetime_end: {
208       uint64_t Len = cast<ConstantInt>(II->getArgOperand(0))->getZExtValue();
209       return MemoryLocation(II->getArgOperand(1), Len);
210     }
211     }
212   }
213   if (auto CS = CallSite(Inst))
214     // All the supported TLI functions so far happen to have dest as their
215     // first argument.
216     return MemoryLocation(CS.getArgument(0));
217   return MemoryLocation();
218 }
219 
220 /// Return the location read by the specified "hasAnalyzableMemoryWrite"
221 /// instruction if any.
222 static MemoryLocation getLocForRead(Instruction *Inst,
223                                     const TargetLibraryInfo &TLI) {
224   assert(hasAnalyzableMemoryWrite(Inst, TLI) && "Unknown instruction case");
225 
226   // The only instructions that both read and write are the mem transfer
227   // instructions (memcpy/memmove).
228   if (auto *MTI = dyn_cast<AnyMemTransferInst>(Inst))
229     return MemoryLocation::getForSource(MTI);
230   return MemoryLocation();
231 }
232 
233 /// If the value of this instruction and the memory it writes to is unused, may
234 /// we delete this instruction?
235 static bool isRemovable(Instruction *I) {
236   // Don't remove volatile/atomic stores.
237   if (StoreInst *SI = dyn_cast<StoreInst>(I))
238     return SI->isUnordered();
239 
240   if (IntrinsicInst *II = dyn_cast<IntrinsicInst>(I)) {
241     switch (II->getIntrinsicID()) {
242     default: llvm_unreachable("doesn't pass 'hasAnalyzableMemoryWrite' predicate");
243     case Intrinsic::lifetime_end:
244       // Never remove dead lifetime_end's, e.g. because it is followed by a
245       // free.
246       return false;
247     case Intrinsic::init_trampoline:
248       // Always safe to remove init_trampoline.
249       return true;
250     case Intrinsic::memset:
251     case Intrinsic::memmove:
252     case Intrinsic::memcpy:
253       // Don't remove volatile memory intrinsics.
254       return !cast<MemIntrinsic>(II)->isVolatile();
255     case Intrinsic::memcpy_element_unordered_atomic:
256     case Intrinsic::memmove_element_unordered_atomic:
257     case Intrinsic::memset_element_unordered_atomic:
258       return true;
259     }
260   }
261 
262   // note: only get here for calls with analyzable writes - i.e. libcalls
263   if (auto CS = CallSite(I))
264     return CS.getInstruction()->use_empty();
265 
266   return false;
267 }
268 
269 /// Returns true if the end of this instruction can be safely shortened in
270 /// length.
271 static bool isShortenableAtTheEnd(Instruction *I) {
272   // Don't shorten stores for now
273   if (isa<StoreInst>(I))
274     return false;
275 
276   if (IntrinsicInst *II = dyn_cast<IntrinsicInst>(I)) {
277     switch (II->getIntrinsicID()) {
278       default: return false;
279       case Intrinsic::memset:
280       case Intrinsic::memcpy:
281       case Intrinsic::memcpy_element_unordered_atomic:
282       case Intrinsic::memset_element_unordered_atomic:
283         // Do shorten memory intrinsics.
284         // FIXME: Add memmove if it's also safe to transform.
285         return true;
286     }
287   }
288 
289   // Don't shorten libcalls calls for now.
290 
291   return false;
292 }
293 
294 /// Returns true if the beginning of this instruction can be safely shortened
295 /// in length.
296 static bool isShortenableAtTheBeginning(Instruction *I) {
297   // FIXME: Handle only memset for now. Supporting memcpy/memmove should be
298   // easily done by offsetting the source address.
299   return isa<AnyMemSetInst>(I);
300 }
301 
302 /// Return the pointer that is being written to.
303 static Value *getStoredPointerOperand(Instruction *I) {
304   //TODO: factor this to reuse getLocForWrite
305   MemoryLocation Loc = getLocForWrite(I);
306   assert(Loc.Ptr &&
307          "unable to find pointer written for analyzable instruction?");
308   // TODO: most APIs don't expect const Value *
309   return const_cast<Value*>(Loc.Ptr);
310 }
311 
312 static uint64_t getPointerSize(const Value *V, const DataLayout &DL,
313                                const TargetLibraryInfo &TLI) {
314   uint64_t Size;
315   if (getObjectSize(V, Size, DL, &TLI))
316     return Size;
317   return MemoryLocation::UnknownSize;
318 }
319 
320 namespace {
321 
322 enum OverwriteResult {
323   OW_Begin,
324   OW_Complete,
325   OW_End,
326   OW_PartialEarlierWithFullLater,
327   OW_Unknown
328 };
329 
330 } // end anonymous namespace
331 
332 /// Return 'OW_Complete' if a store to the 'Later' location completely
333 /// overwrites a store to the 'Earlier' location, 'OW_End' if the end of the
334 /// 'Earlier' location is completely overwritten by 'Later', 'OW_Begin' if the
335 /// beginning of the 'Earlier' location is overwritten by 'Later'.
336 /// 'OW_PartialEarlierWithFullLater' means that an earlier (big) store was
337 /// overwritten by a latter (smaller) store which doesn't write outside the big
338 /// store's memory locations. Returns 'OW_Unknown' if nothing can be determined.
339 static OverwriteResult isOverwrite(const MemoryLocation &Later,
340                                    const MemoryLocation &Earlier,
341                                    const DataLayout &DL,
342                                    const TargetLibraryInfo &TLI,
343                                    int64_t &EarlierOff, int64_t &LaterOff,
344                                    Instruction *DepWrite,
345                                    InstOverlapIntervalsTy &IOL,
346                                    AliasAnalysis &AA) {
347   // If we don't know the sizes of either access, then we can't do a comparison.
348   if (Later.Size == MemoryLocation::UnknownSize ||
349       Earlier.Size == MemoryLocation::UnknownSize)
350     return OW_Unknown;
351 
352   const Value *P1 = Earlier.Ptr->stripPointerCasts();
353   const Value *P2 = Later.Ptr->stripPointerCasts();
354 
355   // If the start pointers are the same, we just have to compare sizes to see if
356   // the later store was larger than the earlier store.
357   if (P1 == P2 || AA.isMustAlias(P1, P2)) {
358     // Make sure that the Later size is >= the Earlier size.
359     if (Later.Size >= Earlier.Size)
360       return OW_Complete;
361   }
362 
363   // Check to see if the later store is to the entire object (either a global,
364   // an alloca, or a byval/inalloca argument).  If so, then it clearly
365   // overwrites any other store to the same object.
366   const Value *UO1 = GetUnderlyingObject(P1, DL),
367               *UO2 = GetUnderlyingObject(P2, DL);
368 
369   // If we can't resolve the same pointers to the same object, then we can't
370   // analyze them at all.
371   if (UO1 != UO2)
372     return OW_Unknown;
373 
374   // If the "Later" store is to a recognizable object, get its size.
375   uint64_t ObjectSize = getPointerSize(UO2, DL, TLI);
376   if (ObjectSize != MemoryLocation::UnknownSize)
377     if (ObjectSize == Later.Size && ObjectSize >= Earlier.Size)
378       return OW_Complete;
379 
380   // Okay, we have stores to two completely different pointers.  Try to
381   // decompose the pointer into a "base + constant_offset" form.  If the base
382   // pointers are equal, then we can reason about the two stores.
383   EarlierOff = 0;
384   LaterOff = 0;
385   const Value *BP1 = GetPointerBaseWithConstantOffset(P1, EarlierOff, DL);
386   const Value *BP2 = GetPointerBaseWithConstantOffset(P2, LaterOff, DL);
387 
388   // If the base pointers still differ, we have two completely different stores.
389   if (BP1 != BP2)
390     return OW_Unknown;
391 
392   // The later store completely overlaps the earlier store if:
393   //
394   // 1. Both start at the same offset and the later one's size is greater than
395   //    or equal to the earlier one's, or
396   //
397   //      |--earlier--|
398   //      |--   later   --|
399   //
400   // 2. The earlier store has an offset greater than the later offset, but which
401   //    still lies completely within the later store.
402   //
403   //        |--earlier--|
404   //    |-----  later  ------|
405   //
406   // We have to be careful here as *Off is signed while *.Size is unsigned.
407   if (EarlierOff >= LaterOff &&
408       Later.Size >= Earlier.Size &&
409       uint64_t(EarlierOff - LaterOff) + Earlier.Size <= Later.Size)
410     return OW_Complete;
411 
412   // We may now overlap, although the overlap is not complete. There might also
413   // be other incomplete overlaps, and together, they might cover the complete
414   // earlier write.
415   // Note: The correctness of this logic depends on the fact that this function
416   // is not even called providing DepWrite when there are any intervening reads.
417   if (EnablePartialOverwriteTracking &&
418       LaterOff < int64_t(EarlierOff + Earlier.Size) &&
419       int64_t(LaterOff + Later.Size) >= EarlierOff) {
420 
421     // Insert our part of the overlap into the map.
422     auto &IM = IOL[DepWrite];
423     LLVM_DEBUG(dbgs() << "DSE: Partial overwrite: Earlier [" << EarlierOff
424                       << ", " << int64_t(EarlierOff + Earlier.Size)
425                       << ") Later [" << LaterOff << ", "
426                       << int64_t(LaterOff + Later.Size) << ")\n");
427 
428     // Make sure that we only insert non-overlapping intervals and combine
429     // adjacent intervals. The intervals are stored in the map with the ending
430     // offset as the key (in the half-open sense) and the starting offset as
431     // the value.
432     int64_t LaterIntStart = LaterOff, LaterIntEnd = LaterOff + Later.Size;
433 
434     // Find any intervals ending at, or after, LaterIntStart which start
435     // before LaterIntEnd.
436     auto ILI = IM.lower_bound(LaterIntStart);
437     if (ILI != IM.end() && ILI->second <= LaterIntEnd) {
438       // This existing interval is overlapped with the current store somewhere
439       // in [LaterIntStart, LaterIntEnd]. Merge them by erasing the existing
440       // intervals and adjusting our start and end.
441       LaterIntStart = std::min(LaterIntStart, ILI->second);
442       LaterIntEnd = std::max(LaterIntEnd, ILI->first);
443       ILI = IM.erase(ILI);
444 
445       // Continue erasing and adjusting our end in case other previous
446       // intervals are also overlapped with the current store.
447       //
448       // |--- ealier 1 ---|  |--- ealier 2 ---|
449       //     |------- later---------|
450       //
451       while (ILI != IM.end() && ILI->second <= LaterIntEnd) {
452         assert(ILI->second > LaterIntStart && "Unexpected interval");
453         LaterIntEnd = std::max(LaterIntEnd, ILI->first);
454         ILI = IM.erase(ILI);
455       }
456     }
457 
458     IM[LaterIntEnd] = LaterIntStart;
459 
460     ILI = IM.begin();
461     if (ILI->second <= EarlierOff &&
462         ILI->first >= int64_t(EarlierOff + Earlier.Size)) {
463       LLVM_DEBUG(dbgs() << "DSE: Full overwrite from partials: Earlier ["
464                         << EarlierOff << ", "
465                         << int64_t(EarlierOff + Earlier.Size)
466                         << ") Composite Later [" << ILI->second << ", "
467                         << ILI->first << ")\n");
468       ++NumCompletePartials;
469       return OW_Complete;
470     }
471   }
472 
473   // Check for an earlier store which writes to all the memory locations that
474   // the later store writes to.
475   if (EnablePartialStoreMerging && LaterOff >= EarlierOff &&
476       int64_t(EarlierOff + Earlier.Size) > LaterOff &&
477       uint64_t(LaterOff - EarlierOff) + Later.Size <= Earlier.Size) {
478     LLVM_DEBUG(dbgs() << "DSE: Partial overwrite an earlier load ["
479                       << EarlierOff << ", "
480                       << int64_t(EarlierOff + Earlier.Size)
481                       << ") by a later store [" << LaterOff << ", "
482                       << int64_t(LaterOff + Later.Size) << ")\n");
483     // TODO: Maybe come up with a better name?
484     return OW_PartialEarlierWithFullLater;
485   }
486 
487   // Another interesting case is if the later store overwrites the end of the
488   // earlier store.
489   //
490   //      |--earlier--|
491   //                |--   later   --|
492   //
493   // In this case we may want to trim the size of earlier to avoid generating
494   // writes to addresses which will definitely be overwritten later
495   if (!EnablePartialOverwriteTracking &&
496       (LaterOff > EarlierOff && LaterOff < int64_t(EarlierOff + Earlier.Size) &&
497        int64_t(LaterOff + Later.Size) >= int64_t(EarlierOff + Earlier.Size)))
498     return OW_End;
499 
500   // Finally, we also need to check if the later store overwrites the beginning
501   // of the earlier store.
502   //
503   //                |--earlier--|
504   //      |--   later   --|
505   //
506   // In this case we may want to move the destination address and trim the size
507   // of earlier to avoid generating writes to addresses which will definitely
508   // be overwritten later.
509   if (!EnablePartialOverwriteTracking &&
510       (LaterOff <= EarlierOff && int64_t(LaterOff + Later.Size) > EarlierOff)) {
511     assert(int64_t(LaterOff + Later.Size) <
512                int64_t(EarlierOff + Earlier.Size) &&
513            "Expect to be handled as OW_Complete");
514     return OW_Begin;
515   }
516   // Otherwise, they don't completely overlap.
517   return OW_Unknown;
518 }
519 
520 /// If 'Inst' might be a self read (i.e. a noop copy of a
521 /// memory region into an identical pointer) then it doesn't actually make its
522 /// input dead in the traditional sense.  Consider this case:
523 ///
524 ///   memmove(A <- B)
525 ///   memmove(A <- A)
526 ///
527 /// In this case, the second store to A does not make the first store to A dead.
528 /// The usual situation isn't an explicit A<-A store like this (which can be
529 /// trivially removed) but a case where two pointers may alias.
530 ///
531 /// This function detects when it is unsafe to remove a dependent instruction
532 /// because the DSE inducing instruction may be a self-read.
533 static bool isPossibleSelfRead(Instruction *Inst,
534                                const MemoryLocation &InstStoreLoc,
535                                Instruction *DepWrite,
536                                const TargetLibraryInfo &TLI,
537                                AliasAnalysis &AA) {
538   // Self reads can only happen for instructions that read memory.  Get the
539   // location read.
540   MemoryLocation InstReadLoc = getLocForRead(Inst, TLI);
541   if (!InstReadLoc.Ptr)
542     return false; // Not a reading instruction.
543 
544   // If the read and written loc obviously don't alias, it isn't a read.
545   if (AA.isNoAlias(InstReadLoc, InstStoreLoc))
546     return false;
547 
548   if (isa<AnyMemCpyInst>(Inst)) {
549     // LLVM's memcpy overlap semantics are not fully fleshed out (see PR11763)
550     // but in practice memcpy(A <- B) either means that A and B are disjoint or
551     // are equal (i.e. there are not partial overlaps).  Given that, if we have:
552     //
553     //   memcpy/memmove(A <- B)  // DepWrite
554     //   memcpy(A <- B)  // Inst
555     //
556     // with Inst reading/writing a >= size than DepWrite, we can reason as
557     // follows:
558     //
559     //   - If A == B then both the copies are no-ops, so the DepWrite can be
560     //     removed.
561     //   - If A != B then A and B are disjoint locations in Inst.  Since
562     //     Inst.size >= DepWrite.size A and B are disjoint in DepWrite too.
563     //     Therefore DepWrite can be removed.
564     MemoryLocation DepReadLoc = getLocForRead(DepWrite, TLI);
565 
566     if (DepReadLoc.Ptr && AA.isMustAlias(InstReadLoc.Ptr, DepReadLoc.Ptr))
567       return false;
568   }
569 
570   // If DepWrite doesn't read memory or if we can't prove it is a must alias,
571   // then it can't be considered dead.
572   return true;
573 }
574 
575 /// Returns true if the memory which is accessed by the second instruction is not
576 /// modified between the first and the second instruction.
577 /// Precondition: Second instruction must be dominated by the first
578 /// instruction.
579 static bool memoryIsNotModifiedBetween(Instruction *FirstI,
580                                        Instruction *SecondI,
581                                        AliasAnalysis *AA) {
582   SmallVector<BasicBlock *, 16> WorkList;
583   SmallPtrSet<BasicBlock *, 8> Visited;
584   BasicBlock::iterator FirstBBI(FirstI);
585   ++FirstBBI;
586   BasicBlock::iterator SecondBBI(SecondI);
587   BasicBlock *FirstBB = FirstI->getParent();
588   BasicBlock *SecondBB = SecondI->getParent();
589   MemoryLocation MemLoc = MemoryLocation::get(SecondI);
590 
591   // Start checking the store-block.
592   WorkList.push_back(SecondBB);
593   bool isFirstBlock = true;
594 
595   // Check all blocks going backward until we reach the load-block.
596   while (!WorkList.empty()) {
597     BasicBlock *B = WorkList.pop_back_val();
598 
599     // Ignore instructions before LI if this is the FirstBB.
600     BasicBlock::iterator BI = (B == FirstBB ? FirstBBI : B->begin());
601 
602     BasicBlock::iterator EI;
603     if (isFirstBlock) {
604       // Ignore instructions after SI if this is the first visit of SecondBB.
605       assert(B == SecondBB && "first block is not the store block");
606       EI = SecondBBI;
607       isFirstBlock = false;
608     } else {
609       // It's not SecondBB or (in case of a loop) the second visit of SecondBB.
610       // In this case we also have to look at instructions after SI.
611       EI = B->end();
612     }
613     for (; BI != EI; ++BI) {
614       Instruction *I = &*BI;
615       if (I->mayWriteToMemory() && I != SecondI)
616         if (isModSet(AA->getModRefInfo(I, MemLoc)))
617           return false;
618     }
619     if (B != FirstBB) {
620       assert(B != &FirstBB->getParent()->getEntryBlock() &&
621           "Should not hit the entry block because SI must be dominated by LI");
622       for (auto PredI = pred_begin(B), PE = pred_end(B); PredI != PE; ++PredI) {
623         if (!Visited.insert(*PredI).second)
624           continue;
625         WorkList.push_back(*PredI);
626       }
627     }
628   }
629   return true;
630 }
631 
632 /// Find all blocks that will unconditionally lead to the block BB and append
633 /// them to F.
634 static void findUnconditionalPreds(SmallVectorImpl<BasicBlock *> &Blocks,
635                                    BasicBlock *BB, DominatorTree *DT) {
636   for (pred_iterator I = pred_begin(BB), E = pred_end(BB); I != E; ++I) {
637     BasicBlock *Pred = *I;
638     if (Pred == BB) continue;
639     TerminatorInst *PredTI = Pred->getTerminator();
640     if (PredTI->getNumSuccessors() != 1)
641       continue;
642 
643     if (DT->isReachableFromEntry(Pred))
644       Blocks.push_back(Pred);
645   }
646 }
647 
648 /// Handle frees of entire structures whose dependency is a store
649 /// to a field of that structure.
650 static bool handleFree(CallInst *F, AliasAnalysis *AA,
651                        MemoryDependenceResults *MD, DominatorTree *DT,
652                        const TargetLibraryInfo *TLI,
653                        InstOverlapIntervalsTy &IOL,
654                        DenseMap<Instruction*, size_t> *InstrOrdering) {
655   bool MadeChange = false;
656 
657   MemoryLocation Loc = MemoryLocation(F->getOperand(0));
658   SmallVector<BasicBlock *, 16> Blocks;
659   Blocks.push_back(F->getParent());
660   const DataLayout &DL = F->getModule()->getDataLayout();
661 
662   while (!Blocks.empty()) {
663     BasicBlock *BB = Blocks.pop_back_val();
664     Instruction *InstPt = BB->getTerminator();
665     if (BB == F->getParent()) InstPt = F;
666 
667     MemDepResult Dep =
668         MD->getPointerDependencyFrom(Loc, false, InstPt->getIterator(), BB);
669     while (Dep.isDef() || Dep.isClobber()) {
670       Instruction *Dependency = Dep.getInst();
671       if (!hasAnalyzableMemoryWrite(Dependency, *TLI) ||
672           !isRemovable(Dependency))
673         break;
674 
675       Value *DepPointer =
676           GetUnderlyingObject(getStoredPointerOperand(Dependency), DL);
677 
678       // Check for aliasing.
679       if (!AA->isMustAlias(F->getArgOperand(0), DepPointer))
680         break;
681 
682       LLVM_DEBUG(
683           dbgs() << "DSE: Dead Store to soon to be freed memory:\n  DEAD: "
684                  << *Dependency << '\n');
685 
686       // DCE instructions only used to calculate that store.
687       BasicBlock::iterator BBI(Dependency);
688       deleteDeadInstruction(Dependency, &BBI, *MD, *TLI, IOL, InstrOrdering);
689       ++NumFastStores;
690       MadeChange = true;
691 
692       // Inst's old Dependency is now deleted. Compute the next dependency,
693       // which may also be dead, as in
694       //    s[0] = 0;
695       //    s[1] = 0; // This has just been deleted.
696       //    free(s);
697       Dep = MD->getPointerDependencyFrom(Loc, false, BBI, BB);
698     }
699 
700     if (Dep.isNonLocal())
701       findUnconditionalPreds(Blocks, BB, DT);
702   }
703 
704   return MadeChange;
705 }
706 
707 /// Check to see if the specified location may alias any of the stack objects in
708 /// the DeadStackObjects set. If so, they become live because the location is
709 /// being loaded.
710 static void removeAccessedObjects(const MemoryLocation &LoadedLoc,
711                                   SmallSetVector<Value *, 16> &DeadStackObjects,
712                                   const DataLayout &DL, AliasAnalysis *AA,
713                                   const TargetLibraryInfo *TLI) {
714   const Value *UnderlyingPointer = GetUnderlyingObject(LoadedLoc.Ptr, DL);
715 
716   // A constant can't be in the dead pointer set.
717   if (isa<Constant>(UnderlyingPointer))
718     return;
719 
720   // If the kill pointer can be easily reduced to an alloca, don't bother doing
721   // extraneous AA queries.
722   if (isa<AllocaInst>(UnderlyingPointer) || isa<Argument>(UnderlyingPointer)) {
723     DeadStackObjects.remove(const_cast<Value*>(UnderlyingPointer));
724     return;
725   }
726 
727   // Remove objects that could alias LoadedLoc.
728   DeadStackObjects.remove_if([&](Value *I) {
729     // See if the loaded location could alias the stack location.
730     MemoryLocation StackLoc(I, getPointerSize(I, DL, *TLI));
731     return !AA->isNoAlias(StackLoc, LoadedLoc);
732   });
733 }
734 
735 /// Remove dead stores to stack-allocated locations in the function end block.
736 /// Ex:
737 /// %A = alloca i32
738 /// ...
739 /// store i32 1, i32* %A
740 /// ret void
741 static bool handleEndBlock(BasicBlock &BB, AliasAnalysis *AA,
742                              MemoryDependenceResults *MD,
743                              const TargetLibraryInfo *TLI,
744                              InstOverlapIntervalsTy &IOL,
745                              DenseMap<Instruction*, size_t> *InstrOrdering) {
746   bool MadeChange = false;
747 
748   // Keep track of all of the stack objects that are dead at the end of the
749   // function.
750   SmallSetVector<Value*, 16> DeadStackObjects;
751 
752   // Find all of the alloca'd pointers in the entry block.
753   BasicBlock &Entry = BB.getParent()->front();
754   for (Instruction &I : Entry) {
755     if (isa<AllocaInst>(&I))
756       DeadStackObjects.insert(&I);
757 
758     // Okay, so these are dead heap objects, but if the pointer never escapes
759     // then it's leaked by this function anyways.
760     else if (isAllocLikeFn(&I, TLI) && !PointerMayBeCaptured(&I, true, true))
761       DeadStackObjects.insert(&I);
762   }
763 
764   // Treat byval or inalloca arguments the same, stores to them are dead at the
765   // end of the function.
766   for (Argument &AI : BB.getParent()->args())
767     if (AI.hasByValOrInAllocaAttr())
768       DeadStackObjects.insert(&AI);
769 
770   const DataLayout &DL = BB.getModule()->getDataLayout();
771 
772   // Scan the basic block backwards
773   for (BasicBlock::iterator BBI = BB.end(); BBI != BB.begin(); ){
774     --BBI;
775 
776     // If we find a store, check to see if it points into a dead stack value.
777     if (hasAnalyzableMemoryWrite(&*BBI, *TLI) && isRemovable(&*BBI)) {
778       // See through pointer-to-pointer bitcasts
779       SmallVector<Value *, 4> Pointers;
780       GetUnderlyingObjects(getStoredPointerOperand(&*BBI), Pointers, DL);
781 
782       // Stores to stack values are valid candidates for removal.
783       bool AllDead = true;
784       for (Value *Pointer : Pointers)
785         if (!DeadStackObjects.count(Pointer)) {
786           AllDead = false;
787           break;
788         }
789 
790       if (AllDead) {
791         Instruction *Dead = &*BBI;
792 
793         LLVM_DEBUG(dbgs() << "DSE: Dead Store at End of Block:\n  DEAD: "
794                           << *Dead << "\n  Objects: ";
795                    for (SmallVectorImpl<Value *>::iterator I = Pointers.begin(),
796                         E = Pointers.end();
797                         I != E; ++I) {
798                      dbgs() << **I;
799                      if (std::next(I) != E)
800                        dbgs() << ", ";
801                    } dbgs()
802                    << '\n');
803 
804         // DCE instructions only used to calculate that store.
805         deleteDeadInstruction(Dead, &BBI, *MD, *TLI, IOL, InstrOrdering, &DeadStackObjects);
806         ++NumFastStores;
807         MadeChange = true;
808         continue;
809       }
810     }
811 
812     // Remove any dead non-memory-mutating instructions.
813     if (isInstructionTriviallyDead(&*BBI, TLI)) {
814       LLVM_DEBUG(dbgs() << "DSE: Removing trivially dead instruction:\n  DEAD: "
815                         << *&*BBI << '\n');
816       deleteDeadInstruction(&*BBI, &BBI, *MD, *TLI, IOL, InstrOrdering, &DeadStackObjects);
817       ++NumFastOther;
818       MadeChange = true;
819       continue;
820     }
821 
822     if (isa<AllocaInst>(BBI)) {
823       // Remove allocas from the list of dead stack objects; there can't be
824       // any references before the definition.
825       DeadStackObjects.remove(&*BBI);
826       continue;
827     }
828 
829     if (auto CS = CallSite(&*BBI)) {
830       // Remove allocation function calls from the list of dead stack objects;
831       // there can't be any references before the definition.
832       if (isAllocLikeFn(&*BBI, TLI))
833         DeadStackObjects.remove(&*BBI);
834 
835       // If this call does not access memory, it can't be loading any of our
836       // pointers.
837       if (AA->doesNotAccessMemory(CS))
838         continue;
839 
840       // If the call might load from any of our allocas, then any store above
841       // the call is live.
842       DeadStackObjects.remove_if([&](Value *I) {
843         // See if the call site touches the value.
844         return isRefSet(AA->getModRefInfo(CS, I, getPointerSize(I, DL, *TLI)));
845       });
846 
847       // If all of the allocas were clobbered by the call then we're not going
848       // to find anything else to process.
849       if (DeadStackObjects.empty())
850         break;
851 
852       continue;
853     }
854 
855     // We can remove the dead stores, irrespective of the fence and its ordering
856     // (release/acquire/seq_cst). Fences only constraints the ordering of
857     // already visible stores, it does not make a store visible to other
858     // threads. So, skipping over a fence does not change a store from being
859     // dead.
860     if (isa<FenceInst>(*BBI))
861       continue;
862 
863     MemoryLocation LoadedLoc;
864 
865     // If we encounter a use of the pointer, it is no longer considered dead
866     if (LoadInst *L = dyn_cast<LoadInst>(BBI)) {
867       if (!L->isUnordered()) // Be conservative with atomic/volatile load
868         break;
869       LoadedLoc = MemoryLocation::get(L);
870     } else if (VAArgInst *V = dyn_cast<VAArgInst>(BBI)) {
871       LoadedLoc = MemoryLocation::get(V);
872     } else if (!BBI->mayReadFromMemory()) {
873       // Instruction doesn't read memory.  Note that stores that weren't removed
874       // above will hit this case.
875       continue;
876     } else {
877       // Unknown inst; assume it clobbers everything.
878       break;
879     }
880 
881     // Remove any allocas from the DeadPointer set that are loaded, as this
882     // makes any stores above the access live.
883     removeAccessedObjects(LoadedLoc, DeadStackObjects, DL, AA, TLI);
884 
885     // If all of the allocas were clobbered by the access then we're not going
886     // to find anything else to process.
887     if (DeadStackObjects.empty())
888       break;
889   }
890 
891   return MadeChange;
892 }
893 
894 static bool tryToShorten(Instruction *EarlierWrite, int64_t &EarlierOffset,
895                          int64_t &EarlierSize, int64_t LaterOffset,
896                          int64_t LaterSize, bool IsOverwriteEnd) {
897   // TODO: base this on the target vector size so that if the earlier
898   // store was too small to get vector writes anyway then its likely
899   // a good idea to shorten it
900   // Power of 2 vector writes are probably always a bad idea to optimize
901   // as any store/memset/memcpy is likely using vector instructions so
902   // shortening it to not vector size is likely to be slower
903   auto *EarlierIntrinsic = cast<AnyMemIntrinsic>(EarlierWrite);
904   unsigned EarlierWriteAlign = EarlierIntrinsic->getDestAlignment();
905   if (!IsOverwriteEnd)
906     LaterOffset = int64_t(LaterOffset + LaterSize);
907 
908   if (!(isPowerOf2_64(LaterOffset) && EarlierWriteAlign <= LaterOffset) &&
909       !((EarlierWriteAlign != 0) && LaterOffset % EarlierWriteAlign == 0))
910     return false;
911 
912   int64_t NewLength = IsOverwriteEnd
913                           ? LaterOffset - EarlierOffset
914                           : EarlierSize - (LaterOffset - EarlierOffset);
915 
916   if (auto *AMI = dyn_cast<AtomicMemIntrinsic>(EarlierWrite)) {
917     // When shortening an atomic memory intrinsic, the newly shortened
918     // length must remain an integer multiple of the element size.
919     const uint32_t ElementSize = AMI->getElementSizeInBytes();
920     if (0 != NewLength % ElementSize)
921       return false;
922   }
923 
924   LLVM_DEBUG(dbgs() << "DSE: Remove Dead Store:\n  OW "
925                     << (IsOverwriteEnd ? "END" : "BEGIN") << ": "
926                     << *EarlierWrite << "\n  KILLER (offset " << LaterOffset
927                     << ", " << EarlierSize << ")\n");
928 
929   Value *EarlierWriteLength = EarlierIntrinsic->getLength();
930   Value *TrimmedLength =
931       ConstantInt::get(EarlierWriteLength->getType(), NewLength);
932   EarlierIntrinsic->setLength(TrimmedLength);
933 
934   EarlierSize = NewLength;
935   if (!IsOverwriteEnd) {
936     int64_t OffsetMoved = (LaterOffset - EarlierOffset);
937     Value *Indices[1] = {
938         ConstantInt::get(EarlierWriteLength->getType(), OffsetMoved)};
939     GetElementPtrInst *NewDestGEP = GetElementPtrInst::CreateInBounds(
940         EarlierIntrinsic->getRawDest(), Indices, "", EarlierWrite);
941     EarlierIntrinsic->setDest(NewDestGEP);
942     EarlierOffset = EarlierOffset + OffsetMoved;
943   }
944   return true;
945 }
946 
947 static bool tryToShortenEnd(Instruction *EarlierWrite,
948                             OverlapIntervalsTy &IntervalMap,
949                             int64_t &EarlierStart, int64_t &EarlierSize) {
950   if (IntervalMap.empty() || !isShortenableAtTheEnd(EarlierWrite))
951     return false;
952 
953   OverlapIntervalsTy::iterator OII = --IntervalMap.end();
954   int64_t LaterStart = OII->second;
955   int64_t LaterSize = OII->first - LaterStart;
956 
957   if (LaterStart > EarlierStart && LaterStart < EarlierStart + EarlierSize &&
958       LaterStart + LaterSize >= EarlierStart + EarlierSize) {
959     if (tryToShorten(EarlierWrite, EarlierStart, EarlierSize, LaterStart,
960                      LaterSize, true)) {
961       IntervalMap.erase(OII);
962       return true;
963     }
964   }
965   return false;
966 }
967 
968 static bool tryToShortenBegin(Instruction *EarlierWrite,
969                               OverlapIntervalsTy &IntervalMap,
970                               int64_t &EarlierStart, int64_t &EarlierSize) {
971   if (IntervalMap.empty() || !isShortenableAtTheBeginning(EarlierWrite))
972     return false;
973 
974   OverlapIntervalsTy::iterator OII = IntervalMap.begin();
975   int64_t LaterStart = OII->second;
976   int64_t LaterSize = OII->first - LaterStart;
977 
978   if (LaterStart <= EarlierStart && LaterStart + LaterSize > EarlierStart) {
979     assert(LaterStart + LaterSize < EarlierStart + EarlierSize &&
980            "Should have been handled as OW_Complete");
981     if (tryToShorten(EarlierWrite, EarlierStart, EarlierSize, LaterStart,
982                      LaterSize, false)) {
983       IntervalMap.erase(OII);
984       return true;
985     }
986   }
987   return false;
988 }
989 
990 static bool removePartiallyOverlappedStores(AliasAnalysis *AA,
991                                             const DataLayout &DL,
992                                             InstOverlapIntervalsTy &IOL) {
993   bool Changed = false;
994   for (auto OI : IOL) {
995     Instruction *EarlierWrite = OI.first;
996     MemoryLocation Loc = getLocForWrite(EarlierWrite);
997     assert(isRemovable(EarlierWrite) && "Expect only removable instruction");
998     assert(Loc.Size != MemoryLocation::UnknownSize && "Unexpected mem loc");
999 
1000     const Value *Ptr = Loc.Ptr->stripPointerCasts();
1001     int64_t EarlierStart = 0;
1002     int64_t EarlierSize = int64_t(Loc.Size);
1003     GetPointerBaseWithConstantOffset(Ptr, EarlierStart, DL);
1004     OverlapIntervalsTy &IntervalMap = OI.second;
1005     Changed |=
1006         tryToShortenEnd(EarlierWrite, IntervalMap, EarlierStart, EarlierSize);
1007     if (IntervalMap.empty())
1008       continue;
1009     Changed |=
1010         tryToShortenBegin(EarlierWrite, IntervalMap, EarlierStart, EarlierSize);
1011   }
1012   return Changed;
1013 }
1014 
1015 static bool eliminateNoopStore(Instruction *Inst, BasicBlock::iterator &BBI,
1016                                AliasAnalysis *AA, MemoryDependenceResults *MD,
1017                                const DataLayout &DL,
1018                                const TargetLibraryInfo *TLI,
1019                                InstOverlapIntervalsTy &IOL,
1020                                DenseMap<Instruction*, size_t> *InstrOrdering) {
1021   // Must be a store instruction.
1022   StoreInst *SI = dyn_cast<StoreInst>(Inst);
1023   if (!SI)
1024     return false;
1025 
1026   // If we're storing the same value back to a pointer that we just loaded from,
1027   // then the store can be removed.
1028   if (LoadInst *DepLoad = dyn_cast<LoadInst>(SI->getValueOperand())) {
1029     if (SI->getPointerOperand() == DepLoad->getPointerOperand() &&
1030         isRemovable(SI) && memoryIsNotModifiedBetween(DepLoad, SI, AA)) {
1031 
1032       LLVM_DEBUG(
1033           dbgs() << "DSE: Remove Store Of Load from same pointer:\n  LOAD: "
1034                  << *DepLoad << "\n  STORE: " << *SI << '\n');
1035 
1036       deleteDeadInstruction(SI, &BBI, *MD, *TLI, IOL, InstrOrdering);
1037       ++NumRedundantStores;
1038       return true;
1039     }
1040   }
1041 
1042   // Remove null stores into the calloc'ed objects
1043   Constant *StoredConstant = dyn_cast<Constant>(SI->getValueOperand());
1044   if (StoredConstant && StoredConstant->isNullValue() && isRemovable(SI)) {
1045     Instruction *UnderlyingPointer =
1046         dyn_cast<Instruction>(GetUnderlyingObject(SI->getPointerOperand(), DL));
1047 
1048     if (UnderlyingPointer && isCallocLikeFn(UnderlyingPointer, TLI) &&
1049         memoryIsNotModifiedBetween(UnderlyingPointer, SI, AA)) {
1050       LLVM_DEBUG(
1051           dbgs() << "DSE: Remove null store to the calloc'ed object:\n  DEAD: "
1052                  << *Inst << "\n  OBJECT: " << *UnderlyingPointer << '\n');
1053 
1054       deleteDeadInstruction(SI, &BBI, *MD, *TLI, IOL, InstrOrdering);
1055       ++NumRedundantStores;
1056       return true;
1057     }
1058   }
1059   return false;
1060 }
1061 
1062 static bool eliminateDeadStores(BasicBlock &BB, AliasAnalysis *AA,
1063                                 MemoryDependenceResults *MD, DominatorTree *DT,
1064                                 const TargetLibraryInfo *TLI) {
1065   const DataLayout &DL = BB.getModule()->getDataLayout();
1066   bool MadeChange = false;
1067 
1068   // FIXME: Maybe change this to use some abstraction like OrderedBasicBlock?
1069   // The current OrderedBasicBlock can't deal with mutation at the moment.
1070   size_t LastThrowingInstIndex = 0;
1071   DenseMap<Instruction*, size_t> InstrOrdering;
1072   size_t InstrIndex = 1;
1073 
1074   // A map of interval maps representing partially-overwritten value parts.
1075   InstOverlapIntervalsTy IOL;
1076 
1077   // Do a top-down walk on the BB.
1078   for (BasicBlock::iterator BBI = BB.begin(), BBE = BB.end(); BBI != BBE; ) {
1079     // Handle 'free' calls specially.
1080     if (CallInst *F = isFreeCall(&*BBI, TLI)) {
1081       MadeChange |= handleFree(F, AA, MD, DT, TLI, IOL, &InstrOrdering);
1082       // Increment BBI after handleFree has potentially deleted instructions.
1083       // This ensures we maintain a valid iterator.
1084       ++BBI;
1085       continue;
1086     }
1087 
1088     Instruction *Inst = &*BBI++;
1089 
1090     size_t CurInstNumber = InstrIndex++;
1091     InstrOrdering.insert(std::make_pair(Inst, CurInstNumber));
1092     if (Inst->mayThrow()) {
1093       LastThrowingInstIndex = CurInstNumber;
1094       continue;
1095     }
1096 
1097     // Check to see if Inst writes to memory.  If not, continue.
1098     if (!hasAnalyzableMemoryWrite(Inst, *TLI))
1099       continue;
1100 
1101     // eliminateNoopStore will update in iterator, if necessary.
1102     if (eliminateNoopStore(Inst, BBI, AA, MD, DL, TLI, IOL, &InstrOrdering)) {
1103       MadeChange = true;
1104       continue;
1105     }
1106 
1107     // If we find something that writes memory, get its memory dependence.
1108     MemDepResult InstDep = MD->getDependency(Inst);
1109 
1110     // Ignore any store where we can't find a local dependence.
1111     // FIXME: cross-block DSE would be fun. :)
1112     if (!InstDep.isDef() && !InstDep.isClobber())
1113       continue;
1114 
1115     // Figure out what location is being stored to.
1116     MemoryLocation Loc = getLocForWrite(Inst);
1117 
1118     // If we didn't get a useful location, fail.
1119     if (!Loc.Ptr)
1120       continue;
1121 
1122     // Loop until we find a store we can eliminate or a load that
1123     // invalidates the analysis. Without an upper bound on the number of
1124     // instructions examined, this analysis can become very time-consuming.
1125     // However, the potential gain diminishes as we process more instructions
1126     // without eliminating any of them. Therefore, we limit the number of
1127     // instructions we look at.
1128     auto Limit = MD->getDefaultBlockScanLimit();
1129     while (InstDep.isDef() || InstDep.isClobber()) {
1130       // Get the memory clobbered by the instruction we depend on.  MemDep will
1131       // skip any instructions that 'Loc' clearly doesn't interact with.  If we
1132       // end up depending on a may- or must-aliased load, then we can't optimize
1133       // away the store and we bail out.  However, if we depend on something
1134       // that overwrites the memory location we *can* potentially optimize it.
1135       //
1136       // Find out what memory location the dependent instruction stores.
1137       Instruction *DepWrite = InstDep.getInst();
1138       if (!hasAnalyzableMemoryWrite(DepWrite, *TLI))
1139         break;
1140       MemoryLocation DepLoc = getLocForWrite(DepWrite);
1141       // If we didn't get a useful location, or if it isn't a size, bail out.
1142       if (!DepLoc.Ptr)
1143         break;
1144 
1145       // Make sure we don't look past a call which might throw. This is an
1146       // issue because MemoryDependenceAnalysis works in the wrong direction:
1147       // it finds instructions which dominate the current instruction, rather than
1148       // instructions which are post-dominated by the current instruction.
1149       //
1150       // If the underlying object is a non-escaping memory allocation, any store
1151       // to it is dead along the unwind edge. Otherwise, we need to preserve
1152       // the store.
1153       size_t DepIndex = InstrOrdering.lookup(DepWrite);
1154       assert(DepIndex && "Unexpected instruction");
1155       if (DepIndex <= LastThrowingInstIndex) {
1156         const Value* Underlying = GetUnderlyingObject(DepLoc.Ptr, DL);
1157         bool IsStoreDeadOnUnwind = isa<AllocaInst>(Underlying);
1158         if (!IsStoreDeadOnUnwind) {
1159             // We're looking for a call to an allocation function
1160             // where the allocation doesn't escape before the last
1161             // throwing instruction; PointerMayBeCaptured
1162             // reasonably fast approximation.
1163             IsStoreDeadOnUnwind = isAllocLikeFn(Underlying, TLI) &&
1164                 !PointerMayBeCaptured(Underlying, false, true);
1165         }
1166         if (!IsStoreDeadOnUnwind)
1167           break;
1168       }
1169 
1170       // If we find a write that is a) removable (i.e., non-volatile), b) is
1171       // completely obliterated by the store to 'Loc', and c) which we know that
1172       // 'Inst' doesn't load from, then we can remove it.
1173       // Also try to merge two stores if a later one only touches memory written
1174       // to by the earlier one.
1175       if (isRemovable(DepWrite) &&
1176           !isPossibleSelfRead(Inst, Loc, DepWrite, *TLI, *AA)) {
1177         int64_t InstWriteOffset, DepWriteOffset;
1178         OverwriteResult OR = isOverwrite(Loc, DepLoc, DL, *TLI, DepWriteOffset,
1179                                          InstWriteOffset, DepWrite, IOL, *AA);
1180         if (OR == OW_Complete) {
1181           LLVM_DEBUG(dbgs() << "DSE: Remove Dead Store:\n  DEAD: " << *DepWrite
1182                             << "\n  KILLER: " << *Inst << '\n');
1183 
1184           // Delete the store and now-dead instructions that feed it.
1185           deleteDeadInstruction(DepWrite, &BBI, *MD, *TLI, IOL, &InstrOrdering);
1186           ++NumFastStores;
1187           MadeChange = true;
1188 
1189           // We erased DepWrite; start over.
1190           InstDep = MD->getDependency(Inst);
1191           continue;
1192         } else if ((OR == OW_End && isShortenableAtTheEnd(DepWrite)) ||
1193                    ((OR == OW_Begin &&
1194                      isShortenableAtTheBeginning(DepWrite)))) {
1195           assert(!EnablePartialOverwriteTracking && "Do not expect to perform "
1196                                                     "when partial-overwrite "
1197                                                     "tracking is enabled");
1198           int64_t EarlierSize = DepLoc.Size;
1199           int64_t LaterSize = Loc.Size;
1200           bool IsOverwriteEnd = (OR == OW_End);
1201           MadeChange |= tryToShorten(DepWrite, DepWriteOffset, EarlierSize,
1202                                     InstWriteOffset, LaterSize, IsOverwriteEnd);
1203         } else if (EnablePartialStoreMerging &&
1204                    OR == OW_PartialEarlierWithFullLater) {
1205           auto *Earlier = dyn_cast<StoreInst>(DepWrite);
1206           auto *Later = dyn_cast<StoreInst>(Inst);
1207           if (Earlier && isa<ConstantInt>(Earlier->getValueOperand()) &&
1208               Later && isa<ConstantInt>(Later->getValueOperand()) &&
1209               memoryIsNotModifiedBetween(Earlier, Later, AA)) {
1210             // If the store we find is:
1211             //   a) partially overwritten by the store to 'Loc'
1212             //   b) the later store is fully contained in the earlier one and
1213             //   c) they both have a constant value
1214             // Merge the two stores, replacing the earlier store's value with a
1215             // merge of both values.
1216             // TODO: Deal with other constant types (vectors, etc), and probably
1217             // some mem intrinsics (if needed)
1218 
1219             APInt EarlierValue =
1220                 cast<ConstantInt>(Earlier->getValueOperand())->getValue();
1221             APInt LaterValue =
1222                 cast<ConstantInt>(Later->getValueOperand())->getValue();
1223             unsigned LaterBits = LaterValue.getBitWidth();
1224             assert(EarlierValue.getBitWidth() > LaterValue.getBitWidth());
1225             LaterValue = LaterValue.zext(EarlierValue.getBitWidth());
1226 
1227             // Offset of the smaller store inside the larger store
1228             unsigned BitOffsetDiff = (InstWriteOffset - DepWriteOffset) * 8;
1229             unsigned LShiftAmount =
1230                 DL.isBigEndian()
1231                     ? EarlierValue.getBitWidth() - BitOffsetDiff - LaterBits
1232                     : BitOffsetDiff;
1233             APInt Mask =
1234                 APInt::getBitsSet(EarlierValue.getBitWidth(), LShiftAmount,
1235                                   LShiftAmount + LaterBits);
1236             // Clear the bits we'll be replacing, then OR with the smaller
1237             // store, shifted appropriately.
1238             APInt Merged =
1239                 (EarlierValue & ~Mask) | (LaterValue << LShiftAmount);
1240             LLVM_DEBUG(dbgs() << "DSE: Merge Stores:\n  Earlier: " << *DepWrite
1241                               << "\n  Later: " << *Inst
1242                               << "\n  Merged Value: " << Merged << '\n');
1243 
1244             auto *SI = new StoreInst(
1245                 ConstantInt::get(Earlier->getValueOperand()->getType(), Merged),
1246                 Earlier->getPointerOperand(), false, Earlier->getAlignment(),
1247                 Earlier->getOrdering(), Earlier->getSyncScopeID(), DepWrite);
1248 
1249             unsigned MDToKeep[] = {LLVMContext::MD_dbg, LLVMContext::MD_tbaa,
1250                                    LLVMContext::MD_alias_scope,
1251                                    LLVMContext::MD_noalias,
1252                                    LLVMContext::MD_nontemporal};
1253             SI->copyMetadata(*DepWrite, MDToKeep);
1254             ++NumModifiedStores;
1255 
1256             // Remove earlier, wider, store
1257             size_t Idx = InstrOrdering.lookup(DepWrite);
1258             InstrOrdering.erase(DepWrite);
1259             InstrOrdering.insert(std::make_pair(SI, Idx));
1260 
1261             // Delete the old stores and now-dead instructions that feed them.
1262             deleteDeadInstruction(Inst, &BBI, *MD, *TLI, IOL, &InstrOrdering);
1263             deleteDeadInstruction(DepWrite, &BBI, *MD, *TLI, IOL,
1264                                   &InstrOrdering);
1265             MadeChange = true;
1266 
1267             // We erased DepWrite and Inst (Loc); start over.
1268             break;
1269           }
1270         }
1271       }
1272 
1273       // If this is a may-aliased store that is clobbering the store value, we
1274       // can keep searching past it for another must-aliased pointer that stores
1275       // to the same location.  For example, in:
1276       //   store -> P
1277       //   store -> Q
1278       //   store -> P
1279       // we can remove the first store to P even though we don't know if P and Q
1280       // alias.
1281       if (DepWrite == &BB.front()) break;
1282 
1283       // Can't look past this instruction if it might read 'Loc'.
1284       if (isRefSet(AA->getModRefInfo(DepWrite, Loc)))
1285         break;
1286 
1287       InstDep = MD->getPointerDependencyFrom(Loc, /*isLoad=*/ false,
1288                                              DepWrite->getIterator(), &BB,
1289                                              /*QueryInst=*/ nullptr, &Limit);
1290     }
1291   }
1292 
1293   if (EnablePartialOverwriteTracking)
1294     MadeChange |= removePartiallyOverlappedStores(AA, DL, IOL);
1295 
1296   // If this block ends in a return, unwind, or unreachable, all allocas are
1297   // dead at its end, which means stores to them are also dead.
1298   if (BB.getTerminator()->getNumSuccessors() == 0)
1299     MadeChange |= handleEndBlock(BB, AA, MD, TLI, IOL, &InstrOrdering);
1300 
1301   return MadeChange;
1302 }
1303 
1304 static bool eliminateDeadStores(Function &F, AliasAnalysis *AA,
1305                                 MemoryDependenceResults *MD, DominatorTree *DT,
1306                                 const TargetLibraryInfo *TLI) {
1307   bool MadeChange = false;
1308   for (BasicBlock &BB : F)
1309     // Only check non-dead blocks.  Dead blocks may have strange pointer
1310     // cycles that will confuse alias analysis.
1311     if (DT->isReachableFromEntry(&BB))
1312       MadeChange |= eliminateDeadStores(BB, AA, MD, DT, TLI);
1313 
1314   return MadeChange;
1315 }
1316 
1317 //===----------------------------------------------------------------------===//
1318 // DSE Pass
1319 //===----------------------------------------------------------------------===//
1320 PreservedAnalyses DSEPass::run(Function &F, FunctionAnalysisManager &AM) {
1321   AliasAnalysis *AA = &AM.getResult<AAManager>(F);
1322   DominatorTree *DT = &AM.getResult<DominatorTreeAnalysis>(F);
1323   MemoryDependenceResults *MD = &AM.getResult<MemoryDependenceAnalysis>(F);
1324   const TargetLibraryInfo *TLI = &AM.getResult<TargetLibraryAnalysis>(F);
1325 
1326   if (!eliminateDeadStores(F, AA, MD, DT, TLI))
1327     return PreservedAnalyses::all();
1328 
1329   PreservedAnalyses PA;
1330   PA.preserveSet<CFGAnalyses>();
1331   PA.preserve<GlobalsAA>();
1332   PA.preserve<MemoryDependenceAnalysis>();
1333   return PA;
1334 }
1335 
1336 namespace {
1337 
1338 /// A legacy pass for the legacy pass manager that wraps \c DSEPass.
1339 class DSELegacyPass : public FunctionPass {
1340 public:
1341   static char ID; // Pass identification, replacement for typeid
1342 
1343   DSELegacyPass() : FunctionPass(ID) {
1344     initializeDSELegacyPassPass(*PassRegistry::getPassRegistry());
1345   }
1346 
1347   bool runOnFunction(Function &F) override {
1348     if (skipFunction(F))
1349       return false;
1350 
1351     DominatorTree *DT = &getAnalysis<DominatorTreeWrapperPass>().getDomTree();
1352     AliasAnalysis *AA = &getAnalysis<AAResultsWrapperPass>().getAAResults();
1353     MemoryDependenceResults *MD =
1354         &getAnalysis<MemoryDependenceWrapperPass>().getMemDep();
1355     const TargetLibraryInfo *TLI =
1356         &getAnalysis<TargetLibraryInfoWrapperPass>().getTLI();
1357 
1358     return eliminateDeadStores(F, AA, MD, DT, TLI);
1359   }
1360 
1361   void getAnalysisUsage(AnalysisUsage &AU) const override {
1362     AU.setPreservesCFG();
1363     AU.addRequired<DominatorTreeWrapperPass>();
1364     AU.addRequired<AAResultsWrapperPass>();
1365     AU.addRequired<MemoryDependenceWrapperPass>();
1366     AU.addRequired<TargetLibraryInfoWrapperPass>();
1367     AU.addPreserved<DominatorTreeWrapperPass>();
1368     AU.addPreserved<GlobalsAAWrapperPass>();
1369     AU.addPreserved<MemoryDependenceWrapperPass>();
1370   }
1371 };
1372 
1373 } // end anonymous namespace
1374 
1375 char DSELegacyPass::ID = 0;
1376 
1377 INITIALIZE_PASS_BEGIN(DSELegacyPass, "dse", "Dead Store Elimination", false,
1378                       false)
1379 INITIALIZE_PASS_DEPENDENCY(DominatorTreeWrapperPass)
1380 INITIALIZE_PASS_DEPENDENCY(AAResultsWrapperPass)
1381 INITIALIZE_PASS_DEPENDENCY(GlobalsAAWrapperPass)
1382 INITIALIZE_PASS_DEPENDENCY(MemoryDependenceWrapperPass)
1383 INITIALIZE_PASS_DEPENDENCY(TargetLibraryInfoWrapperPass)
1384 INITIALIZE_PASS_END(DSELegacyPass, "dse", "Dead Store Elimination", false,
1385                     false)
1386 
1387 FunctionPass *llvm::createDeadStoreEliminationPass() {
1388   return new DSELegacyPass();
1389 }
1390