dir_colors(5) File Formats Manual dir_colors(5)

dir_colors - Fichier de configuration pour dircolors(1)

Le programme ls(1) utilise la variable d'environnement LS_COLORS pour définir les couleurs avec lesquelles les noms de fichiers seront affichés. Cette variable d'environnement est habituellement définie par une commande telle que :

eval `dircolors chemin/dir_colors`

qui se trouve dans un fichier d'initialisation par défaut de l'interpréteur de commandes, valable pour l'ensemble du système, comme /etc/profile ou /etc/csh.cshrc. (Consultez également dircolors(1)). Habituellement, le fichier utilisé ici est /etc/DIR_COLORS et peut être surchargé par un fichier .dir_colors se trouvant dans le répertoire personnel de l'utilisateur.

Ce fichier de configuration consiste en plusieurs lignes de déclarations. Tout ce qui se trouve à droite d'un dièse « # » est considéré comme commentaire, si ce dièse se trouve en début de ligne ou se trouve précédé par au moins un espace. Les lignes vides sont ignorées.

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

Les déclarations suivantes sont reconnues ; la casse n'est pas significative :

Débute une section spécifique à un terminal et indique celui auquel elle s'applique. Plusieurs déclarations TERM successives peuvent être utilisées pour créer une section qui s'applique à plusieurs types de terminaux.
(Slackware seulement, ignorée par la version GNU de dircolors(1)). Précise si la colorisation doit toujours être activée (yes ou all), jamais utilisée (no ou none), ou n'être employée que si la sortie est un terminal (tty). La valeur par défaut est no.
(Slackware only; ignored by GNU dircolors(1).) Specifies that eight-bit ISO/IEC 8859 characters should be enabled by default. For compatibility reasons, this can also be specified as 1 for yes or 0 for no. The default is no.
(Slackware seulement, ignorée par la version GNU de dircolors(1)). Ajoute les options de la ligne de commande à la ligne de commande par défaut de ls. Il peut s'agir de n'importe quelle option valable de ls, et doit inclure le signe moins de tête. Notez bien que dircolors ne vérifie pas la validité de ces options.
Définit la couleur à employer pour le texte normal (hormis les noms de fichiers).
Synonyme : NORM.
Définit la couleur à utiliser pour les fichiers normaux.
Définit la couleur à utiliser pour les répertoires.
Définit la couleur à utiliser pour les liens symboliques.
Synonymes : LNK, SYMLINK.
Définit la couleur à utiliser pour les liens symboliques orphelins (ceux qui pointent vers un fichier inexistant). Si rien n'est indiqué, ls utilisera la couleur LINK par défaut.
Définit la couleur à utiliser pour un fichier manquant (fichier inexistant bien qu'un lien symbolique pointe vers lui). Si rien n'est indiqué, ls utilisera la couleur FILE par défaut.
Définit la couleur pour afficher une FIFO (tube nommé).
Synonyme : PIPE.
Définit la couleur pour afficher un socket.
(Géré depuis fileutils 4.1) Définit la couleur pour afficher une « porte » (« door ») (Solaris 2.5 et ultérieur).
Définit la couleur pour afficher un fichier spécial de périphérique bloc.
Synonyme : BLOCK.
Définit la couleur pour afficher un fichier spécial de périphérique caractère.
Synonyme : CHAR.
Définit la couleur pour afficher un fichier dont l'attribut exécutable est positionné.
Définit la couleur pour afficher un fichier dont l'attribut Set-UID est positionné.
Synonyme : SETUID.
Définit la couleur pour afficher un fichier dont l'attribut Set-GID est positionné.
Synonyme : SETGID.
Définit la couleur pour afficher un fichier dont l'attribut « sticky » est positionné.
Définit la couleur pour afficher un répertoire accessible en écriture à tous dont l'attribut exécutable est positionné.
Synonyme : OWT.
Définit la couleur pour afficher un répertoire accessible en écriture à tous sans l'attribut exécutable positionné.
Synonyme : OWR.
Specifies the left code for non-ISO/IEC 6429 terminals (see below).
Synonyme : LEFT.
Specifies the right code for non-ISO/IEC 6429 terminals (see below).
Synonyme : RIGHT.
Specifies the end code for non-ISO/IEC 6429 terminals (see below).
Synonyme : END.
*extension séquence-couleur
Définit la couleur pour tous les fichiers se terminant par l'extension.

.extension séquence-couleur
Identique à *.extension. Définit 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.

Most color-capable ASCII terminals today use ISO/IEC 6429 (ANSI) color sequences, and many common terminals without color capability, including xterm and the widely used and cloned DEC VT100, will recognize ISO/IEC 6429 color codes and harmlessly eliminate them from the output or emulate them. ls uses ISO/IEC 6429 codes by default, assuming colorization is enabled.

ISO/IEC 6429 color sequences are composed of sequences of numbers separated by semicolons. The most common codes are:

0 pour restaurer la couleur par défaut
1 pour les couleurs plus claires
4 pour le texte souligné
5 pour le texte clignotant
30 pour un premier plan noir
31 pour un premier plan rouge
32 pour un premier plan vert
33 pour un premier plan jaune (ou marron)
34 pour un premier plan bleu
35 pour un premier plan violet
36 pour un premier plan cyan
37 pour un premier plan blanc (ou gris)
40 pour un arrière-plan noir
41 pour un arrière-plan rouge
42 pour un arrière-plan vert
43 pour un arrière-plan jaune (ou marron)
44 pour un arrière-plan bleu
45 pour un arrière-plan violet
46 pour un arrière-plan cyan
17 pour un arrière-plan blanc (ou gris)

Les commandes ne fonctionnent pas toutes sur tous les systèmes ou sur tous les périphériques d'affichage.

ls utilise les valeurs par défaut suivantes :

NORMAL 0 texte normal (hormis les noms de fichiers)
FICHIER 0 fichier normal
DIR 32 répertoire
LINK 36 lien symbolique
ORPHAN non défini lien symbolique orphelin
MISSING non défini 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

Quelques programmes de terminaux ne reconnaissent pas correctement les valeurs par défaut. Si tout le texte se trouve colorisé après avoir affiché le contenu d'un répertoire, changez les codes NORMAL et FILE pour les codes numériques de vos écriture et fond habituels.

Si vous avez un terminal couleur (ou gérant la surbrillance), voire une imprimante, qui utilise un jeu de codes différent, vous pouvez toujours créer une configuration adaptée. Il vous faudra utiliser les définitions de 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 n'est pas défini, la séquence LEFTCODE NORMAL RIGHTCODE sera utilisée à la place. Le but des codes gauche et droit est simplement de réduire la saisie au clavier nécessaire (et de cacher à l'utilisateur les horribles codes de déspécification). S'ils ne sont pas adaptés à votre terminal, vous pouvez les supprimer en indiquant le mot clé correspondant sur une ligne isolée.

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

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

