1 //===-- StackSlotColoring.cpp - Stack slot coloring pass. -----------------===//
3 // The LLVM Compiler Infrastructure
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
8 //===----------------------------------------------------------------------===//
10 // This file implements the stack slot coloring pass.
12 //===----------------------------------------------------------------------===//
14 #include "llvm/CodeGen/Passes.h"
15 #include "llvm/ADT/BitVector.h"
16 #include "llvm/ADT/SmallVector.h"
17 #include "llvm/ADT/Statistic.h"
18 #include "llvm/CodeGen/LiveIntervalAnalysis.h"
19 #include "llvm/CodeGen/LiveStackAnalysis.h"
20 #include "llvm/CodeGen/MachineBlockFrequencyInfo.h"
21 #include "llvm/CodeGen/MachineFrameInfo.h"
22 #include "llvm/CodeGen/MachineInstrBuilder.h"
23 #include "llvm/CodeGen/MachineMemOperand.h"
24 #include "llvm/CodeGen/MachineRegisterInfo.h"
25 #include "llvm/CodeGen/PseudoSourceValue.h"
26 #include "llvm/IR/Module.h"
27 #include "llvm/Support/CommandLine.h"
28 #include "llvm/Support/Debug.h"
29 #include "llvm/Support/raw_ostream.h"
30 #include "llvm/Target/TargetInstrInfo.h"
31 #include "llvm/Target/TargetSubtargetInfo.h"
35 #define DEBUG_TYPE "stackslotcoloring"
38 DisableSharing("no-stack-slot-sharing",
39 cl::init(false), cl::Hidden,
40 cl::desc("Suppress slot sharing during stack coloring"));
42 static cl::opt<int> DCELimit("ssc-dce-limit", cl::init(-1), cl::Hidden);
44 STATISTIC(NumEliminated, "Number of stack slots eliminated due to coloring");
45 STATISTIC(NumDead, "Number of trivially dead stack accesses eliminated");
48 class StackSlotColoring : public MachineFunctionPass {
50 MachineFrameInfo *MFI;
51 const TargetInstrInfo *TII;
52 const MachineBlockFrequencyInfo *MBFI;
54 // SSIntervals - Spill slot intervals.
55 std::vector<LiveInterval*> SSIntervals;
57 // SSRefs - Keep a list of MachineMemOperands for each spill slot.
58 // MachineMemOperands can be shared between instructions, so we need
59 // to be careful that renames like [FI0, FI1] -> [FI1, FI2] do not
60 // become FI0 -> FI1 -> FI2.
61 SmallVector<SmallVector<MachineMemOperand *, 8>, 16> SSRefs;
63 // OrigAlignments - Alignments of stack objects before coloring.
64 SmallVector<unsigned, 16> OrigAlignments;
66 // OrigSizes - Sizess of stack objects before coloring.
67 SmallVector<unsigned, 16> OrigSizes;
69 // AllColors - If index is set, it's a spill slot, i.e. color.
70 // FIXME: This assumes PEI locate spill slot with smaller indices
71 // closest to stack pointer / frame pointer. Therefore, smaller
72 // index == better color.
75 // NextColor - Next "color" that's not yet used.
78 // UsedColors - "Colors" that have been assigned.
81 // Assignments - Color to intervals mapping.
82 SmallVector<SmallVector<LiveInterval*,4>, 16> Assignments;
85 static char ID; // Pass identification
87 MachineFunctionPass(ID), NextColor(-1) {
88 initializeStackSlotColoringPass(*PassRegistry::getPassRegistry());
91 void getAnalysisUsage(AnalysisUsage &AU) const override {
93 AU.addRequired<SlotIndexes>();
94 AU.addPreserved<SlotIndexes>();
95 AU.addRequired<LiveStacks>();
96 AU.addRequired<MachineBlockFrequencyInfo>();
97 AU.addPreserved<MachineBlockFrequencyInfo>();
98 AU.addPreservedID(MachineDominatorsID);
99 MachineFunctionPass::getAnalysisUsage(AU);
102 bool runOnMachineFunction(MachineFunction &MF) override;
105 void InitializeSlots();
106 void ScanForSpillSlotRefs(MachineFunction &MF);
107 bool OverlapWithAssignments(LiveInterval *li, int Color) const;
108 int ColorSlot(LiveInterval *li);
109 bool ColorSlots(MachineFunction &MF);
110 void RewriteInstruction(MachineInstr *MI, SmallVectorImpl<int> &SlotMapping,
111 MachineFunction &MF);
112 bool RemoveDeadStores(MachineBasicBlock* MBB);
114 } // end anonymous namespace
116 char StackSlotColoring::ID = 0;
117 char &llvm::StackSlotColoringID = StackSlotColoring::ID;
119 INITIALIZE_PASS_BEGIN(StackSlotColoring, "stack-slot-coloring",
120 "Stack Slot Coloring", false, false)
121 INITIALIZE_PASS_DEPENDENCY(SlotIndexes)
122 INITIALIZE_PASS_DEPENDENCY(LiveStacks)
123 INITIALIZE_PASS_DEPENDENCY(MachineLoopInfo)
124 INITIALIZE_PASS_END(StackSlotColoring, "stack-slot-coloring",
125 "Stack Slot Coloring", false, false)
128 // IntervalSorter - Comparison predicate that sort live intervals by
130 struct IntervalSorter {
131 bool operator()(LiveInterval* LHS, LiveInterval* RHS) const {
132 return LHS->weight > RHS->weight;
137 /// ScanForSpillSlotRefs - Scan all the machine instructions for spill slot
138 /// references and update spill slot weights.
139 void StackSlotColoring::ScanForSpillSlotRefs(MachineFunction &MF) {
140 SSRefs.resize(MFI->getObjectIndexEnd());
142 // FIXME: Need the equivalent of MachineRegisterInfo for frameindex operands.
143 for (MachineFunction::iterator MBBI = MF.begin(), E = MF.end();
145 MachineBasicBlock *MBB = &*MBBI;
146 for (MachineBasicBlock::iterator MII = MBB->begin(), EE = MBB->end();
148 MachineInstr *MI = &*MII;
149 for (unsigned i = 0, e = MI->getNumOperands(); i != e; ++i) {
150 MachineOperand &MO = MI->getOperand(i);
153 int FI = MO.getIndex();
156 if (!LS->hasInterval(FI))
158 LiveInterval &li = LS->getInterval(FI);
159 if (!MI->isDebugValue())
160 li.weight += LiveIntervals::getSpillWeight(false, true, MBFI, MI);
162 for (MachineInstr::mmo_iterator MMOI = MI->memoperands_begin(),
163 EE = MI->memoperands_end(); MMOI != EE; ++MMOI) {
164 MachineMemOperand *MMO = *MMOI;
165 if (const FixedStackPseudoSourceValue *FSV =
166 dyn_cast_or_null<FixedStackPseudoSourceValue>(
167 MMO->getPseudoValue())) {
168 int FI = FSV->getFrameIndex();
170 SSRefs[FI].push_back(MMO);
177 /// InitializeSlots - Process all spill stack slot liveintervals and add them
178 /// to a sorted (by weight) list.
179 void StackSlotColoring::InitializeSlots() {
180 int LastFI = MFI->getObjectIndexEnd();
181 OrigAlignments.resize(LastFI);
182 OrigSizes.resize(LastFI);
183 AllColors.resize(LastFI);
184 UsedColors.resize(LastFI);
185 Assignments.resize(LastFI);
187 typedef std::iterator_traits<LiveStacks::iterator>::value_type Pair;
188 SmallVector<Pair *, 16> Intervals;
189 Intervals.reserve(LS->getNumIntervals());
191 Intervals.push_back(&I);
192 std::sort(Intervals.begin(), Intervals.end(),
193 [](Pair *LHS, Pair *RHS) { return LHS->first < RHS->first; });
195 // Gather all spill slots into a list.
196 DEBUG(dbgs() << "Spill slot intervals:\n");
197 for (auto *I : Intervals) {
198 LiveInterval &li = I->second;
200 int FI = TargetRegisterInfo::stackSlot2Index(li.reg);
201 if (MFI->isDeadObjectIndex(FI))
203 SSIntervals.push_back(&li);
204 OrigAlignments[FI] = MFI->getObjectAlignment(FI);
205 OrigSizes[FI] = MFI->getObjectSize(FI);
208 DEBUG(dbgs() << '\n');
210 // Sort them by weight.
211 std::stable_sort(SSIntervals.begin(), SSIntervals.end(), IntervalSorter());
213 // Get first "color".
214 NextColor = AllColors.find_first();
217 /// OverlapWithAssignments - Return true if LiveInterval overlaps with any
218 /// LiveIntervals that have already been assigned to the specified color.
220 StackSlotColoring::OverlapWithAssignments(LiveInterval *li, int Color) const {
221 const SmallVectorImpl<LiveInterval *> &OtherLIs = Assignments[Color];
222 for (unsigned i = 0, e = OtherLIs.size(); i != e; ++i) {
223 LiveInterval *OtherLI = OtherLIs[i];
224 if (OtherLI->overlaps(*li))
230 /// ColorSlot - Assign a "color" (stack slot) to the specified stack slot.
232 int StackSlotColoring::ColorSlot(LiveInterval *li) {
235 if (!DisableSharing) {
236 // Check if it's possible to reuse any of the used colors.
237 Color = UsedColors.find_first();
238 while (Color != -1) {
239 if (!OverlapWithAssignments(li, Color)) {
244 Color = UsedColors.find_next(Color);
248 // Assign it to the first available color (assumed to be the best) if it's
249 // not possible to share a used color with other objects.
251 assert(NextColor != -1 && "No more spill slots?");
253 UsedColors.set(Color);
254 NextColor = AllColors.find_next(NextColor);
257 // Record the assignment.
258 Assignments[Color].push_back(li);
259 int FI = TargetRegisterInfo::stackSlot2Index(li->reg);
260 DEBUG(dbgs() << "Assigning fi#" << FI << " to fi#" << Color << "\n");
262 // Change size and alignment of the allocated slot. If there are multiple
263 // objects sharing the same slot, then make sure the size and alignment
264 // are large enough for all.
265 unsigned Align = OrigAlignments[FI];
266 if (!Share || Align > MFI->getObjectAlignment(Color))
267 MFI->setObjectAlignment(Color, Align);
268 int64_t Size = OrigSizes[FI];
269 if (!Share || Size > MFI->getObjectSize(Color))
270 MFI->setObjectSize(Color, Size);
274 /// Colorslots - Color all spill stack slots and rewrite all frameindex machine
275 /// operands in the function.
276 bool StackSlotColoring::ColorSlots(MachineFunction &MF) {
277 unsigned NumObjs = MFI->getObjectIndexEnd();
278 SmallVector<int, 16> SlotMapping(NumObjs, -1);
279 SmallVector<float, 16> SlotWeights(NumObjs, 0.0);
280 SmallVector<SmallVector<int, 4>, 16> RevMap(NumObjs);
281 BitVector UsedColors(NumObjs);
283 DEBUG(dbgs() << "Color spill slot intervals:\n");
284 bool Changed = false;
285 for (unsigned i = 0, e = SSIntervals.size(); i != e; ++i) {
286 LiveInterval *li = SSIntervals[i];
287 int SS = TargetRegisterInfo::stackSlot2Index(li->reg);
288 int NewSS = ColorSlot(li);
289 assert(NewSS >= 0 && "Stack coloring failed?");
290 SlotMapping[SS] = NewSS;
291 RevMap[NewSS].push_back(SS);
292 SlotWeights[NewSS] += li->weight;
293 UsedColors.set(NewSS);
294 Changed |= (SS != NewSS);
297 DEBUG(dbgs() << "\nSpill slots after coloring:\n");
298 for (unsigned i = 0, e = SSIntervals.size(); i != e; ++i) {
299 LiveInterval *li = SSIntervals[i];
300 int SS = TargetRegisterInfo::stackSlot2Index(li->reg);
301 li->weight = SlotWeights[SS];
303 // Sort them by new weight.
304 std::stable_sort(SSIntervals.begin(), SSIntervals.end(), IntervalSorter());
307 for (unsigned i = 0, e = SSIntervals.size(); i != e; ++i)
308 DEBUG(SSIntervals[i]->dump());
309 DEBUG(dbgs() << '\n');
315 // Rewrite all MachineMemOperands.
316 for (unsigned SS = 0, SE = SSRefs.size(); SS != SE; ++SS) {
317 int NewFI = SlotMapping[SS];
318 if (NewFI == -1 || (NewFI == (int)SS))
321 const PseudoSourceValue *NewSV = MF.getPSVManager().getFixedStack(NewFI);
322 SmallVectorImpl<MachineMemOperand *> &RefMMOs = SSRefs[SS];
323 for (unsigned i = 0, e = RefMMOs.size(); i != e; ++i)
324 RefMMOs[i]->setValue(NewSV);
327 // Rewrite all MO_FrameIndex operands. Look for dead stores.
328 for (MachineFunction::iterator MBBI = MF.begin(), E = MF.end();
330 MachineBasicBlock *MBB = &*MBBI;
331 for (MachineBasicBlock::iterator MII = MBB->begin(), EE = MBB->end();
333 RewriteInstruction(MII, SlotMapping, MF);
334 RemoveDeadStores(MBB);
337 // Delete unused stack slots.
338 while (NextColor != -1) {
339 DEBUG(dbgs() << "Removing unused stack object fi#" << NextColor << "\n");
340 MFI->RemoveStackObject(NextColor);
341 NextColor = AllColors.find_next(NextColor);
347 /// RewriteInstruction - Rewrite specified instruction by replacing references
348 /// to old frame index with new one.
349 void StackSlotColoring::RewriteInstruction(MachineInstr *MI,
350 SmallVectorImpl<int> &SlotMapping,
351 MachineFunction &MF) {
352 // Update the operands.
353 for (unsigned i = 0, ee = MI->getNumOperands(); i != ee; ++i) {
354 MachineOperand &MO = MI->getOperand(i);
357 int OldFI = MO.getIndex();
360 int NewFI = SlotMapping[OldFI];
361 if (NewFI == -1 || NewFI == OldFI)
366 // The MachineMemOperands have already been updated.
370 /// RemoveDeadStores - Scan through a basic block and look for loads followed
371 /// by stores. If they're both using the same stack slot, then the store is
372 /// definitely dead. This could obviously be much more aggressive (consider
373 /// pairs with instructions between them), but such extensions might have a
374 /// considerable compile time impact.
375 bool StackSlotColoring::RemoveDeadStores(MachineBasicBlock* MBB) {
376 // FIXME: This could be much more aggressive, but we need to investigate
377 // the compile time impact of doing so.
378 bool changed = false;
380 SmallVector<MachineInstr*, 4> toErase;
382 for (MachineBasicBlock::iterator I = MBB->begin(), E = MBB->end();
384 if (DCELimit != -1 && (int)NumDead >= DCELimit)
387 int FirstSS, SecondSS;
388 if (TII->isStackSlotCopy(I, FirstSS, SecondSS) &&
389 FirstSS == SecondSS &&
393 toErase.push_back(I);
397 MachineBasicBlock::iterator NextMI = std::next(I);
398 if (NextMI == MBB->end()) continue;
400 unsigned LoadReg = 0;
401 unsigned StoreReg = 0;
402 if (!(LoadReg = TII->isLoadFromStackSlot(I, FirstSS))) continue;
403 if (!(StoreReg = TII->isStoreToStackSlot(NextMI, SecondSS))) continue;
404 if (FirstSS != SecondSS || LoadReg != StoreReg || FirstSS == -1) continue;
409 if (NextMI->findRegisterUseOperandIdx(LoadReg, true, nullptr) != -1) {
411 toErase.push_back(I);
414 toErase.push_back(NextMI);
418 for (SmallVectorImpl<MachineInstr *>::iterator I = toErase.begin(),
419 E = toErase.end(); I != E; ++I)
420 (*I)->eraseFromParent();
426 bool StackSlotColoring::runOnMachineFunction(MachineFunction &MF) {
428 dbgs() << "********** Stack Slot Coloring **********\n"
429 << "********** Function: " << MF.getName() << '\n';
432 MFI = MF.getFrameInfo();
433 TII = MF.getSubtarget().getInstrInfo();
434 LS = &getAnalysis<LiveStacks>();
435 MBFI = &getAnalysis<MachineBlockFrequencyInfo>();
437 bool Changed = false;
439 unsigned NumSlots = LS->getNumIntervals();
444 // If there are calls to setjmp or sigsetjmp, don't perform stack slot
445 // coloring. The stack could be modified before the longjmp is executed,
446 // resulting in the wrong value being used afterwards. (See
447 // <rdar://problem/8007500>.)
448 if (MF.exposesReturnsTwice())
451 // Gather spill slot references
452 ScanForSpillSlotRefs(MF);
454 Changed = ColorSlots(MF);
458 for (unsigned i = 0, e = SSRefs.size(); i != e; ++i)
461 OrigAlignments.clear();
465 for (unsigned i = 0, e = Assignments.size(); i != e; ++i)
466 Assignments[i].clear();