Provided by: manpages-pt_20040726-4_all 
NOME
dir_colors - arquivo de configuração para dircolors(1)
DESCRIÇÃO
O arquivo dir_colors contem informações de configuração para o programa dircolors(1) , o
qual, por sua vez, provém informações de cor para ls(1). O arquivo é normalmente
encontrado em /etc, embora os usuários possam manter uma cópia particular no seu diretório
pessoal como .dir_colors.
O arquivo de configuração consiste de vários enunciados, um por linha. Qualquer coisa à
direita da marca (se esta marca estiver no começo da linha ou for precedida por pelo menos
um espaço. Linhas em branco são ignoradas.
A seção global do arquivo consiste de algum enunciado depois do primeiro enunciado TERM
válido para todo tipo de terminal. Seguindo a seção global é uma ou mais seções terminal-
specific , as quais são precedidas por um ou mais enunciados TERM , o qual especifica o
tipo de terminal (como fornecido pela variável de ambiente TERM ) nas seguintes
declarações aplicadas. Ele permite sobrescrever a declaração global por uma subseqüente
especificação de terminal.
Os enunciados seguintes são reconhecidos, tipo da letra é insignificante:
TERM terminal-type
Inicia a seção de especificação de terminal e especifica em qual terminal ela se
aplica. Múltiplos enunciados TERM podem ser usados para criar uma seção que pode
ser aplicada para vários tipos de terminal.
COLOR yes|all|no|none|tty
Especifica que colorização deveria ficar sempre disponível (yes ou all), nunca
disponível (no ou none) ou disponível somente se a saída for um terminal (tty). O
padrão é no.
EIGHTBIT yes|no
Especifica que caracteres de oito bits da ISO 8859 deverian estar disponíveis por
padrão. Pode por razões de compatibilidade ser especificado como 1 para yes ou 0
para no. O padrão é no.
OPTIONS options
Adiciona opções de comando de linha para o comando de linha padrão ls ls , e devem
incluir o sinal de menos em primeiro lugar. Favor notar que dircolors não verifica
a validade destas opções.
NORMAL color-sequence
Especifica a cor usada para texto normal (não nome de arquivo).
FILE color-sequence
Especifica a cor usada para arquivos regulares.
DIR color-sequence
Especifica a cor usada para diretórios.
LINK color-sequence
Especifica a cor usada para ligações simbólicas.
ORPHAN color-sequence
Especifica a cor usada para uma ligação simbólica orfã (a qual aponta para um
arquivo inexistente). Se isto não for especificado, ls irá usar a cor do LINK no
lugar.
MISSING color-sequence
Especifica a cor usada para um arquivo perdido (um arquivo inexistente o qual
todavia tem uma ligação simbólica apontado para si). Se isto não for especificado,
ls irá usar a cor do FILE no lugar.
FIFO color-sequence
Especifica a cor usada por um FIFO (pipe nomeado).
SOCK color-sequence
Especifica a cor usada por um socket.
BLK color-sequence
Especifica a cor usada por um arquivo especial de bloco.
CHR color-sequence
Especifica a cor usada por um arquivo especial de caractere.
EXEC color-sequence
Especifica a cor usada por um arquivo executável.
LEFTCODE color-sequence
Especifica o left code para terminais que não são terminais ISO 6429 (veja abaixo).
RIGHTCODE color-sequence
Especifica o right code para terminais que não são terminais ISO 6429 (veja
abaixo).
ENDCODE color-sequence
Especifica o end code para terminais que não são terminais ISO 6429 (veja abaixo).
*extension color-sequence
Especifica a cor usada para qualquer arquivo que termine com extension.
.extension color-sequence
De forma semelhante *.extension. Especifica a cor usada por qualquer tipo de
arquivo que termine com a extensão.extension. Note que o ponto é incluído na
extensão, o qual torna impossível especificar uma extensão que não inicia com um
ponto, assim como ~ para arquivos de recuperação do emacs. Esta forma poderia ser
considerada obsoleta.
SEQÜENCIA DE CORES (ANSI) ISO 6429
A maioria do terminais ASCII com capacidade de cor usam a seqüencia de cores (ANSI) ISO
6429, e muitos terminais simples sem capacidade de cor, incluindo xterm e o largamente
usado e copiado DEC VT100, irão reconhecer os códigos de cores ISO 6429 e de forma
inofensiva remove elas a partir da saída ou as emula. ls usa o código ISO 6429 por
padrão, assumindo que a colorização está ativada.
As seqüencias ISO 6429 de cores são compostas de seqüencias de números separados por ponto
e vírgula. Os códigos mais comuns são:
0 para restaurar a cor padrão
1 para cor brilhante
4 para sublinhar o texto
5 para fazer o texto pisca
30 negro para o fundo mais próximo
31 primeiro plano em vermleho
32 primeiro plano em verde
33 primeiro plano em amarelo (ou marrom)
34 primeiro plano em azul
35 primeiro plano em púrpura
36 primeiro plano em azul-esverdeado
37 primeiro plano em branco (ou cinza)
40 segundo plano em preto
41 segundo plano em vermelho
42 segundo plano em verde
43 segundo plano em amarelo (ou marrom)
44 segundo plano em azul
45 segundo plano em púrpura
46 segundo plano em azul-esverdeado
47 segundo plano em branco (ou cinza)
Nem todos os comando irão trabalhar em todos os sistema ou dispositivos de vídeo.
ls usa os seguintes padrões:
NORMAL 0 Texto normal (não é um nome de arquivo)
FILE 0 Arquivo normal
DIR 32 Diretório
LINK 36 Ligação simbólica
ORPHAN undefined Ligação simbólica orfã
MISSING undefined Arquivo perdido
FIFO 31 Pipe nomeado (FIFO)
SOCK 33 Socket
BLK 44;37 Dispositivo de bloco
CHR 44;37 Dispositivo de caractere
EXEC 35 Arquivo executável
Alguns programas de terminal não reconhecem o padrão apropriadamente. Se todo texto é
estiver colorizado depois de você exibir um listagem de diretório, altere os códigos
NORMAL e FILE para o código numérico normal nas cores de primeiro e segundo planos.
OUTROS TIPO DE TERMINAIS (CONFIGURAÇÕES AVANÇADAS)
Se você tem um terminal capaz de exibir cores (ou de outra forma sublinhar) (ou
impressora) que usa um conjunto de códigos de cores diferentes, você pode ainda gerar uma
codificação adequada. Para funcionar assim você terá que usar as definições LEFTCODE,
RIGHTCODE, e ENDCODE.
Quando estiver escrevendo um nome de arquivo, ls gerá a seguinte seqüencia de saída:
LEFTCODE typecode RIGHTCODE filename ENDCODE, onde o typecode é a seqüencia de cores que
depende do tipo ou nome do arquivo. Se o ENDCODE e indefinido, a seqüencia LEFTCODE NORMAL
RIGHTCODE será usada no lugar. O propósito dos left(right)codes é meramente para reduzir a
quantidade de impressão necessária (e para esconder os feios códigos de saída vindo do
usuário). Se eles não são apropriados para seu terminal, você pode eliminá-los pela
especificação da respectiva palavra-chave da linha para si mesma.
NOTA: Se o ENDCODE é definido na seção global do arquivo de configuração, ele não pode
estar indefinido na seção terminal-specific do arquivo. Isto significa que qualquer
definição NORMAL não vai ter qualquer efeito. Um código ENDCODE pode de qualquer forma ser
especificado, o qual deverá ter o mesmo efeito.
ESCAPE SEQUENCES
Para especificar caracteres de controle ou vazios na seqüencia de cor ou nas extensões do
nome de arquivos, uma das notações no estilo C ou \-escaped, ou estilostty podem ser
usadas. A notação no estilo C inclui os seguintes caracteres:
\a Sinal sonoro (ASCII 7)
\b Tecla de retorno (ASCII 8)
\e Tecla de saída (ASCII 27)
\f Puxar folha (ASCII 12)
\n Nova linha (ASCII 10)
\r Retorno de carro (ASCII 13)
\t Tabulação (ASCII 9)
\v Tabulação vertical (ASCII 11)
\? Apaguar (ASCII 127)
\nnn Qualquer caractere (número octal)
\xnnn Qualquer caractere (número hexadecimal)
\_ Espaço
\\ Barra invertida (\)
\^ Circunflexo (^)
\# Símbolo (#)
Por favor note que saídas são necessárias para entrar um espaço, barra invetida,
circunflexo ou qualquer outro caractere de controle em qualquer lugar de um cadeia de
caracteres, e assim como um símbolo # no primeiro caractere.
NOTAS
As definições padrão LEFTCODE e RIGHTCODE , são usadas pelos terminais ISO 6429 são:
LEFTCODE \e[
RIGHTCODE m
O padrão ENDCODE é indefinido.
VEJA TAMBÉM
dircolors(5), ls(1), stty(1), xterm(1)
ARQUIVOS
O arquivo de configuração de todo o sistema para
dircolors é encontrado em /etc/dir_colors .
O arquivo de configuração de cada usuário para
dircolors é encontrado em /~/dir_colors .
NOTAS
Esta página descreve dir_colors como se encontra no pacote Utilitários de Arquivos 4.0;
outras versões podem ser um pouco diferentes. Envie correções e adições para aeb@cwi.nl.
Relatório de problemas no programa para fileutils-bugs@gnu.ai.mit.edu.
TRADUZIDO POR LDP-BR em 21/08/2000.
André L. Fassone Canova <lonelywolf@blv.com.br> (tradução) Roberto Selbach Teixeira
<robteix@zaz.com.br> (revisão)