LLVM 20.0.0git
Classes | Public Member Functions | Static Public Attributes | Protected Member Functions | Protected Attributes | List of all members
llvm::InstructionSelect Class Reference

This pass is responsible for selecting generic machine instructions to target-specific instructions. More...

#include "llvm/CodeGen/GlobalISel/InstructionSelect.h"

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

Classes

class  MIIteratorMaintainer
 This class observes instruction insertions/removals. More...
 

Public Member Functions

StringRef getPassName () const override
 getPassName - Return a nice clean name for a pass.
 
void getAnalysisUsage (AnalysisUsage &AU) const override
 getAnalysisUsage - This function should be overriden by passes that need analysis information to do their job.
 
MachineFunctionProperties getRequiredProperties () const override
 
MachineFunctionProperties getSetProperties () const override
 
 InstructionSelect (CodeGenOptLevel OL=CodeGenOptLevel::Default, char &PassID=ID)
 
bool runOnMachineFunction (MachineFunction &MF) override
 runOnMachineFunction - This method must be overloaded to perform the desired machine code transformation or analysis.
 
bool selectMachineFunction (MachineFunction &MF)
 
void setInstructionSelector (InstructionSelector *NewISel)
 
- Public Member Functions inherited from llvm::MachineFunctionPass
bool doInitialization (Module &) override
 doInitialization - Virtual method overridden by subclasses to do any necessary initialization before any pass is run.
 
- Public Member Functions inherited from llvm::FunctionPass
 FunctionPass (char &pid)
 
PasscreatePrinterPass (raw_ostream &OS, const std::string &Banner) const override
 createPrinterPass - Get a function printer pass.
 
virtual bool runOnFunction (Function &F)=0
 runOnFunction - Virtual method overriden by subclasses to do the per-function processing of the pass.
 
void assignPassManager (PMStack &PMS, PassManagerType T) override
 Find appropriate Function Pass Manager or Call Graph Pass Manager in the PM Stack and add self into that manager.
 
PassManagerType getPotentialPassManagerType () const override
 Return what kind of Pass Manager can manage this pass.
 
- Public Member Functions inherited from llvm::Pass
 Pass (PassKind K, char &pid)
 
 Pass (const Pass &)=delete
 
Passoperator= (const Pass &)=delete
 
virtual ~Pass ()
 
PassKind getPassKind () const
 
virtual StringRef getPassName () const
 getPassName - Return a nice clean name for a pass.
 
AnalysisID getPassID () const
 getPassID - Return the PassID number that corresponds to this pass.
 
virtual bool doInitialization (Module &)
 doInitialization - Virtual method overridden by subclasses to do any necessary initialization before any pass is run.
 
virtual bool doFinalization (Module &)
 doFinalization - Virtual method overriden by subclasses to do any necessary clean up after all passes have run.
 
virtual void print (raw_ostream &OS, const Module *M) const
 print - Print out the internal state of the pass.
 
void dump () const
 
virtual PasscreatePrinterPass (raw_ostream &OS, const std::string &Banner) const =0
 createPrinterPass - Get a Pass appropriate to print the IR this pass operates on (Module, Function or MachineFunction).
 
virtual void assignPassManager (PMStack &, PassManagerType)
 Each pass is responsible for assigning a pass manager to itself.
 
virtual void preparePassManager (PMStack &)
 Check if available pass managers are suitable for this pass or not.
 
virtual PassManagerType getPotentialPassManagerType () const
 Return what kind of Pass Manager can manage this pass.
 
void setResolver (AnalysisResolver *AR)
 
AnalysisResolvergetResolver () const
 
virtual void getAnalysisUsage (AnalysisUsage &) const
 getAnalysisUsage - This function should be overriden by passes that need analysis information to do their job.
 
virtual void releaseMemory ()
 releaseMemory() - This member can be implemented by a pass if it wants to be able to release its memory when it is no longer needed.
 
virtual void * getAdjustedAnalysisPointer (AnalysisID ID)
 getAdjustedAnalysisPointer - This method is used when a pass implements an analysis interface through multiple inheritance.
 
virtual ImmutablePassgetAsImmutablePass ()
 
virtual PMDataManagergetAsPMDataManager ()
 
virtual void verifyAnalysis () const
 verifyAnalysis() - This member can be implemented by a analysis pass to check state of analysis information.
 
virtual void dumpPassStructure (unsigned Offset=0)
 
