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)