Man page - tar(1)

Packages contains this manual

Available languages:

en fr es pl nl da tr ja uk ro zh_TW zh_CN de

Manual

TAR

NUME
SINOPSIS
Utilizarea tradițională
Utilizarea în stilul UNIX
Utilizarea în stilul GNU
NOTĂ
DESCRIERE
Stiluri de opțiuni
Mod de operare
OPȚIUNI
Modificatori operaţie
Suprascrie controlul
Selectarea fluxului de ieșire
Manipulare atribute fişiere
Atribute de fișier extinse
Selectare şi schimbare unitate
Blocuri unitate
Selecţie format arhivă
Opțiuni de comprimare
Selecție fișier local
Transformări de nume de fișier
Opțiuni de potrivire a numelui de fișier
Ieşire informativă
Opțiuni compatibilitate
Sufixe de dimensiune
VALOAREA RETURNATĂ
CONSULTAȚI ȘI
RAPORTAREA ERORILOR
DREPTURI DE AUTOR
TRADUCERE

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 t ape ar chiver), 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 N a 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 N x1024 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 BLOCURI x 512 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 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 .