template<typename AnalysisType >
AnalysisType * getAnalysisIfAvailable () const
 getAnalysisIfAvailable<AnalysisType>() - Subclasses use this function to get analysis information that might be around, for example to update it.
 
bool mustPreserveAnalysisID (char &AID) const
 mustPreserveAnalysisID - This method serves the same function as getAnalysisIfAvailable, but works if you just have an AnalysisID.
 
template<typename AnalysisType >
AnalysisType & getAnalysis () const
 getAnalysis<AnalysisType>() - This function is used by subclasses to get to the analysis information that they claim to use by overriding the getAnalysisUsage function.
 
template<typename AnalysisType >
AnalysisType & getAnalysis (Function &F, bool *Changed=nullptr)
 getAnalysis<AnalysisType>() - This function is used by subclasses to get to the analysis information that they claim to use by overriding the getAnalysisUsage function.
 
template<typename AnalysisType >
AnalysisType & getAnalysisID (AnalysisID PI) const
 
template<typename AnalysisType >
AnalysisType & getAnalysisID (AnalysisID PI, Function &F, bool *Changed=nullptr)
 

Static Public Attributes

static char ID = 0
 

Protected Member Functions

bool selectInstr (MachineInstr &MI)
 
- Protected Member Functions inherited from llvm::MachineFunctionPass
 MachineFunctionPass (char &ID)
 
virtual bool runOnMachineFunction (MachineFunction &MF)=0
 runOnMachineFunction - This method must be overloaded to perform the desired machine code transformation or analysis.
 
void getAnalysisUsage (AnalysisUsage &AU) const override
 getAnalysisUsage - Subclasses that override getAnalysisUsage must call this.
 
virtual MachineFunctionProperties getRequiredProperties () const
 
virtual MachineFunctionProperties getSetProperties () const
 
virtual MachineFunctionProperties getClearedProperties () const
 
- Protected Member Functions inherited from llvm::FunctionPass
bool skipFunction (const Function &F) const
 Optional passes call this function to check whether the pass should be skipped.
 

Protected Attributes

InstructionSelectorISel = nullptr
 
GISelKnownBitsKB = nullptr
 
BlockFrequencyInfoBFI = nullptr
 
ProfileSummaryInfoPSI = nullptr
 
CodeGenOptLevel OptLevel = CodeGenOptLevel::None
 

Additional Inherited Members

- Static Public Member Functions inherited from llvm::Pass
static const PassInfolookupPassInfo (const void *TI)
 
static const PassInfolookupPassInfo (StringRef Arg)
 
static PasscreatePass (AnalysisID ID)
 

Detailed Description

This pass is responsible for selecting generic machine instructions to target-specific instructions.

It relies on the InstructionSelector provided by the target. Selection is done by examining blocks in post-order, and instructions in reverse order.

Postcondition
for all inst in MF: not isPreISelGenericOpcode(inst.opcode)

Definition at line 35 of file InstructionSelect.h.

Constructor & Destructor Documentation

◆ InstructionSelect()

Select target instructions out of generic false InstructionSelect::InstructionSelect ( CodeGenOptLevel  OL = CodeGenOptLevel::Default,
char PassID = ID 
)

Definition at line 67 of file InstructionSelect.cpp.

Member Function Documentation

◆ getAnalysisUsage()

void InstructionSelect::getAnalysisUsage ( AnalysisUsage ) const
overridevirtual

getAnalysisUsage - This function should be overriden by passes that need analysis information to do their job.

If a pass specifies that it uses a particular analysis result to this function, it can then use the getAnalysis<AnalysisType>() function, below.

Reimplemented from llvm::Pass.

Definition at line 116 of file InstructionSelect.cpp.

References llvm::AnalysisUsage::addPreserved(), llvm::AnalysisUsage::addRequired(), llvm::MachineFunctionPass::getAnalysisUsage(), llvm::LazyBlockFrequencyInfoPass::getLazyBFIAnalysisUsage(), llvm::getSelectionDAGFallbackAnalysisUsage(), llvm::None, and OptLevel.

◆ getPassName()

StringRef llvm::InstructionSelect::getPassName ( ) const
inlineoverridevirtual

getPassName - Return a nice clean name for a pass.

This usually implemented in terms of the name that is registered by one of the Registration templates, but can be overloaded directly.

Reimplemented from llvm::Pass.

Definition at line 38 of file InstructionSelect.h.

◆ getRequiredProperties()

