NOM

       pthread_exit - Terminer le thread appelant

BIBLIOTHÈQUE

       Bibliothèque de threads POSIX (libpthread, -lpthread)

SYNOPSIS

       #include <pthread.h>

       [[noreturn]] void pthread_exit(void *retval);

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.

ATTRIBUTS

       Pour une explication des termes utilisés dans cette section, consulter attributes(7).
       ┌──────────────────────────────────────────────────────────────────────┬──────────────────────┬─────────┐
       │ Interface                                                            │ Attribut             │ Valeur  │
       ├──────────────────────────────────────────────────────────────────────┼──────────────────────┼─────────┤
       │ pthread_kill()                                                       │ Sécurité des threads │ MT-Safe │
       └──────────────────────────────────────────────────────────────────────┴──────────────────────┴─────────┘

STANDARDS

       POSIX.1-2001, POSIX.1-2008.

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 conte‐
       nu 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)

TRADUCTION

       La   traduction   française   de   cette   page   de   manuel   a   été   créée   par  Christophe  Blaess
       <https://www.blaess.fr/christophe/>, Stéphan Rafin  <stephan.rafin@laposte.net>,  Thierry  Vignaud  <tvi‐
       gnaud@mandriva.com>,  François  Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe Guérard <fe‐
       vrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-luc.coulon@wanadoo.fr>, Julien Cristau  <jcristau@de‐
       bian.org>,   Thomas   Huriaux   <thomas.huriaux@gmail.com>,  Nicolas  François  <nicolas.francois@centra‐
       liens.net>, Florentin Duneau <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-bretagne.fr>,
       Denis  Barbier  <barbier@debian.org>,  David  Prévot  <david@tilapin.org>  et  Frédéric  Hantrais  <fhan‐
       trais@gmail.com>

       Cette  traduction  est  une  documentation libre ; veuillez vous reporter à la GNU General Public License
       version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

       Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à  de‐
       bian-l10n-french@lists.debian.org.

Pages du manuel de Linux 6.03                   15 décembre 2022                                 pthread_exit(3)