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)