LinuxDoc.Ruconsole ioctl - ioctl для консольных терминалов и виртуальных консолей
НАЗВАНИЕconsole ioctl - ioctl для консольных терминалов и
виртуальных консолей
ОПИСАНИЕ
ВНИМАНИЕ: Вы используете эту информацию на свой страх и
риск. ВНИМАНИЕ: ioctl - неописанные ранее возможности
Linux, изменяются без предупреждения. Пользуйтесь
функциями POSIX. Поддерживаются Linux-ориентированные
запросы ioctl(). Каждый запрос определяется третьим
аргументом, далее именуемым argp.
KDGETLED
Получить состояние индикаторов. argp указывает на
длинное целое (long int). Младшие три бита *argp
устанавливают состояние индикаторов следующим
образом:
LED_CAP 0x04 индикатор caps lock
LEC_NUM 0x02 индикатор num lock
LED_SCR 0x01 индикатор scroll lock
KDSETLED
Устанавливает состояние индикаторов. Состояние
индикаторов устанавливается в соответствии с тремя
младшими битами argp. Однако, если установлен
старший бит, индикаторы возвращаются в исходное
состояние: отображают статус функций клавиатуры
caps lock, num lock и scroll lock.
До появления ядра 1.1.54 индикаторы состояния отражали
только состояние флагов клавиатуры, которые также могли
быть изменены KDGETLED/KDSETLED. После появления 1.1.54
они могли отображать уже произвольную информацию, но по
умолчанию показывали флаги клавиатуры. Описанные ниже два
запроса ioctl используются для доступа к флагам
клавиатуры.
KDGKBLED
Считывает флаги клавиатуры: CapsLock, NumLock,
ScrollLock (не индикаторы). argp указывает на
символ (char), который получает состояния флагов.
Младшие три бита (маска 0x7) получают текущее
состояние флагов, следующие три бита (маска 0x70)
присваивают устанавливаемое состояние флагам по
умолчанию. (Со времени появления ядра 1.1.54).
KDSKBLED
Устанавливает флаги клавиатуры: CapsLock, NumLock,
ScrollLock (не индикаторы). argp содержит
требуемые состояния флагов. Три младших бита
(маска 0x7) содержит состояния флагов, следующие
три бита (маска 0x70) содержат состояния флагов по
умолчанию. (Со времени появления ядра 1.1.54).
KDGKBTYPE
Считывает тип клавиатуры. Возвращается значение,
равное KB_101, определено как 0x02.
KDADDIO
Добавляет порт ввода/вывода (I/O) как допустимый.
Эквивалентно вызову ioperm(arg,1,1).
KDDELIO
Удаляет порт ввода/вывода (I/O) как недопустимый.
Эквивалентно вызову ioperm(arg,1,0).
KDENABIO
Разрешает ввод/вывод на видеокарту. Эквивалентно
вызову ioperm(0x3b4, 0x3df-0x3b4+1, 1).
KDDISABIO
Запрещает ввод/вывод на видеокарту. Эквивалентно
вызову ioperm(0x3b4, 0x3df-0x3b4+1, 0).
KDSETMODE
Установить текстовый/графический режим. argp
содержит одно из двух значений:
KD_TEXT 0x00
KD_GRAPHICS 0x01
KDGETMODE
Устанавливает режим (текстовый/графический). argp
указывает на длинное целое, которому присваивается
одно из вышеперечисленных устанавливаемых значений.
KDMKTONE
Генерирует тон заданной длительности. Младшие 16
битов argp задают частоту тона (период в тактах),
старшие 16 битов устанавливают его длительность в
мсек. Если длительность равна нулю, звук
выключается. Управление возвращается немедленно.
Например, argp = (125<<16) + 0x637 определяет звук,
обычно связанный с ctrl-G. (Работает с 0.99pl1; не
работает в 2.1.49-50).
KIOCSOUND
Начинает и останавливает генерацию звука. Младшие
16 битов argp определяют период в тактах (то есть
argp = 1193180/частота). Значение argp = 0
выключает звук. В обоих случаях управление
возвращается немедленно.
GIO_CMAP
Считывает текущую цветовую карту по умолчанию из
ядра. argp указывает на массив из 48-и байтов. (Со
времени появления ядра 1.3.3).
PIO_CMAP
Изменяет цветовую карту по умолчанию для текстового
режима. argp указывает на массив из 48-и байтов,
который содержит, по порядку, значения красного,
зеленого и синего для 16-и доступных экранных
цветов: 0 - составляющая выключена, 255 - полная
интенсивность. Цвета по умолчанию, по порядку:
black, dark red, dark green, brown, dark blue, dark
purple, dark cyan, light grey, dark grey, bright
red, bright green, yellow, bright blue, bright pur-
ple, bright cyan и white. (Со времени появления
ядра 1.3.3).
GIO_FONT
Получить экранный шрифт (256 символов) в
расширенной форме. argp указывает на массив из 8192
байтов. Возвращает код ошибки EINVAL, если текущий
загруженный шрифт содержит 512 символов или консоль
находится не в текстовом режиме.
GIO_FONTX
Считывает экранный шрифт и связанную с ним
информацию. argp указывает на структуру console-
fontdesc (смотри PIO_FONTX). При вызове поле char-
count должно иметь максимальное число символов в
качестве установленного значения, которое
помещается в буфер, указываемый как chardata. При
возврате charcount и charheight содержат полученную
информацию о текущем загруженном шрифте, массив
chardata содержит данные шрифта, если начальное
значение charcount показывало доступное
пространство; в противном случае буфер остается
неизменным и установленное значение errno равно
ENOMEM. (Со времени появления ядра 1.3.1).
PIO_FONT
Устанавливает экранный шрифт в объеме 256 символов.
Шрифт загружается в знакогенератор EGA/VGA. argp
указывает на карту размером 8192 байта (32 байта на
символ). Только первые N из них используются для
шрифта 8xN (0 < N <= 32). Этот вызов также
отменяет установленные соответствия символов Uni-
code шрифту.
PIO_FONTX
Устанавливает экранный шрифт и соответствующую
информацию для изображения. argp указывает на
структуру:
struct consolefontdesc {
u_short charcount; /* число символов в шрифте (256 или 512) */
u_short charheight; /* число линий сканирования символа (1-32) */
char *chardata; /* данные шрифта в расширенной форме */
};
Если требуется, соответственно изменяются размеры
экрана и SIGWINCH посылается соответствующим
процессам. Этот вызов также отменяет установленные
соответствия символов Unicode и шрифта. (Со времени
появления ядра 1.3.1).
PIO_FONTRESET
Пересылает экранный шрифт, размер и соответствие
символов Unicode шрифту в установки по умолчанию
при загрузке. argp не используется, но
установленное значение ее должно быть NULL, чтобы
эта версия была совместима с будущими версиями
Linux. (Со времени появления ядра 1.3.28).
GIO_SCRNMAP
Считывает разметку экрана из ядра. argp указывает
на область размером E_TABSZ, которая заполняется
позициями символов шрифта, используемыми при
отображении. Вызов возвращает бесполезную
информацию, если текущий загруженный шрифт содержит
более 256 символов.
GIO_UNISCRNMAP
Считывает полное экранное соответствие символов
Unicode шрифту из ядра. argp указывает на область
размером E_TABSZ*sizeof(unsigned short), которая
заполняется представлением в Unicode каждого
символа. Специальный набор Unicode, начинающийся с
U+F000, используется для представления перевод
символов ``напрямую в шрифт''. (Со времени
появления ядра 1.3.1).
PIO_SCRNMAP
Загружает ``определенную пользователем''
(четвертую) таблицу, которая отображает байты в
символах на экране консоли из ядра. argp указывает
на область размером E_TABSZ.
PIO_UNISCRNMAP
Загружает ``определенную пользователем''
(четвертую) таблицу из ядра, которая переводит
байты в символы Unicode, преобразующиеся затем в
экранные символы согласно текущей загруженной карте
соответствия символов Unicode и шрифта. Специальные
коды Unicode, начинающиеся с U+F000, могут
использоваться для прямого перевода байтов в
символы шрифта. (Со времени появления ядра 1.3.1).
GIO_UNIMAP
Проверяет соответствие символов Unicode шрифту из
ядра. argp указывает на структуру
struct unimapdesc {
u_short entry_ct;
struct unipair *entries;
};
где entries указывает на массив структур
struct unipair {
u_short unicode;
u_short fontpos;
};
(Со времени появления ядра 1.1.92).
PIO_UNIMAP
Помещает соответствие символов Unicode и экранного
шрифта в ядро. argp указывает на структуру
unimapdesc. (Со времени появления ядра 1.1.92).
PIO_UNIMAPCLR
Сбрасывает таблицу знакогенератора (возможно
использовать алгоритм хэширования). argp указывает
на структуру
struct unimapinit {
u_short advised_hashsize; /* 0, если не использовать */
u_short advised_hashstep; /* 0, если не использовать */
u_short advised_hashlevel; /* 0, если не использовать */
};
(Со времени появления ядра 1.1.92).
KDGKBMODE
Считывает текущий режим клавиатуры. argp указывает
на длинное целое (long), устанавливаемое значение
которого равно одному из:
K_RAW 0x00
K_XLATE 0x01
K_MEDIUMRAW 0x02
K_UNICODE 0x03
KDSKBMODE
Устанавливает текущий режим клавиатуры. argp -
длинное целое (long), равное одному из значений,
указанных выше.
KDGKBMETA
Считывает режим обработки метаклавиш. argp
указывает на длинное целое (long), устанавливаемое
значение которого равно одному из:
K_METABIT 0x03 установить старший бит
K_ESCPREFIX 0x04 префикс escape
KDSKBMETA
Устанавливает режим обработки метаклавиш. argp -
длинное целое (long), равное одному из значений,
указанных выше.
KDGKBENT
Считывает одну запись из таблицы трансляции клавиш
(код клавиши для кода действия). argp указывает на
структуру
struct kbentry {
u_char kb_table;
u_char kb_index;
u_short kb_value;
};
с двумя первыми полями, установленные значения
которых представляют собой: kb_table - выбранную
таблицу клавиш (0 <= kb_table < MAX_NR_KEYMAPS),
kb_index - код клавиши (0 <= kb_index < NR_KEYS).
kb_value, которой присваивается соответствующий код
действия или K_HOLE, если нет такой клавиши, или
K_NOSUCHMAP, если значение kb_table неверно.
KDSKBENT
Делает запись в таблице трансляции клавиш. argp
указывает на структуру kbentry.
KDGKBSENT
Считывает запись строки одной функциональной
клавиши. argp указывает на структуру
struct kbsentry {
u_char kb_func;
u_char kb_string[512];
};
kb_string равна строке, заканчивающейся нулем и
соответствующей коду действия функциональной
клавиши kb_func.
KDSKBSENT
Делает запись строки одной функциональной клавиши.
argp указывает на структуру kbsentry.
KDGKBDIACR
Считывает таблицу акцентов ядра. argp указывает на
структуру
struct kbdiacrs {
unsigned int kb_cnt;
struct kbdiacr kbdiacr[256];
};
где kb_cnt - это число записей в массиве, каждая из
которых является структурой struct kbdiacr { u_char
diacr, base, result; };
KDGETKEYCODE
Считывает запись таблицы кодов клавиш ядра
(сканкоды - коды клавиш). argp указывает на
структуру
struct kbkeycode { unsigned int scancode, keycode; };
keycode устанавливается в соответствии с заданным
scancode. (Допускается 89 <= scancode <= 255. Для
сканкодов 1 <= scancode <= 88, keycode==scancode).
(Со времени появления ядра 1.1.63).
KDSETKEYCODE
Производит запись в таблицу кодов клавиш ядра. argp
указывает на структуру kbkeycode. (Со времени
появления ядра 1.1.63).
KDSIGACCEPT
Вызываемый процесс показывает свою готовность к
приему сигнала argp, если он генерируется нажатием
соответствующей комбинации клавиш. (1 <= argp <=
NSIG). (Смотри функцию spawn_console() в
linux/drivers/char/keyboard.c).
VT_OPENQRY
Возвращает первую доступную (неоткрытую) консоль.
argp указывает на целое (int), устанавливаемое
значение которого равно номеру виртуального
терминала (1 <= *argp <= MAX_NR_CONSOLES).
VT_GETMODE
Считывает режим активного виртуального терминала.
argp указывает на структуру
struct vt_mode {
char mode; /* режим терминала */
char waitv; /* при установленном; остановка при записи, если терминал неактивен */
short relsig; /* сигнал для восстановления при освобождении */
short acqsig; /* сигнал для восстановления при захвате */
short frsig; /* не используется (устанавливается равным нулю) */
};
mode приобретает одно из устанавливаемых значений:
VT_AUTO автоматическое переключение
виртуального терминала
VT_PROCESS переключение контролирует процесс
VT_ACKACQ подтверждение переключения
VT_SETMODE
Устанавливает режим активного виртуального
терминала. argp указывает на структуру vt_mode.
VT_GETSTATE
Считывает общую информацию о состоянии виртуального
терминала. argp указывает на структуру
struct vt_stat {
ushort v_active; /* активный виртуальный терминал */
ushort v_signal; /* посылаемый сигнал */
ushort v_state; /* битовая маска виртуального терминала */
};
Для каждого используемого виртуального терминала
устанавливается соответствующий бит в поле v_state.
(В версиях с 1.0 до 1.1.92).
VT_RELDISP
Освобождает дисплей.
VT_ACTIVATE
Переключается на виртуальный терминал argp (1 <=
argp <= MAX_NR_CONSOLES).
VT_WAITACTIVE
Ожидает, пока виртуальный терминал argp не станет
активным.
VT_DISALLOCATE
Освобождает выделенную виртуальному терминалу argp
память. (Со времени появления ядра 1.1.54).
VT_RESIZE
Устанавливает представление размера экрана в ядре.
argp указывает на структуру
struct vt_sizes {
ushort v_rows; /* число строк */
ushort v_cols; /* число колонок */
ushort v_scrollsize; /* больше не используется */
};
Этот вызов не изменяет видеорежим. Смотрите
руководство resizecons(8). (Со времени появления
ядра 1.1.54).
VT_RESIZEX
Устанавливает значение различных параметров экрана
в ядре. argp указывает на структуру
struct vt_consize {
ushort v_rows; /* число строк */
ushort v_cols; /* число колонок */
ushort v_vlin; /* число строк экрана в пикселях */
ushort v_clin; /* число строк в пикселях на символ */
ushort v_vcol; /* число колонок экрана в пикселях */
ushort v_ccol; /* число колонок в пикселях на символ */
};
Любому параметру может быть присвоено установленное
нулевое значение, то есть он может быть оставлен
``без изменений'', но, если установлено несколько
параметров, они должны быть согласованы. Этот вызов
не изменяет видеорежим. Смотрите руководство
resizecons(8). (Со времени появления ядра 1.3.3).
Действие следующих ioctl зависит от первого байта
структуры, указываемой argp, далее называемого subcode.
Доступны только суперпользователю или владельцу текущего
tty.
TIOCLINUX, subcode=0
Выгружает дамп экрана. Исчезло в 1.1.92. (В ядре
1.1.92 и более поздних версий используется чтение
из /dev/vcsN или /dev/vcsaN).
TIOCLINUX, subcode=1
Считывает информацию о задании. Исчезло в 1.1.92.
TIOCLINUX, subcode=2
Производит выделение блока. argp указывает на
структуру
struct {char subcode;
short xs, ys, xe, ye;
short sel_mode;
} xs и ys - начальные колонка и строка. xe и ye
- конечные колонка и строка. (Левый верхний угол -
строка = колонке = 1). sel_mode равен нулю для
выделения "символ за символом", единице для
выделения "слово за словом" или двум для выделения
"строки за строкой". Выделенные символы
подсвечиваются и сохраняются в статическом массиве
sel_buffer, определенном в devices/char/console.c.
TIOCLINUX, subcode=3
Вставляет выделенный блок. Символы в буфере
выделения записываются в fd.
TIOCLINUX, subcode=4
Выводит экран из режима энергосбережения.
TIOCLINUX, subcode=5
Устанавливает содержимое 256-битной таблицы
определения символов в "word" для выделения "слово
за словом". (Со времени появления ядра 1.1.32).
TIOCLINUX, subcode=6
argp указывает на символ (char), который
устанавливает значение переменной ядра shift_state.
(Со времени появления ядра 1.1.32).
TIOCLINUX, subcode=7
argp указывает на символ (char), который
устанавливает значение переменной ядра
report_mouse. (Со времени появления ядра 1.1.33).
TIOCLINUX, subcode=8
Выгружает ширину и высоту экрана, позицию курсора и
все пары символ-атрибут. (Только в версиях с
1.1.67 по 1.1.91. В ядре 1.1.92 и более поздних
версий используется чтение из /dev/vcsa*).
TIOCLINUX, subcode=9
Восстанавливает ширину и высоту экрана, позицию
курсора и все пары символ-атрибут. (Только в
версиях с 1.1.67 по 1.1.91. В ядре 1.1.92 и более
поздних версий используется запись в /dev/vcsa*).
TIOCLINUX, subcode=10
Обработчик функций энергосбережения для нового
поколения мониторов. Режим погашения экрана VESA
устанавливается равным argp[1], который определяет
тип гашения:
0: гашение экрана запрещено.
1: текущие установки регистров видеоадаптера
сохраняются, когда контроллер программируется на
выключение вертикальной синхронизации. Происходит
перевод монитора в режим "резерв". Если на мониторе
есть таймер Off_Mode, то он может в итоге сам
выключить питание.
2: текущие установки сохраняются, когда и
вертикальная, и горизонтальная развертки
отключаются. Происходит перевод в режим
"выключено". Если на мониторе нет таймера Off_Mode
или Вы хотите отключить питание сразу же по
истечении времени blank_timer, Вы можете выбрать
эту опцию. (Внимание: частое выключение питания
может повредить монитор.) (Со времени появления
ядра 1.1.76).
ВОЗВРАЩАЕМЫЕ ЗНАЧЕНИЯ
При ошибке возвращаемое значение -1, а пременной errno
присваивается значение соответствующих кодов ошибок.
КОДЫ ОШИБОК
errno может принимать следующие значения:
EBADF (неверный описатель файла);
ENOTTY (описатель файла не связан со специальным
символьным устройством, или заданный запрос не
может быть выполнен);
EINVAL (описатель файла или argp неверен);
EPERM (ошибка доступа).
ПРЕДУПРЕЖДЕНИЕ
Не рассматривайте эту страницу руководства как
документацию об ioctl консоли Linux. Она предназначена
только для любознательных как альтернатива исходных
текстов. Ioctl - неописанные ранее возможности Linux,
которые могут изменяться без предупреждения. На самом
деле, это руководство более или менее полно описывает
параметры ядра версии 1.1.94; они несколько отличаются от
параметров ядра более ранних версий. Очень часто ioctl
вводится для совместной работы ядра с какой-либо
конкретной программой (fdisk, hdparm, setserial, tunelp,
loadkeys, selection, setfont и т.д.), и его поведение
изменяется по требованию этой программы. Программы,
использующие такие ioctl, не могут быть перенесены в
другие версии Unix, не будут работать в старых версиях
Linux и могут не работать в будущих версия Linux.
Рекомендуется работать с функциями POSIX.