TREE(1) General Commands Manual TREE(1) NUME tree - listeaza coninutul directoarelor intr-un format arborescent. SINOPSIS tree [-acdfghilnpqrstuvxACDFJQNSUX] [-L nivel [-R]] [-H baseHREF] [-T titlu] [-o nume-fiier] [-P model] [-I model] [--gitignore] [--gitfile[=]fiier] [--matchdirs] [--metafirst] [--ignore-case] [--nolinks] [--hintro[=]fiier] [--houtro[=]fiier] [--inodes] [--device] [--sort[=]nume] [--dirsfirst] [--filesfirst] [--filelimit numar] [--si] [--du] [--prune] [--charset[=]X] [--timefmt[=]format] [--fromfile] [--fromtabfile] [--fflinks] [--info] [--infofile[=]fiier] [--noreport] [--version] [--help] [--] [director ...] DESCRIERE tree este un program de listare recursiva a directoarelor care produce o lista de fiiere cu indentare in adancime, care este colorata precum dircolors daca variabila de mediu LS_COLORS este definita i daca ieirea este pe tty. Fara argumente, tree listeaza fiierele din directorul curent. In cazul in care se dau argumente pentru directoare, tree enumera toate fiierele i/sau directoarele gasite in directoarele date, fiecare pe rand. La terminarea listarii tuturor fiierelor/directoarelor gasite, tree returneaza numarul total de fiiere i/sau directoare listate. In mod implicit, atunci cand se intalnete o legatura simbolica, ruta la care se refera legatura simbolica este imprimata dupa numele legaturii in formatul: nume -> ruta-reala Daca se da opiunea ,,-l" i legatura simbolica se refera la un director real, atunci tree va urma ruta legaturii simbolice ca i cum ar fi un director real. OPIUNI tree inelege urmatoarele opiuni in linia de comanda: OPIUNI DE LISTARE -a Toate fiierele sunt afiate. In mod implicit, tree nu afieaza fiierele ascunse (cele care incep cu un punct ,,."). In nici un caz tree nu afieaza construciile sistemului de fiiere ,,." (directorul curent) i ,,.." (directorul anterior). -d Listeaza numai directoarele. -l Urmarete legaturile simbolice daca acestea indica directoare, ca i cum ar fi directoare. Legaturile simbolice care vor duce la recursivitate sunt evitate atunci cand sunt detectate. -f Imprima prefixul complet al rutei pentru fiecare fiier. -x Ramane doar pe sistemul de fiiere curent. Ca i cum s-ar folosi find -xdev. -L nivel Adancimea maxima de afiare a arborelui de directoare. -R Coboara recursiv fiecare nivel de directoare din arbore (a se vedea opiunea -L) i returneaza un fiier numit OOTree.html la fiecare nivel (in maniera -o). -P model Listeaza numai acele fiiere care se potrivesc cu caracterul joker model. Putei avea mai multe opiuni -P. Nota: trebuie sa utilizai opiunea -a pentru a lua in considerare i fiierele care incep cu un punct ,,." pentru potrivire. Operatorii caracter-joker valabili sunt: ,,*" (orice zero sau mai multe caractere), ,,**" (orice zero sau mai multe caractere, precum i /-uri nule, adica /**/ poate corespunde unui singur /), ,,?" (orice caracter), ,,[...]" (orice caracter listat intre paranteze (se poate utiliza opional - (liniua) pentru intervalul de caractere: de exemplu [A-Z]) i ,,[^...]" (orice caracter care nu este listat intre paranteze) i ,,|" separa modelele alternative. Un caracter ,,/" la sfaritul modelului corespunde directoarelor, dar nu i fiierelor. -I model Nu listeaza acele fiiere care se potrivesc cu modelul joker. Putei avea mai multe opiuni -I. Consultai -P de mai sus pentru informaii despre modelele cu caractere joker. --gitignore Folosete fiierele git .gitignore pentru filtrarea fiierelor i directoarelor. De asemenea, utilizeaza $GIT_DIR/info/exclude daca este prezent. --gitfile[=]fiier Utilizeaza fiier in mod explicit ca fiier gitignore. --ignore-case In cazul in care un model de potrivire este specificat prin opiunea -P sau -I, modelul se va potrivi fara a se ine seama de diferenele dintre majuscule i minuscule. --matchdirs In cazul in care se specifica un model de potrivire prin opiunea -P, modelul va fi aplicat la numele directoarelor (in plus faa de numele fiierelor). In cazul in care numele directorului se potrivete, potrivirea este dezactivata pentru coninutul directorului. In cazul in care se utilizeaza opiunea --prune, dosarele goale care corespund modelului nu vor fi curaate. --metafirst Imprima informaiile privind metadatele la inceputul liniei, mai degraba decat dupa liniile de indentare. --prune Face ca arborele sa elimine directoarele goale de la ieire, util atunci cand este utilizata impreuna cu -P sau -I. Pentru mai multe informaii despre aceasta opiune, consultai seciunea ERORI I NOTE de mai jos. --info Imprima comentariile gasite in fiierele .info. Pentru mai multe informaii despre formatul fiierelor .info, consultai seciunea FIIERE .INFO de mai jos. --infofile[=]fiier Utilizeaza fiier in mod explicit ca fiier info. --noreport Omite imprimarea raportului de fiiere i directoare la sfaritul listei arborelui. --charset[=]set-caractere Stabilete setul de caractere care trebuie utilizat la ieirea HTML i pentru desenarea liniilor. --filelimit[=]numar Nu coboara directoarele care conin mai mult de numar intrari. --timefmt[=]format Imprima (implica -D) i formateaza data in conformitate cu irul de format care utilizeaza sintaxa strftime(3). -o nume-fiier Trimite ieirea la nume-fiier. OPIUNI FIIER -q Imprima caracterele neimprimabile din numele de fiier sub forma de semne de intrebare in loc de cele implicite. -N Imprima caracterele neimprimabile ca atare in loc de numere octale eludate. -Q Introduce numele fiierelor intre ghilimele duble. -p Afieaza tipul de fiier i permisiunile pentru fiecare fiier (ca in cazul comenzii <>). -u Afieaza numele de utilizator, sau numarul UID daca nu exista un nume de utilizator, al fiierului. -g Afieaza numele grupului sau numarul GID daca nu este disponibil niciun nume de grup, al fiierului. -s Afieaza dimensiunea fiecarui fiier in octei impreuna cu numele. -h Imprima dimensiunea fiecarui fiier, dar intr-un mod mai uor de citit, de exemplu, adaugand o litera de marime pentru kilooctei (K), megaoctei (M), gigaoctei (G), teraoctei (T), petaoctei (P) i exaoctei (E). --si Precum -h, dar se folosesc in loc unitai SI (puteri de 1000). --du Pentru fiecare director, raporteaza dimensiunea sa ca fiind cumularea dimensiunilor tuturor fiierelor i subdirectoarelor sale (i a fiierelor acestora, i aa mai departe). Cantitatea totala de spaiu utilizat este, de asemenea, indicata in raportul final (ca i in cazul comenzii <>). Aceasta opiune necesita ca tree sa citeasca intregul arbore de directoare inainte de a-l emite, a se vedea ERORI I NOTE de mai jos. Implica -s. -D Imprima data ultimei modificari sau, daca se utilizeaza -c, data ultimei modificari de stare pentru fiierul listat. -F Adauga un caracter ,,/" pentru directoare, un ,,=" pentru fiiere soclu, un ,,*" pentru fiiere executabile, un ,,>" pentru ui ,,doors" (Solaris) i un ,,|" pentru FIFO-uri, ca in cazul comenzii <>. --inodes Imprima numarul de nod-i al fiierului sau directorului. --device Imprima numarul dispozitivului caruia ii aparine fiierul sau directorul. OPIUNI DE SORTARE -v Sorteaza ieirea in funcie de versiune. -t Sorteaza ieirea in funcie de ultima ora de modificare in loc de ordine alfabetica. -c Sorteaza ieirea in funcie de ultima modificare a starii in loc de ordine alfabetica. Modifica opiunea -D (daca este utilizata) pentru a imprima ultima modificare de stare in loc de ora de modificare. -U Nu sorteaza. Listeaza fiierele in ordinea din directoare. Dezactiveaza opiunea --dirsfirst. -r Sorteaza ieirea in ordine inversa. Aceasta este o meta-sortare care modifica sortarile de mai sus. Aceasta opiune este dezactivata atunci cand se utilizeaza opiunea -U. --dirsfirst Listeaza directoarele inaintea fiierelor. Aceasta este o meta-sortare care modifica sortarile de mai sus. Aceasta opiune este dezactivata atunci cand se utilizeaza opiunea -U. --filesfirst Listeaza fiierele inaintea directoarelor. Aceasta este o meta-sortare care modifica sortarile de mai sus. Aceasta opiune este dezactivata atunci cand se utilizeaza opiunea -U. --sort[=]tip Sorteaza ieirea dupa tip in loc de nume. Valorile posibile sunt: ctime (-c), mtime (-t), size, sau version (-v). OPIUNI GRAFICE -i Face ca tree sa nu imprime liniile de indentare, util atunci cand este utilizata impreuna cu opiunea -f. De asemenea, elimina cat mai multe spaii albe posibil atunci cand este utilizata impreuna cu opiunile -J sau -X. -A Activeaza modificarea grafica a liniilor ANSI la imprimarea liniilor de indentare. -S Activeaza grafica de linie CP437 (utila atunci cand se utilizeaza fonturi in modul consola Linux). Aceasta opiune este acum echivalenta cu ,,--charset=IBM437" i poate fi in cele din urma depreciata. -n Dezactiveaza intotdeauna colorarea, anulata de opiunea -C, insa anuleaza CLICOLOR_FORCE daca este prezenta. -C Activeaza intotdeauna colorarea, utilizand culorile implicite incorporate daca variabilele de mediu LS_COLORS sau TREE_COLORS nu sunt definite. Util pentru a colora ieirea catre o conducta. OPIUNI XML/JSON/HTML -X Activeaza ieirea XML. Scoate arborele de directoare sub forma unui fiier in format XML. -J Activeaza ieirea JSON. Afieaza arborele de directoare ca o matrice formatata JSON. -H baseHREF Activeaza ieirea HTML, inclusiv referinele HTTP. Util pentru siturile ftp. baseHREF ofera locaia ftp de baza atunci cand se utilizeaza ieirea HTML. Adica, directorul local poate fi ,,/local/ftp/pub", dar trebuie sa fie menionat ca ,,ftp://hostname.organization.domain/pub" (baseHREF trebuie sa fie ,,ftp://hostname.organization.domain"). Indicaie: nu utilizai linii ANSI cu aceasta opiune i nu indicai mai mult de un director in lista de directoare. Daca dorii sa utilizai culori prin intermediul foii de stil CSS, utilizai opiunea -C in plus faa de aceasta opiune pentru a fora ieirea in culori. --hintro[=]fiier Utilizeaza fiier ca introducere HTML in locul celui implicit. Utilizai un fiier gol sau /dev/null pentru a elimina complet introducerea. --houtro[=]fiier Utilizeaza fiier ca picior de pagina HTML in locul celui implicit. Folosii un fiier gol sau /dev/null pentru a elimina cu totul piciorul de pagina. -T titlu Stabilete titlul i irul de antet H1 in modul de ieire HTML. --nolinks Dezactiveaza hiperlegaturile in ieirea HTML. OPIUNI DE INTRARE --fromfile Citete o lista de directoare dintr-un fiier i nu din sistemul de fiiere. Rutele furnizate in linia de comanda sunt fiiere din care se citete i nu directoare in care se cauta. Directorul cu punct (.) indica faptul ca tree ar trebui sa citeasca rutele de la intrarea standard. NOTA: acest lucru este adecvat numai pentru citirea ieirii unui program precum find, nu pentru <>, deoarece legaturile simbolice nu se disting de fiierele care conin pur i simplu ,, -> " ca parte a numelui de fiier, cu excepia cazului in care se utilizeaza opiunea --fflinks. --fromtabfile La fel ca i --fromfile, tree citete un arbore de directoare dintr-un fiier text in care fiierele sunt indentate cu tabulaie intr-un format asemanator unui arbore, pentru a indica nivelul de ierarhizare al directoarelor. --fflinks Prelucreaza informaiile privind legaturile simbolice gasite intr-un fiier, ca in cazul ieirii din <>. Numai prima apariie a irului ,,-> " este utilizata pentru a indica separarea numelui de fiier de legatura. OPIUNI DIVERSE --help Afieaza o lista de utilizare detaliata. --version Afieaza versiunea de tree. -- Finalizatorul de procesare a opiunii. Dupa aceasta, nu vor mai fi procesate alte opiuni. FIIERE .INFO Fiierele .info sunt similare fiierelor .gitignore; daca un fiier .info este gasit in timpul scanarii unui director, acesta este citit i adaugat la o stiva de informaii .info. Fiecare fiier este compus din comentarii (linii care incep cu simboluri hash (#),) sau modele cu caractere joker care pot corespunde unui fiier in raport cu directorul in care se gasete fiierul .info. In cazul in care un fiier trebuie sa corespunda unui model, comentariul indentat cu tabulaie care urmeaza modelului este utilizat ca i comentariu al fiierului. Comentariul se termina cu o linie care nu este indentata cu tabulator. Mai multe modele, fiecare pe o linie, pot impari acelai comentariu. FIIERE /etc/DIR_COLORS Baza de date de culori a sistemului. ~/.dircolors Baza de date de culori a utilizatorilor. .gitignore Fiierul de excludere git. $GIT_DIR/info/exclude Lista globala de excludere a fiierelor git. .info Fiier de comentariu al fiierului. /usr/share/finfo/global_info Fiier global de comentariu al fiierului. MEDIU LS_COLORS Informaii despre culori create de dircolors. Folosete acest parametru pentru informaii despre culori in loc de LS_COLORS, daca este definita. TREE_CHARSET Set de caractere pentru arborele de utilizat in modul HTML. Activeaza colorarea chiar daca TREE_COLORS sau LS_COLORS nu sunt definite. CLICOLOR_FORCE Activeaza intotdeauna colorarea (efectiv -C). NO_COLOR Dezactiveaza colorarea (efectiv -n) ( a se vedea https://no-color.org/). LC_CTYPE Configuraia regionala pentru afiarea numelui de fiier. LC_TIME Configuraia regionala pentru afiarea timefmt (formatul de timp), a se vedea strftime(3). TZ Fusul orar pentru afiarea timefmt, a se vedea strftime(3). STDDATA_FD Activeaza caracteristica stddata, opional definete descriptorul de utilizat. AUTOR Steve Baker (Steve.Baker.llc@gmail.com) Ieire HTML construita de Francesc Rocher (rocher@econ.udg.es) Suport pentru seturi de caractere i OS/2 de Kyosuke Tokoro (NBG01720@nifty.ne.jp). ERORI I NOTE tree nu curaa directoarele ,,goale" atunci cand opiunile -P i -I sunt utilizate in mod implicit. Utilizai opiunea --prune pentru aceasta. Opiunile -h i --si rotunjesc la cel mai apropiat numar intreg, spre deosebire de implementarile ls, care rotunjesc intotdeauna in sus. Suprimarea fiierelor i directoarelor cu opiunile -I, -P i --filelimit va duce la rapoarte incorecte privind numarul de fiiere/directoare. Opiunile --prune i --du fac ca tree sa acumuleze intregul arbore in memorie inainte de a-l emite. In cazul arborilor de directoare mari, acest lucru poate cauza o intarziere semnificativa a ieirii i utilizarea unor cantitai mari de memorie. Memoria tampon de expansiune timefmt este limitata la un numar ridicol de mare de 255 de caractere. Ieirea irurilor de timp mai lungi decat aceasta va fi nedefinita, dar este garantat ca nu va depai 255 de caractere. Arborii XML/JSON nu sunt colorai, ceea ce este un pic pacat. Probabil mai multe. Incepand cu versiunea 2.0.0, in Linux, tree va incerca sa emita automat un arbore JSON compact pe descriptorul de fiier 3 (ceea ce eu numesc stddata), daca este prezenta i variabila de mediu STDDATA_FD este definita sau definita la un descriptor de fiier pozitiv diferit de zero, valoarea de utilizat pentru afiare. Se spera ca intr-o zi un shell Linux/Unix mai bun poate profita de aceasta caracteristica, dei BSON ar fi probabil un format mai bun pentru aceasta. CONSULTAI I dircolors(1), ls(1), find(1), du(1), strftime(3) gitignore(5) TRADUCERE Traducerea in limba romana a acestui manual a fost facuta de Remus- Gabriel Chelu Aceasta traducere este documentaie gratuita; citii Licena publica generala GNU Versiunea 3 sau o versiune ulterioara cu privire la condiii privind drepturile de autor. NU se asuma NICIO RESPONSABILITATE. Daca gasii erori in traducerea acestui manual, va rugam sa trimitei un e-mail la . tree 2.1.3 TREE(1)