IOCTL(2)

BEZEICHNUNG
ioctl - steuere device

ÜBERSICHT
#include <sys/ioctl.h>

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

[Das "dritte" Argument ist traditionsgemäß char *argp, und wird so bezeichnet in diesem Dokument.]

BESCHREIBUNG
Die Funktion ioctl manipuliert zugrundeliegenden Device-Parameter einer Spezialdatei. Im besonderen können viele Betriebscharakteristika von zeichenorientierten Spezialdateien (z.B. Terminals) durch ioctl-Aufrufe gesteuert werden. Das Argument d muß ein geöffneter Dateiderkriptor sein. In einer ioctl- request ist festgelegt ob das Argument ein in - oder out -Parameter ist, und die Größe des Argumentes argp in Byte. Makros und Definitionen, die in der Spezifikation eines ioctl request benutzt werden, sind zu finden in <sys/ioctl.h>.

RÜCKGABEWERT
Bei Erfolg wird Null zurückgegeben. Im Fehlerfall wird -1 zurückgegeben und errno entsprechend gesetzt.

FEHLER

EBADF
    d ist kein gültiger Deskriptor.

ENOTTY
    d ist nicht mit einer zeichenorientierten Spezialdatei verbunden.

ENOTTY
    Die angegebene Anforderung passt nicht zu der Art der Änderung, auf die sich der Deskriptor d bezieht.

EINVAL
    Request oder argp ist nicht gültig.

GESCHICHTE
Eine Funktion ioctl erschien in Version 7 AT&T UNIX.

SIEHE AUCH
execve(2), fcntl(2), mt(4), sd(4), tty(4)