LLVM  8.0.1
Classes | Public Types | Public Member Functions | Static Public Attributes | Friends | List of all members
llvm::MachineTraceMetrics Class Reference

#include "llvm/CodeGen/MachineTraceMetrics.h"

Inheritance diagram for llvm::MachineTraceMetrics:
Inheritance graph
[legend]
Collaboration diagram for llvm::MachineTraceMetrics:
Collaboration graph
[legend]

Classes

class  Ensemble
 A trace ensemble is a collection of traces selected using the same strategy, for example 'minimum resource height'. More...
 
struct  FixedBlockInfo
 Per-basic block information that doesn't depend on the trace through the block. More...
 
struct  InstrCycles
 InstrCycles represents the cycle height and depth of an instruction in a trace. More...
 
struct  LiveInReg
 A virtual register or regunit required by a basic block or its trace successors. More...
 
class  Trace
 A trace represents a plausible sequence of executed basic blocks that passes through the current basic block one. More...
 
struct  TraceBlockInfo
 Per-basic block information that relates to a specific trace through the block. More...
 

Public Types

enum  Strategy { TS_MinInstrCount, TS_NumStrategies }
 Strategies for selecting traces. More...
 

Public Member Functions

 MachineTraceMetrics ()
 
void getAnalysisUsage (AnalysisUsage &) const override
 getAnalysisUsage - Subclasses that override getAnalysisUsage must call this. More...
 
bool runOnMachineFunction (MachineFunction &) override
 runOnMachineFunction - This method must be overloaded to perform the desired machine code transformation or analysis. More...
 
void releaseMemory () override
 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. More...
 
void verifyAnalysis () const override
 verifyAnalysis() - This member can be implemented by a analysis pass to check state of analysis information. More...
 
const FixedBlockInfogetResources (const MachineBasicBlock *)
 Get the fixed resource information about MBB. Compute it on demand. More...
 
ArrayRef< unsignedgetProcResourceCycles (unsigned MBBNum) const
 Get the scaled number of cycles used per processor resource in MBB. More...
 
EnsemblegetEnsemble (Strategy)
 Get the trace ensemble representing the given trace selection strategy. More...
 
void invalidate (const MachineBasicBlock *MBB)
 Invalidate cached information about MBB. More...
 
- 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. More...
 
- 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. More...
 
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. More...
 
PassManagerType getPotentialPassManagerType () const override
 Return what kind of Pass Manager can manage this pass. More...
 
- 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. More...
 
AnalysisID getPassID () const
 getPassID - Return the PassID number that corresponds to this pass. More...
 
virtual bool doFinalization (Module &)
 doFinalization - Virtual method overriden by subclasses to do any necessary clean up after all passes have run. More...
 
virtual void print (raw_ostream &OS, const Module *M) const
 print - Print out the internal state of the pass. More...
 
void dump () const
 
virtual void preparePassManager (PMStack &)
 Check if available pass managers are suitable for this pass or not. More...
 
void setResolver (AnalysisResolver *AR)
 
AnalysisResolvergetResolver () const
 
virtual void * getAdjustedAnalysisPointer (AnalysisID ID)
 getAdjustedAnalysisPointer - This method is used when a pass implements an analysis interface through multiple inheritance. More...
 
virtual ImmutablePassgetAsImmutablePass ()
 
virtual PMDataManagergetAsPMDataManager ()
 
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. More...
 
bool mustPreserveAnalysisID (char &AID) const
 mustPreserveAnalysisID - This method serves the same function as getAnalysisIfAvailable, but works if you just have an AnalysisID. More...
 
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. More...
 
template<typename AnalysisType >
AnalysisType & getAnalysis (Function &F)
 getAnalysis<AnalysisType>() - This function is used by subclasses to get to the analysis information that they claim to use by overriding the getAnalysisUsage function. More...
 
template<typename AnalysisType >
AnalysisType & getAnalysisID (AnalysisID PI) const
 
template<typename AnalysisType >
AnalysisType & getAnalysisID (AnalysisID PI, Function &F)
 

Static Public Attributes

static char ID = 0
 

Friends

class Ensemble
 
class Trace
 

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)
 
- Protected Member Functions inherited from llvm::MachineFunctionPass
 MachineFunctionPass (char &ID)
 
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. More...
 

Detailed Description

Definition at line 88 of file MachineTraceMetrics.h.

Member Enumeration Documentation

◆ Strategy

Strategies for selecting traces.

Enumerator
TS_MinInstrCount 

Select the trace through a block that has the fewest instructions.

