IOCTL(2)
НАЗВАНИЕ
ioctl - управление устройствами
СИНТАКСИС
ioctl (fildes, command, arg)
int fildes, command;
ОПИСАНИЕ
Системный вызов ioctl выполняет различные управляющие
действия над обычными устройствами и псевдоустройствами. Для файлов, не являющихся псевдоустройствами, действия, которые выполняет этот системный вызов, зависят
от устройства. Аргументы command и arg передаются в
файл, ассоциированный с дескриптором fildes, и интерпретируются драйвером устройства. Подобный способ управления для обычных устройств используется редко; основные операции ввода/вывода выполняются с помощью системных вызовов read(2) и write(2).
Действия над псевдоустройствами, выполняемые с помощью
системного вызова ioctl, описаны в streamio(7).
Аргумент fildes - это открытый дескриптор файла, являющегося устройством. Аргумент command задает выполняемые
действия и зависит от устройства, с которым ведется работа. Наконец, arg задает дополнительную информацию,
которая может потребоваться для выполнения указанных
действий. Тип аргумента arg зависит от конкретного управляющего действия и является либо целым, либо указателем на специфичную для устройства структуру.
Отметим, что существуют некоторые общие действия, которые выполняются драйверами различных устройств, например общий интерфейс с терминалом [см. termio(7)].
Системный вызов ioctl завершается неудачей для файлов
любого типа, если выполнено хотя бы одно из следующих
условий:
- [EBADF]
- Аргумент fildes не является корректным
дескриптором открытого файла.
- [ENOTTY]
- Аргумент fildes не связан с устройством,
драйвер которого отрабатывает управляющие
функции.
- [EINTR]
- Во время выполнения системного вызова перехвачен сигнал.
Системный вызов ioctl также завершается неудачей, если
драйвер устройства обнаружит ошибку. В этом случае
ошибка возвращается системным вызовом без изменений.
Конкретный драйвер может вырабатывать не все ошибки из
перечисленных ниже:
- [EFAULT]
- Действие command требует обмена данными с
буфером, указанным с помощью аргумента arg,
но сам буфер или его часть находятся за
пределами отведенного процессу адресного
пространства.
- [EINVAL]
- Значения аргументов command или arg некорректны для данного устройства.
- [EIO]
- Обнаружена ошибка ввода/вывода.
- [ENXIO]
- Значения аргументов command или arg корректны для данного драйвера, но над данным
устройством указанный запрос не может быть
выполнен.
- [ENOLINK]
- Аргумент fildes является дескриптором файла
на удаленном компьютере, связи с которым в
данный момент нет.
Ошибки псевдоустройств описаны в
streamio(7).
СМ. ТАКЖЕ
streamio(7), termio(7) в Справочнике администратора.
ДИАГНОСТИКА
При успешном завершении результат зависит от управляющего действия, но должен быть неотрицательным целым
числом. В случае ошибки возвращается -1, а переменной
errno присваивается код ошибки.