gem5 v24.0.0.0
|
#include <queued.hh>
Classes | |
struct | DeferredPacket |
struct | QueuedStats |
Public Types | |
using | AddrPriority = std::pair<Addr, int32_t> |
Public Types inherited from gem5::ClockedObject | |
using | Params = ClockedObjectParams |
Parameters of ClockedObject. | |
Public Types inherited from gem5::SimObject | |
typedef SimObjectParams | Params |
Public Member Functions | |
Queued (const QueuedPrefetcherParams &p) | |
virtual | ~Queued () |
void | notify (const CacheAccessProbeArg &acc, const PrefetchInfo &pfi) override |
Notify prefetcher of cache access (may be any access or just misses, depending on cache parameters.) | |
void | insert (const PacketPtr &pkt, PrefetchInfo &new_pfi, int32_t priority, const CacheAccessor &cache) |
virtual void | calculatePrefetch (const PrefetchInfo &pfi, std::vector< AddrPriority > &addresses, const CacheAccessor &cache)=0 |
PacketPtr | getPacket () override |
Tick | nextPrefetchReadyTime () const override |
void | printQueue (const std::list< DeferredPacket > &queue) const |
Public Member Functions inherited from gem5::prefetch::Base | |
Base (const BasePrefetcherParams &p) | |
virtual | ~Base ()=default |
virtual void | setParentInfo (System *sys, ProbeManager *pm, unsigned blk_size) |
virtual void | notifyFill (const CacheAccessProbeArg &acc) |
Notify prefetcher of cache fill. | |
virtual void | notifyEvict (const EvictionInfo &info) |
Notify prefetcher of cache eviction. | |
void | prefetchUnused () |
void | incrDemandMhsrMisses () |
void | pfHitInCache () |
void | pfHitInMSHR () |
void | pfHitInWB () |
void | regProbeListeners () override |
Register probe points for this object. | |
void | probeNotify (const CacheAccessProbeArg &acc, bool miss) |
Process a notification event from the ProbeListener. | |
void | addEventProbe (SimObject *obj, const char *name) |
Add a SimObject and a probe name to listen events from. | |
void | addMMU (BaseMMU *mmu) |
Add a BaseMMU object to be used whenever a translation is needed. | |
Public Member Functions inherited from gem5::ClockedObject | |
ClockedObject (const ClockedObjectParams &p) | |
void | serialize (CheckpointOut &cp) const override |
Serialize an object. | |
void | unserialize (CheckpointIn &cp) override |
Unserialize an object. | |
Public Member Functions inherited from gem5::SimObject | |
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. | |
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. | |
Public Member Functions inherited from gem5::EventManager | |
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) | |
Public Member Functions inherited from gem5::Serializable | |
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) |
Public Member Functions inherited from gem5::Drainable | |
DrainState | drainState () const |
Return the current drain state of an object. | |
virtual void | notifyFork () |
Notify a child process of a fork. | |
Public Member Functions inherited from gem5::statistics::Group | |
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 ()=delete | |
Group (const Group &)=delete | |
Group & | operator= (const Group &)=delete |
Public Member Functions inherited from gem5::Named | |
Named (const std::string &name_) | |
virtual | ~Named ()=default |
virtual std::string | name () const |
Public Member Functions inherited from gem5::Clocked | |
void | updateClockPeriod () |
Update the tick to the current tick. | |
Tick | clockEdge (Cycles cycles=Cycles(0)) const |
Determine the tick when a cycle begins, by default the current one, but the argument also enables the caller to determine a future cycle. | |
Cycles | curCycle () const |
Determine the current cycle, corresponding to a tick aligned to a clock edge. | |
Tick | nextCycle () const |
Based on the clock of the object, determine the start tick of the first cycle that is at least one cycle in the future. | |
uint64_t | frequency () const |
Tick | clockPeriod () const |
double | voltage () const |
Cycles | ticksToCycles (Tick t) const |
Tick | cyclesToTicks (Cycles c) const |
Protected Types | |
using | const_iterator = std::list<DeferredPacket>::const_iterator |
using | iterator = std::list<DeferredPacket>::iterator |
Protected Attributes | |
std::list< DeferredPacket > | pfq |
std::list< DeferredPacket > | pfqMissingTranslation |
const unsigned | queueSize |
Maximum size of the prefetch queue. | |
const unsigned | missingTranslationQueueSize |
Maximum size of the queue holding prefetch requests with missing address translations. | |
const Cycles | latency |
Cycles after generation when a prefetch can first be issued. | |
const bool | queueSquash |
Squash queued prefetch if demand access observed. | |
const bool | queueFilter |
Filter prefetches if already queued. | |
const bool | cacheSnoop |
Snoop the cache before generating prefetch (cheating basically) | |
const bool | tagPrefetch |
Tag prefetch with PC of generating access? | |
const unsigned int | throttleControlPct |
Percentage of requests that can be throttled. | |
gem5::prefetch::Queued::QueuedStats | statsQueued |
Protected Attributes inherited from gem5::prefetch::Base | |
System * | system |
Pointer to the parent system. | |
ProbeManager * | probeManager |
Pointer to the parent cache's probe manager. | |
unsigned | blkSize |
The block size of the parent cache. | |
unsigned | lBlkSize |
log_2(block size of the parent cache). | |
const bool | onMiss |
Only consult prefetcher on cache misses? | |
const bool | onRead |
Consult prefetcher on reads? | |
const bool | onWrite |
Consult prefetcher on reads? | |
const bool | onData |
Consult prefetcher on data accesses? | |
const bool | onInst |
Consult prefetcher on instruction accesses? | |
const RequestorID | requestorId |
Request id for prefetches. | |
const Addr | pageBytes |
const bool | prefetchOnAccess |
Prefetch on every access, not just misses. | |
const bool | prefetchOnPfHit |
Prefetch on hit on prefetched lines. | |
const bool | useVirtualAddresses |
Use Virtual Addresses for prefetching. | |
gem5::prefetch::Base::StatGroup | prefetchStats |
uint64_t | issuedPrefetches |
Total prefetches issued. | |
uint64_t | usefulPrefetches |
Total prefetches that has been useful. | |
BaseMMU * | mmu |
Registered mmu for address translations. | |
Protected Attributes inherited from gem5::SimObject | |
const SimObjectParams & | _params |
Cached copy of the object parameters. | |
Protected Attributes inherited from gem5::EventManager | |
EventQueue * | eventq |
A pointer to this object's event queue. | |
Private Member Functions | |
void | addToQueue (std::list< DeferredPacket > &queue, DeferredPacket &dpp) |
Adds a DeferredPacket to the specified queue. | |
void | processMissingTranslations (unsigned max) |
Starts the translations of the queued prefetches with a missing translation. | |
void | translationComplete (DeferredPacket *dp, bool failed, const CacheAccessor &cache) |
Indicates that the translation of the address of the provided deferred packet has been successfully completed, and it can be enqueued as a new prefetch request. | |
bool | alreadyInQueue (std::list< DeferredPacket > &queue, const PrefetchInfo &pfi, int32_t priority) |
Checks whether the specified prefetch request is already in the specified queue. | |
size_t | getMaxPermittedPrefetches (size_t total) const |
Returns the maxmimum number of prefetch requests that are allowed to be created from the number of prefetch candidates provided. | |
RequestPtr | createPrefetchRequest (Addr addr, PrefetchInfo const &pfi, PacketPtr pkt) |
Additional Inherited Members | |
Static Public Member Functions inherited from gem5::SimObject | |
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 Public Member Functions inherited from gem5::Serializable | |
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. | |
Public Attributes inherited from gem5::ClockedObject | |
PowerState * | powerState |
Protected Member Functions inherited from gem5::prefetch::Base | |
bool | observeAccess (const PacketPtr &pkt, bool miss, bool prefetched) const |
Determine if this access should be observed. | |
bool | samePage (Addr a, Addr b) const |
Determine if addresses are on the same page. | |
Addr | blockAddress (Addr a) const |
Determine the address of the block in which a lays. | |
Addr | blockIndex (Addr a) const |
Determine the address of a at block granularity. | |
Addr | pageAddress (Addr a) const |
Determine the address of the page in which a lays. | |
Addr | pageOffset (Addr a) const |
Determine the page-offset of a | |
Addr | pageIthBlockAddress (Addr page, uint32_t i) const |
Build the address of the i-th block inside the page. | |
Protected Member Functions inherited from gem5::Drainable | |
Drainable () | |
virtual | ~Drainable () |
virtual void | drainResume () |
Resume execution after a successful drain. | |
void | signalDrainDone () const |
Signal that an object is drained. | |
Protected Member Functions inherited from gem5::Clocked | |
Clocked (ClockDomain &clk_domain) | |
Create a clocked object and set the clock domain based on the parameters. | |
Clocked (Clocked &)=delete | |
Clocked & | operator= (Clocked &)=delete |
virtual | ~Clocked () |
Virtual destructor due to inheritance. | |
void | resetClock () const |
Reset the object's clock using the current global tick value. | |
virtual void | clockPeriodUpdated () |
A hook subclasses can implement so they can do any extra work that's needed when the clock rate is changed. | |
using gem5::prefetch::Queued::AddrPriority = std::pair<Addr, int32_t> |
|
protected |
|
protected |
gem5::prefetch::Queued::Queued | ( | const QueuedPrefetcherParams & | p | ) |
|
virtual |
Definition at line 111 of file queued.cc.
References gem5::MipsISA::p, and pfq.
|
private |
Adds a DeferredPacket to the specified queue.
queue | selected queue to use |
dpp | DeferredPacket to add |
Definition at line 487 of file queued.cc.
References DPRINTF, panic_if, gem5::prefetch::Queued::QueuedStats::pfRemovedFull, printQueue(), queueSize, and statsQueued.
Referenced by insert(), and translationComplete().
|
private |
Checks whether the specified prefetch request is already in the specified queue.
If the request is found, its priority is updated.
queue | selected queue to check |
pfi | information of the prefetch request to be added |
priority | priority of the prefetch request to be added |
Definition at line 342 of file queued.cc.
References DPRINTF, gem5::prefetch::Queued::QueuedStats::pfBufferHit, gem5::ArmISA::priority, and statsQueued.
Referenced by insert().
|
pure virtual |
Implemented in gem5::prefetch::AMPM, gem5::prefetch::BOP, gem5::prefetch::DCPT, gem5::prefetch::IndirectMemory, gem5::prefetch::IrregularStreamBuffer, gem5::prefetch::PIF, gem5::prefetch::SBOOE, gem5::prefetch::SignaturePath, gem5::prefetch::SlimAMPM, gem5::prefetch::STeMS, gem5::prefetch::Stride, and gem5::prefetch::Tagged.
Referenced by notify().
|
private |
Definition at line 377 of file queued.cc.
References gem5::X86ISA::addr, gem5::prefetch::Base::blkSize, gem5::prefetch::Base::PrefetchInfo::getPC(), gem5::Request::PREFETCH, gem5::Packet::req, and gem5::prefetch::Base::requestorId.
Referenced by insert().
|
private |
Returns the maxmimum number of prefetch requests that are allowed to be created from the number of prefetch candidates provided.
The behavior of this service is controlled with the throttleControlPct parameter.
total | number of prefetch candidates generated by the prefetcher |
Throttle generated prefetches based in the accuracy of the prefetcher. Accuracy is computed based in the ratio of useful prefetches with respect to the number of issued prefetches.
The throttleControlPct controls how many of the candidate addresses generated by the prefetcher will be finally turned into prefetch requests
Definition at line 142 of file queued.cc.
References gem5::prefetch::Base::issuedPrefetches, throttleControlPct, gem5::statistics::total, and gem5::prefetch::Base::usefulPrefetches.
Referenced by notify().
|
overridevirtual |
Implements gem5::prefetch::Base.
Definition at line 239 of file queued.cc.
References DPRINTF, gem5::Packet::getAddr(), gem5::prefetch::Base::issuedPrefetches, gem5::prefetch::Base::StatGroup::pfIssued, pfq, gem5::prefetch::Base::prefetchStats, processMissingTranslations(), and queueSize.
void gem5::prefetch::Queued::insert | ( | const PacketPtr & | pkt, |
PrefetchInfo & | new_pfi, | ||
int32_t | priority, | ||
const CacheAccessor & | cache ) |
Definition at line 388 of file queued.cc.
References addToQueue(), alreadyInQueue(), gem5::prefetch::Base::blkSize, cacheSnoop, gem5::Clocked::clockPeriod(), gem5::prefetch::Queued::DeferredPacket::createPkt(), createPrefetchRequest(), gem5::curTick(), DPRINTF, gem5::prefetch::Base::PrefetchInfo::getAddr(), gem5::CacheAccessor::inCache(), gem5::CacheAccessor::inMissQueue(), gem5::prefetch::Base::PrefetchInfo::isSecure(), latency, gem5::prefetch::Queued::QueuedStats::pfInCache, pfq, pfqMissingTranslation, gem5::ArmISA::priority, queueFilter, gem5::Packet::req, gem5::prefetch::Base::requestorId, gem5::prefetch::Base::samePage(), gem5::prefetch::Queued::DeferredPacket::setTranslationRequest(), statsQueued, gem5::ArmISA::stride, gem5::prefetch::Base::system, tagPrefetch, gem5::prefetch::Queued::DeferredPacket::tc, gem5::System::threads, and gem5::prefetch::Base::useVirtualAddresses.
Referenced by notify().
|
inlineoverridevirtual |
Implements gem5::prefetch::Base.
Definition at line 208 of file queued.hh.
References gem5::MaxTick, and pfq.
|
overridevirtual |
Notify prefetcher of cache access (may be any access or just misses, depending on cache parameters.)
Implements gem5::prefetch::Base.
Definition at line 172 of file queued.cc.
References gem5::prefetch::Base::blockAddress(), gem5::CacheAccessProbeArg::cache, calculatePrefetch(), DPRINTF, gem5::Packet::getAddr(), gem5::prefetch::Base::PrefetchInfo::getAddr(), getMaxPermittedPrefetches(), gem5::CacheAccessor::hasBeenPrefetched(), insert(), gem5::Packet::isSecure(), gem5::prefetch::Base::PrefetchInfo::isSecure(), gem5::prefetch::Base::mmu, gem5::prefetch::Queued::QueuedStats::pfIdentified, pfq, gem5::prefetch::Queued::QueuedStats::pfRemovedDemand, gem5::prefetch::Queued::QueuedStats::pfSpanPage, gem5::prefetch::Queued::QueuedStats::pfUsefulSpanPage, gem5::CacheAccessProbeArg::pkt, queueSquash, gem5::prefetch::Base::samePage(), and statsQueued.
void gem5::prefetch::Queued::printQueue | ( | const std::list< DeferredPacket > & | queue | ) | const |
Definition at line 120 of file queued.cc.
References DPRINTF, pfq, pfqMissingTranslation, and gem5::MipsISA::vaddr.
Referenced by addToQueue().
|
private |
Starts the translations of the queued prefetches with a missing translation.
It performs a maximum specified number of translations. Successful translations cause the prefetch request to be queued in the queue of ready requests.
max | maximum number of translations to perform |
Definition at line 288 of file queued.cc.
References gem5::X86ISA::count, gem5::ArmISA::dp, gem5::prefetch::Base::mmu, pfqMissingTranslation, and gem5::prefetch::Queued::DeferredPacket::startTranslation().
Referenced by getPacket().
|
private |
Indicates that the translation of the address of the provided deferred packet has been successfully completed, and it can be enqueued as a new prefetch request.
dp | the deferred packet that has completed the translation request |
failed | whether the translation was successful |
cache | accessor for lookups on the cache that originated this pkt |
Definition at line 303 of file queued.cc.
References addToQueue(), gem5::prefetch::Base::blkSize, cacheSnoop, gem5::Clocked::clockPeriod(), gem5::curTick(), gem5::ArmISA::dp, DPRINTF, gem5::CacheAccessor::inCache(), gem5::CacheAccessor::inMissQueue(), latency, gem5::prefetch::Base::mmu, gem5::Named::name(), gem5::prefetch::Queued::QueuedStats::pfInCache, pfq, pfqMissingTranslation, gem5::prefetch::Base::requestorId, statsQueued, and tagPrefetch.
|
protected |
Snoop the cache before generating prefetch (cheating basically)
Definition at line 171 of file queued.hh.
Referenced by insert(), and translationComplete().
|
protected |
Cycles after generation when a prefetch can first be issued.
Definition at line 162 of file queued.hh.
Referenced by insert(), and translationComplete().
|
protected |
|
protected |
Definition at line 144 of file queued.hh.
Referenced by getPacket(), insert(), nextPrefetchReadyTime(), notify(), printQueue(), translationComplete(), and ~Queued().
|
protected |
Definition at line 145 of file queued.hh.
Referenced by insert(), printQueue(), processMissingTranslations(), and translationComplete().
|
protected |
|
protected |
Maximum size of the prefetch queue.
Definition at line 153 of file queued.hh.
Referenced by addToQueue(), and getPacket().
|
protected |
|
protected |
Referenced by addToQueue(), alreadyInQueue(), insert(), notify(), and translationComplete().
|
protected |
Tag prefetch with PC of generating access?
Definition at line 174 of file queued.hh.
Referenced by insert(), and translationComplete().
|
protected |
Percentage of requests that can be throttled.
Definition at line 177 of file queued.hh.
Referenced by getMaxPermittedPrefetches().