gem5  v22.1.0.0
Public Member Functions | Private Types | Private Member Functions | Private Attributes | List of all members
gem5::BasePixelPump::PixelEvent Class Reference

Callback helper class with suspend support. More...

Inheritance diagram for gem5::BasePixelPump::PixelEvent:
gem5::Event gem5::Drainable gem5::EventBase gem5::Serializable

Public Member Functions

 PixelEvent (const char *name, BasePixelPump *parent, CallbackType func)
 
DrainState drain () override
 Draining is the process of clearing out the states of SimObjects.These are the SimObjects that are partially executed or are partially in flight. More...
 
void drainResume () override
 Resume execution after a successful drain. More...
 
void serialize (CheckpointOut &cp) const override
 Serialize an object. More...
 
void unserialize (CheckpointIn &cp) override
 Unserialize an object. More...
 
const std::string name () const override
 
void process () override
 
bool active () const
 
- Public Member Functions inherited from gem5::Event
 Event (Priority p=Default_Pri, Flags f=0)
 
bool scheduled () const
 Determine if the current event is scheduled. More...
 
void squash ()
 Squash the current event. More...
 
bool squashed () const
 Check whether the event is squashed. More...
 
bool isExitEvent () const
 See if this is a SimExitEvent (without resorting to RTTI) More...
 
bool isManaged () const
 Check whether this event will auto-delete. More...
 
bool isAutoDelete () const
 The function returns true if the object is automatically deleted after the event is processed. More...
 
Tick when () const
 Get the time that the event is scheduled. More...
 
Priority priority () const
 Get the event priority. More...
 
virtual BaseGlobalEventglobalEvent ()
 If this is part of a GlobalEvent, return the pointer to the Global Event. More...
 
void serialize (CheckpointOut &cp) const override
 Serialize an object. More...
 
void unserialize (CheckpointIn &cp) override
 Unserialize an object. More...
 
virtual ~Event ()
 
virtual const char * description () const
 Return a C string describing the event. More...
 
void dump () const
 Dump the current event data. More...
 
- 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...
 

Private Types

typedef void(BasePixelPump::* CallbackType) ()
 

Private Member Functions

void suspend ()
 
void resume ()
 

Private Attributes

const std::string _name
 
BasePixelPumpparent
 
const CallbackType func
 
bool suspended
 
Tick relativeTick
 

Additional Inherited Members

- Public Types inherited from gem5::EventBase
typedef int8_t Priority
 
- 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...
 
- Static Public Attributes inherited from gem5::EventBase
static const Priority Minimum_Pri = SCHAR_MIN
 Event priorities, to provide tie-breakers for events scheduled at the same cycle. More...
 
static const Priority Debug_Enable_Pri = -101
 If we enable tracing on a particular cycle, do that as the very first thing so we don't miss any of the events on that cycle (even if we enter the debugger). More...
 
static const Priority Debug_Break_Pri = -100
 Breakpoints should happen before anything else (except enabling trace output), so we don't miss any action when debugging. More...
 
static const Priority CPU_Switch_Pri = -31
 CPU switches schedule the new CPU's tick event for the same cycle (after unscheduling the old CPU's tick event). More...
 
static const Priority Delayed_Writeback_Pri = -1
 For some reason "delayed" inter-cluster writebacks are scheduled before regular writebacks (which have default priority). More...
 
static const Priority Default_Pri = 0
 Default is zero for historical reasons. More...
 
static const Priority DVFS_Update_Pri = 31
 DVFS update event leads to stats dump therefore given a lower priority to ensure all relevant states have been updated. More...
 
static const Priority Serialize_Pri = 32
 Serailization needs to occur before tick events also, so that a serialize/unserialize is identical to an on-line CPU switch. More...
 
static const Priority CPU_Tick_Pri = 50
 CPU ticks must come after other associated CPU events (such as writebacks). More...
 
static const Priority CPU_Exit_Pri = 64
 If we want to exit a thread in a CPU, it comes after CPU_Tick_Pri. More...
 
static const Priority Stat_Event_Pri = 90
 Statistics events (dump, reset, etc.) come after everything else, but before exit. More...
 
static const Priority Progress_Event_Pri = 95
 Progress events come at the end. More...
 
static const Priority Sim_Exit_Pri = 100
 If we want to exit on this cycle, it's the very last thing we do. More...
 
static const Priority Maximum_Pri = SCHAR_MAX
 Maximum priority. More...
 
- Protected Types inherited from gem5::EventBase
typedef unsigned short FlagsType
 
typedef ::gem5::Flags< FlagsTypeFlags
 
- Protected Member Functions inherited from gem5::Event
Flags getFlags () const
 
bool isFlagSet (Flags _flags) const
 
void setFlags (Flags _flags)
 
void clearFlags (Flags _flags)
 
void clearFlags ()
 
virtual void trace (const char *action)
 This function isn't really useful if TRACING_ON is not defined. More...
 
const std::string instanceString () const
 Return the instance number as a string. More...
 
void acquire ()
 Memory management hooks for events that have the Managed flag set. More...
 
void release ()
 Managed event removed from the event queue. More...
 
virtual void acquireImpl ()
 
virtual void releaseImpl ()
 
- Protected Member Functions inherited from gem5::Drainable
 Drainable ()
 
virtual ~Drainable ()
 
void signalDrainDone () const
 Signal that an object is drained. More...
 
