LLVM API Documentation

 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
Classes | Public Types | Public Member Functions | List of all members
llvm::TargetFrameLowering Class Referenceabstract

#include <TargetFrameLowering.h>

Inheritance diagram for llvm::TargetFrameLowering:
Inheritance graph
[legend]

Classes

struct  SpillSlot
 

Public Types

enum  StackDirection { StackGrowsUp, StackGrowsDown }
 

Public Member Functions

 TargetFrameLowering (StackDirection D, unsigned StackAl, int LAO, unsigned TransAl=1, bool StackReal=true)
 
virtual ~TargetFrameLowering ()
 
StackDirection getStackGrowthDirection () const
 
unsigned getStackAlignment () const
 
unsigned getTransientStackAlignment () const
 
bool isStackRealignable () const
 
int getOffsetOfLocalArea () const
 
virtual bool isFPCloseToIncomingSP () const
 
virtual const SpillSlot * getCalleeSavedSpillSlots (unsigned &NumEntries) const
 
virtual bool targetHandlesStackFrameRounding () const
 
virtual void emitPrologue (MachineFunction &MF) const =0
 
virtual void emitEpilogue (MachineFunction &MF, MachineBasicBlock &MBB) const =0
 
virtual void adjustForSegmentedStacks (MachineFunction &MF) const
 
virtual void adjustForHiPEPrologue (MachineFunction &MF) const
 
virtual bool spillCalleeSavedRegisters (MachineBasicBlock &MBB, MachineBasicBlock::iterator MI, const std::vector< CalleeSavedInfo > &CSI, const TargetRegisterInfo *TRI) const
 
virtual bool restoreCalleeSavedRegisters (MachineBasicBlock &MBB, MachineBasicBlock::iterator MI, const std::vector< CalleeSavedInfo > &CSI, const TargetRegisterInfo *TRI) const
 
virtual bool hasFP (const MachineFunction &MF) const =0
 
virtual bool hasReservedCallFrame (const MachineFunction &MF) const
 
virtual bool canSimplifyCallFramePseudos (const MachineFunction &MF) const
 
virtual int getFrameIndexOffset (const MachineFunction &MF, int FI) const
 
virtual int getFrameIndexReference (const MachineFunction &MF, int FI, unsigned &FrameReg) const
 
virtual void processFunctionBeforeCalleeSavedScan (MachineFunction &MF, RegScavenger *RS=NULL) const
 
virtual void processFunctionBeforeFrameFinalized (MachineFunction &MF, RegScavenger *RS=NULL) const
 
virtual void eliminateCallFramePseudoInstr (MachineFunction &MF, MachineBasicBlock &MBB, MachineBasicBlock::iterator MI) const
 

Detailed Description

Information about stack frame layout on the target. It holds the direction of stack growth, the known stack alignment on entry to each function, and the offset to the locals area.

The offset to the local area is the offset from the stack pointer on function entry to the first location where function data (local variables, spill locations) can be stored.

Definition at line 33 of file TargetFrameLowering.h.

Member Enumeration Documentation

enum llvm::TargetFrameLowering::StackDirection
Enumerator
StackGrowsUp 
StackGrowsDown 

Definition at line 35 of file TargetFrameLowering.h.

Constructor & Destructor Documentation

llvm::TargetFrameLowering::TargetFrameLowering ( StackDirection  D,
unsigned  StackAl,
int  LAO,
unsigned  TransAl = 1,
bool  StackReal = true 
)
inline

Definition at line 52 of file TargetFrameLowering.h.

TargetFrameLowering::~TargetFrameLowering ( )
virtual

Definition at line 22 of file TargetFrameLoweringImpl.cpp.

Member Function Documentation

virtual void llvm::TargetFrameLowering::adjustForHiPEPrologue ( MachineFunction &  MF) const
inlinevirtual

Adjust the prologue to add Erlang Run-Time System (ERTS) specific code in the assembly prologue to explicitly handle the stack.

Reimplemented in llvm::X86FrameLowering.

Definition at line 130 of file TargetFrameLowering.h.

virtual void llvm::TargetFrameLowering::adjustForSegmentedStacks ( MachineFunction &  MF) const
inlinevirtual

Adjust the prologue to have the function use segmented stacks. This works by adding a check even before the "normal" function prologue.

Reimplemented in llvm::X86FrameLowering.

Definition at line 126 of file TargetFrameLowering.h.

