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

#include <sys/io.h>

int iopl(int level);

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.

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

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.

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

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.

ioperm(2), capabilities(7)

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.