DOKK / manpages / debian 10 / manpages-pt / dir_colors.5.pt
DIR_COLORS(5) File Formats Manual DIR_COLORS(5)

dir_colors - arquivo de configuração para dircolors(1)

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:

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.
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.
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.
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.
Especifica a cor usada para texto normal (não nome de arquivo).
Especifica a cor usada para arquivos regulares.
Especifica a cor usada para diretórios.
Especifica a cor usada para ligações simbólicas.
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.
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.
Especifica a cor usada por um FIFO (pipe nomeado).
Especifica a cor usada por um socket.
Especifica a cor usada por um arquivo especial de bloco.
Especifica a cor usada por um arquivo especial de caractere.
Especifica a cor usada por um arquivo executável.
Especifica o left code para terminais que não são terminais ISO 6429 (veja abaixo).
Especifica o right code para terminais que não são terminais ISO 6429 (veja abaixo).
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.

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.

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.

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.

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.

dircolors(5), ls(1), stty(1), xterm(1)

dircolors é encontrado em /etc/dir_colors .
dircolors é encontrado em /~/dir_colors .

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.

André L. Fassone Canova <lonelywolf@blv.com.br> (tradução) Roberto Selbach Teixeira <robteix@zaz.com.br> (revisão)

11/1998 Utilit. de Arquivos GNU 4.0