TREE(1)

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] [--matchdirs] [--metafirst] [--ignore-case] [--nolinks] [--inodes] [--device] [--sort[=]nom] [--dirsfirst] [--filesfirst] [--filelimit n] [--si] [--du] [--prune] [--timefmt[=]format] [--fromfile] [--info] [--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, qui est 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 LISTE

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

-d  Lister uniquement les répertoires.

-l  Suivre les liens symboliques s'ils pointent sur ses 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 pour chacun d'eux exécuter de nouveau tree en y ajoutant `-o OOTree.html' comme nouvelle option.

-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 par un point « . » pour la correspondance. Les opérateurs de joker valables sont * (aucun ou tout caractère), ** (aucun ou tout caractère aussi bien que NULL, par exemple /**/ 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 unique non listé entre les crochets), et | sépare des motifs alternatifs. 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 des informations 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.

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

--matchdirs
    Appliquer le motif aux noms de répertoires (en plus des noms de fichiers), si le motif de correspondance est spécifié par l'option -P, 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 fichiers trouvés dans les fichiers .info. Consulter .INFO FILES pour plus d'information sur le format des fichiers .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 le jeu de caractères à utiliser pour les sorties en HTML et pour dessiner une ligne.

--filelimit n
    Ne pas descendre dans les répertoires qui contiennent plus de n 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 (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 état de changement horaire pour le fichier listé.

-F  Ajouter un / pour les répertoires, = pour les fichiers sockets, * pour les fichier d'exécutables, un `>' 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éticalement. 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éga-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égatriage 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égatriage 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  tree n'affiche pas les lignes d'indentation, utile lorsqu'utilisé en conjonction avec l'option -f. Supprime également autant d'espaces 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 polices du mode console de Linux). Cette option est l'équivalent actuel de --charset=IBM437 et peut éventuellement être dépréciée.

-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, utilise la couleur intégrée par défaut si les variables d'environnement LS_COLORS ou TREE_COLORS ne sont pas définies. Utile pour colorer la sortie vers 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 lorsque l'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 via une feuille de style CSS, utilisez l'option -C en plus de cette option pour forcer la sortie en couleurs.

-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épertoire 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 peuvent pas (jusqu'à présent) être distingués des fichiers contenant juste ' -> ' dans une partie de leur nom de fichier.

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 faire correspondre un fichier relatif au répertoire dans lequel est trouvé le fichier .info. Si un fichier doit correspondre à un motif, le commentaire indenté d'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ée 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 de couleur créées par dircolors
TREE_COLORS    Utiliser cela pour les informations de couleur 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)
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émentations 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 garanti quelles 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 positionné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 ou 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.