Man page - console_codes(4)

Packages contains this manual

Available languages:

en fr pt_BR es pl ko ja ru zh_TW zh_CN de

Manual

console_codes

NOME
DESCRIÇÃO
Linux console controls
Character sets
Mouse tracking
Comparisons with other terminals
NOTAS
BUGS
VEJA TAMBÉM
TRADUÇÃO

NOME

console_codes - Sequëncias de controle e saída do console Linux

DESCRIÇÃO

The Linux console implements a large subset of the VT102 and ECMA-48 / ISO/IEC 6429 / ANSI X3.64 terminal controls, plus certain private-mode sequences for changing the color palette, character-set mapping, and so on. In the tabular descriptions below, the second column gives ECMA-48 or DEC mnemonics (the latter if prefixed with DEC) for the given function. Sequences without a mnemonic are neither ECMA-48 nor VT102.

Após o resultado do processamento normal ter sido concluido e uma sequência de caracteres ter chegado ao driver de console para a impressão real, a primeira coisa que acontece é uma tradução do código usado para o processamento para o código usado para impressão.

Se o console está no modelo UTF-8, então o bytes de entrada são primeiramente montados em códigos Unicode de 16bits. Caso contrário, cada byte é transformado de acordo com a tabela de mapeamento atual (o qual é traduzido para um valor Unicode). Veja a seção Conjunto de caracteres abaixo para um discussão a respeito.

No caso normal, o valor Unicode é convertido para um índice de fonte e armazenado na memória de video, de forma que o símbolo correspondente (como encontrado na ROM de vídeo) aparece na tela. Note que o uso do Unicode (e o projeto do PC) nos permite usar 512 símbolos simultaneamente.

If the current Unicode value is a control character, or we are currently processing an escape sequence, the value will treated specially. Instead of being turned into a font index and rendered as a glyph, it may trigger cursor movement or other control functions. See the Linux Console Controls section below for discussion.

Geralmente não é uma boa prática fixar códigos de controles de terminais dentro de programas. O Linux suporta uma base de dados terminfo (5) de capacidades de terminais. Ao invés de emitir manualmente uma sequência de escape, você irá quase sempre procurar usar uma biblioteca de tela terminfo ou utilitários como por exemplo ncurses (3), tput (1) ou reset (1).

Linux console controls

Esta seção descreve todos os caracteres de controle e sequências de escape que chamam funções especiais (isto é, qualquer coisa exceto escrever um símbolo na localização atual do cursor) no console do Linux.

Caracteres de Controle

Um caracter é dito de controle se (antes da transformação de acordo com a tabela de mapeamento) ele tem um dos 14 códigos 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). Um conjunto pode selecionar um modo de "caracter de controle de exibição" (veja abaixo), e permitir que 07, 09, 0b, 18, 1a, 7f sejam exibidos como símbolos. Por outro lado, em modo UTF-8 todos os códigos de 00–1f são respeitados como caracteres de controle, sem ligação com qualquer modo "caracter de controle de exibição".

Se nós temos um caracter de controle, ele é manipulado imediatamente e então descartado (mesmo que no meio de um sequência de escape) e a seqüencia de escape continua com o próximo caracter. (De qualquer forma, ESC inicia uma nova sequência de escape, possivelmente abortando uma sequência anterior inacabada, CAN e SUB abortam qualquer sequência de escape). Os caracteres de controle reconhecidos são: BEL, BS, HT, LF, VT, FF, CR, SO, SI, CAN, SUB, ESC, DEL, CSI. Eles fazem o que é esperado:
BEL (0x07, ^G )

Emite um beep;

BS (0x08, ^H )

Retorna uma coluna (mas não passa do inicio da linha);

HT (0x09, ^I )

Vai para a próxima parada de tabulação ou para o fim da linha se estiver na última tabulação;

LF (0x0A, ^J )
VT (0x0B, ^K )
FF (0x0C, ^L )

all give a linefeed, and if LF/NL (new-line mode) is set also a carriage return;

CR (0x0D, ^M )

gives a carriage return;

SO (0x0E, ^N )

ativa o conjunto de caracteres G1;

SI (0x0F, ^O )

ativa o conjunto de caracteres G0;

CAN (0x18, ^X )
SUB (0x1A, ^Z )

