Ubuntu Manpage: tree - Lister le contenu de répertoires sous forme d'arborescence.

NOM

       tree - Lister le contenu de répertoires sous forme d'arborescence.

SYNOPSIS

       tree  [-acdfghilnpqrstuvxACDFJQNSUX]  [-L  niveau  [-R]]  [-H  baseHREF]  [-T  titre]  [-o
       nom_fichier] [-P  motif]  [-I  motif]  [--gitignore]  [--gitfile[=]fichier]  [--matchdirs]
       [--metafirst]   [--ignore-case]   [--nolinks]   [--hintro[=fichier]   [--houtro[=]fichier]
       [--inodes] [--device] [--sort[=]nom]  [--dirsfirst]  [--filesfirst]  [--filelimit  nombre]
       [--si]   [--du]  [--prune]  [--charset[=]X]  [timefmt[=]format]  [--fromfile]  [--fflinks]
       [--info] [--infofile[=]fichier] [--noreport] [--version] [--help] [--] [répertoire ...]

DESCRIPTION

       tree est un programme de listage récursif de répertoires qui produit une liste de fichiers
       indentés  en  profondeur,  coloré à la manière de dircolors si la variable d'environnement
       LS_COLORS est définie et que la sortie est sur une console tty. Sans arguments, tree liste
       les  fichiers du répertoire en cours d'utilisation. Lorsque des répertoires sont donnés en
       argument, tree liste tous les fichiers et/ou  répertoires  trouvés  dans  les  répertoires
       mentionnés  chacun  à  leur  tour.  Après  avoir  affiché tous les fichiers et répertoires
       trouvés, tree renvoie le nombre total de fichiers et/ou de répertoires listés.

       Par défaut, quand un lien symbolique est  rencontré,  le  chemin  auquel  il  renvoie  est
       affiché après le nom du lien sous la forme suivante :

           nom -> chemin-réel

       Si l'option -l est donnée et que le lien symbolique renvoie à un répertoire existant, tree
       suivra le chemin du lien symbolique comme s'il s'agissait d'un répertoire réel.

OPTIONS

       tree comprend les commutateurs en ligne de commande suivants :

OPTIONS DE LISTAGE

-a Tous les fichiers sont affichés. Par défaut, tree n'affiche pas les fichiers cachés
(ceux commençant par un point «. »). En aucun cas, tree n'affiche les
constructeurs du système de fichiers « . » (répertoire courant) et « .. »
(répertoire précédent).

-d Lister uniquement les répertoires.

-l Suivre les liens symboliques s'ils pointent sur des répertoires comme s'ils étaient
des répertoires. Les liens symboliques qui entraîneraient une récursion sont
évités, une fois détectés.

-f Afficher le préfixe du chemin entier pour chaque fichier.

-x Rester exclusivement sur le système de fichiers actuel. À la manière de find -xdev.

-L niveau
Maximum de profondeur d'affichage de l'arborescence des répertoires.

-R Descendre récursivement dans chaque niveau de répertoires de l'arbre (voir l'option
-L) et renvoyer à chaque niveau un fichier nommé OOTree.html (à la manière de -o).

