dir_colors - Fichier de configuration pour dircolors(1).

Le programme ls(1) utilise la variable d'environnement LS_COLORS pour déterminer les couleurs avec lesquelles afficher les noms de fichiers. Cette variable d'environnement est en principe remplie par une commande

eval `dircolors some_path/dir_colors`

dans un fichier d'initialisation du shell, comme /etc/profile ou /etc/csh.cshrc. (Voir également dircolors(1)). Habituellement, le fichier est /etc/DIR_COLORS et peut être surchargé par un fichier .dir_colors dans le répertoire personnel de l'utilisateur.

Ce fichier de configuration consiste en plusieurs lignes de déclarations. Un dièse (#) en début de ligne, précédé eventuellement d'espaces blancs, transforme cette ligne en commentaire qui sera ignoré. Les lignes blanches sont ignorées.

La section global du fichier contient toutes les déclarations avant la première ligne TERM. Toute déclaration dans la section globale est considérée comme valide pour tous les types de terminaux. Après cette section on trouve une ou plusieurs sections spécifiques aux terminaux, précédées par une ou plusieurs lignes TERM qui indiquent à quels types (au sens de la variable d'environnement TERM) de terminaux, les déclarations s'appliquent. Il est toujours possible de surcharger une déclaration globale par une déclaration spécique à un terminal ultérieure.

Les déclarations suivantes sont reconnues (sans différences maj/minuscules)

TERM type-terminal

Débute une section spécique à un terminal et indique auquel elle s'applique. Plusieurs déclarations TERM successives permettent de créer des sections qui s'appliquent à plusieurs types de terminaux.

COLOR yes|all|no|none|tty

(Slackware seulement, ignoré par la version GNU de dircolors(1)). Indique que la couleur doit toujours être utilisée (yes ou all), jamais utilisée (no ou none), ou employée seulement si la sortie est un terminal (tty). La valeur par défaut est no.

EIGHTBIT yes|no

(Slackware seulement, ignoré par la version GNU de dircolors(1)). Indique que les caractères huits bits ISO 8859 sont autorisés par défaut. Pour des raisons de compatibilité, on peut aussi écrire 1 pour yes et 0 pour no. La valeur par défaut est no.

OPTIONS options

(Slackware seulement, ignoré par la version GNU de dircolors(1)). Ajouter les options sur la ligne de commande de ls. Il peut s'agir de n'importe quelle option valide de ls, et devait inclure le signe moins en début d'option. Notez bien que dircolors ne vérifie pas la validité de ces options.

NORMAL séquence-couleur

Indique la couleur à employer pour le texte normal (hors noms de fichiers).

FILE séquence-couleur

Indique la couleur à utiliser pour les fichiers normaux.

DIR séquence-couleur

Indique la couleur à utiliser pour les répertoires.

LINK séquence-couleur

Indique la couleur à utiliser pour les liens symboliques.

ORPHAN séquence-couleur

Indique la couleur à utiliser pour les liens symboliques orphelins(ceux qui pointent sur un fichier inexistant). Si rien n'est indiqué, ls utilisera la couleur LINK par défaut.

MISSING séquence-couleur

Indique la couleur à utiliser pour un fichier manquant (inexistant bien qu'un lien symbolique pointe dessus). Si rien n'est indiqué, ls utilisera la couleur FILE par défaut.

FIFO séquence-couleur

Indique la couleur pour afficher une FIFO (tube nommé).

SOCK séquence-couleur

Indique la couleur pour afficher une socket.

DOOR séquence-couleur

(Supporté depuis file-utils 4.1) Indique la couleur pour afficher une "door" (Solaris 2.5 et ultérieur).

BLK séquence-couleur

Indique la couleur pour afficher un périphérique spécial bloc.

CHR séquence-couleur

Indique la couleur pour afficher un périphérique spécial caractère.

EXEC séquence-couleur

Indique la couleur pour afficher un fichier avec l'attribut exécutable.

LEFTCODE séquence-couleur

Indique le code gauche pourles terminaux non-ISO 6429 (voir plus bas).

RIGHTCODE séquence-couleur

Indique le code droit pour les terminaux non-ISO 6429 (voir plus bas).

ENDCODE séquence-couleur

Indique le code final pour les terminaux non-ISO 6429 (voir plus bas).

*extension séquence-couleur

Indique la couleur pour tous les fichiers se terminant par l'extension.

.extension séquence-couleur

Comme *.extension. Indique la couleur pour tous les fichiers se terminant par .extension. Notez que le point est inclus dans l'extension, ce qui rend impossible de préciser une extension ne commençant pas par un point, comme ~ pour les fichiers de sauvegarde emacs. Cette forme doit être considérée comme obsolète.

La plupart des terminaux Ascii actuels utilisent les séquences ISO 6429 (ANSI), et ne nombreux terminaux sans couleurs, comme l'émulateur xterm et le très cloné DEC VT100, reconnaissent les codes de couleur ISO 6429 et les éliminent sans problème ou les émulent. Par défaut, ls utilise les codes ISO 6429 si la couleur est validée.

Les séquences de couleurs ISO 6429 sont composées de suite de nombres séparés par des points-virgules. Les codes les plus courants sont :

 0     restituer la couleur par défaut
 1     couleur en sur-brillance
 4     texte souligné
 5     texte clignotant
30     encre noire
31     encre rouge
32     encre verte
33     encre jaune (ou marron)
34     encre bleue
35     encre violette
36     encre cyan
37     encre blanche (ou grise)
40     fond noir
41     fond rouge
42     fond vert
43     fond jaune (ou marron)
44     fond bleu
45     fond violet
46     fond cyan
47     fond blanc (ou gris)

ls utilise les valeurs suivantes par défaut :

NORMAL   0       Texte normal (hors noms de fichiers)
FILE     0       Fichier normal
DIR      32      Répertoire
LINK     36      Lien symbolique
ORPHAN   undefined       Lien symbolique orphelin
MISSING  undefined       Fichier manquant
FIFO     31      Tube nommé (FIFO)
SOCK     33      Socket
BLK      44;37   Périphérique bloc
CHR      44;37   périphérique caractère
EXEC     35      Fichier exécutable

Si vous avez un terminal couleur (ou gérant d'autre attributs), voire une imprimante, qui utilise un jeu de codes différents, vous pouvez toujours le configurer corectement en utilisant les définitions LEFTCODE, RIGHTCODE, et ENDCODE.

Lorsqu'il affiche un nom de fichier, ls produit la séquence de sortie suivante : LEFTCODE code-type RIGHTCODE nom-fichier ENDCODE, où code-type est la séquence de couleur qui dépend du type ou nom de fichier. Si ENDCODE est indéfinie, la séquence LEFTCODE NORMAL RIGHTCODE est utilisée à la place. Le but des codes gauche et droits est de réduire sérieusement la saisie (et de cacher les codes d'échappement horribles). S'il n'y en a pas besoin, vous pouvez les supprimer en spécifiant le mot clé correspondant sur une ligne isolée.

NOTE : SI ENDCODE est défini dans la section global du fichier, il ne peut pas être indéfini dans une section spécifique ultérieure. Ceci signifie que toute définition NORMAL n'aura aucun effet. Un ENDCODE peut toutefois être indiqué, avec l'effet désiré.

Pour spécifier des caractères de contrôle ou des blancs dans la séquence de couleur ou les extensions des noms de fichier, on peut employer la notation C préfixée par un \, ou la notation ^ comme stty -style. La notation C contient les séquences suivantes :

\a	Bell (ASCII 7)
\b	Backspace (ASCII 8)
\e	Escape (ASCII 27)
\f	Form feed (ASCII 12)
\n	Newline (ASCII 10)
\r	Carriage Return (ASCII 13)
\t	Tab (ASCII 9)
\v	Vertical Tab (ASCII 11)
\?	Delete (ASCII 127)
\nnn	Tout caractère (code octal)
\xnnn	Tout caractère (code hexadécimal)
\_	Space
\\	Backslash (\)
\^	Caret (^)
\#	Hash mark (#)

Les définitions LEFTCODE et RIGHTCODE par défaut, pour les terminaux ISO 6429 sont :

LEFTCODE  \e[
RIGHTCODE m

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

/etc/DIR_COLORS

Fichier de configuration global au système.

~/.dir_colors

Fichier de configuration pour l'utilisateur.

Cette page décrit le format du fichier dir_colors utilisé dans le paquet fileutils-4.1 ; d'autres version peuvent différer légèrement.

Christophe Blaess, 2003.