1 //===----------------------- SIFrameLowering.cpp --------------------------===//
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 #include "SIFrameLowering.h"
10 #include "AMDGPUSubtarget.h"
11 #include "SIInstrInfo.h"
12 #include "SIMachineFunctionInfo.h"
13 #include "SIRegisterInfo.h"
14 #include "MCTargetDesc/AMDGPUMCTargetDesc.h"
15 
16 #include "llvm/CodeGen/LivePhysRegs.h"
17 #include "llvm/CodeGen/MachineFrameInfo.h"
18 #include "llvm/CodeGen/MachineFunction.h"
19 #include "llvm/CodeGen/MachineInstrBuilder.h"
20 #include "llvm/CodeGen/RegisterScavenging.h"
21 
22 using namespace llvm;
23 
24 #define DEBUG_TYPE "frame-info"
25 
26 
27 // Find a scratch register that we can use at the start of the prologue to
28 // re-align the stack pointer. We avoid using callee-save registers since they
29 // may appear to be free when this is called from canUseAsPrologue (during
30 // shrink wrapping), but then no longer be free when this is called from
31 // emitPrologue.
32 //
33 // FIXME: This is a bit conservative, since in the above case we could use one
34 // of the callee-save registers as a scratch temp to re-align the stack pointer,
35 // but we would then have to make sure that we were in fact saving at least one
36 // callee-save register in the prologue, which is additional complexity that
37 // doesn't seem worth the benefit.
38 static MCRegister findScratchNonCalleeSaveRegister(MachineRegisterInfo &MRI,
39                                                    LivePhysRegs &LiveRegs,
40                                                    const TargetRegisterClass &RC,
41                                                    bool Unused = false) {
42   // Mark callee saved registers as used so we will not choose them.
43   const MCPhysReg *CSRegs = MRI.getCalleeSavedRegs();
44   for (unsigned i = 0; CSRegs[i]; ++i)
45     LiveRegs.addReg(CSRegs[i]);
46 
47   if (Unused) {
48     // We are looking for a register that can be used throughout the entire
49     // function, so any use is unacceptable.
50     for (MCRegister Reg : RC) {
51       if (!MRI.isPhysRegUsed(Reg) && LiveRegs.available(MRI, Reg))
52         return Reg;
53     }
54   } else {
55     for (MCRegister Reg : RC) {
56       if (LiveRegs.available(MRI, Reg))
57         return Reg;
58     }
59   }
60 
61   // If we require an unused register, this is used in contexts where failure is
62   // an option and has an alternative plan. In other contexts, this must
63   // succeed0.
64   if (!Unused)
65     report_fatal_error("failed to find free scratch register");
66 
67   return MCRegister();
68 }
69 
70 static void getVGPRSpillLaneOrTempRegister(MachineFunction &MF,
71                                            LivePhysRegs &LiveRegs,
72                                            Register &TempSGPR,
73                                            Optional<int> &FrameIndex,
74                                            bool IsFP) {
75   SIMachineFunctionInfo *MFI = MF.getInfo<SIMachineFunctionInfo>();
76   MachineFrameInfo &FrameInfo = MF.getFrameInfo();
77 
78 #ifndef NDEBUG
79   const GCNSubtarget &ST = MF.getSubtarget<GCNSubtarget>();
80   const SIRegisterInfo *TRI = ST.getRegisterInfo();
81 #endif
82 
83   // We need to save and restore the current FP/BP.
84 
85   // 1: If there is already a VGPR with free lanes, use it. We
86   // may already have to pay the penalty for spilling a CSR VGPR.
87   if (MFI->haveFreeLanesForSGPRSpill(MF, 1)) {
88     int NewFI = FrameInfo.CreateStackObject(4, Align(4), true, nullptr,
89                                             TargetStackID::SGPRSpill);
90 
91     if (!MFI->allocateSGPRSpillToVGPR(MF, NewFI))
92       llvm_unreachable("allocate SGPR spill should have worked");
93 
94     FrameIndex = NewFI;
95 
96     LLVM_DEBUG(auto Spill = MFI->getSGPRToVGPRSpills(NewFI).front();
97                dbgs() << "Spilling " << (IsFP ? "FP" : "BP") << " to  "
98                       << printReg(Spill.VGPR, TRI) << ':' << Spill.Lane
99                       << '\n');
100     return;
101   }
102 
103   // 2: Next, try to save the FP/BP in an unused SGPR.
104   TempSGPR = findScratchNonCalleeSaveRegister(
105       MF.getRegInfo(), LiveRegs, AMDGPU::SReg_32_XM0_XEXECRegClass, true);
106 
107   if (!TempSGPR) {
108     int NewFI = FrameInfo.CreateStackObject(4, Align(4), true, nullptr,
109                                             TargetStackID::SGPRSpill);
110 
111     if (MFI->allocateSGPRSpillToVGPR(MF, NewFI)) {
112       // 3: There's no free lane to spill, and no free register to save FP/BP,
113       // so we're forced to spill another VGPR to use for the spill.
114       FrameIndex = NewFI;
115 
116       LLVM_DEBUG(
117           auto Spill = MFI->getSGPRToVGPRSpills(NewFI).front();
118           dbgs() << (IsFP ? "FP" : "BP") << " requires fallback spill to "
119                  << printReg(Spill.VGPR, TRI) << ':' << Spill.Lane << '\n';);
120     } else {
121       // Remove dead <NewFI> index
122       MF.getFrameInfo().RemoveStackObject(NewFI);
123       // 4: If all else fails, spill the FP/BP to memory.
124       FrameIndex = FrameInfo.CreateSpillStackObject(4, Align(4));
125       LLVM_DEBUG(dbgs() << "Reserved FI " << FrameIndex << " for spilling "
126                         << (IsFP ? "FP" : "BP") << '\n');
127     }
128   } else {
129     LLVM_DEBUG(dbgs() << "Saving " << (IsFP ? "FP" : "BP") << " with copy to "
130                       << printReg(TempSGPR, TRI) << '\n');
131   }
132 }
133 
134 // We need to specially emit stack operations here because a different frame
135 // register is used than in the rest of the function, as getFrameRegister would
136 // use.
137 static void buildPrologSpill(const GCNSubtarget &ST, LivePhysRegs &LiveRegs,
138                              MachineBasicBlock &MBB,
139                              MachineBasicBlock::iterator I,
140                              const SIInstrInfo *TII, Register SpillReg,
141                              Register ScratchRsrcReg, Register SPReg, int FI) {
142   MachineFunction *MF = MBB.getParent();
143   MachineFrameInfo &MFI = MF->getFrameInfo();
144 
145   int64_t Offset = MFI.getObjectOffset(FI);
146 
147   MachineMemOperand *MMO = MF->getMachineMemOperand(
148       MachinePointerInfo::getFixedStack(*MF, FI), MachineMemOperand::MOStore, 4,
149       MFI.getObjectAlign(FI));
150 
151   if (ST.enableFlatScratch()) {
152     if (TII->isLegalFLATOffset(Offset, AMDGPUAS::PRIVATE_ADDRESS, true)) {
153       BuildMI(MBB, I, DebugLoc(), TII->get(AMDGPU::SCRATCH_STORE_DWORD_SADDR))
154         .addReg(SpillReg, RegState::Kill)
155         .addReg(SPReg)
156         .addImm(Offset)
157         .addImm(0) // glc
158         .addImm(0) // slc
159         .addImm(0) // dlc
160         .addMemOperand(MMO);
161       return;
162     }
163   } else if (SIInstrInfo::isLegalMUBUFImmOffset(Offset)) {
164     BuildMI(MBB, I, DebugLoc(), TII->get(AMDGPU::BUFFER_STORE_DWORD_OFFSET))
165       .addReg(SpillReg, RegState::Kill)
166       .addReg(ScratchRsrcReg)
167       .addReg(SPReg)
168       .addImm(Offset)
169       .addImm(0) // glc
170       .addImm(0) // slc
171       .addImm(0) // tfe
172       .addImm(0) // dlc
173       .addImm(0) // swz
174       .addMemOperand(MMO);
175     return;
176   }
177 
178   // Don't clobber the TmpVGPR if we also need a scratch reg for the stack
179   // offset in the spill.
180   LiveRegs.addReg(SpillReg);
181 
182   if (ST.enableFlatScratch()) {
183     MCPhysReg OffsetReg = findScratchNonCalleeSaveRegister(
184       MF->getRegInfo(), LiveRegs, AMDGPU::SReg_32_XM0RegClass);
185 
186     BuildMI(MBB, I, DebugLoc(), TII->get(AMDGPU::S_ADD_U32), OffsetReg)
187       .addReg(SPReg)
188       .addImm(Offset);
189 
190     BuildMI(MBB, I, DebugLoc(), TII->get(AMDGPU::SCRATCH_STORE_DWORD_SADDR))
191       .addReg(SpillReg, RegState::Kill)
192       .addReg(OffsetReg, RegState::Kill)
193       .addImm(0)
194       .addImm(0) // glc
195       .addImm(0) // slc
196       .addImm(0) // dlc
197       .addMemOperand(MMO);
198   } else {
199     MCPhysReg OffsetReg = findScratchNonCalleeSaveRegister(
200       MF->getRegInfo(), LiveRegs, AMDGPU::VGPR_32RegClass);
201 
202     BuildMI(MBB, I, DebugLoc(), TII->get(AMDGPU::V_MOV_B32_e32), OffsetReg)
203       .addImm(Offset);
204 
205     BuildMI(MBB, I, DebugLoc(), TII->get(AMDGPU::BUFFER_STORE_DWORD_OFFEN))
206       .addReg(SpillReg, RegState::Kill)
207       .addReg(OffsetReg, RegState::Kill)
208       .addReg(ScratchRsrcReg)
209       .addReg(SPReg)
210       .addImm(0)
211       .addImm(0) // glc
212       .addImm(0) // slc
213       .addImm(0) // tfe
214       .addImm(0) // dlc
215       .addImm(0) // swz
216       .addMemOperand(MMO);
217   }
218 
219   LiveRegs.removeReg(SpillReg);
220 }
221 
222 static void buildEpilogReload(const GCNSubtarget &ST, LivePhysRegs &LiveRegs,
223                               MachineBasicBlock &MBB,
224                               MachineBasicBlock::iterator I,
225                               const SIInstrInfo *TII, Register SpillReg,
226                               Register ScratchRsrcReg, Register SPReg, int FI) {
227   MachineFunction *MF = MBB.getParent();
228   MachineFrameInfo &MFI = MF->getFrameInfo();
229   int64_t Offset = MFI.getObjectOffset(FI);
230 
231   MachineMemOperand *MMO = MF->getMachineMemOperand(
232       MachinePointerInfo::getFixedStack(*MF, FI), MachineMemOperand::MOLoad, 4,
233       MFI.getObjectAlign(FI));
234 
235   if (ST.enableFlatScratch()) {
236     if (TII->isLegalFLATOffset(Offset, AMDGPUAS::PRIVATE_ADDRESS, true)) {
237       BuildMI(MBB, I, DebugLoc(),
238               TII->get(AMDGPU::SCRATCH_LOAD_DWORD_SADDR), SpillReg)
239         .addReg(SPReg)
240         .addImm(Offset)
241         .addImm(0) // glc
242         .addImm(0) // slc
243         .addImm(0) // dlc
244         .addMemOperand(MMO);
245       return;
246     }
247     MCPhysReg OffsetReg = findScratchNonCalleeSaveRegister(
248       MF->getRegInfo(), LiveRegs, AMDGPU::SReg_32_XM0RegClass);
249 
250       BuildMI(MBB, I, DebugLoc(), TII->get(AMDGPU::S_ADD_U32), OffsetReg)
251         .addReg(SPReg)
252         .addImm(Offset);
253       BuildMI(MBB, I, DebugLoc(), TII->get(AMDGPU::SCRATCH_LOAD_DWORD_SADDR),
254               SpillReg)
255       .addReg(OffsetReg, RegState::Kill)
256       .addImm(0)
257       .addImm(0) // glc
258       .addImm(0) // slc
259       .addImm(0) // dlc
260       .addMemOperand(MMO);
261       return;
262   }
263 
264   if (SIInstrInfo::isLegalMUBUFImmOffset(Offset)) {
265     BuildMI(MBB, I, DebugLoc(),
266             TII->get(AMDGPU::BUFFER_LOAD_DWORD_OFFSET), SpillReg)
267       .addReg(ScratchRsrcReg)
268       .addReg(SPReg)
269       .addImm(Offset)
270       .addImm(0) // glc
271       .addImm(0) // slc
272       .addImm(0) // tfe
273       .addImm(0) // dlc
274       .addImm(0) // swz
275       .addMemOperand(MMO);
276     return;
277   }
278 
279   MCPhysReg OffsetReg = findScratchNonCalleeSaveRegister(
280     MF->getRegInfo(), LiveRegs, AMDGPU::VGPR_32RegClass);
281 
282   BuildMI(MBB, I, DebugLoc(), TII->get(AMDGPU::V_MOV_B32_e32), OffsetReg)
283     .addImm(Offset);
284 
285   BuildMI(MBB, I, DebugLoc(),
286           TII->get(AMDGPU::BUFFER_LOAD_DWORD_OFFEN), SpillReg)
287     .addReg(OffsetReg, RegState::Kill)
288     .addReg(ScratchRsrcReg)
289     .addReg(SPReg)
290     .addImm(0)
291     .addImm(0) // glc
292     .addImm(0) // slc
293     .addImm(0) // tfe
294     .addImm(0) // dlc
295     .addImm(0) // swz
296     .addMemOperand(MMO);
297 }
298 
299 // Emit flat scratch setup code, assuming `MFI->hasFlatScratchInit()`
300 void SIFrameLowering::emitEntryFunctionFlatScratchInit(
301     MachineFunction &MF, MachineBasicBlock &MBB, MachineBasicBlock::iterator I,
302     const DebugLoc &DL, Register ScratchWaveOffsetReg) const {
303   const GCNSubtarget &ST = MF.getSubtarget<GCNSubtarget>();
304   const SIInstrInfo *TII = ST.getInstrInfo();
305   const SIRegisterInfo *TRI = &TII->getRegisterInfo();
306   const SIMachineFunctionInfo *MFI = MF.getInfo<SIMachineFunctionInfo>();
307 
308   // We don't need this if we only have spills since there is no user facing
309   // scratch.
310 
311   // TODO: If we know we don't have flat instructions earlier, we can omit
312   // this from the input registers.
313   //
314   // TODO: We only need to know if we access scratch space through a flat
315   // pointer. Because we only detect if flat instructions are used at all,
316   // this will be used more often than necessary on VI.
317 
318   Register FlatScratchInitReg =
319       MFI->getPreloadedReg(AMDGPUFunctionArgInfo::FLAT_SCRATCH_INIT);
320   assert(FlatScratchInitReg);
321 
322   MachineRegisterInfo &MRI = MF.getRegInfo();
323   MRI.addLiveIn(FlatScratchInitReg);
324   MBB.addLiveIn(FlatScratchInitReg);
325 
326   Register FlatScrInitLo = TRI->getSubReg(FlatScratchInitReg, AMDGPU::sub0);
327   Register FlatScrInitHi = TRI->getSubReg(FlatScratchInitReg, AMDGPU::sub1);
328 
329   // Do a 64-bit pointer add.
330   if (ST.flatScratchIsPointer()) {
331     if (ST.getGeneration() >= AMDGPUSubtarget::GFX10) {
332       BuildMI(MBB, I, DL, TII->get(AMDGPU::S_ADD_U32), FlatScrInitLo)
333         .addReg(FlatScrInitLo)
334         .addReg(ScratchWaveOffsetReg);
335       BuildMI(MBB, I, DL, TII->get(AMDGPU::S_ADDC_U32), FlatScrInitHi)
336         .addReg(FlatScrInitHi)
337         .addImm(0);
338       BuildMI(MBB, I, DL, TII->get(AMDGPU::S_SETREG_B32)).
339         addReg(FlatScrInitLo).
340         addImm(int16_t(AMDGPU::Hwreg::ID_FLAT_SCR_LO |
341                        (31 << AMDGPU::Hwreg::WIDTH_M1_SHIFT_)));
342       BuildMI(MBB, I, DL, TII->get(AMDGPU::S_SETREG_B32)).
343         addReg(FlatScrInitHi).
344         addImm(int16_t(AMDGPU::Hwreg::ID_FLAT_SCR_HI |
345                        (31 << AMDGPU::Hwreg::WIDTH_M1_SHIFT_)));
346       return;
347     }
348 
349     // For GFX9.
350     BuildMI(MBB, I, DL, TII->get(AMDGPU::S_ADD_U32), AMDGPU::FLAT_SCR_LO)
351       .addReg(FlatScrInitLo)
352       .addReg(ScratchWaveOffsetReg);
353     BuildMI(MBB, I, DL, TII->get(AMDGPU::S_ADDC_U32), AMDGPU::FLAT_SCR_HI)
354       .addReg(FlatScrInitHi)
355       .addImm(0);
356 
357     return;
358   }
359 
360   assert(ST.getGeneration() < AMDGPUSubtarget::GFX9);
361 
362   // Copy the size in bytes.
363   BuildMI(MBB, I, DL, TII->get(AMDGPU::COPY), AMDGPU::FLAT_SCR_LO)
364     .addReg(FlatScrInitHi, RegState::Kill);
365 
366   // Add wave offset in bytes to private base offset.
367   // See comment in AMDKernelCodeT.h for enable_sgpr_flat_scratch_init.
368   BuildMI(MBB, I, DL, TII->get(AMDGPU::S_ADD_U32), FlatScrInitLo)
369     .addReg(FlatScrInitLo)
370     .addReg(ScratchWaveOffsetReg);
371 
372   // Convert offset to 256-byte units.
373   BuildMI(MBB, I, DL, TII->get(AMDGPU::S_LSHR_B32), AMDGPU::FLAT_SCR_HI)
374     .addReg(FlatScrInitLo, RegState::Kill)
375     .addImm(8);
376 }
377 
378 // Shift down registers reserved for the scratch RSRC.
379 Register SIFrameLowering::getEntryFunctionReservedScratchRsrcReg(
380     MachineFunction &MF) const {
381 
382   const GCNSubtarget &ST = MF.getSubtarget<GCNSubtarget>();
383   const SIInstrInfo *TII = ST.getInstrInfo();
384   const SIRegisterInfo *TRI = &TII->getRegisterInfo();
385   MachineRegisterInfo &MRI = MF.getRegInfo();
386   SIMachineFunctionInfo *MFI = MF.getInfo<SIMachineFunctionInfo>();
387 
388   assert(MFI->isEntryFunction());
389 
390   Register ScratchRsrcReg = MFI->getScratchRSrcReg();
391 
392   if (!ScratchRsrcReg || !MRI.isPhysRegUsed(ScratchRsrcReg))
393     return Register();
394 
395   if (ST.hasSGPRInitBug() ||
396       ScratchRsrcReg != TRI->reservedPrivateSegmentBufferReg(MF))
397     return ScratchRsrcReg;
398 
399   // We reserved the last registers for this. Shift it down to the end of those
400   // which were actually used.
401   //
402   // FIXME: It might be safer to use a pseudoregister before replacement.
403 
404   // FIXME: We should be able to eliminate unused input registers. We only
405   // cannot do this for the resources required for scratch access. For now we
406   // skip over user SGPRs and may leave unused holes.
407 
408   unsigned NumPreloaded = (MFI->getNumPreloadedSGPRs() + 3) / 4;
409   ArrayRef<MCPhysReg> AllSGPR128s = TRI->getAllSGPR128(MF);
410   AllSGPR128s = AllSGPR128s.slice(std::min(static_cast<unsigned>(AllSGPR128s.size()), NumPreloaded));
411 
412   // Skip the last N reserved elements because they should have already been
413   // reserved for VCC etc.
414   Register GITPtrLoReg = MFI->getGITPtrLoReg(MF);
415   for (MCPhysReg Reg : AllSGPR128s) {
416     // Pick the first unallocated one. Make sure we don't clobber the other
417     // reserved input we needed. Also for PAL, make sure we don't clobber
418     // the GIT pointer passed in SGPR0 or SGPR8.
419     if (!MRI.isPhysRegUsed(Reg) && MRI.isAllocatable(Reg) &&
420         !TRI->isSubRegisterEq(Reg, GITPtrLoReg)) {
421       MRI.replaceRegWith(ScratchRsrcReg, Reg);
422       MFI->setScratchRSrcReg(Reg);
423       return Reg;
424     }
425   }
426 
427   return ScratchRsrcReg;
428 }
429 
430 static unsigned getScratchScaleFactor(const GCNSubtarget &ST) {
431   return ST.enableFlatScratch() ? 1 : ST.getWavefrontSize();
432 }
433 
434 void SIFrameLowering::emitEntryFunctionPrologue(MachineFunction &MF,
435                                                 MachineBasicBlock &MBB) const {
436   assert(&MF.front() == &MBB && "Shrink-wrapping not yet supported");
437 
438   // FIXME: If we only have SGPR spills, we won't actually be using scratch
439   // memory since these spill to VGPRs. We should be cleaning up these unused
440   // SGPR spill frame indices somewhere.
441 
442   // FIXME: We still have implicit uses on SGPR spill instructions in case they
443   // need to spill to vector memory. It's likely that will not happen, but at
444   // this point it appears we need the setup. This part of the prolog should be
445   // emitted after frame indices are eliminated.
446 
447   // FIXME: Remove all of the isPhysRegUsed checks
448 
449   SIMachineFunctionInfo *MFI = MF.getInfo<SIMachineFunctionInfo>();
450   const GCNSubtarget &ST = MF.getSubtarget<GCNSubtarget>();
451   const SIInstrInfo *TII = ST.getInstrInfo();
452   const SIRegisterInfo *TRI = &TII->getRegisterInfo();
453   MachineRegisterInfo &MRI = MF.getRegInfo();
454   const Function &F = MF.getFunction();
455 
456   assert(MFI->isEntryFunction());
457 
458   Register PreloadedScratchWaveOffsetReg = MFI->getPreloadedReg(
459       AMDGPUFunctionArgInfo::PRIVATE_SEGMENT_WAVE_BYTE_OFFSET);
460   // FIXME: Hack to not crash in situations which emitted an error.
461   if (!PreloadedScratchWaveOffsetReg)
462     return;
463 
464   // We need to do the replacement of the private segment buffer register even
465   // if there are no stack objects. There could be stores to undef or a
466   // constant without an associated object.
467   //
468   // This will return `Register()` in cases where there are no actual
469   // uses of the SRSRC.
470   Register ScratchRsrcReg = getEntryFunctionReservedScratchRsrcReg(MF);
471 
472   // Make the selected register live throughout the function.
473   if (ScratchRsrcReg) {
474     for (MachineBasicBlock &OtherBB : MF) {
475       if (&OtherBB != &MBB) {
476         OtherBB.addLiveIn(ScratchRsrcReg);
477       }
478     }
479   }
480 
481   // Now that we have fixed the reserved SRSRC we need to locate the
482   // (potentially) preloaded SRSRC.
483   Register PreloadedScratchRsrcReg;
484   if (ST.isAmdHsaOrMesa(F)) {
485     PreloadedScratchRsrcReg =
486         MFI->getPreloadedReg(AMDGPUFunctionArgInfo::PRIVATE_SEGMENT_BUFFER);
487     if (ScratchRsrcReg && PreloadedScratchRsrcReg) {
488       // We added live-ins during argument lowering, but since they were not
489       // used they were deleted. We're adding the uses now, so add them back.
490       MRI.addLiveIn(PreloadedScratchRsrcReg);
491       MBB.addLiveIn(PreloadedScratchRsrcReg);
492     }
493   }
494 
495   // Debug location must be unknown since the first debug location is used to
496   // determine the end of the prologue.
497   DebugLoc DL;
498   MachineBasicBlock::iterator I = MBB.begin();
499 
500   // We found the SRSRC first because it needs four registers and has an
501   // alignment requirement. If the SRSRC that we found is clobbering with
502   // the scratch wave offset, which may be in a fixed SGPR or a free SGPR
503   // chosen by SITargetLowering::allocateSystemSGPRs, COPY the scratch
504   // wave offset to a free SGPR.
505   Register ScratchWaveOffsetReg;
506   if (TRI->isSubRegisterEq(ScratchRsrcReg, PreloadedScratchWaveOffsetReg)) {
507     ArrayRef<MCPhysReg> AllSGPRs = TRI->getAllSGPR32(MF);
508     unsigned NumPreloaded = MFI->getNumPreloadedSGPRs();
509     AllSGPRs = AllSGPRs.slice(
510         std::min(static_cast<unsigned>(AllSGPRs.size()), NumPreloaded));
511     Register GITPtrLoReg = MFI->getGITPtrLoReg(MF);
512     for (MCPhysReg Reg : AllSGPRs) {
513       if (!MRI.isPhysRegUsed(Reg) && MRI.isAllocatable(Reg) &&
514           !TRI->isSubRegisterEq(ScratchRsrcReg, Reg) && GITPtrLoReg != Reg) {
515         ScratchWaveOffsetReg = Reg;
516         BuildMI(MBB, I, DL, TII->get(AMDGPU::COPY), ScratchWaveOffsetReg)
517             .addReg(PreloadedScratchWaveOffsetReg, RegState::Kill);
518         break;
519       }
520     }
521   } else {
522     ScratchWaveOffsetReg = PreloadedScratchWaveOffsetReg;
523   }
524   assert(ScratchWaveOffsetReg);
525 
526   if (requiresStackPointerReference(MF)) {
527     Register SPReg = MFI->getStackPtrOffsetReg();
528     assert(SPReg != AMDGPU::SP_REG);
529     BuildMI(MBB, I, DL, TII->get(AMDGPU::S_MOV_B32), SPReg)
530         .addImm(MF.getFrameInfo().getStackSize() * getScratchScaleFactor(ST));
531   }
532 
533   if (hasFP(MF)) {
534     Register FPReg = MFI->getFrameOffsetReg();
535     assert(FPReg != AMDGPU::FP_REG);
536     BuildMI(MBB, I, DL, TII->get(AMDGPU::S_MOV_B32), FPReg).addImm(0);
537   }
538 
539   if (MFI->hasFlatScratchInit() || ScratchRsrcReg) {
540     MRI.addLiveIn(PreloadedScratchWaveOffsetReg);
541     MBB.addLiveIn(PreloadedScratchWaveOffsetReg);
542   }
543 
544   if (MFI->hasFlatScratchInit()) {
545     emitEntryFunctionFlatScratchInit(MF, MBB, I, DL, ScratchWaveOffsetReg);
546   }
547 
548   if (ScratchRsrcReg) {
549     emitEntryFunctionScratchRsrcRegSetup(MF, MBB, I, DL,
550                                          PreloadedScratchRsrcReg,
551                                          ScratchRsrcReg, ScratchWaveOffsetReg);
552   }
553 }
554 
555 // Emit scratch RSRC setup code, assuming `ScratchRsrcReg != AMDGPU::NoReg`
556 void SIFrameLowering::emitEntryFunctionScratchRsrcRegSetup(
557     MachineFunction &MF, MachineBasicBlock &MBB, MachineBasicBlock::iterator I,
558     const DebugLoc &DL, Register PreloadedScratchRsrcReg,
559     Register ScratchRsrcReg, Register ScratchWaveOffsetReg) const {
560 
561   const GCNSubtarget &ST = MF.getSubtarget<GCNSubtarget>();
562   const SIInstrInfo *TII = ST.getInstrInfo();
563   const SIRegisterInfo *TRI = &TII->getRegisterInfo();
564   const SIMachineFunctionInfo *MFI = MF.getInfo<SIMachineFunctionInfo>();
565   const Function &Fn = MF.getFunction();
566 
567   if (ST.isAmdPalOS()) {
568     // The pointer to the GIT is formed from the offset passed in and either
569     // the amdgpu-git-ptr-high function attribute or the top part of the PC
570     Register RsrcLo = TRI->getSubReg(ScratchRsrcReg, AMDGPU::sub0);
571     Register RsrcHi = TRI->getSubReg(ScratchRsrcReg, AMDGPU::sub1);
572     Register Rsrc01 = TRI->getSubReg(ScratchRsrcReg, AMDGPU::sub0_sub1);
573 
574     const MCInstrDesc &SMovB32 = TII->get(AMDGPU::S_MOV_B32);
575 
576     if (MFI->getGITPtrHigh() != 0xffffffff) {
577       BuildMI(MBB, I, DL, SMovB32, RsrcHi)
578         .addImm(MFI->getGITPtrHigh())
579         .addReg(ScratchRsrcReg, RegState::ImplicitDefine);
580     } else {
581       const MCInstrDesc &GetPC64 = TII->get(AMDGPU::S_GETPC_B64);
582       BuildMI(MBB, I, DL, GetPC64, Rsrc01);
583     }
584     Register GitPtrLo = MFI->getGITPtrLoReg(MF);
585     MF.getRegInfo().addLiveIn(GitPtrLo);
586     MBB.addLiveIn(GitPtrLo);
587     BuildMI(MBB, I, DL, SMovB32, RsrcLo)
588       .addReg(GitPtrLo)
589       .addReg(ScratchRsrcReg, RegState::ImplicitDefine);
590 
591     // We now have the GIT ptr - now get the scratch descriptor from the entry
592     // at offset 0 (or offset 16 for a compute shader).
593     MachinePointerInfo PtrInfo(AMDGPUAS::CONSTANT_ADDRESS);
594     const MCInstrDesc &LoadDwordX4 = TII->get(AMDGPU::S_LOAD_DWORDX4_IMM);
595     auto MMO = MF.getMachineMemOperand(PtrInfo,
596                                        MachineMemOperand::MOLoad |
597                                            MachineMemOperand::MOInvariant |
598                                            MachineMemOperand::MODereferenceable,
599                                        16, Align(4));
600     unsigned Offset = Fn.getCallingConv() == CallingConv::AMDGPU_CS ? 16 : 0;
601     const GCNSubtarget &Subtarget = MF.getSubtarget<GCNSubtarget>();
602     unsigned EncodedOffset = AMDGPU::convertSMRDOffsetUnits(Subtarget, Offset);
603     BuildMI(MBB, I, DL, LoadDwordX4, ScratchRsrcReg)
604       .addReg(Rsrc01)
605       .addImm(EncodedOffset) // offset
606       .addImm(0) // glc
607       .addImm(0) // dlc
608       .addReg(ScratchRsrcReg, RegState::ImplicitDefine)
609       .addMemOperand(MMO);
610   } else if (ST.isMesaGfxShader(Fn) || !PreloadedScratchRsrcReg) {
611     assert(!ST.isAmdHsaOrMesa(Fn));
612     const MCInstrDesc &SMovB32 = TII->get(AMDGPU::S_MOV_B32);
613 
614     Register Rsrc2 = TRI->getSubReg(ScratchRsrcReg, AMDGPU::sub2);
615     Register Rsrc3 = TRI->getSubReg(ScratchRsrcReg, AMDGPU::sub3);
616 
617     // Use relocations to get the pointer, and setup the other bits manually.
618     uint64_t Rsrc23 = TII->getScratchRsrcWords23();
619 
620     if (MFI->hasImplicitBufferPtr()) {
621       Register Rsrc01 = TRI->getSubReg(ScratchRsrcReg, AMDGPU::sub0_sub1);
622 
623       if (AMDGPU::isCompute(MF.getFunction().getCallingConv())) {
624         const MCInstrDesc &Mov64 = TII->get(AMDGPU::S_MOV_B64);
625 
626         BuildMI(MBB, I, DL, Mov64, Rsrc01)
627           .addReg(MFI->getImplicitBufferPtrUserSGPR())
628           .addReg(ScratchRsrcReg, RegState::ImplicitDefine);
629       } else {
630         const MCInstrDesc &LoadDwordX2 = TII->get(AMDGPU::S_LOAD_DWORDX2_IMM);
631 
632         MachinePointerInfo PtrInfo(AMDGPUAS::CONSTANT_ADDRESS);
633         auto MMO = MF.getMachineMemOperand(
634             PtrInfo,
635             MachineMemOperand::MOLoad | MachineMemOperand::MOInvariant |
636                 MachineMemOperand::MODereferenceable,
637             8, Align(4));
638         BuildMI(MBB, I, DL, LoadDwordX2, Rsrc01)
639           .addReg(MFI->getImplicitBufferPtrUserSGPR())
640           .addImm(0) // offset
641           .addImm(0) // glc
642           .addImm(0) // dlc
643           .addMemOperand(MMO)
644           .addReg(ScratchRsrcReg, RegState::ImplicitDefine);
645 
646         MF.getRegInfo().addLiveIn(MFI->getImplicitBufferPtrUserSGPR());
647         MBB.addLiveIn(MFI->getImplicitBufferPtrUserSGPR());
648       }
649     } else {
650       Register Rsrc0 = TRI->getSubReg(ScratchRsrcReg, AMDGPU::sub0);
651       Register Rsrc1 = TRI->getSubReg(ScratchRsrcReg, AMDGPU::sub1);
652 
653       BuildMI(MBB, I, DL, SMovB32, Rsrc0)
654         .addExternalSymbol("SCRATCH_RSRC_DWORD0")
655         .addReg(ScratchRsrcReg, RegState::ImplicitDefine);
656 
657       BuildMI(MBB, I, DL, SMovB32, Rsrc1)
658         .addExternalSymbol("SCRATCH_RSRC_DWORD1")
659         .addReg(ScratchRsrcReg, RegState::ImplicitDefine);
660 
661     }
662 
663     BuildMI(MBB, I, DL, SMovB32, Rsrc2)
664       .addImm(Rsrc23 & 0xffffffff)
665       .addReg(ScratchRsrcReg, RegState::ImplicitDefine);
666 
667     BuildMI(MBB, I, DL, SMovB32, Rsrc3)
668       .addImm(Rsrc23 >> 32)
669       .addReg(ScratchRsrcReg, RegState::ImplicitDefine);
670   } else if (ST.isAmdHsaOrMesa(Fn)) {
671     assert(PreloadedScratchRsrcReg);
672 
673     if (ScratchRsrcReg != PreloadedScratchRsrcReg) {
674       BuildMI(MBB, I, DL, TII->get(AMDGPU::COPY), ScratchRsrcReg)
675           .addReg(PreloadedScratchRsrcReg, RegState::Kill);
676     }
677   }
678 
679   // Add the scratch wave offset into the scratch RSRC.
680   //
681   // We only want to update the first 48 bits, which is the base address
682   // pointer, without touching the adjacent 16 bits of flags. We know this add
683   // cannot carry-out from bit 47, otherwise the scratch allocation would be
684   // impossible to fit in the 48-bit global address space.
685   //
686   // TODO: Evaluate if it is better to just construct an SRD using the flat
687   // scratch init and some constants rather than update the one we are passed.
688   Register ScratchRsrcSub0 = TRI->getSubReg(ScratchRsrcReg, AMDGPU::sub0);
689   Register ScratchRsrcSub1 = TRI->getSubReg(ScratchRsrcReg, AMDGPU::sub1);
690 
691   // We cannot Kill ScratchWaveOffsetReg here because we allow it to be used in
692   // the kernel body via inreg arguments.
693   BuildMI(MBB, I, DL, TII->get(AMDGPU::S_ADD_U32), ScratchRsrcSub0)
694       .addReg(ScratchRsrcSub0)
695       .addReg(ScratchWaveOffsetReg)
696       .addReg(ScratchRsrcReg, RegState::ImplicitDefine);
697   BuildMI(MBB, I, DL, TII->get(AMDGPU::S_ADDC_U32), ScratchRsrcSub1)
698       .addReg(ScratchRsrcSub1)
699       .addImm(0)
700       .addReg(ScratchRsrcReg, RegState::ImplicitDefine);
701 }
702 
703 bool SIFrameLowering::isSupportedStackID(TargetStackID::Value ID) const {
704   switch (ID) {
705   case TargetStackID::Default:
706   case TargetStackID::NoAlloc:
707   case TargetStackID::SGPRSpill:
708     return true;
709   case TargetStackID::SVEVector:
710     return false;
711   }
712   llvm_unreachable("Invalid TargetStackID::Value");
713 }
714 
715 // Activate all lanes, returns saved exec.
716 static Register buildScratchExecCopy(LivePhysRegs &LiveRegs,
717                                      MachineFunction &MF,
718                                      MachineBasicBlock &MBB,
719                                      MachineBasicBlock::iterator MBBI,
720                                      bool IsProlog) {
721   Register ScratchExecCopy;
722   MachineRegisterInfo &MRI = MF.getRegInfo();
723   const GCNSubtarget &ST = MF.getSubtarget<GCNSubtarget>();
724   const SIInstrInfo *TII = ST.getInstrInfo();
725   const SIRegisterInfo &TRI = TII->getRegisterInfo();
726   SIMachineFunctionInfo *FuncInfo = MF.getInfo<SIMachineFunctionInfo>();
727   DebugLoc DL;
728 
729   if (LiveRegs.empty()) {
730     if (IsProlog) {
731       LiveRegs.init(TRI);
732       LiveRegs.addLiveIns(MBB);
733       if (FuncInfo->SGPRForFPSaveRestoreCopy)
734         LiveRegs.removeReg(FuncInfo->SGPRForFPSaveRestoreCopy);
735 
736       if (FuncInfo->SGPRForBPSaveRestoreCopy)
737         LiveRegs.removeReg(FuncInfo->SGPRForBPSaveRestoreCopy);
738     } else {
739       // In epilog.
740       LiveRegs.init(*ST.getRegisterInfo());
741       LiveRegs.addLiveOuts(MBB);
742       LiveRegs.stepBackward(*MBBI);
743     }
744   }
745 
746   ScratchExecCopy = findScratchNonCalleeSaveRegister(
747       MRI, LiveRegs, *TRI.getWaveMaskRegClass());
748 
749   if (!IsProlog)
750     LiveRegs.removeReg(ScratchExecCopy);
751 
752   const unsigned OrSaveExec =
753       ST.isWave32() ? AMDGPU::S_OR_SAVEEXEC_B32 : AMDGPU::S_OR_SAVEEXEC_B64;
754   BuildMI(MBB, MBBI, DL, TII->get(OrSaveExec), ScratchExecCopy).addImm(-1);
755 
756   return ScratchExecCopy;
757 }
758 
759 void SIFrameLowering::emitPrologue(MachineFunction &MF,
760                                    MachineBasicBlock &MBB) const {
761   SIMachineFunctionInfo *FuncInfo = MF.getInfo<SIMachineFunctionInfo>();
762   if (FuncInfo->isEntryFunction()) {
763     emitEntryFunctionPrologue(MF, MBB);
764     return;
765   }
766 
767   const MachineFrameInfo &MFI = MF.getFrameInfo();
768   MachineRegisterInfo &MRI = MF.getRegInfo();
769   const GCNSubtarget &ST = MF.getSubtarget<GCNSubtarget>();
770   const SIInstrInfo *TII = ST.getInstrInfo();
771   const SIRegisterInfo &TRI = TII->getRegisterInfo();
772 
773   Register StackPtrReg = FuncInfo->getStackPtrOffsetReg();
774   Register FramePtrReg = FuncInfo->getFrameOffsetReg();
775   Register BasePtrReg =
776       TRI.hasBasePointer(MF) ? TRI.getBaseRegister() : Register();
777   LivePhysRegs LiveRegs;
778 
779   MachineBasicBlock::iterator MBBI = MBB.begin();
780   DebugLoc DL;
781 
782   bool HasFP = false;
783   bool HasBP = false;
784   uint32_t NumBytes = MFI.getStackSize();
785   uint32_t RoundedSize = NumBytes;
786   // To avoid clobbering VGPRs in lanes that weren't active on function entry,
787   // turn on all lanes before doing the spill to memory.
788   Register ScratchExecCopy;
789 
790   bool HasFPSaveIndex = FuncInfo->FramePointerSaveIndex.hasValue();
791   bool SpillFPToMemory = false;
792   // A StackID of SGPRSpill implies that this is a spill from SGPR to VGPR.
793   // Otherwise we are spilling the FP to memory.
794   if (HasFPSaveIndex) {
795     SpillFPToMemory = MFI.getStackID(*FuncInfo->FramePointerSaveIndex) !=
796                       TargetStackID::SGPRSpill;
797   }
798 
799   bool HasBPSaveIndex = FuncInfo->BasePointerSaveIndex.hasValue();
800   bool SpillBPToMemory = false;
801   // A StackID of SGPRSpill implies that this is a spill from SGPR to VGPR.
802   // Otherwise we are spilling the BP to memory.
803   if (HasBPSaveIndex) {
804     SpillBPToMemory = MFI.getStackID(*FuncInfo->BasePointerSaveIndex) !=
805                       TargetStackID::SGPRSpill;
806   }
807 
808   // Emit the copy if we need an FP, and are using a free SGPR to save it.
809   if (FuncInfo->SGPRForFPSaveRestoreCopy) {
810     BuildMI(MBB, MBBI, DL, TII->get(AMDGPU::COPY), FuncInfo->SGPRForFPSaveRestoreCopy)
811       .addReg(FramePtrReg)
812       .setMIFlag(MachineInstr::FrameSetup);
813   }
814 
815   // Emit the copy if we need a BP, and are using a free SGPR to save it.
816   if (FuncInfo->SGPRForBPSaveRestoreCopy) {
817     BuildMI(MBB, MBBI, DL, TII->get(AMDGPU::COPY),
818             FuncInfo->SGPRForBPSaveRestoreCopy)
819         .addReg(BasePtrReg)
820         .setMIFlag(MachineInstr::FrameSetup);
821   }
822 
823   // If a copy has been emitted for FP and/or BP, Make the SGPRs
824   // used in the copy instructions live throughout the function.
825   SmallVector<MCPhysReg, 2> TempSGPRs;
826   if (FuncInfo->SGPRForFPSaveRestoreCopy)
827     TempSGPRs.push_back(FuncInfo->SGPRForFPSaveRestoreCopy);
828 
829   if (FuncInfo->SGPRForBPSaveRestoreCopy)
830     TempSGPRs.push_back(FuncInfo->SGPRForBPSaveRestoreCopy);
831 
832   if (!TempSGPRs.empty()) {
833     for (MachineBasicBlock &MBB : MF) {
834       for (MCPhysReg Reg : TempSGPRs)
835         MBB.addLiveIn(Reg);
836 
837       MBB.sortUniqueLiveIns();
838     }
839   }
840 
841   for (const SIMachineFunctionInfo::SGPRSpillVGPRCSR &Reg
842          : FuncInfo->getSGPRSpillVGPRs()) {
843     if (!Reg.FI.hasValue())
844       continue;
845 
846     if (!ScratchExecCopy)
847       ScratchExecCopy = buildScratchExecCopy(LiveRegs, MF, MBB, MBBI, true);
848 
849     buildPrologSpill(ST, LiveRegs, MBB, MBBI, TII, Reg.VGPR,
850                      FuncInfo->getScratchRSrcReg(),
851                      StackPtrReg,
852                      Reg.FI.getValue());
853   }
854 
855   if (HasFPSaveIndex && SpillFPToMemory) {
856     assert(!MFI.isDeadObjectIndex(FuncInfo->FramePointerSaveIndex.getValue()));
857 
858     if (!ScratchExecCopy)
859       ScratchExecCopy = buildScratchExecCopy(LiveRegs, MF, MBB, MBBI, true);
860 
861     MCPhysReg TmpVGPR = findScratchNonCalleeSaveRegister(
862         MRI, LiveRegs, AMDGPU::VGPR_32RegClass);
863 
864     BuildMI(MBB, MBBI, DL, TII->get(AMDGPU::V_MOV_B32_e32), TmpVGPR)
865         .addReg(FramePtrReg);
866 
867     buildPrologSpill(ST, LiveRegs, MBB, MBBI, TII, TmpVGPR,
868                      FuncInfo->getScratchRSrcReg(), StackPtrReg,
869                      FuncInfo->FramePointerSaveIndex.getValue());
870   }
871 
872   if (HasBPSaveIndex && SpillBPToMemory) {
873     assert(!MFI.isDeadObjectIndex(*FuncInfo->BasePointerSaveIndex));
874 
875     if (!ScratchExecCopy)
876       ScratchExecCopy = buildScratchExecCopy(LiveRegs, MF, MBB, MBBI, true);
877 
878     MCPhysReg TmpVGPR = findScratchNonCalleeSaveRegister(
879         MRI, LiveRegs, AMDGPU::VGPR_32RegClass);
880 
881     BuildMI(MBB, MBBI, DL, TII->get(AMDGPU::V_MOV_B32_e32), TmpVGPR)
882         .addReg(BasePtrReg);
883 
884     buildPrologSpill(ST, LiveRegs, MBB, MBBI, TII, TmpVGPR,
885                      FuncInfo->getScratchRSrcReg(), StackPtrReg,
886                      *FuncInfo->BasePointerSaveIndex);
887   }
888 
889   if (ScratchExecCopy) {
890     // FIXME: Split block and make terminator.
891     unsigned ExecMov = ST.isWave32() ? AMDGPU::S_MOV_B32 : AMDGPU::S_MOV_B64;
892     MCRegister Exec = ST.isWave32() ? AMDGPU::EXEC_LO : AMDGPU::EXEC;
893     BuildMI(MBB, MBBI, DL, TII->get(ExecMov), Exec)
894         .addReg(ScratchExecCopy, RegState::Kill);
895     LiveRegs.addReg(ScratchExecCopy);
896   }
897 
898   // In this case, spill the FP to a reserved VGPR.
899   if (HasFPSaveIndex && !SpillFPToMemory) {
900     const int FI = FuncInfo->FramePointerSaveIndex.getValue();
901     assert(!MFI.isDeadObjectIndex(FI));
902 
903     assert(MFI.getStackID(FI) == TargetStackID::SGPRSpill);
904     ArrayRef<SIMachineFunctionInfo::SpilledReg> Spill =
905         FuncInfo->getSGPRToVGPRSpills(FI);
906     assert(Spill.size() == 1);
907 
908     // Save FP before setting it up.
909     // FIXME: This should respect spillSGPRToVGPR;
910     BuildMI(MBB, MBBI, DL, TII->get(AMDGPU::V_WRITELANE_B32), Spill[0].VGPR)
911         .addReg(FramePtrReg)
912         .addImm(Spill[0].Lane)
913         .addReg(Spill[0].VGPR, RegState::Undef);
914   }
915 
916   // In this case, spill the BP to a reserved VGPR.
917   if (HasBPSaveIndex && !SpillBPToMemory) {
918     const int BasePtrFI = *FuncInfo->BasePointerSaveIndex;
919     assert(!MFI.isDeadObjectIndex(BasePtrFI));
920 
921     assert(MFI.getStackID(BasePtrFI) == TargetStackID::SGPRSpill);
922     ArrayRef<SIMachineFunctionInfo::SpilledReg> Spill =
923         FuncInfo->getSGPRToVGPRSpills(BasePtrFI);
924     assert(Spill.size() == 1);
925 
926     // Save BP before setting it up.
927     // FIXME: This should respect spillSGPRToVGPR;
928     BuildMI(MBB, MBBI, DL, TII->get(AMDGPU::V_WRITELANE_B32), Spill[0].VGPR)
929         .addReg(BasePtrReg)
930         .addImm(Spill[0].Lane)
931         .addReg(Spill[0].VGPR, RegState::Undef);
932   }
933 
934   if (TRI.needsStackRealignment(MF)) {
935     HasFP = true;
936     const unsigned Alignment = MFI.getMaxAlign().value();
937 
938     RoundedSize += Alignment;
939     if (LiveRegs.empty()) {
940       LiveRegs.init(TRI);
941       LiveRegs.addLiveIns(MBB);
942       LiveRegs.addReg(FuncInfo->SGPRForFPSaveRestoreCopy);
943       LiveRegs.addReg(FuncInfo->SGPRForBPSaveRestoreCopy);
944     }
945 
946     Register ScratchSPReg = findScratchNonCalleeSaveRegister(
947         MRI, LiveRegs, AMDGPU::SReg_32_XM0RegClass);
948     assert(ScratchSPReg && ScratchSPReg != FuncInfo->SGPRForFPSaveRestoreCopy &&
949            ScratchSPReg != FuncInfo->SGPRForBPSaveRestoreCopy);
950 
951     // s_add_u32 tmp_reg, s32, NumBytes
952     // s_and_b32 s32, tmp_reg, 0b111...0000
953     BuildMI(MBB, MBBI, DL, TII->get(AMDGPU::S_ADD_U32), ScratchSPReg)
954         .addReg(StackPtrReg)
955         .addImm((Alignment - 1) * getScratchScaleFactor(ST))
956         .setMIFlag(MachineInstr::FrameSetup);
957     BuildMI(MBB, MBBI, DL, TII->get(AMDGPU::S_AND_B32), FramePtrReg)
958         .addReg(ScratchSPReg, RegState::Kill)
959         .addImm(-Alignment * getScratchScaleFactor(ST))
960         .setMIFlag(MachineInstr::FrameSetup);
961     FuncInfo->setIsStackRealigned(true);
962   } else if ((HasFP = hasFP(MF))) {
963     BuildMI(MBB, MBBI, DL, TII->get(AMDGPU::COPY), FramePtrReg)
964         .addReg(StackPtrReg)
965         .setMIFlag(MachineInstr::FrameSetup);
966   }
967 
968   // If we need a base pointer, set it up here. It's whatever the value of
969   // the stack pointer is at this point. Any variable size objects will be
970   // allocated after this, so we can still use the base pointer to reference
971   // the incoming arguments.
972   if ((HasBP = TRI.hasBasePointer(MF))) {
973     BuildMI(MBB, MBBI, DL, TII->get(AMDGPU::COPY), BasePtrReg)
974         .addReg(StackPtrReg)
975         .setMIFlag(MachineInstr::FrameSetup);
976   }
977 
978   if (HasFP && RoundedSize != 0) {
979     BuildMI(MBB, MBBI, DL, TII->get(AMDGPU::S_ADD_U32), StackPtrReg)
980         .addReg(StackPtrReg)
981         .addImm(RoundedSize * getScratchScaleFactor(ST))
982         .setMIFlag(MachineInstr::FrameSetup);
983   }
984 
985   assert((!HasFP || (FuncInfo->SGPRForFPSaveRestoreCopy ||
986                      FuncInfo->FramePointerSaveIndex)) &&
987          "Needed to save FP but didn't save it anywhere");
988 
989   assert((HasFP || (!FuncInfo->SGPRForFPSaveRestoreCopy &&
990                     !FuncInfo->FramePointerSaveIndex)) &&
991          "Saved FP but didn't need it");
992 
993   assert((!HasBP || (FuncInfo->SGPRForBPSaveRestoreCopy ||
994                      FuncInfo->BasePointerSaveIndex)) &&
995          "Needed to save BP but didn't save it anywhere");
996 
997   assert((HasBP || (!FuncInfo->SGPRForBPSaveRestoreCopy &&
998                     !FuncInfo->BasePointerSaveIndex)) &&
999          "Saved BP but didn't need it");
1000 }
1001 
1002 void SIFrameLowering::emitEpilogue(MachineFunction &MF,
1003                                    MachineBasicBlock &MBB) const {
1004   const SIMachineFunctionInfo *FuncInfo = MF.getInfo<SIMachineFunctionInfo>();
1005   if (FuncInfo->isEntryFunction())
1006     return;
1007 
1008   const GCNSubtarget &ST = MF.getSubtarget<GCNSubtarget>();
1009   const SIInstrInfo *TII = ST.getInstrInfo();
1010   MachineRegisterInfo &MRI = MF.getRegInfo();
1011   const SIRegisterInfo &TRI = TII->getRegisterInfo();
1012   MachineBasicBlock::iterator MBBI = MBB.getFirstTerminator();
1013   LivePhysRegs LiveRegs;
1014   DebugLoc DL;
1015 
1016   const MachineFrameInfo &MFI = MF.getFrameInfo();
1017   uint32_t NumBytes = MFI.getStackSize();
1018   uint32_t RoundedSize = FuncInfo->isStackRealigned()
1019                              ? NumBytes + MFI.getMaxAlign().value()
1020                              : NumBytes;
1021   const Register StackPtrReg = FuncInfo->getStackPtrOffsetReg();
1022   const Register FramePtrReg = FuncInfo->getFrameOffsetReg();
1023   const Register BasePtrReg =
1024       TRI.hasBasePointer(MF) ? TRI.getBaseRegister() : Register();
1025 
1026   bool HasFPSaveIndex = FuncInfo->FramePointerSaveIndex.hasValue();
1027   bool SpillFPToMemory = false;
1028   if (HasFPSaveIndex) {
1029     SpillFPToMemory = MFI.getStackID(*FuncInfo->FramePointerSaveIndex) !=
1030                       TargetStackID::SGPRSpill;
1031   }
1032 
1033   bool HasBPSaveIndex = FuncInfo->BasePointerSaveIndex.hasValue();
1034   bool SpillBPToMemory = false;
1035   if (HasBPSaveIndex) {
1036     SpillBPToMemory = MFI.getStackID(*FuncInfo->BasePointerSaveIndex) !=
1037                       TargetStackID::SGPRSpill;
1038   }
1039 
1040   if (RoundedSize != 0 && hasFP(MF)) {
1041     BuildMI(MBB, MBBI, DL, TII->get(AMDGPU::S_SUB_U32), StackPtrReg)
1042       .addReg(StackPtrReg)
1043       .addImm(RoundedSize * getScratchScaleFactor(ST))
1044       .setMIFlag(MachineInstr::FrameDestroy);
1045   }
1046 
1047   if (FuncInfo->SGPRForFPSaveRestoreCopy) {
1048     BuildMI(MBB, MBBI, DL, TII->get(AMDGPU::COPY), FramePtrReg)
1049         .addReg(FuncInfo->SGPRForFPSaveRestoreCopy)
1050         .setMIFlag(MachineInstr::FrameSetup);
1051   }
1052 
1053   if (FuncInfo->SGPRForBPSaveRestoreCopy) {
1054     BuildMI(MBB, MBBI, DL, TII->get(AMDGPU::COPY), BasePtrReg)
1055         .addReg(FuncInfo->SGPRForBPSaveRestoreCopy)
1056         .setMIFlag(MachineInstr::FrameSetup);
1057   }
1058 
1059   Register ScratchExecCopy;
1060   if (HasFPSaveIndex) {
1061     const int FI = FuncInfo->FramePointerSaveIndex.getValue();
1062     assert(!MFI.isDeadObjectIndex(FI));
1063     if (SpillFPToMemory) {
1064       if (!ScratchExecCopy)
1065         ScratchExecCopy = buildScratchExecCopy(LiveRegs, MF, MBB, MBBI, false);
1066 
1067       MCPhysReg TempVGPR = findScratchNonCalleeSaveRegister(
1068           MRI, LiveRegs, AMDGPU::VGPR_32RegClass);
1069       buildEpilogReload(ST, LiveRegs, MBB, MBBI, TII, TempVGPR,
1070                         FuncInfo->getScratchRSrcReg(), StackPtrReg, FI);
1071       BuildMI(MBB, MBBI, DL, TII->get(AMDGPU::V_READFIRSTLANE_B32), FramePtrReg)
1072           .addReg(TempVGPR, RegState::Kill);
1073     } else {
1074       // Reload from VGPR spill.
1075       assert(MFI.getStackID(FI) == TargetStackID::SGPRSpill);
1076       ArrayRef<SIMachineFunctionInfo::SpilledReg> Spill =
1077           FuncInfo->getSGPRToVGPRSpills(FI);
1078       assert(Spill.size() == 1);
1079       BuildMI(MBB, MBBI, DL, TII->get(AMDGPU::V_READLANE_B32), FramePtrReg)
1080           .addReg(Spill[0].VGPR)
1081           .addImm(Spill[0].Lane);
1082     }
1083   }
1084 
1085   if (HasBPSaveIndex) {
1086     const int BasePtrFI = *FuncInfo->BasePointerSaveIndex;
1087     assert(!MFI.isDeadObjectIndex(BasePtrFI));
1088     if (SpillBPToMemory) {
1089       if (!ScratchExecCopy)
1090         ScratchExecCopy = buildScratchExecCopy(LiveRegs, MF, MBB, MBBI, false);
1091 
1092       MCPhysReg TempVGPR = findScratchNonCalleeSaveRegister(
1093           MRI, LiveRegs, AMDGPU::VGPR_32RegClass);
1094       buildEpilogReload(ST, LiveRegs, MBB, MBBI, TII, TempVGPR,
1095                         FuncInfo->getScratchRSrcReg(), StackPtrReg, BasePtrFI);
1096       BuildMI(MBB, MBBI, DL, TII->get(AMDGPU::V_READFIRSTLANE_B32), BasePtrReg)
1097           .addReg(TempVGPR, RegState::Kill);
1098     } else {
1099       // Reload from VGPR spill.
1100       assert(MFI.getStackID(BasePtrFI) == TargetStackID::SGPRSpill);
1101       ArrayRef<SIMachineFunctionInfo::SpilledReg> Spill =
1102           FuncInfo->getSGPRToVGPRSpills(BasePtrFI);
1103       assert(Spill.size() == 1);
1104       BuildMI(MBB, MBBI, DL, TII->get(AMDGPU::V_READLANE_B32), BasePtrReg)
1105           .addReg(Spill[0].VGPR)
1106           .addImm(Spill[0].Lane);
1107     }
1108   }
1109 
1110   for (const SIMachineFunctionInfo::SGPRSpillVGPRCSR &Reg :
1111        FuncInfo->getSGPRSpillVGPRs()) {
1112     if (!Reg.FI.hasValue())
1113       continue;
1114 
1115     if (!ScratchExecCopy)
1116       ScratchExecCopy = buildScratchExecCopy(LiveRegs, MF, MBB, MBBI, false);
1117 
1118     buildEpilogReload(ST, LiveRegs, MBB, MBBI, TII, Reg.VGPR,
1119                       FuncInfo->getScratchRSrcReg(), StackPtrReg,
1120                       Reg.FI.getValue());
1121   }
1122 
1123   if (ScratchExecCopy) {
1124     // FIXME: Split block and make terminator.
1125     unsigned ExecMov = ST.isWave32() ? AMDGPU::S_MOV_B32 : AMDGPU::S_MOV_B64;
1126     MCRegister Exec = ST.isWave32() ? AMDGPU::EXEC_LO : AMDGPU::EXEC;
1127     BuildMI(MBB, MBBI, DL, TII->get(ExecMov), Exec)
1128         .addReg(ScratchExecCopy, RegState::Kill);
1129   }
1130 }
1131 
1132 // Note SGPRSpill stack IDs should only be used for SGPR spilling to VGPRs, not
1133 // memory. They should have been removed by now.
1134 static bool allStackObjectsAreDead(const MachineFrameInfo &MFI) {
1135   for (int I = MFI.getObjectIndexBegin(), E = MFI.getObjectIndexEnd();
1136        I != E; ++I) {
1137     if (!MFI.isDeadObjectIndex(I))
1138       return false;
1139   }
1140 
1141   return true;
1142 }
1143 
1144 #ifndef NDEBUG
1145 static bool allSGPRSpillsAreDead(const MachineFunction &MF) {
1146   const MachineFrameInfo &MFI = MF.getFrameInfo();
1147   const SIMachineFunctionInfo *FuncInfo = MF.getInfo<SIMachineFunctionInfo>();
1148   for (int I = MFI.getObjectIndexBegin(), E = MFI.getObjectIndexEnd();
1149        I != E; ++I) {
1150     if (!MFI.isDeadObjectIndex(I) &&
1151         MFI.getStackID(I) == TargetStackID::SGPRSpill &&
1152         (I != FuncInfo->FramePointerSaveIndex &&
1153          I != FuncInfo->BasePointerSaveIndex)) {
1154       return false;
1155     }
1156   }
1157 
1158   return true;
1159 }
1160 #endif
1161 
1162 StackOffset SIFrameLowering::getFrameIndexReference(const MachineFunction &MF,
1163                                                     int FI,
1164                                                     Register &FrameReg) const {
1165   const SIRegisterInfo *RI = MF.getSubtarget<GCNSubtarget>().getRegisterInfo();
1166 
1167   FrameReg = RI->getFrameRegister(MF);
1168   return StackOffset::getFixed(MF.getFrameInfo().getObjectOffset(FI));
1169 }
1170 
1171 void SIFrameLowering::processFunctionBeforeFrameFinalized(
1172   MachineFunction &MF,
1173   RegScavenger *RS) const {
1174   MachineFrameInfo &MFI = MF.getFrameInfo();
1175 
1176   const GCNSubtarget &ST = MF.getSubtarget<GCNSubtarget>();
1177   const SIRegisterInfo *TRI = ST.getRegisterInfo();
1178   SIMachineFunctionInfo *FuncInfo = MF.getInfo<SIMachineFunctionInfo>();
1179 
1180   FuncInfo->removeDeadFrameIndices(MFI);
1181   assert(allSGPRSpillsAreDead(MF) &&
1182          "SGPR spill should have been removed in SILowerSGPRSpills");
1183 
1184   // FIXME: The other checks should be redundant with allStackObjectsAreDead,
1185   // but currently hasNonSpillStackObjects is set only from source
1186   // allocas. Stack temps produced from legalization are not counted currently.
1187   if (!allStackObjectsAreDead(MFI)) {
1188     assert(RS && "RegScavenger required if spilling");
1189 
1190     if (FuncInfo->isEntryFunction()) {
1191       int ScavengeFI = MFI.CreateFixedObject(
1192         TRI->getSpillSize(AMDGPU::SGPR_32RegClass), 0, false);
1193       RS->addScavengingFrameIndex(ScavengeFI);
1194     } else {
1195       int ScavengeFI = MFI.CreateStackObject(
1196           TRI->getSpillSize(AMDGPU::SGPR_32RegClass),
1197           TRI->getSpillAlign(AMDGPU::SGPR_32RegClass), false);
1198       RS->addScavengingFrameIndex(ScavengeFI);
1199     }
1200   }
1201 }
1202 
1203 // Only report VGPRs to generic code.
1204 void SIFrameLowering::determineCalleeSaves(MachineFunction &MF,
1205                                            BitVector &SavedVGPRs,
1206                                            RegScavenger *RS) const {
1207   TargetFrameLowering::determineCalleeSaves(MF, SavedVGPRs, RS);
1208   SIMachineFunctionInfo *MFI = MF.getInfo<SIMachineFunctionInfo>();
1209   if (MFI->isEntryFunction())
1210     return;
1211 
1212   MachineFrameInfo &FrameInfo = MF.getFrameInfo();
1213   const GCNSubtarget &ST = MF.getSubtarget<GCNSubtarget>();
1214   const SIRegisterInfo *TRI = ST.getRegisterInfo();
1215 
1216   // Ignore the SGPRs the default implementation found.
1217   SavedVGPRs.clearBitsNotInMask(TRI->getAllVGPRRegMask());
1218 
1219   // hasFP only knows about stack objects that already exist. We're now
1220   // determining the stack slots that will be created, so we have to predict
1221   // them. Stack objects force FP usage with calls.
1222   //
1223   // Note a new VGPR CSR may be introduced if one is used for the spill, but we
1224   // don't want to report it here.
1225   //
1226   // FIXME: Is this really hasReservedCallFrame?
1227   const bool WillHaveFP =
1228       FrameInfo.hasCalls() &&
1229       (SavedVGPRs.any() || !allStackObjectsAreDead(FrameInfo));
1230 
1231   // VGPRs used for SGPR spilling need to be specially inserted in the prolog,
1232   // so don't allow the default insertion to handle them.
1233   for (auto SSpill : MFI->getSGPRSpillVGPRs())
1234     SavedVGPRs.reset(SSpill.VGPR);
1235 
1236   LivePhysRegs LiveRegs;
1237   LiveRegs.init(*TRI);
1238 
1239   if (WillHaveFP || hasFP(MF)) {
1240     getVGPRSpillLaneOrTempRegister(MF, LiveRegs, MFI->SGPRForFPSaveRestoreCopy,
1241                                    MFI->FramePointerSaveIndex, true);
1242   }
1243 
1244   if (TRI->hasBasePointer(MF)) {
1245     if (MFI->SGPRForFPSaveRestoreCopy)
1246       LiveRegs.addReg(MFI->SGPRForFPSaveRestoreCopy);
1247     getVGPRSpillLaneOrTempRegister(MF, LiveRegs, MFI->SGPRForBPSaveRestoreCopy,
1248                                    MFI->BasePointerSaveIndex, false);
1249   }
1250 }
1251 
1252 void SIFrameLowering::determineCalleeSavesSGPR(MachineFunction &MF,
1253                                                BitVector &SavedRegs,
1254                                                RegScavenger *RS) const {
1255   TargetFrameLowering::determineCalleeSaves(MF, SavedRegs, RS);
1256   const SIMachineFunctionInfo *MFI = MF.getInfo<SIMachineFunctionInfo>();
1257   if (MFI->isEntryFunction())
1258     return;
1259 
1260   const GCNSubtarget &ST = MF.getSubtarget<GCNSubtarget>();
1261   const SIRegisterInfo *TRI = ST.getRegisterInfo();
1262 
1263   // The SP is specifically managed and we don't want extra spills of it.
1264   SavedRegs.reset(MFI->getStackPtrOffsetReg());
1265   SavedRegs.clearBitsInMask(TRI->getAllVGPRRegMask());
1266 }
1267 
1268 bool SIFrameLowering::assignCalleeSavedSpillSlots(
1269     MachineFunction &MF, const TargetRegisterInfo *TRI,
1270     std::vector<CalleeSavedInfo> &CSI) const {
1271   if (CSI.empty())
1272     return true; // Early exit if no callee saved registers are modified!
1273 
1274   const SIMachineFunctionInfo *FuncInfo = MF.getInfo<SIMachineFunctionInfo>();
1275   if (!FuncInfo->SGPRForFPSaveRestoreCopy &&
1276       !FuncInfo->SGPRForBPSaveRestoreCopy)
1277     return false;
1278 
1279   const GCNSubtarget &ST = MF.getSubtarget<GCNSubtarget>();
1280   const SIRegisterInfo *RI = ST.getRegisterInfo();
1281   Register FramePtrReg = FuncInfo->getFrameOffsetReg();
1282   Register BasePtrReg = RI->getBaseRegister();
1283   unsigned NumModifiedRegs = 0;
1284 
1285   if (FuncInfo->SGPRForFPSaveRestoreCopy)
1286     NumModifiedRegs++;
1287   if (FuncInfo->SGPRForBPSaveRestoreCopy)
1288     NumModifiedRegs++;
1289 
1290   for (auto &CS : CSI) {
1291     if (CS.getReg() == FramePtrReg && FuncInfo->SGPRForFPSaveRestoreCopy) {
1292       CS.setDstReg(FuncInfo->SGPRForFPSaveRestoreCopy);
1293       if (--NumModifiedRegs)
1294         break;
1295     } else if (CS.getReg() == BasePtrReg &&
1296                FuncInfo->SGPRForBPSaveRestoreCopy) {
1297       CS.setDstReg(FuncInfo->SGPRForBPSaveRestoreCopy);
1298       if (--NumModifiedRegs)
1299         break;
1300     }
1301   }
1302 
1303   return false;
1304 }
1305 
1306 MachineBasicBlock::iterator SIFrameLowering::eliminateCallFramePseudoInstr(
1307   MachineFunction &MF,
1308   MachineBasicBlock &MBB,
1309   MachineBasicBlock::iterator I) const {
1310   int64_t Amount = I->getOperand(0).getImm();
1311   if (Amount == 0)
1312     return MBB.erase(I);
1313 
1314   const GCNSubtarget &ST = MF.getSubtarget<GCNSubtarget>();
1315   const SIInstrInfo *TII = ST.getInstrInfo();
1316   const DebugLoc &DL = I->getDebugLoc();
1317   unsigned Opc = I->getOpcode();
1318   bool IsDestroy = Opc == TII->getCallFrameDestroyOpcode();
1319   uint64_t CalleePopAmount = IsDestroy ? I->getOperand(1).getImm() : 0;
1320 
1321   if (!hasReservedCallFrame(MF)) {
1322     Amount = alignTo(Amount, getStackAlign());
1323     assert(isUInt<32>(Amount) && "exceeded stack address space size");
1324     const SIMachineFunctionInfo *MFI = MF.getInfo<SIMachineFunctionInfo>();
1325     Register SPReg = MFI->getStackPtrOffsetReg();
1326 
1327     unsigned Op = IsDestroy ? AMDGPU::S_SUB_U32 : AMDGPU::S_ADD_U32;
1328     BuildMI(MBB, I, DL, TII->get(Op), SPReg)
1329       .addReg(SPReg)
1330       .addImm(Amount * getScratchScaleFactor(ST));
1331   } else if (CalleePopAmount != 0) {
1332     llvm_unreachable("is this used?");
1333   }
1334 
1335   return MBB.erase(I);
1336 }
1337 
1338 /// Returns true if the frame will require a reference to the stack pointer.
1339 ///
1340 /// This is the set of conditions common to setting up the stack pointer in a
1341 /// kernel, and for using a frame pointer in a callable function.
1342 ///
1343 /// FIXME: Should also check hasOpaqueSPAdjustment and if any inline asm
1344 /// references SP.
1345 static bool frameTriviallyRequiresSP(const MachineFrameInfo &MFI) {
1346   return MFI.hasVarSizedObjects() || MFI.hasStackMap() || MFI.hasPatchPoint();
1347 }
1348 
1349 // The FP for kernels is always known 0, so we never really need to setup an
1350 // explicit register for it. However, DisableFramePointerElim will force us to
1351 // use a register for it.
1352 bool SIFrameLowering::hasFP(const MachineFunction &MF) const {
1353   const MachineFrameInfo &MFI = MF.getFrameInfo();
1354 
1355   // For entry functions we can use an immediate offset in most cases, so the
1356   // presence of calls doesn't imply we need a distinct frame pointer.
1357   if (MFI.hasCalls() &&
1358       !MF.getInfo<SIMachineFunctionInfo>()->isEntryFunction()) {
1359     // All offsets are unsigned, so need to be addressed in the same direction
1360     // as stack growth.
1361 
1362     // FIXME: This function is pretty broken, since it can be called before the
1363     // frame layout is determined or CSR spills are inserted.
1364     return MFI.getStackSize() != 0;
1365   }
1366 
1367   return frameTriviallyRequiresSP(MFI) || MFI.isFrameAddressTaken() ||
1368     MF.getSubtarget<GCNSubtarget>().getRegisterInfo()->needsStackRealignment(MF) ||
1369     MF.getTarget().Options.DisableFramePointerElim(MF);
1370 }
1371 
1372 // This is essentially a reduced version of hasFP for entry functions. Since the
1373 // stack pointer is known 0 on entry to kernels, we never really need an FP
1374 // register. We may need to initialize the stack pointer depending on the frame
1375 // properties, which logically overlaps many of the cases where an ordinary
1376 // function would require an FP.
1377 bool SIFrameLowering::requiresStackPointerReference(
1378     const MachineFunction &MF) const {
1379   // Callable functions always require a stack pointer reference.
1380   assert(MF.getInfo<SIMachineFunctionInfo>()->isEntryFunction() &&
1381          "only expected to call this for entry points");
1382 
1383   const MachineFrameInfo &MFI = MF.getFrameInfo();
1384 
1385   // Entry points ordinarily don't need to initialize SP. We have to set it up
1386   // for callees if there are any. Also note tail calls are impossible/don't
1387   // make any sense for kernels.
1388   if (MFI.hasCalls())
1389     return true;
1390 
1391   // We still need to initialize the SP if we're doing anything weird that
1392   // references the SP, like variable sized stack objects.
1393   return frameTriviallyRequiresSP(MFI);
1394 }
1395