virtual bool llvm::TargetFrameLowering::canSimplifyCallFramePseudos ( const MachineFunction &  MF) const
inlinevirtual

canSimplifyCallFramePseudos - When possible, it's best to simplify the call frame pseudo ops before doing frame index elimination. This is possible only when frame index references between the pseudos won't need adjusting for the call frame adjustments. Normally, that's true if the function has a reserved call frame or a frame pointer. Some targets (Thumb2, for example) may have more complicated criteria, however, and can override this behavior.

Reimplemented in llvm::ARMFrameLowering.

Definition at line 175 of file TargetFrameLowering.h.

References hasFP(), and hasReservedCallFrame().

virtual void llvm::TargetFrameLowering::eliminateCallFramePseudoInstr ( MachineFunction &  MF,
MachineBasicBlock &  MBB,
MachineBasicBlock::iterator  MI 
) const
inlinevirtual

eliminateCallFramePseudoInstr - This method is called during prolog/epilog code insertion to eliminate call frame setup and destroy pseudo instructions (but only if the Target is using them). It is responsible for eliminating these instructions, replacing them with concrete instructions. This method need only be implemented if using call frame setup/destroy pseudo instructions.

Reimplemented in llvm::AArch64FrameLowering, llvm::X86FrameLowering, llvm::SystemZFrameLowering, llvm::PPCFrameLowering, llvm::Thumb1FrameLowering, llvm::XCoreFrameLowering, llvm::HexagonFrameLowering, llvm::MSP430FrameLowering, llvm::SparcFrameLowering, llvm::NVPTXFrameLowering, llvm::MipsSEFrameLowering, and llvm::Mips16FrameLowering.

Definition at line 214 of file TargetFrameLowering.h.

References llvm_unreachable.

virtual void llvm::TargetFrameLowering::emitEpilogue ( MachineFunction &  MF,
MachineBasicBlock &  MBB 
) const
pure virtual

Implemented in llvm::SystemZFrameLowering, llvm::AArch64FrameLowering, llvm::X86FrameLowering, llvm::PPCFrameLowering, llvm::AMDGPUFrameLowering, llvm::ARMFrameLowering, llvm::Thumb1FrameLowering, llvm::MSP430FrameLowering, llvm::SparcFrameLowering, llvm::NVPTXFrameLowering, llvm::HexagonFrameLowering, llvm::XCoreFrameLowering, llvm::MipsSEFrameLowering, and llvm::Mips16FrameLowering.

virtual void llvm::TargetFrameLowering::emitPrologue ( MachineFunction &  MF) const
pure virtual

emitProlog/emitEpilog - These methods insert prolog and epilog code into the function.

Implemented in llvm::SystemZFrameLowering, llvm::AArch64FrameLowering, llvm::X86FrameLowering, llvm::PPCFrameLowering, llvm::AMDGPUFrameLowering, llvm::ARMFrameLowering, llvm::Thumb1FrameLowering, llvm::MSP430FrameLowering, llvm::SparcFrameLowering, llvm::NVPTXFrameLowering, llvm::HexagonFrameLowering, llvm::XCoreFrameLowering, llvm::MipsSEFrameLowering, and llvm::Mips16FrameLowering.

virtual const SpillSlot* llvm::TargetFrameLowering::getCalleeSavedSpillSlots ( unsigned &  NumEntries) const
inlinevirtual

getCalleeSavedSpillSlots - This method returns a pointer to an array of pairs, that contains an entry for each callee saved register that must be spilled to a particular stack location if it is spilled.

Each entry in this array contains a <register,offset> pair, indicating the fixed offset from the incoming stack pointer that each register should be spilled at. If a register is not listed here, the code generator is allowed to spill it anywhere it chooses.

Reimplemented in llvm::PPCFrameLowering, llvm::AMDGPUFrameLowering, and llvm::SystemZFrameLowering.

Definition at line 106 of file TargetFrameLowering.h.

int TargetFrameLowering::getFrameIndexOffset ( const MachineFunction &  MF,
int  FI 
) const
virtual

getFrameIndexOffset - Returns the displacement from the frame register to the stack frame of the specified index.

getFrameIndexOffset - Returns the displacement from the frame register to the stack frame of the specified index. This is the default implementation which is overridden for some targets.

Reimplemented in llvm::X86FrameLowering, llvm::ARMFrameLowering, llvm::SystemZFrameLowering, llvm::HexagonFrameLowering, and llvm::AMDGPUFrameLowering.

