TAR(1)

NUME
tar - un instrument pentru arhivare

SINOPSIS

  Utilizarea tradițională
tar {A|c|d|r|t|u|x}[GnSkUWOmpsMBiajJzZhPlRvwo] [ARG...]

  Utilizarea în stilul UNIX

tar -A [OPȚIUNI] -f ARHIVĂ ARHIVĂ...

tar -c [-f ARHIVĂ] [OPȚIUNI] [FIȘIER...]

tar -d [-f ARHIVĂ] [OPȚIUNI] [FIȘIER...]

tar -r [-f ARHIVĂ] [OPȚIUNI] [FIȘIER...]

tar -t [-f ARHIVĂ] [OPȚIUNI] [NUME-MEMBRU...]

tar -u [-f ARHIVĂ] [OPȚIUNI] [FIȘIER...]

tar -x [-f ARHIVĂ] [OPȚIUNI] [NUME-MEMBRU...]

  Utilizarea în stilul GNU

tar {--catenate|--concatenate} [OPȚIUNI] --file ARHIVĂ ARHIVĂ...

tar --create [--file ARHIVĂ] [OPȚIUNI] [FIȘIER...]

tar {--diff|--compare} [--file ARHIVĂ] [OPȚIUNI] [FIȘIER...]

tar --delete [--file ARHIVĂ] [OPȚIUNI] [NUME-MEMBRU...]

tar --append [--file ARHIVĂ] [OPȚIUNI] [FIȘIER...]

tar --list [--file ARHIVĂ] [OPȚIUNI] [NUME-MEMBRU...]

tar --test-label [--file ARHIVĂ] [OPȚIUNI] [ETICHETA...]

tar --update [--file ARHIVĂ] [OPȚIUNI] [FIȘIER...]

tar {--extract|--get} [--file ARHIVĂ] [OPȚIUNI] [NUME-MEMBRU...]

NOTĂ
Această pagină de manual este o scurtă descriere a GNU tar. Pentru o discuție detaliată, inclusiv exemple și recomandări de utilizare, consultați Manualul GNU Tar disponibil în format texinfo. Dacă cititorul info și documentația tar sunt instalate corect pe sistemul dumneavoastră, comanda

    info tar

ar trebui să vă permită accesul la manualul complet.

De asemenea, puteți vizualiza manualul folosind modul info din emacs(1) sau îl puteți găsi în diverse formate online la adresa

    https://www.gnu.org/software/tar/manual

În cazul în care apar discrepanțe între această pagină de manual și manualul Manualul GNU Tar, acesta din urmă va fi considerat sursa care are autoritate.

DESCRIERE
GNU tar este un program de arhivare conceput pentru a stoca mai multe fișiere într-un singur fișier ("o arhivă") și pentru a manipula astfel de arhive. Arhiva poate fi fie un fișier obișnuit, fie un dispozitiv (de exemplu, o unitate de bandă magnetică (tape drive), de unde și numele programului, care vine de la tape archiver), care poate fi localizat fie pe o mașină locală, fie pe o mașină aflată la distanță.

  Stiluri de opțiuni
Opțiunile pentru GNU tar pot fi date în trei stiluri diferite. În stilul tradițional, primul argument este un grup de litere de opțiune și toate argumentele ulterioare furnizează argumente pentru acele opțiuni care le solicită. Argumentele sunt citite în aceeași ordine ca și literele de opțiune. Toate cuvintele din linia de comandă care rămân după ce toate opțiunile au fost procesate sunt tratate ca argumente fără opțiune: nume de fișiere sau de membri ai arhivei.

De exemplu, opțiunea c solicită crearea arhivei, opțiunea v solicită ca operația să se efectueze cu informații detaliate despre ce se realizează, iar opțiunea f primește un argument care stabilește numele arhivei pe care se operează. Următoarea comandă, scrisă în stilul tradițional, ordonă lui «tar» să stocheze toate fișierele din directorul /etc în fișierul de arhivă etc.tar enumerând în mod detaliat fișierele care sunt arhivate:

    tar cfv etc.tar /etc

În stilul UNIX sau cu opțiuni scurte, fiecare literă de opțiune este precedată de o singură liniuță, ca în cazul altor instrumente de linie de comandă. Dacă o opțiune are un argument, argumentul o urmează, fie ca un cuvânt separat în linia de comandă, fie imediat după opțiune. Cu toate acestea, în cazul în care opțiunea are un argument opțional, argumentul trebuie să urmeze litera opțiunii fără niciun spațiu alb intermediar, ca în -g/tmp/snar.db.

Orice număr de opțiuni care nu primesc argumente pot fi grupate împreună după o singură liniuță, de exemplu -vkp. O opțiune care preia un argument (indiferent că este obligatoriu sau opțional) poate apărea la sfârșitul unui astfel de grup, de exemplu -vkpf a.tar.

Exemplul de comandă de mai sus scris în stilul cu opțiune scurtă ar putea arăta astfel:

    tar -cvf etc.tar /etc
sau
    tar -c -v -f etc.tar /etc

În GNU sau stilul cu opțiuni lungi, fiecare opțiune începe cu două liniuțe și are un nume semnificativ, format din litere minuscule și liniuțe. Atunci când este utilizată, opțiunea lungă poate fi abreviată la literele sale inițiale, cu condiția ca acest lucru să nu creeze ambiguitate. Argumentele pentru opțiunile lungi sunt furnizate fie ca un cuvânt separat în linia de comandă, imediat după opțiune, fie separate de opțiune printr-un semn egal, fără spații albe intermediare. Argumentele opționale trebuie să utilizeze întotdeauna cea din urmă metodă.

Iată mai multe moduri de a scrie comanda dată de exemplu în acest stil:

    tar --create --file etc.tar --verbose /etc
sau (abreviind unele opțiuni):
    tar --cre --file=etc.tar --verb /etc

Opțiunile din toate cele trei stiluri pot fi amestecate, deși nu se încurajează să faceți acest lucru cu opțiunile vechi.

  Mod de operare
Opțiunile enumerate în tabelul de mai jos îi indică lui GNU tar ce operațiune trebuie să efectueze. Trebuie să se dea exact una dintre ele. Semnificația argumentelor fără opțiuni depinde de modul de operare solicitat.

-A, --catenate, --concatenate
    Adaugă arhive la sfârșitul unei alte arhive. Argumentele sunt tratate ca nume de arhive care trebuie adăugate. Toate arhivele trebuie să aibă același format ca arhiva la care sunt adăugate, în caz contrar arhiva rezultată ar putea fi inutilizabilă în cazul implementărilor non-GNU ale lui tar. Rețineți, de asemenea, că atunci când se indică mai multe arhive, membrii din alte arhive decât prima vor fi accesibili în arhiva rezultată numai când se utilizează opțiunea -i (--ignore-zeros). Arhivele comprimate nu pot fi concatenate.

-c, --create
    Creează o nouă arhivă. Argumentele furnizează numele fișierelor care urmează să fie arhivate. Directoarele sunt arhivate recursiv, cu excepția cazului în care este dată opțiunea --no-recursion.

-d, --diff, --compare
    Găsește diferențele dintre arhivă și sistemul de fișiere. Argumentele sunt opționale și specifică membrii arhivei care trebuie comparați. Dacă nu se specifică, se presupune că este vorba de directorul de lucru curent.

--delete
    Șterge din arhivă. Argumentele furnizează numele membrilor arhivei care urmează să fie eliminați. Trebuie să se dea cel puțin un argument. Această opțiune nu funcționează în cazul arhivelor comprimate. Nu există o opțiune scurtă echivalentă.

-r, --append
    Adaugă fișiere la sfârșitul unei arhive. Argumentele au aceeași semnificație ca pentru -c (--create).

-t, --list
    Listează conținutul unei arhive. Argumentele sunt opționale. Atunci când sunt date, acestea specifică numele membrilor care trebuie listați.

--test-label
    Testează eticheta volumului de arhivă și iese. Atunci când este utilizat fără argumente, imprimă eticheta volumului (dacă există) și iese cu starea 0. Atunci când sunt date unul sau mai multe argumente în linia de comandă, tar compară eticheta volumului cu fiecare argument. Iese cu codul 0 dacă se găsește o potrivire, iar în caz contrar cu codul 1. Nu se afișează nici o ieșire, cu excepția cazului în care se utilizează împreună cu opțiunea -v (--verbose). Nu există o opțiune scurtă echivalentă pentru această opțiune.

-u, --update
    Adaugă fișiere care sunt mai noi decât copia corespunzătoare din arhivă. Argumentele au aceeași semnificație ca și în cazul opțiunilor -c și -r. Observați că fișierele mai noi nu înlocuiesc vechile lor copii din arhivă, ci sunt adăugate la sfârșitul arhivei. Arhiva rezultată poate astfel să conțină mai mulți membri cu același nume, care corespund diferitelor versiuni ale aceluiași fișier.

-x, --extract, --get
    Extrage fișiere dintr-o arhivă. Argumentele sunt opționale. Atunci când sunt date, acestea specifică numele membrilor arhivei care urmează să fie extrași.

--show-defaults
    Afișează valorile implicite predefinite pentru diferite opțiuni ale lui tar și iese.

-?, --help
    Afișează un scurt rezumat al opțiunilor și iese.

--usage
    Afișează o listă de opțiuni disponibile și iese.

--version
    Afișează versiunea programului și informațiile privind drepturile de autor și iese.

OPȚIUNI

  Modificatori operaţie

--check-device
    Verifică numele dispozitivelor când se creează arhivele incrementale (implicit).

-g, --listed-incremental=FIȘIER
    Gestionează noile copii de rezervă incrementale în format GNU. FIȘIER este numele unui fișier de instantanee, în care tar stochează informații suplimentare care sunt utilizate pentru a decide ce fișiere s-au modificat de la precedenta copie de rezervă incrementală și, în consecință, trebuie să fie din nou copiate. Dacă FIȘIER nu există la crearea unei arhive, acesta va fi creat și toate fișierele vor fi adăugate la arhiva rezultată (copia de rezervă nivel 0). Pentru a crea arhive incrementale de nivel N diferit de zero, trebuie să creați o copie a fișierului de instantanee creat în timpul creării copiei de rezervă de nivel N-1 și să-l utilizați ca FIȘIER. La listare sau la extragere, conținutul real al FIȘIERULUI nu este inspectat, ci este necesar doar din cauza cerințelor sintactice. Prin urmare, este o practică obișnuită să se utilizeze /dev/null în locul acestuia.

--hole-detection=METODA
    Utilizează METODA pentru a detecta găurile din fișierele disperse. Această opțiune implică --sparse. Valorile valide pentru METODĂ sunt seek și raw. Valoarea implicită este seek cu revenire la raw atunci când nu este cazul.

-G, --incremental
    Gestionează vechiul format GNU de copii de rezervă incrementale.

--ignore-failed-read
    Nu termină cu un cod de ieșire diferit de zero dacă fișierele nu pot fi citite.

--level=NUMĂR
    Stabilește nivelul de salvare pentru o arhivă creată în lista de arhivă incrementală. În prezent, numai --level=0 este semnificativ: acesta îi indică lui tar să trunchieze fișierul de instantanee înainte de salvare, forțând astfel o salvare de nivel 0.

-n, --seek
    Presupune că arhiva poate fi explorată. În mod normal, tar determină automat dacă arhiva poate fi explorată sau nu. Această opțiune este destinată utilizării în cazurile în care o astfel de recunoaștere eșuează. Ea are efect numai dacă arhiva este deschisă pentru citire (de exemplu, cu opțiunile --list sau --extract).

--no-check-device
    Nu verifică numerele dispozitivelor la crearea arhivelor incrementale.

--no-seek
    Presupune că arhiva nu poate fi explorată.

