Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] getcontext, setcontext - Lire ou écrire le contexte utilisateur. [size=18] [b]Résumé[/b] [/size] [b]#include <ucontext.h>[/b] [b][i]int getcontext(ucontext_t * ucp );[/i][/b] [b][/b] [b][i]int setcontext(const ucontext_t * ucp );[/i][/b] [size=18] [b]Description[/b] [/size] Dans un environnement de type SysV, il existe deux types [b]mcontext_t et ucontext_t[/b] définis dans [i]<ucontext.h>[/i] et les quatre fonctions [b]getcontext (), setcontext (), makecontext () et swapcontext ()[/b] permettent le changement de contexte au niveau utilisateur entre plusieurs fils de contrôle au sein du même processus (threads).     Le type [b]mcontext_t[/b] est opaque et dépend de la machine. Le type [b]ucontext_t[/b] est une structure ayant au moins les champs suivants :[table][row][col]    [/col][col] .nf typedef struct ucontext { struct ucontext *uc_link; sigset_t uc_sigmask; stack_t uc_stack; mcontext_t uc_mcontext; ... } ucontext_t; .fi[/col][/row][/table] Les types [b]sigset_t et stack_t[/b] sont définis dans [b]<signal.h> .[/b] Ici, [i]uc_link[/i] pointe sur le contexte qui doit être restauré lorsque le contexte courant se terminera (si le contexte en cours a été créé par [b]makecontext ()),[/b] [i]uc_sigmask[/i] est l'ensemble des signaux bloqués dans ce contexte (voir [b]sigaltstack (2)),[/b] et [i]uc_mcontext[/i] est la représentation - dépendant de la machine - du contexte sauvegardé, qui inclue les registres du processeur pour le thread appelant.     La fonction [b]getcontext ()[/b] remplit la structure pointée par [i]ucp[/i] avec le contexte actuellement actif.     La fonction [b]setcontext ()[/b] restaure le contexte utilisateur pointé par [b]ucp .[/b] Un appel réussi ne revient pas. Le contexte doit avoir été obtenu par un appel [b]getcontext (),[/b] ou [b]makecontext (),[/b] ou passé en troisième argument à un gestionnaire de signal.     Si le contexte a été obtenu par un appel [b]getcontext (),[/b] l'exécution du programme reprend comme si cet appel venait juste de se terminer.     Si le contexte a été obtenu par un appel [b]makecontext (),[/b] l'exécution du programme continue par l'appel de la fonction [i]func[/i] indiquée en second argument de [b]makecontext ().[/b] Quand la fonction [i]func[/i] se terminer, on continue avec le membre [i]uc_link[/i] de la structure [i]ucp[/i] spécifiée en premier argument de l'appel [b]makecontext ().[/b] Si ce membre est NULL, le thread se termine.     Si le contexte a été obtenu lors d'un appel à un gestionnaire de signal, alors le texte des anciens standards dit que "l'exécution du programme continue avec l'instruction suivant celle qui a été interrompue par le signal". Toutefois cette phrase a été supprimée de SUSv2, et remplacée par "le résultat n'est pas spécifié". [size=18] [b]Valeur renvoyée[/b] [/size] Lorsqu'ils réussissent, [b]getcontext ()[/b] renvoie zéro et [b]setcontext ()[/b] ne revient pas. En cas d'erreur, ils retournent -1 et remplissent [i]errno[/i] avec le code d'erreur adéquat. [size=18] [b]Erreurs[/b] [/size] Aucune définie. [size=18] [b]Notes[/b] [/size] L'incarnation la plus ancienne de ce mécanisme était constituée de la paire [b]setjmp ()/ longjmp ().[/b] Comme ils ne précisent pas la gestion des signaux, l'étape suivante fut [b]sigsetjmp ()/ siglongjmp ().[/b] Le mécanisme actuel donne plus de contrôle. En revanche, il n'y a pas de moyen simple pour savoir si le retour de [b]getcontext ()[/b] se fait depuis son premier appel ou par l'intermédiaire d'un appel [b]setcontext ().[/b] L'utilisateur doit inventer son propre système de comptabilisation, et pas dans un registre car il serait restauré.     Lorsqu'un signal arrive, le contexte utilisateur courant est sauvegardé et un nouveau contexte est créé par le noyau pour exécuter le gestionnaire. N'utilisez pas [b]longjmp ()[/b] dans le gestionnaire, le comportement est indéfini. Utilisez [b]siglongjmp () ou setcontext ().[/b] [size=18] [b]Conformité[/b] [/size] SUSv2 [size=18] [b]Voir aussi[/b] [/size] [b]sigaction (2),[/b] [b]sigaltstack (2),[/b] [b]sigprocmask (2),[/b] [b]longjmp (3),[/b] [b]sigsetjmp (3),[/b] [b]makecontext (3)[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 1996-2003.
Fichier