Definition at line 28 of file TargetFrameLoweringImpl.cpp.

References llvm::MachineFunction::getFrameInfo(), llvm::MachineFrameInfo::getObjectOffset(), llvm::MachineFrameInfo::getOffsetAdjustment(), getOffsetOfLocalArea(), and llvm::MachineFrameInfo::getStackSize().

Referenced by llvm::SystemZRegisterInfo::eliminateFrameIndex(), llvm::X86RegisterInfo::eliminateFrameIndex(), getFrameIndexReference(), and llvm::AMDGPUInstrInfo::getIndirectIndexEnd().

int TargetFrameLowering::getFrameIndexReference ( const MachineFunction &  MF,
int  FI,
unsigned &  FrameReg 
) const
virtual

getFrameIndexReference - This method should return the base register and offset used to reference a frame index location. The offset is returned directly, and the base register is returned via FrameReg.

Reimplemented in llvm::X86FrameLowering, and llvm::ARMFrameLowering.

Definition at line 35 of file TargetFrameLoweringImpl.cpp.

References getFrameIndexOffset(), llvm::TargetRegisterInfo::getFrameRegister(), llvm::TargetMachine::getRegisterInfo(), and llvm::MachineFunction::getTarget().

Referenced by llvm::CompileUnit::constructVariableDIE(), and emitDebugValueComment().

int llvm::TargetFrameLowering::getOffsetOfLocalArea ( ) const
inline

getOffsetOfLocalArea - This method returns the offset of the local area from the stack pointer on entrance to a function.

Definition at line 89 of file TargetFrameLowering.h.

Referenced by llvm::X86RegisterInfo::eliminateFrameIndex(), llvm::SystemZFrameLowering::getFrameIndexOffset(), llvm::X86FrameLowering::getFrameIndexOffset(), getFrameIndexOffset(), llvm::MachineFrameInfo::print(), and llvm::X86FrameLowering::processFunctionBeforeCalleeSavedScan().

unsigned llvm::TargetFrameLowering::getStackAlignment ( ) const
inline

getStackAlignment - This method returns the number of bytes to which the stack pointer must be aligned on entry to a function. Typically, this is the largest alignment for any data object in the target.

Definition at line 70 of file TargetFrameLowering.h.

Referenced by llvm::PPCFrameLowering::addScavengingSpillSlot(), checkNumAlignedDPRCS2Regs(), llvm::MachineFrameInfo::CreateFixedObject(), llvm::PPCFrameLowering::determineFrameLayout(), llvm::MSP430FrameLowering::eliminateCallFramePseudoInstr(), llvm::XCoreFrameLowering::eliminateCallFramePseudoInstr(), llvm::Thumb1FrameLowering::eliminateCallFramePseudoInstr(), llvm::X86FrameLowering::eliminateCallFramePseudoInstr(), llvm::AArch64FrameLowering::eliminateCallFramePseudoInstr(), llvm::Thumb1FrameLowering::emitEpilogue(), llvm::ARMFrameLowering::emitEpilogue(), llvm::X86FrameLowering::emitEpilogue(), llvm::XCoreFrameLowering::emitPrologue(), llvm::Thumb1FrameLowering::emitPrologue(), llvm::ARMFrameLowering::emitPrologue(), llvm::X86FrameLowering::emitPrologue(), llvm::MipsFrameLowering::estimateStackSize(), llvm::MachineFrameInfo::estimateStackSize(), llvm::X86InstrInfo::foldMemoryOperandImpl(), llvm::MipsSEFrameLowering::hasReservedCallFrame(), llvm::X86InstrInfo::loadRegFromStackSlot(), llvm::PPCRegisterInfo::lowerDynamicAlloc(), llvm::ARMBaseRegisterInfo::needsFrameBaseReg(), llvm::PPCRegisterInfo::needsStackRealignment(), llvm::X86RegisterInfo::needsStackRealignment(), llvm::ARMBaseRegisterInfo::needsStackRealignment(), llvm::ARMFrameLowering::processFunctionBeforeCalleeSavedScan(), and llvm::X86InstrInfo::storeRegToStackSlot().

StackDirection llvm::TargetFrameLowering::getStackGrowthDirection ( ) const
inline

getStackGrowthDirection - Return the direction the stack grows

Definition at line 64 of file TargetFrameLowering.h.

unsigned llvm::TargetFrameLowering::getTransientStackAlignment ( ) const
inline

