Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] pthread_sigmask, pthread_kill, sigwait - gestion des signaux dans les threads [size=18] [b]Résumé[/b] [/size] [b]#include <pthread.h>[/b] [b][/b] [b]#include <signal.h>[/b] [b][i]int pthread_sigmask(int how , const sigset_t * newmask , sigset_t * oldmask );[/i][/b] [b][i]int pthread_kill(pthread_t thread , int signo );[/i][/b] [b][i]int sigwait(const sigset_t * set , int * sig );[/i][/b] [size=18] [b]Description[/b] [/size] [b]pthread_sigmask[/b] change le masque des signaux pour le thread appelant tel que décrit par les arguments [i]how[/i] et [i]newmask[/i]. Si [i]oldmask[/i] ne vaut pas [b]NULL ,[/b] le précédent masque de signaux est sauvegardé dans l'emplacement pointé par [b]oldmask .[/b] La signification des arguments [i]how[/i] et [i]newmask[/i] est la même que pour [b]sigprocmask (2).[/b] Si [i]how[/i] vaut [b]SIG_SETMASK ,[/b] le masque de signal est positionné à [b]newmask .[/b] Si [i]how[/i] vaut [b]SIG_BLOCK ,[/b] les signaux indiqués par [i]newmask[/i] sont ajoutés au masque de signaux courant. Si [i]how[/i] vaut [b]SIG_UNBLOCK ,[/b] les signaux indiqués par [i]newmask[/i] sont retirés du masque courant. N.B. : Les masques de signaux sont définis par thread, mais la gestion des signaux et les gestionnaires associés, tels que mis en place par [b]sigaction (2),[/b] sont partagés par tous les threads. [b]pthread_kill[/b] envoie le signal numéro [i]signo[/i] au thread [b]thread .[/b] Le signal est reçu et géré tel que décrit dans [b]kill (2).[/b] [b]sigwait[/b] suspend le thread appelant jusqu'à ce que l'un des signaux définis dans [i]set[/i] soit envoyé au thread appelant. Le numéro du signal reçu est alors sauvegardé dans l'emplacement pointé par [i]sig[/i] et la fonction rend la main. Les signaux définis dans [i]set[/i] doivent être bloqués et non ignorés lorsque l'on entre dans [b]sigwait .[/b] Si l'un des signaux reçus possède un gestionnaire de signal, cette fonction [i]n'est pas[/i] appelée. [size=18] [b]Annullation[/b] [/size] [b]sigwait[/b] est un point d'annulation. [size=18] [b]Valeur renvoyée[/b] [/size] En cas de succès, 0 est renvoyé. En cas d'échec, un code d'erreur non nul est renvoyé. [size=18] [b]Erreurs[/b] [/size] La fonction [b]pthread_sigmask[/b] renvoie l'un des codes d'erreur suivants en cas de problème :[table][row][col]    [/col][col] [b]EINVAL[/b] [i]how[/i] [table][row][col]    [/col][col]n'est ni [b]SIG_SETMASK ,[/b] ni [b]SIG_BLOCK ,[/b] ni [b]SIG_UNBLOCK[/b] [/col][/row][/table] [b]EFAULT[/b] [i]newmask[/i] [table][row][col]    [/col][col]ou [i]oldmask[/i] pointe en dehors de l'espace mémoire du processus.[/col][/row][/table] La fonction [b]pthread_kill[/b] renvoiz l'un des codes d'erreur suivants en cas de problème :[table][row][col]    [/col][col][/col][/row][/table] [b]EINVAL[/b] [i]signo[/i] [table][row][col]    [/col][col]n'est pas un masque de signaux valide. [/col][/row][/table] [b]ESRCH[/b] [table][row][col]    [/col][col]le thread [i]thread[/i] n'existe pas (par exemple, il s'est déjà achevé)[/col][/row][/table] La fonction [b]sigwait[/b] ne renvoie jamais de code d'erreur. [/col][/row][/table] [size=18] [b]Auteur[/b] [/size] Xavier Leroy <Xavier.Leroy@inria.fr> [size=18] [b]Voir aussi[/b] [/size] [b]sigprocmask (2),[/b] [b]kill (2),[/b] [b]sigaction (2),[/b] [b]sigsuspend (2).[/b] [size=18] [b]Notes[/b] [/size] Afin que [b]sigwait[/b] fonctionne de manière fiable, les signaux que l'on attend doivent être bloqués dans tous les threads, pas seulement le thread appelant, sinon les sémantiques de POSIX concernant le traitement du signal ne garantissent pas que le thread appelant [b]sigwait[/b] sera celui recevant le signal. La meilleur manière d'assurer cela est de bloquer ces signals avant de créer les threads puis de ne jamais débloquer ces signaux dans aucun de ces threads sauf en appelant [b]sigwait .[/b] [size=18] [b]Bugs[/b] [/size] La gestion des signaux dans LinuxThreads ne respecte pas celle définie par le standard POSIX. Selon le standard, un signal "asynchrone" (externe) doit être dérouté vers le processus tout entier (c'est à dire vers tous les threads le composant) mais seul l'un d'eux doit le gérer. Celui-ci peut être n'importe lequel des threads ne bloquant pas le signal. Dans LinuxThreads, chaque thread est un processus par rapport au noyau, possédant son propre PID, aussi les signaux extérieurs sont toujours envoyés vers un thread particulier. Si, par exemple, un autre thread est bloqué dans [b]sigwait[/b] sur ce signal, il ne sera pas relancé. L'implémentation de [b]sigwait[/b] par LinuxThreads installe un gestionnaire de signaux vide pour les signaux définis dans [i]set[/i] durant l'attente. Comme les gestionnaires de signaux sont partagés par tous les threads, les autres threads ne doivent pas attacher leurs propres gestionnaires sur ces signaux, mais doivent bloquer ces signaux (ce qui est de toute façon recommandé -- voir la rubrique NOTES). [size=18] [b]Traduction[/b] [/size] [i]Thierry Vignaud < tvignaud@mandrakesoft.com >, 2000[/i] [b][/b] Christophe Blaess, 2003.
Fichier