LLVM 20.0.0git
LiveIntervalUnion.h
Go to the documentation of this file.
1//===- LiveIntervalUnion.h - Live interval union data struct ---*- C++ -*--===//
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// LiveIntervalUnion is a union of live segments across multiple live virtual
10// registers. This may be used during coalescing to represent a congruence
11// class, or during register allocation to model liveness of a physical
12// register.
13//
14//===----------------------------------------------------------------------===//
15
16#ifndef LLVM_CODEGEN_LIVEINTERVALUNION_H
17#define LLVM_CODEGEN_LIVEINTERVALUNION_H
18
23#include <cassert>
24#include <limits>
25
26namespace llvm {
27
28class raw_ostream;
29class TargetRegisterInfo;
30
31#ifndef NDEBUG
32// forward declaration
33template <unsigned Element> class SparseBitVector;
34
36#endif
37
38/// Union of live intervals that are strong candidates for coalescing into a
39/// single register (either physical or virtual depending on the context). We
40/// expect the constituent live intervals to be disjoint, although we may
41/// eventually make exceptions to handle value-based interference.
43 // A set of live virtual register segments that supports fast insertion,
44 // intersection, and removal.
45 // Mapping SlotIndex intervals to virtual register numbers.
47
48public:
49 // SegmentIter can advance to the next segment ordered by starting position
50 // which may belong to a different live virtual register. We also must be able
51 // to reach the current segment's containing virtual register.
53
54 /// Const version of SegmentIter.
56
57 // LiveIntervalUnions share an external allocator.
59
60private:
61 unsigned Tag = 0; // unique tag for current contents.
62 LiveSegments Segments; // union of virtual reg segments
63
64public:
65 explicit LiveIntervalUnion(Allocator &a) : Segments(a) {}
66
67 // Iterate over all segments in the union of live virtual registers ordered
68 // by their starting position.
69 SegmentIter begin() { return Segments.begin(); }
70 SegmentIter end() { return Segments.end(); }
71 SegmentIter find(SlotIndex x) { return Segments.find(x); }
72 ConstSegmentIter begin() const { return Segments.begin(); }
73 ConstSegmentIter end() const { return Segments.end(); }
74 ConstSegmentIter find(SlotIndex x) const { return Segments.find(x); }
75
76 bool empty() const { return Segments.empty(); }
77 SlotIndex startIndex() const { return Segments.start(); }
78 SlotIndex endIndex() const { return Segments.stop(); }
79
80 // Provide public access to the underlying map to allow overlap iteration.
82 const Map &getMap() const { return Segments; }
83
84 /// getTag - Return an opaque tag representing the current state of the union.
85 unsigned getTag() const { return Tag; }
86
87 /// changedSince - Return true if the union change since getTag returned tag.
88 bool changedSince(unsigned tag) const { return tag != Tag; }
89
90 // Add a live virtual register to this union and merge its segments.
91 void unify(const LiveInterval &VirtReg, const LiveRange &Range);
92
93 // Remove a live virtual register's segments from this union.
94 void extract(const LiveInterval &VirtReg, const LiveRange &Range);
95
96 // Remove all inserted virtual registers.
97 void clear() { Segments.clear(); ++Tag; }
98
99 // Print union, using TRI to translate register names
100 void print(raw_ostream &OS, const TargetRegisterInfo *TRI) const;
101
102#ifndef NDEBUG
103 // Verify the live intervals in this union and add them to the visited set.
104 void verify(LiveVirtRegBitSet& VisitedVRegs);
105#endif
106
107 // Get any virtual register that is assign to this physical unit
108 const LiveInterval *getOneVReg() const;
109
110 /// Query interferences between a single live virtual register and a live
111 /// interval union.
112 class Query {
113 const LiveIntervalUnion *LiveUnion = nullptr;
114 const LiveRange *LR = nullptr;
115 LiveRange::const_iterator LRI; ///< current position in LR
116 ConstSegmentIter LiveUnionI; ///< current position in LiveUnion
118 bool CheckedFirstInterference = false;
119 bool SeenAllInterferences = false;
120 unsigned Tag = 0;
121 unsigned UserTag = 0;
122
123 // Count the virtual registers in this union that interfere with this
124 // query's live virtual register, up to maxInterferingRegs.
125 unsigned collectInterferingVRegs(unsigned MaxInterferingRegs);
126
127 // Was this virtual register visited during collectInterferingVRegs?
128 bool isSeenInterference(const LiveInterval *VirtReg) const;
129
130 public:
131 Query() = default;
132 Query(const LiveRange &LR, const LiveIntervalUnion &LIU)
133 : LiveUnion(&LIU), LR(&LR) {}
134 Query(const Query &) = delete;
135 Query &operator=(const Query &) = delete;
136
137 void reset(unsigned NewUserTag, const LiveRange &NewLR,
138 const LiveIntervalUnion &NewLiveUnion) {
139 LiveUnion = &NewLiveUnion;
140 LR = &NewLR;
141 InterferingVRegs.clear();
142 CheckedFirstInterference = false;
143 SeenAllInterferences = false;
144 Tag = NewLiveUnion.getTag();
145 UserTag = NewUserTag;
146 }
147
148 void init(unsigned NewUserTag, const LiveRange &NewLR,
149 const LiveIntervalUnion &NewLiveUnion) {
150 if (UserTag == NewUserTag && LR == &NewLR && LiveUnion == &NewLiveUnion &&
151 !NewLiveUnion.changedSince(Tag)) {
152 // Retain cached results, e.g. firstInterference.
153 return;
154 }
155 reset(NewUserTag, NewLR, NewLiveUnion);
156 }
157
158 // Does this live virtual register interfere with the union?
159 bool checkInterference() { return collectInterferingVRegs(1); }
160
161 // Vector generated by collectInterferingVRegs.
163 unsigned MaxInterferingRegs = std::numeric_limits<unsigned>::max()) {
164 if (!SeenAllInterferences || MaxInterferingRegs < InterferingVRegs.size())
165 collectInterferingVRegs(MaxInterferingRegs);
166 return InterferingVRegs;
167 }
168 };
169
170 // Array of LiveIntervalUnions.
171 class Array {
172 unsigned Size = 0;
173 LiveIntervalUnion *LIUs = nullptr;
174
175 public:
176 Array() = default;
177 ~Array() { clear(); }
178
179 // Initialize the array to have Size entries.
180 // Reuse an existing allocation if the size matches.
181 void init(LiveIntervalUnion::Allocator&, unsigned Size);
182
183 unsigned size() const { return Size; }
184
185 void clear();
186
188 assert(idx < Size && "idx out of bounds");
189 return LIUs[idx];
190 }
191
192 const LiveIntervalUnion& operator[](unsigned Idx) const {
193 assert(Idx < Size && "Idx out of bounds");
194 return LIUs[Idx];
195 }
196 };
197};
198
199} // end namespace llvm
200
201#endif // LLVM_CODEGEN_LIVEINTERVALUNION_H
Returns the sub type a function will return at a given Idx Should correspond to the result type of an ExtractValue instruction executed with just that one unsigned Idx
This file implements a coalescing interval map for small objects.
loop extract
unsigned const TargetRegisterInfo * TRI
ConstantRange Range(APInt(BitWidth, Low), APInt(BitWidth, High))
ppc ctr loops verify
assert(ImpDefSCC.getReg()==AMDGPU::SCC &&ImpDefSCC.isDef())
raw_pwrite_stream & OS
This file defines the SmallVector class.
void init(LiveIntervalUnion::Allocator &, unsigned Size)
LiveIntervalUnion & operator[](unsigned idx)
const LiveIntervalUnion & operator[](unsigned Idx) const
Query interferences between a single live virtual register and a live interval union.
Query & operator=(const Query &)=delete
Query(const LiveRange &LR, const LiveIntervalUnion &LIU)
void init(unsigned NewUserTag, const LiveRange &NewLR, const LiveIntervalUnion &NewLiveUnion)
const SmallVectorImpl< const LiveInterval * > & interferingVRegs(unsigned MaxInterferingRegs=std::numeric_limits< unsigned >::max())
void reset(unsigned NewUserTag, const LiveRange &NewLR, const LiveIntervalUnion &NewLiveUnion)
Query(const Query &)=delete
Union of live intervals that are strong candidates for coalescing into a single register (either phys...
SlotIndex startIndex() const
LiveSegments::const_iterator ConstSegmentIter
Const version of SegmentIter.
LiveIntervalUnion(Allocator &a)
SegmentIter find(SlotIndex x)
void unify(const LiveInterval &VirtReg, const LiveRange &Range)
ConstSegmentIter begin() const
const LiveInterval * getOneVReg() const
NDEBUG.
LiveSegments::iterator SegmentIter
unsigned getTag() const
getTag - Return an opaque tag representing the current state of the union.
ConstSegmentIter find(SlotIndex x) const
bool changedSince(unsigned tag) const
changedSince - Return true if the union change since getTag returned tag.
void print(raw_ostream &OS, const TargetRegisterInfo *TRI) const
SlotIndex endIndex() const
const Map & getMap() const
LiveSegments::Allocator Allocator
ConstSegmentIter end() const
LiveInterval - This class represents the liveness of a register, or stack slot.
Definition: LiveInterval.h:687
This class represents the liveness of a register, stack slot, etc.
Definition: LiveInterval.h:157
SlotIndex - An opaque wrapper around machine indexes.
Definition: SlotIndexes.h:65
size_t size() const
Definition: SmallVector.h:91
This class consists of common code factored out of the SmallVector class to reduce code duplication b...
Definition: SmallVector.h:586
This is a 'vector' (really, a variable-sized array), optimized for the case when the array is small.
Definition: SmallVector.h:1209
TargetRegisterInfo base class - We assume that the target defines a static array of TargetRegisterDes...
This class implements an extremely fast bulk output stream that can only output to a stream.
Definition: raw_ostream.h:52
This is an optimization pass for GlobalISel generic memory operations.
Definition: AddressRanges.h:18