toc.h-Dateireferenz

Enthält die Struktur 'Thread of context'. Mehr ...

Dieser Graph zeigt, welche Datei direkt oder indirekt diese Datei enthält:

Klassen
struct	toc
	Die Struktur toc dient dazu, bei einem Koroutinenwechsel die Werte der nicht-flüchtigen Register zu sichern. Mehr ...

Funktionen
void	toc_settle (struct toc *regs, void *tos, void(*kickoff)(Thread *), Thread *object)
	Diese Funktion bereitet ein struct toc für die erste Aktivierung vor. Mehr ...
void	toc_go (struct toc *regs)
	Diese Funktion lädt die Prozessorregister mit den Inhalten aus regs. Mehr ...
void	toc_switch (struct toc *regs_now, struct toc *reg_then)
	Diese Funktion führt einen Kontextwechsel durch. Dazu brauchen nur die aktuellen Registerwerte in regs_now gesichert und durch die Werte von regs_then ersetzt zu werden. Mehr ...

Ausführliche Beschreibung

Enthält die Struktur 'Thread of context'.

Dokumentation der Funktionen

toc_go()

void toc_go

(

struct toc *

regs

)

Diese Funktion lädt die Prozessorregister mit den Inhalten aus regs.

toc_go wird verwendet, um auf jeder CPU den ersten Thread überhaupt zu starten. Die Implementierung von toc_go muss in Assembler in der Datei toc.asm erfolgen. Sie muss als extern "C" deklariert werden, da sie als Assemblerfunktion nicht dem C++ Namemangeling unterliegt.

Parameter

regs	Initialer Kontext der Koroutine, die gestartet werden soll.

toc_settle()

void toc_settle	(	struct toc *	regs,
		void *	tos,
		void(*)(Thread *)	kickoff,
		Thread *	object
	)

Diese Funktion bereitet ein struct toc für die erste Aktivierung vor.

Dazu müssen Registerinhalte und Stack so initialisiert werden, dass bei der ersten Aktivierung die Ausführung mit der Funktion kickoff beginnt, die wiederum den Zeiger object als ersten Parameter auf dem Stack vorfinden muss.

toc_settle kann in C++ in der Datei toc.cc implementiert werden und deshalb muss sie nicht als extern "C" deklariert werden.

Parameter

regs	Kontext, der auf eine Aktivierung vorbereitet werden soll
tos	Zeiger auf die oberste Adresse des Stackbereichs.
kickoff	Adresse der Funktion kickoff, mit der die Ausführung eines Fadens beginnt.
object	Zeiger auf ein Thread Objekt; Parameter für die Funktion kickoff.

toc_switch()

void toc_switch	(	struct toc *	regs_now,
		struct toc *	reg_then
	)

Diese Funktion führt einen Kontextwechsel durch. Dazu brauchen nur die aktuellen Registerwerte in regs_now gesichert und durch die Werte von regs_then ersetzt zu werden.

Auch toc_switch wird in Assembler in der Datei toc.asm implementiert. Sie muss als extern "C" deklariert werden, da sie als Assemblerfunktion nicht dem C++ Namemangeling unterliegt.

Parameter

regs_now	Zeiger auf ein struct toc, in den der aktuelle Prozessorkontext gesichert werden soll.
reg_then	Zeiger auf ein struct toc, der den zu ladenden Kontext enthält.