ARCH_PRCTL(2)

NOM
arch_prctl - Fixer l'état spécifique à l'architecture

SYNOPSIS
#include <asm/prctl.h>
#include <sys/prctl.h>

int arch_prctl(int code, unsigned long addr)
int arch_prctl(int code, unsigned long *addr);

DESCRIPTION
La fonction arch_prctl() fixe l'état spécifique à l'architecture pour le thread ou le processus. code sélectionne une sous-fonction et lui passe l'argument addr ; addr est interprété soit comme un unsigned long pour les opérations de définitions (« set»), soit comme un unsigned long *, pour les opérations de lecture (« get»).

Les sous-fonctions pour l'architecture x86-64 sont :

ARCH_SET_FS
    Remplit la base 64 bits pour le registre FS avec addr.

ARCH_GET_FS
    Renvoie la base 64 bits pour le registre FS du thread en cours dans la variable unsigned long pointée par addr.

ARCH_SET_GS
    Remplit la base 64 bits pour le registre GS avec addr.

ARCH_GET_GS
    Renvoie la base 64 bits pour le registre GS du thread en cours dans la variable unsigned long pointée par addr.

VALEUR RENVOYÉE
S'il réussit, arch_prctl() renvoie 0 ; en cas d'erreur, -1 est renvoyée errno contient le code d'erreur.

ERREURS

EFAULT
    addr pointe vers une adresse non affectée ou est en dehors de l'espace d'adressage.

EINVAL
    code n'est pas une sous-commande valide.

EPERM
    addr pointe en dehors de l'espace d'adressage du processus.

CONFORMITÉ
arch_prctl() est une extension Linux/x86-64 et ne doit pas être employée dans un programme conçu pour être portable.

NOTES
arch_prctl() n'est pris en charge sur Linux/x86-64 que pour les programmes 64 bits. La base 64 bits change lorsqu'un nouveau sélecteur de segment 32 bits est chargé. ARCH_SET_GS est inactif dans certains noyaux. Les changements de contexte pour les bases 64 bits sont assez coûteux. Il peut être plus rapide de fixer une base 32 bits avec un sélecteur de segment en fixant une LDT avec modify_ldt(2) ou en utilisant l'appel système set_thread_area(2) des noyaux 2.5 et suivants. arch_prctl() n'est utile que si vous désirez fixer des bases plus grandes que 4Go. La mémoire dans les premiers 2 Go d'adressage peut être allouée en utilisant mmap(2) avec l'attribut. MAP_32BIT. Il n'y a pas de prototype pour arch_prctl() dans la glibc 2.7. Vous devez le déclarer vous-même. Ceci sera peut-être corrigé dans les futures versions de la glibc. FS peut être déjà utilisé par la bibliothèque de multithreading.

VOIR AUSSI
mmap(2), modify_ldt(2), prctl(2), set_thread_area(2)

Manuel du programmeur AMD X86-64

TRADUCTION

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 18 juillet 2003 et révisée le 17 juillet 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 arch_prctl ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.