NOM

       ioctl - Contrôler les périphériques

SYNOPSIS

       #include <sys/ioctl.h>

       int ioctl(int d, unsigned long requête, ...);

DESCRIPTION

       La  fonction  ioctl()  modifie le comportement des périphériques sous‐jacents des fichiers
       spéciaux. En particulier, de nombreuses caractéristiques des  fichiers  spéciaux  en  mode
       caractère  (par  exemple des terminaux) peuvent être contrôlées avec des requêtes ioctl().
       L'argument d doit être un descripteur de fichier ouvert.

       Le second argument est le code de la  requête  dépendant  du  périphérique.  Le  troisième
       argument  est  un  pointeur non typé. Il est traditionnellement défini en char *argp (ceci
       date de l'époque avant que void * soit du C valide), et sera ainsi nommé dans le reste  de
       cette page.

       Une  requête  ioctl()  encapsule  le  fait  que l'argument est un paramètre d'entrée ou de
       sortie ainsi que la taille  de  l'argument  argp  en  octets.  Les  macros  et  constantes
       symboliques décrivant les requêtes ioctl() se trouvent dans le fichier <sys/ioctl.h>.

VALEUR RENVOYÉE

       En  général,  ioctl  renvoie  0  s'il réussit, ou -1 s'il échoue. Certaines requêtes ioctl
       utilisent la valeur de retour comme paramètre de sortie, et renvoient une valeur  positive
       si  elles  réussissent  (et  -1  pour les erreurs). En cas d'échec, errno contient le code
       d'erreur.

ERREURS

       EBADF  d n'est pas un descripteur de fichier valide.

       EFAULT argp pointe en dehors de l'espace d'adressage valide.

       EINVAL La requête ou l'argument argp n'est pas valide.

       ENOTTY d n'est pas associé avec un fichier spécial en mode caractère.

       ENOTTY La requête indiquée ne s'applique pas au type d'objet associé avec  le  descripteur
              d.

CONFORMITÉ

       Pas  de  vrai standard. Les arguments, les valeurs de retour, et la sémantique des ioctl()
       varient en  fonction  du  périphérique  concerné  (cet  appel  système  est  utilisé  pour
       encapsuler les opérations qui ne se conforment pas bien au modèle UNIX des entrées/sorties
       par flux). Consultez ioctl_list(2) pour une liste des principaux appels ioctl() connus. La
       fonction ioctl() est apparue dans l'UNIX d'AT&T Version 7.

NOTES

       Pour  utiliser cet appel, on a besoin d'un descripteur de fichier ouvert. Souvent, l'appel
       open(2) a des effets de bord non désirés, qui  peuvent  être  évités  sous  Linux  en  lui
       passant le drapeau O_NONBLOCK.

VOIR AUSSI

       execve(2), fcntl(2), ioctl_list(2), open(2), sd(4), tty(4)

COLOPHON

       Cette  page  fait partie de la publication 3.65 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> ».