Dispatcher Class Reference

The dispatcher dispatches threads and, by that, puts the scheduler's decisions into action. More...

#include <thread/dispatcher.h>

Inheritance diagram for Dispatcher:

Collaboration diagram for Dispatcher:

Static Public Member Functions
static Thread *	active ()
	Returns the thread currently running on the CPU core calling this method.
static bool	isActive (const Thread *thread, unsigned *cpu=nullptr)
	Check if thread is currently active.
static void	go (Thread *first)
	This method stores first as life pointer for this CPU core and triggers the execution of first thread.
static void	dispatch (Thread *next)
	Updates the life pointer to next and issues a thread change from the old to the new life pointer.

Private Member Functions
	Dispatcher ()
	private constructor to prevent instantiation

Static Private Member Functions
static void	setActive (Thread *thread)
	set the currently active thread

Static Private Attributes
static PerCore< Thread * >	life
	Initialize life pointer with nullptr to indicate that nothing is (yet) being executed on the respective CPU.

Detailed Description

The dispatcher dispatches threads and, by that, puts the scheduler's decisions into action.

The dispatcher manages the life pointer that refers to the currently active thread and performs the actual switching of processes. For single-core systems, a single life pointer is sufficient, as only a single thread can be active at any one time. On multi-core systems, every CPU core needs its own life pointer.

Constructor & Destructor Documentation

Dispatcher()

Dispatcher::Dispatcher ( )

private

private constructor to prevent instantiation

Member Function Documentation

setActive()

static void Dispatcher::setActive ( Thread *  thread )

inlinestaticprivate

set the currently active thread

Parameters

thread

active Thread

active()

static Thread * Dispatcher::active ( )

inlinestatic

Returns the thread currently running on the CPU core calling this method.

isActive()

static bool Dispatcher::isActive ( const Thread *  thread, unsigned *  cpu = nullptr  )

inlinestatic

Check if thread is currently active.

Parameters

thread	Pointer to the thread in question
cpu	will receive the core number if cpu pointer is not nullptr and the thread is currently active

Returns

true if currently running, false otherwise

go()

void Dispatcher::go ( Thread *  first )

static

This method stores first as life pointer for this CPU core and triggers the execution of first thread.

Note

Only to be used for the first thread running on a CPU core.

Parameters

first

First thread to be executed on this CPU core.

dispatch()

void Dispatcher::dispatch ( Thread *  next )

static

Updates the life pointer to next and issues a thread change from the old to the new life pointer.

Parameters

next	Next thread to be executed.

Member Data Documentation

life

PerCore< Thread * > Dispatcher::life

staticprivate

Initialize life pointer with nullptr to indicate that nothing is (yet) being executed on the respective CPU.

---

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

• thread/dispatcher.h
• thread/dispatcher.cc