MODIFY_LDT(2)

NOM
modify_ldt - Lire/écrire la LDT

SYNOPSIS
#include <sys/types.h>

int modify_ldt(int func, void *ptr, unsigned long bytecount);

DESCRIPTION
modify_ldt() lit ou écrit la table des descripteurs locaux (Local Descriptor Table) du processus. La LDT est une table de gestion mémoire par processus utilisée par les processeurs i386. Pour plus d'information sur cette table, se reporter au manuel Intel 386.

Quand func vaut 0, modify_ldt() lit la LDT et la place dans la mémoire pointée par ptr. Le nombre d'octets lus est le minimum entre bytecount et la vraie taille de la LDT.

Quand func vaut 1, modify_ldt() modifie une entrée de la LDT. ptr pointe sur une structure user_desc et bytecount doit être égal à la taille de cette structure. La structure user_desc est définie ainsi dans <asm/ldt.h> :
struct user_desc {
    unsigned int  entry_number;
    unsigned long 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;
};

Sous Linux 2.4 et antérieurs, cette structure s'appelait modify_ldt_ldt_s.

VALEUR RENVOYÉE
S'il réussit modify_ldt() renvoie soit le nombre d'octets lus soit 0 (écriture). En cas d'échec -1 est renvoyé et errno contient le code d'erreur.

ERREURS

EFAULT
    ptr pointe en dehors de l'espace d'adressage accessible.

EINVAL
    ptr est nul, ou func est 1 et bytecount n'est pas égal à la taille de la structure modify_ldt_ldt_s, ou func est 1 et la nouvelle entrée de LDT a des valeurs illégales.

ENOSYS
    func n'est ni 0 ni 1.

CONFORMITÉ
Cet appel système est spécifique à Linux et ne doit pas être employé dans des programmes destinés à être portables.

NOTES
La glibc ne fournit pas d'enveloppe pour cet appel système ; utilisez syscall(2) pour l'appeller.

VOIR AUSSI
vm86(2)

TRADUCTION

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