-P motif
Ne lister que les fichiers qui correspondent au motif joker. Il peut y avoir
plusieurs options -P. Note : vous devez utiliser l'option -a pour prendre aussi en
compte les fichiers commençant avec un point « . » pour la correspondance. Les
opérateurs jokers valables sont * (aucun ou tout caractère), ** (aucun ou tout
caractère aussi bien que NULL, c'est à dire /**/ correspondra à un simple /), ?
(tout caractère unique), [...] (tout caractère unique listé entre les crochets (un
tiret facultatif - peut être utilisé pour une plage de caractères, par exemple :
[A-Z])) et [^...] (tout caractère seul non listé entre les crochets), | sépare les
motifs alternés. Un / à la fin du motif correspond à des répertoires, mais pas à
des fichiers.

-I motif
Ne pas lister les fichiers qui correspondent au motif joker. Il peut y avoir
plusieurs options -I. Voir -P ci-dessus pour de l'information sur les motifs
jokers.

--gitignore
Utiliser les fichiers .gitignore de git pour filtrer les fichiers et répertoires.
Utilise aussi $GIT_DIR/info/exclude si présent.

--gitfile[=]fichier
Utiliser fichier explicitement comme un fichier gitignore.

--ignore-case
Si un motif de correspondance est indiqué par l'option -P ou -I, cela fera
correspondre le motif en ignorant la casse (différence majuscule/minuscule) de
chaque lettre.

--matchdirs
Si un motif de correspondance est indiqué par l'option -P, cela fera appliquer le
motif aux noms de répertoires (en plus des noms de fichiers). Dans le cas d'une
correspondance avec le nom de répertoire, la recherche de correspondance est
désactivée pour le contenu du répertoire. Si l'option --prune est utilisée, les
dossiers vides ne seront pas enlevés.

--metafirst
Afficher les métadonnées au début de la ligne plutôt qu'après les lignes
d'indentation.

--prune
Enlever les répertoires vides de l'arbre dans la sortie, utile lorsque l'option est
utilisée conjointement avec -P ou -I. Consulter NOTES ET BOGUES ci-dessous pour
plus d'informations sur cette option.

--info Afficher les commentaires de fichier trouvés dans les fichiers .info. Consulter
ci-dessous .INFO FILES pour plus d'informations sur le format des fichiers .info.

--infofile[=]fichier
Utiliser fichier explicitement comme un fichier info.

--noreport
Ne pas afficher de rapport sur le fichier et le répertoire à la fin de la liste de
l'arbre.

--charset[=]jeu_de_caractères
Définir les caractères à utiliser pour les sorties en HTML et pour dessiner une
ligne.

--filelimit[=]nombre
Ne pas descendre dans les répertoires qui contiennent plus de nombre entrées.

--timefmt[=]format
Afficher (nécessite -D) et formater la date selon la chaîne de format utilisée par
la syntaxe strftime(3).

-o nom_fichier
Diriger la sortie vers nom_fichier.

OPTIONS DE FICHIER

-q Afficher les caractères non affichables dans les noms de fichiers sous forme de
points d'interrogation (?) plutôt que la notation par défaut.

-N Afficher les caractères non imprimables tels quels plutôt que sous forme de nombre
octal protégé.

-Q Noter les noms de fichiers entre guillemets.

-p Afficher le type de fichier et les permissions pour chaque fichier (comme avec ls
-l).

-u Afficher le nom d'utilisateur, ou l'UID si aucun nom utilisateur n'est disponible,
du fichier.

-g Afficher le nom du groupe, ou le GID si aucun nom de groupe n'est disponible,
auquel appartient le fichier.

-s Afficher la taille de chaque fichier en octets avec son nom.

-h Afficher la taille de chaque fichier sous une forme plus humainement lisible, par
exemple en ajoutant une lettre en fonction de la taille, K pour kilooctet, M
mégaoctet, G gigaoctet, T téraoctet, P pétaoctet et E exaoctet.

--si Comme -h mais utilise des unités du Système International (multiples de 1000).

--du Afficher la taille pour chaque répertoire comme étant l'addition des tailles de ses
fichiers et sous-répertoires (ainsi que leurs fichiers, etc). Le chiffre du total
d'espace utilisé est aussi donné dans le rapport final (comme avec la commande
du -c). Cette option nécessite que tree lise l'arborescence entière du répertoire
avant de l'émettre, voir BOGUES ET NOTES ci dessous, nécessite -s.

-D Afficher la date de la dernière modification horaire ou, si -c est utilisé, le
dernier horaire de changement d'état pour le fichier listé.

-F Ajouter / pour les répertoires, = pour les fichiers sockets, * pour les fichier
d'exécutables, « > » pour les portes (Solaris) et « | » pour les FIFO, comme avec
ls -F

--inodes
Afficher le numéro d'inœud du fichier ou du répertoire

--device
Afficher le numéro du périphérique auquel appartient le fichier ou le répertoire

OPTIONS DE TRIAGE

       -v     Trier la sortie par version.

       -t     Trier la sortie par date de dernière modification plutôt qu'alphabétiquement.

       -c     Trier  la  sortie par le dernier changement d'état plutôt qu'alphabétiquement. Cela
              modifie l'option -D (si utilisée) pour afficher le  dernier  changement  d'état  au
              lieu de la date de modification.

       -U     Ne   pas   trier.  Lister  les  fichiers  dans  l'ordre  du  répertoire.  Désactive
              --dirsfirst.

       -r     Trier la sortie dans l'ordre inverse. Cela est un méta-triage qui altère  les  tris
              ci-dessus. Cette option est désactivée lorsque -U est utilisé.

       --dirsfirst
              Lister  les  répertoires avant les fichiers. Cela est un méta-triage qui altère les
              tris ci-dessus. Cette option est désactivée si -U est utilisé.

       --filesfirst
              Lister les fichiers avant les répertoires. Cela est un méta-triage qui  altère  les
              tris cités ci-dessus. Cette option est désactivée lorsque -U est utilisé.

       --sort[=]type
              Trier  la  sortie  par  type plutôt que par nom. Les valeurs possibles sont : ctime
              (-c), mtime (-t), size ou version (-v).

