lib/CodeGen/LiveInterval.cpp

   1 //===-- LiveInterval.cpp - Live Interval Representation -------------------===//
   2 //
   3 //                     The LLVM Compiler Infrastructure
   4 //
   5 // This file was developed by the LLVM research group and is distributed under
   6 // the University of Illinois Open Source License. See LICENSE.TXT for details.
   7 //
   8 //===----------------------------------------------------------------------===//
   9 //
  10 // This file implements the LiveRange and LiveInterval classes.  Given some
  11 // numbering of each the machine instructions an interval [i, j) is said to be a
  12 // live interval for register v if there is no instruction with number j' > j
  13 // such that v is live at j' abd there is no instruction with number i' < i such
  14 // that v is live at i'. In this implementation intervals can have holes,
  15 // i.e. an interval might look like [1,20), [50,65), [1000,1001).  Each
  16 // individual range is represented as an instance of LiveRange, and the whole
  17 // interval is represented as an instance of LiveInterval.
  18 //
  19 //===----------------------------------------------------------------------===//
  20
  21 #include "llvm/CodeGen/LiveInterval.h"
  22 #include "llvm/ADT/STLExtras.h"
  23 #include "llvm/Support/Streams.h"
  24 #include "llvm/Target/MRegisterInfo.h"
  25 #include <algorithm>
  26 #include <map>
  27 #include <ostream>
  28 using namespace llvm;
  29
  30 // An example for liveAt():
  31 //
  32 // this = [1,4), liveAt(0) will return false. The instruction defining this
  33 // spans slots [0,3]. The interval belongs to an spilled definition of the
  34 // variable it represents. This is because slot 1 is used (def slot) and spans
  35 // up to slot 3 (store slot).
  36 //
  37 bool LiveInterval::liveAt(unsigned I) const {
  38   Ranges::const_iterator r = std::upper_bound(ranges.begin(), ranges.end(), I);
  39
  40   if (r == ranges.begin())
  41     return false;
  42
  43   --r;
  44   return r->contains(I);
  45 }
  46
  47 // overlaps - Return true if the intersection of the two live intervals is
  48 // not empty.
  49 //
  50 // An example for overlaps():
  51 //
  52 // 0: A = ...
  53 // 4: B = ...
  54 // 8: C = A + B ;; last use of A
  55 //
  56 // The live intervals should look like:
  57 //
  58 // A = [3, 11)
  59 // B = [7, x)
  60 // C = [11, y)
  61 //
  62 // A->overlaps(C) should return false since we want to be able to join
  63 // A and C.
  64 //
  65 bool LiveInterval::overlapsFrom(const LiveInterval& other,
  66                                 const_iterator StartPos) const {
  67   const_iterator i = begin();
  68   const_iterator ie = end();
  69   const_iterator j = StartPos;
  70   const_iterator je = other.end();
  71
  72   assert((StartPos->start <= i->start || StartPos == other.begin()) &&
  73          StartPos != other.end() && "Bogus start position hint!");
  74
  75   if (i->start < j->start) {
  76     i = std::upper_bound(i, ie, j->start);
  77     if (i != ranges.begin()) --i;
  78   } else if (j->start < i->start) {
  79     ++StartPos;
  80     if (StartPos != other.end() && StartPos->start <= i->start) {
  81       assert(StartPos < other.end() && i < end());
  82       j = std::upper_bound(j, je, i->start);
  83       if (j != other.ranges.begin()) --j;
  84     }
  85   } else {
  86     return true;
  87   }
  88
  89   if (j == je) return false;
  90
  91   while (i != ie) {
  92     if (i->start > j->start) {
  93       std::swap(i, j);
  94       std::swap(ie, je);
  95     }
  96
  97     if (i->end > j->start)
  98       return true;
  99     ++i;
 100   }
 101
 102   return false;
 103 }
 104
 105 /// extendIntervalEndTo - This method is used when we want to extend the range
 106 /// specified by I to end at the specified endpoint.  To do this, we should
 107 /// merge and eliminate all ranges that this will overlap with.  The iterator is
 108 /// not invalidated.
 109 void LiveInterval::extendIntervalEndTo(Ranges::iterator I, unsigned NewEnd) {
 110   assert(I != ranges.end() && "Not a valid interval!");
 111   unsigned ValId = I->ValId;
 112   unsigned OldEnd = I->end;
 113
 114   // Search for the first interval that we can't merge with.
 115   Ranges::iterator MergeTo = next(I);
 116   for (; MergeTo != ranges.end() && NewEnd >= MergeTo->end; ++MergeTo) {
 117     assert(MergeTo->ValId == ValId && "Cannot merge with differing values!");
 118   }
 119
 120   // If NewEnd was in the middle of an interval, make sure to get its endpoint.
 121   I->end = std::max(NewEnd, prior(MergeTo)->end);
 122
 123   // Erase any dead ranges.
 124   ranges.erase(next(I), MergeTo);
 125
 126   // Update kill info.
 127   removeKillForValNum(ValId, OldEnd, I->end-1);
 128
 129   // If the newly formed range now touches the range after it and if they have
 130   // the same value number, merge the two ranges into one range.
 131   Ranges::iterator Next = next(I);
 132   if (Next != ranges.end() && Next->start <= I->end && Next->ValId == ValId) {
 133     I->end = Next->end;
 134     ranges.erase(Next);
 135   }
 136 }
 137
 138
 139 /// extendIntervalStartTo - This method is used when we want to extend the range
 140 /// specified by I to start at the specified endpoint.  To do this, we should
 141 /// merge and eliminate all ranges that this will overlap with.
 142 LiveInterval::Ranges::iterator
 143 LiveInterval::extendIntervalStartTo(Ranges::iterator I, unsigned NewStart) {
 144   assert(I != ranges.end() && "Not a valid interval!");
 145   unsigned ValId = I->ValId;
 146
 147   // Search for the first interval that we can't merge with.
 148   Ranges::iterator MergeTo = I;
 149   do {
 150     if (MergeTo == ranges.begin()) {
 151       I->start = NewStart;
 152       ranges.erase(MergeTo, I);
 153       return I;
 154     }
 155     assert(MergeTo->ValId == ValId && "Cannot merge with differing values!");
 156     --MergeTo;
 157   } while (NewStart <= MergeTo->start);
 158
 159   // If we start in the middle of another interval, just delete a range and
 160   // extend that interval.
 161   if (MergeTo->end >= NewStart && MergeTo->ValId == ValId) {
 162     MergeTo->end = I->end;
 163   } else {
 164     // Otherwise, extend the interval right after.
 165     ++MergeTo;
 166     MergeTo->start = NewStart;
 167     MergeTo->end = I->end;
 168   }
 169
 170   ranges.erase(next(MergeTo), next(I));
 171   return MergeTo;
 172 }
 173
 174 LiveInterval::iterator
 175 LiveInterval::addRangeFrom(LiveRange LR, iterator From) {
 176   unsigned Start = LR.start, End = LR.end;
 177   iterator it = std::upper_bound(From, ranges.end(), Start);
 178
 179   // If the inserted interval starts in the middle or right at the end of
 180   // another interval, just extend that interval to contain the range of LR.
 181   if (it != ranges.begin()) {
 182     iterator B = prior(it);
 183     if (LR.ValId == B->ValId) {
 184       if (B->start <= Start && B->end >= Start) {
 185         extendIntervalEndTo(B, End);
 186         return B;
 187       }
 188     } else {
 189       // Check to make sure that we are not overlapping two live ranges with
 190       // different ValId's.
 191       assert(B->end <= Start &&
 192              "Cannot overlap two LiveRanges with differing ValID's"
 193              " (did you def the same reg twice in a MachineInstr?)");
 194     }
 195   }
 196
 197   // Otherwise, if this range ends in the middle of, or right next to, another
 198   // interval, merge it into that interval.
 199   if (it != ranges.end())
 200     if (LR.ValId == it->ValId) {
 201       if (it->start <= End) {
 202         it = extendIntervalStartTo(it, Start);
 203
 204         // If LR is a complete superset of an interval, we may need to grow its
 205         // endpoint as well.
 206         if (End > it->end)
 207           extendIntervalEndTo(it, End);
 208         return it;
 209       }
 210     } else {
 211       // Check to make sure that we are not overlapping two live ranges with
 212       // different ValId's.
 213       assert(it->start >= End &&
 214              "Cannot overlap two LiveRanges with differing ValID's");
 215     }
 216
 217   // Otherwise, this is just a new range that doesn't interact with anything.
 218   // Insert it.
 219   return ranges.insert(it, LR);
 220 }
 221
 222
 223 /// removeRange - Remove the specified range from this interval.  Note that
 224 /// the range must already be in this interval in its entirety.
 225 void LiveInterval::removeRange(unsigned Start, unsigned End) {
 226   // Find the LiveRange containing this span.
 227   Ranges::iterator I = std::upper_bound(ranges.begin(), ranges.end(), Start);
 228   assert(I != ranges.begin() && "Range is not in interval!");
 229   --I;
 230   assert(I->contains(Start) && I->contains(End-1) &&
 231          "Range is not entirely in interval!");
 232
 233   // If the span we are removing is at the start of the LiveRange, adjust it.
 234   if (I->start == Start) {
 235     if (I->end == End) {
 236       removeKillForValNum(I->ValId, Start, End);
 237       ranges.erase(I);  // Removed the whole LiveRange.
 238     } else
 239       I->start = End;
 240     return;
 241   }
 242
 243   // Otherwise if the span we are removing is at the end of the LiveRange,
 244   // adjust the other way.
 245   if (I->end == End) {
 246     removeKillForValNum(I->ValId, Start, End);
 247     I->end = Start;
 248     return;
 249   }
 250
 251   // Otherwise, we are splitting the LiveRange into two pieces.
 252   unsigned OldEnd = I->end;
 253   I->end = Start;   // Trim the old interval.
 254
 255   // Insert the new one.
 256   ranges.insert(next(I), LiveRange(End, OldEnd, I->ValId));
 257 }
 258
 259 /// getLiveRangeContaining - Return the live range that contains the
 260 /// specified index, or null if there is none.
 261 LiveInterval::const_iterator
 262 LiveInterval::FindLiveRangeContaining(unsigned Idx) const {
 263   const_iterator It = std::upper_bound(begin(), end(), Idx);
 264   if (It != ranges.begin()) {
 265     --It;
 266     if (It->contains(Idx))
 267       return It;
 268   }
 269
 270   return end();
 271 }
 272
 273 LiveInterval::iterator
 274 LiveInterval::FindLiveRangeContaining(unsigned Idx) {
 275   iterator It = std::upper_bound(begin(), end(), Idx);
 276   if (It != begin()) {
 277     --It;
 278     if (It->contains(Idx))
 279       return It;
 280   }
 281
 282   return end();
 283 }
 284
 285 /// join - Join two live intervals (this, and other) together.  This applies
 286 /// mappings to the value numbers in the LHS/RHS intervals as specified.  If
 287 /// the intervals are not joinable, this aborts.
 288 void LiveInterval::join(LiveInterval &Other, int *LHSValNoAssignments,
 289                         int *RHSValNoAssignments,
 290                         SmallVector<VNInfo, 16> &NewValueNumberInfo) {
 291
 292   // Try to do the least amount of work possible.  In particular, if there are
 293   // more liverange chunks in the other set than there are in the 'this' set,
 294   // swap sets to merge the fewest chunks in possible.
 295   //
 296   // Also, if one range is a physreg and one is a vreg, we always merge from the
 297   // vreg into the physreg, which leaves the vreg intervals pristine.
 298   if ((Other.ranges.size() > ranges.size() &&
 299       MRegisterInfo::isVirtualRegister(reg)) ||
 300       MRegisterInfo::isPhysicalRegister(Other.reg)) {
 301     swap(Other);
 302     std::swap(LHSValNoAssignments, RHSValNoAssignments);
 303   }
 304
 305   // Determine if any of our live range values are mapped.  This is uncommon, so
 306   // we want to avoid the interval scan if not.
 307   bool MustMapCurValNos = false;
 308   for (unsigned i = 0, e = getNumValNums(); i != e; ++i) {
 309     if (ValueNumberInfo[i].def == ~1U) continue;  // tombstone value #
 310     if (i != (unsigned)LHSValNoAssignments[i]) {
 311       MustMapCurValNos = true;
 312       break;
 313     }
 314   }
 315
 316   // If we have to apply a mapping to our base interval assignment, rewrite it
 317   // now.
 318   if (MustMapCurValNos) {
 319     // Map the first live range.
 320     iterator OutIt = begin();
 321     OutIt->ValId = LHSValNoAssignments[OutIt->ValId];
 322     ++OutIt;
 323     for (iterator I = OutIt, E = end(); I != E; ++I) {
 324       OutIt->ValId = LHSValNoAssignments[I->ValId];
 325
 326       // If this live range has the same value # as its immediate predecessor,
 327       // and if they are neighbors, remove one LiveRange.  This happens when we
 328       // have [0,3:0)[4,7:1) and map 0/1 onto the same value #.
 329       if (OutIt->ValId == (OutIt-1)->ValId && (OutIt-1)->end == OutIt->start) {
 330         (OutIt-1)->end = OutIt->end;
 331       } else {
 332         if (I != OutIt) {
 333           OutIt->start = I->start;
 334           OutIt->end = I->end;
 335         }
 336
 337         // Didn't merge, on to the next one.
 338         ++OutIt;
 339       }
 340     }
 341
 342     // If we merge some live ranges, chop off the end.
 343     ranges.erase(OutIt, end());
 344   }
 345
 346   // Update val# info first. Increasing live ranges may invalidate some kills.
 347   ValueNumberInfo.clear();
 348   ValueNumberInfo.append(NewValueNumberInfo.begin(), NewValueNumberInfo.end());
 349
 350   // Okay, now insert the RHS live ranges into the LHS.
 351   iterator InsertPos = begin();
 352   for (iterator I = Other.begin(), E = Other.end(); I != E; ++I) {
 353     // Map the ValId in the other live range to the current live range.
 354     I->ValId = RHSValNoAssignments[I->ValId];
 355     InsertPos = addRangeFrom(*I, InsertPos);
 356   }
 357
 358   weight += Other.weight;
 359   if (Other.preference && !preference)
 360     preference = Other.preference;
 361 }
 362
 363 /// MergeRangesInAsValue - Merge all of the intervals in RHS into this live
 364 /// interval as the specified value number.  The LiveRanges in RHS are
 365 /// allowed to overlap with LiveRanges in the current interval, but only if
 366 /// the overlapping LiveRanges have the specified value number.
 367 void LiveInterval::MergeRangesInAsValue(const LiveInterval &RHS,
 368                                         unsigned LHSValNo) {
 369   // TODO: Make this more efficient.
 370   iterator InsertPos = begin();
 371   for (const_iterator I = RHS.begin(), E = RHS.end(); I != E; ++I) {
 372     // Map the ValId in the other live range to the current live range.
 373     LiveRange Tmp = *I;
 374     Tmp.ValId = LHSValNo;
 375     InsertPos = addRangeFrom(Tmp, InsertPos);
 376   }
 377 }
 378
 379
 380 /// MergeInClobberRanges - For any live ranges that are not defined in the
 381 /// current interval, but are defined in the Clobbers interval, mark them
 382 /// used with an unknown definition value.
 383 void LiveInterval::MergeInClobberRanges(const LiveInterval &Clobbers) {
 384   if (Clobbers.begin() == Clobbers.end()) return;
 385
 386   // Find a value # to use for the clobber ranges.  If there is already a value#
 387   // for unknown values, use it.
 388   // FIXME: Use a single sentinal number for these!
 389   unsigned ClobberValNo = getNextValue(~0U, 0);
 390
 391   iterator IP = begin();
 392   for (const_iterator I = Clobbers.begin(), E = Clobbers.end(); I != E; ++I) {
 393     unsigned Start = I->start, End = I->end;
 394     IP = std::upper_bound(IP, end(), Start);
 395
 396     // If the start of this range overlaps with an existing liverange, trim it.
 397     if (IP != begin() && IP[-1].end > Start) {
 398       Start = IP[-1].end;
 399       // Trimmed away the whole range?
 400       if (Start >= End) continue;
 401     }
 402     // If the end of this range overlaps with an existing liverange, trim it.
 403     if (IP != end() && End > IP->start) {
 404       End = IP->start;
 405       // If this trimmed away the whole range, ignore it.
 406       if (Start == End) continue;
 407     }
 408
 409     // Insert the clobber interval.
 410     IP = addRangeFrom(LiveRange(Start, End, ClobberValNo), IP);
 411   }
 412 }
 413
 414 /// MergeValueNumberInto - This method is called when two value nubmers
 415 /// are found to be equivalent.  This eliminates V1, replacing all
 416 /// LiveRanges with the V1 value number with the V2 value number.  This can
 417 /// cause merging of V1/V2 values numbers and compaction of the value space.
 418 void LiveInterval::MergeValueNumberInto(unsigned V1, unsigned V2) {
 419   assert(V1 != V2 && "Identical value#'s are always equivalent!");
 420
 421   // This code actually merges the (numerically) larger value number into the
 422   // smaller value number, which is likely to allow us to compactify the value
 423   // space.  The only thing we have to be careful of is to preserve the
 424   // instruction that defines the result value.
 425
 426   // Make sure V2 is smaller than V1.
 427   if (V1 < V2) {
 428     copyValNumInfo(V1, V2);
 429     std::swap(V1, V2);
 430   }
 431
 432   // Merge V1 live ranges into V2.
 433   for (iterator I = begin(); I != end(); ) {
 434     iterator LR = I++;
 435     if (LR->ValId != V1) continue;  // Not a V1 LiveRange.
 436
 437     // Okay, we found a V1 live range.  If it had a previous, touching, V2 live
 438     // range, extend it.
 439     if (LR != begin()) {
 440       iterator Prev = LR-1;
 441       if (Prev->ValId == V2 && Prev->end == LR->start) {
 442         Prev->end = LR->end;
 443
 444         // Erase this live-range.
 445         ranges.erase(LR);
 446         I = Prev+1;
 447         LR = Prev;
 448       }
 449     }
 450
 451     // Okay, now we have a V1 or V2 live range that is maximally merged forward.
 452     // Ensure that it is a V2 live-range.
 453     LR->ValId = V2;
 454
 455     // If we can merge it into later V2 live ranges, do so now.  We ignore any
 456     // following V1 live ranges, as they will be merged in subsequent iterations
 457     // of the loop.
 458     if (I != end()) {
 459       if (I->start == LR->end && I->ValId == V2) {
 460         LR->end = I->end;
 461         ranges.erase(I);
 462         I = LR+1;
 463       }
 464     }
 465   }
 466
 467   // Now that V1 is dead, remove it.  If it is the largest value number, just
 468   // nuke it (and any other deleted values neighboring it), otherwise mark it as
 469   // ~1U so it can be nuked later.
 470   if (V1 == getNumValNums()-1) {
 471     do {
 472       ValueNumberInfo.pop_back();
 473     } while (ValueNumberInfo.back().def == ~1U);
 474   } else {
 475     ValueNumberInfo[V1].def = ~1U;
 476   }
 477 }
 478
 479 unsigned LiveInterval::getSize() const {
 480   unsigned Sum = 0;
 481   for (const_iterator I = begin(), E = end(); I != E; ++I)
 482     Sum += I->end - I->start;
 483   return Sum;
 484 }
 485
 486 std::ostream& llvm::operator<<(std::ostream& os, const LiveRange &LR) {
 487   return os << '[' << LR.start << ',' << LR.end << ':' << LR.ValId << ")";
 488 }
 489
 490 void LiveRange::dump() const {
 491   cerr << *this << "\n";
 492 }
 493
 494 void LiveInterval::print(std::ostream &OS, const MRegisterInfo *MRI) const {
 495   if (MRI && MRegisterInfo::isPhysicalRegister(reg))
 496     OS << MRI->getName(reg);
 497   else
 498     OS << "%reg" << reg;
 499
 500   OS << ',' << weight;
 501
 502   if (empty())
 503     OS << "EMPTY";
 504   else {
 505     OS << " = ";
 506     for (LiveInterval::Ranges::const_iterator I = ranges.begin(),
 507            E = ranges.end(); I != E; ++I)
 508     OS << *I;
 509   }
 510
 511   // Print value number info.
 512   if (getNumValNums()) {
 513     OS << "  ";
 514     for (unsigned i = 0; i != getNumValNums(); ++i) {
 515       if (i) OS << " ";
 516       OS << i << "@";
 517       if (ValueNumberInfo[i].def == ~1U) {
 518         OS << "x";
 519       } else {
 520         if (ValueNumberInfo[i].def == ~0U)
 521           OS << "?";
 522         else
 523           OS << ValueNumberInfo[i].def;
 524         unsigned e = ValueNumberInfo[i].kills.size();
 525         if (e) {
 526           OS << "-(";
 527           for (unsigned j = 0; j != e; ++j) {
 528             OS << ValueNumberInfo[i].kills[j];
 529             if (j != e-1)
 530               OS << " ";
 531           }
 532           OS << ")";
 533         }
 534       }
 535     }
 536   }
 537 }
 538
 539 void LiveInterval::dump() const {
 540   cerr << *this << "\n";
 541 }
 542
 543
 544 void LiveRange::print(std::ostream &os) const {
 545   os << *this;
 546 }