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