pthread_detach

Section: C Library Functions (3)
Updated: 15 décembre 2022
Index Return to Main Contents
 

NOM

pthread_detach - Détacher un thread  

BIBLIOTHÈQUE

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

SYNOPSIS

#include <pthread.h>

int pthread_detach(pthread_t thread);
 

DESCRIPTION

La fonction pthread_detach() marque l'identifiant de thread identifié par thread comme détaché. Quand un thread détaché se termine, ses ressources sont automatiquement rendues au système sans avoir besoin d'un autre thread pour joindre le thread terminé.

Essayer de détacher un thread qui est déjà détaché résulte en un comportement indéfini.  

VALEUR RENVOYÉE

En cas de réussite, pthread_detach() renvoie 0 ; en cas d'erreur, elle renvoie un numéro d'erreur.  

ERREURS

EINVAL
thread n'est pas un thread joignable.
ESRCH
Aucun fil d’exécution avec pour identifiant thread n'a pu être trouvé.
 

ATTRIBUTS

Pour une explication des termes utilisés dans cette section, consulter attributes(7).
InterfaceAttributValeur
pthread_detach() Sécurité des threadsMT-Safe

 

STANDARDS

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

NOTES

Une fois qu'un thread est détaché, il ne peut plus être joint avec pthread_join(3) ou être fait de nouveau joignable.

Un nouveau thread peut être créé dans un état détaché en utilisant pthread_attr_setdetachstate(3) pour positionner l'attribut détaché de l'argument attr de pthread_create(3).

L'attribut d'état de détachement détermine principalement le comportement du système quand le thread se termine. Il n'empêche pas le thread de terminer si le processus se termine avec exit(3) (ou, de manière équivalente, si le thread principal sort de sa routine d'appel).

Soit pthread_join(3), soit pthread_detach() devrait être appelé pour chaque thread créé par une application, afin que les ressources système du thread puissent être libérées. Notez cependant que les ressources de tous les threads pour lesquels une de ces actions n'a pas été réalisée sont libérées quand le processus se termine.  

EXEMPLES

L'expression suivante détache le thread appelant :

pthread_detach(pthread_self());  

VOIR AUSSI

pthread_attr_setdetachstate(3), pthread_cancel(3), pthread_create(3), pthread_exit(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 <tvignaud@mandriva.com>, François Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe Guérard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas Huriaux <thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centraliens.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 <fhantrais@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 à


 

Index

NOM
BIBLIOTHÈQUE
SYNOPSIS
DESCRIPTION
VALEUR RENVOYÉE
ERREURS
ATTRIBUTS
STANDARDS
NOTES
EXEMPLES
VOIR AUSSI
TRADUCTION

This document was created by man2html, using the manual pages.
Time: 13:43:42 GMT, May 22, 2024