#include <tagged_entry.hh>

Inheritance diagram for TaggedEntry:

Public Member Functions
	TaggedEntry ()

	~TaggedEntry ()=default

virtual bool	isValid () const
	Checks if the entry is valid. More...

bool	isSecure () const
	Check if this block holds data from the secure memory space. More...

virtual Addr	getTag () const
	Get tag associated to this block. More...

virtual bool	matchTag (Addr tag, bool is_secure) const
	Checks if the given tag information corresponds to this entry's. More...

virtual void	insert (const Addr tag, const bool is_secure)
	Insert the block by assigning it a tag and marking it valid. More...

virtual void	invalidate ()
	Invalidate the block. More...

std::string	print () const override
	Prints relevant information about this entry. More...

Public Member Functions inherited from ReplaceableEntry
	ReplaceableEntry ()=default

virtual	~ReplaceableEntry ()=default

virtual void	setPosition (const uint32_t set, const uint32_t way)
	Set both the set and way. More...

uint32_t	getSet () const
	Get set number. More...

uint32_t	getWay () const
	Get way number. More...

Protected Member Functions
virtual void	setTag (Addr tag)
	Set tag associated to this block. More...

virtual void	setSecure ()
	Set secure bit. More...

virtual void	setValid ()
	Set valid bit. More...

Private Member Functions
void	clearSecure ()
	Clear secure bit. More...

Private Attributes
bool	_valid
	Valid bit. More...

bool	_secure
	Secure bit. More...

Addr	_tag
	The entry's tag. More...

Additional Inherited Members
Public Attributes inherited from ReplaceableEntry
std::shared_ptr< ReplacementPolicy::ReplacementData >	replacementData
	Replacement data associated to this entry. More...

Protected Attributes inherited from ReplaceableEntry
uint32_t	_set
	Set to which this entry belongs. More...

uint32_t	_way
	Way (relative position within the set) to which this entry belongs. More...

Detailed Description

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer; redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution; neither the name of the copyright holders nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. A tagged entry is an entry containing a tag. Each tag is accompanied by a secure bit, which informs whether it belongs to a secure address space. A tagged entry's contents are only relevant if it is marked as valid.

Definition at line 43 of file tagged_entry.hh.

Constructor & Destructor Documentation

◆ TaggedEntry()

TaggedEntry::TaggedEntry ( )

inline

Definition at line 46 of file tagged_entry.hh.

◆ ~TaggedEntry()

TaggedEntry::~TaggedEntry ( )

default

Member Function Documentation

◆ clearSecure()

void TaggedEntry::clearSecure ( )

inlineprivate

Clear secure bit.

Should be only used by the invalidation function.

Definition at line 151 of file tagged_entry.hh.

References _secure.

Referenced by invalidate().

◆ getTag()

virtual Addr TaggedEntry::getTag ( ) const

inlinevirtual

Get tag associated to this block.

Returns: The tag value.

Reimplemented in SectorSubBlk.

Definition at line 68 of file tagged_entry.hh.

References _tag.

Referenced by FALRU::findBlock(), SectorSubBlk::getTag(), FALRU::insertBlock(), FALRU::invalidate(), matchTag(), print(), SectorTags::regenerateBlkAddr(), BaseSetAssoc::regenerateBlkAddr(), FALRU::regenerateBlkAddr(), and Prefetcher::IndirectMemory::trackMissIndex2().

◆ insert()

virtual void TaggedEntry::insert	(	const Addr	tag,
		const bool	is_secure
	)

inlinevirtual

Insert the block by assigning it a tag and marking it valid.

Touches block if it hadn't been touched previously.

Parameters

tag	The tag value.

Reimplemented in SectorSubBlk, and TempCacheBlk.

Definition at line 90 of file tagged_entry.hh.

References setSecure(), setTag(), and setValid().

Referenced by SectorSubBlk::insert().

◆ invalidate()

virtual void TaggedEntry::invalidate ( )

inlinevirtual

Invalidate the block.

Its contents are no longer valid.

Reimplemented in TempCacheBlk, SuperBlk, CacheBlk, Prefetcher::IndirectMemory::IndirectPatternDetectorEntry, CompressionBlk, Compressor::FrequentValues::VFTEntry, Prefetcher::Stride::StrideEntry, SectorSubBlk, Prefetcher::SignaturePath::PatternEntry, Prefetcher::IndirectMemory::PrefetchTableEntry, Prefetcher::AccessMapPatternMatching::AccessMapEntry, Prefetcher::STeMS::ActiveGenerationTableEntry, Prefetcher::IrregularStreamBuffer::AddressMappingEntry, and Prefetcher::DeltaCorrelatingPredictionTables::DCPTEntry.

Definition at line 100 of file tagged_entry.hh.

References _valid, clearSecure(), MaxAddr, and setTag().

Referenced by Prefetcher::DeltaCorrelatingPredictionTables::DCPTEntry::invalidate(), Prefetcher::IrregularStreamBuffer::AddressMappingEntry::invalidate(), Prefetcher::STeMS::ActiveGenerationTableEntry::invalidate(), Prefetcher::AccessMapPatternMatching::AccessMapEntry::invalidate(), Prefetcher::IndirectMemory::PrefetchTableEntry::invalidate(), Prefetcher::SignaturePath::PatternEntry::invalidate(), Prefetcher::Stride::StrideEntry::invalidate(), Compressor::FrequentValues::VFTEntry::invalidate(), Prefetcher::IndirectMemory::IndirectPatternDetectorEntry::invalidate(), CacheBlk::invalidate(), SuperBlk::invalidate(), and SectorBlk::invalidateSubBlk().

