Provided by: manpages-fr-dev_4.13-4_all 
NOM
get_thread_area, set_thread_area - Manipuler les informations de la zone de stockage
locale du thread
SYNOPSIS
#include <linux/unistd.h>
#if defined __i386__ || defined __x86_64__
# include <asm/ldt.h>
int get_thread_area(struct user_desc *u_info);
int set_thread_area(struct user_desc *u_info);
#elif defined __m68k__
int get_thread_area(void);
int set_thread_area(unsigned long tp);
#elif defined __mips__
int set_thread_area(unsigned long addr);
#endif
Remarque : il n'existe pas de fonctions glibc autour de ces appels système ; consultez
NOTES.
DESCRIPTION
Ces appels fournissent la prise en charge spécifique à l'architecture de l'implémentation
d'un stockage local du thread. Pour le moment, set_thread_area() est disponible sur m68k,
MIPS et x86 (variantes 32 et 64 bits) ; get_thread_area() est disponible sur m68k et x86.
Sur m68k et MIPS, set_thread_area() permet de stocker un pointeur arbitraire (fourni dans
les paramètres tp sur m68k et addr sur MIPS) dans la structure de données du noyau
associée au thread appelant ; ce pointeur peut être récupéré ensuite en utilisant
get_thread_area() (voir aussi les NOTES pour des informations sur l'obtention du pointeur
du thread sur MIPS).
Sur x86, Linux consacre trois entrées de la GDT (Table globale de descripteurs) au
stockage local du thread. Pour plus d'informations sur la GDT, voir le manuel du
développeur logiciel d'Intel ou le manuel de programmation de l'architecture AMD.
Les deux appels système prennent un argument qui est un pointeur vers une structure du
type suivant :
struct user_desc {
unsigned int entry_number;
unsigned int base_addr;
unsigned int limit;
unsigned int seg_32bit:1;
unsigned int contents:2;
unsigned int read_exec_only:1;
unsigned int limit_in_pages:1;
unsigned int seg_not_present:1;
unsigned int useable:1;
#ifdef __x86_64__
unsigned int lm:1;
#endif
};
get_thread_area() lit l'entrée de la GDT indiquée par u_info->entry_number et remplit le
reste des champs dans u_info.
set_thread_area() définit une entrée TLS (Mémoire locale de thread) dans la GDT.
L'entrée de la table de stockage local du thread (TLS) définie par set_thread_area()
correspond à la valeur u_info->entry_number fournie par l'utilisateur. Si la valeur est
dans les limites, set_thread_area() copie le descripteur TLS pointé par u_info dans la
table TLS du thread.
Quand set_thread_area() reçoit un nombre entry_number valant -1, il cherche une entrée
libre dans la table TLS. Si set_thread_area() trouve une entrée TLS libre, la valeur de
u_info->entry_number est remplie au retour pour montrer quelle entrée a été modifiée.
Un user_desc est considéré comme « vide » si read_exec_only et seg_not_present sont
positionnés sur 1 et tous les autres champs valent 0. Si un descripteur « vide » est passé
à set_thread_area(), l'entrée TLS correspondante sera effacée. Voir BOGUES pour des
détails complémentaires.
Depuis Linux 3.19, set_thread_area() ne peut pas être utilisé pour écrire des segments non
présents, segments 16 bits ou de code, bien que le vidage d'un segment soit toujours
acceptable.
VALEUR RENVOYÉE
Sur x86, ces appels système renvoient 0 s'ils réussissent et -1 s'ils échouent, en
positionnant errno adéquatement.
Sur MIPS et m68k, set_thread_area() renvoie toujours 0. Sur m68k, get_thread_area()
renvoie la valeur du pointeur de la zone de thread (précédemment définie à l'aide de
set_thread_area()).
ERREURS
EFAULT u_info est un pointeur non valable.
EINVAL u_info->entry_number est en dehors des limites.
ENOSYS get_thread_area() ou set_thread_area() a été appelé en tant qu'appel système
64 bits.
ESRCH (set_thread_area()) Impossible de trouver une entrée TLS libre.
VERSIONS
set_thread_area() est apparue pour la première fois dans Linux 2.5.29. get_thread_area()
est apparu dans Linux 2.5.32.
CONFORMITÉ
set_thread_area() et get_thread_area() sont spécifiques à Linux et ne devraient pas être
employés dans des programmes conçus pour être portables.
NOTES
La glibc ne fournit pas de fonction autour de ces appels système, puisqu'ils ont
normalement pour seul but d'être utilisés dans les bibliothèques de threads. Au cas
improbable où vous voudriez les appeler directement, utilisez syscall(2).
arch_prctl(2) peut interférer avec set_thread_area() sur x86. Voir arch_prctl(2) pour plus
de détails. Il ne s'agit pas d'un problème en général, car arch_prctl(2) n'est en principe
utilisé que par des programmes 64 bits.
Sur MIPS, la valeur actuelle du pointeur de la zone de thread peut être récupérée en
utilisant l'instruction :
rdhwr dest, $29
Cette instruction intercepte et est prise en charge par le noyau.
BOGUES
Sur des noyaux 64 bits avant Linux 3.19, un des bits de remplissage de user_desc, s'il est
positionné, empêcherait le descripteur d'être considéré comme vide (voir modify_ldt(2)).
Il s'en suit que la seule manière fiable d'effacer une entrée TLS est d'utiliser memset(3)
pour mettre à zéro toute la structure user_desc, y compris les bits de remplissage, puis
de positionner les bits read_exec_only et seg_not_present. Sur Linux 3.19, un user_desc
consistant entièrement en zéros sauf entry_number sera aussi interprété comme une requête
pour effacer une entrée TLS, mais le comportement était différent sur les anciens noyaux.
Avant Linux 3.19, les registres de segment DS et ES ne doivent pas se référer aux entrées
TLS.
VOIR AUSSI
arch_prctl(2), modify_ldt(2), ptrace(2) (PTRACE_GET_THREAD_AREA et PTRACE_SET_THREAD_AREA)
COLOPHON
Cette page fait partie de la publication 5.10 du projet man-pages Linux. Une description
du projet et des instructions pour signaler des anomalies et la dernière version de cette
page peuvent être trouvées à l'adresse https://www.kernel.org/doc/man-pages/.
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 Jean-Philippe MENGUAL
<jpmengual@debian.org>
Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General
Public License version 3 ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ 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 à debian-l10n-french@lists.debian.org ⟨⟩.