NOM

       pthread_exit - Terminer le thread appelant

SYNOPSIS

       #include <pthread.h>

       void pthread_exit(void *retval);

       Compilez et effectuez l'édition des liens avec l'option -pthread.

DESCRIPTION

       La  fonction  pthread_exit() termine le thread appelant et renvoie une valeur à travers retval qui, si le
       thread est joignable, est rendue disponible à un  autre  thread  dans  le  même  processus  s'il  appelle
       pthread_join(3).

       Tous  les  gestionnaires  de  nettoyage  ajoutés  par pthread_cleanup_push(3) \m qui n'ont pas encore été
       dépilés \m  sont dépilés (dans l'ordre inverse dans lequel ils ont été empilés) et exécutés. Si le thread
       contient  des données spécifiques au thread, alors les destructeurs de ces données sont appelées, dans un
       ordre indéfini, une fois que tous les gestionnaires de nettoyage ont été exécutés.

       Quand un thread se  termine,  les  ressources  partagées  au  niveau  du  processus  (comme  les  verrous
       mutuellement  exclusifs,  des  variables de condition, des sémaphores et des descripteurs de fichiers) ne
       sont pas libérées, et les fonctions enregistrées avec atexit(3)  ne sont pas appelées.

       Quand le dernier thread d'un processus se termine, le processus s'arrête en  appelant  exit(3)  avec  une
       valeur  de  sortie  de zéro. Ainsi, les ressources partagées au niveau du processus sont libérées, et les
       fonctions enregistrées avec atexit(3)  sont appelées.

VALEUR RENVOYÉE

       Cette fonction ne retourne jamais vers l'appelant.

ERREURS

       Cette fonction réussit toujours.

CONFORMITÉ

       POSIX.1-2001.

NOTES

       Tout thread autre que le thread principal qui sort de la fonction initiale entraîne un appel implicite  à
       pthread_exit(), en utilisant la valeur de retour de la fonction comme état de sortie du thread.

       Afin de permettre aux autres threads de continuer l'exécution, le thread principal devrait se terminer en
       appelant pthread_exit()  plutôt que exit(3).

       La valeur pointée par retval ne devrait pas être placée sur  la  pile  du  thread  appelant,  puisque  le
       contenu de cette pile devient indéfini quand le thread se termine.

BOGUES

       Il y a actuellement des limitations dans la logique d'implémentation du noyau si on attend (avec wait(2))
       un groupe de thread dont le chef de groupe a terminé. Cela peut entraîner des problèmes comme un terminal
       bloqué  si le signal d'arrêt est envoyé à un processus en avant-plan dont le thread chef de groupe a déjà
       appelé pthread_exit().

VOIR AUSSI

       pthread_create(3), pthread_join(3), pthreads(7)

COLOPHON

       Cette page fait partie de la publication 3.57 du projet man-pages Linux. Une description du projet et des
       instructions     pour     signaler     des     anomalies    peuvent    être    trouvées    à    l'adresse
       http://www.kernel.org/doc/man-pages/.

TRADUCTION

       Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a <http://po4a.alioth.debian.org/> par
       l'équipe de traduction francophone au sein du projet perkamon <http://perkamon.alioth.debian.org/>.

       Denis Barbier (2010).

       Veuillez  signaler  toute erreur de traduction en écrivant à <debian-l10n-french@lists.debian.org> ou par
       un rapport de bogue sur le paquet manpages-fr.

       Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « man -L C
       <section> <page_de_man> ».