NOMBRE

       ioctl - controlar dispositivo

SINOPSIS

       #include <sys/ioctl.h>

       int ioctl(int d, int request, ...);

DESCRIPCIÓN

       La   función  ioctl  manipula  los  parámetros  subyacentes  de  ficheros  especiales.  En
       particular, muchas características operacionales de los ficheros especiales de  caracteres
       (verbigracia las terminales) pueden controlarse con llamadas a ioctl.  El argumento d debe
       ser un descriptor de fichero abierto.

       El segundo argumento es un código de solicitud que depende  del  dispositivo.   El  tercer
       argumento es un puntero a memoria sin tipo. Es tradicionalmente char *argp (desde los días
       antes de que void * se considerara  código  C  válido),  y  así  se  le  llamará  en  este
       documento.

       Una  peticion  de  ioctl  tiene  codificada en sí misma si el argumento es un parámetro de
       entrada o de salida, y el tamaño del argumento argp en bytes.  En el fichero  de  cabecera
       <sys/ioctl.h> se definen macros empleadas al especificar una peticion de ioctl.

VALOR DEVUELTO

       Normalmente,  se  devuelve  cero  en  caso  de  éxito.  Unos pocos ioctls usan el valor de
       retorno como un parámetro de salida y devuelven un valor no negativo en caso de éxito.  En
       caso de error, se devuelve -1, y se pone en errno un valor apropiado.

ERRORES

       EBADF  d no es un descriptor válido.

       EFAULT argp referencia a una zona de memoria inaccesible.

       ENOTTY d no está asociado con un dispositivo especial de caracteres.

       ENOTTY La  petición  especificada  no  se  aplica  a  la clase de objeto que referencia el
              descriptor d.

       EINVAL Peticion o argp no es válido.

CONFORME A

       Ningún estándar en particular. Los argumentos, valores devueltos y semántica  de  ioctl(2)
       varían  según  el  controlador  de  dispositivo  en  cuestión  (la  llamada se usa como un
       recogedor para las operaciones que no encajen claramente en el modelo de flujos de E/S  de
       Unix).  Vea  ioctl_list(2) para una lista de muchas de las llamadas conocidas a ioctl.  La
       función ioctl apareció por primera vez en Unix de AT&T Versión 7.

VÉASE TAMBIÉN

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