CONSOLE_CODES(4)

NOMBRE
console_codes - secuencias de escape y control de la consola de Linux

DESCRIPCIÓN
La consola de Linux implementa un vasto subconjunto de los controles de terminal de la VT102 y del estándar ECMA-48/ISO 6429/ANSI X3.64, más ciertas secuencias de modo privadas para cambiar la paleta de colores, asociaciones de conjuntos de caracteres, etc. En las descripciones tabulares de abajo, la 2ª columna da los mnemónicos ECMA-48 o DEC (éstos, prefijados por DEC) para la función dada. Las secuencias sin un mnemónico no son ni ECMA-48 ni VT102.

Después de haber hecho todo el procesamiento de salida normal, y de que un flujo de caracteres llega al controlador de consola para la impresión de verdad, la 1ª cosa que ocurre es una traducción del código empleado para el procesamiento al código empleado para la impresión.

Si la consola está en el modo UTF-8, entonces los bytes que llegan se ensamblan 1º a los códigos de 16 b Unicode. Si no, cada byte se transforma según la tabla de asociaciones en curso (que lo traduce a un valor Unicode). Vea más abajo la sección CONJUNTOS DE CARACTERES para la discusión sobre esto.

En el caso normal, el valor Unicode se convierte a un índice de tipo de letra, y éste se almacena en memoria de vídeo, de forma que aparezca en la pantalla el grafo correspondiente (según se encuentra en la ROM de vídeo). Observe que el empleo de Unicode (y el diseño del hardware del PC) nos permite usar 512 grafos diferentes simultáneamente.

Si el valor actual Unicode es un carácter de control, o estamos actualmente procesando una secuencia de escape, el valor se tratará especialmente. En vez de convertirse a un índice de tipo y presentarse como un grafismo, puede lanzar un movimiento del cursor u otra función de control. Vea la sección CONTROLES DE LA CONSOLA DE LINUX abajo para la discusión sobre esto.

Generalmente no es una buena idea codificar directamente controles de terminal en programas. Linux tiene una base de datos terminfo(5) de capacidades de terminales. En vez de emitir a mano secuencias de escape de la consola, Ud. debería casi siempre utilizar una biblioteca de pantalla que consultara terminfo o una utilidad, como ncurses(3), tput(1), o reset(1).

CONTROLES DE LA CONSOLA DE LINUX

Esta sección describe todos los caracteres de control y secuencias de escape que llaman a funciones especiales (i.e., cualquier otra cosa distinta a escribir un grafo en la localización del cursor en curso) en la consola de Linux.

  Caracteres de control
Un carácter lo es de control si (antes de la transformación según la tabla de asociaciones) tiene uno de los 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). Uno puede establecer un modo de `mostrar caracteres de control' (vea más abajo), y permitir que los códigos 07, 09, 0b, 18, 1a, 7f se muestren como grafos. Por otro lado, en modo UTF-8 todos los códigos 00-1f se miran como caracteres de control, sin importar ningún modo `mostrar caracteres de control'.

Si tenemos un carácter de control, se actúa inmediatamente y luego se descarta (incluso en medio de una secuencia de escape) y la secuencia de escape continúa con el siguiente carácter. (Sin embargo, ESC empieza una nueva secuencia de escape, posiblemente abortando una anterior no acabada, y CAN y SUB abortan cualquier secuencia de escape). Los caracteres de control reconocidos son BEL, BS, HT, LF, VT, FF, CR, SO, SI, CAN, SUB, ESC, DEL, CSI. Hacen lo que uno esperaría:

BEL (0x07, ^G) pita;

BS (0x08, ^H) va un espacio atrás a la columna anterior (pero no pasa del principio de la línea);

HT (0x09, ^I) va a la siguiente parada de tabulación o al final de la línea si no hay antes una parada de tabulación;

LF (0x0A, ^J), VT (0x0B, ^K) y FF (0x0C, ^L) todos dan un salto de línea;

