These methods relate to the event queue interface. More...

Typedefs
typedef int8_t	EventBase::Priority

Functions
virtual void	Event::trace (const char *action)
	This function isn't really useful if TRACING_ON is not defined. More...

bool	Event::scheduled () const
	Determine if the current event is scheduled. More...

void	Event::squash ()
	Squash the current event. More...

bool	Event::squashed () const
	Check whether the event is squashed. More...

bool	Event::isExitEvent () const
	See if this is a SimExitEvent (without resorting to RTTI) More...

bool	Event::isManaged () const
	Check whether this event will auto-delete. More...

bool	Event::isAutoDelete () const

Tick	Event::when () const
	Get the time that the event is scheduled. More...

Priority	Event::priority () const
	Get the event priority. More...

bool	operator< (const Event &l, const Event &r)

bool	operator> (const Event &l, const Event &r)

bool	operator<= (const Event &l, const Event &r)

bool	operator>= (const Event &l, const Event &r)

bool	operator== (const Event &l, const Event &r)

bool	operator!= (const Event &l, const Event &r)

	EventQueue::ScopedMigration::ScopedMigration (EventQueue *_new_eq, bool _doMigrate=true)

	EventQueue::EventQueue (const std::string &n)

void	EventQueue::schedule (Event *event, Tick when, bool global=false)
	Schedule the given event on this queue. More...

void	EventQueue::deschedule (Event *event)
	Deschedule the specified event. More...

void	EventQueue::reschedule (Event *event, Tick when, bool always=false)
	Reschedule the specified event. More...

Tick	EventQueue::getCurTick () const
	While curTick() is useful for any object assigned to this event queue, if an object that is assigned to another event queue (or a non-event object) need to access the current tick of this event queue, this function is used. More...

void	EventQueue::serviceEvents (Tick when)
	process all events up to the given timestamp. More...

bool	EventQueue::empty () const
	Returns true if no events are queued. More...

void	EventQueue::dump () const
	This is a debugging function which will print everything on the event queue. More...

virtual void	EventQueue::wakeup (Tick when=(Tick) -1)
	Function to signal that the event loop should be woken up because an event has been scheduled by an agent outside the gem5 event loop(s) whose event insertion may not have been noticed by gem5. More...

EventQueue *	EventManager::eventQueue () const

void	EventManager::schedule (Event &event, Tick when)

void	EventManager::deschedule (Event &event)

void	EventManager::reschedule (Event &event, Tick when, bool always=false)

void	EventManager::schedule (Event *event, Tick when)

void	EventManager::deschedule (Event *event)

void	EventManager::reschedule (Event *event, Tick when, bool always=false)

void	EventManager::wakeupEventQueue (Tick when=(Tick) -1)

	EventFunctionWrapper::EventFunctionWrapper (const std::function< void(void)> &callback, const std::string &name, bool del=false, Priority p=Default_Pri)

void	EventFunctionWrapper::process ()

const std::string	EventFunctionWrapper::name () const

const char *	EventFunctionWrapper::description () const
	Return a C string describing the event. More...

Variables
static const Priority	EventBase::Minimum_Pri = SCHAR_MIN
	Event priorities, to provide tie-breakers for events scheduled at the same cycle. More...

static const Priority	EventBase::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	EventBase::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	EventBase::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	EventBase::Delayed_Writeback_Pri = -1
	For some reason "delayed" inter-cluster writebacks are scheduled before regular writebacks (which have default priority). More...

static const Priority	EventBase::Default_Pri = 0
	Default is zero for historical reasons. More...

static const Priority	EventBase::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	EventBase::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	EventBase::CPU_Tick_Pri = 50
	CPU ticks must come after other associated CPU events (such as writebacks). More...

static const Priority	EventBase::CPU_Exit_Pri = 64
	If we want to exit a thread in a CPU, it comes after CPU_Tick_Pri. More...

static const Priority	EventBase::Stat_Event_Pri = 90
	Statistics events (dump, reset, etc.) come after everything else, but before exit. More...

static const Priority	EventBase::Progress_Event_Pri = 95
	Progress events come at the end. More...

static const Priority	EventBase::Sim_Exit_Pri = 100
	If we want to exit on this cycle, it's the very last thing we do. More...

static const Priority	EventBase::Maximum_Pri = SCHAR_MAX
	Maximum priority. More...

virtual	Event::~Event ()

virtual const std::string	Event::name () const

virtual const char *	Event::description () const
	Return a C string describing the event. More...

void	Event::dump () const
	Dump the current event data. More...

virtual const std::string	EventQueue::name () const

void	EventQueue::name (const std::string &st)

	EventManager::EventManager (EventManager &em)

	EventManager::EventManager (EventManager *em)

	EventManager::EventManager (EventQueue *eq)

Detailed Description

These methods relate to the event queue interface.

Typedef Documentation

◆ Priority

typedef int8_t EventBase::Priority

Definition at line 117 of file eventq.hh.

Function Documentation

◆ deschedule() [1/3]

