Changes between Initial Version and Version 1 of pthread_join

Timestamp:

Jul 10, 2007, 11:57:59 PM (17 years ago)

Author:

Ghassan Almaless

Comment:

--

pthread_join

@@ +1 @@
+= Nom =
+pthread_join - attend la mort d'un autre thread 
+
+= Synopsis =
+#include <pthread.h>[[BR]]
+int pthread_join(pthread_t th, void **thread_return); 
+
+= Description =
+pthread_join suspend l'exécution du thread appelant jusqu'à ce que le thread identifié par th achève son exécution, soit en appelant pthread_exit soit en arrivant simplement vers la fin de sa fonction en exécutant l’instruction return.
+
+
+Si thread_return ne vaut pas NULL, la valeur renvoyée par th y sera enregistrée. Cette valeur sera l'argument passé à pthread_exit.
+
+ 
+Quand l'exécution d'un thread joignable s'achève, ses ressources mémoires (descripteur de thread et pile) ne sont pas désallouées jusqu'à ce qu'un autre thread le joigne en utilisant pthread_join. Aussi, pthread_join 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 pthread_join sur un thread th dont un autre thread attend déjà la fin renvoie une erreur.
+
+
+MUTEKP ne gère pas, pour l’instant, ni l’annulation des threads ni le détachement d’un thread. Ainsi tout thread est crée dans l’état joignable. En fin, MUTEKP fourni une gestion mémoire minimaliste, par conséquence, l’appel pthread_join n’a pas un caractère obligatoire.   
+
+= Valeur Renvoyée =
+En cas de succès, le code renvoyé par th est enregistré à l'emplacement pointé par thread_return, et 0 est renvoyé. En cas d'erreur, un code d'erreur non nul est renvoyé. 
+
+= Erreurs =
+ESRCH: Aucun thread correspondant à th n' a pu être trouvé.[[BR]]
+EINVAL: Le thread th a été détaché.[[BR]]
+EINVAL: Un autre thread attend déjà la mort de th.[[BR]]
+EDEADLK: L'argument th représente le thread appelant. 
+
+= Auteur =
+Xavier Leroy <Xavier.Leroy@inria.fr> 
+
+= Traduction =
+Thierry Vignaud <tvignaud@mandrakesoft.com>, 2000 
+
+= Adaptation MUTEKP =
+Ghassan Almaless <Ghassan.Almalass@asim.lip6.fr>, <ghassan.almaless@gmail.com>, 2007
+
+= Voir Aussi =
+[wiki:pthread_exit], [wiki:pthread_create].