abort escape sequences;

ESC (0x1B, ^[ )

inicia uma sequência de escape;

DEL (0x7F)

is ignored;

CSI (0x9B)

é equivalente a ESC [.

ESC - mas não a sequência CSI

Image grohtml-3935569-1.png

Sequências ECMA-48 CSI

CSI (ou ESC [) é seguido por uma sequência de parâmetros na maioria NPAR (16), que são números decimais separados por ponto-e-vírgula. Um parâmetro vazio ou ausente é interpretado como 0. A sequência de parâmetros pode ser precedida pelo sinal de interrogação.

Entretanto, após o CSI [ (ou ESC [ [) um único caracter é lido e a sequência inteira é ignorada. (A idéia é ignorar uma tecla de função que seja ecoada).

A ação de uma sequência CSI é determinada pelo seu caracter final.

Image grohtml-3935569-2.png

ECMA-48 Select Graphic Rendition

The ECMA-48 SGR sequence ESC [ parameters m sets display attributes. Several attributes can be set in the same sequence, separated by semicolons. An empty parameter (between semicolons or string initiator or terminator) is interpreted as a zero.

Image grohtml-3935569-3.png

Commands 38 and 48 require further arguments:

Image grohtml-3935569-4.png

Opções do Modo ECMA-48
ESC [ 3 h

DECCRM (Padrão Desativado): Caracteres de Controle de Exibição.

ESC [ 4 h

DECIM (Padrão Desativado): Define Modo de Inserção.

ESC [ 20 h

LF/NL (Padrão Desativado): Automáticamente segue o eco do LF, VT ou FF com CR.

ECMA-48 Comandos de Resultado de Estado
ESC [ 5 n

Informa o estado do dispositivo (DSR): A resposta é ESC [ 0 n (Terminal OK).

ESC [ 6 n

Informa a posição do cursor (CPR): A resposta é ESC [ y ; x R, onde x,y é a localização do cursor.

Sequência do Modo Privativo DEC (DECSET/DECRST)

Ele não é descrito no ECMA-48. Nós listamos a sequência dos modos de configuração; as sequências do Modo de Reinicialização são obtidas pela troca do 'h' final por 'l'.
ESC [ ? 1 h

DECCKM (Padrão Desativado): Quando definido, as teclas de cursor enviam um prefixo ESC O, ao invés de ESC [.

ESC [ ? 3 h

DECCOLM (Padrão Desativado = 80 colunas): Alterna de 80/132 colunas. Este parâmetro sozinho nem sempre é suficiente, alguns utilitários em modo usuá rio como o resizecons (8) altera os registradores do equipamento na placa de vídeo.

ESC [ ? 5 h

DECSCNM (Padrão Desativado): Define o modo de vídeo reverso.

ESC [ ? 6 h

DECOM (Padrão Desativado): Quando definido, o endereçamento do cursor é relativo ao canto superior esquerdo da região de rolagem.

ESC [ ? 7 h

DECAWM (Padrão Ativo): Define quebra de linha automática. neste modo, um caracter gráfico emitido após a coluna 80 (ou coluna 132 se DECCOLM ativo) força uma quebra para o inicio da primeira linha seguinte.

ESC [ ? 8 h

DECARM (Padrão Ativo): Define autorepetição do teclado ativo.

ESC [ ? 9 h

X10 Informações do Mouse (Padrão Desativado): Define o modo de informações para 1 (ou reinicia para 0)—veja abaixo.

ESC [ ? 25 h

DECTECM (Padrão Ativo): Torna o cursor visivel.

ESC [ ? 1000 h

X11 Informações do Mouse (Padrão Desativado): Define o modo de informações para 2 (ou reinicia para 0)—veja abaixo.

Sequência de Console Linux Privada - CSI

The following sequences are neither ECMA-48 nor native VT102. They are native to the Linux console driver. Colors are in SGR parameters: 0 = black, 1 = red, 2 = green, 3 = brown, 4 = blue, 5 = magenta, 6 = cyan, 7 = white; 8–15 = bright versions of 0–7.

Image grohtml-3935569-5.png

Character sets

O Linux conhece entorno de 4 traduções de bytes em símbolos de console de tela. As 4 tabelas são: a) Latin1 -> PC, b) VT100 gráfico -> PC, c) PC -> PC, d) definição-usuário.

Existem dois conjuntos de caracteres chamados G0 e G1 e um deles é o conjunto corrente. (Inicialmente G0.) Digitar ^N torna o G1 o corrente, ^N O torna o G0 corrente.

Estas variáveis G0 e G1 estão na tabela de tradução e podem ser alteradas pelo usuário. Inicialmente elas apontam a tabela a) e b), respectivamente. As sequências ESC ( B e ESC ( 0 e ESC ( U e ESC ( K fazem G0 apontar para a tabela de tracução a), b), c) e d), respectivamente. As sequências ESC ) B e ESC ) 0 e ESC ) U e ESC ) K fazem G1 apontar para a tabela de tradução a), b), c) e d), respectivamente.

The sequence ESC c causes a terminal reset, which is what you want if the screen is all garbled. The oft-advised "echo ^V^O" will make only G0 current, but there is no guarantee that G0 points at table a). In some distributions there is a program reset (1) that just does "echo ^[c". If your terminfo entry for the console is correct (and has an entry rs1=\Ec), then "tput reset" will also work.

A tabela de mapeamento definida pelo usuário pode ser usada através do mapscrn (8). O resultado do mapeamento é que se o símbolo c é impresso, o símbolo s = map[c] é enviado para a memória de vídeo. O bitmap que corresponde a s é encontrado na ROM de caracter e pode ser alterado usando o setfont (8).

Mouse tracking

A facilidade de rastreamento do mouse pretende retornar informações de estado do mouse compatível com xterm (1). Devido ao controlador de console não ter como saber o dispositivo e o tipo do mouse, estas informações são retornadas na sequência de entrada da console apenas quando o controlador de terminal virtual recebe uma atualização através do ioctl. Estes ioctls são gerados pela aplicação relacionada ao mouse em modo usuário, tal como, o gpm (8).

The mouse tracking escape sequences generated by xterm (1) encode numeric parameters in a single character as value +040. For example, '!' is 1. The screen coordinate system is 1-based.

O modo de compatibilidade X10 envia um sequência escape ao pressionar um botão codificando a localização e o botão pressionado. Isto é habilitado enviando ESC [ ? 9 h e desativado com ESC [ ? 9 l. Ao pressionar o botão, o xterm (1) envia ESC [ M bxy (6 caracteres). Aqui b é o botão-1, e x e y são as coordenadas x e y do mouse quando o botão foi pressionado. Este é o mesmo código que o núcleo também produz.

O modo de rastreamento normal (não implementado no Linux 2.0.24) envia uma sequência escape quando o botão é pressiondo e liberado. Modificadores de informações também são enviados. Isto é habilitado enviado ESC [ ? 1000 h e desativado com ESC [ ? 1000 l. Ao pressionar e liberar o botão, o xterm (1) envia ESC [ M bxy . Os dois bits baixos de b codifica informações do botão: 0=MB1 pressionado, 1=MB2 pressionado, 2=MB3 pressionado, 3=liberado. Os bits altos codificam que os modificadores foram teclados quando o botão foi pressionado e acrescentado junto: 4=Shift, 8=Meta, 16=Control. De novo x e y são as coordenadas x e y do mouse. O canto superior esquerdo é (1,1).

Comparisons with other terminals

Diferentes tipos de terminais são descritos, com a console Linux sendo "VT100-compatível". Aqui nós discutimos diferenças entre a console Linux e outros dois mais importantes, o DEC VT102 e xterm (1).

Tratamento dos caracteres de controle

O VT102 também reconhece os seguintes caracteres de controle:
NUL (0x00)

foi ignorado;

ENQ (0x05)

resposta disparada;

DC1 (0x11, ^Q , XON)

transmissão reiniciada;

DC3 (0x13, ^S , XOFF)

faz o VT100 ignorar (e parar de transmitir) todos os códigos exceto XOFF e XON.

VT100-like DC1/DC3 processing may be enabled by the terminal driver.

O programa xterm (1) (no modo VT100) reconhece os caracteres de controle BEL, BS, HT, LF, VT, FF, CR, SO, SI, ESC.

Sequências Escape

Sequências de console VT100 não implementadas na console Linux:

Image grohtml-3935569-6.png

The program xterm (1) (in VT100 mode) recognizes ESC c, ESC # 8, ESC >, ESC =, ESC D, ESC E, ESC H, ESC M, ESC N, ESC O, ESC P ... ESC \, ESC Z (it answers ESC [ ? 1 ; 2 c, "I am a VT100 with advanced video option") and ESC ^ ... ESC \ with the same meanings as indicated above. It accepts ESC (, ESC ), ESC *, ESC + followed by 0, A, B for the DEC special character and line drawing set, UK, and US-ASCII, respectively.

The user can configure xterm (1) to respond to VT220-specific control sequences, and it will identify itself as a VT52, VT100, and up depending on the way it is configured and initialized.

It accepts ESC ] (OSC) for the setting of certain resources. In addition to the ECMA-48 string terminator (ST), xterm (1) accepts a BEL to terminate an OSC string. These are a few of the OSC control sequences recognized by xterm (1):

Image grohtml-3935569-7.png

It recognizes the following with slightly modified meaning (saving more state, behaving closer to VT100/VT220):

Image grohtml-3935569-8.png

Ele também reconhece

Image grohtml-3935569-9.png

It also recognizes ESC % and provides a more complete UTF-8 implementation than Linux console.

Sequência CSI

Old versions of xterm (1), for example, from X11R5, interpret the blink SGR as a bold SGR. Later versions which implemented ANSI colors, for example, XFree86 3.1.2A in 1995, improved this by allowing the blink attribute to be displayed as a color. Modern versions of xterm implement blink SGR as blinking text and still allow colored text as an alternate rendering of SGRs. Stock X11R6 versions did not recognize the color-setting SGRs until the X11R6.8 release, which incorporated XFree86 xterm. All ECMA-48 CSI sequences recognized by Linux are also recognized by xterm , however xterm (1) implements several ECMA-48 and DEC control sequences not recognized by Linux.

The xterm (1) program recognizes all of the DEC Private Mode sequences listed above, but none of the Linux private-mode sequences. For discussion of xterm (1)’s own private-mode sequences, refer to the Xterm Control Sequences document by Edward Moy, Stephen Gildea, and Thomas E. Dickey available with the X distribution. That document, though terse, is much longer than this manual page. For a chronological overview,

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

details changes to xterm.

The vttest program

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

demonstrates many of these control sequences. The xterm (1) source distribution also contains sample scripts which exercise other features.

NOTAS

ESC 8 (DECRC) is not able to restore the character set changed with ESC %.

BUGS

In Linux 2.0.23, CSI is broken, and NUL is not ignored inside escape sequences.

Some older kernel versions (after Linux 2.0) interpret 8-bit control sequences. These "C1 controls" use codes between 128 and 159 to replace ESC [, ESC ] and similar two-byte control sequence initiators. There are fragments of that in modern kernels (either overlooked or broken by changes to support UTF-8), but the implementation is incomplete and should be regarded as unreliable.

Linux "private mode" sequences do not follow the rules in ECMA-48 for private mode control sequences. In particular, those ending with ] do not use a standard terminating character. The OSC (set palette) sequence is a greater problem, since xterm (1) may interpret this as a control sequence which requires a string terminator (ST). Unlike the setterm (1) sequences which will be ignored (since they are invalid control sequences), the palette sequence will make xterm (1) appear to hang (though pressing the return-key will fix that). To accommodate applications which have been hardcoded to use Linux control sequences, set the xterm (1) resource brokenLinuxOSC to true.

An older version of this document implied that Linux recognizes the ECMA-48 control sequence for invisible text. It is ignored.

VEJA TAMBÉM

ioctl_console (2), charsets (7)

TRADUÇÃO

A tradução para português brasileiro desta página man foi criada por Fábio Henrique F. Silva <fabiohfs@mail.com> e André Luiz Fassone <lonely_wolf@ig.com.br>

Esta tradução é uma documentação livre; leia a Licença Pública Geral GNU Versão 3 ou posterior para as condições de direitos autorais. Nenhuma responsabilidade é aceita.

Se você encontrar algum erro na tradução desta página de manual, envie um e-mail para a lista de discussão de tradutores .