LLVM 20.0.0git
AArch64FrameLowering.h
Go to the documentation of this file.
1//==-- AArch64FrameLowering.h - TargetFrameLowering for AArch64 --*- 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//
10//
11//===----------------------------------------------------------------------===//
12
13#ifndef LLVM_LIB_TARGET_AARCH64_AARCH64FRAMELOWERING_H
14#define LLVM_LIB_TARGET_AARCH64_AARCH64FRAMELOWERING_H
15
19
20namespace llvm {
21
23public:
26 true /*StackRealignable*/) {}
27
28 void resetCFIToInitialState(MachineBasicBlock &MBB) const override;
29
32 MachineBasicBlock::iterator I) const override;
33
34 /// emitProlog/emitEpilog - These methods insert prolog and epilog code into
35 /// the function.
36 void emitPrologue(MachineFunction &MF, MachineBasicBlock &MBB) const override;
37 void emitEpilogue(MachineFunction &MF, MachineBasicBlock &MBB) const override;
38
39 bool enableCFIFixup(MachineFunction &MF) const override;
40
41 bool canUseAsPrologue(const MachineBasicBlock &MBB) const override;
42
44 Register &FrameReg) const override;
46 int FI) const override;
48 Register &FrameReg, bool PreferFP,
49 bool ForSimm) const;
51 int64_t ObjectOffset, bool isFixed,
52 bool isSVE, Register &FrameReg,
53 bool PreferFP, bool ForSimm) const;
57 const TargetRegisterInfo *TRI) const override;
58
59 bool
63 const TargetRegisterInfo *TRI) const override;
64
65 /// Can this function use the red zone for local allocations.
66 bool canUseRedZone(const MachineFunction &MF) const;
67
68 bool hasFP(const MachineFunction &MF) const override;
69 bool hasReservedCallFrame(const MachineFunction &MF) const override;
70
73 std::vector<CalleeSavedInfo> &CSI,
74 unsigned &MinCSFrameIndex,
75 unsigned &MaxCSFrameIndex) const override;
76
78 RegScavenger *RS) const override;
79
80 /// Returns true if the target will correctly handle shrink wrapping.
81 bool enableShrinkWrapping(const MachineFunction &MF) const override {
82 return true;
83 }
84
85 bool enableStackSlotScavenging(const MachineFunction &MF) const override;
87
89 RegScavenger *RS) const override;
90
91 void
93 RegScavenger *RS) const override;
94
95 unsigned getWinEHParentFrameOffset(const MachineFunction &MF) const override;
96
97 unsigned getWinEHFuncletFrameSize(const MachineFunction &MF) const;
98
101 Register &FrameReg,
102 bool IgnoreSPUpdates) const override;
104 int FI) const override;
105 int getSEHFrameIndexOffset(const MachineFunction &MF, int FI) const;
106
108 switch (ID) {
109 default:
110 return false;
114 return true;
115 }
116 }
117
118 bool isStackIdSafeForLocalArea(unsigned StackId) const override {
119 // We don't support putting SVE objects into the pre-allocated local
120 // frame block at the moment.
121 return StackId != TargetStackID::ScalableVector;
122 }
123
124 void
126 SmallVectorImpl<int> &ObjectsToAllocate) const override;
127
128private:
129 /// Returns true if a homogeneous prolog or epilog code can be emitted
130 /// for the size optimization. If so, HOM_Prolog/HOM_Epilog pseudo
131 /// instructions are emitted in place. When Exit block is given, this check is
132 /// for epilog.
133 bool homogeneousPrologEpilog(MachineFunction &MF,
134 MachineBasicBlock *Exit = nullptr) const;
135
136 /// Returns true if CSRs should be paired.
137 bool producePairRegisters(MachineFunction &MF) const;
138
139 bool shouldCombineCSRLocalStackBump(MachineFunction &MF,
140 uint64_t StackBumpBytes) const;
141
142 int64_t estimateSVEStackObjectOffsets(MachineFrameInfo &MF) const;
143 int64_t assignSVEStackObjectOffsets(MachineFrameInfo &MF,
144 int &MinCSFrameIndex,
145 int &MaxCSFrameIndex) const;
146 bool shouldCombineCSRLocalStackBumpInEpilogue(MachineBasicBlock &MBB,
147 unsigned StackBumpBytes) const;
148 void emitCalleeSavedGPRLocations(MachineBasicBlock &MBB,
150 void emitCalleeSavedSVELocations(MachineBasicBlock &MBB,
152 void emitCalleeSavedGPRRestores(MachineBasicBlock &MBB,
154 void emitCalleeSavedSVERestores(MachineBasicBlock &MBB,
156 void allocateStackSpace(MachineBasicBlock &MBB,
158 int64_t RealignmentPadding, StackOffset AllocSize,
159 bool NeedsWinCFI, bool *HasWinCFI, bool EmitCFI,
160 StackOffset InitialOffset, bool FollowupAllocs) const;
161 /// Make a determination whether a Hazard slot is used and create it if
162 /// needed.
163 void determineStackHazardSlot(MachineFunction &MF,
164 BitVector &SavedRegs) const;
165
166 /// Emit target zero call-used regs.
167 void emitZeroCallUsedRegs(BitVector RegsToZero,
168 MachineBasicBlock &MBB) const override;
169
170 /// Replace a StackProbe stub (if any) with the actual probe code inline
171 void inlineStackProbe(MachineFunction &MF,
172 MachineBasicBlock &PrologueMBB) const override;
173
174 void inlineStackProbeFixed(MachineBasicBlock::iterator MBBI,
175 Register ScratchReg, int64_t FrameSize,
176 StackOffset CFAOffset) const;
177
179 inlineStackProbeLoopExactMultiple(MachineBasicBlock::iterator MBBI,
180 int64_t NegProbeSize,
181 Register TargetReg) const;
182
183 void emitRemarks(const MachineFunction &MF,
184 MachineOptimizationRemarkEmitter *ORE) const override;
185};
186
187} // End llvm namespace
188
189#endif
MachineBasicBlock & MBB
MachineBasicBlock MachineBasicBlock::iterator MBBI
basic Basic Alias true
IRTranslator LLVM IR MI
#define I(x, y, z)
Definition: MD5.cpp:58
===- MachineOptimizationRemarkEmitter.h - Opt Diagnostics -*- C++ -*-—===//
unsigned const TargetRegisterInfo * TRI
void processFunctionBeforeFrameIndicesReplaced(MachineFunction &MF, RegScavenger *RS) const override
processFunctionBeforeFrameIndicesReplaced - This method is called immediately before MO_FrameIndex op...
MachineBasicBlock::iterator eliminateCallFramePseudoInstr(MachineFunction &MF, MachineBasicBlock &MBB, MachineBasicBlock::iterator I) const override
This method is called during prolog/epilog code insertion to eliminate call frame setup and destroy p...
bool canUseAsPrologue(const MachineBasicBlock &MBB) const override
Check whether or not the given MBB can be used as a prologue for the target.
bool enableStackSlotScavenging(const MachineFunction &MF) const override
Returns true if the stack slot holes in the fixed and callee-save stack area should be used when allo...
bool spillCalleeSavedRegisters(MachineBasicBlock &MBB, MachineBasicBlock::iterator MI, ArrayRef< CalleeSavedInfo > CSI, const TargetRegisterInfo *TRI) const override
spillCalleeSavedRegisters - Issues instruction(s) to spill all callee saved registers and returns tru...
bool restoreCalleeSavedRegisters(MachineBasicBlock &MBB, MachineBasicBlock::iterator MI, MutableArrayRef< CalleeSavedInfo > CSI, const TargetRegisterInfo *TRI) const override
restoreCalleeSavedRegisters - Issues instruction(s) to restore all callee saved registers and returns...
StackOffset getFrameIndexReferenceFromSP(const MachineFunction &MF, int FI) const override
getFrameIndexReferenceFromSP - This method returns the offset from the stack pointer to the slot of t...
StackOffset getNonLocalFrameIndexReference(const MachineFunction &MF, int FI) const override
getNonLocalFrameIndexReference - This method returns the offset used to reference a frame index locat...
TargetStackID::Value getStackIDForScalableVectors() const override
Returns the StackID that scalable vectors should be associated with.
bool hasFP(const MachineFunction &MF) const override
hasFP - Return true if the specified function should have a dedicated frame pointer register.
void emitPrologue(MachineFunction &MF, MachineBasicBlock &MBB) const override
emitProlog/emitEpilog - These methods insert prolog and epilog code into the function.
bool enableCFIFixup(MachineFunction &MF) const override
Returns true if we may need to fix the unwind information for the function.
void resetCFIToInitialState(MachineBasicBlock &MBB) const override
Emit CFI instructions that recreate the state of the unwind information upon fucntion entry.
bool hasReservedCallFrame(const MachineFunction &MF) const override
hasReservedCallFrame - Under normal circumstances, when a frame pointer is not required,...
bool enableShrinkWrapping(const MachineFunction &MF) const override
Returns true if the target will correctly handle shrink wrapping.
bool canUseRedZone(const MachineFunction &MF) const
Can this function use the red zone for local allocations.
bool isSupportedStackID(TargetStackID::Value ID) const override
void processFunctionBeforeFrameFinalized(MachineFunction &MF, RegScavenger *RS) const override
processFunctionBeforeFrameFinalized - This method is called immediately before the specified function...
int getSEHFrameIndexOffset(const MachineFunction &MF, int FI) const
unsigned getWinEHFuncletFrameSize(const MachineFunction &MF) const
Funclets only need to account for space for the callee saved registers, as the locals are accounted f...
void orderFrameObjects(const MachineFunction &MF, SmallVectorImpl< int > &ObjectsToAllocate) const override
Order the symbols in the local stack frame.
void emitEpilogue(MachineFunction &MF, MachineBasicBlock &MBB) const override
void determineCalleeSaves(MachineFunction &MF, BitVector &SavedRegs, RegScavenger *RS) const override
This method determines which of the registers reported by TargetRegisterInfo::getCalleeSavedRegs() sh...
StackOffset getFrameIndexReference(const MachineFunction &MF, int FI, Register &FrameReg) const override
getFrameIndexReference - Provide a base+offset reference to an FI slot for debug info.
StackOffset resolveFrameOffsetReference(const MachineFunction &MF, int64_t ObjectOffset, bool isFixed, bool isSVE, Register &FrameReg, bool PreferFP, bool ForSimm) const
bool assignCalleeSavedSpillSlots(MachineFunction &MF, const TargetRegisterInfo *TRI, std::vector< CalleeSavedInfo > &CSI, unsigned &MinCSFrameIndex, unsigned &MaxCSFrameIndex) const override
assignCalleeSavedSpillSlots - Allows target to override spill slot assignment logic.
StackOffset getFrameIndexReferencePreferSP(const MachineFunction &MF, int FI, Register &FrameReg, bool IgnoreSPUpdates) const override
For Win64 AArch64 EH, the offset to the Unwind object is from the SP before the update.
bool isStackIdSafeForLocalArea(unsigned StackId) const override
This method returns whether or not it is safe for an object with the given stack id to be bundled int...
StackOffset resolveFrameIndexReference(const MachineFunction &MF, int FI, Register &FrameReg, bool PreferFP, bool ForSimm) const
unsigned getWinEHParentFrameOffset(const MachineFunction &MF) const override
The parent frame offset (aka dispFrame) is only used on X86_64 to retrieve the parent's frame pointer...
ArrayRef - Represent a constant reference to an array (0 or more elements consecutively in memory),...
Definition: ArrayRef.h:41
The MachineFrameInfo class represents an abstract stack frame until prolog/epilog code is inserted.
MutableArrayRef - Represent a mutable reference to an array (0 or more elements consecutively in memo...
Definition: ArrayRef.h:307
Wrapper class representing virtual and physical registers.
Definition: Register.h:19
This class consists of common code factored out of the SmallVector class to reduce code duplication b...
Definition: SmallVector.h:587
StackOffset holds a fixed and a scalable offset in bytes.
Definition: TypeSize.h:33
Information about stack frame layout on the target.
TargetRegisterInfo base class - We assume that the target defines a static array of TargetRegisterDes...
This is an optimization pass for GlobalISel generic memory operations.
Definition: AddressRanges.h:18
This struct is a compact representation of a valid (non-zero power of two) alignment.
Definition: Alignment.h:39