◆ isSecure()

bool TaggedEntry::isSecure ( ) const

inline

Check if this block holds data from the secure memory space.

Returns: True if the block holds data from the secure memory space.

Definition at line 61 of file tagged_entry.hh.

References _secure.

Referenced by Cache::cleanEvictBlk(), BaseCache::cmpAndSwap(), FALRU::findBlock(), BaseCache::handleFill(), FALRU::insertBlock(), FALRU::invalidate(), matchTag(), print(), CacheBlkPrintWrapper::print(), BaseCache::satisfyRequest(), BaseCache::updateBlockData(), BaseCache::updateCompressionData(), BaseCache::writebackBlk(), BaseCache::writebackVisitor(), and BaseCache::writecleanBlk().

◆ isValid()

virtual bool TaggedEntry::isValid ( ) const

inlinevirtual

Checks if the entry is valid.

Returns: True if the entry is valid.

Reimplemented in SectorBlk.

Definition at line 54 of file tagged_entry.hh.

References _valid.

Referenced by NoncoherentCache::access(), Cache::access(), BaseCache::access(), FALRU::accessBlock(), Cache::cleanEvictBlk(), BaseTags::cleanupRefsVisitor(), BaseTags::computeStatsVisitor(), NoncoherentCache::createMissPacket(), Cache::createMissPacket(), FALRU::findBlock(), CompressedTags::findVictim(), SectorTags::findVictim(), BaseCache::functionalAccess(), SectorSubBlk::getTag(), Cache::handleAtomicReqMiss(), BaseCache::handleFill(), Cache::handleSnoop(), NoncoherentCache::handleTimingReqMiss(), Cache::handleTimingReqMiss(), BaseCache::handleTimingReqMiss(), CacheBlk::insert(), BaseTags::insertBlock(), BaseTags::invalidate(), BaseCache::invalidateBlock(), BaseCache::invalidateVisitor(), CacheBlk::isSet(), BaseCache::maintainClusivity(), matchTag(), SectorTags::moveBlock(), BaseTags::moveBlock(), CacheBlk::operator=(), print(), CacheBlk::print(), CacheBlkPrintWrapper::print(), FALRU::CacheTracking::recordAccess(), BaseCache::recvAtomic(), BaseCache::recvTimingResp(), BaseCache::satisfyRequest(), Cache::serviceMSHRTargets(), CacheBlk::setCoherenceBits(), setValid(), BaseCache::writebackBlk(), and BaseCache::writebackVisitor().

◆ matchTag()

virtual bool TaggedEntry::matchTag	(	Addr	tag,
		bool	is_secure
	)		const

inlinevirtual

Checks if the given tag information corresponds to this entry's.

Parameters

tag	The tag value to compare to.
is_secure	Whether secure bit is set.

Returns: True if the tag information match this entry's.

Definition at line 78 of file tagged_entry.hh.

References getTag(), isSecure(), and isValid().

Referenced by BaseTags::findBlock(), CompressedTags::findVictim(), SectorTags::findVictim(), and SectorSubBlk::insert().

◆ print()

std::string TaggedEntry::print ( ) const

inlineoverridevirtual

Prints relevant information about this entry.

Returns: A string containg the contents of this entry.

Reimplemented from ReplaceableEntry.

Definition at line 108 of file tagged_entry.hh.

References csprintf(), getTag(), isSecure(), isValid(), and ReplaceableEntry::print().

Referenced by SectorBlk::print(), and CacheBlk::print().

◆ setSecure()

virtual void TaggedEntry::setSecure ( )

inlineprotectedvirtual

Set secure bit.

Definition at line 123 of file tagged_entry.hh.

References _secure.

Referenced by insert().

◆ setTag()

virtual void TaggedEntry::setTag ( Addr tag )

inlineprotectedvirtual

Set tag associated to this block.

Parameters

tag	The tag value.

Definition at line 120 of file tagged_entry.hh.

References _tag.

Referenced by insert(), and invalidate().

◆ setValid()

virtual void TaggedEntry::setValid ( )

inlineprotectedvirtual

Set valid bit.

The block must be invalid beforehand.

Reimplemented in SectorSubBlk.

Definition at line 127 of file tagged_entry.hh.

References _valid, and isValid().

Referenced by insert(), and SectorSubBlk::setValid().

Member Data Documentation

◆ _secure

bool TaggedEntry::_secure

private

Secure bit.

Marks whether this entry refers to an address in the secure memory space. Must always be modified along with the tag.

Definition at line 145 of file tagged_entry.hh.

Referenced by clearSecure(), isSecure(), and setSecure().

◆ _tag

Addr TaggedEntry::_tag

private

The entry's tag.

Definition at line 148 of file tagged_entry.hh.

Referenced by getTag(), and setTag().

◆ _valid

bool TaggedEntry::_valid

private

Valid bit.

The contents of this entry are only valid if this bit is set.

See also: invalidate(); insert()

Definition at line 139 of file tagged_entry.hh.

Referenced by invalidate(), isValid(), and setValid().

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

mem/cache/tags/tagged_entry.hh

Public Member Functions

Protected Member Functions

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ TaggedEntry()

◆ ~TaggedEntry()

Member Function Documentation

◆ clearSecure()

◆ getTag()

◆ insert()

◆ invalidate()

◆ isSecure()

◆ isValid()

◆ matchTag()

◆ print()

◆ setSecure()

◆ setTag()

◆ setValid()

Member Data Documentation

◆ _secure

◆ _tag

◆ _valid