int pthread_join(pthread_t th, void **thread_return);  

Si thread_return ne vaut pas NULL, la valeur renvoyée par th y sera enregistrée. Cette valeur sera soit l'argument passé à pthread_exit(3), soit PTHREAD_CANCELED si le thread th a été annulé.

Le thread rejoint th doit être dans l'état joignable : il ne doit pas avoir été détaché par pthread_detach(3) ou par l'attribut PTHREAD_CREATE_DETACHED lors de sa création par pthread_create(3).

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 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.  

ESRCH

Aucun thread correspondant à th n'a pu être trouvé.

EINVAL

Le thread th a été détaché.

EINVAL

Un autre thread attend déjà la mort de th.

EDEADLK

L'argument th représente le thread appelant.

Ce document est une traduction réalisée par Thierry Vignaud <tvignaud AT mandriva DOT com> en 2000 et révisée le 19 novembre 2007.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 3 pthread_join ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.

NOM

SYNOPSIS

DESCRIPTION

ANNULATION

VALEUR RENVOYÉE

ERREURS

AUTEUR

VOIR AUSSI

TRADUCTION