dir_colors(5)

NOMBRE
dir_colors - fichero de configuración para dircolors(1)

DESCRIPCIÓN
El programa ls(1) usa la variable de entorno LS_COLORS para determinar los colores con los que debe mostrar los nombre s de fichero. Esta variable de entorno se inicializa normalmente con una orden como

    eval `dircolors some_path/dir_colors`

localizado en un fichero de inicialización del intérprete por defecto, como /etc/profile o /etc/csh.cshrc. (Vea también dircolors(1).) Habitualmente, el fichero utilizado es /etc/DIR_COLORS y puede ser sobreescrito con un fichero .dir_colors en el directorio personal de cada usuario.

Este fichero de configuración consiste en varias sentencias, una por línea. Cualquier cosa a la derecha de una almohadilla (#) se trata como un comentario si la almohadilla está al principio de una línea o está precedida por, al menos, un espacio en blanco. Las líneas en blanco se ignoran.

La sección global del fichero está formada por cualquier sentencia antes de la primera sentencia TERM. Cualquier sentencia en la sección global del fichero se considera válida para todos los tipos de terminales. A continuación de la sección global hay una o más secciones específicas de terminales, que están precedidas por una o más sentencias TERM que especifican los tipos de terminal (tal y como los da la variable de entorno TERM) para los que se aplican las declaraciones que les siguen. Siempre es posible anular una declaración global mediante una subsiguiente declaración específica de terminales.

Se reconocen las siguientes sentencias, sin distinguir entre mayúsculas y minúsculas:

TERM terminal-type
    Comienza una sección específica de terminales y especifica a qué terminal se aplica. Se pueden usar múltiples sentencias TERM para crear una sección que se aplique a varios tipos de terminales.

COLOR yes|all|no|none|tty
    (Solo Slackware; ignorado por GNU dircolors(1).) Especifica que la coloración debe estar siempre habilitada (yes o all), nunca habilitada ((no o none) o habilitada solo si la salida es una terminal (tty). El valor predeterminado es no.

EIGHTBIT yes|no
    (Sólo Slackware; ignorado por GNU dircolors(1).) Indica que los caracteres ISO/IEC 8859 de ocho bits deben estar habilitados de forma predeterminada. Por razones de compatibilidad, también se especificar como 1 para sí o 0 para no. El valor predeterminado es no.

OPTIONS opciones
    (Sólo en Slackware; ignorada por la utilidad dircolors(1) de GNU.) Añade opciones de la línea de órdenes a la línea de órdenes por omisión de ls. Las opciones pueden ser cualquier opción válida de la línea de órdenes de ls, y deberían incluir el signo menos del principio. Dése cuenta que dircolors no verifica la validez de estas opciones.

NORMAL secuencia de colores
    Especifica el color usado para el texto normal (no nombres de fichero).

    Sinónimo: NORM.

ARCHIVO secuencia de colores
    Especifica el color usado para un fichero regular.

DIR secuencia de colores
    Especifica el color para los directorios.

LINK secuencia de colores
    Especifica el color para los enlaces simbólicos.

    Sinónimos: LNK, SYMLINK.

ORPHAN secuencia de colores
    Especifica el color usado para un enlace simbólico huérfano (uno que apunta a un fichero inexistente). Si no se indica este color, ls usará en su lugar el color de LINK.

MISSING secuencia de colores
    Especifica el color usado para un fichero ausente (un fichero inexistente que, sin embargo, tiene un enlace simbólico apuntaNdo a él). Si no se indica este color, ls usará en su lugar el color de FILE.

FIFO secuencia de colores
    Especifica el color usado para una FIFO (tubería con nombre).

    Sinónimo: PIPE.

SOCK secuencia de colores
    Especifica el color para los conectores.

DOOR secuencia de colores
    (Soportada desde fileutils 4.1) Especifica el color usado para una "puerta" (Solaris 2.5 y posteriores).

BLK secuencia de colores
    Especifica el color usado para un fichero especial de dispositivo de bloque.

    Sinónimo: BLOCK.

CHR secuencia de colores
    Especifica el color usado para un fichero especial de dispositivo de caracteres.

    Sinónimo: CHAR.

EXEC secuencia de colores
    Especifica el color usado para un fichero que tiene activo el atributo de ejecutable.

SUID secuencia de colores
    Especifica el color usado para un fichero que tiene activo el atributo SETUID.

    Sinónimo: SETUID.

SGID secuencia-de-colores
    Especifica el color usado para un fichero que tiene activo el atributo SETGID

    Sinónimo: SETGID.

STICKY secuencia-de-colores
    Especifica el color usado para un fichero que tiene activo el atributo sticky.

STICKY_OTHER_WRITABLE secuencia-de-colores
    Especifica el color usado para un fichero modificable por cualquier usuario con el atributo ejecutable activado.

    Sinónimo: OWT.

OTHER_WRITABLE secuencia-de-colores
    Especifica el color usado para un fichero modificable por cualquier usuario sin el permiso de ejecución activado.

    Sinónimo: OWR.

LEFTCODE secuencia-de-colores
    Define el código izquierda para terminales que no sean ISO/IEC 6429 (vea más adelante).

    Sinónimo: LEFT.

RIGHTCODE secuencia-de-colores
    Define el código derecha para terminales que no sean ISO/IEC 6429 (ver más abajo).

    Sinónimo: RIGHT.

ENDCODE secuencia-de-colores
    Define el código final para terminales que no sean ISO/IEC 6429 (consulte a continuación).

    Sinónimo: END.

*extension secuencia-de-colores
    Define el color usado para cualquier archivo que termina en extensión.

.extension secuencia-de-colores
    Igual que *.extensión. Especifica el color utilizado para cualquier archivo que termine en .extensión. Tenga en cuenta que el punto está incluido en la extensión, lo que impide especificar una extensión que no comience con un punto, como ~ para archivos de copia de seguridad emacs. Este formato debe considerarse obsoleto.

  Secuencias de color ISO/IEC 6429 (ANSI)
La mayoría de los terminales ASCII con capacidad para mostrar colores utilizan secuencias de color ISO/IEC 6429 (ANSI), y muchos terminales comunes sin capacidad de color, incluidos xterm y el ampliamente utilizado y clonado DEC VT100, reconocerán los códigos de color ISO/IEC 6429 y los eliminarán de la salida sin causar ningún problema o los emularán. ls utiliza por defecto códigos ISO/IEC 6429, presuponiendo que la coloración está habilitada.

Las secuencias de color ISO/IEC 6429 están formadas por secuencias de números separados por punto y coma. Los códigos más comunes son:
    0 | para restablecer el color por omisión
    1 | para colores más brillantes
    4 | para texto subrayado
    5 | para texto centelleante
    30 | para primer plano negro
    31 | para primer plano rojo
    32 | para primer plano verde
    33 | para primer plano amarillo (o marrón)
    34 | para primer plano azul
    35 | para primer plano púrpura
    36 | para primer plano cian
    37 | para primer plano blanco (o gris)
    40 | para segundo plano negro
    41 | para segundo plano rojo
    42 | para segundo plano verde
    43 | para segundo plano amarillo (o marrón)
    44 | para segundo plano azul
    45 | para segundo plano púrpura
    46 | para segundo plano cian
    47 | para segundo plano blanco (o gris)

No todas las órdenes funcionarán en todos los sistemas o dispositivos de visualización.

ls usa por omisión los siguientes valores:
NORMAL | 0 | Texto normal (no nombres de fichero)
FILE | 0 | Fichero regular
DIR | 32 | Directorio
LINK | 36 | Enlace simbólico
ORPHAN | indefinido | Enlace simbólico huérfano
MISSING | indefinido | Fichero ausente
FIFO | 31 | Tubería con nombre (FIFO)
SOCK | 33 | Conector
BLK | 44;37 | Dispositivo de bloques
CHR | 44;37 | Dispositivo de caracteres
EXEC | 35 | Fichero ejecutable

Unos pocos programas de terminal no reconocen adecuadamente los valores por omisión. Si se colorea todo el texto después de realizar un listado del directorio, cambie los códigos NORMAL y FILE a los códigos numéricos para sus colores de primer y segundo plano.

  Otros tipos de terminal (configuración avanzada)
Si posee una terminal (¡o impresora!) con capacidades de color (o un método de resaltado distinto) que usa un conjunto diferente de códigos, todavía puede generar una configuración adecuada. Para hacer eso, tendrá que usar las definiciones LEFTCODE, RIGHTCODE y ENDCODE.

Cuando ls escribe un nombre de fichero, genera las siguiente secuencia de salida: LEFTCODE código_de_tipo RIGHTCODE nombre_de_fichero ENDCODE, donde código_de_tipo es la secuencia de color que depende del tipo o nombre del fichero. Si el valor ENDCODE está indefinido, en su lugar se usará la secuencia LEFTCODE NORMAL RIGHTCODE. El propósito de los códigos a la izquierda y a la derecha es simplemente el de reducir la cantidad de escritura necesaria (y el de ocultar códigos de escape desagradables a los usuarios). Si no son adecuados para su terminal, puede eliminarlos especificando en una línea sólo la palabra clave correspondiente.

NOTA: Si ENDCODE está definida en la sección global del fichero de configuración, no se puede anular en una sección del fichero específica de terminales. Esto significaría que cualquier definición NORMAL no tendría efecto. Sin embargo, se puede especificar un ENDCODE diferente, que tendría el mismo efecto.

  Secuencias de Escape
Para especificar caracteres de control o en blanco en las secuencias de colores o extensiones de nombre de archivo, se puede utilizar la notación de escape \ de estilo C o la notación ^ de estilo stty. La notación de estilo C incluye los siguientes caracteres:
    \a | Pitido (ASCII 7)
    \b | Retroceso (ASCII 8)
    \e | Escape (ASCII 27)
    \f | Salto de página (ASCII 12)
    \n | Nueva línea (ASCII 10)
    \r | Retorno de carro (ASCII 13)
    \t | Tabulador (ASCII 9)
    \v | Tabulador vertical (ASCII 11)
    \? | Borrado (ASCII 127)
    \nnn | Cualquier carácter (notación octal)
    \xnnn | Cualquier carácter (notación hexadecimal)
     | Espacio
    \\ | Barra invertida (\)
     | Signo de intercalación (^)
    \# | Almohadilla (#)

Dése cuenta que los caracteres de escape son necesarios para introducir un espacio, una barra inclinada invertida, un acento circunflejo o cualquier carácter de control en cualquier lugar de la cadena, así como una almohadilla como primer carácter.

ARCHIVOS

/etc/DIR_COLORS
    Archivo de configuración global del sistema.

~/.dir_colors
    Archivo de configuración por usuario.

Esta página describe el formato del fichero dir_colors tal y como se usa en el paquete fileutils-4.1. Otras versiones pueden diferir ligeramente.

NOTAS
Las definiciones predeterminadas de LEFTCODE y RIGHTCODE, que se utilizan en los terminales ISO/IEC 6429 son:
    LEFTCODE | \e[
    RIGHTCODE | m

El valor por omisión de ENDCODE está indefinido.

VÉASE TAMBIÉN
dircolors(1), ls(1), stty(1), xterm(1)

TRADUCCIÓN
La traducción al español de esta página del manual fue creada por Juan Piernas <piernas@ditec.um.es>, Miguel Pérez Ibars <mpi79470@alu.um.es> y Marcos Fouces <marcos@debian.org>

Esta traducción es documentación libre; lea la GNU General Public License Version 3 (https://www.gnu.org/licenses/gpl-3.0.html) o posterior con respecto a las condiciones de copyright. No existe NINGUNA RESPONSABILIDAD.

Si encuentra algún error en la traducción de esta página del manual, envíe un correo electrónico a debian-l10n-spanish@lists.debian.org.