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.