Provided by: manpages-es_1.55-10_all bug

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 nombres 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 tipo-terminal
              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
              (Sólo  en  Slackware; ignorada por la utilidad dircolors(1) de GNU.)  Especifica que la coloración
              siempre debería estar activa (yes o all), simepre inactiva (no o none) o activa sólo si la  salida
              es una terminal (tty).  El valor por omisión es no.

       EIGHTBIT yes|no
              (Sólo  en  Slackware; ignorada por la utilidad dircolors(1) de GNU.)  Especifica que, por omisión,
              deberían estar activos caracteres ISO 8859 de 8 bits. Por razones de  compatibilidad,  también  se
              puede especificar 1 para yes y 0 para no.  El valor por omisión 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-color
              Especifica el color usado para el texto normal (no nombres de fichero).

       FILE secuencia-color
              Especifica el color usado para un fichero regular.

       DIR secuencia-color
              Especifica el color para los directorios.

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

       ORPHAN secuencia-color
              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-color
              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-color
              Especifica el color usado para una FIFO (tubería con nombre).

       SOCK secuencia-color
              Especifica el color para los conectores.

       B DOOR secuencia-color
              (Soportada  desde  file-utils  4.1)  Especifica  el  color  usado para una "puerta" (Solaris 2.5 y
              posteriores).

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

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

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

       LEFTCODE secuencia-color
              Especifica el código a la izquierda para terminales que no son ISO 6429 (ver más abajo).

       RIGHTCODE secuencia-color
              Especifica el código a la derecha para terminales que no son ISO 6429 (ver más abajo).

       ENDCODE secuencia-color
              Especifica el código al final para terminales que no son ISO 6429 (ver más abajo).

       *extensión secuencia-color
              Especifica el color usado para cualquier fichero que termina en extensión.

        .extension secuencia-color
              Lo mismo que *.extensión.  Especifica el  color  usado  para  cualquier  fichero  que  termina  en
              .extension.  Dése cuenta que el punto se incluye en la extensión, lo que hace imposible especifica
              una  extensión que no comience por punto, tal como ~ para los ficheros de respaldo de emacs.  Esta
              forma se debería considerar obsoleta.

SECUENCIAS DE COLOR ISO 6429 (ANSI)

       La mayoría de las terminales ASCII con capacidades de color usan actualmente secuencias de color ISO 6429
       (ANSI), y muchas terminales comunes sin capacidades de color, incluyendo xterm y la ampliamente  usada  y
       copiada  DEC  VT100,  reconocerán  códigos  de  color  ISO  6429, elminándolos de la salida limpiamente o
       emulándolos.  ls usa códigos ISO 6429 por omisión, suponiendo que la coloración esté activa.

       Las secuencias de color ISO 6429 están compuestas por secuencias  de  números  separados  por  caracteres
       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 espacio o de control en las secuencias de color o en  las  extensiones  de
       los  nombres  de  fichero,  se  puede  usar  tanto la notación de códigos de \-escape al estilo de C o la
       notación ^ al estilo de stty.  La notación al estilo de C incluyen 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 inclinada invertida (\)
         \^        Acento circunflejo (^)
         \#        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.

OBSERVACIONES

       Las definiciones por omisión de LEFTCODE y RIGHTCODE, que son usadas por las terminales ISO 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)

FICHEROS

       /etc/DIR_COLORS
              Fichero de configuración global del sistema para dircolors.

       ~/.dir_colors
              Fichero de configuración por usuario para dircolors.

OBSERVACIONES

       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. Envíe correos con correciones y ampliaciones a aeb@cwi.nl.
       Informe de fallos en el programa en fileutils-bugs@gnu.ai.mit.edu.

GNU fileutils 4.1                               26 diciembre 2001                                  DIR_COLORS(5)