Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] pthread_join - attend la fin d'un autre thread [size=18] [b]Résumé[/b] [/size] [b]#include <pthread.h>[/b] [b][i]int pthread_join(pthread_t th , void ** thread_return );[/i][/b] [size=18] [b]Description[/b] [/size] [b]pthread_join[/b] suspend l'exécution du thread appelant jusqu'à ce que le thread identifié par [i]th[/i] achève son exécution, soit en appelant [b]pthread_exit (3)[/b] soit après avoir été annulé. Si [i]thread_return[/i] ne vaut pas [b]NULL ,[/b] la valeur renvoyée par [i]th[/i] y sera enregistrée. Cette valeur sera soit l'argument passé à [b]pthread_exit (3),[/b] soit [b]PTHREAD_CANCELED[/b] si le thread [i]th[/i] a été annulé. Le thread rejoint [b]th[/b] doit être dans l'état joignable : il ne doit pas avoir été détaché par [b]pthread_detach (3)[/b] ou par l'attribut [b]PTHREAD_CREATE_DETACHED[/b] lors de sa création par [b]pthread_create (3).[/b] Quand l'exécution d'un thread joignable s'achève, ses ressources mémoire (descripteur de thread et pile) ne sont pas désallouées jusqu'à ce qu'un autre thread le joigne en utilisant [b]pthread_join[/b]. Aussi, [b]pthread_join[/b] doit être appelée une fois pour chaque thread joignable pour éviter des "fuites" de mémoire. Au plus un seul thread peut attendre la mort d'un thread donné. Appeler [b]pthread_join[/b] sur un thread [i]th[/i] dont un autre thread attend déjà la fin renvoie une erreur. [size=18] [b]Annulation[/b] [/size] [b]pthread_join[/b] est un point d'annulation. Si un thread est annulé alors qu'il est suspendu dans [b]pthread_join ,[/b] l'exécution du thread reprend immédiatement et l'annulation est réalisée sans attendre la fin du thread [i]th[/i]. Si l'annulation intervient durant [b]pthread_join ,[/b] le thread [i]th[/i] demeure non joint. [size=18] [b]Valeur renvoyée[/b] [/size] En cas de succès, le code renvoyé par [i]th[/i] est enregistré à l'emplacement pointé par [b]thread_return ,[/b] et 0 est renvoyé. En cas d'erreur, un code d'erreur non nul est renvoyé. [size=18] [b]Erreurs[/b] [/size] [b]ESRCH[/b] [table][row][col]    [/col][col]Aucun thread correspondant à [b]th[/b] n' a pu être trouvé.[/col][/row][/table] [b]EINVAL[/b] [table][row][col]    [/col][col]Le thread [i]th[/i] a été détaché.[/col][/row][/table] [b]EINVAL[/b] [table][row][col]    [/col][col]Un autre thread attend déjà la mort de [b]th .[/b][/col][/row][/table] [b]EDEADLK[/b] [table][row][col]    [/col][col]L'argument [i]th[/i] représente le thread appelant. [/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_detach (3),[/b] [b]pthread_create (3),[/b] [b]pthread_attr_setdetachstate (3),[/b] [b]pthread_cleanup_push (3),[/b] [b]pthread_key_create (3).[/b] [size=18] [b]Traduction[/b] [/size] [i]Thierry Vignaud < tvignaud@mandrakesoft.com >, 2000[/i]
Fichier