void EventQueue::deschedule ( Event * event )

inline

Deschedule the specified event.

Should be called only from the owning thread.

Definition at line 65 of file eventq_impl.hh.

References curEventQueue(), DTRACE, MipsISA::event, Event::initialized(), inParallelMode, EventBase::Scheduled, Event::scheduled(), and EventBase::Squashed.

Referenced by sc_gem5::Scheduler::deschedule(), EventManager::deschedule(), Iris::ThreadContext::descheduleInstCountEvent(), SimpleThread::descheduleInstCountEvent(), RubySystem::memWriteback(), and pybind_init_event().

◆ deschedule() [2/3]

void EventManager::deschedule ( Event & event )

inline

Definition at line 943 of file eventq.hh.

References EventQueue::deschedule().

Referenced by BaseCPU::activateContext(), IGbE::chkInterrupt(), HDLcd::cmdDisable(), MemTest::completeRequest(), IGbE::cpuPostInt(), BaseCPU::deschedulePowerGatingEvent(), BaseKvmCPU::drain(), AtomicSimpleCPU::drain(), ArchTimer::drain(), BaseTrafficGen::drain(), FullO3CPU< O3CPUImpl >::drain(), IGbE::drain(), GenericTimer::handleStream(), VIPERCoalescer::makeRequest(), DVFSHandler::perfLevel(), IGbE::postInterrupt(), Sp804::Timer::restartCounter(), A9GlobalTimer::Timer::restartCounter(), CpuLocalTimer::Timer::restartTimerCounter(), CpuLocalTimer::Timer::restartWatchdogCounter(), PL031::resyncMatch(), SparcISA::ISA::setFSReg(), Iris::ThreadContext::setStatus(), BasePixelPump::stop(), Sp805::stopCounter(), BasePixelPump::PixelEvent::suspend(), DRAMCtrl::Rank::suspend(), BaseKvmCPU::suspendContext(), AtomicSimpleCPU::suspendContext(), TimingSimpleCPU::suspendContext(), BaseCPU::switchOut(), Root::timeSyncEnable(), FullO3CPU< O3CPUImpl >::tryDrain(), GpuDispatcher::unserialize(), ArchTimer::updateCounter(), Uart8250::write(), EnergyCtrl::write(), Intel8254Timer::Counter::write(), MC146818::writeData(), AtomicSimpleCPU::~AtomicSimpleCPU(), MC146818::~MC146818(), and Iris::ThreadContext::~ThreadContext().

◆ deschedule() [3/3]

void EventManager::deschedule ( Event * event )

inline

Definition at line 970 of file eventq.hh.

References EventQueue::deschedule().

◆ description() [1/2]

const char * Event::description ( ) const

virtual

Return a C string describing the event.

This string should not be dynamically allocated; just a const char array describing the event class.

Reimplemented in EventFunctionWrapper, EventWrapper< T, F >, EventWrapper< A9GlobalTimer::Timer, &Timer::counterAtCmpVal >, EventWrapper< SMMUv3SlaveInterface, &SMMUv3SlaveInterface::atsSendDeviceRetry >, EventWrapper< sc_gem5::Scheduler, &Scheduler::timeAdvances >, EventWrapper< sc_gem5::Kernel, &Kernel::t0Handler >, EventWrapper< sc_gem5::Scheduler, &Scheduler::stop >, EventWrapper< PowerDomain, &PowerDomain::setFollowerPowerStates >, EventWrapper< BaseRemoteGDB, &BaseRemoteGDB::singleStep >, EventWrapper< sc_gem5::Scheduler, &Scheduler::maxTickFunc >, EventWrapper< sc_gem5::Scheduler, &Scheduler::pause >, EventWrapper< sc_gem5::Scheduler, &Scheduler::runReady >, EventWrapper< SMMUv3, &SMMUv3::processCommands >, EventWrapper< QoS::MemSinkCtrl, &MemSinkCtrl::processNextReqEvent >, LSQUnit< Impl >::WritebackEvent, X86ISA::GpuTLB::TLBEvent, HSAPacketProcessor::CmdQueueCmdDmaEvent, TimingSimpleCPU::IprEvent, HSAPacketProcessor::UpdateReadDispIdDmaEvent, HSAPacketProcessor::DepSignalsReadDmaEvent, HSAPacketProcessor::QueueProcessEvent, TimingSimpleCPU::IcachePort::ITickEvent, TimingSimpleCPU::TimingCPUPort::TickEvent, DefaultFetch< Impl >::FinishTranslationEvent, InstructionQueue< Impl >::FUCompletion, CountedExitEvent, Trace::TarmacParserRecord::TarmacParserRecordEvent, CPUProgressEvent, Intel8254Timer::Counter::CounterEvent, LocalSimLoopExitEvent, MC146818::RTCTickEvent, HWScheduler::SchedulerWakeupEvent, MC146818::RTCEvent, SMMUDeviceRetryEvent, and EndQuiesceEvent.

Definition at line 371 of file eventq.cc.

Referenced by GlobalSyncEvent::GlobalSyncEvent().

