NOM

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

BIBLIOTHÈQUE

Bibliothèque C standard ( libc, -lc)

SYNOPSIS

#include <sys/io.h>
[[obsolète]] int iopl(int level);

DESCRIPTION

iopl() modifie le niveau de droits pour les E/S du thread appelant, en utilisant les deux bits de poids faible indiqués dans level.
Le niveau de privilège d'E/S pour un thread normal vaut 0. Les droits sont hérités des parents par les enfants.
Cet appel est obsolète, il est significativement plus lent que ioperm(2) et il n'est fourni que pour d'anciens serveurs X qui doivent accéder aux 65536 ports d'E/S. Il existe principalement pour l'architecture i386. Sur beaucoup d'autres architectures, il est, soit inexistant, soit renvoie toujours une erreur.

VALEUR RENVOYÉE

En cas de succès, zéro est renvoyé. En cas d'erreur, -1 est renvoyé et errno est définie pour préciser l'erreur.

ERREURS

EINVAL
level est plus grand que 3.
ENOSYS
Cet appel n'est pas implémenté.
EPERM
Le thread appelant n'a pas assez de droits pour appeler iopl() ; la capacité CAP_SYS_RAWIO est nécessaire pour augmenter le niveau de droits d'E/S de sa valeur actuelle.

STANDARDS

iopl() est spécifique à Linux et ne doit pas être utilisé dans des programmes destinés à être portables.

NOTES

La 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.
Avant Linux 5.5, iopl() permettait au thread de désactiver les interruptions tout en s'exécutant à un niveau de droits E/S supérieur. Cela fera probablement planter le système et n'est pas recommandé.
Avant Linux 3.7, sur certaines architectures (telles que i386), les droits étaient récupérés par l'enfant créé avec fork(2) et préservés pendant un execve(2). Ce comportement a été modifié par inadvertance dans Linux 3.7 et il ne sera pas rétabli.

VOIR AUSSI

ioperm(2), outb(2), capabilities(7)

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 <[email protected]>, Thierry Vignaud <[email protected]>, François Micaux, Alain Portal <[email protected]>, Jean-Philippe Guérard <[email protected]>, Jean-Luc Coulon (f5ibh) <[email protected]>, Julien Cristau <[email protected]>, Thomas Huriaux <[email protected]>, Nicolas François <[email protected]>, Florentin Duneau <[email protected]>, Simon Paillard <[email protected]>, Denis Barbier <[email protected]>, David Prévot <[email protected]>, Cédric Boutillier <[email protected]>, Frédéric Hantrais <[email protected]> et Jean-Philippe MENGUAL <[email protected]>
Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 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 à [email protected]

Recommended readings

Pages related to iopl you should read also: