TAR(1) Manualul GNU TAR TAR(1) NUME tar - un instrument pentru arhivare REZUMAT Utilizarea tradiionala tar {A|c|d|r|t|u|x}[GnSkUWOmpsMBiajJzZhPlRvwo] [ARG...] Utilizarea in stilul UNIX tar -A [OPIUNI] -f ARHIVA ARHIVA... tar -c [-f ARHIVA] [OPIUNI] [FIIER...] tar -d [-f ARHIVA] [OPIUNI] [FIIER...] tar -r [-f ARHIVA] [OPIUNI] [FIIER...] tar -t [-f ARHIVA] [OPIUNI] [NUME-MEMBRU...] tar -u [-f ARHIVA] [OPIUNI] [FIIER...] tar -x [-f ARHIVA] [OPIUNI] [NUME-MEMBRU...] Utilizarea in stilul GNU tar {--catenate|--concatenate} [OPIUNI] --file ARHIVA ARHIVA... tar --create [--file ARHIVA] [OPIUNI] [FIIER...] tar {--diff|--compare} [--file ARHIVA] [OPIUNI] [FIIER...] tar --delete [--file ARHIVA] [OPIUNI] [NUME-MEMBRU...] tar --append [--file ARHIVA] [OPIUNI] [FIIER...] tar --list [--file ARHIVA] [OPIUNI] [NUME-MEMBRU...] tar --test-label [--file ARHIVA] [OPIUNI] [ETICHETA...] tar --update [--file ARHIVA] [OPIUNI] [FIIER...] tar {--extract|--get} [--file ARHIVA] [OPIUNI] [NUME-MEMBRU...] NOTA Aceasta pagina de manual este o scurta descriere a GNU tar. Pentru o discuie detaliata, inclusiv exemple i recomandari de utilizare, consultai Manualul GNU Tar disponibil in format texinfo. Daca cititorul info i documentaia tar sunt instalate corect pe sistemul dumneavoastra, comanda info tar ar trebui sa va permita accesul la manualul complet. De asemenea, putei vizualiza manualul folosind modul info din emacs(1) sau il putei gasi in diverse formate online la adresa https://www.gnu.org/software/tar/manual In cazul in care apar discrepane intre aceasta pagina de manual i manualul Manualul GNU Tar, acesta din urma va fi considerat sursa care are autoritate. DESCRIERE GNU tar este un program de arhivare conceput pentru a stoca mai multe fiiere intr-un singur fiier ("o arhiva") i pentru a manipula astfel de arhive. Arhiva poate fi fie un fiier obinuit, fie un dispozitiv (de exemplu, o unitate de banda magnetica (tape drive), de unde i numele programului, care vine de la tape archiver), care poate fi localizat fie pe o maina locala, fie pe o maina aflata la distana. Stiluri de opiuni Opiunile pentru GNU tar pot fi date in trei stiluri diferite. In stilul tradiional, primul argument este un grup de litere de opiune i toate argumentele ulterioare furnizeaza argumente pentru acele opiuni care le solicita. Argumentele sunt citite in aceeai ordine ca i literele de opiune. Toate cuvintele din linia de comanda care raman dupa ce toate opiunile au fost procesate sunt tratate ca argumente fara opiune: nume de fiiere sau de membri ai arhivei. De exemplu, opiunea c solicita crearea arhivei, opiunea v solicita ca operaia sa se efectueze cu informaii detaliate despre ce se realizeaza, iar opiunea f primete un argument care stabilete numele arhivei pe care se opereaza. Urmatoarea comanda, scrisa in stilul tradiional, ordona lui <> sa stocheze toate fiierele din directorul /etc in fiierul de arhiva etc.tar enumerand in mod detaliat fiierele care sunt arhivate: tar cfv etc.tar /etc In stilul UNIX sau cu opiuni scurte, fiecare litera de opiune este precedata de o singura liniua, ca in cazul altor instrumente de linie de comanda. Daca o opiune are un argument, argumentul o urmeaza, fie ca un cuvant separat in linia de comanda, fie imediat dupa opiune. Cu toate acestea, in cazul in care opiunea are un argument opional, argumentul trebuie sa urmeze litera opiunii fara niciun spaiu alb intermediar, ca in -g/tmp/snar.db. Orice numar de opiuni care nu primesc argumente pot fi grupate impreuna dupa o singura liniua, de exemplu -vkp. O opiune care preia un argument (indiferent ca este obligatoriu sau opional) poate aparea la sfaritul unui astfel de grup, de exemplu -vkpf a.tar. Exemplul de comanda de mai sus scris in stilul cu opiune scurta ar putea arata astfel: tar -cvf etc.tar /etc sau tar -c -v -f etc.tar /etc In GNU sau stilul cu opiuni lungi, fiecare opiune incepe cu doua liniue i are un nume semnificativ, format din litere minuscule i liniue. Atunci cand este utilizata, opiunea lunga poate fi abreviata la literele sale iniiale, cu condiia ca acest lucru sa nu creeze ambiguitate. Argumentele pentru opiunile lungi sunt furnizate fie ca un cuvant separat in linia de comanda, imediat dupa opiune, fie separate de opiune printr-un semn egal, fara spaii albe intermediare. Argumentele opionale trebuie sa utilizeze intotdeauna cea din urma metoda. Iata mai multe moduri de a scrie comanda data de exemplu in acest stil: tar --create --file etc.tar --verbose /etc sau (abreviind unele opiuni): tar --cre --file=etc.tar --verb /etc Opiunile din toate cele trei stiluri pot fi amestecate, dei nu se incurajeaza sa facei acest lucru cu opiunile vechi. Mod de operare Opiunile enumerate in tabelul de mai jos ii indica lui GNU tar ce operaiune trebuie sa efectueze. Trebuie sa se dea exact una dintre ele. Semnificaia argumentelor fara opiuni depinde de modul de operare solicitat. -A, --catenate, --concatenate Adauga arhive la sfaritul unei alte arhive. Argumentele sunt tratate ca nume de arhive care trebuie adaugate. Toate arhivele trebuie sa aiba acelai format ca arhiva la care sunt adaugate, in caz contrar arhiva rezultata ar putea fi inutilizabila in cazul implementarilor non-GNU ale lui tar. Reinei, de asemenea, ca atunci cand se indica mai multe arhive, membrii din alte arhive decat prima vor fi accesibili in arhiva rezultata numai cand se utilizeaza opiunea -i (--ignore-zeros). Arhivele comprimate nu pot fi concatenate. -c, --create Creeaza o noua arhiva. Argumentele furnizeaza numele fiierelor care urmeaza sa fie arhivate. Directoarele sunt arhivate recursiv, cu excepia cazului in care este data opiunea --no-recursion. -d, --diff, --compare Gasete diferenele dintre arhiva i sistemul de fiiere. Argumentele sunt opionale i specifica membrii arhivei care trebuie comparai. Daca nu se specifica, se presupune ca este vorba de directorul de lucru curent. --delete terge din arhiva. Argumentele furnizeaza numele membrilor arhivei care urmeaza sa fie eliminai. Trebuie sa se dea cel puin un argument. Aceasta opiune nu funcioneaza in cazul arhivelor comprimate. Nu exista o opiune scurta echivalenta. -r, --append Adauga fiiere la sfaritul unei arhive. Argumentele au aceeai semnificaie ca pentru -c (--create). -t, --list Listeaza coninutul unei arhive. Argumentele sunt opionale. Atunci cand sunt date, acestea specifica numele membrilor care trebuie listai. --test-label Testeaza eticheta volumului de arhiva i iese. Atunci cand este utilizat fara argumente, imprima eticheta volumului (daca exista) i iese cu starea 0. Atunci cand sunt date unul sau mai multe argumente in linia de comanda, tar compara eticheta volumului cu fiecare argument. Iese cu codul 0 daca se gasete o potrivire, iar in caz contrar cu codul 1. Nu se afieaza nici o ieire, cu excepia cazului in care se utilizeaza impreuna cu opiunea -v (--verbose). Nu exista o opiune scurta echivalenta pentru aceasta opiune. -u, --update Adauga fiiere care sunt mai noi decat copia corespunzatoare din arhiva. Argumentele au aceeai semnificaie ca i in cazul opiunilor -c i -r. Observai ca fiierele mai noi nu inlocuiesc vechile lor copii din arhiva, ci sunt adaugate la sfaritul arhivei. Arhiva rezultata poate astfel sa conina mai muli membri cu acelai nume, care corespund diferitelor versiuni ale aceluiai fiier. -x, --extract, --get Extrage fiiere dintr-o arhiva. Argumentele sunt opionale. Atunci cand sunt date, acestea specifica numele membrilor arhivei care urmeaza sa fie extrai. --show-defaults Afieaza valorile implicite predefinite pentru diferite opiuni ale lui tar i iese. -?, --help Afieaza un scurt rezumat al opiunilor i iese. --usage Afieaza o lista de opiuni disponibile i iese. --version Afieaza versiunea programului i informaiile privind drepturile de autor i iese. OPIUNI Modificatori operatie --check-device Verifica numele dispozitivelor cand se creeaza arhivele incrementale (implicit). -g, --listed-incremental=FIIER Gestioneaza noile copii de rezerva incrementale in format GNU. FIIER este numele unui fiier de instantanee, in care tar stocheaza informaii suplimentare care sunt utilizate pentru a decide ce fiiere s-au modificat de la precedenta copie de rezerva incrementala i, in consecina, trebuie sa fie din nou copiate. Daca FIIER nu exista la crearea unei arhive, acesta va fi creat i toate fiierele vor fi adaugate la arhiva rezultata (copia de rezerva nivel 0). Pentru a crea arhive incrementale de nivel N diferit de zero, trebuie sa creai o copie a fiierului de instantanee creat in timpul crearii copiei de rezerva de nivel N-1 i sa-l utilizai ca FIIER. La listare sau la extragere, coninutul real al FIIERULUI nu este inspectat, ci este necesar doar din cauza cerinelor sintactice. Prin urmare, este o practica obinuita sa se utilizeze /dev/null in locul acestuia. --hole-detection=METODA Utilizeaza METODA pentru a detecta gaurile din fiierele disperse. Aceasta opiune implica --sparse. Valorile valide pentru METODA sunt seek i raw. Valoarea implicita este seek cu revenire la raw atunci cand nu este cazul. -G, --incremental Gestioneaza vechiul format GNU de copii de rezerva incrementale. --ignore-failed-read Nu termina cu un cod de ieire diferit de zero daca fiierele nu pot fi citite. --level=NUMAR Stabilete nivelul de salvare pentru o arhiva creata in lista de arhiva incrementala. In prezent, numai --level=0 este semnificativ: acesta ii indica lui tar sa trunchieze fiierul de instantanee inainte de salvare, forand astfel o salvare de nivel 0. -n, --seek Presupune ca arhiva poate fi explorata. In mod normal, tar determina automat daca arhiva poate fi explorata sau nu. Aceasta opiune este destinata utilizarii in cazurile in care o astfel de recunoatere eueaza. Ea are efect numai daca arhiva este deschisa pentru citire (de exemplu, cu opiunile --list sau --extract). --no-check-device Nu verifica numerele dispozitivelor la crearea arhivelor incrementale. --no-seek Presupune ca arhiva nu poate fi explorata. --occurrence[=N] Proceseaza numai a Na apariie a fiecarui fiier din arhiva. Aceasta opiune este valabila numai atunci cand este utilizata cu una dintre urmatoarele subcomenzi: --delete, --diff, --extract sau --list i atunci cand se furnizeaza o lista de fiiere fie in linia de comanda, fie prin intermediul opiunii -T. Valoarea implicita pentru N este 1. --restrict Dezactiveaza utilizarea unor opiuni potenial daunatoare. --sparse-version=MAJOR[.MINOR] Stabilete ce versiune a formatului de dispersie trebuie sa fie utilizata. Aceasta opiune implica --sparse. Valorile valide ale argumentului sunt 0.0, 0.1 i 1.0. Pentru o discuie detaliata a formatelor de dispersie, consultai Manualul GNU Tar, apendicele D, ,,Sparse Formats". Utilizand cititorul info, acesta poate fi accesat executand urmatoarea comanda: <>. -S, --sparse Gestioneaza eficient fiierele disperse. Unele fiiere din sistemul de fiiere pot avea segmente care, de fapt, nu au fost scrise niciodata (destul de des, acestea sunt fiiere de baze de date create de sisteme precum DBM). Atunci cand i se da aceasta opiune, tar incearca sa determine daca fiierul este dispers inainte de a-l arhiva i, in caz afirmativ, sa reduca dimensiunea arhivei rezultate prin faptul ca nu descarca parile goale din fiier. Suprascrie controlul Aceste opiuni controleaza aciunile tar la extragerea unui fiier peste o copie existenta pe disc. -k, --keep-old-files Nu inlocuiete fiierele existente atunci cand extrage. --keep-newer-files Nu inlocuiete fiierele existente care sunt mai noi decat copiile acestora din arhiva. --keep-directory-symlink Pastreaza legaturile simbolice existente catre directoare cand extrage. --no-overwrite-dir Pastreaza metadatale directoarelor existente. --one-top-level[=DIR] Extrage toate fiierele in DIR, sau, daca este folosit fara argument, intr-un subdirector numit dupa numele de baza al arhivei (minus sufixele standard de compresie recunoscute de --auto-compress). --overwrite Suprascrie fiierele existente la extragere. --overwrite-dir Suprascrie metadatele directoarelor existente cand extrage (implicit). --recursive-unlink Elimina in mod recursiv toate fiierele din director inainte de a le extrage. --remove-files Elimina fiierele de pe disc dupa adaugarea lor in arhiva. --skip-old-files Nu inlocuiete fiierele existente atunci cand extrage, trece peste ele in mod silenios. -U, --unlink-first Elimina fiecare fiier inainte de a extrage peste el. -W, --verify Verifica arhiva dupa scrierea acesteia. Selectarea fluxului de ieire --ignore-command-error Ignora codurile de ieire ale subproceselor. --no-ignore-command-error Trateaza codurile de ieire diferite de zero ale proceselor-copii ca eroare (implicit). -O, --to-stdout Extrage fiierele la ieirea standard. --to-command=COMANDA Dirijeaza fiierele extrase catre COMANDA. Argumentul este ruta de acces a unui program extern, opional cu argumente de linie de comanda. Programul va fi invocat, iar coninutul fiierului extras ii va fi furnizat pe intrarea standard a acestuia. Datele suplimentare vor fi furnizate prin intermediul urmatoarelor variabile de mediu: TAR_FILETYPE Tipul de fiier. Este o singura litera cu urmatoarea semnificaie: f fiier obinuit d director l legatura simbolica h legatura dura b dispozitiv de blocn c dispozitiv de caracter In prezent, sunt acceptate doar fiierele obinuite. TAR_MODE Modul de fiier (permisiunile fiierului), un numar octal. TAR_FILENAME Numele fiierului. TAR_REALNAME Numele fiierului, aa cum este stocat in arhiva. TAR_UNAME Numele proprietarului fiierului. TAR_GNAME Numele grupului proprietar al fiierului. TAR_ATIME Ora ultimei accesari. Este un numar zecimal, reprezentand secundele scurse de la ,,Epoca". In cazul in care arhiva furnizeaza ore cu precizie de nanosecunde, nanosecundele sunt adaugate la marca temporala dupa un punct zecimal. TAR_MTIME Data i ora ultimei modificari. TAR_CTIME Data i ora ultimei schimbari de stare. TAR_SIZE Dimensiunea fiierului. TAR_UID UID-ul proprietarului fiierului. TAR_GID GID-ul proprietarului fiierului. In plus, urmatoarele variabile conin informaii despre modul de operare tar i despre arhiva care este procesata: TAR_VERSION Numarul versiunii GNU tar. TAR_ARCHIVE Numele arhivei pe care o proceseaza tar. TAR_BLOCKING_FACTOR Coeficientul de blocuri curent, adica numarul de blocuri de 512 octei dintr-o inregistrare. TAR_VOLUME Numarul ordinal al volumului pe care tar il prelucreaza (setul daca se citete o arhiva cu mai multe volume). TAR_FORMAT Formatul arhivei in curs de prelucrare. Unul dintre urmatoarele: gnu, oldgnu, posix, ustar, v7. TAR_SUBCOMMAND Opiune scurta (cu o liniua de inceput) care descrie operaia pe care o executa tar. Manipulare atribute fisiere --atime-preserve[=METODA] Pastreaza data i ora de acces la fiierele transferate, fie prin restabilirea datei i orei dupa citire (METODA=replace, aceasta este valoarea implicita), fie prin nestabilirea datei i orei in primul rand (METODA=system). --delay-directory-restore Amana stabilirea datei i orei de modificare i a permisiunilor directoarelor extrase pana la sfaritul extragerii. Utilizai aceasta opiune atunci cand extragei dintr-o arhiva care are o ordine neobinuita a membrilor. --group=NUME[:GID] Foreaza NUME ca grup pentru fiierele adaugate. Daca GID nu este furnizat, NUMEle poate fi, fie un nume de utilizator, fie un GID numeric. In acest caz, partea care lipsete (GID sau nume) va fi dedusa din baza de date de grupuri a gazdei curente. Atunci cand se utilizeaza cu --group-map=FIIER, afecteaza numai acele fiiere al caror grup proprietar nu este listat in FIIER. --group-map=FIIER Citete tabelul de traducere al grupului din FIIER. Liniile goale sunt ignorate. Comentariile sunt introduse cu semnul # i se extind pana la sfaritul liniei. Fiecare linie care nu este goala din FIIER definete traducerea pentru un singur grup. Aceasta trebuie sa fie formata din doua campuri, delimitate de orice cantitate de spaiu alb: GRUPUL_VECHI GRUPUL_NOU[:GID_NOU] GRUPUL_VECHI este fie un nume de grup valid, fie un GID prefixat cu +. Cu excepia cazului in care se furnizeaza GID_NOU, GRUPUL_NOU trebuie sa fie, de asemenea, fie un nume de grup valid, fie un +GID. In caz contrar, atat GRUPUL_NOU, cat i GID_NOU nu trebuie sa fie listate in baza de date a grupurilor de sistem. Ca urmare, fiecare fiier de intrare cu grupul proprietar GRUPUL_VECHI va fi stocat in arhiva cu grupul proprietar GRUPUL_NOU i GID-ul GID_NOU. --mode=SCHIMBARI Foreaza mod (simbolic) SCHIMBARI pentru fiierele adaugate. --mtime=DATA-SAU_FIIERUL Stabilete ,,mtime" pentru fiierele adaugate. DATA-SAU-FIIERUL este fie o data/ora intr-un format aproape arbitrar, fie numele unui fiier existent. In acest din urma caz, se va utiliza ,,mtime" a acelui fiier. -m, --touch Nu extrage ora i data de modificare al fiierului. --no-delay-directory-restore Anuleaza efectul opiunii anterioare --delay-directory-restore. --no-same-owner Extrage fiierele ca tine (implicit pentru utilizatorii obinuii). --no-same-permissions Aplica masca de permisiuni a utilizatorului cand se extrag permisiunile de la arhiva (implicit pentru utilizatorii obinuii). --numeric-owner Utilizeaza intotdeauna numere pentru numele utilizatorilor/grupurilor. --owner=NUME[:UID] Foreaza NUME ca proprietar pentru fiierele adaugate. Daca UID nu este furnizat, NUME poate fi fie un nume de utilizator, fie un UID numeric. In acest caz, partea care lipsete (UID sau nume) va fi dedusa din baza de date de utilizatori a gazdei curente. Atunci cand se utilizeaza cu --owner-map=FIIER, afecteaza numai acele fiiere al caror proprietar nu este listat in FIIER. --owner-map=FIIER Citete tabelul de traducere al proprietarului din FIIER. Liniile goale sunt ignorate. Comentariile sunt introduse cu semnul # i se extind pana la sfaritul liniei. Fiecare linie care nu este goala din FIIER definete traducerea pentru un singur UID. Aceasta trebuie sa fie formata din doua campuri, delimitate de orice cantitate de spaiu alb: UTILIZATOR_VECHI UTILIZATOR_NOU[:UID_NOU] UTILIZATOR_VECHI este fie un nume de utilizator valid, fie un UID prefixat cu +. Cu excepia cazului in care se furnizeaza UID_NOU, UTILIZATOR_NOU trebuie sa fie, de asemenea, fie un nume de utilizator valid, fie un +UID. In caz contrar, atat UTILIZATOR_NOU, cat i UID_NOU nu trebuie sa fie listate in baza de date a utilizatorilor sistemului. Ca urmare, fiecare fiier de intrare deinut de UTILIZATOR_VECHI va fi stocat in arhiva cu numele proprietarului UTILIZATOR_NOU i UID-ul UID_NOU. -p, --preserve-permissions, --same-permissions Stabiletepermisiunile fiierelor extrase la cele inregistrate in arhiva (implicit pentru superutilizator). --same-owner Incearca sa extragi fiierele cu acelai proprietar ca cel care exista in arhiva (implicit pentru superutilizator). -s, --preserve-order, --same-order Ii indica lui tar ca lista de nume de fiiere de procesat este sortata in aceeai ordine ca i fiierele din arhiva. --sort=ORDINE Atunci cand creeaza o arhiva, sorteaza intrarile din directoare in funcie de ORDINE, care este unul dintre: none (niciuna), name (nume) sau inode (nod-i). Valoarea implicita este --sort=none (niciuna), care stocheaza membrii arhivei in aceeai ordine in care este returnata de sistemul de operare. Folosind --sort=name (nume) se asigura ca ordinea membrilor in arhiva creata este uniforma i reproductibila. Utilizarea --sort=inode (nod-i) reduce numarul de cautari pe disc la crearea arhivei i, prin urmare, poate accelera considerabil arhivarea. Aceasta ordine de sortare este acceptata numai daca sistemul de baza furnizeaza informaiile necesare. Atribute de fiier extinse --acls Activeaza suportul ACLs POSIX. --no-acls Dezactiveaza suportul ACLs POSIX. --selinux Activeaza suportul de context SELinux. --no-selinux Dezactiveaza suportul de context SELinux. --xattrs Activeaza suportul de atribute extinse. --no-xattrs Dezactiveaza suportul de atribute extinse. --xattrs-exclude=MODEL Specifica modelul de excludere pentru cheile xattr. MODEL este un mode global (utilizeaza metacaractere), de exemplu, --xattrs-exclude='user.*', pentru a include doar atributele din spaiul de nume al utilizatorului. --xattrs-include=MODEL Specifica modelul de includere pentru cheile xattr. MODEL este un model global (bazat pe metacaractere). Selectare si schimbare unitate -f, --file=ARHIVA Utilizeaza fiierul arhiva sau dispozitivul ARHIVA. Daca aceasta opiune nu este data, tar va examina mai intai variabila de mediu ,,TAPE". Daca aceasta este definita, valoarea sa va fi utilizata ca nume de arhiva. In caz contrar, tar va prelua valoarea implicita compilata. Valoarea implicita poate fi inspectata fie cu ajutorul opiunii --show-defaults, fie la sfaritul ieirii comenzii tar --help. Un nume de arhiva care are in el doua puncte specifica un fiier sau un dispozitiv de pe o maina aflata la distana. Partea de dinaintea celor doua puncte este considerata ca fiind numele mainii sau adresa IP, iar partea de dupa ca fiind numele de acces la fiier sau dispozitiv, de exemplu: --file=gazda_la_distana:/dev/sr0 Un nume de utilizator opional poate fi prefixat la numele de gazda, plasand un semn @ intre ele. In mod implicit, gazda de la distana este accesata prin intermediul comenzii rsh(1). In prezent, este obinuit sa se utilizeze in schimb ssh(1). Putei face acest lucru oferind urmatoarea opiune de linie de comanda: --rsh-command=/usr/bin/ssh Maina de la distana trebuie sa aiba instalata comanda rmt(8). In cazul in care numele sau de ruta nu se potrivete cu cel implicit al tar, putei informa tar cu privire la numele de ruta corect folosind opiunea --rmt-command. --force-local Fiierul arhiva este local chiar daca are doua puncte. -F, --info-script=COMANDA, --new-volume-script=COMANDA Ruleaza COMANDA la sfaritul fiecarei benzi magnetice (implica -M). Comanda poate include argumente. Cand este lansata, va moteni mediul lui tar plus urmatoarele variabile: TAR_VERSION Numarul versiunii GNU tar. TAR_ARCHIVE Numele arhivei pe care o proceseaza tar. TAR_BLOCKING_FACTOR Coeficientul de blocuri curent, adica numarul de blocuri de 512 octei dintr-o inregistrare. TAR_VOLUME Numarul ordinal al volumului pe care tar il prelucreaza (setul daca se citete o arhiva cu mai multe volume). TAR_FORMAT Formatul arhivei in curs de prelucrare. Unul dintre urmatoarele: gnu, oldgnu, posix, ustar, v7. TAR_SUBCOMMAND Opiune scurta (cu o liniua de inceput) care descrie operaia pe care o executa tar. TAR_FD Descriptorul de fiier care poate fi utilizat pentru a comunica noul nume de volum catre tar. Daca scriptul ,,info" eueaza, tar iese; in caz contrar, incepe sa scrie urmatorul volum. -L, --tape-length=N Schimba banda magnetica dupa ce a scris Nx1024 octei. Daca N este urmat de un sufix de marime (a se vedea subseciunea Sufixe de marime de mai jos), sufixul specifica factorul multiplicativ care trebuie utilizat in loc de 1024. Aceasta opiune implica -M. -M, --multi-volume Creeaza/listeaza/extrage o arhiva multi-volum. --rmt-command=COMANDA Utilizeaza COMANDA in loc de rmt la accesarea arhivelor de la distana. A se vedea descrierea opiunii -f, de mai sus. --rsh-command=COMANDA Utilizeaza COMANDA in loc de rsh la accesarea arhivelor de la distana. A se vedea descrierea opiunii -f, de mai sus. --volno-file=FIIER Atunci cand aceasta opiune este utilizata impreuna cu --multi-volum, tar va ine evidena volumului dintr-o arhiva multi-volum in care lucreaza in FIIER. Blocuri unitate -b, --blocking-factor=BLOCURI Stabilete dimensiunea inregistrarii la BLOCURIx512 octei. -B, --read-full-records Cand listeaza sau extrage, accepta inregistrarile de intrare incomplete dupa marcajul de sfarit de fiier. -i, --ignore-zeros Ignora blocurile care constau in zerouri din arhiva. In mod normal, doua blocuri consecutive de 512 blocuri umplute cu zerouri inseamna EOF (sfarit de fiier), iar tar oprete citirea dupa ce le intalnete. Aceasta opiune ii indica sa citeasca in continuare i este utila la citirea arhivelor create cu opiunea -A. --record-size=NUMAR Stabilete dimensiunea inregistrarii. NUMAR este numarul de octei pe inregistrare. Acesta trebuie sa fie multiplu de 512. Poate fi sufixat cu un sufix size, de exemplu --record-size=10K, pentru 10 Kilooctei. A se vedea subseciunea Sufixe de marime, pentru o lista de sufixe valabile. Selectie format arhiva -H, --format=FORMAT Creeaza arhiva in formatul dat. Formatele valide sunt: gnu Formatul GNU tar 1.13x oldgnu Formatul GNU conform cu tar <= 1.12. pax, posix Formatul POSIX 1003.1-2001 (pax). ustar Formatul POSIX 1003.1-1988 (ustar). v7 Vechiul format tar V7. --old-archive, --portability Ca si --format=v7. --pax-option=cuvant_cheie[[:]=valoare][,cuvant_cheie[[:]=valoare]]... Controleaza cuvintele-cheie pax la crearea arhivelor PAX (-H pax). Aceasta opiune este echivalenta cu opiunea -o a instrumentului pax(1). --posix Ca si --format=posix. -V, --label=TEXT Creeaza arhiva cu numele de volum TEXT. In cazul listarii sau extragerii, utilizeaza TEXT ca model de globalizare (folosind metacaractere (caractere-jocker)) pentru numele volumului. Opiuni de comprimare -a, --auto-compress Utilizeaza sufixul arhivei pentru a determina programul de comprimare. -I, --use-compress-program=COMANDA Filtreaza datele cu ajutorul COMENZII. Trebuie sa accepte opiunea -d, pentru decomprimare. Argumentul poate conine opiuni de linie de comanda. -j, --bzip2 Filtreaza arhiva prin bzip2(1). -J, --xz Filtreaza arhiva prin xz(1). --lzip Filtreaza arhiva prin lzip(1). --lzma Filtreaza arhiva prin lzma(1). --lzop Filtreaza arhiva prin lzop(1). --no-auto-compress Nu utilizeaza sufixul arhivei pentru a determina programul de comprimare. -z, --gzip, --gunzip, --ungzip Filtreaza arhiva prin gzip(1). -Z, --compress, --uncompress Filtreaza arhiva prin compress(1). --zstd Filtreaza arhiva prin zstd(1). Selecie fiier local --add-file=FIIER Adauga FIIERUL dat la arhiva (util daca numele acestuia incepe cu o liniua). --backup[=CONTROL] Face o copie de rezerva inainte de eliminare. Argumentul CONTROL, daca este furnizat, controleaza politica de copie de rezerva. Valorile sale valide sunt: none, off Nu face copii de rezerva niciodata. t, numbered Face copii de rezerva numerotate. nil, existing Creeaza copii de rezerva numerotate daca exista copii de rezerva numerotate, iar in caz contrar copii de rezerva simple. never, simple Face intotdeauna copii de rezerva simple Daca nu se indica CONTROL, valoarea este preluata din variabila de mediu VERSION_CONTROL. Daca aceasta nu este definita, se presupune existing (valoarea existenta). -C, --directory=DIR Schimba la DIR inainte de a efectua orice operaie. Aceasta opiune este sensibila la ordine, adica afecteaza toate opiunile care urmeaza. --exclude=MODEL Exclude fiierele care se potrivesc cu MODELUL, un model de metacaractere (caractere-jocker) in stil glob(3). --exclude-backups Exclude fiierele de copii de rezerva i blocare. --exclude-caches Exclude coninutul directoarelor care conin fiierul CACHEDIR.TAG, cu excepia fiierului de eticheta propriu-zis. --exclude-caches-all Exclude directoarele care conin fiierul CACHEDIR.TAG i fiierul insui. --exclude-caches-under Exclude tot ceea ce se afla sub directoarele care conin CACHEDIR.TAG --exclude-ignore=FIIER Inainte de a transfera un director, verifica daca acesta conine FIIERUL. In caz afirmativ, citete modelele de excludere din acest fiier. Modelele afecteaza numai directorul in sine. --exclude-ignore-recursive=FIIER La fel ca --exclude-ignore, cu excepia faptului ca modelele din FIIER afecteaza atat directorul, cat i toate subdirectoarele sale. --exclude-tag=FIIER Exclude coninutul directoarelor care conin FIIERUL, cu excepia FIIERULUI insui. --exclude-tag-all=FIIER Exclude directoarele care conin FIIERUL. --exclude-tag-under=FIIER Exclude tot ceea ce se afla sub directoarele care conin FIIERUL. --exclude-vcs Exclude directoarele sistemului de control al versiunilor. --exclude-vcs-ignores Exclude fiierele care se potrivesc cu modelele citite din fiierele de ignorare specifice VCS. Fiierele acceptate sunt: .cvsignore, .gitignore, .bzrignore i .hgignore. -h, --dereference Urmarete legaturile simbolice; arhiveaza i transfera fiierele la care arata. --hard-dereference Urmarete legaturile dure; arhiveaza i transfera fiierele la care se refera. -K, --starting-file=NUME-MEMBRU Incepe de la membrul dat (NUME-MEMBRU) din arhiva. --newer-mtime=DATA Lucreaza pe fiiere ale caror date s-au modificat dupa DATA. Daca DATA incepe cu / sau ., se considera ca este un nume de fiier; ,,mtime" al acelui fiier este utilizat ca data. --no-null Dezactiveaza efectul opiunii --null precedenta. --no-recursion Evita coborarea automata in directoare. --no-unquote Nu elimina ghilimelele din numele fiierului de intrare sau din numele membrilor. --no-verbatim-files-from Trateaza fiecare linie citita dintr-o lista de fiiere ca i cum ar fi fost furnizata in linia de comanda. Adica, se elimina spaiile albe de inceput i de sfarit i, daca irul rezultat incepe cu o liniua, este tratat ca opiunea de linie de comanda tar. Acesta este comportamentul implicit. Opiunea --no-verbatim-files-from este furnizata ca o modalitate de a-l restabili dupa opiunea --verbatim-files-from. Aceasta opiune este poziionala: afecteaza toate opiunile --files-from care apar dupa ea in, pana la opiunea --verbatim-files-from sau pana la sfaritul liniei, in funcie de care apare mai intai. Este subineleasa de opiunea --no-null. --null Indica opiunilor ulterioare -T sa citeasca textual (verbatim) numele cu terminaie nula (dezactiveaza tratarea speciala a numelor care incep cu o liniua). A se vedea, de asemenea, --verbatim-files-from. -N, --newer=DATA, --after-date=DATA Stocheaza numai fiiere mai noi decat DATA. Daca DATA incepe cu / sau ., se considera ca este un nume de fiier; ,,mtime" al acelui fiier este utilizat ca data. --one-file-system Ramane in sistemul de fiiere local la crearea arhivei. -P, --absolute-names Nu inlatura barele inclinate ,,/" de la inceputul numelor de fiiere la crearea arhivelor. --recursion Coboara recursiv in directoare (implicit). --suffix=IR Face o copie de rezerva inaintea eliminarii, suprascrie sufixul uzual. Sufixul implicit este ~, daca nu este inlocuit de variabila de mediu SIMPLE_BACKUP_SUFFIX. -T, --files-from=FIIER Obine numele care trebuie extrase sau create din FIIER. Cu excepia cazului in care se specifica altfel, FIIERUL trebuie sa conina o lista de nume separate prin ASCII LF (adica un nume pe linie). Numele citite sunt tratate in acelai mod ca i argumentele din linia de comanda. Acestea sunt supuse eliminarii ghilimelelor i divizarii cuvintelor, iar orice ir de caractere care incepe cu un - este tratat ca o opiune de linie de comanda tar. Daca acest comportament nu este dorit, poate fi dezactivat cu ajutorul opiunii --verbatim-files-from. Opiunea --null ii indica lui tar ca numele din FILE sunt separate de caracterul ASCII NUL, in loc de LF. Este utila in cazul in care lista este generata de comanda <>. --unquote Elimina ghilimelele din numele fiierului de intrare sau din numele membrilor (implicit) --verbatim-files-from Trateaza fiecare linie obinuta dintr-o lista de fiiere ca pe un nume de fiier, chiar daca incepe cu o liniua. Listele de fiiere sunt furnizate cu opiunea --files-from (-T). Comportamentul implicit este de a trata numele furnizate in listele de fiiere ca i cum ar fi fost tastate in linia de comanda, adica orice nume care incepe cu o liniua este tratat ca o opiune tar. Opiunea --verbatim-files-from dezactiveaza acest comportament. Aceasta opiune afecteaza toate opiunile --files-from care apar dupa ea in linia de comanda. Efectul sau este anulat de opiunea --no-verbatim-files-from. Aceasta opiune este subineleasa de opiunea --null. A se vedea, de asemenea, --add-file. -X, --exclude-from=FIIER Exclude fiierele care corespund modelelor enumerate in FIIER. Transformari de nume de fiier --strip-components=NUMAR Elimina componentele de inceput NUMAR din numele fiierelor care urmeaza sa fie extrase. --transform=EXPRESIA, --xform=EXPRESIA Utilizeaza inlocuirea EXPRESIEI cu <> pentru a transforma numele fiierelor. Opiuni de potrivire a numelui de fiier Aceste opiuni afecteaza atat modelele de excludere, cat i cele de includere. --anchored Modelele se potrivesc cu inceputul numelui fiierului. --ignore-case Ignora majusculele. --no-anchored Modelele se potrivesc dupa fiecare / (implicit pentru excludere). --no-ignore-case Potrivire sensibila la majuscule (implicit). --no-wildcards Potrivire a irului textuala (verbatim). --no-wildcards-match-slash Metacaracterele (caracterele jocker) nu se potrivesc cu /. --wildcards Utilizeaza metacaractere (implicit pentru excludere). --wildcards-match-slash Metacaracterele se potrivesc cu / (implicit pentru excludere). Iesire informativa --checkpoint[=N] Afieaza mesajele de progres la fiecare a N-a inregistrare (implicit 10). --checkpoint-action=ACIUNE Executa ACIUNEA la fiecare punct de verificare. --clamp-mtime Stabilete timpul doar cand fiierul este mai recent decat a fost dat cu --mtime. --full-time Afieaza data i ora fiierelor cu precizie maxima. --index-file=FIIER Trimite ieire detaliata in FISIER. -l, --check-links Afieaza un mesaj daca nu toate legaturile sunt prelucrate. --no-quote-chars=IR Dezactiveaza punerea intre ghilimele a caracterelor din IR. --quote-chars=IR Adauga punerea intre ghilimele a caracterelor din IR. --quoting-style=STIL Stabilete stilul punerii intre ghilimele pentru numele fiierelor i al membrilor. Valorile valabile pentru STIL sunt literal, shell, shell-always, c, c-maybe, escape, locale, clocale. -R, --block-number Afieaza numarul blocului din arhiva cu fiecare mesaj. --show-omitted-dirs Cand se listeaza sau se extrage, listeaza fiecare director care nu se potrivete cu criteriile de cautare. --show-transformed-names, --show-stored-names Afieaza numele fiierelor sau arhivelor dupa transformarea prin opiunile --strip i --transform. --totals[=SEMNAL] Afieaza numarul total de octei dupa procesarea arhivei. Daca se da SEMNAL, se imprima numarul total de octei atunci cand este transmis acest semnal. Semnalele permise sunt: SIGHUP, SIGQUIT, SIGINT, SIGUSR1 i SIGUSR2. Prefixul SIG poate fi omis. --utc Afieaza timpii (data+ora) de modificare a fiierului in UTC. -v, --verbose Afieaza o lista detaliata a fiierelor procesate. Fiecare instana a acestei opiuni pe linia de comanda crete nivelul de detaliere cu un punct. Nivelul maxim de detaliere este 3. Pentru o discuie detaliata a modului in care diferitele niveluri de detaliere afecteaza ieirea lui tar, consultai Manualul Tar GNU, subseciunea 2.5.2 ,,Opiunea '--verbose'". --warning=CUVANTUL_CHEIE Activeaza sau dezactiveaza mesajele de avertizare identificate prin CUVANTUL_CHEIE. Mesajele sunt suprimate daca CUVANTUL_CHEIE este prefixat cu no- i activate in caz contrar. Pot fi adaugate mai multe opiuni --warning. Cuvintele cheie care controleaza operarea generala tar: all Activeaza toate mesajele de avertizare. Aceasta este valoarea implicita. none Dezactiveaza toate mesajele de avertisment. filename-with-nuls "%s: numele de fiier citit conine caracterul nul" alone-zero-block "Un singur bloc de zerouri in %s" Cuvintele cheie aplicabile pentru tar --create: cachedir "%s: conine o eticheta de director de zona de prestocare (cache) %s; %s" file-shrank "%s: Fiierul s-a redus cu %s octei; se umple cu zerouri" xdev "%s: fiierul este pe un sistem de fiiere diferit; nimic generat" file-ignored "%s: Tip de fiier necunoscut; fiier ignorat" "%s: soclu ignorat" "%s: poarta(door) ignorata" file-unchanged "%s: fiierul este neschimbat; nimic generat" ignore-archive "%s: arhiva nu se poate conine pe ea insai; nu a fost extrasa" file-removed "%s: Fiier ters inainte de a-l putea citi" file-changed "%s: fiierul s-a modificat in timp ce era citit" failed-read Suprima avertismentele privind fiierele sau directoarele care nu pot fi citite. Acest cuvant cheie se aplica numai daca este utilizat impreuna cu opiunea --ignore-failed-read. Cuvintele cheie aplicabile pentru tar --extract: existing-file "%s: se omite fiierul existent" timestamp "%s: inregistrare de timp neverosimila %s" "%s: marcajul de ora %s este %s secunde in viitor" contiguous-cast "Extrage fiierele contigue ca fiiere normale" symlink-cast "Se incearca extragerea legaturilor simbolice ca legaturi dure" unknown-cast "%s: Tip de fiier necunoscut ,,%c", extras ca fiier normal" ignore-newer "%s curent este mai nou sau de aceeai varsta" unknown-keyword "Se ignora cuvantul cheie necunoscut din antetul extins ,,%s"" decompress-program Controleaza o descriere detaliata a eecurilor care apar atunci cand se incearca sa se execute programe de decomprimare alternative. Acest avertisment este dezactivat in mod implicit (cu excepia cazului in care se utilizeaza --verbose). Un exemplu obinuit de ceea ce putei obine atunci cand utilizai acest avertisment este: $ tar --warning=decompress-program -x -f archive.Z tar (proces-copil): nu se poate rula comprimarea: Nu exista un astfel de fiier sau director tar (proces-copil): se incearca gzip Acest lucru inseamna ca tar a incercat mai intai sa decomprime archive.Z folosind compress i, cand a euat, a trecut la gzip. record-size "Dimensiune inregistrare = %lu blocuri" Cuvintele cheie care controleaza extragerea incrementala: rename-directory "%s: Directorul a fost redenumit de la %s" "%s: Directorul a fost redenumit" new-directory "%s: Directorul este nou" xdev "%s: directorul este pe un dispozitiv diferit; nu se curaa" bad-dumpdir "Director de transferare malformat: ,,X" niciodata utilizat" -w, --interactive, --confirmation Cere confirmare pentru fiecare aciune. Opiuni compatibilitate -o Cand se creeaza, la fel ca --old-archive. Cand se extrage, la fel ca --no-same-owner. Sufixe de dimensiune Sufix Unitatea Echivalentul in octei b Blocuri DIMENSIUNEA x 512 B Kilooctei DIMENSIUNEA x 1024 c Octei DIMENSIUNEA G Gigaoctei DIMENSIUNEA x 1024^3 K Kilooctei DIMENSIUNEA x 1024 k Kilooctei DIMENSIUNEA x 1024 M Megaoctei DIMENSIUNEA x 1024^2 P Petaoctei DIMENSIUNEA x 1024^5 T Teraoctei DIMENSIUNEA x 1024^4 w Cuvinte DIMENSIUNEA x 2 VALOAREA RETURNATA Codul de ieire a lui <> indica daca a reuit sa efectueze cu succes operaia solicitata i, in caz contrar, ce fel de eroare s-a produs. 0 Executarea programului s-a incheiat fara erori. 1 Unele fiiere difera. Daca tar a fost invocat cu opiunea de linie de comanda --compare (--diff, -d), aceasta inseamna ca unele fiiere din arhiva difera de cele de pe disc. Daca tar a primit una dintre opiunile --create, --append sau --update, acest cod de ieire inseamna ca unele fiiere au fost modificate in timp ce erau arhivate i, prin urmare, arhiva rezultata nu conine o copie exacta a setului de fiiere. 2 Eroare fatala. Aceasta inseamna ca s-a produs o eroare fatala, irecuperabila. Daca un subproces care a fost invocat de tar a ieit cu un cod de ieire diferit de zero, tar insui iese cu acest cod. Acest lucru se poate intampla, de exemplu, daca a fost utilizata o opiune de comprimare (de exemplu, -z), iar programul de comprimare extern a euat. Un alt exemplu este eecul rmt in timpul copierii de rezerva pe un dispozitiv de la distana. CONSULTAI I bzip2(1), compress(1), gzip(1), lzma(1), lzop(1), rmt(8), symlink(7), xz(1), zstd(1). Pentru a consulta manualul complet de tar: rulai comanda <> sau utilizai modul info emacs(1) pentru a-l citi. Copii disponibile in Internet ale documentaiei GNU tar in diferite formate pot fi gasite la: https://www.gnu.org/software/tar/manual RAPORTAREA ERORILOR Raportai erorile la . DREPTURI DE AUTOR Drepturi de autor (C) 2023 Free Software Foundation, Inc. Licena GPLv3+: GNU GPL versiunea 3 sau ulterioara . Acesta este software liber: suntei liber sa-l modificai i sa-l redistribuii. Nu exista NICIO GARANIE, in limitele prevazute de lege. 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 . TAR 11 iulie 2022 TAR(1)