- Static Protected Attributes inherited from gem5::EventBase
static const FlagsType PublicRead = 0x003f
 
static const FlagsType PublicWrite = 0x001d
 
static const FlagsType Squashed = 0x0001
 
static const FlagsType Scheduled = 0x0002
 
static const FlagsType Managed = 0x0004
 
static const FlagsType AutoDelete = Managed
 
static const FlagsType Reserved0 = 0x0008
 This used to be AutoSerialize. More...
 
static const FlagsType IsExitEvent = 0x0010
 
static const FlagsType IsMainQueue = 0x0020
 
static const FlagsType Initialized = 0x7a40
 
static const FlagsType InitMask = 0xffc0
 

Detailed Description

Callback helper class with suspend support.

Unlike a normal EventWrapper, this class suspends an event on drain() and restarts it at drainResume(). The suspend operation stores the tick relative to curTick() and then deschedules the event. The resume operation schedules the event at curTick() plus the relative tick stored when the event was suspended.

Definition at line 303 of file pixelpump.hh.

Member Typedef Documentation

◆ CallbackType

typedef void(BasePixelPump::* gem5::BasePixelPump::PixelEvent::CallbackType) ()
private

Definition at line 305 of file pixelpump.hh.

Constructor & Destructor Documentation

◆ PixelEvent()

gem5::BasePixelPump::PixelEvent::PixelEvent ( const char *  name,
BasePixelPump parent,
CallbackType  func 
)

Definition at line 298 of file pixelpump.cc.

References parent, and gem5::BasePixelPump::pixelEvents.

Member Function Documentation

◆ active()

bool gem5::BasePixelPump::PixelEvent::active ( ) const
inline

Definition at line 324 of file pixelpump.hh.

References gem5::Event::scheduled(), and suspended.

Referenced by gem5::BasePixelPump::active().

◆ drain()

DrainState gem5::BasePixelPump::PixelEvent::drain ( )
overridevirtual

Draining is the process of clearing out the states of SimObjects.These are the SimObjects that are partially executed or are partially in flight.

Draining is mostly used before forking and creating a check point.

This function notifies an object that it needs to drain its state.

If the object does not need further simulation to drain internal buffers, it returns DrainState::Drained and automatically switches to the Drained state. If the object needs more simulation, it returns DrainState::Draining and automatically enters the Draining state. Other return values are invalid.

Note
An object that has entered the Drained state can be disturbed by other objects in the system and consequently stop being drained. These perturbations are not visible in the drain state. The simulator therefore repeats the draining process until all objects return DrainState::Drained on the first call to drain().
Returns
DrainState::Drained if the object is drained at this point in time, DrainState::Draining if it needs further simulation.

Implements gem5::Drainable.

Definition at line 309 of file pixelpump.cc.

References gem5::Drained.

◆ drainResume()

void gem5::BasePixelPump::PixelEvent::drainResume ( )
overridevirtual

Resume execution after a successful drain.

Reimplemented from gem5::Drainable.

Definition at line 317 of file pixelpump.cc.

◆ name()

const std::string gem5::BasePixelPump::PixelEvent::name ( ) const
inlineoverridevirtual

Reimplemented from gem5::Event.

Definition at line 316 of file pixelpump.hh.

References _name.

◆ process()

void gem5::BasePixelPump::PixelEvent::process ( )
inlineoverridevirtual

Implements gem5::Event.

Definition at line 319 of file pixelpump.hh.

References func, and parent.

◆ resume()

void gem5::BasePixelPump::PixelEvent::resume ( )
private

Definition at line 353 of file pixelpump.cc.

References gem5::curTick().

◆ serialize()

void gem5::BasePixelPump::PixelEvent::serialize ( CheckpointOut cp) const
overridevirtual

Serialize an object.

Output an object's state into the current checkpoint section.

Parameters
cpCheckpoint state

Implements gem5::Serializable.

Definition at line 324 of file pixelpump.cc.

References gem5::Event::serialize(), and SERIALIZE_SCALAR.

◆ suspend()

void gem5::BasePixelPump::PixelEvent::suspend ( )
private

Definition at line 342 of file pixelpump.cc.

References gem5::curTick().

◆ unserialize()

void gem5::BasePixelPump::PixelEvent::unserialize ( CheckpointIn cp)
overridevirtual

Unserialize an object.

Read an object's state from the current checkpoint section.

Parameters
cpCheckpoint state

Implements gem5::Serializable.

Definition at line 333 of file pixelpump.cc.

References gem5::Event::unserialize(), and UNSERIALIZE_SCALAR.

Member Data Documentation

◆ _name

const std::string gem5::BasePixelPump::PixelEvent::_name
private

Definition at line 330 of file pixelpump.hh.

Referenced by name().

◆ func

const CallbackType gem5::BasePixelPump::PixelEvent::func
private

Definition at line 332 of file pixelpump.hh.

Referenced by process().

◆ parent

BasePixelPump& gem5::BasePixelPump::PixelEvent::parent
private

Definition at line 331 of file pixelpump.hh.

Referenced by PixelEvent(), and process().

◆ relativeTick

Tick gem5::BasePixelPump::PixelEvent::relativeTick
private

Definition at line 335 of file pixelpump.hh.

◆ suspended

bool gem5::BasePixelPump::PixelEvent::suspended
private

Definition at line 334 of file pixelpump.hh.

Referenced by active().


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

Generated on Wed Dec 21 2022 10:23:21 for gem5 by doxygen 1.9.1