--occurrence[=N]
    Procesează numai a Na apariție a fiecărui fișier din arhivă. Această opțiune este valabilă numai atunci când este utilizată cu una dintre următoarele subcomenzi: --delete, --diff, --extract sau --list și atunci când se furnizează o listă de fișiere fie în linia de comandă, fie prin intermediul opțiunii -T. Valoarea implicită pentru N este 1.

--restrict
    Dezactivează utilizarea unor opțiuni potențial dăunătoare.

--sparse-version=MAJOR[.MINOR]
    Stabilește ce versiune a formatului de dispersie trebuie să fie utilizată. Această opțiune implică --sparse. Valorile valide ale argumentului sunt 0.0, 0.1 și 1.0. Pentru o discuție detaliată a formatelor de dispersie, consultați Manualul GNU Tar, apendicele D, „Sparse Formats”. Utilizând cititorul info, acesta poate fi accesat executând următoarea comandă: «info tar 'Sparse Formats'».

-S, --sparse
    Gestionează eficient fișierele disperse. Unele fișiere din sistemul de fișiere pot avea segmente care, de fapt, nu au fost scrise niciodată (destul de des, acestea sunt fișiere de baze de date create de sisteme precum DBM). Atunci când i se dă această opțiune, tar încearcă să determine dacă fișierul este dispers înainte de a-l arhiva și, în caz afirmativ, să reducă dimensiunea arhivei rezultate prin faptul că nu descarcă părțile goale din fișier.

  Suprascrie controlul
Aceste opțiuni controlează acțiunile tar la extragerea unui fișier peste o copie existentă pe disc.

-k, --keep-old-files
    Nu înlocuiește fișierele existente atunci când extrage.

--keep-newer-files
    Nu înlocuiește fișierele existente care sunt mai noi decât copiile acestora din arhivă.

--keep-directory-symlink
    Păstrează legăturile simbolice existente către directoare când extrage.

--no-overwrite-dir
    Păstrează metadatale directoarelor existente.

--one-top-level[=DIR]
    Extrage toate fișierele în DIR, sau, dacă este folosit fără argument, într-un subdirector numit după numele de bază al arhivei (minus sufixele standard de compresie recunoscute de --auto-compress).

--overwrite
    Suprascrie fișierele existente la extragere.

--overwrite-dir
    Suprascrie metadatele directoarelor existente când extrage (implicit).

--recursive-unlink
    Elimină în mod recursiv toate fișierele din director înainte de a le extrage.

--remove-files
    Elimină fișierele de pe disc după adăugarea lor în arhivă.

--skip-old-files
    Nu înlocuiește fișierele existente atunci când extrage, trece peste ele în mod silențios.

-U, --unlink-first
    Elimină fiecare fișier înainte de a extrage peste el.

-W, --verify
    Verifică arhiva după scrierea acesteia.

  Selectarea fluxului de ieșire

--ignore-command-error
    Ignoră codurile de ieșire ale subproceselor.

--no-ignore-command-error
    Tratează codurile de ieșire diferite de zero ale proceselor-copii ca eroare (implicit).

-O, --to-stdout
    Extrage fișierele la ieșirea standard.

--to-command=COMANDA
    Dirijează fișierele extrase către COMANDA. Argumentul este ruta de acces a unui program extern, opțional cu argumente de linie de comandă. Programul va fi invocat, iar conținutul fișierului extras îi va fi furnizat pe intrarea standard a acestuia. Datele suplimentare vor fi furnizate prin intermediul următoarelor variabile de mediu:

    TAR_FILETYPE
        Tipul de fișier. Este o singură literă cu următoarea semnificație:

        	f	fișier obișnuit
        	d	director
        	l	legătură simbolică
        	h	legătură dură
        	b	dispozitiv de blocn
        	c	dispozitiv de caracter
        În prezent, sunt acceptate doar fișierele obișnuite.

    TAR_MODE
        Modul de fișier (permisiunile fișierului), un număr octal.

    TAR_FILENAME
        Numele fișierului.

    TAR_REALNAME
        Numele fișierului, așa cum este stocat în arhivă.

    TAR_UNAME
        Numele proprietarului fișierului.

    TAR_GNAME
        Numele grupului proprietar al fișierului.

    TAR_ATIME
        Ora ultimei accesări. Este un număr zecimal, reprezentând secundele scurse de la „Epoca”. În cazul în care arhiva furnizează ore cu precizie de nanosecunde, nanosecundele sunt adăugate la marca temporală după un punct zecimal.

    TAR_MTIME
        Data și ora ultimei modificări.

    TAR_CTIME
        Data și ora ultimei schimbări de stare.

    TAR_SIZE
        Dimensiunea fișierului.

    TAR_UID
        UID-ul proprietarului fișierului.

    TAR_GID
        GID-ul proprietarului fișierului.
    În plus, următoarele variabile conțin informații despre modul de operare tar și despre arhiva care este procesată:

    TAR_VERSION
        Numărul versiunii GNU tar.

    TAR_ARCHIVE
        Numele arhivei pe care o procesează tar.

    TAR_BLOCKING_FACTOR
        Coeficientul de blocuri curent, adică numărul de blocuri de 512 octeți dintr-o înregistrare.

    TAR_VOLUME
        Numărul ordinal al volumului pe care tar îl prelucrează (setul dacă se citește o arhivă cu mai multe volume).

    TAR_FORMAT
        Formatul arhivei în curs de prelucrare. Unul dintre următoarele: gnu, oldgnu, posix, ustar, v7.

    TAR_SUBCOMMAND
        Opțiune scurtă (cu o liniuță de început) care descrie operația pe care o execută tar.

  Manipulare atribute fişiere

--atime-preserve[=METODA]
    Păstrează data și ora de acces la fișierele transferate, fie prin restabilirea datei și orei după citire (METODA=replace, aceasta este valoarea implicită), fie prin nestabilirea datei și orei în primul rând (METODA=system).

--delay-directory-restore
    Amână stabilirea datei și orei de modificare și a permisiunilor directoarelor extrase până la sfârșitul extragerii. Utilizați această opțiune atunci când extrageți dintr-o arhivă care are o ordine neobișnuită a membrilor.

