The MemTest class tests a cache coherent memory system by generating false sharing and verifying the read data against a reference updated on the completion of writes. More...
#include <memtest.hh>
Classes | |
| class | CpuPort |
| struct | MemTestStats |
Public Types | |
| typedef MemTestParams | Params |
 Public Types inherited from gem5::ClockedObject | |
| using | Params = ClockedObjectParams |
| Parameters of ClockedObject. More... | |
| Public Types inherited from gem5::SimObject | |
| typedef SimObjectParams | Params |
Public Member Functions | |
| MemTest (const Params &p) | |
| Port & | getPort (const std::string &if_name, PortID idx=InvalidPortID) override |
| Get a port with a given name and index. More... | |
| Public Member Functions inherited from gem5::ClockedObject | |
| ClockedObject (const ClockedObjectParams &p) | |
| void | serialize (CheckpointOut &cp) const override |
| Serialize an object. More... | |
| void | unserialize (CheckpointIn &cp) override |
| Unserialize an object. More... | |
| 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. More... | |
| virtual void | loadState (CheckpointIn &cp) |
| loadState() is called on each SimObject when restoring from a checkpoint. More... | |
| virtual void | initState () |
| initState() is called on each SimObject when not restoring from a checkpoint. More... | |
| virtual void | regProbePoints () |
| Register probe points for this object. More... | |
| virtual void | regProbeListeners () |
| Register probe listeners for this object. More... | |
| ProbeManager * | getProbeManager () |
| Get the probe manager for this object. More... | |
| virtual void | startup () |
| startup() is the final initialization call before simulation. More... | |
| DrainState | drain () override |
| Provide a default implementation of the drain interface for objects that don't need draining. More... | |
| virtual void | memWriteback () |
| Write back dirty buffers to memory using functional writes. More... | |
| virtual void | memInvalidate () |
| Invalidate the contents of memory buffers. More... | |
| void | serialize (CheckpointOut &cp) const override |
| Serialize an object. More... | |
| void | unserialize (CheckpointIn &cp) override |
| Unserialize an object. More... | |
| 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. More... | |
| void | setCurTick (Tick newVal) |
| EventManager (EventManager &em) | |
| Event manger manages events in the event queue. More... | |
| 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. More... | |
| void | serializeSection (CheckpointOut &cp, const std::string &name) const |
| void | unserializeSection (CheckpointIn &cp, const char *name) |
| Unserialize an a child object. More... | |
| 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. More... | |
| virtual void | notifyFork () |
| Notify a child process of a fork. More... | |
| Public Member Functions inherited from gem5::statistics::Group | |
| Group (Group *parent, const char *name=nullptr) | |
| Construct a new statistics group. More... | |
| virtual | ~Group () |
| virtual void | regStats () |
| Callback to set stat parameters. More... | |
| virtual void | resetStats () |
| Callback to reset stats. More... | |
| virtual void | preDumpStats () |
| Callback before stats are dumped. More... | |
| void | addStat (statistics::Info *info) |
| Register a stat with this group. More... | |
| const std::map< std::string, Group * > & | getStatGroups () const |
| Get all child groups associated with this object. More... | |
| const std::vector< Info * > & | getStats () const |
| Get all stats associated with this object. More... | |
| void | addStatGroup (const char *name, Group *block) |
| Add a stat block as a child of this block. More... | |
| const Info * | resolveStat (std::string name) const |
| Resolve a stat by its name within this group. More... | |
| void | mergeStatGroup (Group *block) |
| Merge the contents (stats & children) of a block to this block. More... | |
| 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. More... | |
| 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. More... | |
| Cycles | curCycle () const |
| Determine the current cycle, corresponding to a tick aligned to a clock edge. More... | |
| 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. More... | |
| uint64_t | frequency () const |
| Tick | clockPeriod () const |
| double | voltage () const |
| Cycles | ticksToCycles (Tick t) const |
| Tick | cyclesToTicks (Cycles c) const |
Protected Member Functions | |
| void | tick () |
| void | noRequest () |
| void | noResponse () |
| Addr | blockAlign (Addr addr) const |
| Get the block aligned address. More... | |
| void | completeRequest (PacketPtr pkt, bool functional=false) |
| Complete a request by checking the response. More... | |
| bool | sendPkt (PacketPtr pkt) |
| void | recvRetry () |
| Protected Member Functions inherited from gem5::Drainable | |
| Drainable () | |
| virtual | ~Drainable () |
| virtual void | drainResume () |
| Resume execution after a successful drain. More... | |
| void | signalDrainDone () const |
| Signal that an object is drained. More... | |
| Protected Member Functions inherited from gem5::Clocked | |
| Clocked (ClockDomain &clk_domain) | |
| Create a clocked object and set the clock domain based on the parameters. More... | |
| Clocked (Clocked &)=delete | |
| Clocked & | operator= (Clocked &)=delete |
| virtual | ~Clocked () |
| Virtual destructor due to inheritance. More... | |
| void | resetClock () const |
| Reset the object's clock using the current global tick value. More... | |
| virtual void | clockPeriodUpdated () |
| A hook subclasses can implement so they can do any extra work that's needed when the clock rate is changed. More... | |
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. More... | |
| static SimObject * | find (const char *name) |
| Find the SimObject with the given name and return a pointer to it. More... | |
| static void | setSimObjectResolver (SimObjectResolver *resolver) |
| There is a single object name resolver, and it is only set when simulation is restoring from checkpoints. More... | |
| static SimObjectResolver * | getSimObjectResolver () |
| There is a single object name resolver, and it is only set when simulation is restoring from checkpoints. More... | |
| Static Public Member Functions inherited from gem5::Serializable | |
| static const std::string & | currentSection () |
| Gets the fully-qualified name of the active section. More... | |
| static void | generateCheckpointOut (const std::string &cpt_dir, std::ofstream &outstream) |
| Generate a checkpoint file so that the serialization can be routed to it. More... | |
| Public Attributes inherited from gem5::ClockedObject | |
| PowerState * | powerState |
Detailed Description
The MemTest class tests a cache coherent memory system by generating false sharing and verifying the read data against a reference updated on the completion of writes.
Each tester reads and writes a specific byte in a cache line, as determined by its unique id. Thus, all requests issued by the MemTest instance are a single byte and a specific address is only ever touched by a single tester.
In addition to verifying the data, the tester also has timeouts for both requests and responses, thus checking that the memory-system is making progress.
Definition at line 70 of file memtest.hh.
Member Typedef Documentation
◆ Params
| typedef MemTestParams gem5::MemTest::Params |
Definition at line 75 of file memtest.hh.
Constructor & Destructor Documentation
◆ MemTest()
| gem5::MemTest::MemTest | ( | const Params & | p | ) |
Definition at line 84 of file memtest.cc.
References tick().
Member Function Documentation
◆ blockAlign()
Get the block aligned address.
- Parameters
-
addr Address to align
- Returns
- The block aligned address
Definition at line 157 of file memtest.hh.
References gem5::X86ISA::addr, and blockAddrMask.
Referenced by completeRequest(), and tick().
◆ completeRequest()
|
protected |
Complete a request by checking the response.
- Parameters
-
pkt Response packet functional Whether the access was functional or not
Definition at line 134 of file memtest.cc.
References blockAlign(), gem5::ccprintf(), gem5::Clocked::clockEdge(), gem5::curTick(), gem5::EventManager::deschedule(), DPRINTF, gem5::exitSimLoop(), gem5::Packet::getConstPtr(), interval, gem5::Packet::isError(), gem5::Packet::isRead(), gem5::Packet::isWrite(), maxLoads, gem5::Named::name(), nextProgressMessage, noResponseEvent, numReads, gem5::MemTest::MemTestStats::numReads, numWrites, gem5::MemTest::MemTestStats::numWrites, outstandingAddrs, panic, progressCheck, progressInterval, referenceData, gem5::Packet::req, gem5::EventManager::reschedule(), gem5::EventManager::schedule(), gem5::Event::scheduled(), stats, suppressFuncErrors, tickEvent, and waitResponse.
Referenced by gem5::MemTest::CpuPort::recvTimingResp(), sendPkt(), and tick().
◆ getPort()
|
overridevirtual |
Get a port with a given name and index.
This is used at binding time and returns a reference to a protocol-agnostic port.
gem5 has a request and response port interface. All memory objects are connected together via ports. These ports provide a rigid interface between these memory objects. These ports implement three different memory system modes: timing, atomic, and functional. The most important mode is the timing mode and here timing mode is used for conducting cycle-level timing experiments. The other modes are only used in special circumstances and should not be used to conduct cycle-level timing experiments. The other modes are only used in special circumstances. These ports allow SimObjects to communicate with each other.
- Parameters
-
if_name Port name idx Index in the case of a VectorPort
- Returns
- A reference to the given port
Reimplemented from gem5::SimObject.
Definition at line 125 of file memtest.cc.
References gem5::SimObject::getPort(), and port.
◆ noRequest()
|
protected |
Definition at line 320 of file memtest.cc.
References gem5::Named::name(), panic, and progressCheck.
◆ noResponse()
|
protected |
Definition at line 326 of file memtest.cc.
References gem5::Named::name(), panic, and progressCheck.
◆ recvRetry()
|
protected |
Definition at line 332 of file memtest.cc.
References gem5::Clocked::clockEdge(), DPRINTF, interval, noRequestEvent, port, progressCheck, gem5::EventManager::reschedule(), retryPkt, gem5::EventManager::schedule(), gem5::RequestPort::sendTimingReq(), and tickEvent.
◆ sendPkt()
|
protected |
Definition at line 71 of file memtest.cc.
References atomic, completeRequest(), port, retryPkt, gem5::RequestPort::sendAtomic(), and gem5::RequestPort::sendTimingReq().
Referenced by tick().
◆ tick()
|
protected |
Definition at line 214 of file memtest.cc.
References gem5::X86ISA::base, baseAddr1, baseAddr2, blockAlign(), gem5::Clocked::clockEdge(), completeRequest(), data, gem5::Packet::dataDynamic(), DPRINTF, flags, id, interval, gem5::Named::name(), noRequestEvent, noResponseEvent, gem5::ArmISA::offset, outstandingAddrs, panic_if, percentFunctional, percentReads, percentUncacheable, port, progressCheck, gem5::Random::random(), gem5::random_mt, gem5::MemCmd::ReadReq, referenceData, requestorId, gem5::EventManager::reschedule(), retryPkt, gem5::EventManager::schedule(), gem5::Event::scheduled(), gem5::RequestPort::sendFunctional(), sendPkt(), gem5::Packet::setSuppressFuncError(), size, sizeBlocks, tickEvent, gem5::Request::UNCACHEABLE, uncacheAddr, waitResponse, and gem5::MemCmd::WriteReq.
Referenced by MemTest().
Member Data Documentation
◆ atomic
|
protected |
Definition at line 174 of file memtest.hh.
Referenced by sendPkt().
◆ baseAddr1
|
protected |
Definition at line 162 of file memtest.hh.
Referenced by tick().
◆ baseAddr2
|
protected |
Definition at line 163 of file memtest.hh.
Referenced by tick().
◆ blockAddrMask
|
protected |
Definition at line 147 of file memtest.hh.
Referenced by blockAlign().
◆ blockSize
|
protected |
Definition at line 145 of file memtest.hh.
◆ id
|
protected |
Definition at line 138 of file memtest.hh.
Referenced by tick().
◆ interval
|
protected |
Definition at line 129 of file memtest.hh.
Referenced by completeRequest(), recvRetry(), and tick().
◆ maxLoads
|
protected |
Definition at line 172 of file memtest.hh.
Referenced by completeRequest().
◆ nextProgressMessage
|
protected |
Definition at line 168 of file memtest.hh.
Referenced by completeRequest().
◆ noRequestEvent
|
protected |
Definition at line 90 of file memtest.hh.
Referenced by recvRetry(), and tick().
◆ noResponseEvent
|
protected |
Definition at line 94 of file memtest.hh.
Referenced by completeRequest(), and tick().
◆ numReads
|
protected |
Definition at line 170 of file memtest.hh.
Referenced by completeRequest().
◆ numWrites
|
protected |
Definition at line 171 of file memtest.hh.
Referenced by completeRequest().
◆ outstandingAddrs
|
protected |
Definition at line 140 of file memtest.hh.
Referenced by completeRequest(), and tick().
◆ percentFunctional
|
protected |
Definition at line 132 of file memtest.hh.
Referenced by tick().
◆ percentReads
|
protected |
Definition at line 131 of file memtest.hh.
Referenced by tick().
◆ percentUncacheable
|
protected |
Definition at line 133 of file memtest.hh.
Referenced by tick().
◆ port
|
protected |
Definition at line 119 of file memtest.hh.
Referenced by getPort(), recvRetry(), sendPkt(), and tick().
◆ progressCheck
|
protected |
Definition at line 167 of file memtest.hh.
Referenced by completeRequest(), noRequest(), noResponse(), recvRetry(), and tick().
◆ progressInterval
|
protected |
Definition at line 166 of file memtest.hh.
Referenced by completeRequest().
◆ referenceData
|
protected |
Definition at line 143 of file memtest.hh.
Referenced by completeRequest(), and tick().
◆ requestorId
|
protected |
Request id for all generated traffic.
Definition at line 136 of file memtest.hh.
Referenced by tick().
◆ retryPkt
|
protected |
Definition at line 121 of file memtest.hh.
Referenced by recvRetry(), sendPkt(), and tick().
◆ size
|
protected |
Definition at line 127 of file memtest.hh.
Referenced by tick().
◆ sizeBlocks
|
protected |
Definition at line 149 of file memtest.hh.
Referenced by tick().
◆ stats
|
protected |
Referenced by completeRequest().
◆ suppressFuncErrors
|
protected |
Definition at line 176 of file memtest.hh.
Referenced by completeRequest().
◆ tickEvent
|
protected |
Definition at line 86 of file memtest.hh.
Referenced by completeRequest(), recvRetry(), and tick().
◆ uncacheAddr
|
protected |
Definition at line 164 of file memtest.hh.
Referenced by tick().
◆ waitResponse
|
protected |
Definition at line 125 of file memtest.hh.
Referenced by completeRequest(), and tick().
The documentation for this class was generated from the following files:
- cpu/testers/memtest/memtest.hh
- cpu/testers/memtest/memtest.cc