◆ description() [2/2]

const char* EventFunctionWrapper::description ( ) const

inlinevirtual

Return a C string describing the event.

This string should not be dynamically allocated; just a const char array describing the event class.

Reimplemented from Event.

Definition at line 1064 of file eventq.hh.

◆ dump() [1/2]

void Event::dump ( ) const

Dump the current event data.

Definition at line 403 of file eventq.cc.

References cprintf(), EventQueue::EventQueue(), ArmISA::n, and name().

Referenced by EventQueue::debugVerify(), EventQueue::dump(), and pybind_init_event().

◆ dump() [2/2]

void EventQueue::dump ( ) const

This is a debugging function which will print everything on the event queue.

Definition at line 287 of file eventq.cc.

References cprintf(), curTick(), Event::dump(), Event::nextBin, and Event::nextInBin.

Referenced by pybind_init_event().

◆ empty()

bool EventQueue::empty ( ) const

inline

Returns true if no events are queued.

Definition at line 823 of file eventq.hh.

References Stats::dump().

Referenced by doSimLoop(), RubySystem::eventQueueEmpty(), Iris::ThreadContext::maintainStepping(), RubySystem::memWriteback(), and BaseKvmCPU::setupInstStop().

◆ EventFunctionWrapper()

EventFunctionWrapper::EventFunctionWrapper	(	const std::function< void(void)> &	callback,
		const std::string &	name,
		bool	del = `false`,
		Priority	p = `Default_Pri`
	)

inline

Definition at line 1037 of file eventq.hh.

References EventBase::AutoDelete.

◆ EventManager() [1/3]

EventManager::EventManager ( EventManager & em )

inline

Definition at line 916 of file eventq.hh.

◆ EventManager() [2/3]

EventManager::EventManager ( EventManager * em )

inline

Definition at line 917 of file eventq.hh.

◆ EventManager() [3/3]

EventManager::EventManager ( EventQueue * eq )

inline

Definition at line 918 of file eventq.hh.

◆ EventQueue()

EventQueue::EventQueue ( const std::string & n )

◆ eventQueue()

EventQueue* EventManager::eventQueue ( ) const

inline

Definition at line 925 of file eventq.hh.

Referenced by VncServer::accept(), X86KvmCPU::deliverInterrupts(), BaseKvmCPU::deviceEventQueue(), BaseKvmCPU::drain(), sc_gem5::Kernel::Kernel(), TapEvent::process(), Terminal::DataEvent::process(), and BaseKvmCPU::wakeup().

◆ getCurTick()

Tick EventQueue::getCurTick ( ) const

inline

While curTick() is useful for any object assigned to this event queue, if an object that is assigned to another event queue (or a non-event object) need to access the current tick of this event queue, this function is used.

Returns: Tick The current tick of this event queue.

Definition at line 782 of file eventq.hh.

Referenced by abortHandler(), curTick(), SimpleThread::getCurrentInstCount(), sc_gem5::Scheduler::getCurTick(), EventQueue::reschedule(), and EventQueue::schedule().

◆ isAutoDelete()

bool Event::isAutoDelete ( ) const

inline

Definition at line 492 of file eventq.hh.

Referenced by RubySystem::memWriteback().

◆ isExitEvent()

bool Event::isExitEvent ( ) const

inline

See if this is a SimExitEvent (without resorting to RTTI)

Definition at line 480 of file eventq.hh.

References EventBase::IsExitEvent, and Flags< T >::isSet().

Referenced by pybind_init_event().

◆ isManaged()

bool Event::isManaged ( ) const

inline

Check whether this event will auto-delete.

Definition at line 487 of file eventq.hh.

References Flags< T >::isSet(), and EventBase::Managed.

◆ name() [1/4]

const std::string Event::name ( ) const

virtual

Reimplemented in EventFunctionWrapper, EventWrapper< T, F >, EventWrapper< A9GlobalTimer::Timer, &Timer::counterAtCmpVal >, EventWrapper< SMMUv3SlaveInterface, &SMMUv3SlaveInterface::atsSendDeviceRetry >, EventWrapper< sc_gem5::Scheduler, &Scheduler::timeAdvances >, EventWrapper< sc_gem5::Kernel, &Kernel::t0Handler >, EventWrapper< sc_gem5::Scheduler, &Scheduler::stop >, EventWrapper< PowerDomain, &PowerDomain::setFollowerPowerStates >, EventWrapper< BaseRemoteGDB, &BaseRemoteGDB::singleStep >, EventWrapper< sc_gem5::Scheduler, &Scheduler::maxTickFunc >, EventWrapper< sc_gem5::Scheduler, &Scheduler::pause >, EventWrapper< sc_gem5::Scheduler, &Scheduler::runReady >, EventWrapper< SMMUv3, &SMMUv3::processCommands >, EventWrapper< QoS::MemSinkCtrl, &MemSinkCtrl::processNextReqEvent >, BasePixelPump::PixelEvent, and SMMUDeviceRetryEvent.