--group=NUME[:GID]
    Forțează NUME ca grup pentru fișierele adăugate. Dacă GID nu este furnizat, NUMEle poate fi, fie un nume de utilizator, fie un GID numeric. În acest caz, partea care lipsește (GID sau nume) va fi dedusă din baza de date de grupuri a gazdei curente. Atunci când se utilizează cu --group-map=FIȘIER, afectează numai acele fișiere al căror grup proprietar nu este listat în FIȘIER.

--group-map=FIȘIER
    Citește tabelul de traducere al grupului din FIȘIER. Liniile goale sunt ignorate. Comentariile sunt introduse cu semnul # și se extind până la sfârșitul liniei. Fiecare linie care nu este goală din FIȘIER definește traducerea pentru un singur grup. Aceasta trebuie să fie formată din două câmpuri, delimitate de orice cantitate de spațiu alb:
        GRUPUL_VECHI GRUPUL_NOU[:GID_NOU]
    GRUPUL_VECHI este fie un nume de grup valid, fie un GID prefixat cu +. Cu excepția cazului în care se furnizează GID_NOU, GRUPUL_NOU trebuie să fie, de asemenea, fie un nume de grup valid, fie un +GID. În caz contrar, atât GRUPUL_NOU, cât și GID_NOU nu trebuie să fie listate în baza de date a grupurilor de sistem. Ca urmare, fiecare fișier de intrare cu grupul proprietar GRUPUL_VECHI va fi stocat în arhiva cu grupul proprietar GRUPUL_NOU și GID-ul GID_NOU.

--mode=SCHIMBĂRI
    Forțează mod (simbolic) SCHIMBĂRI pentru fișierele adăugate.

--mtime=DATA-SAU_FIȘIERUL
    Stabilește „mtime” pentru fișierele adăugate. DATA-SAU-FIȘIERUL este fie o dată/ora într-un format aproape arbitrar, fie numele unui fișier existent. În acest din urmă caz, se va utiliza „mtime” a acelui fișier.

-m, --touch
    Nu extrage ora și data de modificare al fișierului.

--no-delay-directory-restore
    Anulează efectul opțiunii anterioare --delay-directory-restore.

--no-same-owner
    Extrage fișierele ca tine (implicit pentru utilizatorii obișnuiți).

--no-same-permissions
    Aplică masca de permisiuni a utilizatorului când se extrag permisiunile de la arhivă (implicit pentru utilizatorii obișnuiți).

--numeric-owner
    Utilizează întotdeauna numere pentru numele utilizatorilor/grupurilor.

--owner=NUME[:UID]
    Forțează NUME ca proprietar pentru fișierele adăugate. Dacă UID nu este furnizat, NUME poate fi fie un nume de utilizator, fie un UID numeric. În acest caz, partea care lipsește (UID sau nume) va fi dedusă din baza de date de utilizatori a gazdei curente. Atunci când se utilizează cu --owner-map=FIȘIER, afectează numai acele fișiere al căror proprietar nu este listat în FIȘIER.

--owner-map=FIȘIER
    Citește tabelul de traducere al proprietarului din FIȘIER. Liniile goale sunt ignorate. Comentariile sunt introduse cu semnul # și se extind până la sfârșitul liniei. Fiecare linie care nu este goală din FIȘIER definește traducerea pentru un singur UID. Aceasta trebuie să fie formată din două câmpuri, delimitate de orice cantitate de spațiu alb:
        UTILIZATOR_VECHI UTILIZATOR_NOU[:UID_NOU]
    UTILIZATOR_VECHI este fie un nume de utilizator valid, fie un UID prefixat cu +. Cu excepția cazului în care se furnizează UID_NOU, UTILIZATOR_NOU trebuie să fie, de asemenea, fie un nume de utilizator valid, fie un +UID. În caz contrar, atât UTILIZATOR_NOU, cât și UID_NOU nu trebuie să fie listate în baza de date a utilizatorilor sistemului. Ca urmare, fiecare fișier de intrare deținut de UTILIZATOR_VECHI va fi stocat în arhivă cu numele proprietarului UTILIZATOR_NOU și UID-ul UID_NOU.

-p, --preserve-permissions, --same-permissions
    Stabileștepermisiunile fișierelor extrase la cele înregistrate în arhivă (implicit pentru superutilizator).

--same-owner
    Încearcă să extragi fișierele cu același proprietar ca cel care există în arhivă (implicit pentru superutilizator).

-s, --preserve-order, --same-order
    Îi indică lui tar că lista de nume de fișiere de procesat este sortată în aceeași ordine ca și fișierele din arhivă.

--sort=ORDINE
    Atunci când creează o arhivă, sortează intrările din directoare în funcție de ORDINE, care este unul dintre: none (niciuna), name (nume) sau inode (nod-i). Valoarea implicită este --sort=none (niciuna), care stochează membrii arhivei în aceeași ordine în care este returnată de sistemul de operare. Folosind --sort=name (nume) se asigură că ordinea membrilor în arhiva creată este uniformă și reproductibilă. Utilizarea --sort=inode (nod-i) reduce numărul de căutări pe disc la crearea arhivei și, prin urmare, poate accelera considerabil arhivarea. Această ordine de sortare este acceptată numai dacă sistemul de bază furnizează informațiile necesare.

  Atribute de fișier extinse

--acls
    Activează suportul ACLs POSIX.

--no-acls
    Dezactivează suportul ACLs POSIX.

--selinux
    Activează suportul de context SELinux.

--no-selinux
    Dezactivează suportul de context SELinux.

--xattrs
    Activează suportul de atribute extinse.

--no-xattrs
    Dezactivează suportul de atribute extinse.

--xattrs-exclude=MODEL
    Specifică modelul de excludere pentru cheile xattr. MODEL este un mode global (utilizează metacaractere), de exemplu, --xattrs-exclude='user.*', pentru a include doar atributele din spațiul de nume al utilizatorului.

