---

Interface de gestion de file d'attente
[Interface FRED]

Ce module définit comment bloquer ou réveiller un thread dans une file d'attente. Plus de détails...

Définitions des macros
#define	FredQueueGetFirst(Q)   (FredThread)FredListGetFirst((FredList*)Q)
	Retirer le premier thread d'une file d'attente.
#define	FredQueuePutLast(Q, th)   FredListPutLast((FredList*)Q,(FredCell*)th)
	Insérer un thread déja bloqué dans une file d'attente.
#define	FredQueueEmpty(Q)   FredListEmpty((FredList*)Q)
	Tester une queue à vide de threads.
#define	FredQueueInit(Q)   FredListInit((FredList*)Q);
	Initialiser une queue vide de threads.
Fonctions
void	FredThreadSuspend (FredQueue *q)
	Suspendre le thread courant dans une file.
void	FredThreadWakeUp (FredQueue *q)
	Réveille un thread bloqué.

---

Description détaillée

Pour savoir comment l'utiliser, voir File d'attente , Un exemple d'outil de synchronisation : le sémaphore et Les N philosophes

---

Documentation de la macro

#define FredQueueEmpty (  Q    )     FredListEmpty((FredList*)Q)

Paramètres: Q  queue Renvoie : 1 si vide. 0 sinon Implantation C'est un simple alias du test de liste vide, les conversions de type en sus.

#define FredQueueGetFirst (  Q    )     (FredThread)FredListGetFirst((FredList*)Q)

Paramètres: Q  FredQueue où mettre le thread courant Renvoie : le premier thread de la file ou 0 si file vide Avertissement: Cette procédure n'est utilisable qu'au sein d'une section en exclusion mutuelle. Implantation C'est un simple alias du retrait de liste, les conversions de type en sus.

#define FredQueueInit (  Q    )     FredListInit((FredList*)Q);

Paramètres: Q  queue vide Implantation C'est un simple alias de l'initialisation de liste , les conversions de type en sus.

#define FredQueuePutLast (  Q, th    )     FredListPutLast((FredList*)Q,(FredCell*)th)

Paramètres: Q  FredQueue où mettre le thread bloqué th  le thread bloqué à insérer en queue Avertissement: Cette procédure n'est utilisable qu'au sein d'une section en exclusion mutuelle. Implantation C'est un simple alias de l'insertion de liste, les conversions de type en sus.

---

Documentation de la fonction

void FredThreadSuspend (  FredQueue *    q )

Paramètres: q  file où mettre le thread courant Le thread courant est mis en queue de la file. Un nouveau thread est élu pour s'exécuter. Avertissement: Cette procédure n'est utilisable qu'au sein d'une section en exclusion mutuelle. Implantation On doit arrêter puis relancer un décomptage. { FredThread old; current->err=errno; /* sauver errno */ FredCountDownStop(); /* Arrêt décompeur */ /* le courant se en queue de la file q */ FredQueuePutLast(q,current); /* on choisit un nouveau courant : on doit garantir que la file readyQ n'est jamais vide : C'est le rôle du watchdog */ old=current; current=FredQueueGetFirst(&readyQ); FredContextSwitch(old->ctx,current->ctx); /* on reviendra ici lors de son réveil : on relance le décomptage du quantum */ FredCountDownStart(quantum); errno=current->err;/* restaurer errno */ }

void FredThreadWakeUp (  FredQueue *    q )

Paramètres: q  queue dont- le premier thread est remis prêt Le thread réveillé est mis en queue de la file des prêts. C'est une opération nulle si la file est vide. Avertissement: Cette procédure n'est utilisable qu'au sein d'une section en exclusion mutuelle. Implantation { if(!FredQueueEmpty(q))FredQueuePutLast(&readyQ,FredQueueGetFirst(q)); }

---