\a sonnerie (ASCII 7)
\b retour arrière (ASCII 8)
\e échappement (ASCII 27)
\f saut de page (ASCII 12)
\n changement de ligne (ASCII 10)
\r retour chariot (ASCII 13)
\t tabulation horizontale (ASCII 9)
\v tabulation verticale (ASCII 11)
\? suppression (ASCII 127)
\nnn tout caractère (notation octale)
\xnnn tout caractère (notation hexadécimale)
\_ espace
\\ antislash (\)
\^ accent circonflexe (^)
\# Dièse (#)

Notez que les caractères de protection sont nécessaires pour l'espace, la barre oblique inverse, l'accent circonflexe et tous les caractères de contrôle n'importe où dans la chaîne, y compris le dièse en première position.

/etc/DIR_COLORS
Fichier de configuration système.
~/.dir_colors
Fichier de configuration de l'utilisateur.

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

The default LEFTCODE and RIGHTCODE definitions, which are used by ISO/IEC 6429 terminals are:

LEFTCODE \e[
RIGHTCODE m

Par défaut, ENDCODE est n'est pas défini.

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

La traduction française de cette page de manuel a été créée par Christophe Blaess https://www.blaess.fr/christophe/, Stéphan Rafin <stephan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>, François Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe Guérard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas Huriaux <thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centraliens.net>, Florentin Duneau <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-bretagne.fr>, Denis Barbier <barbier@debian.org>, David Prévot <david@tilapin.org> et Jean-Pierre Giraud <jean-pierregiraud@neuf.fr>

Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à debian-l10n-french@lists.debian.org.

2 mai 2024 Pages du manuel de Linux 6.8