--xattrs-include=MODEL
    Specifică modelul de includere pentru cheile xattr. MODEL este un model global (bazat pe metacaractere).

  Selectare şi schimbare unitate

-f, --file=ARHIVĂ
    Utilizează fișierul arhivă sau dispozitivul ARHIVĂ. Dacă această opțiune nu este dată, tar va examina mai întâi variabila de mediu „TAPE”. Dacă aceasta este definită, valoarea sa va fi utilizată ca nume de arhivă. În caz contrar, tar va prelua valoarea implicită compilată. Valoarea implicită poate fi inspectată fie cu ajutorul opțiunii --show-defaults, fie la sfârșitul ieșirii comenzii tar --help. Un nume de arhivă care are în el două puncte specifică un fișier sau un dispozitiv de pe o mașină aflată la distanță. Partea de dinaintea celor două puncte este considerată ca fiind numele mașinii sau adresa IP, iar partea de după ca fiind numele de acces la fișier sau dispozitiv, de exemplu:
        --file=gazdă_la_distanță:/dev/sr0
    Un nume de utilizator opțional poate fi prefixat la numele de gazdă, plasând un semn @ între ele. În mod implicit, gazda de la distanță este accesată prin intermediul comenzii rsh(1). În prezent, este obișnuit să se utilizeze în schimb ssh(1). Puteți face acest lucru oferind următoarea opțiune de linie de comandă:
        --rsh-command=/usr/bin/ssh
    Mașina de la distanță trebuie să aibă instalată comanda rmt(8). În cazul în care numele său de rută nu se potrivește cu cel implicit al tar, puteți informa tar cu privire la numele de rută corect folosind opțiunea --rmt-command.

--force-local
    Fișierul arhivă este local chiar dacă are două puncte.

-F, --info-script=COMANDA, --new-volume-script=COMANDA
    Rulează COMANDA la sfârșitul fiecărei benzi magnetice (implică -M). Comanda poate include argumente. Când este lansată, va moșteni mediul lui tar plus următoarele variabile:

    TAR_VERSION
        Numărul versiunii GNU tar.

    TAR_ARCHIVE
        Numele arhivei pe care o procesează tar.

    TAR_BLOCKING_FACTOR
        Coeficientul de blocuri curent, adică numărul de blocuri de 512 octeți dintr-o înregistrare.

    TAR_VOLUME
        Numărul ordinal al volumului pe care tar îl prelucrează (setul dacă se citește o arhivă cu mai multe volume).

    TAR_FORMAT
        Formatul arhivei în curs de prelucrare. Unul dintre următoarele: gnu, oldgnu, posix, ustar, v7.

    TAR_SUBCOMMAND
        Opțiune scurtă (cu o liniuță de început) care descrie operația pe care o execută tar.

    TAR_FD
        Descriptorul de fișier care poate fi utilizat pentru a comunica noul nume de volum către tar.
    Dacă scriptul „info” eșuează, tar iese; în caz contrar, începe să scrie următorul volum.

-L, --tape-length=N
    Schimbă banda magnetică după ce a scris Nx1024 octeți. Dacă N este urmat de un sufix de mărime (a se vedea subsecțiunea Sufixe de mărime de mai jos), sufixul specifică factorul multiplicativ care trebuie utilizat în loc de 1024. Această opțiune implică -M.

-M, --multi-volume
    Creează/listează/extrage o arhivă multi-volum.

--rmt-command=COMANDA
    Utilizează COMANDA în loc de rmt la accesarea arhivelor de la distanță. A se vedea descrierea opțiunii -f, de mai sus.

--rsh-command=COMANDA
    Utilizează COMANDA în loc de rsh la accesarea arhivelor de la distanță. A se vedea descrierea opțiunii -f, de mai sus.

--volno-file=FIȘIER
    Atunci când această opțiune este utilizată împreună cu --multi-volum, tar va ține evidența volumului dintr-o arhivă multi-volum în care lucrează în FIȘIER.

  Blocuri unitate

-b, --blocking-factor=BLOCURI
    Stabilește dimensiunea înregistrării la BLOCURIx512 octeți.

-B, --read-full-records
    Când listează sau extrage, acceptă înregistrările de intrare incomplete după marcajul de sfârșit de fișier.

-i, --ignore-zeros
    Ignoră blocurile care constau în zerouri din arhivă. În mod normal, două blocuri consecutive de 512 blocuri umplute cu zerouri înseamnă EOF (sfârșit de fișier), iar tar oprește citirea după ce le întâlnește. Această opțiune îi indică să citească în continuare și este utilă la citirea arhivelor create cu opțiunea -A.

--record-size=NUMĂR
    Stabilește dimensiunea înregistrării. NUMĂR este numărul de octeți pe înregistrare. Acesta trebuie să fie multiplu de 512. Poate fi sufixat cu un sufix size, de exemplu --record-size=10K, pentru 10 Kiloocteți. A se vedea subsecțiunea Sufixe de mărime, pentru o listă de sufixe valabile.

  Selecţie format arhivă

-H, --format=FORMAT
    Creează arhiva în 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 şi --format=v7.

--pax-option=cuvânt_cheie[[:]=valoare][,cuvânt_cheie[[:]=valoare]]...
    Controlează cuvintele-cheie pax la crearea arhivelor PAX (-H pax). Această opțiune este echivalentă cu opțiunea -o a instrumentului pax(1).

--posix
    Ca şi --format=posix.

-V, --label=TEXT
    Creează arhiva cu numele de volum TEXT. În cazul listării sau extragerii, utilizează TEXT ca model de globalizare (folosind metacaractere (caractere-jocker)) pentru numele volumului.

  Opțiuni de comprimare

-a, --auto-compress
    Utilizează sufixul arhivei pentru a determina programul de comprimare.

-I, --use-compress-program=COMANDĂ
    Filtrează datele cu ajutorul COMENZII. Trebuie să accepte opțiunea -d, pentru decomprimare. Argumentul poate conține opțiuni de linie de comandă.

