Abstract base interface for LS (load/store) units in llvm-mca. More...

#include "llvm/MCA/HardwareUnits/LSUnit.h"

Inheritance diagram for llvm::mca::LSUnitBase:

Collaboration diagram for llvm::mca::LSUnitBase:

Public Types
enum	Status { LSU_AVAILABLE = 0, LSU_LQUEUE_FULL, LSU_SQUEUE_FULL }

Public Member Functions
	LSUnitBase (const MCSchedModel &SM, unsigned LoadQueueSize, unsigned StoreQueueSize, bool AssumeNoAlias)

virtual	~LSUnitBase ()

unsigned	getLoadQueueSize () const
	Returns the total number of entries in the load queue. More...

unsigned	getStoreQueueSize () const
	Returns the total number of entries in the store queue. More...

unsigned	getUsedLQEntries () const

unsigned	getUsedSQEntries () const

void	acquireLQSlot ()

void	acquireSQSlot ()

void	releaseLQSlot ()

void	releaseSQSlot ()

bool	assumeNoAlias () const

virtual Status	isAvailable (const InstRef &IR) const =0
	This method checks the availability of the load/store buffers. More...

virtual unsigned	dispatch (const InstRef &IR)=0
	Allocates LS resources for instruction IR. More...

bool	isSQEmpty () const

bool	isLQEmpty () const

bool	isSQFull () const

bool	isLQFull () const

bool	isValidGroupID (unsigned Index) const

bool	isReady (const InstRef &IR) const
	Check if a peviously dispatched instruction IR is now ready for execution. More...

bool	isPending (const InstRef &IR) const
	Check if instruction IR only depends on memory instructions that are currently executing. More...

bool	isWaiting (const InstRef &IR) const
	Check if instruction IR is still waiting on memory operations, and the wait time is still unknown. More...

bool	hasDependentUsers (const InstRef &IR) const

const MemoryGroup &	getGroup (unsigned Index) const

MemoryGroup &	getGroup (unsigned Index)

unsigned	createMemoryGroup ()

virtual void	onInstructionExecuted (const InstRef &IR)

virtual void	onInstructionRetired (const InstRef &IR)

virtual void	onInstructionIssued (const InstRef &IR)

virtual void	cycleEvent ()

void	dump () const

Public Member Functions inherited from llvm::mca::HardwareUnit
	HardwareUnit ()=default

virtual	~HardwareUnit ()

Detailed Description

Abstract base interface for LS (load/store) units in llvm-mca.

Definition at line 167 of file LSUnit.h.

Member Enumeration Documentation

◆ Status

enum llvm::mca::LSUnitBase::Status

Enumerator
LSU_AVAILABLE
LSU_LQUEUE_FULL
LSU_SQUEUE_FULL

Definition at line 219 of file LSUnit.h.

Constructor & Destructor Documentation

◆ LSUnitBase()

llvm::mca::LSUnitBase::LSUnitBase	(	const MCSchedModel &	SM,
		unsigned	LoadQueueSize,
		unsigned	StoreQueueSize,
		bool	AssumeNoAlias
	)

Definition at line 24 of file LSUnit.cpp.

References llvm::MCProcResourceDesc::BufferSize, llvm::MCSchedModel::getExtraProcessorInfo(), llvm::MCSchedModel::getProcResource(), llvm::MCSchedModel::hasExtraProcessorInfo(), llvm::MCExtraProcessorInfo::LoadQueueID, llvm::max(), and llvm::MCExtraProcessorInfo::StoreQueueID.

◆ ~LSUnitBase()

llvm::mca::LSUnitBase::~LSUnitBase ( )

virtual

Definition at line 42 of file LSUnit.cpp.

Member Function Documentation

◆ acquireLQSlot()

void llvm::mca::LSUnitBase::acquireLQSlot ( )

inline

Definition at line 212 of file LSUnit.h.

Referenced by llvm::mca::LSUnit::dispatch().

◆ acquireSQSlot()

void llvm::mca::LSUnitBase::acquireSQSlot ( )

inline

Definition at line 213 of file LSUnit.h.

Referenced by llvm::mca::LSUnit::dispatch().

◆ assumeNoAlias()

bool llvm::mca::LSUnitBase::assumeNoAlias ( ) const

inline

Definition at line 217 of file LSUnit.h.

References llvm::NoAlias.

Referenced by llvm::mca::LSUnit::dispatch().

◆ createMemoryGroup()

unsigned llvm::mca::LSUnitBase::createMemoryGroup ( )

