Ubuntu Manpage: dir_colors - Fichier de configuration pour dircolors(1)

NOM

       dir_colors - Fichier de configuration pour dircolors(1)

DESCRIPTION

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 :

TERM type-terminal
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.

COLOR yes|all|no|none|tty
(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.

EIGHTBIT yes|no
(Slackware seulement, ignorée par la version GNU de dircolors(1)). Précise que les caractères à
huit bits ISO/IEC 8859 doivent être activé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é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.

NORMAL séquence-couleur
Définit la couleur à employer pour le texte normal (hormis les noms de fichiers).

Synonyme : NORM.

FILE séquence-couleur
Définit la couleur à utiliser pour les fichiers normaux.

DIR séquence-couleur
Définit la couleur à utiliser pour les répertoires.

LINK séquence-couleur
Définit la couleur à utiliser pour les liens symboliques.

Synonymes : LNK, SYMLINK.

ORPHAN séquence-couleur
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.

MISSING séquence-couleur
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.

FIFO séquence-couleur
Définit la couleur pour afficher une FIFO (tube nommé).

Synonyme : PIPE.

SOCK séquence-couleur
Définit la couleur pour afficher un socket.

DOOR séquence-couleur
(Géré depuis fileutils 4.1) Définit la couleur pour afficher une « porte » (« door ») (Solaris 2.5
et ultérieur).

BLK séquence-couleur
Définit la couleur pour afficher un fichier spécial de périphérique bloc.

Synonyme : BLOCK.

CHR séquence-couleur
Définit la couleur pour afficher un fichier spécial de périphérique caractère.

Synonyme : CHAR.

EXEC séquence-couleur
Définit la couleur pour afficher un fichier dont l'attribut exécutable est positionné.

SUID séquence-couleur
Définit la couleur pour afficher un fichier dont l'attribut Set-UID est positionné.

Synonyme : SETUID.

SGID séquence-couleur
Définit la couleur pour afficher un fichier dont l'attribut Set-GID est positionné.

Synonyme : SETGID.

STICKY séquence-couleur
Définit la couleur pour afficher un fichier dont l'attribut « sticky » est positionné.

STICKY_OTHER_WRITABLE séquence-couleur
Définit la couleur pour afficher un répertoire accessible en écriture à tous dont l'attribut
exécutable est positionné.

Synonyme : OWT.

OTHER_WRITABLE séquence-couleur
Définit la couleur pour afficher un répertoire accessible en écriture à tous sans l'attribut
exécutable positionné.

Synonyme : OWR.

LEFTCODE séquence-couleur
Définit le code gauche pour les terminaux non-ISO/IEC 6429 (voir plus bas).

Synonyme : LEFT.

RIGHTCODE séquence-couleur
Définit le code droit pour les terminaux non-ISO/IEC 6429 (voir plus bas).

Synonyme : RIGHT.

ENDCODE séquence-couleur
Définit le code final pour les terminaux non-ISO/IEC 6429 (voir plus bas).

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.

Séquences de couleur ISO/IEC 6429 (ANSI)
La plupart des terminaux ASCII actuels utilisent les séquences ISO/IEC 6429 (ANSI), et de nombreux
terminaux ne gérant pas la couleur, comme l'émulateur xterm et le très utilisé et très cloné DEC VT100,
reconnaissent les codes de couleur ISOIEC 6429 et les éliminent sans problème de la sortie ou les
émulent. Par défaut, ls utilise les codes ISO/IEC 6429 si la couleur est activée.

Les séquences de couleurs ISO/IEC 6429 sont composées de suites de nombres séparés par des
points-virgules. Les codes les plus courants sont :
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
47 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.

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

Séquences d’échappement
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 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
\\ barre oblique inverse (\)
\^ 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.

FICHIERS

       /etc/DIR_COLORS
              Fichier de configuration  système.  (Slackware,  SuSE  et  RedHat  uniquement  ;  ignoré  par  GNU
              dircolors(1) et donc Debian.)

       ~/.dir_colors
              (Slackware,  SuSE  et  RedHat uniquement ; ignoré par GNU dircolors(1) et donc Debian.) 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.

NOTES

       Les définitions de LEFTCODE et de RIGHTCODE par défaut, pour les terminaux ISO/IEC 6429 sont :
              LEFTCODE    \e[
              RIGHTCODE   m

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

VOIR AUSSI

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

TRADUCTION

       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.

Pages du manuel de Linux 6.9.1                    16 juin 2024                                     dir_colors(5)