getTransientStackAlignment - This method returns the number of bytes to which the stack pointer must be aligned at all times, even between calls.

Definition at line 76 of file TargetFrameLowering.h.

Referenced by llvm::MachineFrameInfo::estimateStackSize().

virtual bool llvm::TargetFrameLowering::hasFP ( const MachineFunction &  MF) const
pure virtual

hasFP - Return true if the specified function should have a dedicated frame pointer register. For most targets this is true only if the function has variable sized allocas or if frame pointer elimination is disabled.

Implemented in llvm::AArch64FrameLowering, llvm::X86FrameLowering, llvm::SystemZFrameLowering, llvm::MSP430FrameLowering, llvm::ARMFrameLowering, llvm::HexagonFrameLowering, llvm::XCoreFrameLowering, llvm::PPCFrameLowering, llvm::SparcFrameLowering, llvm::AMDGPUFrameLowering, llvm::MipsFrameLowering, and llvm::NVPTXFrameLowering.

Referenced by canSimplifyCallFramePseudos(), llvm::MSP430RegisterInfo::eliminateFrameIndex(), llvm::XCoreRegisterInfo::eliminateFrameIndex(), llvm::HexagonRegisterInfo::eliminateFrameIndex(), llvm::Thumb1RegisterInfo::eliminateFrameIndex(), llvm::X86RegisterInfo::eliminateFrameIndex(), estimateRSStackSizeLimit(), llvm::MSP430RegisterInfo::getCalleeSavedRegs(), llvm::AArch64RegisterInfo::getFrameRegister(), llvm::MSP430RegisterInfo::getFrameRegister(), llvm::XCoreRegisterInfo::getFrameRegister(), llvm::SystemZRegisterInfo::getFrameRegister(), llvm::MipsRegisterInfo::getFrameRegister(), llvm::HexagonRegisterInfo::getFrameRegister(), llvm::PPCRegisterInfo::getFrameRegister(), llvm::X86RegisterInfo::getFrameRegister(), llvm::ARMBaseRegisterInfo::getFrameRegister(), llvm::PPCRegisterInfo::getRegPressureLimit(), llvm::MipsRegisterInfo::getRegPressureLimit(), llvm::X86RegisterInfo::getRegPressureLimit(), llvm::ARMBaseRegisterInfo::getRegPressureLimit(), llvm::AArch64RegisterInfo::getReservedRegs(), llvm::MSP430RegisterInfo::getReservedRegs(), llvm::XCoreRegisterInfo::getReservedRegs(), llvm::MipsRegisterInfo::getReservedRegs(), llvm::SystemZRegisterInfo::getReservedRegs(), llvm::X86RegisterInfo::getReservedRegs(), llvm::ARMBaseRegisterInfo::getReservedRegs(), hasReservedCallFrame(), llvm::X86RegisterInfo::hasReservedSpillSlot(), llvm::ARMBaseRegisterInfo::needsFrameBaseReg(), and llvm::XCoreRegisterInfo::requiresRegisterScavenging().

virtual bool llvm::TargetFrameLowering::hasReservedCallFrame ( const MachineFunction &  MF) const
inlinevirtual

hasReservedCallFrame - Under normal circumstances, when a frame pointer is not required, we reserve argument space for call sites in the function immediately on entry to the current function. This eliminates the need for add/sub sp brackets around call sites. Returns true if the call frame is included as part of the stack frame.

Reimplemented in llvm::AArch64FrameLowering, llvm::X86FrameLowering, llvm::SystemZFrameLowering, llvm::MSP430FrameLowering, llvm::ARMFrameLowering, llvm::Thumb1FrameLowering, llvm::Mips16FrameLowering, llvm::SparcFrameLowering, and llvm::MipsSEFrameLowering.

Definition at line 164 of file TargetFrameLowering.h.

References hasFP().

Referenced by llvm::ARMBaseRegisterInfo::canRealignStack(), canSimplifyCallFramePseudos(), llvm::XCoreFrameLowering::eliminateCallFramePseudoInstr(), llvm::Thumb1RegisterInfo::eliminateFrameIndex(), llvm::MipsFrameLowering::estimateStackSize(), and llvm::MachineFrameInfo::estimateStackSize().

virtual bool llvm::TargetFrameLowering::isFPCloseToIncomingSP ( ) const
inlinevirtual

isFPCloseToIncomingSP - Return true if the frame pointer is close to the incoming stack pointer, false if it is close to the post-prologue stack pointer.

