ИМЯ

console_codes - управляющие и экранирующие последовательности консоли Linux

ОПИСАНИЕ

Консоль Linux имеет большой набор средств управления терминалами VT102 и
ECMA-48/ISO 6429/ANSI X364, а также некоторым количеством индивидуальных
последовательностей для изменения цветовой палитры, перекодировки символьного
набора и т. д. В таблицах, приведенных ниже (во втором столбце), указывается
мнемонический код ECMA-48 или DEC (если последнее приписано к DEC) данной функции.
Последовательности без мнемонического кода не принадлежат ни к ECMA-48, ни к
VT102.

Первым процессом, который выполняется после работы обычного процесса по выводу
информации и отправки к драйверу потока символов консоли (для их реального
вывода), является перевод кодов, используемых при обычной работе, в коды,
применяемые для печати.

Если консоль работает в режиме UTF-8, то входящие байты сначала организуются в
16-битовый Юникод. В ином случае каждый байт преобразуется согласно текущей
таблице перекодировки (которая переводит данные в Юникод). Смотри раздел Наборы
символов ниже).

Обычно значения Юникода преобразуются в индекс шрифта, который хранится в
видеопамяти таким образом, что соответствующий образ (обнаруженный в видео-ПЗУ)
появляется на экране. Заметим, что работа с Юникодом (и текущими аппаратными
средствами компьютеров) позволяет одновременно использовать только 512 различных
образов.

Если текущим значением Юникода является управляющий символ или если в данный
момент обрабатывается экранирующая последовательность, значение будет
обрабатываться особым образом. Вместо того, чтобы значение было преобразовало в
шрифт и отобразилось как образ, оно приведёт к выполнению определённого действия
(например, перемещение курсора) или другой функции управления. Смотрите ниже
раздел Управление консолью Linux.

Некорректно явно указывать в программах аппаратные последовательности управление
терминалом. Linux поддерживает работу с базой возможностей терминала terminfo(5).
Вместо того, чтобы вводить управляющие последовательности вручную, вы, наверняка,
захотите использовать для этой работы библиотеку, использующую terminfo, или
другие утилиты, такие как ncurses(3), tput(1) или reset(1).

Управление консолью Linux
Этот раздел описывает все управляющие символы и экранирущие последовательности,
которые выполняют специальные команды (т.е., всё, что отличается от простого
вывода символа в текущую позицию курсора) консоли Linux.

Управляющие символы

Символ считается управляющим, если (до преобразования согласно таблице
перекодировки) он содержит один из 4 кодов: 00 (NUL), 07 (BEL), 08 (BS), 09 (HT),
0a (LF), 0b (VT), 0c (FF), 0d (CR), 0e (SO), 0f (SI), 18 (CAN), 1a (SUB), 1b
(ESC), 7f (DEL). Можно установить режим "показывать управляющие символы" (см.
ниже), при этом символы 07, 09, 0b, 18, 1a, 7f будут выводиться на экран в виде
образов. С другой стороны, в режиме UTF-8 все коды с 00 по 1f воспринимаются как
управляющие символы, независимо от режима «показа управляющих символов».

Если встречается управляющий символ, то он учитывается немедленно, и никак не

BS (0x08, ^H) удаляет предыдущий символ (смещается влево на один столбец, но не
далее, чем за начало строки);

HT (0x09, ^I) перемещается на следующую позицию табуляции или в конец строки, если
до этого не было установлено позиций табуляции;

LF (0x0A, ^J), VT (0x0B, ^K) и FF (0x0C, ^L) задают перевод строки, а LF/NL (в
режиме новой строки) выполняет перевод каретки;

CR (0x0D, ^M) задает перевод каретки;

SO (0x0E, ^N) приводит в действие набор символов G1;

SI (0x0F, ^O) приводит в действие набор символов G0;

CAN (0x18, ^X) и SUB (0x1A, ^Z) прерывают экранирующую последовательность;

