#include <mshr.hh>

Inheritance diagram for gem5::MSHR::TargetList:

Public Member Functions
	TargetList (const std::string &name=".unnamedTargetList")

void	updateFlags (PacketPtr pkt, Target::Source source, bool alloc_on_fill)
	Use the provided packet and the source to update the flags of this TargetList.

void	init (Addr blk_addr, Addr blk_size)
	Reset state.

void	resetFlags ()

void	populateFlags ()
	Goes through the list of targets and uses them to populate the flags of this TargetList.

void	updateWriteFlags (PacketPtr pkt)
	Add the specified packet in the TargetList.

bool	isReset () const
	Tests if the flags of this TargetList have their default values.

void	add (PacketPtr pkt, Tick readyTime, Counter order, Target::Source source, bool markPending, bool alloc_on_fill)
	Add the specified packet in the TargetList.

void	replaceUpgrades ()
	Convert upgrades to the equivalent request if the cache line they refer to would have been invalid (Upgrade -> ReadEx, SC* -> Fail).

void	clearDownstreamPending ()

void	clearDownstreamPending (iterator begin, iterator end)

bool	trySatisfyFunctional (PacketPtr pkt)

void	print (std::ostream &os, int verbosity, const std::string &prefix) const

bool	isWholeLineWrite () const
	Check if this list contains writes that cover an entire cache line.

Public Member Functions inherited from gem5::Named
	Named (const std::string &name_)

virtual	~Named ()=default

virtual std::string	name () const

Public Attributes
bool	needsWritable

bool	hasUpgrade

bool	allocOnFill
	Set when the response should allocate on fill.

bool	hasFromCache
	Determine whether there was at least one non-snooping target coming from another cache.

Public Attributes inherited from std::list< Target >
Target	item
	Dummy Item.

Private Attributes
Addr	blkAddr
	Address of the cache block for this list of targets.

Addr	blkSize
	Size of the cache block.

bool	canMergeWrites
	Indicates whether we can merge incoming write requests.

std::vector< char >	writesBitmap
	Track which bytes are written by requests in this target list.

Detailed Description

Definition at line 169 of file mshr.hh.

Constructor & Destructor Documentation

◆ TargetList()

gem5::MSHR::TargetList::TargetList ( const std::string & name = ".unnamedTargetList" )

Definition at line 73 of file mshr.cc.

Member Function Documentation

◆ add()

void gem5::MSHR::TargetList::add	(	PacketPtr	pkt,
		Tick	readyTime,
		Counter	order,
		Target::Source	source,
		bool	markPending,
		bool	alloc_on_fill )

inline

Add the specified packet in the TargetList.

This function stores information related to the added packet and updates accordingly the flags.

Parameters

pkt	Packet considered for adding
readTime	Tick at which the packet is processed by this cache
order	A counter giving a unique id to each target
source	Indicates the source agent of the packet
markPending	Set for deferred targets or pending MSHRs
alloc_on_fill	Whether it should allocate on a fill

Definition at line 164 of file mshr.cc.

References gem5::MSHR::downstreamPending, DPRINTF, gem5::Packet::findNextSenderState(), gem5::QueueEntry::order, gem5::Packet::print(), and gem5::QueueEntry::readyTime.

Referenced by gem5::MSHR::allocate(), gem5::MSHR::allocateTarget(), and gem5::MSHR::handleSnoop().

◆ clearDownstreamPending() [1/2]

void gem5::MSHR::TargetList::clearDownstreamPending ( )

Definition at line 257 of file mshr.cc.

References gem5::MSHR::clearDownstreamPending().

Referenced by gem5::MSHR::clearDownstreamPending(), gem5::MSHR::markInService(), and gem5::MSHR::promoteIf().

◆ clearDownstreamPending() [2/2]

void gem5::MSHR::TargetList::clearDownstreamPending	(	iterator	begin,
		iterator	end )

◆ init()

void gem5::MSHR::TargetList::init	(	Addr	blk_addr,
		Addr	blk_size )

inline

Reset state.

Parameters

blk_addr	Address of the cache block
blk_size	Size of the cache block

Definition at line 202 of file mshr.hh.

References blkAddr, blkSize, resetFlags(), and writesBitmap.

Referenced by gem5::MSHR::allocate(), and gem5::MSHR::extractServiceableTargets().

◆ isReset()

bool gem5::MSHR::TargetList::isReset ( ) const

inline

Tests if the flags of this TargetList have their default values.

Returns: True if the TargetList are reset, false otherwise.

Definition at line 243 of file mshr.hh.

References allocOnFill, canMergeWrites, hasFromCache, hasUpgrade, and needsWritable.

Referenced by gem5::MSHR::deallocate().

◆ isWholeLineWrite()

bool gem5::MSHR::TargetList::isWholeLineWrite ( ) const

inline

Check if this list contains writes that cover an entire cache line.

This is used as part of the miss-packet creation. Note that new requests may arrive after a miss-packet has been created, and for the corresponding fill we use the wasWholeLineWrite field.

Definition at line 282 of file mshr.hh.

References gem5::ArmISA::i, and writesBitmap.

Referenced by gem5::MSHR::isWholeLineWrite().