Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] makecontext, swapcontext - Manipulation du contexte utilisateur. [size=18] [b]Résumé[/b] [/size] [b]#include <ucontext.h>[/b] [b][i]void makecontext(ucontext_t * ucp , void * func (),[/i][/b] [b][i]int argc , ...);[/i][/b] [b][/b] [b][i]int swapcontext (ucontext_t * oucp , ucontext_t * ucp );[/i][/b] [size=18] [b]Description[/b] [/size] Dans un environnement de type SysV, on dispose du type [b]ucontext_t[/b] défini dans [i]<ucontext.h>[/i] et des quatre fonctions [b]getcontext()[/b], [b]setcontext()[/b], [b]makecontext()[/b] et [b]swapcontext()[/b] qui permettent, au niveau utilisateur, des permutations de contextes entre plusieurs threads de contrôle au sein d'un processus.     Pour le type et les deux premières fonctions, voir [b]getcontext (2).[/b]     La fonction [b]makecontext()[/b] modifie le contexte pointé par [i]ucp[/i] ( qui a été obtenu par un appel à [b]getcontext()[/b]). Avant d'appeler [b]makecontext()[/b], il faut allouer une nouvelle pile pour ce contexte, l'affectant à [i]ucp->uc_stack[/i], et définir un contexte successeur, l'affectant à [i]ucp->uc_link[/i]. Lorsque ce contexte est activé par la suite (en utilisant [b]setcontext()[/b] ou [b]swapcontext()[/b]), alors, la fonction [i]func[/i] est tout d'abord appelée avec les arguments spécifiés à la suite de [i]argc[/i] (où [i]argc[/i] doit préciser le nombre de ces arguments), et lorsque cette fonction s'achève, le contexte successeur est activé. Quand le pointeur sur le contexte successeur vaut NULL, le thread se termine.     La fonction [b]swapcontext()[/b] sauvegarde le contexte actuel dans la structure pointée par [i]oucp[/i] et active ensuite le contexte pointé par [i]ucp[/i]. [size=18] [b]Valeur renvoyée[/b] [/size] En cas de succès, [b]makecontext()[/b] renvoie 0 tandis que [b]swapcontext()[/b] ne rend pas la main à l'appelant. (On peut toutefois revenir à l'appelant en cas d'activation de [i]oucp[/i]. Dans un tel cas, [b]swapcontext()[/b] se comporte comme si elle renvoyait 0.) En cas d'erreur, les deux fonctions renvoient -1 et positionnent [i]errno[/i] de façon appropriée. [size=18] [b]Erreurs[/b] [/size] [b]ENOMEM[/b] [table][row][col]    [/col][col]Espace de pile disponible insuffisant.[/col][/row][/table] [size=18] [b]Notes[/b] [/size] L'interprétation de [i]ucp->uc_stack[/i] est exactement la même que pour [b]sigaltstack (2),[/b] à savoir, cette structure contient l'adresse de départ et la longueur d'une zone mémoire destinée à être utilisée comme pile, et ce, sans considération sur le sens d'expansion de la pile. Il n'est donc pas nécessaire pour le programme utilisateur de se soucier de ce sens. [size=18] [b]Conformité[/b] [/size] SUSv2, POSIX 1003.1-2001. [size=18] [b]Voir aussi[/b] [/size] [b]getcontext (2),[/b] [b]sigaction (2),[/b] [b]sigaltstack (2),[/b] [b]sigprocmask (2),[/b] [b]sigsetjmp (3)[/b] [size=18] [b]Traduction[/b] [/size] Stéphan Rafin, 2002.
Fichier