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

       Pour  chaque  processus, Le noyau maintient deux attributs (adresses) nommés set_child_tid
       et clear_child_tid. Ces deux attributs contiennent la valeur NULL 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 définie à la valeur passée à l'argument ctid
              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 définie à la valeur passée  à  l'argument
              ctid de cet appel système.

       L'appel  système  set_tid_address()  remplit  la  valeur clear_child_tid pour le processus
       appelant à tidptr.

       Lorsqu'un processus dont clear_child_tid n'est pas NULL se termine, alors, si le processus
       partage de la mémoire avec d'autres processus ou threads, 0 est écrit à l'adresse indiquée
       dans clear_child_tid et le noyau réalise l'opération suivante :

           futex(clear_child_tid, FUTEX_WAKE, 1, NULL, NULL, 0);

       L'effet de cette opération est de réveiller un simple processus qui  réalise  une  attente
       futex  à  l'emplacement  de la mémoire. Les erreurs de l'opération de réveil du futex 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)

COLOPHON

       Cette  page  fait partie de la publication 3.57 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/>.

       Alain   Portal   <http://manpagesfr.free.fr/> (2004-2006).   Julien  Cristau  et  l'équipe
       francophone de traduction de Debian (2006-2009).

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