Definition at line 82 of file eventq.cc.

References csprintf().

Referenced by X86ISA::GpuTLB::exitCallback(), RubySystem::memWriteback(), pybind_init_event(), Uart8250::scheduleIntr(), InstructionQueue< Impl >::FUCompletion::setFreeFU(), and Intel8254Timer::~Intel8254Timer().

◆ name() [2/4]

virtual const std::string EventQueue::name ( ) const

inlinevirtual

Definition at line 744 of file eventq.hh.

Referenced by pybind_init_event().

◆ name() [3/4]

void EventQueue::name ( const std::string & st )

inline

Definition at line 745 of file eventq.hh.

References MipsISA::event, and ArmISA::st.

◆ name() [4/4]

const std::string EventFunctionWrapper::name ( ) const

inlinevirtual

Reimplemented from Event.

Definition at line 1056 of file eventq.hh.

◆ operator!=()

bool operator!=	(	const Event &	l,
		const Event &	r
	)

inline

Definition at line 570 of file eventq.hh.

References Event::priority(), and Event::when().

◆ operator<()

bool operator<	(	const Event &	l,
		const Event &	r
	)

inline

Definition at line 521 of file eventq.hh.

References Event::priority(), and Event::when().

◆ operator<=()

bool operator<=	(	const Event &	l,
		const Event &	r
	)

inline

Definition at line 541 of file eventq.hh.

References Event::priority(), and Event::when().

◆ operator==()

bool operator==	(	const Event &	l,
		const Event &	r
	)

inline

Definition at line 561 of file eventq.hh.

References Event::priority(), and Event::when().

◆ operator>()

bool operator>	(	const Event &	l,
		const Event &	r
	)

inline

Definition at line 531 of file eventq.hh.

References Event::priority(), and Event::when().

◆ operator>=()

bool operator>=	(	const Event &	l,
		const Event &	r
	)

inline

Definition at line 551 of file eventq.hh.

References Event::priority(), and Event::when().

◆ priority()

Priority Event::priority ( ) const

inline

Get the event priority.

Definition at line 506 of file eventq.hh.

Referenced by EventQueue::debugVerify(), operator!=(), operator<(), operator<=(), operator==(), operator>(), operator>=(), and pybind_init_event().

◆ process()

void EventFunctionWrapper::process ( )

inlinevirtual

Implements Event.

Definition at line 1050 of file eventq.hh.

Referenced by StubSlavePort::recvRespRetry(), and Uart8250::write().

◆ reschedule() [1/3]

void EventQueue::reschedule	(	Event *	event,
		Tick	when,
		bool	always = `false`
	)

inline

Reschedule the specified event.

Should be called only from the owning thread.

Definition at line 83 of file eventq_impl.hh.

References curEventQueue(), DTRACE, MipsISA::event, EventQueue::getCurTick(), Event::initialized(), inParallelMode, EventQueue::insert(), EventBase::Scheduled, Event::scheduled(), and EventBase::Squashed.

Referenced by pybind_init_event(), and EventManager::reschedule().

◆ reschedule() [2/3]

void EventManager::reschedule	(	Event &	event,
		Tick	when,
		bool	always = `false`
	)

inline

Definition at line 952 of file eventq.hh.

References EventQueue::reschedule().

Referenced by FlashDevice::accessDevice(), FlashDevice::actionComplete(), DRAMCtrl::activateBank(), TimingSimpleCPU::advanceInst(), MemTest::completeRequest(), SimpleMemory::dequeue(), EtherSwitch::Interface::enqueue(), SystemCounter::freqUpdateSchedule(), GenericTimer::handleStream(), IGbE::RxDescCache::pktComplete(), IGbE::TxDescCache::pktComplete(), DRAMCtrl::prechargeBank(), DRAMCtrl::processNextReqEvent(), ThreadContext::quiesceTick(), MemTest::recvRetry(), Sp805::restartCounter(), TraceCPU::schedDcacheNextEvent(), GenericTimer::CoreTimers::schedNextEvent(), PacketQueue::schedSendEvent(), FullO3CPU< O3CPUImpl >::scheduleTickEvent(), IdeDisk::serialize(), AtomicSimpleCPU::tick(), MemTest::tick(), Sinic::Device::transferDone(), NSGigE::transferDone(), Sp805::unserialize(), SystemCounter::unserialize(), X86ISA::Interrupts::unserialize(), GenericTimer::CoreTimers::unserialize(), IdeDisk::unserialize(), and BaseTrafficGen::update().

◆ reschedule() [3/3]

void EventManager::reschedule	(	Event *	event,
		Tick	when,
		bool	always = `false`
	)

inline

Definition at line 979 of file eventq.hh.

References EventQueue::reschedule().

◆ schedule() [1/3]

void EventQueue::schedule	(	Event *	event,
		Tick	when,
		bool	global = `false`
	)

inline

Schedule the given event on this queue.

Safe to call from any thread.

Definition at line 38 of file eventq_impl.hh.