Reimplemented in llvm::SystemZFrameLowering.

Definition at line 94 of file TargetFrameLowering.h.

bool llvm::TargetFrameLowering::isStackRealignable ( ) const
inline

isStackRealignable - This method returns whether the stack can be realigned.

Definition at line 82 of file TargetFrameLowering.h.

virtual void llvm::TargetFrameLowering::processFunctionBeforeCalleeSavedScan ( MachineFunction &  MF,
RegScavenger *  RS = NULL 
) const
inlinevirtual

processFunctionBeforeCalleeSavedScan - This method is called immediately before PrologEpilogInserter scans the physical registers used to determine what callee saved registers should be spilled. This method is optional.

Reimplemented in llvm::AArch64FrameLowering, llvm::ARMFrameLowering, llvm::X86FrameLowering, llvm::PPCFrameLowering, llvm::XCoreFrameLowering, llvm::Mips16FrameLowering, llvm::SparcFrameLowering, llvm::MipsSEFrameLowering, and llvm::SystemZFrameLowering.

Definition at line 192 of file TargetFrameLowering.h.

Referenced by llvm::PEI::runOnMachineFunction().

virtual void llvm::TargetFrameLowering::processFunctionBeforeFrameFinalized ( MachineFunction &  MF,
RegScavenger *  RS = NULL 
) const
inlinevirtual

processFunctionBeforeFrameFinalized - This method is called immediately before the specified function's frame layout (MF.getFrameInfo()) is finalized. Once the frame is finalized, MO_FrameIndex operands are replaced with direct constants. This method is optional.

Reimplemented in llvm::MSP430FrameLowering, llvm::SystemZFrameLowering, and llvm::PPCFrameLowering.

Definition at line 202 of file TargetFrameLowering.h.

Referenced by llvm::PEI::runOnMachineFunction().

virtual bool llvm::TargetFrameLowering::restoreCalleeSavedRegisters ( MachineBasicBlock &  MBB,
MachineBasicBlock::iterator  MI,
const std::vector< CalleeSavedInfo > &  CSI,
const TargetRegisterInfo *  TRI 
) const
inlinevirtual

restoreCalleeSavedRegisters - Issues instruction(s) to restore all callee saved registers and returns true if it isn't possible / profitable to do so by issuing a series of load instructions via loadRegToStackSlot(). Returns false otherwise.

Reimplemented in llvm::AArch64FrameLowering, llvm::PPCFrameLowering, llvm::X86FrameLowering, llvm::MSP430FrameLowering, llvm::SystemZFrameLowering, llvm::ARMFrameLowering, llvm::HexagonFrameLowering, llvm::Thumb1FrameLowering, llvm::Mips16FrameLowering, and llvm::XCoreFrameLowering.

Definition at line 147 of file TargetFrameLowering.h.

virtual bool llvm::TargetFrameLowering::spillCalleeSavedRegisters ( MachineBasicBlock &  MBB,
MachineBasicBlock::iterator  MI,
const std::vector< CalleeSavedInfo > &  CSI,
const TargetRegisterInfo *  TRI 
) const
inlinevirtual

spillCalleeSavedRegisters - Issues instruction(s) to spill all callee saved registers and returns true if it isn't possible / profitable to do so by issuing a series of store instructions via storeRegToStackSlot(). Returns false otherwise.

Reimplemented in llvm::AArch64FrameLowering, llvm::PPCFrameLowering, llvm::X86FrameLowering, llvm::MSP430FrameLowering, llvm::SystemZFrameLowering, llvm::ARMFrameLowering, llvm::Thumb1FrameLowering, llvm::MipsSEFrameLowering, llvm::HexagonFrameLowering, llvm::Mips16FrameLowering, and llvm::XCoreFrameLowering.

Definition at line 136 of file TargetFrameLowering.h.

virtual bool llvm::TargetFrameLowering::targetHandlesStackFrameRounding ( ) const
inlinevirtual

targetHandlesStackFrameRounding - Returns true if the target is responsible for rounding up the stack frame (probably at emitPrologue time).

Reimplemented in llvm::PPCFrameLowering.

Definition at line 114 of file TargetFrameLowering.h.

The documentation for this class was generated from the following files:

Generated on Tue Mar 18 2014 10:40:48 for LLVM by Doxygen1.8.6
Copyright © 2003-2013 University of Illinois at Urbana-Champaign. All Rights Reserved.