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