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