DIR_COLORS(5)

NOM
dir_colors - Fichier de configuration pour dircolors(1)

DESCRIPTION
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écifique ultérieure à un terminal.

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 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.

  Séquences de couleur ISO 6429 (ANSI)
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.

  Autres types de terminaux (configuration avancée)
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é.

  Séquences d'échappement
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 contre oblique, le Caret et tout caractère de contrôle, y compris le dièse en première position.

FICHIERS

/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 versions peuvent différer légèrement.

NOTES
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.

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

TRADUCTION

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 13 décembre 2007.

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=C man 5 dir_colors ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.