iopl

Autres langues

Langue: fr

Version: 27 mai 2004 (fedora - 16/08/07)

Section: 2 (Appels système)

NOM

iopl - Modifier le niveau de privilège d'entrée-sortie.

SYNOPSIS


#include <sys/io.h>

int iopl(int level);

DESCRIPTION

iopl() change le niveau de privilège pour les entrées-sorties du processus courant, en utilisant la valeur spécifiée dans level.

Cette fonction est indispensable pour permettre aux serveurs X compatibles 8514 de fonctionner sous Linux. Comme ces serveurs X ont besoin de l'accès aux 65536 ports d'entrée-sortie, la fonction ioperm() ne serait pas suffisante.

En plus de disposer d'un accès illimité aux ports d'entree-sortie, un processus tournant à un niveau de privilège élevé pourra également inhiber les interruptions. Ceci risque d'engendrer un plantage du système, et est fortement déconseillé.

Les permissions sont héritées aussi bien par fork() que par exec().

Le niveau de privilège d'entrée-sortie pour un utilisateur normal vaut 0.

VALEUR RENVOYÉE

iopl() renvoie 0 s'il réussit, ou -1 s'il échoue, auquel cas errno contient le code d'erreur.

ERREURS

EINVAL
level est plus grand que 3.
ENOSYS
Cet appel n'est pas implémenté.
EPERM
Le processus appelant n'a pas les privilèges suffisant pour appeler iopl() ; la capacité CAP_SYS_RAWIO est nécessaire.

CONFORMITÉ

iopl() est spécifique à Linux et ne doit pas être utilisé dans des programmes conçus pour être portables.

NOTES

Libc5 considère qu'il s'agit d'un appel système et fournit le prototype dans <unistd.h>. glibc1 n'offre pas de prototype. glibc2 fournit un prototype à la fois dans <sys/io.h> et dans <sys/perm.h>. Évitez ce dernier, il n'est disponible que sur les i386.

VOIR AUSSI

ioperm(2), capabilities(7)

TRADUCTION

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 10 octobre 1996 et révisée le 10 juillet 2006.

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=en man 2 iopl ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.