PTHREAD_ATTR_SETDETACHSTATE

Manuel du programmeur Linux (3)
14 avril 2014

NOM

pthread_attr_setdetachstate, pthread_attr_getdetachstate - Définir ou obtenir l'attribut de l'état de détachement de l'objet d'attributs de thread

SYNOPSIS

#include <pthread.h>

int pthread_attr_setdetachstate(pthread_attr_t *attr, int detachstate);
int pthread_attr_getdetachstate(pthread_attr_t *attr, int *detachstate);

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

DESCRIPTION

La fonction pthread_attr_setdetachstate() définit l'attribut d'état de détachement de l'objet d'attributs de thread auquel attr fait référence à la valeur indiquée par detachstate. Cet attribut d'état de détachemennt détermine si un thread créé en utilisant l'objet d'attributs de thread attr sera dans un état joignable ou détaché.

Les valeurs suivantes peuvent être spécifiées dans detachstate :

PTHREAD_CREATE_DETACHED: Les threads créés avec attr seront dans un état détaché.
PTHREAD_CREATE_JOINABLE: Les threads créés avec attr seront dans un état joignable.

Par défaut, l'attribut d'état de détachement est initialisé à PTHREAD_CREATE_JOINABLE dans un objet d'attributs de thread.

La fonction pthread_attr_getdetachstate() renvoie, dans le tampon pointé par detachstate, l'attribut contenant l'état de détachement de l'objet d'attributs de thread attr.

VALEUR RENVOYÉE

En cas de réussite, ces fonctions renvoient 0 ; en cas d'erreur elles renvoient un numéro d'erreur non nul.

ERREURS

pthread_attr_setdetachstate() peut échouer avec l'erreur suivante :

EINVAL: Une valeur invalide a été spécifiée dans detachstate.

ATTRIBUTS

Multithreading (voir pthreads(7))

Les fonctions pthread_attr_setdetachstate() et pthread_attr_getdetachstate() sont sûres dans un contexte multithread.

CONFORMITÉ

POSIX.1-2001.

NOTES

Consultez pthread_create(3) pour plus de détails sur les threads joignables et détachés.

Un thread qui est créé dans un état joignable devrait à la fin soit être joint avec pthread_join(3), soit être détaché avec pthread_detach(3) ; consultez pthread_create(3).

C'est une erreur de spécifier, lors d'un appel ultérieur à pthread_detach(3) ou pthread_join(3), comme identifiant de thread un thread qui a été créé dans un état détaché.

EXEMPLE

Consultez pthread_attr_init(3).

VOIR AUSSI

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

COLOPHON

Cette page fait partie de la publication 3.66 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 à <perkamon-fr@traduc.org>.

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

Index

Multithreading (voir pthreads(7))

This document was created by man2html, using the manual pages.
Time: 21:52:40 GMT, July 12, 2014