CR (0x0D, ^M) da un retorno de carro;

SO (0x0E, ^N) activa el conjunto de caracteres G1, y si está activado LF/NL (modo de nueva línea), también un retorno de carro;

SI (0x0F, ^O) activa el conjunto de carcteres G0;

CAN (0x18, ^X) y SUB (0x1A, ^Z) interrumpen secuencias de escape;

ESC (0x1B, ^[) empieza una secuencia de escape;

DEL (0x7F) no es tenido en cuenta;

CSI (0x9B) es equivalente a ESC [.

  Secuencias de ESC, pero no CSI
ESC c | RIS | Inicio.
ESC D | IND | Salto de línea.
ESC E | NEL | Nueva línea.
ESC H | HTS | Pone parada tab en esta columna.
ESC M | RI | Salto de línea inverso.
ESC Z | DECID | DEC identificación privada. El núcleo
 |  | devuelve la cadena ESC [ ? 6 c, diciendo
 |  | que es una VT102.
ESC 7 | DECSC | Salva el estado actual (cordenadas del cursor,
 |  | atributos, conjuntos de caracteres apuntados por G0, G1).
ESC 8 | DECRC | Restaura el estado salvado más reciente por ESC 7.
ESC [ | CSI | Introductor de secuencia de control
ESC % |  | Empieza la secuencia de selección de conjunto de caracteres
ESC % @ |  | Selecciona el predeterminado (ISO 646 / ISO 8859-1)
ESC % G |  | Selecciona UTF-8
ESC % 8 |  | Selecciona UTF-8 (obsoleto)
ESC # 8 | DECALN | DEC prueba de alineación en pantalla - la llena de E's.
ESC ( |  | Empieza secuencia de definición del conjunto G0
ESC ( B |  | Selecciona predeterminado (asociación ISO 8859-1)
ESC ( 0 |  | Selecciona asociación de gráficos vt100
ESC ( U |  | Selecciona ninguna asociación - derecho a la ROM
ESC ( K |  | Selecciona asociación del usuario - la que se carga con
 |  | la utilidad mapscrn(8).
ESC ) |  | Empieza la secuencia de definición de G1
 |  | (seguido por uno de B, 0, U, K, como arriba).
ESC > | DECPNM | Pone el teclado auxiliar en modo numérico
ESC = | DECPAM | Pone el teclado auxiliar en modo aplicación
ESC ] | OSC | (Debería ser: Orden del sistema operativo)
 |  | ESC ] P nrrggbb: pone paleta, con parámetro
 |  | dado en 7 dígitos hexadecimales tras la P final :-(.
 |  | Aquí n es el color (0-15), y rrggbb indica
 |  | los valores rojo/verde/azul (0-255).
 |  | ESC ] R: restaura paleta

  Secuencias ECMA-48 CSI

CSI (o ESC [) es seguido por una secuencia de parámetros, como mucho NPAR (16), que son los números decimales separados por punto y comas. Un parámetro vacío o ausente se toma como 0. La secuencia de parámetros puede ir precedida por un signo de interrogación.

Sin embargo, tras CSI [ (o ESC [ [) se lee un carácter solo y esta secuencia entera no es tenida en cuenta. (La idea es no hacer caso de una tecla de función que se muestra.)

La acción de una secuencia CSI se determina por su carácter final.

@ | ICH | Insertar el Nº indicado de caracteres blancos
A | CUU | Mover cursor arriba el Nº indicado de filas
B | CUD | Mover cursor abajo el Nº indicado de filas
C | CUF | Mover cursor a la derecha el Nº indicado de columnas
D | CUB | Mover cursor a la izquierda el Nº indicado de columnas
E | CNL | Mover cursor abajo el Nº indicado de filas, a la columna 1
F | CPL | Mover cursor arriba el Nº indicado de filas, a la columna 1
G | CHA | Mover cursor a la columna indicada en la fila actual
H | CUP | Mover cursor a la fila y columna indicadas (origen en 1,1)
J | ED | Borrar pantalla (p. o.: desde el cursor al final de la pantalla).
 |  | ESC [ 1 J: borrar desde el comienzo hasta el cursor.
 |  | ESC [ 2 J: borrar la pantalla entera.
K | EL | Borrar línea (p.o.: desde el cursor al final de la línea).
 |  | ESC [ 1 K: borrar desde el comienzo de la línea al cursor
 |  | ESC [ 2 K: borrar la línea entera.
L | IL | Insertar el Nº indicado de líneas en blanco
M | DL | Borrar el Nº indicado de líneas
P | DCH | Borrar el Nº indicado de caracteres en la línea actual
X | ECH | Borrar el Nº indicado de caracteres en la línea actual
a | HPR | Mover cursor a la derecha el Nº indicado de columnas
c | DA | Reponder ESC [ ? 6 c: `Yo soy una VT102'.
d | VPA | Mover cursor a la fila y columna indicadas
e | VPR | Mover cursor abajo el Nº indicado de filas
f | HVP | Mover cursor a la fila y columna indicadas
g | TBC | Sin parámetro: quita parada TAB en la posición actual
 |  | ESC [ 3 g: borra todas las paradas de tabulación
h | SM | Establece Modo (vea abajo).
l | RM | Restablece Modo (vea abajo).
m | SGR | Establece atributos (vea abajo).
n | DSR | Informe de estado (vea abajo).
q | DECLL | Establece los LEDs del teclado.
 |  | ESC [ 0 q: apaga todos los LEDs
 |  | ESC [ 1 q: pone LED Bloq. Despl.
 |  | ESC [ 2 q: pone LED Bloq. Num.
 |  | ESC [ 3 q: pone LED Bloq. Mayús.
r | DECSTBM | Establece región de rodadura; los parámetros son la fila de arriba y abajo
s | ? | Salva la localización del cursor
u | ? | Restaura la localización del cursor.
` | HPA | Mover cursor a la columna indicada en la fila indicada

  ECMA-48 Pone modo Gráfico

La secuencia ECMA-48 SGR ESC [ <parámetros> m establece los atributos de la pantalla. Se pueden poner varios atributos en la misma secuencia.

par | resultado
0 | restablece todos los atributos a sus valores predeterminados
1 | pone negrillas
2 | pone medio brillo (simulado con color en una pantalla a color)
4 | pone subrayado (simulado con color en una pantalla a color)
 | (los colores para simular disminución o subrayado se ponen con
 | ESC ] ...)
5 | pone intermitencia
7 | pone vídeo inverso
10 | restaura asociación seleccionada, indicador de control de
 | pantalla y cambia el indicador meta
11 | selecciona no asociación, pone indicador de control de
 | pantalla, restaura indicador de cambio meta
12 | selecciona no asociación, pone indicador de control de
 | pantalla, pone indicador de cambio meta (que hace que el bit
 | más alto de un byte cambie antes de que se haga la traducción
 | de la tabla de asociación.)
21 | pone intensidad normal (esto no es compatible con ECMA-48)
22 | pone intensidad normal
24 | quita subrayado
25 | quita intermitencia
27 | quita vídeo inverso
30 | pone negro
31 | pone rojo
32 | pone verde
33 | pone marrón
34 | pone azul
35 | pone rosa
36 | pone celeste
37 | pone blanco
38 | pone subrayado, color predeterminado
39 | quita subrayado, pone color predeterminado
40 | pone negro de fondo
41 | pone rojo de fondo
42 | pone verde de fondo
43 | pone marrón de fondo
44 | pone azul de fondo
45 | pone rosa de fondo
46 | pone celeste de fondo
47 | pone blanco de fondo
49 | pone el color de fondo predeterminado

  Interruptores de Modo ECMA-48

ESC [ 3 h
    DECCRM (por omisión desactivado): Mostrar caracteres de control

ESC [ 4 h
    DECIM (por omisión desactivado): Poner modo de inserción

ESC [ 20 h
    LF/NL (por omisión desactivado): Automáticamente seguir a LF, VT o FF con CR.

  Órdenes de Informe de Estado ECMA-48

ESC [ 5 n
    Informe de estado de dispositivo (DSR): La respuesta es ESC [ 0 n (Terminal OK).

ESC [ 6 n
    Informe de posición de cursor (CPR): La respuesta es ESC [ y ; x R, donde x,y es la localización del cursor.

  Secuencias de Modo Privado DEC (DECSET/DECRST).
Éstas no se describen en ECMA-48. Listamos las secuencias de Establecer Modo; las de Reestablecer Modo se obtienen reemplazando la hache final por ele.

ESC [ ? 1 h
    DECCKM (por omisisón desactivado): Cuando está activado, las teclas de cursor envían un prefijo ESC O, en vez de ESC [.

ESC [ ? 3 h
    DECCOLM (por omisión desactivado = 80 columnas): interruptor de modo 80/132 columnas. En los fuentes del controlador se hace notar que esto solo no basta; alguna utilidad de usuario como resizecons(8) tiene que cambiar los registros de hardware en la tarjeta de vídeo de consola.

ESC [ ? 5 h
    DECSCNM (por omisión desactivado): Pone el modo de vídeo inverso

ESC [ ? 6 h
    DECOM (por omisión desactivado): Cuando está activado, el direccionamiento del cursor es relativo a la esquina superior izquierda de la región de rodadura.

ESC [ ? 7 h
    DECAWM (por omisión activado): Activa el paso automático de renglón. En este modo, un carácter gráfico emitido tras la columna 80 (o la 132 si está activado DECCOLM) fuerza un cambio al principio de la siguiente línea.

ESC [ ? 8 h
    DECARM (por omisión activado): Activa la auto-repetición del teclado

ESC [ ? 9 h
    Informe de Ratón X10 (por omisión desactivado): Establece el modo de informe a 1 (o lo restaura a 0) - vea abajo.

ESC [ ? 25 h
    DECCM (por omisión activado): Hace visible el cursor.

ESC [ ? 1000 h
    Informe de Ratón X11 (por omisión desactivado): Establece el modo de informe a 2 (o lo restaura a 0) - vea abajo.

  Secuencias Privadas de Consola de Linux CSI
Las siguientes secuencias no son ni ECMA-48 ni VT102 nativas. Son nativas al controlador de consola de Linux. Los colores están en los parámetros SGR: 0 = negro, 1 = rojo, 2 = verde, 3 = marrón, 4 = azul, 5 = rosa, 6 = celeste, 7 = blanco.

ESC [ 1 ; n ] | Pone el color n como el de subrayado
ESC [ 2 ; n ] | Pone el color n como el disminuido
ESC [ 8 ] | Hace al color actual el de los atributos predeterminados
ESC [ 9 ; n ] | Pone el tiempo de espera del blanqueado de la terminal a n min.
ESC [ 10 ; n ] | Establece la frecuencia del pito en Hz.
ESC [ 11 ; n ] | Establece la duración del pitido en ms.
ESC [ 12 ; n ] | Trae al frente la consola especificada.
ESC [ 13 ] | Quita el blanco de la pantalla.
ESC [ 14 ; n ] | Establece el intervalo de apagado VESA en min.

CONJUNTOS DE CARACTERES

El núcleo sabe de 4 traducciones de bytes a símbolos de la pantalla de la consola. Las cuatro tablas son: a) Latin1 -> PC, b) gráficos VT100 -> PC, c) PC -> PC, d) definida por el usuario.

Hay dos conjuntos de caracteres, llamados G0 y G1, y uno de ellos es el actual. (Inicialmente G0.)

Teclear ^N hace que G1 sea el actual, ^O hace a G0 el actual.

Estas variables G0 y G1 apuntan a una tabla de traducción, y pueden ser cambiadas por el usuario. Inicialmente apuntan a las tablas a) y b) respectivamente. Las secuencias ESC ( B y ESC ( 0 y ESC ( U y ESC ( K causan que G0 apunte a la tabla a), b), c) y d) respectivamente. Las secuencias ESC ) B y ESC ) 0 y ESC ) U y ESC ) K causan que G1 apunte a la tabla a), b), c) y d), respectivamente.

La secuencia ESC c provoca una puesta a cero de la terminal, que es lo que uno quiere cuando la pantalla está liada. El otrora truco "echo ^V^O" solamente hace G0 actual, pero no hay garantías de que G0 apunte a la tabla a). En algunas distribuciones hay un programa reset(1) que simplemente hace "echo ^[c". Si su entrada de terminfo para la consola es correcto (y tiene una entrada rs1=\Ec), entonces "tput reset" también funcionará.

La tabla de asociación definida por el usuario puede ponerse con mapscrn(8). El resultado de la asociación es que si hay un símbolo c que se imprime, se envía a la memoria de vídeo el símbolo s = map[c]. El mapa de bits que corresponde a s se encuentra en la ROM de caracteres, y puede cambiarse mediante setfont(8).

PISTA DEL RATÓN

La facilidad de seguimiento de pista del ratón sirve para devolver informes de estado del ratón compatibles con xterm. Puesto que el controlador de consola no tiene forma de conocer el dispositivo ni tipo del ratón, estos informes se devuelven en el flujo de entrada de la consola sólo cuando del controlador de terminal virtual recibe un ioctl de actualización de ratón. Estos ioctls deben ser generados por una aplicación de usuario que haga uso del ratón como el duende gpm(8).

Los parámetros para todas las secuencias de escape de pista del ratón generadas por xterm codifican los parámetros numéricos en un simple carácter como valor+040. Por ejemplo, `!' es 1. El sistema de coordenadas de la pantalla empieza en 1.

El modo de compatibilidad X10 envía una secuencia de escape cuando se pulsa un botón codificando la localización y el botón del ratón pulsado. Esto se activa enviando ESC [ ? 9 h y se desactiva con ESC [ ? 9 l. Cuando se pulsa un botón, xterm envía ESC [ M bxy (6 caracteres). Aquí b es botón-1, y x y y son las coordenadas x e y del ratón cuando se pulsó el botón. Esto es el mismo código que el núcleo también produce.

El modo de pista normal (no implementado en Linux 2.0.24) envía una secuencia de escape cuando se pulas o se libera un botón. También se envía información de modificador. Se habilita enviando ESC [ ? 1000 h y se inhabilita con ESC [ 1000 l. Cuando se pulas o libera un botón, xtermenvía ESC [ M bxy. Los dos bits bajos de b codifican información del botón: 0=MB1 pulsado, 1=MB2 pulsado, 2=MB3 pulsado, 3=liberar. Los bits más altos codifican qué modificadores estaban pulsados cuando el botón se hubo presionado y se añaden juntos: 4=Mayúsculas, 8=Meta, 16=Control. De nuevo x e y son las coordenadas x e y del evento de ratón. La esquina superior izquierda es (1,1).

COMPARACIONES CON OTRAS TERMINALES

Muchos tipos diferentes de terminal se describen, como la consola de Linux, como `compatibles VT100'. Aquí se discuten las diferencias entre la consola de Linux y las otras dos más importantes, la VT102 de DEC y la xterm(1).

  Manejo de caracteres de control
La vt102 también reconocía los siguientes caracteres de control:

NUL (0x00) no era tenido en cuenta;

ENQ (0x05) lanzaba un mensaje de reconocimiento;

DC1 (0x11, ^Q, XON) reanudaba la transmisión;

DC3 (0x13, ^S, XOFF) hacía que la vt100 no tuviera en cuenta (y parara la transmisión) ningún código excepto XOFF y XON.

El controlador de tty puede habilitar el procesamiento de DC1/DC3 al estilo de la VT100.

El programa xterm (en modo vt100) reconoce los caracteres de control BEL, BS, HT, LF, VT, FF, CR, SO, SI, ESC.

  Secuencias de Escape
Secuncias de consola VT100 no implementadas en la consola de Linux:

ESC N | SS2 | Simple cambio 2. (Selecciona el conjunto de caracteres
 |  | G2 sólo para el sgute. carácter.)
ESC O | SS3 | Simple cambio 3. (Selecciona el conjunto de caracteres
 |  | G3 sólo para el sgute. carácter.)
ESC P | DCS | Cadena de control de dispositivo (acabada por ESC \)
ESC X | SOS | Comienzo de cadena.
ESC ^ | PM | Mensaje de privacidad (acabado por ESC \)
ESC \ | ST | Terminador de caadena
ESC * ... |  | Designa el conjunto de caracteres G2
ESC + ... |  | Designa el conjunto de caracteres G3

El programa xterm (en modo vt100) reconoce ESC c, ESC # 8, ESC >, ESC =, ESC D, ESC E, ESC H, ESC M, ESC N, ESC O, ESC P ... ESC ESC Z (responde ESC [ ? 1 ; 2 c, `Yo soy una vt100 con opción de vídeo avanzado') y ESC ^ ... ESC con los mismos significados que los arriba indicados. Acepta ESC (, ESC ), ESC *, ESC + seguidos por 0, A, B para el conjunto de caracteres especiales y líneas de dibujo de DEC, UK y US-ASCII, respectivamente. Acepta ESC ] para el establecimiento de ciertos recursos:

ESC ] 0 ; txt BEL | Pone nombre de icono y título de ventana como txt.
ESC ] 1 ; txt BEL | Pone txt como nombre de icono.
ESC ] 2 ; txt BEL | Pone txt como título de ventana.
ESC ] 4 6 ; log BEL | Cambia el nombre del fichero de registro a log
 | (normalmente deshabilitado por una opción de tiempo de
 | compilación)
ESC ] 5 0 ; fn BEL | Pone fn como el tipo de letra.

Reconoce lo siguiente con un significado ligeramente modificado:

ESC 7 DECSC | Salva el cursor
ESC 8 DECRC | Restaura el cursor

También reconoce

ESC F |  | Cursor a esquina inferior izda. de la pantalla (si
 |  | permitido por el recurso hpLowerleftBugCompat)
ESC l |  | Bloqueo de memoria (por terminales HP).
 |  | Bloquea la memoria sobre el cursor.
ESC m |  | Desbloqueo de memoria (por terminales HP).
ESC n | LS2 | Invoca el conjunto de caracteres G2.
ESC o | LS3 | Invoca el conjunto de caracteres G2.
ESC | | LS3R | Invoca el conjunto de caracteres G3 como GR.
 |  | No tiene efecto visible en xterm.
ESC } | LS2R | Invoca el conjunto de caracteres G2 como GR.
 |  | No tiene efecto visible en xterm.
ESC ~ | LS1R | Invoca el conjunto de caracteres G1 como GR.
 |  | No tiene efecto visible en xterm.

No reconoce ESC % ...

  Secuencias CSI
El programa xterm (en XFree86 3.1.2G) no reconoce los SGRs de modo invisible o parpadeo. Versiones originales X11R6 no reconocen los SGRs de establecimiento de colores. Todas las otras secuencias CSI de ECMA-48 reconocidas por Linux también lo son por xterm, y viceversa.

El programa xterm reconocerá todas las secuencias de Modo Privado de DEC listadas arriba, pero ninguna de las secuencias de modo privado de Linux. Para una discusión sobre las propias secuencias de modo privado de xterm, refiérase al documento Xterm Control Sequences por Edward Moy & Stephen Gildea, disponible con la distribución X-Window.

FALLOS

En 2.0.23, CSI no funciona, y NUL es tenido en cuenta dentro de secuencias de escape.

VÉASE TAMBIÉN
console(4), console_ioctl(4), charsets(7)