References EventQueue::asyncInsert(), curEventQueue(), DTRACE, EventQueue::getCurTick(), Event::initialized(), inParallelMode, EventQueue::insert(), EventBase::Scheduled, and Event::scheduled().

Referenced by sc_gem5::Scheduler::initPhase(), RubySystem::memWriteback(), GicV2::postFiq(), GicV2::postInt(), VGic::postVInt(), pybind_init_event(), sc_gem5::Scheduler::schedule(), EventManager::schedule(), Iris::ThreadContext::scheduleInstCountEvent(), and SimpleThread::scheduleInstCountEvent().

◆ schedule() [2/3]

void EventManager::schedule	(	Event &	event,
		Tick	when
	)

inline

Definition at line 934 of file eventq.hh.

References EventQueue::schedule().

Referenced by DRAMSim2::accessAndRespond(), FlashDevice::accessDevice(), BaseKvmCPU::activateContext(), AtomicSimpleCPU::activateContext(), TimingSimpleCPU::activateContext(), BaseCPU::BaseCPU(), BasePixelPump::beginLine(), TraceCPU::checkAndSchedExitEvent(), DRAMCtrl::Rank::checkDrainDone(), IGbE::chkInterrupt(), HDLcd::cmdEnable(), Sinic::Base::cpuIntrPost(), NSGigE::cpuIntrPost(), CPUProgressEvent::CPUProgressEvent(), TraceCPU::dcacheRetryRecvd(), Prefetcher::BOP::delayQueueEventWrapper(), TimingSimpleCPU::TimingCPUPort::TickEvent::description(), Shader::dispatch_workgroups(), Pl111::dmaDone(), HSADevice::dmaVirt(), HSAPacketProcessor::dmaVirt(), IdeDisk::doDmaDataRead(), IdeDisk::doDmaDataWrite(), IdeDisk::doDmaRead(), IdeDisk::doDmaTransfer(), IdeDisk::doDmaWrite(), ThermalModel::doStep(), TimingSimpleCPU::drain(), BaseKvmCPU::drainResume(), AtomicSimpleCPU::drainResume(), TimingSimpleCPU::drainResume(), FullO3CPU< O3CPUImpl >::drainResume(), RubySystem::enqueueRubyEvent(), GoodbyeObject::fillBuffer(), Minor::LSQ::SplitDataRequest::finish(), BaseKvmCPU::finishMMIOPending(), GarnetSyntheticTraffic::GarnetSyntheticTraffic(), GpuDispatcher::GpuDispatcher(), SimpleCache::handleRequest(), DmaPort::handleResp(), X86ISA::GpuTLB::handleTranslationReturn(), RubyDirectedTester::hitCallback(), TraceCPU::icacheRetryRecvd(), TraceCPU::init(), Prefetcher::BOP::insertIntoDelayQueue(), Sequencer::insertRequest(), GPUCoalescer::insertRequest(), TimingSimpleCPU::IprEvent::IprEvent(), X86ISA::GpuTLB::issueTLBLookup(), VIPERCoalescer::makeRequest(), GPUCoalescer::makeRequest(), MemTest::MemTest(), ArmISA::TableWalker::nextWalk(), GpuDispatcher::notifyWgCompl(), DVFSHandler::perfLevel(), IGbE::RxDescCache::pktComplete(), IGbE::TxDescCache::pktComplete(), IGbE::postInterrupt(), MC146818::RTCEvent::process(), MC146818::RTCTickEvent::process(), CPUProgressEvent::process(), Prefetcher::AccessMapPatternMatching::processEpochEvent(), HelloObject::processEvent(), SparcISA::ISA::processHSTickCompare(), DRAMCtrl::Rank::processPowerEvent(), BaseCPU::processProfileEvent(), DRAMCtrl::Rank::processRefreshEvent(), SparcISA::ISA::processSTickCompare(), Shader::processTick(), EtherLink::Link::processTxQueue(), PowerDomain::pwrStateChangeCallback(), Pl111::readFramebuffer(), BaseCache::recvAtomic(), MemTest::recvRetry(), StubSlavePort::recvTimingReq(), SimpleMemory::recvTimingReq(), RiscvISA::Walker::recvTimingResp(), X86ISA::Walker::recvTimingResp(), X86ISA::GpuTLB::MemSidePort::recvTimingResp(), BasePixelPump::renderPixels(), IGbE::restartClock(), Sp804::Timer::restartCounter(), A9GlobalTimer::Timer::restartCounter(), CpuLocalTimer::Timer::restartTimerCounter(), CpuLocalTimer::Timer::restartWatchdogCounter(), BasePixelPump::PixelEvent::resume(), PL031::resyncMatch(), EtherTapBase::retransmit(), RubyDirectedTester::RubyDirectedTester(), RubyTester::RubyTester(), Gicv3Its::runProcessTiming(), NSGigE::rxKick(), CommMonitor::samplePeriodic(), HSAPacketProcessor::schedAQLProcessing(), SMMUv3SlaveInterface::schedAtsTimingResp(), TraceCPU::schedDcacheNextEvent(), TraceCPU::schedIcacheNext(), PacketQueue::schedSendEvent(), MipsISA::ISA::scheduleCP0Update(), SMMUv3SlaveInterface::scheduleDeviceRetry(), GpuDispatcher::scheduleDispatch(), MC146818::RTCEvent::scheduleIntr(), DRAMCtrl::Rank::schedulePowerEvent(), BaseCPU::schedulePowerGatingEvent(), FullO3CPU< O3CPUImpl >::scheduleThreadExitEvent(), FullO3CPU< O3CPUImpl >::scheduleTickEvent(), BaseTrafficGen::scheduleUpdate(), SMMUProcess::scheduleWakeup(), DRAMCtrl::Rank::scheduleWakeUpEvent(), HWScheduler::schedWakeup(), Iris::ThreadContext::semihostingEvent(), EtherBus::send(), ComputeUnit::sendRequest(), DRAMSim2::sendResponse(), EtherTapBase::sendSimulated(), ComputeUnit::sendSyncRequest(), SparcISA::ISA::setFSReg(), Pl011::setInterrupts(), Intel8254Timer::Counter::CounterEvent::setTo(), BasePixelPump::start(), IdeDisk::startDma(), sc_gem5::Kernel::startup(), HelloObject::startup(), CommMonitor::startup(), BaseKvmCPU::startup(), MC146818::startup(), ThermalModel::startup(), Prefetcher::AccessMapPatternMatching::startup(), Intel8254Timer::Counter::startup(), DRAMSim2::startup(), BaseCPU::startup(), DRAMCtrl::Rank::startup(), BaseCPU::suspendContext(), BaseCPU::takeOverFrom(), GarnetSyntheticTraffic::tick(), MemTest::tick(), IGbE::tick(), DRAMSim2::tick(), FullO3CPU< O3CPUImpl >::tick(), BaseKvmCPU::tick(), Root::timeSync(), Root::timeSyncEnable(), X86ISA::GpuTLB::translationReturn(), EtherLink::Link::transmit(), EtherSwitch::Interface::transmit(), NSGigE::transmit(), EtherLink::Link::txDone(), NSGigE::txKick(), ThreadState::unserialize(), Sinic::Base::unserialize(), EtherSwitch::Interface::unserialize(), GpuDispatcher::unserialize(), Uart8250::unserialize(), EtherLink::Link::unserialize(), Sp804::Timer::unserialize(), PL031::unserialize(), EnergyCtrl::unserialize(), A9GlobalTimer::Timer::unserialize(), CpuLocalTimer::Timer::unserialize(), SparcISA::ISA::unserialize(), DVFSHandler::unserialize(), VGic::unserialize(), BaseTrafficGen::unserialize(), X86ISA::Interrupts::unserialize(), Sinic::Device::unserialize(), NSGigE::unserialize(), IdeDisk::unserialize(), Pl111::unserialize(), GicV2::unserialize(), IGbE::unserialize(), ArchTimer::updateCounter(), TLBCoalescer::updatePhysAddresses(), HDLcd::virtRefresh(), FullO3CPU< O3CPUImpl >::wakeCPU(), RubyDirectedTester::wakeup(), Sequencer::wakeup(), GPUCoalescer::wakeup(), RubyTester::wakeup(), EnergyCtrl::write(), GpuDispatcher::write(), SMMUv3::writeControl(), and MC146818::writeData().