OPTIONS GRAPHIQUES

       -i     Faire que tree n'affiche pas les  lignes  d'indentation,  utile  lorsqu'utilisé  en
              conjonction  avec  l'option  -f.  Supprime  également  autant  d'espaces blancs que
              possible lorsqu'il est utilisé avec les options -J ou -X.

       -A     Activer le  hack  des  lignes  ANSI  graphiques  lors  de  l'affichage  des  lignes
              d'indentation.

       -S     Activer  le  graphisme  des  lignes  CP437  (utile pour utiliser les fontes du mode
              console de Linux). Cette option est l'équivalent actuel de --charset=IBM437 et peut
              éventuellement être obsolète.

       -n     Désactiver tout le temps la colorisation, cette option est écrasée par l'option -C,
              mais écrase CLICOLOR_FORCE si présente.

       -C     Activer tout le temps la colorisation en utilisant les couleurs internes par défaut
              si  les  variables  d'environnement  LS_COLORS ou TREE_COLORS ne sont pas définies.
              Utile pour colorer la sortie dans un tube (pipe).

OPTIONS HTML/JSON/XML

-X Activer la sortie XML. Affiche l'arborescence comme un fichier formaté en XML.

-J Activer la sortie en JSON. Affiche l'arborescence comme un tableau formaté en JSON.

-H baseHREF
Activer la sortie HTML, en incluant des références HTTP. Utile pour les sites ftp.
baseHREF donne l'emplacement ftp de base lorsqu'on utilise la sortie HTML.
C'est-à-dire que le répertoire local peut être /local/ftp/pub, mais il doit être
référencé comme ftp://hostname.organization.domain/pub (baseHREF doit être
ftp://hostname.organization.domain). Conseil : n'utilisez pas les lignes ANSI avec
cette option, et n'indiquez pas plus d'un répertoire dans la liste des répertoires.
Si vous voulez utiliser des couleurs à l'aide d'une feuille de style CSS, utilisez
l'option -C en plus de cette option pour forcer la sortie en couleurs.

--hintro[=]fichier
Utiliser fichier comme introduction HTML à la place de celle par défaut. Utiliser
un fichier vide ou /dev/null pour éliminer l'introduction complètement.

--houtro[=]fichier
Utiliser fichier comme séquence finale HTML à la place de celle par défaut.
Utiliser un fichier vide ou /dev/null pour éliminer cette séquence complètement.

-T titre
Définir le titre et la chaîne d'en-tête H1 dans le mode de sortie HTML.

--nolinks
Désactiver les hyperliens dans la sortie HTML.

OPTIONS D'ENTRÉE

       --fromfile
              Lire  une  liste  de  répertoires depuis un fichier plutôt que depuis le système de
              fichiers. Les chemins fournis sur la ligne de commande sont  des  fichiers  à  lire
              plutôt  que des répertoires à rechercher. Le répertoire point (.) indique à tree de
              lire les chemins depuis l'entrée standard. NOTE : cela ne convient que pour lire la
              sortie  d'un  programme  comme  find,  pas  tree  -fi  étant  donné  que  les liens
              symboliques ne sont pas distingués des fichiers contenant juste  « -> »   dans  une
              partie de leur nom de fichier à moins que l'option --fflinks ne soit utilisée.

       --fflinks
              Traiter  les  informations  sur  un lien symbolique trouvées dans un fichier, comme
              dans la sortie de 'tree -fi --noreport'. Seule la première occurrence de la  chaîne
              ' -> ' est utilisée pour indiquer la séparation le nom du fichier et le lien.

OPTIONS DIVERSES

       --help Afficher une liste d'utilisation détaillée.

       --version
              Afficher la version de tree.

       --     Fin du traitement d'options. Aucune autre option ne sera traitée après cela.

