SET_TID_ADDRESS
Section : Manuel du programmeur Linux (
2)
Mise à jour de la version anglaise : 10 septembre 2004
Index
Menu principal
NOM
set_tid_address - Positionner un pointeur vers un identifiant de thread (TID)
SYNOPSIS
#include <linux/unistd.h>
long set_tid_address(int *tidptr);
DESCRIPTION
Le noyau conserve, pour chaque processus, deux valeurs nommées
set_child_tid
et
clear_child_tid
qui sont nulles par défaut.
set_child_tid
Si un processus est démarré en utilisant
clone(2)
avec l'attribut
CLONE_CHILD_SETTID,
set_child_tid
est remplie avec
child_tidptr,
le cinquième paramètre de cet appel système.
Lorsque
set_child_tid
est remplie, la toute première chose que le nouveau processus fait est
d'écrire son PID à cette adresse.
clear_child_tid
Si un processus est démarré en utilisant
clone(2)
avec l'attribut
CLONE_CHILD_CLEARTID,
clear_child_tid
est remplie avec
child_tidptr,
le cinquième paramètre de cet appel système.
L'appel système
set_tid_address()
remplit la valeur
clear_child_tid
pour le processus appelant à
tidptr.
Lorsque
clear_child_tid
est remplie, que le processus finit et qu'il avait de la mémoire partagée
avec d'autres processus ou threads, 0 est écrit à cette adresse
et un appel à
futex(child_tidptr, FUTEX_WAKE, 1, NULL, NULL, 0);
est réalisé
(c'est-à-dire, que l'un des processus bloqué sur ce futex est réveillé).
Les erreurs sont ignorées
VALEUR RENVOYÉE
set_tid_address()
renvoie toujours le PID du processus appelant.
ERREURS
set_tid_address()
réussit toujours.
VERSIONS
Cet appel est présent depuis Linux 2.5.48.
Les détails fournis ici sont valides depuis Linux 2.5.49.
CONFORMITÉ
Cet appel système est spécifique à Linux.
VOIR AUSSI
clone(2),
futex(2)
TRADUCTION
Ce document est une traduction réalisée par Alain Portal
<aportal AT univ-montp2 DOT fr> le 9 mai 2006
et révisée le 23 juin 2008.
L'équipe de traduction a fait le maximum pour réaliser une adaptation
française de qualité. La version anglaise la plus à jour de ce document est
toujours consultable via la commande : « LANG=C man 2 set_tid_address ».
N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute
erreur dans cette page de manuel.
Index
- NOM
-
- SYNOPSIS
-
- DESCRIPTION
-
- set_child_tid
-
- clear_child_tid
-
- VALEUR RENVOYÉE
-
- ERREURS
-
- VERSIONS
-
- CONFORMITÉ
-
- VOIR AUSSI
-
- TRADUCTION
-
Dernière mise à jour : 23 juin 2008