◆ schedule() [3/3]

void EventManager::schedule	(	Event *	event,
		Tick	when
	)

inline

Definition at line 961 of file eventq.hh.

References EventQueue::schedule().

◆ scheduled()

bool Event::scheduled ( ) const

inline

Determine if the current event is scheduled.

Definition at line 459 of file eventq.hh.

References Flags< T >::isSet(), and EventBase::Scheduled.

◆ ScopedMigration()

EventQueue::ScopedMigration::ScopedMigration	(	EventQueue *	_new_eq,
		bool	_doMigrate = `true`
	)

inline

Definition at line 679 of file eventq.hh.

References curEventQueue().

◆ serviceEvents()

void EventQueue::serviceEvents ( Tick when )

inline

process all events up to the given timestamp.

we inline a quick test to see if there are any events to process; if so, call the internal out-of-line version to process them all.

Notes:

This is only used for "instruction" event queues. Instead of counting ticks, this is actually counting instructions.
This updates the current tick value to the value of the entry at the head of the queue.

Todo:: this assert is a good bug catcher. I need to make it true again.

Definition at line 801 of file eventq.hh.

Referenced by Iris::ThreadContext::maintainStepping(), and BaseSimpleCPU::preExecute().

◆ squash()

void Event::squash ( )

inline

Squash the current event.

Definition at line 466 of file eventq.hh.

References Flags< T >::set(), and EventBase::Squashed.

Referenced by Sinic::Base::cpuIntrClear(), NSGigE::cpuIntrClear(), Sinic::Base::cpuIntrPost(), NSGigE::cpuIntrPost(), pybind_init_event(), InstructionQueue< Impl >::recordProducer(), and FullO3CPU< O3CPUImpl >::unscheduleTickEvent().