MachineFunctionProperties llvm::InstructionSelect::getRequiredProperties ( ) const
inlineoverridevirtual

◆ getSetProperties()

MachineFunctionProperties llvm::InstructionSelect::getSetProperties ( ) const
inlineoverridevirtual

◆ runOnMachineFunction()

bool InstructionSelect::runOnMachineFunction ( MachineFunction MF)
overridevirtual

◆ selectInstr()

bool InstructionSelect::selectInstr ( MachineInstr MI)
protected

◆ selectMachineFunction()

bool InstructionSelect::selectMachineFunction ( MachineFunction MF)

Definition at line 154 of file InstructionSelect.cpp.

References assert(), BFI, llvm::MachineBasicBlock::clear(), llvm::detail::DenseSetImpl< ValueT, MapTy, ValueInfoT >::contains(), CoveragePrefix, llvm::CodeGenCoverage::covered(), llvm::GIMatchTableExecutor::CurMBB, llvm::dbgs(), llvm::DisableGISelLegalityCheck, llvm::CodeGenCoverage::emit(), llvm::MachineBasicBlock::empty(), End, llvm::MachineFunctionProperties::FailedISel, llvm::TargetLoweringBase::finalizeLowering(), llvm::MachineFunction::getFrameInfo(), llvm::MachineFunction::getFunction(), llvm::MachineFunction::getName(), llvm::MachineFunction::getProperties(), llvm::MachineFunction::getRegInfo(), llvm::TargetSubtargetInfo::getRegisterInfo(), llvm::LLT::getSizeInBits(), llvm::Function::getSubprogram(), llvm::MachineFunction::getSubtarget(), llvm::TargetSubtargetInfo::getTargetLowering(), llvm::MachineFrameInfo::hasCalls(), llvm::MachineFunction::hasInlineAsm(), I, llvm::Register::index2VirtReg(), llvm::detail::DenseSetImpl< ValueT, MapTy, ValueInfoT >::insert(), ISel, llvm::details::FixedOrScalableQuantity< TypeSize, uint64_t >::isKnownGT(), llvm::LLT::isValid(), llvm::Register::isVirtual(), KB, LLVM_DEBUG, llvm::machineFunctionIsIllegal(), MBB, MI, llvm::InstructionSelect::MIIteratorMaintainer::MII, llvm::InstructionSelector::MORE, MORE, MRI, llvm::post_order(), PSI, llvm::MachineBasicBlock::rbegin(), llvm::MachineBasicBlock::rend(), llvm::InstructionSelect::MIIteratorMaintainer::reportFullyCreatedInstrs(), llvm::reportGISelFailure(), selectInstr(), llvm::MachineFunctionProperties::set(), llvm::MachineFrameInfo::setHasCalls(), llvm::MachineFunction::setHasInlineAsm(), llvm::GIMatchTableExecutor::setupMF(), llvm::DebugCounter::shouldExecute(), llvm::MachineFunction::size(), llvm::InstructionSelector::TPC, and TRI.

Referenced by runOnMachineFunction().

◆ setInstructionSelector()

void llvm::InstructionSelect::setInstructionSelector ( InstructionSelector NewISel)
inline

Definition at line 59 of file InstructionSelect.h.

References ISel.

Member Data Documentation

◆ BFI

BlockFrequencyInfo* llvm::InstructionSelect::BFI = nullptr
protected

Definition at line 66 of file InstructionSelect.h.

Referenced by runOnMachineFunction(), and selectMachineFunction().

◆ ID

char InstructionSelect::ID = 0
static

Definition at line 37 of file InstructionSelect.h.

◆ ISel

InstructionSelector* llvm::InstructionSelect::ISel = nullptr
protected

◆ KB

GISelKnownBits* llvm::InstructionSelect::KB = nullptr
protected

Definition at line 65 of file InstructionSelect.h.

Referenced by runOnMachineFunction(), and selectMachineFunction().

◆ OptLevel

CodeGenOptLevel llvm::InstructionSelect::OptLevel = CodeGenOptLevel::None
protected

Definition at line 69 of file InstructionSelect.h.

Referenced by getAnalysisUsage(), and runOnMachineFunction().

◆ PSI

ProfileSummaryInfo* llvm::InstructionSelect::PSI = nullptr
protected

Definition at line 67 of file InstructionSelect.h.

Referenced by runOnMachineFunction(), and selectMachineFunction().


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