-j, --bzip2
    Filtrează arhiva prin bzip2(1).

-J, --xz
    Filtrează arhiva prin xz(1).

--lzip
    Filtrează arhiva prin lzip(1).

--lzma
    Filtrează arhiva prin lzma(1).

--lzop
    Filtrează arhiva prin lzop(1).

--no-auto-compress
    Nu utilizează sufixul arhivei pentru a determina programul de comprimare.

-z, --gzip, --gunzip, --ungzip
    Filtrează arhiva prin gzip(1).

-Z, --compress, --uncompress
    Filtrează arhiva prin compress(1).

--zstd
    Filtrează arhiva prin zstd(1).

  Selecție fișier local

--add-file=FIȘIER
    Adaugă FIȘIERUL dat la arhivă (util dacă numele acestuia începe cu o liniuță).

--backup[=CONTROL]
    Face o copie de rezervă înainte de eliminare. Argumentul CONTROL, dacă este furnizat, controlează politica de copie de rezervă. Valorile sale valide sunt:

    none, off
        Nu face copii de rezervă niciodată.

    t, numbered
        Face copii de rezervă numerotate.

    nil, existing
        Creează copii de rezervă numerotate dacă există copii de rezervă numerotate, iar în caz contrar copii de rezervă simple.

    never, simple
        Face întotdeauna copii de rezervă simple
    Dacă nu se indică CONTROL, valoarea este preluată din variabila de mediu VERSION_CONTROL. Dacă aceasta nu este definită, se presupune existing (valoarea existentă).

-C, --directory=DIR
    Schimbă la DIR înainte de a efectua orice operație. Această opțiune este sensibilă la ordine, adică afectează toate opțiunile care urmează.

--exclude=MODEL
    Exclude fișierele care se potrivesc cu MODELUL, un model de metacaractere (caractere-jocker) în stil glob(3).

--exclude-backups
    Exclude fișierele de copii de rezervă și blocare.

--exclude-caches
    Exclude conținutul directoarelor care conțin fișierul CACHEDIR.TAG, cu excepția fișierului de etichetă propriu-zis.

--exclude-caches-all
    Exclude directoarele care conțin fișierul CACHEDIR.TAG și fișierul însuși.

--exclude-caches-under
    Exclude tot ceea ce se află sub directoarele care conțin CACHEDIR.TAG

--exclude-ignore=FIȘIER
    Înainte de a transfera un director, verifică dacă acesta conține FIȘIERUL. În caz afirmativ, citește modelele de excludere din acest fișier. Modelele afectează numai directorul în sine.

--exclude-ignore-recursive=FIȘIER
    La fel ca --exclude-ignore, cu excepția faptului că modelele din FIȘIER afectează atât directorul, cât și toate subdirectoarele sale.

--exclude-tag=FIȘIER
    Exclude conținutul directoarelor care conțin FIȘIERUL, cu excepția FIȘIERULUI însuși.

--exclude-tag-all=FIȘIER
    Exclude directoarele care conțin FIȘIERUL.

--exclude-tag-under=FIȘIER
    Exclude tot ceea ce se află sub directoarele care conțin FIȘIERUL.

--exclude-vcs
    Exclude directoarele sistemului de control al versiunilor.

--exclude-vcs-ignores
    Exclude fișierele care se potrivesc cu modelele citite din fișierele de ignorare specifice VCS. Fișierele acceptate sunt: .cvsignore, .gitignore, .bzrignore și .hgignore.

-h, --dereference
    Urmărește legăturile simbolice; arhivează și transferă fișierele la care arată.

--hard-dereference
    Urmărește legăturile dure; arhivează și transferă fișierele la care se referă.

-K, --starting-file=NUME-MEMBRU
    Începe de la membrul dat (NUME-MEMBRU) din arhivă.

--newer-mtime=DATA
    Lucrează pe fișiere ale căror date s-au modificat după DATA. Dacă DATA începe cu / sau ., se consideră că este un nume de fișier; „mtime” al acelui fișier este utilizat ca dată.

--no-null
    Dezactivează efectul opțiunii --null precedentă.

--no-recursion
    Evită coborârea automată în directoare.

--no-unquote
    Nu elimină ghilimelele din numele fișierului de intrare sau din numele membrilor.

--no-verbatim-files-from
    Tratează fiecare linie citită dintr-o listă de fișiere ca și cum ar fi fost furnizată în linia de comandă. Adică, se elimină spațiile albe de început și de sfârșit și, dacă șirul rezultat începe cu o liniuță, este tratat ca opțiunea de linie de comandă tar. Acesta este comportamentul implicit. Opțiunea --no-verbatim-files-from este furnizată ca o modalitate de a-l restabili după opțiunea --verbatim-files-from. Această opțiune este pozițională: afectează toate opțiunile --files-from care apar după ea în, până la opțiunea --verbatim-files-from sau până la sfârșitul liniei, în funcție de care apare mai întâi. Este subînțeleasă de opțiunea --no-null.

--null
    Indică opțiunilor ulterioare -T să citească textual (verbatim) numele cu terminație nulă (dezactivează tratarea specială a numelor care încep cu o liniuță). A se vedea, de asemenea, --verbatim-files-from.

-N, --newer=DATA, --after-date=DATA
    Stochează numai fișiere mai noi decât DATA. Dacă DATA începe cu / sau ., se consideră că este un nume de fișier; „mtime” al acelui fișier este utilizat ca dată.

--one-file-system
    Rămâne în sistemul de fișiere local la crearea arhivei.

-P, --absolute-names
    Nu înlătură barele înclinate „/” de la începutul numelor de fișiere la crearea arhivelor.

--recursion
    Coboară recursiv în directoare (implicit).

--suffix=ȘIR
    Face o copie de rezervă înaintea eliminării, suprascrie sufixul uzual. Sufixul implicit este ~, dacă nu este înlocuit de variabila de mediu SIMPLE_BACKUP_SUFFIX.