inline

Definition at line 288 of file LSUnit.h.

References llvm::DenseMapBase< DenseMap< KeyT, ValueT, KeyInfoT, BucketT >, KeyT, ValueT, KeyInfoT, BucketT >::insert(), IR, and llvm::mca::MemoryGroup::onInstructionExecuted().

Referenced by llvm::mca::LSUnit::dispatch().

◆ cycleEvent()

void llvm::mca::LSUnitBase::cycleEvent ( )

virtual

Definition at line 44 of file LSUnit.cpp.

References G.

Referenced by llvm::mca::Scheduler::cycleEvent().

◆ dispatch()

virtual unsigned llvm::mca::LSUnitBase::dispatch ( const InstRef & IR )

pure virtual

Allocates LS resources for instruction IR.

This method assumes that a previous call to isAvailable(IR) succeeded with a LSUnitBase::Status value of LSU_AVAILABLE. Returns the GroupID associated with this instruction. That value will be used to set the LSUTokenID field in class Instruction.

Implemented in llvm::mca::LSUnit.

Referenced by llvm::mca::Scheduler::dispatch().

◆ dump()

void llvm::mca::LSUnitBase::dump ( ) const

Definition at line 50 of file LSUnit.cpp.

References llvm::dbgs(), getLoadQueueSize(), llvm::mca::MemoryGroup::getNumExecuted(), llvm::mca::MemoryGroup::getNumExecutedPredecessors(), llvm::mca::MemoryGroup::getNumExecuting(), llvm::mca::MemoryGroup::getNumExecutingPredecessors(), llvm::mca::MemoryGroup::getNumInstructions(), llvm::mca::MemoryGroup::getNumPredecessors(), getStoreQueueSize(), getUsedLQEntries(), and getUsedSQEntries().

◆ getGroup() [1/2]

const MemoryGroup& llvm::mca::LSUnitBase::getGroup ( unsigned Index ) const

inline

Definition at line 278 of file LSUnit.h.

References assert(), and llvm::DenseMapBase< DenseMap< KeyT, ValueT, KeyInfoT, BucketT >, KeyT, ValueT, KeyInfoT, BucketT >::find().

Referenced by llvm::mca::LSUnit::dispatch(), and llvm::mca::Scheduler::isAvailable().

◆ getGroup() [2/2]

MemoryGroup& llvm::mca::LSUnitBase::getGroup ( unsigned Index )

inline

Definition at line 283 of file LSUnit.h.

References assert(), and llvm::DenseMapBase< DenseMap< KeyT, ValueT, KeyInfoT, BucketT >, KeyT, ValueT, KeyInfoT, BucketT >::find().

◆ getLoadQueueSize()

unsigned llvm::mca::LSUnitBase::getLoadQueueSize ( ) const

inline

Returns the total number of entries in the load queue.

Definition at line 205 of file LSUnit.h.

Referenced by dump().

◆ getStoreQueueSize()

unsigned llvm::mca::LSUnitBase::getStoreQueueSize ( ) const

inline

Returns the total number of entries in the store queue.

Definition at line 208 of file LSUnit.h.

Referenced by dump().

◆ getUsedLQEntries()

unsigned llvm::mca::LSUnitBase::getUsedLQEntries ( ) const

inline

Definition at line 210 of file LSUnit.h.

Referenced by dump().

◆ getUsedSQEntries()

unsigned llvm::mca::LSUnitBase::getUsedSQEntries ( ) const

inline

Definition at line 211 of file LSUnit.h.

Referenced by dump().

◆ hasDependentUsers()

bool llvm::mca::LSUnitBase::hasDependentUsers ( const InstRef & IR ) const

inline

Definition at line 272 of file LSUnit.h.

References llvm::mca::InstRef::getInstruction(), llvm::mca::Instruction::getLSUTokenID(), llvm::mca::MemoryGroup::getNumSuccessors(), and llvm::mca::MemoryGroup::isExecuted().

Referenced by llvm::mca::Scheduler::issueInstruction().

◆ isAvailable()

virtual Status llvm::mca::LSUnitBase::isAvailable ( const InstRef & IR ) const

pure virtual

This method checks the availability of the load/store buffers.

Returns LSU_AVAILABLE if there are enough load/store queue entries to accomodate instruction IR. By default, LSU_AVAILABLE is returned if IR is not a memory operation.

Implemented in llvm::mca::LSUnit.

Referenced by llvm::mca::Scheduler::isAvailable().