ESC (0x1B, ^[) начинают экранирующую последовательность;

DEL (0x7F) игнорируется;

CSI (0x9B) эквивалентно ESC [.

ESC- но не CSI-последовательности

ESC c RIS Сброс
ESC D IND Перевод строки
ESC E NEL Новая строка
ESC H HTS Установить позицию табуляции в текущем столбце
ESC M RI Обратный перевод строки
ESC Z DECID Есть только у DEC. Ядро возвращает строку ESC [ ? 6 c,
утверждая что это VT102.
ESC 7 DECSC Сохранить текущее состояние (координаты курсора, атрибуты,
наборы символов, указанные G0, G1).
ESC 8 DECRC Восстановить последнее сохранённое ESC 7 состояние
ESC [ CSI Начало управляющей последовательности
ESC % Начать последовательность с выбором набора символов
ESC % @ выбор по умолчанию (ISO 646/ISO 8859-1)
ESC % G выбор UTF-8
ESC % 8 выбор UTF-8 (устарело)
ESC # 8 DECALN Экранный тест на выравнивание DEC: заполняет экран символами E
ESC ( Начать последовательность с выбором набора символов G0
ESC ( B выбор по умолчанию (таблица перекодировки ISO 8859-1)
ESC ( 0 выбор графической перекодировки VT100
ESC ( U выбрать null-перекодировку — сразу в символьную ROM
ESC ( K пользовательская перекодировка — карта
загружается утилитой mapscrn(8)
ESC ) Начать последовательность с выбором набора символов G1
(следом идёт один из символов B, 0, U, K, как с G0)
ESC > DECPNM Установить режим ввода цифр для дополнительной клавиатуры
ESC = DECPAM Установить режим управления для дополнительной клавиатуры
ESC ] OSC (Должно быть: команда операционной системы) ESC ] P nrrggbb:
задать палитру, в параметре указывается 7 шестнадцатеричных
цифр после последнего P :-(. Здесь n определяет цвет (0–15), а
в rrggbb указываются значения красного/зелёного/синего (0–255)
ESC ] R: сбросить палитру

оставшаяся часть последовательности игнорируется. (Смысл этого в том, чтобы не
отображать функциональную клавишу).

Результат работы CSI-последовательности определяется её конечным символом.

@ ICH Вставить N пустых символов
A CUU Переместить курсор вверх на N строк
B CUD Переместить курсор вниз на N строк
C CUF Переместить курсор вправо на N столбцов
D CUB Переместить курсор влево на N столбцов
E CNL Переместить курсор вниз на N строк в столбец 1
F CPL Переместить курсор вверх на N строк в столбец 1
G CHA Переместить курсор в указанный столбец текущей строки
H CUP Переместить курсор в указанную строку и столбец (начало в 1,1)
J ED Очистить экран (по умолчанию от курсора до конца экрана)
ESC [ 1 J: очистить от начала до курсора
ESC [ 2 J: очистить весь экран
ESC [ 3 J: очистить весь экран, включая буфер
обратной прокрутки (начиная с Linux 3.0)
K EL Очистить строку (по умолчанию от курсора до конца строки)
ESC [ 1 K: очистить от начала строки до курсора
ESC [ 2 K: очистить всю строку
L IL Вставить N пустых строк
M DL Удалить N строк
P DCH Удалить N символов в текущей строке
X ECH Очистить N символов в текущей строке
a HPR Переместить курсор вправо на N столбцов
c DA Ответ по ESC [ ? 6 c: «Я терминал VT102»
d VPA Переместить курсор в указанную строку текущего столбца
e VPR Переместить курсор вниз на N строк
f HVP Переместить курсор в указанную строку и столбец
g TBC Без параметра: очистить текущую позицию табуляции
ESC [ 3 g: удалить все позиции табуляции
h SM Режим установки (смотрите ниже)
l RM Режим сброса (смотрите ниже)
m SGR Установка атрибутов (смотрите ниже)
n DSR Отчёт о состоянии (смотрите ниже)
q DECLL Управление индикаторами на клавиатуре
ESC [ 0 q: выключить все индикаторы
ESC [ 1 q: включить Scroll Lock
ESC [ 2 q: включить Num Lock
ESC [ 3 q: включить Caps Lock
r DECSTBM Установить область прокрутки; параметрами будут верхняя и нижняя строки
s ? Сохранить местоположение курсора
u ? Восстановить местоположение курсора
` HPA Переместить курсор в указанный столбец текущей строки

Установка параметров графики ECMA-48

Последовательность ECMA-48 SGR управляющих символов ESC [ parameters m
устанавливает атрибуты экрана. В одной последовательности может быть задано
несколько атрибутов. Пустой параметр (между точкой с запятой или начальной строкой
или символом завершения) считается нулём.

параметр результат
0 сбросить все атрибуты в их значения по умолчанию
1 установить жирный
11 выбрать null-перекодировку, установить флаг управления экраном, сбросить
переключатель метафлага (в ECMA-48 указан как «первый альтернативный шрифт»).
12 выбрать null-перекодировку, установить флаг управления экраном, установить
переключатель метафлага (в ECMA-48 указан как «второй альтернативный шрифт»).
Переключение метафлага вызывает переключение старшего бита в байте до его
перекодировки согласно таблице трансляции.
21 включить нормальную интенсивность (в ECMA-48 указан как «двойное подчёркивание»)
22 включить нормальную интенсивность
24 выключить подчеркивание
25 выключить мерцание
27 выключить инвертированное видео
30 установить чёрный цвет символов
31 установить красный цвет символов
32 установить зелёный цвет символов
33 установить коричневый цвет символов
34 установить синий цвет символов
35 установить сиреневый цвет символов
36 установить голубой цвет символов
37 установить белый цвет символов
38 включить подчеркивание, установить цвет символов по умолчанию
39 выключить подчеркивание, установить цвет символов по умолчанию
40 установить чёрный цвет фона
41 установить красный цвет фона
42 установить зелёный цвет фона
43 установить коричневый цвет фона
44 установить синий цвет фона
45 установить сиреневый цвет фона
46 установить голубой цвет фона
47 установить белый цвет фона
49 установить цвет фона по умолчанию

Переключатели режимов ECMA-48

ESC [ 3 h
DECCRM (по умолчанию выключен): Показывать управляющие символы.

ESC [ 4 h
DECIM (по умолчанию выключен): Включить режим вставки.

ESC [ 20 h
LF/NL (по умолчанию выключен): Автоматически выводить код CR после LF, VT
или FF.

Команды вывода состояния ECMA-48

ESC [ 5 n
Сообщение о состоянии устройства (DSR): Ответом является ESC [ 0 n
(терминал в порядке).

ESC [ 6 n
Сообщение о позиции курсора (CPR): Ответом является ESC [ y ; x R, где x,y
являются координатами курсора.

Последовательности спец-режима DEC (DECSET/DECRST)

Не описаны в ECMA-48. Далее будут перечислены последовательности установки режима;
в последовательности для сброса режима последний знак 'h' заменяется на 'l'.
нестандартные режимы, такие как resizecons(8), должны менять регистры
настройки видеокарты консоли.

ESC [ ? 5 h
DECSCNM (по умолчанию выключено): Включить инвертированный видеорежим.

ESC [ ? 6 h
DECOM (по умолчанию выключено): Если включено, то координаты курсора
рассматриваются относительно верхнего левого угла области прокрутки.

ESC [ ? 7 h
DECAWM (по умолчанию включено): Включить режим автопереноса. В этом режиме
графический символ, вводящийся после 80-го столбца (или 132-го, если
DECCOLM включён), переносится в начало следующей строки.

ESC [ ? 8 h
DECARM (по умолчанию включено): Включить режим автоповтора символов при
вводе с клавиатуры.

ESC [ ? 9 h
Отчёт X10 о состоянии мыши (по умолчанию выключено): Установить режим
отчёта о состоянии мыши, равным 1 (или сбросить в 0), см. ниже.

ESC [ ? 25 h
DECTECM (по умолчанию включено): Сделать курсор видимым.

ESC [ ? 1000 h
Отчёт X11 о состоянии мыши (по умолчанию выключено): Установить режим
отчёта о состоянии мыши, равным 2 (или сбросить в 0), см. ниже.

Специфические CSI-последовательности консоли Linux

Следующие последовательности не являются ни ECMA-48, ни VT102. Они есть только в
драйвере консоли Linux. Цвета в параметрах SGR: 0 = чёрный, 1 = красный, 2 =
зелёный, 3 = коричневый, 4 = синий, 5 = сиреневый, 6 = голубой, 7 = белый.

ESC [ 1 ; n ] Назначить цвет n цветом подчеркивания
ESC [ 2 ; n ] Назначить цвет n цветом затемнения
ESC [ 8 ] Сделать текущую пару цветов атрибутами по умолчанию
ESC [ 9 ; n ] Показывать заставку через n минут
ESC [ 10 ; n ] Задать частоту звукового сигнала (в герцах)
ESC [ 11 ; n ] Задать длительность звукового сигнала (в миллисекундах)
ESC [ 12 ; n ] Переместить указанную консоль перед остальными
ESC [ 13 ] Убрать заставку (blank screen)
ESC [ 14 ; n ] Задать интервал отключения питания VESA (в минутах)
ESC [ 15 ] Переместить предыдущую консоль перед остальными
(начиная с Linux 2.6.0)
ESC [ 16 ; n ] Задать интервал мигания курсора (в миллисекундах)
(начиная с Linux 4.2)

Наборы символов
Ядро располагает информацией о 4-х типах трансляции байтов в символы консоли
экрана. Эти четыре таблицы: a) Latin1 -> PC, b) графика VT100 -> PC, c) PC -> PC,
d) определяется пользователем.

В системе существует два набора символов, называемых G0 и G1, и один из них
является текущим набором символов системы (изначально это G0). Ввод ^N заставляет
Последовательность ESC c приводит к сбросу терминала, то есть то, что вы хотели бы
сделать при наличии «мусора» на экране. Рекомендация, указанная после «echo ^V^O»,
только сделает G0 текущим набором, но нет никакой гарантии, что G0 указывает на
таблицу a). В некоторых дистрибутивах есть программа reset(1), которая всего лишь
выполняет команду «echo ^[c». Если элемент terminfo является правильным для
консоли (и содержит элемент rs1=\Ec), то «tput reset» также сработает.

Определенная пользователем таблица перекодировки может быть установлена с помощью
mapscrn(8). Результатом перекодировки будет то, что при указании символа c в
видеопамять будет отправлен символ s = перекодировка[c] . Побитовое изображение,
соответствующее s, ищется в ПЗУ символов и может меняться при помощи setfont(8).

Отслеживание мыши
Для отслеживания работы мыши в системе предполагается выдача xterm(1)-совместимых
сигналов о состоянии мыши. Так как драйвер консоли не распознает такого
устройства, как мышь (или похожего типа), то эти сигналы отправляются во входной
поток консоли, только когда драйвер виртуального терминала получает сигнал ioctl
об обновлении состояния мыши. Эти сигналы ioctl должны генерироваться
пользовательскими приложениями, поддерживающими работу с мышью такими, как служба
gpm(8).

Параметром для всех созданных xterm(1) экранирующих последовательностей (сигналов
от мыши) будет один символ, код которого равен значение+040. Например, '!'
соответствует единице. Отчёт системы координат экрана начинается с 1.

В режиме совместимости с X10 при нажатии на кнопки посылаются экранирующие
последовательности, в которых кодируется и расположение мыши, и информация о
нажатой кнопке. Режим включается при выдаче ESC [ ? 9 h и выключается при выдаче
ESC [ ? 9 l. При нажатии на кнопку xterm(1) посылает ESC [ M bxy (6 символов), где
b — это кнопка 1, а x и y равны координатам x и y при нажатии на кнопку. Это такие
же коды, какие генерирует и выдаёт ядро.

В обычном режиме отслеживания мыши (который не был реализован в Linux 2.0.24)
экранирующие последовательности посылаются и при нажатии и при отпускании кнопки
мыши. Также посылается информация о модификаторе. Режим включается при выдаче ESC
[ ? 1000 h и выключается при выдаче ESC [ 1000 l. При нажатии или отпускании
кнопки xterm(1) выдает ESC [ M bxy. Два младших бита b содержат информацию о
кнопках: 0=MB1 нажата, 1=MB2 нажата, 2=MB3 нажата, 3=отпущена. Старшие биты
содержат информацию о том, какие модификаторы были нажаты, когда была нажата
кнопка. Эта информация складывается при нажатии: 4=Shift, 8=Meta, 16=Control. Ещё
раз: x и y являются координатами x и y мыши при обработке события. Координаты
верхнего левого угла рассматриваются как (1,1).

Сравнение с другими терминалами
Множество других типов терминалов описаны, подобно консоли Linux, как
VT100-совместимые. Далее мы обсудим различия между консолью Linux и двумя другими
важнейшими типами — DEC VT102 и xterm(1).

Обработка управляющих символов

Тип VT102 также распознает следующие управляющие символы:

NUL (0x00) игнорируется;

ENQ (0x05) запускает обратное ответное сообщение;

DC1 (0x11, ^Q, XON) возобновляет передачу;
Экранирующие последовательности

Последовательности консоли VT100, не реализованные в консоли Linux:

ESC N SS2 Сдвиг на 2 (выбрать набор символов G2 только для следующего
символа)
ESC O SS3 Сдвиг на 3 (выбрать набор символов G3 только для следующего
символа)
ESC P DCS Строка управления устройством (заканчивается ESC \)
ESC X SOS Начало строки
ESC ^ PM Частное сообщение (заканчивается ESC \)
ESC \ ST Символ завершения строки
ESC * ... Определить набор символов G2
ESC + ... Определить набор символов G3

Программа xterm(1) (в режиме VT100) распознает ESC c, ESC # 8, ESC >, ESC =, ESC
D, ESC E, ESC H, ESC M, ESC N, ESC O, ESC P ... ESC \, ESC Z (отвечает ESC [ ? 1 ;
2 c, "Я VT100 с улучшенными видеопараметрами") и ESC ^ ... ESC \ с теми же
значениями, какие указаны выше. Принимаются ESC (, ESC ), ESC *, ESC + за которыми
0, A, B для специального символа DEC и режима рисования линий, UK и US-ASCII,
соответственно.

Пользователь может настроить xterm(1) так, чтобы он отвечал на специальные
управляющие последовательности VT220, и в этом случае он будет идентифицировать
себя как VT52, VT100 и далее, в зависимости от способа настройки и инициализации.

Для настройки определённых ресурсов он принимает ESC ] (OSC). Помимо символа
завершения строки (ST) из ECMA-48, xterm(1) для завершения OSC-строки также
принимает BEL. Есть несколько управляющих последовательностей OSC, распознаваемых
xterm(1):

ESC ] 0 ; txt ST Установить имя значка и заголовок окна равным txt
ESC ] 1 ; txt ST Установить имя значка равным txt
ESC ] 2 ; txt ST Установить заголовок окна равным txt
ESC ] 4 ; num; txt ST Установить цвет ANSI num равным txt
ESC ] 10 ; txt ST Установить цвет динамического текста равным txt
ESC ] 4 6 ; name ST Изменить файл журнала на name (обычно отключено
в параметрах компиляции)
ESC ] 5 0 ; fn ST Установить шрифт равным fn.

Распознаются следующие параметры с несколько измененным значением (больше
сохраняется состояние, поведение ближе к VT100/VT220):

ESC 7 DECSC Сохранить курсор
ESC 8 DECRC Восстановить курсор

Также распознаются

ESC F Курсор в нижний левый угол экрана (если разрешено
ресурсом hpLowerleftBugCompat в xterm(1))
ESC l Блокировать память (терминалы HP)
Блокировать память выше курсора
ESC m Разблокировать память (терминалы HP)
ESC n LS2 Вызов набора символов G2
ESC o LS3 Вызов набора символов G3
ESC | LS3R Вызов набора символов G3 в качестве GR
ESC } LS2R Вызов набора символов G2 в качестве GR
3.1.2A 1995 года, атрибут мерцания отображается цветом. В современных версиях
xterm мерцание SGR реализовано в виде мерцающего текста, который можно также
сделать цветным в качестве альтернативы отображения SGR. Исходные версии X11R6 не
распознают настройки цвета SGR вплоть до версии X11R6.8, в которую был включён
XFree86 xterm. Все последовательности CSI ECMA-48 CSI, понимаемые Linux, также
понимает xterm, однако в xterm(1) реализовано несколько управляющих
последовательностей ECMA-48 и DEC, которые не понимаются Linux.

Программа xterm(1) распознаёт все последовательности спец-режимов DEC, описанных
выше, но ни одной последовательности спец-режимов Linux. О собственных
спец-режимах xterm(1) можно прочитать в документе Управляющие последовательности
Xterm, написанном Edward Moy, Stephen Gildea и Thomas E. Dickey и доступном в
дистрибутиве X. Этот документ хотя и сокращённый, но всё равно намного больше
данной справочной страницы. Хронологический обзор в

⟨http://invisible-island.net/xterm/xterm.log.html⟩

описывает изменения в xterm.

Программа vttest

⟨http://invisible-island.net/vttest/⟩

демонстрирует многие из этих управляющих последовательностей. В исходном
дистрибутиве xterm(1) также содержатся примеры сценариев, которые учат работать с
другими свойствами.

ЗАМЕЧАНИЯ

Последовательность ESC 8 (DECRC) не может восстановить набор символов, изменённый
с помощью ESC %.

ДЕФЕКТЫ

В версии 2.0.23 набор CSI является неправильным и недейственным, NUL не
игнорируется внутри экранирующих последовательностей.

Некоторые старые версии ядер (после 2.0) анализируют 8-битные управляющие
последовательности. В них ("управляющие коды C1") используются коды от 128 до 159
для замены ESC [, ESC ] и подобных начальных двухбайтовых управляющих
последовательностей. Они частично существуют в современных ядрах (или не
распознаются или не работают из-за поддержки UTF-8), и реализованы не полностью, и
должны расцениваться как ненадежные.

Последовательности "спец-режима" Linux не учитывают правила ECMA-48 для
управляющих последовательностей спец-режима. В частности, они заканчиваются ] и не
используют стандартный символ завершения. Последовательность OSC (установить
палитру) — большая проблема, так как xterm(1) рассматривает её как управляющую
последовательность, которой требуется окончание строки (ST). В отличие от
последовательностей setterm(1), которые будут проигнорированы (так как они не
являются правильными управляющими последовательностями), последовательность
палитры приведёт к подвисанию xterm(1) (хотя нажав клавишу return это исправится).
Чтобы приспособить приложения, в которых жёстко заданы управляющие
последовательности Linux, установите ресурс xterm(1) brokenLinuxOSC равным true.

В старой версии данного документа предполагалось, что Linux распознаёт управляющую
последовательность ECMA-48 для невидимости текста. Она игнорируется.