◆ squashed()

bool Event::squashed ( ) const

inline

Check whether the event is squashed.

Definition at line 473 of file eventq.hh.

References Flags< T >::isSet(), and EventBase::Squashed.

Referenced by pybind_init_event(), and FullO3CPU< O3CPUImpl >::scheduleTickEvent().

◆ trace()

void Event::trace ( const char * action )

protectedvirtual

This function isn't really useful if TRACING_ON is not defined.

trace event activity

Definition at line 377 of file eventq.cc.

References DPRINTF_UNCONDITIONAL.

Referenced by Trace::TarmacParser::TarmacParser(), sc_gem5::Scheduler::timeAdvances(), and Trace::TarmacParser::~TarmacParser().

◆ wakeup()

virtual void EventQueue::wakeup ( Tick when = (Tick)-1 )

inlinevirtual

Function to signal that the event loop should be woken up because an event has been scheduled by an agent outside the gem5 event loop(s) whose event insertion may not have been noticed by gem5.

This function isn't needed by the usual gem5 event loop but may be necessary in derived EventQueues which host gem5 onto other schedulers.

Parameters

when	Time of a delayed wakeup (if known). This parameter can be used by an implementation to schedule a wakeup in the future if it is sure it will remain active until then. Or it can be ignored and the event queue can be woken up now.

Definition at line 855 of file eventq.hh.

References ArmISA::s.

Referenced by dumprstStatsHandler(), dumpStatsHandler(), exitNowHandler(), ioHandler(), PollQueue::setupAsyncIO(), and EventManager::wakeupEventQueue().

◆ wakeupEventQueue()

void EventManager::wakeupEventQueue ( Tick when = (Tick)-1 )

inline

Definition at line 987 of file eventq.hh.

References EventQueue::wakeup().

◆ when()

Tick Event::when ( ) const

inline

Get the time that the event is scheduled.

Definition at line 499 of file eventq.hh.

Referenced by FlashDevice::accessDevice(), FlashDevice::actionComplete(), DRAMCtrl::activateBank(), FlashDevice::checkDrain(), EventQueue::debugVerify(), RubySystem::memWriteback(), EventQueue::nextTick(), operator!=(), operator<(), operator<=(), operator==(), operator>(), operator>=(), DRAMCtrl::prechargeBank(), LdsState::process(), pybind_init_event(), Sp804::Timer::read(), CpuLocalTimer::Timer::read(), TraceCPU::schedDcacheNextEvent(), PacketQueue::schedSendEvent(), DRAMCtrl::Rank::schedulePowerEvent(), Sp805::serialize(), ThreadState::serialize(), Sinic::Base::serialize(), EtherSwitch::Interface::serialize(), GpuDispatcher::serialize(), Uart8250::serialize(), EtherLink::Link::serialize(), Sp804::Timer::serialize(), PL031::serialize(), EnergyCtrl::serialize(), SystemCounter::serialize(), CpuLocalTimer::Timer::serialize(), MC146818::serialize(), SparcISA::ISA::serialize(), Intel8254Timer::Counter::serialize(), VGic::serialize(), BaseTrafficGen::serialize(), Sinic::Device::serialize(), NSGigE::serialize(), GenericTimer::CoreTimers::serialize(), IdeDisk::serialize(), Pl111::serialize(), IGbE::serialize(), BasePixelPump::PixelEvent::suspend(), Sp805::value(), and BaseGlobalEvent::when().

◆ ~Event()

Event::~Event ( )

virtual

Definition at line 75 of file eventq.cc.

Variable Documentation

◆ CPU_Exit_Pri

const Priority EventBase::CPU_Exit_Pri = 64

static

If we want to exit a thread in a CPU, it comes after CPU_Tick_Pri.

Definition at line 205 of file eventq.hh.

Referenced by FullO3CPU< O3CPUImpl >::FullO3CPU().

◆ CPU_Switch_Pri

const Priority EventBase::CPU_Switch_Pri = -31

static

CPU switches schedule the new CPU's tick event for the same cycle (after unscheduling the old CPU's tick event).

The switch needs to come before any tick events to make sure we don't tick both CPUs in the same cycle.

Definition at line 157 of file eventq.hh.

Referenced by pybind_init_event().

◆ CPU_Tick_Pri

const Priority EventBase::CPU_Tick_Pri = 50

static

CPU ticks must come after other associated CPU events (such as writebacks).

Definition at line 198 of file eventq.hh.

Referenced by AtomicSimpleCPU::AtomicSimpleCPU(), BaseKvmCPU::BaseKvmCPU(), FullO3CPU< O3CPUImpl >::FullO3CPU(), GarnetSyntheticTraffic::GarnetSyntheticTraffic(), DefaultCommit< Impl >::generateTrapEvent(), GpuDispatcher::GpuDispatcher(), pybind_init_event(), RubyDirectedTester::RubyDirectedTester(), RubyTester::RubyTester(), MipsISA::ISA::scheduleCP0Update(), Shader::Shader(), and TLBCoalescer::TLBCoalescer().

