StuBS
Dispatcher Class Reference

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

#include <dispatcher.h>

Collaboration diagram for Dispatcher:

Public Member Functions

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

Private Member Functions

void setActive (Thread *thread)
 set the currently active thread More...
 

Detailed Description

The dispatcher dispatches threads and 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 ( )

constructor

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

Member Function Documentation

◆ active()

Thread * Dispatcher::active ( )
inline

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

◆ dispatch()

void Dispatcher::dispatch ( Thread next)

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

Parameters
nextNext thread to be executed.

◆ go()

void Dispatcher::go ( Thread first)

This method stores first as life pointer for this CPU core and triggers the execution of first. Only to be used for the first thread running on a CPU.

Parameters
firstFirst thread to be executed on this CPU core.

◆ isActive()

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

Check if thread is currently active.

Parameters
threadPointer to the thread in question
cpuwill receive the core number if cpu pointer is not nullptr and the thread is currently active
Returns
true if currently running, false otherwise

◆ setActive()

void Dispatcher::setActive ( Thread thread)
inlineprivate

set the currently active thread

Parameters
threadactive Thread

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