NOM

       ioperm - Positionner les autorisations d'entrée-sortie sur les ports

SYNOPSIS

       #include <unistd.h> /* pour libc5 */
       #include <sys/io.h> /* pour glibc */

       int ioperm(unsigned long from, unsigned long num, int turn_on);

DESCRIPTION

       ioperm() positionne les bits de permission d'accès du thread appelant aux ports commençant
       à l'adresse from étalés sur  num  bits.  Si  turn_on  n'est  pas  nul,  les  autorisations
       correspondantes  aux  bits  indiqués  sont activées, sinon désactivées. Si turn_on est non
       nul, le thread appelant doit être privilégié (CAP_SYS_RAWIO).

       Avant Linux 2.6.8, seuls les 0x3ff premiers ports d'entrée-sortie pouvaient être  indiqués
       de  cette  manière. Pour d'autres ports, il fallait utiliser l'appel système iopl(2) (avec
       un paramètre level de 3). Depuis Linux 2.6.8, 65 536 ports  d'entrée-sortie  peuvent  être
       indiqués.

       Les  permissions ne sont pas héritées par le processus fils durant un fork(2) : le process
       fils doit activer les permissions dont il en a besoin. En revanche,  elles  le  sont  lors
       d'un  execve(2).  Ceci  permet  de  donner  des autorisations d'accès à des programmes non
       privilégiés.

       Cet  appel  existe  principalement  pour  l'architecture  i386.  Sur   beaucoup   d'autres
       architectures, il est soit inexistant soit renvoie toujours une erreur.

VALEUR RENVOYÉE

       S'il  réussit, cet appel système renvoie 0. S'il échoue, il renvoie -1 et remplit errno en
       conséquence.

ERREURS

       EINVAL Valeur invalide pour from ou num.

       EIO    (sur PowerPC) Cet appel n'est pas supporté.

       ENOMEM Plus de mémoire disponible.

       EPERM  L'appelant n'a pas les privilèges nécessaires.

CONFORMITÉ

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

NOTES

       Le  fichier  /proc/ioports  indique  les ports d'entrée-sortie actuellement alloués sur le
       système.

       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

       iopl(2), outb(2), capabilities(7)

COLOPHON

       Cette page fait partie de la publication 3.57 du projet man-pages Linux.  Une  description
       du  projet  et  des  instructions  pour  signaler  des  anomalies  peuvent être trouvées à
       l'adresse http://www.kernel.org/doc/man-pages/.

TRADUCTION

       Depuis   2010,   cette   traduction   est   maintenue   à   l'aide   de    l'outil    po4a
       <http://po4a.alioth.debian.org/>  par l'équipe de traduction francophone au sein du projet
       perkamon <http://perkamon.alioth.debian.org/>.

       Christophe   Blaess   <http://www.blaess.fr/christophe/>   (1996-2003),    Alain    Portal
       <http://manpagesfr.free.fr/>  (2003-2006).  Julien  Cristau  et  l'équipe  francophone  de
       traduction de Debian (2006-2009).

       Veuillez     signaler     toute     erreur     de     traduction     en     écrivant     à
       <debian-l10n-french@lists.debian.org>   ou   par   un  rapport  de  bogue  sur  le  paquet
       manpages-fr.

       Vous pouvez toujours avoir accès à la version anglaise de  ce  document  en  utilisant  la
       commande « man -L C <section> <page_de_man> ».