TREE(1) General Commands Manual TREE(1) NOM tree - Lister le contenu de repertoires 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] [--fromtabfile] [--fflinks] [--info] [--infofile[=]fichier] [--noreport] [--version] [--help] [--] [repertoire ...] DESCRIPTION tree est un programme de listage recursif de repertoires qui produit une liste de fichiers indentes en profondeur, colore a la maniere de dircolors si la variable d'environnement LS_COLORS est definie et que la sortie est sur une console tty. Sans arguments, tree liste les fichiers du repertoire en cours d'utilisation. Lorsque des repertoires sont donnes en argument, tree liste tous les fichiers et/ou repertoires trouves dans les repertoires mentionnes chacun a leur tour. Apres avoir affiche tous les fichiers et repertoires trouves, tree renvoie le nombre total de fichiers et/ou de repertoires listes. Par defaut, quand un lien symbolique est rencontre, le chemin auquel il renvoie est affiche apres le nom du lien sous la forme suivante : nom -> chemin-reel Si l'option -l est donnee et que le lien symbolique renvoie a un repertoire existant, tree suivra le chemin du lien symbolique comme s'il s'agissait d'un repertoire reel. OPTIONS tree comprend les commutateurs en ligne de commande suivants : OPTIONS DE LISTAGE -a Tous les fichiers sont affiches. Par defaut, tree n'affiche pas les fichiers caches (ceux commencant par un point <<. >>). En aucun cas, tree n'affiche les constructeurs du systeme de fichiers << . >> (repertoire courant) et << .. >> (repertoire precedent). -d Lister uniquement les repertoires. -l Suivre les liens symboliques s'ils pointent sur des repertoires comme s'ils etaient des repertoires. Les liens symboliques qui entraineraient une recursion sont evites, une fois detectes. -f Afficher le prefixe du chemin entier pour chaque fichier. -x Rester exclusivement sur le systeme de fichiers actuel. A la maniere de find -xdev. -L niveau Maximum de profondeur d'affichage de l'arborescence des repertoires. -R Descendre recursivement dans chaque niveau de repertoires de l'arbre (voir l'option -L) et renvoyer a chaque niveau un fichier nomme OOTree.html (a la maniere 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 commencant avec un point << . >> pour la correspondance. Les operateurs jokers valables sont * (aucun ou tout caractere), ** (aucun ou tout caractere aussi bien que NULL, c'est a dire /**/ correspondra a un simple /), ? (tout caractere unique), [...] (tout caractere unique liste entre les crochets (un tiret facultatif - peut etre utilise pour une plage de caracteres, par exemple : [A-Z])) et [^...] (tout caractere seul non liste entre les crochets), | separe les motifs alternes. Un / a la fin du motif correspond a des repertoires, mais pas a 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 repertoires. Utilise aussi $GIT_DIR/info/exclude si present. --gitfile[=]fichier Utiliser fichier explicitement comme un fichier gitignore. --ignore-case Si un motif de correspondance est indique par l'option -P ou -I, cela fera correspondre le motif en ignorant la casse (difference majuscule/minuscule) de chaque lettre. --matchdirs Si un motif de correspondance est indique par l'option -P, cela fera appliquer le motif aux noms de repertoires (en plus des noms de fichiers). Dans le cas d'une correspondance avec le nom de repertoire, la recherche de correspondance est desactivee pour le contenu du repertoire. Si l'option --prune est utilisee, les dossiers vides ne seront pas enleves. --metafirst Afficher les metadonnees au debut de la ligne plutot qu'apres les lignes d'indentation. --prune Enlever les repertoires vides de l'arbre dans la sortie, utile lorsque l'option est utilisee conjointement avec -P ou -I. Consulter NOTES ET BOGUES ci-dessous pour plus d'informations sur cette option. --info Afficher les commentaires de fichier trouves 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 repertoire a la fin de la liste de l'arbre. --charset[=]jeu_de_caracteres Definir les caracteres a utiliser pour les sorties en HTML et pour dessiner une ligne. --filelimit[=]nombre Ne pas descendre dans les repertoires qui contiennent plus de nombre entrees. --timefmt[=]format Afficher (necessite -D) et formater la date selon la chaine de format utilisee par la syntaxe strftime(3). -o nom_fichier Diriger la sortie vers nom_fichier. OPTIONS DE FICHIER -q Afficher les caracteres non affichables dans les noms de fichiers sous forme de points d'interrogation (?) plutot que la notation par defaut. -N Afficher les caracteres non imprimables tels quels plutot que sous forme de nombre octal protege. -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 megaoctet, G gigaoctet, T teraoctet, P petaoctet et E exaoctet. --si Comme -h mais utilise des unites du Systeme International (multiples de 1000). --du Afficher la taille pour chaque repertoire comme etant l'addition des tailles de ses fichiers et sous-repertoires (ainsi que leurs fichiers, etc). Le chiffre du total d'espace utilise est aussi donne dans le rapport final (comme avec la commande du -c). Cette option necessite que tree lise l'arborescence entiere du repertoire avant de l'emettre, voir BOGUES ET NOTES ci dessous, necessite -s. -D Afficher la date de la derniere modification horaire ou, si -c est utilise, le dernier horaire de changement d'etat pour le fichier liste. -F Ajouter / pour les repertoires, = pour les fichiers sockets, * pour les fichier d'executables, << > >> pour les portes (Solaris) et << | >> pour les FIFO, comme avec ls -F --inodes Afficher le numero d'inoeud du fichier ou du repertoire --device Afficher le numero du peripherique auquel appartient le fichier ou le repertoire OPTIONS DE TRIAGE -v Trier la sortie par version. -t Trier la sortie par date de derniere modification plutot qu'alphabetiquement. -c Trier la sortie par le dernier changement d'etat plutot qu'alphabetiquement. Cela modifie l'option -D (si utilisee) pour afficher le dernier changement d'etat au lieu de la date de modification. -U Ne pas trier. Lister les fichiers dans l'ordre du repertoire. Desactive --dirsfirst. -r Trier la sortie dans l'ordre inverse. Cela est un meta-triage qui altere les tris ci-dessus. Cette option est desactivee lorsque -U est utilise. --dirsfirst Lister les repertoires avant les fichiers. Cela est un meta-triage qui altere les tris ci-dessus. Cette option est desactivee si -U est utilise. --filesfirst Lister les fichiers avant les repertoires. Cela est un meta-triage qui altere les tris cites ci-dessus. Cette option est desactivee lorsque -U est utilise. --sort[=]type Trier la sortie par type plutot 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'utilise en conjonction avec l'option -f. Supprime egalement autant d'espaces blancs que possible lorsqu'il est utilise 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'equivalent actuel de --charset=IBM437 et peut eventuellement etre obsolete. -n Desactiver tout le temps la colorisation, cette option est ecrasee par l'option -C, mais ecrase CLICOLOR_FORCE si presente. -C Activer tout le temps la colorisation en utilisant les couleurs internes par defaut si les variables d'environnement LS_COLORS ou TREE_COLORS ne sont pas definies. Utile pour colorer la sortie dans un tube (pipe). OPTIONS HTML/JSON/XML -X Activer la sortie XML. Affiche l'arborescence comme un fichier formate en XML. -J Activer la sortie en JSON. Affiche l'arborescence comme un tableau formate en JSON. -H baseHREF Activer la sortie HTML, en incluant des references HTTP. Utile pour les sites ftp. baseHREF donne l'emplacement ftp de base lorsqu'on utilise la sortie HTML. C'est-a-dire que le repertoire local peut etre /local/ftp/pub, mais il doit etre reference comme ftp://hostname.organization.domain/pub (baseHREF doit etre ftp://hostname.organization.domain). Conseil : n'utilisez pas les lignes ANSI avec cette option, et n'indiquez pas plus d'un repertoire dans la liste des repertoires. Si vous voulez utiliser des couleurs a 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 a la place de celle par defaut. Utiliser un fichier vide ou /dev/null pour eliminer l'introduction completement. --houtro[=]fichier Utiliser fichier comme sequence finale HTML a la place de celle par defaut. Utiliser un fichier vide ou /dev/null pour eliminer cette sequence completement. -T titre Definir le titre et la chaine d'en-tete H1 dans le mode de sortie HTML. --nolinks Desactiver les hyperliens dans la sortie HTML. OPTIONS D'ENTREE --fromfile Lire une liste de repertoires depuis un fichier plutot que depuis le systeme de fichiers. Les chemins fournis sur la ligne de commande sont des fichiers a lire plutot que des repertoires a rechercher. Le repertoire point (.) indique a tree de lire les chemins depuis l'entree standard. NOTE : cela ne convient que pour lire la sortie d'un programme comme find, pas tree -fi etant donne que les liens symboliques ne sont pas distingues des fichiers contenant juste << -> >> dans une partie de leur nom de fichier a moins que l'option --fflinks ne soit utilisee. --fromtabfile Comme --fromfile, tree lit une hierarchie de repertoires a partir d'un fichier ou les fichiers sont indentes par une tabulation, dans un format de type arborescent pour indiquer le niveau d'imbrication du repertoire. --fflinks Traiter les informations sur un lien symbolique trouvees dans un fichier, comme dans la sortie de 'tree -fi --noreport'. Seule la premiere occurrence de la chaine ' -> ' est utilisee pour indiquer la separation le nom du fichier et le lien. OPTIONS DIVERSES --help Afficher une liste d'utilisation detaillee. --version Afficher la version de tree. -- Fin du traitement d'options. Aucune autre option ne sera traitee apres cela. FICHIERS .INFO Les fichiers .info sont similaires aux fichiers .gitignore, si un fichier .info est trouve lors du parcours d'un repertoire, il est lu et ajoute a une pile d'informations .info. Chaque fichier est compose de commentaires (lignes commencant par un diese (#)), ou de motifs jokers qui peuvent correspondre a un fichier relatif au repertoire dans lequel est trouve le fichier .info. Si un fichier doit correspondre a un motif, le commentaire indente par une tabulation qui suit le motif est utilise comme commentaire de fichier. Un commentaire se termine par une ligne non indentee. Plusieurs motifs, chacun sur une ligne peuvent partager le meme commentaire. FICHIERS /etc/DIR_COLORS Base de donnees des couleurs du systeme. ~/.dircolors Base de donnees 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 creees par dircolors TREE_COLORS Utiliser cela pour les informations sur les couleurs en plus de LS_COLORS si elle est definie. TREE_CHARSET Jeu de caracteres a utiliser en mode HTML pour l'arbre. CLICOLOR Activer la coloration meme si TREE_COLORS ou LS_COLORS ne sont pas definies. CLICOLOR_FORCE Toujours activer la colorisation (en fait -C) NO_COLOR Desactiver la colorisation (en fait -n) (consulter https://no-color.org/) LC_CTYPE Parametres regionaux pour la sortie du nom de fichier. LC_TIME Parametres regionaux 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 definir le descripteur a utiliser. AUTEUR Steve Baker (ice@mama.indstate.edu) Sortie HTML faite par Francesc Rocher (rocher@econ.udg.es) Prise en charge de jeux de caracteres et de OS/2 par Kyosuke Tokoro (NBG01720@nifty.ne.jp) BOGUES ET NOTES tree ne supprime pas les repertoires << vides >> lorsque les options -P et -I sont utilisees par defaut. Utilisez l'option --prune. Les options -h et --si arrondissent au nombre entier le plus proche alors que les implementaions de ls l'arrondissent toujours a l'entier superieur. Supprimer des fichiers et repertoires avec les options -I, -P et --filelimit peut conduire a un rapport incorrect du nombre de fichiers et de repertoires. Les options --prune et --du font que tree accumule l'arbre entier en memoire avant de l'emettre. Pour de grandes arborescences, cela peut causer un delai non negligeable pour la sortie et l'utilisation d'une grande quantite de memoire. Le tampon d'expansion timefmt est ridiculement limite a un maximum de 255 caracteres. La sortie de chaines de temps plus longues que cela seront indefinies, mais il est assure qu'elles n'excederont pas 255 caracteres. Les arbres XML et JSON ne sont pas colores, ce qui est un peu dommage. Probablement plus. A partir de la version 2.0.0, dans Linux, tree essaiera de produire automatiquement un arbre JSON compact sur le descripteur de fichier 3 (appele ici stddata), s'il est present et que la variable d'environnement STDDATA_FD est definie ou posiotionnee a une valeur de descripteur de fichier positive non nulle a utiliser dans la sortie. Il est a esperer qu'un jour un meilleur interpreteur de commande Linux/Unix puisse utiliser cette fonctionnalite, meme 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 francaise de cette page de manuel a ete creee par Baptiste Meles et bubu Cette traduction est une documentation libre ; veuillez vous reporter a la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE. Si vous decouvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message a . Tree 2.1.1 TREE(1)