◆ Debug_Break_Pri

const Priority EventBase::Debug_Break_Pri = -100

static

Breakpoints should happen before anything else (except enabling trace output), so we don't miss any action when debugging.

Definition at line 147 of file eventq.hh.

Referenced by pybind_init_event().

◆ Debug_Enable_Pri

const Priority EventBase::Debug_Enable_Pri = -101

static

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).

Definition at line 138 of file eventq.hh.

Referenced by pybind_init_event().

◆ Default_Pri

const Priority EventBase::Default_Pri = 0

static

Default is zero for historical reasons.

Definition at line 173 of file eventq.hh.

Referenced by pybind_init_event().

◆ Delayed_Writeback_Pri

const Priority EventBase::Delayed_Writeback_Pri = -1

static

For some reason "delayed" inter-cluster writebacks are scheduled before regular writebacks (which have default priority).

Steve?

Definition at line 166 of file eventq.hh.

Referenced by BaseCache::BaseCache(), and pybind_init_event().

◆ DVFS_Update_Pri

const Priority EventBase::DVFS_Update_Pri = 31

static

DVFS update event leads to stats dump therefore given a lower priority to ensure all relevant states have been updated.

Definition at line 181 of file eventq.hh.

Referenced by pybind_init_event().

◆ Maximum_Pri

const Priority EventBase::Maximum_Pri = SCHAR_MAX

static

Maximum priority.

Definition at line 235 of file eventq.hh.

Referenced by X86ISA::GpuTLB::GpuTLB(), pybind_init_event(), and TLBCoalescer::TLBCoalescer().

◆ Minimum_Pri

const Priority EventBase::Minimum_Pri = SCHAR_MIN

static

Event priorities, to provide tie-breakers for events scheduled at the same cycle.

Most events are scheduled at the default priority; these values are used to control events that need to be ordered within a cycle. Minimum priority

Definition at line 129 of file eventq.hh.

Referenced by pybind_init_event().

◆ Progress_Event_Pri

const Priority EventBase::Progress_Event_Pri = 95

static

Progress events come at the end.

Definition at line 220 of file eventq.hh.

Referenced by GPUCoalescer::GPUCoalescer(), pybind_init_event(), and simulate().

◆ Serialize_Pri

const Priority EventBase::Serialize_Pri = 32

static

Serailization needs to occur before tick events also, so that a serialize/unserialize is identical to an on-line CPU switch.

Definition at line 190 of file eventq.hh.

Referenced by pybind_init_event().

◆ Sim_Exit_Pri

const Priority EventBase::Sim_Exit_Pri = 100

static

If we want to exit on this cycle, it's the very last thing we do.

Definition at line 228 of file eventq.hh.

Referenced by pybind_init_event(), and Iris::ThreadContext::ThreadContext().

◆ Stat_Event_Pri

const Priority EventBase::Stat_Event_Pri = 90

static

Statistics events (dump, reset, etc.) come after everything else, but before exit.

Definition at line 213 of file eventq.hh.

Referenced by pybind_init_event().

Typedefs

Functions

Variables

Detailed Description

Typedef Documentation

◆ Priority

Function Documentation

◆ deschedule() [1/3]

◆ deschedule() [2/3]

◆ deschedule() [3/3]

◆ description() [1/2]

◆ description() [2/2]

◆ dump() [1/2]

◆ dump() [2/2]

◆ empty()

◆ EventFunctionWrapper()

◆ EventManager() [1/3]

◆ EventManager() [2/3]

◆ EventManager() [3/3]

◆ EventQueue()

◆ eventQueue()

◆ getCurTick()

◆ isAutoDelete()

◆ isExitEvent()

◆ isManaged()

◆ name() [1/4]

◆ name() [2/4]

◆ name() [3/4]

◆ name() [4/4]

◆ operator!=()

◆ operator<()

◆ operator<=()

◆ operator==()

◆ operator>()

◆ operator>=()

◆ priority()

◆ process()

◆ reschedule() [1/3]

◆ reschedule() [2/3]

◆ reschedule() [3/3]

◆ schedule() [1/3]

◆ schedule() [2/3]

◆ schedule() [3/3]

◆ scheduled()

◆ ScopedMigration()

◆ serviceEvents()

◆ squash()

◆ squashed()

◆ trace()

◆ wakeup()

◆ wakeupEventQueue()

◆ when()

◆ ~Event()

Variable Documentation

◆ CPU_Exit_Pri

◆ CPU_Switch_Pri

◆ CPU_Tick_Pri

◆ Debug_Break_Pri

◆ Debug_Enable_Pri

◆ Default_Pri

◆ Delayed_Writeback_Pri

◆ DVFS_Update_Pri

◆ Maximum_Pri

◆ Minimum_Pri

◆ Progress_Event_Pri

◆ Serialize_Pri

◆ Sim_Exit_Pri

◆ Stat_Event_Pri