Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] pthread_cancel, pthread_setcancelstate, pthread_setcanceltype, pthread_testcancel - Annulation de thread. [size=18] [b]Résumé[/b] [/size] [b]#include <pthread.h>[/b] [b][i]int pthread_cancel(pthread_t thread );[/i][/b] [b][i]int pthread_setcancelstate(int state , int * etat_pred );[/i][/b] [b][i]int pthread_setcanceltype(int mode , int * ancien_mode );[/i][/b] [b][i]void pthread_testcancel(void);[/i][/b] [size=18] [b]Description[/b] [/size] L'annulation est le mécanisme par lequel un thread peut interrompre l'exécution d'un autre thread. C'est l'équivalent pour les threads de la fonction kill() des processus classiques. Plus précisément, un thread peut envoyer une requête d'annulation à un autre thread. Selon sa configuration, le thread visé peut soit ignorer la requête, soit l'honorer immédiatement, soit enfin retarder son application jusqu'à ce qu'un point d'annulation soit atteint. Quand un thread réalise finalement la requête d'annulation, il se comporte comme si [b]pthread_exit(PTHREAD_CANCELED)[/b] avait été appelé à cet endroit : tous les gestionnaires de nettoyage sont exécutés dans l'ordre inverse de leur enregistrement. Puis les fonctions de destruction des données spécifiques au thread sont appelées. Enfin, le thread interrompt définitivement son exécution en retournant la valeur [b]PTHREAD_CANCELED .[/b] Voir [b]pthread_exit (3)[/b] pour plus d'information. [b]pthread_cancel[/b] envoie une requête d'annulation au thread indiqué par l'argument [b]thread .[/b] [b]pthread_setcancelstate[/b] modifie l'état d'annulation pour le thread appelant, c'est à dire si les requêtes d'annulation sont ignorées ou non. L'argument [i]state[/i] est le nouvel état d'annulation : soit [b]PTHREAD_CANCEL_ENABLE[/b] pour autoriser les annulations, soit [b]PTHREAD_CANCEL_DISABLE[/b] pour les désactiver (les requêtes d'annulation sont alors ignorées). Si [i]etat_pred[/i] est différent de [b]NULL ,[/b] le précédent état d'annulation est sauvegardé à l'emplacement pointé par [b]etat_pred ,[/b] et peut donc être restauré plus tard par un autre appel à [b]pthread_setcancelstate .[/b] [b]pthread_setcanceltype[/b] modifie le mode de la réponse à une requête d'annulation pour le thread appelant : asynchrone (immédiate) ou retardée. L'argument [i]type[/i] est le nouveau mode d'annulation : soit [b]PTHREAD_CANCEL_ASYNCHRONOUS[/b] pour annuler le thread appelant dès que possible après la réception d'une requête d'annulation, soit [b]PTHREAD_CANCEL_DEFERRED[/b] pour mettre en attente la requête jusqu'à ce qu'un point d'annulation soit atteint. Si [i]ancien_mode[/i] n'est pas égal à [b]NULL ,[/b] alors le précédent état d'annulation est sauvegardé à l'emplacement pointé par [b]ancien_mode ,[/b] et peut donc être restauré plus tard par un autres appel à [b]pthread_setcanceltype .[/b] Les threads sont toujours créés par [b]pthread_create (3)[/b] avec annulation activée et retardée. C'est à dire que l'état initial d'annulation est [b]PTHREAD_CANCEL_ENABLE[/b] et que le mode initial est [b]PTHREAD_CANCEL_DEFERRED .[/b] Les points d'annulation sont les points dans l'exécution d'un programme où l'on teste si des requêtes d'annulation ne sont pas en attente de traitement. Si des requêtes sont en attente, alors l'annulation du thread est exécutée. Les fonctions suivantes relatives aux threads de la norme POSIX sont des points d'annulation implicites : [table][row][col]    [/col][col] [b]pthread_join (3)[/b] [b][/b] [b]pthread_cond_wait (3)[/b] [b][/b] [b]pthread_cond_timedwait (3)[/b] [b][/b] [b]pthread_testcancel (3)[/b] [b][/b] [b]sem_wait (3)[/b] [b][/b] [b]sigwait (3)[/b][/col][/row][/table] Toutes les autres fonctions POSIX relatives aux threads sont garanties ne pas être des points d'annulation. C'est-à-dire qu'elles ne traitent pas les requêtes d'annulation en attente de traitement. [b]pthread_testcancel[/b] ne fait rien si ce n'est tester si une requête d'annulation est en attente de réalisation et la traiter. Sa fonction est d'introduire des tests explicites pour vérifier ponctuellement qu'aucune requête d'annulation n'a été reçue lors des longues séquences de code sans points d'annulation. [size=18] [b]Valeur renvoyée[/b] [/size] [b]pthread_cancel ,[/b] [b]pthread_setcancelstate[/b] et [b]pthread_setcanceltype[/b] renvoient 0 en cas de succès et un code d'erreur non nul en cas d'erreur. [size=18] [b]Erreurs[/b] [/size] [b]pthread_cancel[/b] renvoie l'un des codes d'erreur suivants :[table][row][col]    [/col][col] [b]ESRCH[/b] [table][row][col]    [/col][col]aucun thread correspondant au descripteur [i]thread[/i] n'a pu ête trouvé.[/col][/row][/table] [b]pthread_setcancelstate[/b] renvoie l'un des codes d'erreur suivants :[table][row][col]    [/col][col][/col][/row][/table] [b]EINVAL[/b] [table][row][col]    [/col][col]l'argument [i]state[/i] n'est ni [b]PTHREAD_CANCEL_ENABLE[/b] ni [b]PTHREAD_CANCEL_DISABLE[/b][/col][/row][/table] [b]pthread_setcanceltype[/b] renvoie l'un des codes d'erreur suivants :[table][row][col]    [/col][col][/col][/row][/table] [b]EINVAL[/b] [table][row][col]    [/col][col]l'argument [i]type[/i] n'est ni [b]PTHREAD_CANCEL_DEFERRED[/b] ni [b]PTHREAD_CANCEL_ASYNCHRONOUS[/b][/col][/row][/table] [/col][/row][/table] [size=18] [b]Auteur[/b] [/size] Xavier Leroy <Xavier.Leroy@inria.fr> [size=18] [b]Voir aussi[/b] [/size] [b]pthread_exit (3),[/b] [b]pthread_cleanup_push (3),[/b] [b]pthread_cleanup_pop (3).[/b] [size=18] [b]Bugs[/b] [/size] POSIX spécifie qu'un certain nombre d'appels-système (fondamentalement, tous les appels-système pouvant bloquer comme [b]read (2),[/b] [b]write (2),[/b] [b]wait (2),[/b] etc.) et les fonctions de bibliothèques qui invoquent ces appels-système (par exemple, [b]fprintf (3))[/b] sont des points d'annulation. LinuxThreads n'est pas encore assez intégré à la bibliothèque standard C pour implémenter cela ; et donc, aucune fonction de la GlibC n'est un point d'annulation. Pour les appels-système, au moins existe-t'il un moyen détourné d'y parvenir. Les requêtes d'annulation sont transmises au thread ciblé en lui envoyant un signal. Ce dernier va interrompre tous les appels-système bloquants, les faisant renvoyer immédiatement l'erreur [b]EINTR[/b]. Aussi, vérifier qu'un thread n'a pas été annulé au cours de l'appel-système [b]read[/b], par exemple, peut être réalisé de la manière suivante : [table][row][col]    [/col][col] .ft 3 .nf pthread_testcancel(); retcode = read(fd, tampon, longueur); pthread_testcancel(); .ft    [/col][/row][/table] .fi [size=18] [b]Traduction[/b] [/size] [i]Thierry Vignaud < tvignaud@mandrakesoft.com >, 2000[/i] [b][/b] Christophe Blaess, 2003.
Fichier