lib/CodeGen/LiveIntervalUnion.h

   1 //===-- LiveIntervalUnion.h - Live interval union data struct --*- C++ -*--===//
   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 // LiveIntervalUnion is a union of live segments across multiple live virtual
  11 // registers. This may be used during coalescing to represent a congruence
  12 // class, or during register allocation to model liveness of a physical
  13 // register.
  14 //
  15 //===----------------------------------------------------------------------===//
  16
  17 #ifndef LLVM_CODEGEN_LIVEINTERVALUNION
  18 #define LLVM_CODEGEN_LIVEINTERVALUNION
  19
  20 #include "llvm/CodeGen/LiveInterval.h"
  21 #include <vector>
  22 #include <set>
  23
  24 namespace llvm {
  25
  26 /// A LiveSegment is a copy of a LiveRange object used within
  27 /// LiveIntervalUnion. LiveSegment additionally contains a pointer to its
  28 /// original live virtual register (LiveInterval). This allows quick lookup of
  29 /// the live virtual register as we iterate over live segments in a union. Note
  30 /// that LiveRange is misnamed and actually represents only a single contiguous
  31 /// interval within a virtual register's liveness. To limit confusion, in this
  32 /// file we refer it as a live segment.
  33 ///
  34 /// Note: This currently represents a half-open interval [start,end).
  35 /// If LiveRange is modified to represent a closed interval, so should this.
  36 struct LiveSegment {
  37   SlotIndex start;
  38   SlotIndex end;
  39   LiveInterval *liveVirtReg;
  40
  41   LiveSegment(SlotIndex s, SlotIndex e, LiveInterval &lvr)
  42     : start(s), end(e), liveVirtReg(&lvr) {}
  43
  44   bool operator==(const LiveSegment &ls) const {
  45     return start == ls.start && end == ls.end && liveVirtReg == ls.liveVirtReg;
  46   }
  47
  48   bool operator!=(const LiveSegment &ls) const {
  49     return !operator==(ls);
  50   }
  51
  52   // Order segments by starting point only--we expect them to be disjoint.
  53   bool operator<(const LiveSegment &ls) const { return start < ls.start; }
  54 };
  55
  56 inline bool operator<(SlotIndex V, const LiveSegment &ls) {
  57   return V < ls.start;
  58 }
  59
  60 inline bool operator<(const LiveSegment &ls, SlotIndex V) {
  61   return ls.start < V;
  62 }
  63
  64 /// Compare a live virtual register segment to a LiveIntervalUnion segment.
  65 inline bool overlap(const LiveRange &lvrSeg, const LiveSegment &liuSeg) {
  66   return lvrSeg.start < liuSeg.end && liuSeg.start < lvrSeg.end;
  67 }
  68
  69 /// Union of live intervals that are strong candidates for coalescing into a
  70 /// single register (either physical or virtual depending on the context).  We
  71 /// expect the constituent live intervals to be disjoint, although we may
  72 /// eventually make exceptions to handle value-based interference.
  73 class LiveIntervalUnion {
  74   // A set of live virtual register segments that supports fast insertion,
  75   // intersection, and removal.
  76   //
  77   // FIXME: std::set is a placeholder until we decide how to
  78   // efficiently represent it. Probably need to roll our own B-tree.
  79   typedef std::set<LiveSegment> LiveSegments;
  80
  81   // A set of live virtual registers. Elements have type LiveInterval, where
  82   // each element represents the liveness of a single live virtual register.
  83   // This is traditionally known as a live range, but we refer is as a live
  84   // virtual register to avoid confusing it with the misnamed LiveRange
  85   // class.
  86   typedef std::vector<LiveInterval*> LiveVirtRegs;
  87
  88 public:
  89   // SegmentIter can advance to the next segment ordered by starting position
  90   // which may belong to a different live virtual register. We also must be able
  91   // to reach the current segment's containing virtual register.
  92   typedef LiveSegments::iterator SegmentIter;
  93
  94   class InterferenceResult;
  95   class Query;
  96
  97 private:
  98   unsigned repReg_;        // representative register number
  99   LiveSegments segments_;  // union of virtual reg segements
 100   LiveVirtRegs lvrs_;      // set of live virtual regs in the union
 101
 102 public:
 103   // default ctor avoids placement new
 104   LiveIntervalUnion() : repReg_(0) {}
 105
 106   // Initialize the union by associating it with a representative register
 107   // number.
 108   void init(unsigned repReg) { repReg_ = repReg; }
 109
 110   // Iterate over all segments in the union of live virtual registers ordered
 111   // by their starting position.
 112   SegmentIter begin() { return segments_.begin(); }
 113   SegmentIter end() { return segments_.end(); }
 114
 115   // Add a live virtual register to this union and merge its segments.
 116   // Holds a nonconst reference to the LVR for later maniplution.
 117   void unify(LiveInterval &lvr);
 118
 119   // FIXME: needed by RegAllocGreedy
 120   //void extract(const LiveInterval &li);
 121
 122   /// Cache a single interference test result in the form of two intersecting
 123   /// segments. This allows efficiently iterating over the interferences. The
 124   /// iteration logic is handled by LiveIntervalUnion::Query which may
 125   /// filter interferences depending on the type of query.
 126   class InterferenceResult {
 127     friend class Query;
 128
 129     LiveInterval::iterator lvrSegI_; // current position in _lvr
 130     SegmentIter liuSegI_;            // current position in _liu
 131
 132     // Internal ctor.
 133     InterferenceResult(LiveInterval::iterator lvrSegI, SegmentIter liuSegI)
 134       : lvrSegI_(lvrSegI), liuSegI_(liuSegI) {}
 135
 136   public:
 137     // Public default ctor.
 138     InterferenceResult(): lvrSegI_(), liuSegI_() {}
 139
 140     // Note: this interface provides raw access to the iterators because the
 141     // result has no way to tell if it's valid to dereference them.
 142
 143     // Access the lvr segment.
 144     const LiveInterval::iterator &lvrSegPos() const { return lvrSegI_; }
 145
 146     // Access the liu segment.
 147     const SegmentIter &liuSeg() const { return liuSegI_; }
 148
 149     bool operator==(const InterferenceResult &ir) const {
 150       return lvrSegI_ == ir.lvrSegI_ && liuSegI_ == ir.liuSegI_;
 151     }
 152     bool operator!=(const InterferenceResult &ir) const {
 153       return !operator==(ir);
 154     }
 155   };
 156
 157   /// Query interferences between a single live virtual register and a live
 158   /// interval union.
 159   class Query {
 160     LiveIntervalUnion &liu_;
 161     LiveInterval &lvr_;
 162     InterferenceResult firstInterference_;
 163     // TBD: interfering vregs
 164
 165   public:
 166     Query(LiveInterval &lvr, LiveIntervalUnion &liu): liu_(liu), lvr_(lvr) {}
 167
 168     LiveInterval &lvr() const { return lvr_; }
 169
 170     bool isInterference(const InterferenceResult &ir) const {
 171       if (ir.lvrSegI_ != lvr_.end()) {
 172         assert(overlap(*ir.lvrSegI_, *ir.liuSegI_) &&
 173                "invalid segment iterators");
 174         return true;
 175       }
 176       return false;
 177     }
 178
 179     // Does this live virtual register interfere with the union.
 180     bool checkInterference() { return isInterference(firstInterference()); }
 181
 182     // First pair of interfering segments, or a noninterfering result.
 183     InterferenceResult firstInterference();
 184
 185     // Treat the result as an iterator and advance to the next interfering pair
 186     // of segments. Visiting each unique interfering pairs means that the same
 187     // lvr or liu segment may be visited multiple times.
 188     bool nextInterference(InterferenceResult &ir) const;
 189
 190     // TBD: bool collectInterferingVirtRegs(unsigned maxInterference)
 191
 192   private:
 193     // Private interface for queries
 194     void findIntersection(InterferenceResult &ir) const;
 195   };
 196 };
 197
 198 } // end namespace llvm
 199
 200 #endif // !defined(LLVM_CODEGEN_LIVEINTERVALUNION)