gem5 v24.1.0.1
|
A common base class for indexing table locations. More...
#include <base.hh>
Public Member Functions | |
IndexingPolicyTemplate (const Params &p, uint32_t num_entries, int set_shift) | |
Construct and initialize this policy. | |
~IndexingPolicyTemplate () | |
Destructor. | |
void | setEntry (ReplaceableEntry *entry, const uint64_t index) |
Associate a pointer to an entry to its physical counterpart. | |
ReplaceableEntry * | getEntry (const uint32_t set, const uint32_t way) const |
Get an entry based on its set and way. | |
virtual Addr | extractTag (const Addr addr) const |
Generate the tag from the given address. | |
virtual std::vector< ReplaceableEntry * > | getPossibleEntries (const KeyType &key) const =0 |
Find all possible entries for insertion and replacement of an address. | |
virtual Addr | regenerateAddr (const KeyType &key, const ReplaceableEntry *entry) const =0 |
Regenerate an entry's address from its tag and assigned indexing bits. | |
![]() | |
const Params & | params () const |
SimObject (const Params &p) | |
virtual | ~SimObject () |
virtual void | init () |
init() is called after all C++ SimObjects have been created and all ports are connected. | |
virtual void | loadState (CheckpointIn &cp) |
loadState() is called on each SimObject when restoring from a checkpoint. | |
virtual void | initState () |
initState() is called on each SimObject when not restoring from a checkpoint. | |
virtual void | regProbePoints () |
Register probe points for this object. | |
virtual void | regProbeListeners () |
Register probe listeners for this object. | |
ProbeManager * | getProbeManager () |
Get the probe manager for this object. | |
virtual Port & | getPort (const std::string &if_name, PortID idx=InvalidPortID) |
Get a port with a given name and index. | |
virtual void | startup () |
startup() is the final initialization call before simulation. | |
DrainState | drain () override |
Provide a default implementation of the drain interface for objects that don't need draining. | |
virtual void | memWriteback () |
Write back dirty buffers to memory using functional writes. | |
virtual void | memInvalidate () |
Invalidate the contents of memory buffers. | |
void | serialize (CheckpointOut &cp) const override |
Serialize an object. | |
void | unserialize (CheckpointIn &cp) override |
Unserialize an object. | |
![]() | |
EventQueue * | eventQueue () const |
void | schedule (Event &event, Tick when) |
void | deschedule (Event &event) |
void | reschedule (Event &event, Tick when, bool always=false) |
void | schedule (Event *event, Tick when) |
void | deschedule (Event *event) |
void | reschedule (Event *event, Tick when, bool always=false) |
void | wakeupEventQueue (Tick when=(Tick) -1) |
This function is not needed by the usual gem5 event loop but may be necessary in derived EventQueues which host gem5 on other schedulers. | |
void | setCurTick (Tick newVal) |
EventManager (EventManager &em) | |
Event manger manages events in the event queue. | |
EventManager (EventManager *em) | |
EventManager (EventQueue *eq) | |
![]() | |
Serializable () | |
virtual | ~Serializable () |
void | serializeSection (CheckpointOut &cp, const char *name) const |
Serialize an object into a new section. | |
void | serializeSection (CheckpointOut &cp, const std::string &name) const |
void | unserializeSection (CheckpointIn &cp, const char *name) |
Unserialize an a child object. | |
void | unserializeSection (CheckpointIn &cp, const std::string &name) |
![]() | |
DrainState | drainState () const |
Return the current drain state of an object. | |
virtual void | notifyFork () |
Notify a child process of a fork. | |
![]() | |
Group (Group *parent, const char *name=nullptr) | |
Construct a new statistics group. | |
virtual | ~Group () |
virtual void | regStats () |
Callback to set stat parameters. | |
virtual void | resetStats () |
Callback to reset stats. | |
virtual void | preDumpStats () |
Callback before stats are dumped. | |
void | addStat (statistics::Info *info) |
Register a stat with this group. | |
const std::map< std::string, Group * > & | getStatGroups () const |
Get all child groups associated with this object. | |
const std::vector< Info * > & | getStats () const |
Get all stats associated with this object. | |
void | addStatGroup (const char *name, Group *block) |
Add a stat block as a child of this block. | |
const Info * | resolveStat (std::string name) const |
Resolve a stat by its name within this group. | |
void | mergeStatGroup (Group *block) |
Merge the contents (stats & children) of a block to this block. | |
Group (const Group &)=delete | |
Group & | operator= (const Group &)=delete |
![]() | |
Named (const std::string &name_) | |
virtual | ~Named ()=default |
virtual std::string | name () const |
Protected Types | |
using | KeyType = typename Types::KeyType |
using | Params = typename Types::Params |
Protected Attributes | |
const unsigned | assoc |
The associativity. | |
const uint32_t | numSets |
The number of sets in the cache. | |
const int | setShift |
The amount to shift the address to get the set. | |
const unsigned | setMask |
Mask out all bits that aren't part of the set index. | |
std::vector< std::vector< ReplaceableEntry * > > | sets |
The cache sets. | |
const int | tagShift |
The amount to shift the address to get the tag. | |
![]() | |
const SimObjectParams & | _params |
Cached copy of the object parameters. | |
![]() | |
EventQueue * | eventq |
A pointer to this object's event queue. | |
Additional Inherited Members | |
![]() | |
typedef SimObjectParams | Params |
![]() | |
static void | serializeAll (const std::string &cpt_dir) |
Create a checkpoint by serializing all SimObjects in the system. | |
static SimObject * | find (const char *name) |
Find the SimObject with the given name and return a pointer to it. | |
static void | setSimObjectResolver (SimObjectResolver *resolver) |
There is a single object name resolver, and it is only set when simulation is restoring from checkpoints. | |
static SimObjectResolver * | getSimObjectResolver () |
There is a single object name resolver, and it is only set when simulation is restoring from checkpoints. | |
![]() | |
static const std::string & | currentSection () |
Gets the fully-qualified name of the active section. | |
static void | generateCheckpointOut (const std::string &cpt_dir, std::ofstream &outstream) |
Generate a checkpoint file so that the serialization can be routed to it. | |
![]() | |
Drainable () | |
virtual | ~Drainable () |
virtual void | drainResume () |
Resume execution after a successful drain. | |
void | signalDrainDone () const |
Signal that an object is drained. | |
A common base class for indexing table locations.
Classes that inherit from it determine hash functions that should be applied based on the set and way. These functions are then applied to re-map the original values.
Types | the Types template parameter shall contain the following type traits:
|
|
protected |
|
protected |
|
inline |
Construct and initialize this policy.
Definition at line 112 of file base.hh.
References gem5::IndexingPolicyTemplate< Types >::assoc, fatal_if, gem5::ArmISA::i, gem5::isPowerOf2(), gem5::IndexingPolicyTemplate< Types >::numSets, and gem5::IndexingPolicyTemplate< Types >::sets.
|
inline |
|
inlinevirtual |
Generate the tag from the given address.
addr | The address to get the tag from. |
Reimplemented in gem5::BTBSetAssociative, and gem5::prefetch::StridePrefetcherHashedSetAssociative.
Definition at line 180 of file base.hh.
References gem5::X86ISA::addr, and gem5::IndexingPolicyTemplate< Types >::tagShift.
Referenced by gem5::BaseTags::extractTag().
|
inline |
Get an entry based on its set and way.
All entries must have been set already before calling this function.
set | The set of the desired entry. |
way | The way of the desired entry. |
Definition at line 168 of file base.hh.
References gem5::ArmISA::set, and gem5::IndexingPolicyTemplate< Types >::sets.
Referenced by gem5::BaseTags::findBlockBySetAndWay().
|
pure virtual |
Find all possible entries for insertion and replacement of an address.
Should be called immediately before ReplacementPolicy's findVictim() not to break cache resizing.
addr | The addr to a find possible entries for. |
Implemented in gem5::ArmISA::TLBSetAssociative, and gem5::TaggedSetAssociative.
Referenced by gem5::BaseTags::findBlock(), gem5::SectorTags::findBlock(), gem5::CompressedTags::findVictim(), gem5::SectorTags::findVictim(), and gem5::BaseSetAssoc::findVictim().
|
pure virtual |
Regenerate an entry's address from its tag and assigned indexing bits.
tag | The tag bits. |
entry | The entry. |
Implemented in gem5::ArmISA::TLBSetAssociative, and gem5::TaggedSetAssociative.
Referenced by gem5::BaseSetAssoc::regenerateBlkAddr(), and gem5::SectorTags::regenerateBlkAddr().
|
inline |
Associate a pointer to an entry to its physical counterpart.
entry | The entry pointer. |
index | An unique index for the entry. |
Definition at line 142 of file base.hh.
References gem5::IndexingPolicyTemplate< Types >::assoc, gem5::MipsISA::index, gem5::IndexingPolicyTemplate< Types >::numSets, gem5::ArmISA::set, gem5::ReplaceableEntry::setPosition(), and gem5::IndexingPolicyTemplate< Types >::sets.
Referenced by gem5::BaseSetAssoc::tagsInit(), gem5::CompressedTags::tagsInit(), and gem5::SectorTags::tagsInit().
|
protected |
The associativity.
Definition at line 81 of file base.hh.
Referenced by gem5::SkewedAssociative::getPossibleEntries(), gem5::IndexingPolicyTemplate< Types >::IndexingPolicyTemplate(), gem5::IndexingPolicyTemplate< Types >::setEntry(), and gem5::SkewedAssociative::SkewedAssociative().
|
protected |
The number of sets in the cache.
Definition at line 86 of file base.hh.
Referenced by gem5::IndexingPolicyTemplate< Types >::IndexingPolicyTemplate(), gem5::IndexingPolicyTemplate< Types >::setEntry(), and gem5::SkewedAssociative::SkewedAssociative().
|
protected |
Mask out all bits that aren't part of the set index.
Definition at line 96 of file base.hh.
Referenced by gem5::SetAssociative::extractSet(), gem5::SkewedAssociative::extractSet(), gem5::prefetch::StridePrefetcherHashedSetAssociative::extractSet(), gem5::ArmISA::TLBSetAssociative::getPossibleEntries(), and gem5::SkewedAssociative::regenerateAddr().
|
protected |
The cache sets.
Definition at line 101 of file base.hh.
Referenced by gem5::IndexingPolicyTemplate< Types >::getEntry(), gem5::SetAssociative::getPossibleEntries(), gem5::SkewedAssociative::getPossibleEntries(), gem5::ArmISA::TLBSetAssociative::getPossibleEntries(), gem5::IndexingPolicyTemplate< Types >::IndexingPolicyTemplate(), and gem5::IndexingPolicyTemplate< Types >::setEntry().
|
protected |
The amount to shift the address to get the set.
Definition at line 91 of file base.hh.
Referenced by gem5::SetAssociative::extractSet(), gem5::SkewedAssociative::extractSet(), gem5::SetAssociative::regenerateAddr(), gem5::SkewedAssociative::regenerateAddr(), and gem5::SkewedAssociative::SkewedAssociative().
|
protected |
The amount to shift the address to get the tag.
Definition at line 106 of file base.hh.
Referenced by gem5::prefetch::StridePrefetcherHashedSetAssociative::extractSet(), gem5::IndexingPolicyTemplate< Types >::extractTag(), gem5::SetAssociative::regenerateAddr(), and gem5::SkewedAssociative::regenerateAddr().