Provided by: manpages-es_1.55-8_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
       especficas   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 cdigo a la izquierda para terminales que  no  son
              ISO 6429 (ver más abajo).

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

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

       *extensin secuencia-color
              Especifica  el color usado para cualquier fichero que termina en
              extensin.

        .extension secuencia-color
              Lo mismo  que  *.extensin.   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 cdigo_de_tipo RIGHTCODE nombre_de_fichero ENDCODE,
       donde  cdigo_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.