Callback helper class with suspend support. More...

Inheritance diagram for BasePixelPump::PixelEvent:

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 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 BaseGlobalEvent *	globalEvent ()
	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 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 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

BasePixelPump &	parent

const CallbackType	func

bool	suspended

Tick	relativeTick

Additional Inherited Members
Public Types inherited from EventBase
typedef int8_t	Priority

Static Public Member Functions inherited from Serializable
static const std::string &	currentSection ()
	Gets the fully-qualified name of the active section. More...

static void	serializeAll (const std::string &cpt_dir)
	Serializes all the SimObjects. More...

static void	unserializeGlobals (CheckpointIn &cp)

Static Public Attributes inherited from 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 EventBase
typedef unsigned short	FlagsType

typedef ::Flags< FlagsType >	Flags

Protected Member Functions inherited from 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 Drainable
	Drainable ()

virtual	~Drainable ()

void	signalDrainDone () const
	Signal that an object is drained. More...

Static Protected Attributes inherited from 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 258 of file pixelpump.hh.

Member Typedef Documentation

◆ CallbackType

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

private

Definition at line 260 of file pixelpump.hh.

Constructor & Destructor Documentation

◆ PixelEvent()

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

Definition at line 297 of file pixelpump.cc.

References parent, and BasePixelPump::pixelEvents.

Member Function Documentation

◆ active()

bool BasePixelPump::PixelEvent::active ( ) const

inline

Definition at line 276 of file pixelpump.hh.

References Event::scheduled(), and suspended.

Referenced by BasePixelPump::active().

◆ drain()

DrainState 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 Drainable.

Definition at line 308 of file pixelpump.cc.

References Drained.

◆ drainResume()

void BasePixelPump::PixelEvent::drainResume ( )

overridevirtual

Resume execution after a successful drain.

Reimplemented from Drainable.

Definition at line 316 of file pixelpump.cc.

◆ name()

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

inlineoverridevirtual

Reimplemented from Event.

Definition at line 271 of file pixelpump.hh.

References _name.

◆ process()

void BasePixelPump::PixelEvent::process ( )

inlineoverridevirtual

Implements Event.

Definition at line 272 of file pixelpump.hh.

References func, and parent.

◆ resume()

void BasePixelPump::PixelEvent::resume ( )

private

Definition at line 352 of file pixelpump.cc.

References curTick().

◆ serialize()

void BasePixelPump::PixelEvent::serialize ( CheckpointOut & cp ) const

overridevirtual

Serialize an object.

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

Parameters

cp	Checkpoint state

Implements Serializable.

Definition at line 323 of file pixelpump.cc.

References Event::serialize(), and SERIALIZE_SCALAR.

◆ suspend()

void BasePixelPump::PixelEvent::suspend ( )

private

Definition at line 341 of file pixelpump.cc.

References curTick().

◆ unserialize()

void BasePixelPump::PixelEvent::unserialize ( CheckpointIn & cp )

overridevirtual

Unserialize an object.

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

Parameters

cp	Checkpoint state

Implements Serializable.

Definition at line 332 of file pixelpump.cc.

References Event::unserialize(), and UNSERIALIZE_SCALAR.

Member Data Documentation

◆ _name

const std::string BasePixelPump::PixelEvent::_name

private

Definition at line 282 of file pixelpump.hh.

Referenced by name().

◆ func

const CallbackType BasePixelPump::PixelEvent::func

private

Definition at line 284 of file pixelpump.hh.

Referenced by process().

◆ parent

BasePixelPump& BasePixelPump::PixelEvent::parent

private

Definition at line 283 of file pixelpump.hh.

Referenced by PixelEvent(), and process().

◆ relativeTick

Tick BasePixelPump::PixelEvent::relativeTick

private

Definition at line 287 of file pixelpump.hh.

◆ suspended

bool BasePixelPump::PixelEvent::suspended

private

Definition at line 286 of file pixelpump.hh.

Referenced by active().

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

dev/pixelpump.hh
dev/pixelpump.cc

Public Member Functions

Private Types

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Member Typedef Documentation

◆ CallbackType

Constructor & Destructor Documentation

◆ PixelEvent()

Member Function Documentation

◆ active()

◆ drain()

◆ drainResume()

◆ name()

◆ process()

◆ resume()

◆ serialize()

◆ suspend()

◆ unserialize()

Member Data Documentation

◆ _name

◆ func

◆ parent

◆ relativeTick

◆ suspended