-T, --files-from=FIȘIER
    Obține numele care trebuie extrase sau create din FIȘIER. Cu excepția cazului în care se specifică altfel, FIȘIERUL trebuie să conțină o listă de nume separate prin ASCII LF (adică un nume pe linie). Numele citite sunt tratate în același mod ca și argumentele din linia de comandă. Acestea sunt supuse eliminării ghilimelelor și divizării cuvintelor, iar orice șir de caractere care începe cu un - este tratat ca o opțiune de linie de comandă tar. Dacă acest comportament nu este dorit, poate fi dezactivat cu ajutorul opțiunii --verbatim-files-from. Opțiunea --null îi indică lui tar că numele din FILE sunt separate de caracterul ASCII NUL, în loc de LF. Este utilă în cazul în care lista este generată de comanda «find(1) -print0».

--unquote
    Elimină ghilimelele din numele fișierului de intrare sau din numele membrilor (implicit)

--verbatim-files-from
    Tratează fiecare linie obținută dintr-o listă de fișiere ca pe un nume de fișier, chiar dacă începe cu o liniuță. Listele de fișiere sunt furnizate cu opțiunea --files-from (-T). Comportamentul implicit este de a trata numele furnizate în listele de fișiere ca și cum ar fi fost tastate în linia de comandă, adică orice nume care începe cu o liniuță este tratat ca o opțiune tar. Opțiunea --verbatim-files-from dezactivează acest comportament. Această opțiune afectează toate opțiunile --files-from care apar după ea în linia de comandă. Efectul său este anulat de opțiunea --no-verbatim-files-from. Această opțiune este subînțeleasă de opțiunea --null. A se vedea, de asemenea, --add-file.

-X, --exclude-from=FIȘIER
    Exclude fișierele care corespund modelelor enumerate în FIȘIER.

  Transformări de nume de fișier

--strip-components=NUMĂR
    Elimină componentele de început NUMĂR din numele fișierelor care urmează să fie extrase.

--transform=EXPRESIA, --xform=EXPRESIA
    Utilizează înlocuirea EXPRESIEI cu «sed» pentru a transforma numele fișierelor.

  Opțiuni de potrivire a numelui de fișier
Aceste opțiuni afectează atât modelele de excludere, cât și cele de includere.

--anchored
    Modelele se potrivesc cu începutul numelui fișierului.

--ignore-case
    Ignoră majusculele.

--no-anchored
    Modelele se potrivesc după fiecare / (implicit pentru excludere).

--no-ignore-case
    Potrivire sensibilă la majuscule (implicit).

--no-wildcards
    Potrivire a șirului textuală (verbatim).

--no-wildcards-match-slash
    Metacaracterele (caracterele jocker) nu se potrivesc cu /.

--wildcards
    Utilizează metacaractere (implicit pentru excludere).

--wildcards-match-slash
    Metacaracterele se potrivesc cu / (implicit pentru excludere).

  Ieşire informativă

--checkpoint[=N]
    Afișează mesajele de progres la fiecare a N-a înregistrare (implicit 10).

--checkpoint-action=ACȚIUNE
    Execută ACȚIUNEA la fiecare punct de verificare.

--clamp-mtime
    Stabilește timpul doar când fișierul este mai recent decât a fost dat cu --mtime.

--full-time
    Afișează data și ora fișierelor cu precizie maximă.

--index-file=FIȘIER
    Trimite ieșire detaliată în FIŞIER.

-l, --check-links
    Afișează un mesaj dacă nu toate legăturile sunt prelucrate.

--no-quote-chars=ȘIR
    Dezactivează punerea între ghilimele a caracterelor din ȘIR.

--quote-chars=ȘIR
    Adaugă punerea între ghilimele a caracterelor din ȘIR.

--quoting-style=STIL
    Stabilește stilul punerii între ghilimele pentru numele fișierelor și al membrilor. Valorile valabile pentru STIL sunt literal, shell, shell-always, c, c-maybe, escape, locale, clocale.

-R, --block-number
    Afișează numărul blocului din arhivă cu fiecare mesaj.

--show-omitted-dirs
    Când se listează sau se extrage, listează fiecare director care nu se potrivește cu criteriile de căutare.

--show-transformed-names, --show-stored-names
    Afișează numele fișierelor sau arhivelor după transformarea prin opțiunile --strip și --transform.

--totals[=SEMNAL]
    Afișează numărul total de octeți după procesarea arhivei. Dacă se dă SEMNAL, se imprimă numărul total de octeți atunci când este transmis acest semnal. Semnalele permise sunt: SIGHUP, SIGQUIT, SIGINT, SIGUSR1 și SIGUSR2. Prefixul SIG poate fi omis.

--utc
    Afișează timpii (data+ora) de modificare a fișierului în UTC.

-v, --verbose
    Afișează o listă detaliată a fișierelor procesate. Fiecare instanță a acestei opțiuni pe linia de comandă crește nivelul de detaliere cu un punct. Nivelul maxim de detaliere este 3. Pentru o discuție detaliată a modului în care diferitele niveluri de detaliere afectează ieșirea lui tar, consultați Manualul Tar GNU, subsecțiunea 2.5.2 „Opțiunea '--verbose'”.