TS_NumStrategies 

Definition at line 378 of file MachineTraceMetrics.h.

Constructor & Destructor Documentation

◆ MachineTraceMetrics()

Machine Trace true MachineTraceMetrics::MachineTraceMetrics ( )

Definition at line 55 of file MachineTraceMetrics.cpp.

References llvm::sys::path::begin(), and llvm::sys::path::end().

Member Function Documentation

◆ getAnalysisUsage()

void MachineTraceMetrics::getAnalysisUsage ( AnalysisUsage AU) const
overridevirtual

getAnalysisUsage - Subclasses that override getAnalysisUsage must call this.

For MachineFunctionPasses, calling AU.preservesCFG() indicates that the pass does not modify the MachineBasicBlock CFG.

Reimplemented from llvm::MachineFunctionPass.

Definition at line 59 of file MachineTraceMetrics.cpp.

References llvm::AnalysisUsage::addRequired(), llvm::MachineFunctionPass::getAnalysisUsage(), and llvm::AnalysisUsage::setPreservesAll().

◆ getEnsemble()

MachineTraceMetrics::Ensemble * MachineTraceMetrics::getEnsemble ( MachineTraceMetrics::Strategy  strategy)

Get the trace ensemble representing the given trace selection strategy.

The returned Ensemble object is owned by the MachineTraceMetrics analysis, and valid for the lifetime of the analysis pass.

Definition at line 384 of file MachineTraceMetrics.cpp.

References assert(), E, llvm_unreachable, TS_MinInstrCount, and TS_NumStrategies.

◆ getProcResourceCycles()

ArrayRef< unsigned > MachineTraceMetrics::getProcResourceCycles ( unsigned  MBBNum) const

Get the scaled number of cycles used per processor resource in MBB.

This is an array with SchedModel.getNumProcResourceKinds() entries. The getResources() function above must have been called first.

These numbers have already been scaled by SchedModel.getResourceFactor().

Definition at line 145 of file MachineTraceMetrics.cpp.

References assert(), llvm::SmallVectorTemplateCommon< T, typename >::data(), llvm::TargetSchedModel::getNumProcResourceKinds(), llvm::makeArrayRef(), and llvm::SmallVectorBase::size().

Referenced by llvm::MachineTraceMetrics::Ensemble::getLoopFor().

◆ getResources()

const MachineTraceMetrics::FixedBlockInfo * MachineTraceMetrics::getResources ( const MachineBasicBlock MBB)

◆ invalidate()

void MachineTraceMetrics::invalidate ( const MachineBasicBlock MBB)

Invalidate cached information about MBB.

This must be called before MBB is erased, or the CFG is otherwise changed.

This invalidates per-block information about resource usage for MBB only, and it invalidates per-trace information for any trace that passes through MBB.

Call Ensemble::getTrace() again to update any trace handles.

Definition at line 397 of file MachineTraceMetrics.cpp.

References llvm::dbgs(), llvm::MachineBasicBlock::getNumber(), LLVM_DEBUG, llvm::printMBBReference(), and TS_NumStrategies.

◆ releaseMemory()

void MachineTraceMetrics::releaseMemory ( )
overridevirtual

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.

The default behavior of passes is to hold onto memory for the entire duration of their lifetime (which is the entire compile time). For pipelined passes, this is not a big deal because that memory gets recycled every time the pass is invoked on another program unit. For IP passes, it is more important to free memory when it is unused.

Optionally implement this function to release pass memory when it is no longer used.

Reimplemented from llvm::Pass.

Definition at line 80 of file MachineTraceMetrics.cpp.

References TS_NumStrategies.

◆ runOnMachineFunction()

bool MachineTraceMetrics::runOnMachineFunction ( MachineFunction MF)
overridevirtual

◆ verifyAnalysis()

void MachineTraceMetrics::verifyAnalysis ( ) const
overridevirtual

verifyAnalysis() - This member can be implemented by a analysis pass to check state of analysis information.

Reimplemented from llvm::Pass.

Definition at line 406 of file MachineTraceMetrics.cpp.

References assert(), Loops, loops, and TS_NumStrategies.

Friends And Related Function Documentation

◆ Ensemble

friend class Ensemble
friend

Definition at line 97 of file MachineTraceMetrics.h.

Referenced by isExitingLoop().

◆ Trace

friend class Trace
friend

Definition at line 98 of file MachineTraceMetrics.h.

Member Data Documentation

◆ ID

char MachineTraceMetrics::ID = 0
static

Definition at line 100 of file MachineTraceMetrics.h.


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