FICHIERS .INFO

       Les fichiers .info sont similaires aux fichiers .gitignore, si un fichier .info est trouvé
       lors du parcours d'un répertoire, il est lu et ajouté à  une  pile  d'informations  .info.
       Chaque  fichier  est  composé  de commentaires (lignes commençant par un dièse (#)), ou de
       motifs jokers qui peuvent correspondre à un fichier relatif au répertoire dans lequel  est
       trouvé  le  fichier  .info.  Si  un  fichier  doit correspondre à un motif, le commentaire
       indenté par une tabulation qui suit le motif est utilisé comme commentaire de fichier.  Un
       commentaire  se termine par une ligne non indentée. Plusieurs motifs, chacun sur une ligne
       peuvent partager le même commentaire.

FICHIERS

       /etc/DIR_COLORS          Base de données des couleurs du système.
       ~/.dircolors             Base de données des couleurs de l'utilisateur.
       .gitignore               Fichier d'exclusion Git
       $GIT_DIR/info/exclude    Liste globale d'exclusion de fichiers git
       .info                    Fichier de commentaires du fichier
       /usr/share/finfo/global_info  Fichier global des commentaires de fichier

ENVIRONNEMENT

       LS_COLORS      Informations sur les couleurs créées par dircolors
       TREE_COLORS    Utiliser cela pour les informations sur les couleurs en plus  de  LS_COLORS
       si elle est définie.
       TREE_CHARSET   Jeu de caractères à utiliser en mode HTML pour l'arbre.
       CLICOLOR       Activer  la  coloration  même  si  TREE_COLORS  ou  LS_COLORS  ne  sont pas
       définies.
       CLICOLOR_FORCE Toujours activer la colorisation (en fait -C)
       NO_COLOR       Désactiver la colorisation (en fait -n) (consulter https://no-color.org/)
       LC_CTYPE       Paramètres régionaux pour la sortie du nom de fichier.
       LC_TIME        Paramètres régionaux pour la sortie de timefmt, consulter strftime(3).
       TZ             Fuseau horaire pour la sortie de timefmt, consulter strftime(3).
       STDDATA_FD     Activer la fonction  stddata,  optionnellement  définir  le  descripteur  à
       utiliser.

AUTEUR

       Steve Baker (ice@mama.indstate.edu)
       Sortie HTML faite par Francesc Rocher (rocher@econ.udg.es)
       Prise en charge de jeux de caractères et de OS/2 par Kyosuke Tokoro (NBG01720@nifty.ne.jp)

BOGUES ET NOTES

tree ne supprime pas les répertoires « vides » lorsque les options -P et -I sont utilisées
par défaut. Utilisez l'option --prune.

Les options -h et --si arrondissent au nombre entier le plus proche alors que les
implémentaions de ls l'arrondissent toujours à l'entier supérieur.

Supprimer des fichiers et répertoires avec les options -I, -P et --filelimit peut conduire
à un rapport incorrect du nombre de fichiers et de répertoires.

Les options --prune et --du font que tree accumule l'arbre entier en mémoire avant de
l'émettre. Pour de grandes arborescences, cela peut causer un délai non négligeable pour
la sortie et l'utilisation d'une grande quantité de mémoire.

Le tampon d'expansion timefmt est ridiculement limité à un maximum de 255 caractères. La
sortie de chaînes de temps plus longues que cela seront indéfinies, mais il est assuré
qu'elles n'excèderont pas 255 caractères.

Les arbres XML et JSON ne sont pas colorés, ce qui est un peu dommage.

Probablement plus.

À partir de la version 2.0.0, dans Linux, tree essaiera de produire automatiquement un
arbre JSON compact sur le descripteur de fichier 3 (appelé ici stddata), s'il est présent
et que la variable d'environnement STDDATA_FD est définie ou posiotionnée à une valeur de
descripteur de fichier positive non nulle à utiliser dans la sortie. Il est à espérer
qu'un jour un meilleur interpréteur de commande Linux/Unix puisse utiliser cette
fonctionnalité, même si BSON serait probablement un meilleur format pour cela.

VOIR AUSSI

       dircolors(1), ls(1), find(1), du(1), strftime(3) gitignore(5)

TRADUCTION

       La  traduction  française  de  cette  page  de  manuel  a  été  créée  par  Baptiste Mélès
       <baptiste.meles@ens.fr> et bubu <bubub@no-log.org>

       Cette traduction est une documentation libre ; veuillez vous reporter  à  la  GNU  General
       Public   License   version 3  ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩  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⟩.