--warning=CUVÂNTUL_CHEIE
    Activează sau dezactivează mesajele de avertizare identificate prin CUVÂNTUL_CHEIE. Mesajele sunt suprimate dacă CUVÂNTUL_CHEIE este prefixat cu no- și activate în caz contrar. Pot fi adăugate mai multe opțiuni --warning. Cuvintele cheie care controlează operarea generală tar:

    all Activează toate mesajele de avertizare. Aceasta este valoarea implicită.

    none
        Dezactivează toate mesajele de avertisment.

    filename-with-nuls
        "%s: numele de fișier citit conține caracterul nul"

    alone-zero-block
        "Un singur bloc de zerouri în %s"

    Cuvintele cheie aplicabile pentru tar --create:

    cachedir
        "%s: conține o etichetă de director de zonă de prestocare (cache) %s; %s"

    file-shrank
        "%s: Fișierul s-a redus cu %s octeți; se umple cu zerouri"

    xdev
        "%s: fișierul este pe un sistem de fișiere diferit; nimic generat"

    file-ignored
        "%s: Tip de fișier necunoscut; fișier ignorat"
        "%s: soclu ignorat"
        "%s: poartă(door) ignorată"

    file-unchanged
        "%s: fișierul este neschimbat; nimic generat"

    ignore-archive
        "%s: arhiva nu se poate conține pe ea însăși; nu a fost extrasă"

    file-removed
        "%s: Fișier șters înainte de a-l putea citi"

    file-changed
        "%s: fișierul s-a modificat în timp ce era citit"

    failed-read
        Suprimă avertismentele privind fișierele sau directoarele care nu pot fi citite. Acest cuvânt cheie se aplică numai dacă este utilizat împreună cu opțiunea --ignore-failed-read.

    Cuvintele cheie aplicabile pentru tar --extract:

    existing-file
        "%s: se omite fișierul existent"

    timestamp
        "%s: înregistrare de timp neverosimilă %s"
        "%s: marcajul de oră %s este %s secunde în viitor"

    contiguous-cast
        "Extrage fișierele contigue ca fișiere normale"

    symlink-cast
        "Se încearcă extragerea legăturilor simbolice ca legături dure"

    unknown-cast
        "%s: Tip de fișier necunoscut „%c”, extras ca fișier normal"

    ignore-newer
        "%s curent este mai nou sau de aceeași vârstă"

    unknown-keyword
        "Se ignoră cuvântul cheie necunoscut din antetul extins „%s”"

    decompress-program
        Controlează o descriere detaliată a eșecurilor care apar atunci când se încearcă să se execute programe de decomprimare alternative. Acest avertisment este dezactivat în mod implicit (cu excepția cazului în care se utilizează --verbose). Un exemplu obișnuit de ceea ce puteți obține atunci când utilizați acest avertisment este:
            $ tar --warning=decompress-program -x -f archive.Z
            tar (proces-copil): nu se poate rula comprimarea: Nu există un astfel de fișier sau director
            tar (proces-copil): se încearcă gzip
        Acest lucru înseamnă că tar a încercat mai întâi să decomprime archive.Z folosind compress și, când a eșuat, a trecut la gzip.

    record-size
        "Dimensiune înregistrare = %lu blocuri"

    Cuvintele cheie care controlează extragerea incrementală:

    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 curăță"

    bad-dumpdir
        "Director de transferare malformat: „X” niciodată utilizat"

-w, --interactive, --confirmation
    Cere confirmare pentru fiecare acțiune.

  Opțiuni compatibilitate

-o  Când se creează, la fel ca --old-archive. Când se extrage, la fel ca --no-same-owner.

  Sufixe de dimensiune

	Sufix	Unitatea	Echivalentul în octeți
	b	Blocuri	DIMENSIUNEA x 512
	B	Kiloocteți	DIMENSIUNEA x 1024
	c	Octeți	DIMENSIUNEA
	G	Gigaocteți	DIMENSIUNEA x 1024^3
	K	Kiloocteți	DIMENSIUNEA x 1024
	k	Kiloocteți	DIMENSIUNEA x 1024
	M	Megaocteți	DIMENSIUNEA x 1024^2
	P	Petaocteți	DIMENSIUNEA x 1024^5
	T	Teraocteți	DIMENSIUNEA x 1024^4
	w	Cuvinte	DIMENSIUNEA x 2

VALOAREA RETURNATĂ
Codul de ieșire a lui «tar» indică dacă a reușit să efectueze cu succes operația solicitată și, în caz contrar, ce fel de eroare s-a produs.

0   Executarea programului s-a încheiat fără erori.

1   Unele fișiere diferă. Dacă tar a fost invocat cu opțiunea de linie de comandă --compare (--diff, -d), aceasta înseamnă că unele fișiere din arhivă diferă de cele de pe disc. Dacă tar a primit una dintre opțiunile --create, --append sau --update, acest cod de ieșire înseamnă că unele fișiere au fost modificate în timp ce erau arhivate și, prin urmare, arhiva rezultată nu conține o copie exactă a setului de fișiere.

2   Eroare fatală. Aceasta înseamnă că s-a produs o eroare fatală, irecuperabilă.

Dacă un subproces care a fost invocat de tar a ieșit cu un cod de ieșire diferit de zero, tar însuși iese cu acest cod. Acest lucru se poate întâmpla, de exemplu, dacă a fost utilizată o opțiune de comprimare (de exemplu, -z), iar programul de comprimare extern a eșuat. Un alt exemplu este eșecul rmt în timpul copierii de rezervă pe un dispozitiv de la distanță.

CONSULTAȚI Ș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: rulați comanda «info tar» sau utilizați modul info emacs(1) pentru a-l citi.

Copii disponibile în Internet ale documentației GNU tar în diferite formate pot fi găsite la:

https://www.gnu.org/software/tar/manual

RAPORTAREA ERORILOR
Raportați erorile la <bug-tar@gnu.org>.

DREPTURI DE AUTOR
Drepturi de autor © 2023 Free Software Foundation, Inc.
Licența GPLv3+: GNU GPL versiunea 3 sau ulterioară <http://gnu.org/licenses/gpl.html>.
Acesta este software liber: sunteți liber să-l modificați și să-l redistribuiți. Nu există NICIO GARANȚIE, în limitele prevăzute de lege.

TRADUCERE
Traducerea în limba română a acestui manual a fost făcută de Remus-Gabriel Chelu <remusgabriel.chelu@disroot.org>

Această traducere este documentație gratuită; citiți Licența publică generală GNU Versiunea 3 (https://www.gnu.org/licenses/gpl-3.0.html) sau o versiune ulterioară cu privire la condiții privind drepturile de autor. NU se asumă NICIO RESPONSABILITATE.

Dacă găsiți erori în traducerea acestui manual, vă rugăm să trimiteți un e-mail la translation-team-ro@lists.sourceforge.net.