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érence 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)

Toutes les commandes ne fonctionnent pas sur tous les terminaux.

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

Peu de terminaux ne reconnaissent pas les valeurs par défaut correctement. Si tout le texte est colorié après avoir affiché le contenu d’un répertoire, changez les codes NORMAL et FILE pour les codes numériques de vos encre et fond habituels.

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 (#)

Notez que les échappements sont nécessaires pour protéger l’espace, la barre oblique inverse, le Caret et tout caractère de contrôle, y compris le dièse en première position.

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

LEFTCODE  \e[
RIGHTCODE m

Par défaut, ENDCODE est indéfini.

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 paquetage fileutils-4.1 ; d’autres version peuvent différer légèrement.

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 25 juillet 2003 et révisée le 2 mai 2006.

L’équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=en man 5 dir_colors ». N’hésitez pas à signaler à l’auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.