gem5  v22.1.0.0
Classes | Public Member Functions | Protected Attributes | Static Private Attributes | List of all members
gem5::BaseGlobalEvent Class Referenceabstract

Common base class for GlobalEvent and GlobalSyncEvent. More...

#include <global_event.hh>

Inheritance diagram for gem5::BaseGlobalEvent:
gem5::EventBase gem5::BaseGlobalEventTemplate< GlobalEvent > gem5::BaseGlobalEventTemplate< GlobalSyncEvent > gem5::BaseGlobalEventTemplate< Derived > gem5::GlobalEvent gem5::GlobalSyncEvent gem5::DebugBreakEvent gem5::GlobalSimLoopExitEvent gem5::statistics::StatEvent gem5::DistIface::SyncEvent

Classes

class  BarrierEvent
 The base class for the local events that will synchronize threads to perform the global event. More...
 

Public Member Functions

 BaseGlobalEvent (Priority p, Flags f)
 
virtual ~BaseGlobalEvent ()
 
virtual void process ()=0
 
virtual const char * description () const =0
 
void schedule (Tick when)
 
bool scheduled () const
 
Tick when () const
 
void deschedule ()
 
void reschedule (Tick when)
 

Protected Attributes

Barrier barrier
 The barrier that all threads wait on before performing the global event. More...
 
std::vector< BarrierEvent * > barrierEvent
 The individual local event instances (one per thread/event queue). More...
 

Static Private Attributes

static std::mutex globalQMutex
 Mutex variable for providing exculsive right to schedule global events. More...
 

Additional Inherited Members

- Public Types inherited from gem5::EventBase
typedef int8_t Priority
 
- 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
 
- 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

Common base class for GlobalEvent and GlobalSyncEvent.

Definition at line 63 of file global_event.hh.

Constructor & Destructor Documentation

◆ BaseGlobalEvent()

gem5::BaseGlobalEvent::BaseGlobalEvent ( Priority  p,
Flags  f 
)

Definition at line 39 of file global_event.cc.

◆ ~BaseGlobalEvent()

gem5::BaseGlobalEvent::~BaseGlobalEvent ( )
virtual

Definition at line 46 of file global_event.cc.

References barrierEvent, gem5::ArmISA::i, and gem5::numMainEventQueues.

Member Function Documentation

◆ deschedule()

void gem5::BaseGlobalEvent::deschedule ( )

◆ description()

virtual const char* gem5::BaseGlobalEvent::description ( ) const
pure virtual

◆ process()

virtual void gem5::BaseGlobalEvent::process ( )
pure virtual

◆ reschedule()

void gem5::BaseGlobalEvent::reschedule ( Tick  when)

◆ schedule()

void gem5::BaseGlobalEvent::schedule ( Tick  when)

◆ scheduled()

bool gem5::BaseGlobalEvent::scheduled ( ) const
inline

◆ when()

Tick gem5::BaseGlobalEvent::when ( ) const
inline

Member Data Documentation

◆ barrier

Barrier gem5::BaseGlobalEvent::barrier
protected

The barrier that all threads wait on before performing the global event.

Definition at line 113 of file global_event.hh.

Referenced by gem5::BaseGlobalEvent::BarrierEvent::globalBarrier().

◆ barrierEvent

std::vector<BarrierEvent *> gem5::BaseGlobalEvent::barrierEvent
protected

◆ globalQMutex

std::mutex gem5::BaseGlobalEvent::globalQMutex
staticprivate

Mutex variable for providing exculsive right to schedule global events.

This is necessary so that a total order can be maintained amongst the global events. Without ensuring the total order, it is possible that threads execute global events in different orders, which can result in a deadlock.

Definition at line 71 of file global_event.hh.

Referenced by reschedule(), and schedule().


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

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