TAR(1) Podrecznik GNU TAR TAR(1) NAZWA tar - narzedzie archiwizujace SKLADNIA Skladnia tradycyjna tar {A|c|d|r|t|u|x}[GnSkUWOmpsMBiajJzZhPlRvwo] [ARG...] Skladnia uniksowa tar -A [OPCJE] -f ARCHIWUM ARCHIWUM... tar -c [-f ARCHIWUM] [OPCJE] [PLIK...] tar -d [-f ARCHIWUM] [OPCJE] [PLIK...] tar -r [-f ARCHIWUM] [OPCJE] [PLIK...] tar -t [-f ARCHIWUM] [OPCJE] [SKLADOWA...] tar -u [-f ARCHIWUM] [OPCJE] [PLIK...] tar -x [-f ARCHIWUM] [OPCJE] [SKLADOWA...] Skladnia GNU tar {--catenate|--concatenate} [OPCJE] --file ARCHIWUM ARCHIWUM... tar --create [--file ARCHIWUM] [OPCJE] [PLIK...] tar {--diff|--compare} [--file ARCHIWUM] [OPCJE] [PLIK...] tar --delete [--file ARCHIWUM] [OPCJE] [SKLADOWA...] tar --append [--file ARCHIWUM] [OPCJE] [PLIK...] tar --list [--file ARCHIWUM] [OPCJE] [SKLADOWA...] tar --test-label [--file ARCHIWUM] [OPCJE] [ETYKIETA...] tar --update [--file ARCHIWUM] [OPCJE] [PLIK...] tar {--extract|--get} [--file ARCHIWUM] [OPCJE] [SKLADOWA...] UWAGA Niniejsza strona podrecznika jest streszczeniem opisu GNU tar. Pelne informacje, w tym przyklady i zalecane sposoby uzycia opisano w Podreczniku GNU Tar, dostepnym w formacie texinfo. Jesli tar i czytnik info sa prawidlowo zainstalowane w tym systemie, polecenie info tar powinno dac dostep do pelnego podrecznika. Podrecznik mozna przegladac rowniez korzystajac z trybu info edytora emacs(1) oraz w roznych formatach pod adresem https://www.gnu.org/software/tar/manual W przypadku rozbieznosci miedzy niniejszym podrecznikiem systemowym a Podrecznikiem GNU Tar, ten ostatni nalezy uwazac za rozstrzygajacy. OPIS GNU tar to program archiwizujacy, zaprojektowany do umieszczania wielu plikow w pliku pojedynczym (archiwum) oraz modyfikowania takich archiwow. Archiwum moze byc zwyklym plikiem lub urzadzeniem (np. napedem tasmowym; stad pochodzi zreszta nazwa programu, bedaca skrotem od tasmowy archiwizator), zlokalizowanym na komputerze lokalnym lub zdalnym. Style skladni opcji Opcje GNU tar mozna podac w trzech roznych stylach skladni. W skladni tradycyjnej pierwszy argument jest zlepkiem liter opcji, a wszystkie nastepne argumenty dostarczaja argumenty opcjom, ktore ich wymagaja. Argumenty sa odczytywane w tej samej kolejnosci, co litery opcji. Wszelkie slowa wiersza polecen, ktore pozostana po przetworzeniu wszystkich opcji, sa traktowane jako argumenty niebedace opcjami: plikami lub nazwami czesci archiwum. Na przyklad opcja c wymaga utworzenia archiwum, opcja v zada wiekszej szczegolowosci komunikatow, a opcja f przyjmuje argument, ktory ustawia nazwe przedmiotowego archiwum. Ponizsze polecenie, zapisane w skladni tradycyjnej, poleca programowi tar na umieszczenie wszystkich plikow z katalogu /etc w pliku archiwum etc.tar, szczegolowo wypisujac archiwizowane pliku: tar cfv etc.tar /etc W skladni uniksowej lub skladni z krotkimi opcjami, kazda litere opcji poprzedza pojedyncza kreska, podobnie jak w innych narzedziach wiersza polecen. Jesli opcja przyjmuje argument, umiejscowiony jest on po opcji, albo jako oddzielne slowo wiersza polecen, albo bezposrednio (bez spacji) po opcji. Jednakze, jesli opcja przyjmuje argument opcjonalny, argument musi byc podany po literze opcji bez rozdzielenia spacja np. -g/tmp/snar.db. Po kresce, mozna zlepic ze soba dowolna liczbe opcji nieprzyjmujacych argumentow np. -vkp. Opcja przyjmujaca argument (obowiazkowy lub opcjonalny) moze pojawic sie na koncu takiego sklejenia np. -vkpf a.tar. Przyklad podany wyzej, wygladalby nastepujaco w skladni z krotkimi opcjami: tar -cvf etc.tar /etc lub tar -c -v -f etc.tar /etc E skladni GNU lub skladni z dlugimi opcjami, kazda opcja zaczyna sie od dwoch kresek i ma znaczaca nazwe, skladajaca sie z malych liter i kresek. Dluga opcje mozna skrocic do poczatkowych liter, o ile dany skrot nie bedzie wieloznaczny. Argumenty do dlugich opcji podaje sie albo jako osobne slowa wiersza polecen, wystepujace zaraz za opcja lub rozdzielajac go od opcji znakiem rownosci, bez dodatkowych spacji. Argumenty opcjonalne mozna podawac tylko w ten ostatni sposob. Oto kilka mozliwosci zapisania polecenia przykladowego w tej skladni: tar --create --file etc.tar --verbose /etc lub (skracajac pewne opcje): tar --cre --file=etc.tar --verb /etc Mozna laczyc jednoczesne korzystanie ze wszystkich skladni, choc nie zaleca sie tego w przypadku starych opcji. Tryb operacji: Opcje z ponizszej tabeli przekazuja GNU tar rodzaj operacji, jaka ma wykonac. Nalezy podac dokladnie jedna. Znaczenie argumentow niebedacych opcjami, zalezy od zadanego trybu operacji. -A, --catenate, --concatenate Dolacza archiwa na koncu innego archiwum. Argumenty sa traktowane jako nazwy archiwow do przylaczenia. Wszystkie archiwa musza miec ten sam format jak archiwum, do ktorego nastepuje dolaczenie, w innym przypadku archiwum moze byc nieodczytywalne w innych implementacjach programu tar niz GNU. Prosze zauwazyc, ze gdy poda sie kilka archiwow, skladowe z archiwow innych niz pierwsze, beda dostepne w koncowym archiwum tylko wtedy, gdy uzyje sie opcji -i (--ignore-zeros). Nie mozna laczyc ze soba archiwow skompresowanych. -c, --create Tworzy nowe archiwum. Argumenty dostarczaja nazwy plikow do zarchiwizowania. Katalogi sa archiwizowane rekurencyjnie, chyba ze podano opcje --no-recursion. -d, --diff, --compare Znajduje roznice pomiedzy archiwum i systemem plikow. Argumenty sa opcjonalne i podaja skladowe archiwum do porownania. Jesli nie poda sie argumentu, przyjmowany jest biezacy katalog roboczy. --delete Usuwa z archiwum. Argumenty dostarczaja nazwy skladowe archiwum do usuniecia. Nalezy podac co najmniej jeden argument. Opcja nie dziala na archiwach skompresowanych. Jest dostepna tylko w skladni dlugich opcji. -r, --append Dolacza pliki na koncu archiwum. Argumenty maja takie samo znaczenie jak w opcji -c (--create). -t, --list Wypisuje zawartosc archiwum. Argumenty sa opcjonalne. Gdy wystepuja, okreslaja nazwy skladowych do wypisania. --test-label Sprawdza etykiete archiwum i wychodzi. Przy uzyciu bez argumentow, wypisuje etykiete archiwum (jesli wystepuje) i wychodzi ze statusem 0. Jesli poda sie jeden lub wiecej argumentow w wierszu polecenia, tar porownuje etykiete z kazdym argumentem. Wychodzi z kodem 0 jesli znajdzie dopasowanie lub z kodem 1 w przeciwnym przypadku. Nie jest wypisywane zadne wyjscie, chyba ze poda sie jednoczesnie opcje -v (--verbose). Nie wystepuje krotki odpowiednik tej opcji. -u, --update Dodaje pliki, ktore sa nowsze niz odpowiadajace im kopie w archiwum. Argumenty maja takie samo znaczenie, jak przy opcjach -c i -r. Prosze zauwazyc, ze nowsze pliki nie zastepuja swoich starszych kopii w archiwum, lecz sa dodawane na koncu archiwum. Z tego wzgledu wynikowe archiwum zawiera kilka skladowych o tej samej nazwie, odpowiadajacych roznym wersjom tego samego pliku. -x, --extract, --get Rozpakowuje pliki z archiwum. Argumenty sa opcjonalne. Gdy sie je poda, okreslaja nazwy skladowych archiwum do wypakowania. --show-defaults Pokazuje wbudowane wartosci domyslne roznych opcji tar i wychodzi. -?, --help Wyswietla krotkie podsumowanie opcji i konczy dzialanie. --usage Wyswietla liste dostepnych opcji i wychodzi. --version Wypisuje wersje programu oraz informacje o prawach autorskich i wychodzi. OPCJE Modyfikatory operacji --check-device Sprawdza numer urzadzenia przy tworzeniu archiwow przyrostowych (domyslnie). -g, --listed-incremental=PLIK Obsluguje nowy format GNU przyrostowych kopii zapasowych. PLIK jest nazwa pliku migawki, w ktorym tar przechowuje dodatkowe informacje uzywane do decydowania, ktore pliki ulegly zmianie od poprzedniej przyrostowej kopii i z tego wzgledu musza byc zrzucone ponownie. Jesli PLIK nie bedzie istnial przy tworzeniu archiwum, zostanie utworzony, a do wynikowego archiwum zostana dodane wszystkie pliki (zrzut poziomu 0). Aby utworzyc przyrostowe archiwa niezerowego poziomu N, konieczna jest kopia pliku migawki utworzonego dla poziomu N-1, ktory nalezy podac jako PLIK. Przy wypisywaniu oraz wypakowywaniu, faktyczna zawartosc PLIKU nie jest sprawdzana, jest on potrzebny tylko ze wzgledu na wymagania skladni. Z tego wzgledu czesto podaje sie w tym miejscu /dev/null. --hole-detection=METODA Uzywa METODY do wykrywania dziur w rzadkich plikach. Opcja wymusza --sparse. Prawidlowymi wartosciami METODY sa seek i raw. Domyslna jest seek, natomiast tam, gdzie nie ma zastosowania, korzysta sie z raw. -G, --incremental Obsluguje archiwum przyrostowe w starym formacie GNU. --ignore-failed-read Zakazuje konczenia dzialania programu z niezerowym kodem wyjscia po napotkaniu plikow, ktore nie daja sie odczytac. --level=LICZBA Ustawia poziom zrzutu dla tworzonego archiwum przyrostowego. Obecnie istotny jest tylko --level=0: wowczas tar przytnie plik migawki przed zrzutem, co wymusi utworzenie zrzutu poziomu 0. -n, --seek Zaklada, ze archiwum jest przeszukiwalne. Zwykle tar automatycznie okresla, czy archiwum da sie przeszukac, czy nie. Opcja ta jest przeznaczona do stosowania w przypadkach, gdy to wykrycie zawiedzie. Dziala tylko wtedy, gdy archiwum jest otwarte do odczytu (np. z opcjami --list lub --extract). --no-check-device Nie sprawdza numerow urzadzenia przy tworzeniu archiwow przyrostowych. --no-seek Zaklada, ze archiwum jest nieprzeszukiwalne. --occurrence[=N] Przetwarza tylko N-te wystapienie kazdego pliku w archiwum. Opcja ta jest prawidlowa tylko w polaczeniu z jednym z podpolecen: --delete, --diff, --extract lub --list i gdy lista plikow zostala podana albo w wierszu polecen albo opcja -T. Domyslnym N jest 1. --restrict Wylacza czesc potencjalnie szkodliwych opcji. --sparse-version=GLOWNY[.POBOCZNY] Ustawia, ktorej wersji formatu rzadkiego uzyc. Opcja wymusza --sparse. Prawidlowymi wartosciami sa 0.0, 0.1 i 1.0. Szczegolowy opis formatow rzadkich mozna znalezc w Podreczniku GNU Tar, aneksie D, rozdziale "Sparse Formats". Korzystajac z czytnika info mozna go wyswietlic poleceniem: info tar 'Sparse Formats'. -S, --sparse Wydajnie obsluguje pliki rzadkie. Niektore pliki w systemie plikow moga posiadac segmenty, ktore faktycznie nigdy nie byly zapisane (czesto zdarza sie tak z plikami baz danych tworzonymi w systemach takich jak DBM). Po podaniu tej opcji, tar postara sie ustalic czy plik jest rzadki zanim go zarchiwizuje, a jesli tak jest, zmniejszy wynikowy rozmiar archiwum tak, aby nie zrzucac pustych czesci pliku. Sterowanie zamazywaniem Opcje reguluja dzialanie tar przy wypakowywaniu plikow nad istniejaca kopia na dysku. -k, --keep-old-files Nie zastepuje istniejacych plikow podczas wypakowywania. --keep-newer-files Nie zastepuje istniejacych plikow, ktore sa nowsze niz egzemplarze w archiwum. --keep-directory-symlink Nie zastepuje istniejacych dowiazan symbolicznych przy wypakowywaniu. --no-overwrite-dir Zachowuje metadane istniejacych katalogow. --one-top-level[=KATALOG] Wypakowuje wszystkie pliki do KATALOGU lub, jesli nie poda sie argumentu, do podkatalogu nazwanego nazwa bazowa (basename) archiwum (po usunieciu z nazwy standardowych przyrostkow kompresji rozpoznawalnych przez --auto-compress). --overwrite Nadpisuje istniejace pliki podczas wypakowywania. --overwrite-dir Nadpisuje metadane istniejacych katalogow podczas wypakowywania (domyslne). --recursive-unlink Rekurencyjnie usuwa wszystkie pliki w katalogu przed wypakowaniem do niego. --remove-files Usuwa pliki z dysku po dodaniu ich do archiwum. --skip-old-files Nie zastepuje istniejacych plikow podczas wypakowywania, po chichu je pomija. -U, --unlink-first Usuwa kazdy plik przed wypakowaniem do niego. -W, --verify Weryfikuje archiwum po jego utworzeniu. Wybor strumienia wyjsciowego --ignore-command-error Ignoruje kody zakonczenia podprocesow. --no-ignore-command-error Traktuje niezerowe kody zakonczenia procesow potomnych jako blad (domyslne). -O, --to-stdout Wypakowuje pliki na standardowe wyjscie. --to-command=POLECENIE Przekazuje pliki potokiem do POLECENIA. Argument jest sciezka programu zewnetrznego, opcjonalnie z argumentami wiersza polecen. Program ten zostanie wywolany, a zawartosc wypakowywanego pliku przekazana mu na standardowe wejscie. Dodatkowe dane zostana przekazane przez nastepujace zmienne srodowiskowe: TAR_FILETYPE Typ pliku. Pojedyncza litera o nastepujacym znaczeniu. f Zwykly plik d Katalog l Dowiazanie symboliczne h Dowiazanie zwykle b Urzadzenie blokowe c Urzadzenie znakowe Obecnie obslugiwane sa tylko zwykle pliki. TAR_MODE Tryb pliku, liczba osemkowa. TAR_FILENAME Nazwa pliku. TAR_REALNAME Nazwa pliku, w postaci przechowywanej w archiwum. TAR_UNAME Nazwa wlasciciela pliku. TAR_GNAME Nazwa grupy posiadajacej plik. TAR_ATIME Czas ostatniego dostepu. Jest to liczba dziesietna, reprezentujace sekundy od Epoki. Jesli archiwum zapewnia nanosekundowa precyzje czasu, nanosekundy sa dolaczane do znacznika czasu po kropce dziesietnej. TAR_MTIME Czas ostatniej modyfikacji. TAR_CTIME Czas ostatniej zmiany statusu. TAR_SIZE Rozmiar pliku. TAR_UID Identyfikator uzytkownika wlasciciela pliku. TAR_GID Identyfikator grupy posiadajacej plik. Dodatkowo, ponizsze zmienne zawieraja informacje o trybie dzialania tar oraz o przetwarzanym archiwum: TAR_VERSION Numer wersji GNU tar. TAR_ARCHIVE Nazwa przetwarzanego przez tar archiwum. TAR_BLOCKING_FACTOR Biezaca liczba jednoczesnie przetwarzanych blokow ("blocking factor") tj. liczba 512-bajtowych blokow na rekord. TAR_VOLUME Kolejny numer przetwarzanej przez tar czesci archiwum (ustawione przy odczytywaniu archiwum wieloczesciowego). TAR_FORMAT Format przetwarzanego archiwum. Jeden z: gnu, oldgnu, posix, ustar, v7. TAR_SUBCOMMAND Krotka opcja (z poczatkowym dywizem) opisujaca aktualne dzialanie tar. Obsluga atrybutow plikow --atime-preserve[=METODA] Zachowuje czasy dostepu zrzucanych plikow, albo przez przywrocenie czasow po odczycie (METODA=replace, domyslnie), albo po prostu przez nieustawianie czasow (METODA=system) --delay-directory-restore Opoznia ustawianie czasow modyfikacji i opoznien rozpakowanych katalogow az do konca rozpakowywania. Z opcji tej nalezy korzystac, gdy archiwum ma nietypowa kolejnosc skladowych. --group=NAZWA[:ID-GRUPY] Wymusza NAZWE jako grupe dodanych plikow. Jesli nie poda sie ID-GRUPY, NAZWA moze byc nazwa uzytkownika lub numeryczny identyfikator grupy. W takim przypadku, brakujaca czesc (identyfikator grupy lub nazwa) zostana pobrane z bazy danych grup biezacej stacji. Przy lacznym stosowaniu z --group-map=PLIK, opcja ma wplyw tylko na pliki, ktorych grupy wlascicielskiej nie wypisano w PLIKU. --group-map=PLIK Odczytuje mape translacji grup z PLIKU. Puste wiersze sa ignorowane. Komentarze wprowadza znak #, koncza sie z koncem wiersza. Kazdy niepusty wiersz w PLIKU okresla tlumaczenie pojedynczej grupy. Musi skladac sie z dwoch pol, rozdzielonych dowolna liczba odstepow: STARA-GRUPA NOWA-GRUPA[:NOWY-ID-GRUPY] STARA-GRUPA jest albo prawidlowa nazwa grupy, albo identyfikatorem grupy poprzedzonym znakiem +. Jesli nie podano NOWEGO-ID-GRUPY, NOWA-GRUPA rowniez musi byc albo prawidlowa nazwa grupy, albo +ID-GRUPY. W innym przypadku, NOWA-GRUPA i NOWY-ID-GRUPY nie musza byc umieszczone w systemowej bazie danych grup Efektem koncowym jest sytuacja, gdzie kazdy plik wejsciowy z wlasnoscia grupy STARA-GRUPA zostanie przechowany w archiwum z wlasnoscia grupy NOWA-GRUPA i GID NOWY-ID-GRUPY. --mode=ZMIANY Wymusza ZMIANY trybu (symbolicznego) dodanych plikow. --mtime=DATA-lub-PLIK Ustawia czas modyfikacji (mtime) dodawanych plikow. DATA-lub-PLIK jest albo data/czasem w niemal dowolnym formacie, albo nazwa istniejacego pliku. W tym drugim przypadku zostanie uzyty czas modyfikacji podanego pliku. -m, --touch Nie dearchiwizuje czasu modyfikacji plikow. --no-delay-directory-restore Odwoluje dzialanie wczesniejszej opcji --delay-directory-restore. --no-same-owner Wypakowuje pliki jako uzytkownik uruchamiajacy program tar (domyslne dla zwyklych uzytkownikow). --no-same-permissions Stosuje umask uzytkownika przy wypakowywaniu uprawnien z archiwum (domyslne dla zwyklych uzytkownikow). --numeric-owner Posluguje sie numerami uzytkownikow i grup, zamiast ich nazw. --owner=NAZWA[:UID] Wymusza NAZWE jako wlasciciela dodanych plikow. Jesli nie poda sie ID-UZYTKOWNIKA, NAZWA moze byc nazwa uzytkownika lub numeryczny identyfikator uzytkownika. W takim przypadku, brakujaca czesc (identyfikator uzytkownika lub nazwa) zostana pobrane z bazy danych uzytkownikow biezacej stacji. Przy lacznym stosowaniu z --owner-map=PLIK, opcja ma wplyw tylko na pliki, ktorych wlasciciela nie wypisano w PLIKU. --owner-map=PLIK Odczytuje mape translacji uzytkownikow z PLIKU. Puste wiersze sa ignorowane. Komentarze wprowadza znak #, koncza sie z koncem wiersza. Kazdy niepusty wiersz w PLIKU okresla tlumaczenie pojedynczego uzytkownika. Musi skladac sie z dwoch pol, rozdzielonych dowolna liczba odstepow: STARY-UZYTKOWNIK NOWY-UZYTKOWNIK[:NOWY-ID-UZYTKOWNIKA] STARY-UZYTKOWNIK jest albo prawidlowa nazwa uzytkownika, albo identyfikatorem uzytkownika poprzedzonym znakiem +. Jesli nie podano NOWEGO-ID-UZYTKOWNIKA, NOWY-UZYTKOWNIK rowniez musi byc albo prawidlowa nazwa uzytkownika, albo +ID-UZYTKOWNIKA. W innym przypadku, NOWY-UZYTKOWNIK i NOWY-ID-UZYTKOWNIKA nie musza byc umieszczone w systemowej bazie danych uzytkownikow. Efektem koncowym jest sytuacja, gdzie kazdy plik wejsciowy z wlascicielem STARY-UZYTKOWNIK zostanie przechowany w archiwum z wlascicielem NOWY-UZYTKOWNIK i UID NOWY-ID-UZYTKOWNIKA. -p, --preserve-permissions, --same-permissions Ustawia uprawnienia wypakowanych plikow na zachowane w archiwum (domyslne dla superuzytkownika). --same-owner Probuje wypakowac pliki z tymi samymi wlascicielami jak w archiwum (domyslne dla superuzytkownika). -s, --preserve-order, --same-order Przekazuje tar, ze lista nazw plikow do przetworzenia jest posortowana w tej samej kolejnosci jak pliki w archiwum. --sort=KOLEJNOSC Przy tworzeniu archiwum, sortuje wpisy katalogow zgodnie z KOLEJNOSCIA, ktora moze byc none, name albo inode. Domyslnym ustawieniem jest --sort=none, przechowujace skladowe archiwum w tej samej kolejnosci, jaka zwroci system operacyjny. Opcja --sort=name zapewnia, ze kolejnosc w tworzonym archiwum jest jednolita i odtwarzalna. Opcja --sort=inode ogranicza liczbe przeszukiwan na dysku przy tworzeniu archiwum, co moze znacznie skrocic czas archiwizacji. Ta kolejnosc sortowania jest obslugiwana tylko wtedy, jesli dany system zapewnia wymagane informacje. Atrybuty rozszerzone plikow --acls Wlacza obsluge ACL POSIX. --no-acls Wylacza obsluge ACL POSIX. --selinux Wlacza obsluge kontekstu SELinux. --no-selinux Wylacza obsluge kontekstu SELinux. --xattrs Wlacza obsluge atrybutow rozszerzonych. --no-xattrs Wylacza obsluge atrybutow rozszerzonych. --xattrs-exclude=WZORZEC Okresla wzorzec wylaczenia kluczy atrybutow rozszerzonych. We WZORCU mozna korzystac tylko z wieloznacznikow (wzorzec typu glob) np. --xattrs-exclude='user.*' obejmie atrybuty tylko z przestrzeni nazw uzytkownika. --xattrs-include=WZORZEC Okresla wzorzec wlaczenia kluczy atrybutow rozszerzonych. We WZORCU mozna korzystac tylko z wieloznacznikow (wzorzec typu glob). Wybor i przelaczanie miedzy urzadzeniami -f, --file=ARCHIWUM Uzywa urzadzenia lub pliku archiwum ARCHIWUM. Jesli nie poda sie tej opcji, tar na poczatku sprawdzi wartosc zmiennej srodowiskowej "TAPE". Jesli bedzie ustawiona, jej wartosc zostanie uzyta jako nazwa archiwum. W przeciwnym przypadku, tar przyjmie wbudowana wartosc domyslna. Mozna ja sprawdzic opcja --show-defaults, zostanie rowniez wypisana na koncu wyniku polecenia tar --help. Nazwa archiwum posiadajaca dwukropek okresla plik lub urzadzenie na stacji zdalnej. Czesc przed dwukropkiem stanowi nazwe lub adres IP stacji, a czesc po dwukropku jest sciezka pliku lub urzadzenia np.: --file=remotehost:/dev/sr0 Przed nazwa stacji mozna podac opcjonalna nazwe uzytkownika, rozdzielajac je znakiem @. Domyslnie, dostep do zdalnej stacji nastepuje poprzez polecenie rsh(1). Obecnie czesto korzysta sie w zamian z ssh(1). Mozna to uczynic za pomoca nastepujacej opcji wiersza polecenia: --rsh-command=/usr/bin/ssh Zdalna stacja powinna miec zainstalowane polecenie rmt(8). Jesli jego sciezka nie jest taka jak domyslna wartosc tar, mozna przekazac programowi tar prawidlowa sciezke opcja --rmt-command. --force-local Plik z archiwum jest lokalny nawet, jezeli w jego nazwie wystepuje dwukropek. -F, --info-script=POLECENIE, --new-volume-script=POLECENIE Uruchamia COMMAND po osiagnieciu konca kazdej tasmy (wymusza -M). Polecenie moze miec argumenty. Przy uruchomieniu, odziedziczy ono srodowisko tar oraz nastepujace zmienne: TAR_VERSION Numer wersji GNU tar. TAR_ARCHIVE Nazwa przetwarzanego przez tar archiwum. TAR_BLOCKING_FACTOR Biezaca liczba jednoczesnie przetwarzanych blokow ("blocking factor") tj. liczba 512-bajtowych blokow na rekord. TAR_VOLUME Kolejny numer przetwarzanej przez tar czesci archiwum (ustawione przy odczytywaniu archiwum wieloczesciowego). TAR_FORMAT Format przetwarzanego archiwum. Jeden z: gnu, oldgnu, posix, ustar, v7. TAR_SUBCOMMAND Krotka opcja (z poczatkowym dywizem) opisujaca aktualne dzialanie tar. TAR_FD Deskryptor pliku, ktory moze sluzyc do przekazania nowej nazwy czesci archiwum programowi tar. Jesli info-script zawiedzie, tar wyjdzie; w przeciwnym przypadku zacznie zapisywac nastepna czesc archiwum. -L, --tape-length=N Zmienia tasme po zapisaniu Nx1024 bajtow. Jesli po N poda sie przyrostek oznaczajacy rozmiar (zob. rozdzial Przyrostki oznaczajace rozmiar ponizej), przyrostek okresla mnoznik zamiast 1024. Opcja wymusza -M. -M, --multi-volume Tworzy/wypisuje zawartosc/wypakowuje archiwum wieloczesciowe. --rmt-command=POLECENIE Uzywa POLECENIA zamiast rmt przy uzyskiwaniu dostepu do archiwow zdalnych. Zob. opis opcji -f, powyzej. --rsh-command=POLECENIE Uzywa POLECENIA zamiast rsh przy uzyskiwaniu dostepu do archiwow zdalnych. Zob. opis opcji -f, powyzej. --volno-file=PLIK Przy lacznym stosowaniu z --multi-volume, tar bedzie pilnowal tego, nad ktora czescia archiwum wieloczesciowego w PLIKU pracuje program. Parametry blokow -b, --blocking-factor=BLOKI Ustawia rozmiar rekordu na BLOKIx512 bajtow. -B, --read-full-records Przy wypisywaniu lub wypakowywaniu, akceptuje niepelne rekordy wejsciowe po znaczniku konca pliku. -i, --ignore-zeros Ignoruje wyzerowane bloki w archiwum. Zwykle dwa kolejne 512 bloki wypelnione zerami oznaczaja koniec pliku i tar zatrzymuje odczyt po ich napotkaniu. Opcja instruuje program, aby odczytywal dalej i jest przydatna przy archiwach utworzonych z opcja -A. --record-size=LICZBA Ustawia rozmiar rekordu. LICZBA jest liczba bajtow na rekord. Musi byc wielokrotnoscia 512. Mozna uzyc po niej przyrostka oznaczajacego rozmiar np. --record-size=10K oznacza 10 kilobajtow. Zob. podrozdzial Przyrostki oznaczajace rozmiar, aby zapoznac sie z lista prawidlowych przyrostkow. Wybor formatu archiwum -H, --format=FORMAT Tworzy archiwum w podanym formacie. Prawidlowe formaty to: gnu Format GNU tar 1.13.x. oldgnu Format GNU w programie tar <= 1.12. pax, posix Format POSIX 1003.1-2001 (pax). ustar Format POSIX 1003.1-1988 (ustar). v7 Stary format tar V7. --old-archive, --portability Rownowazne as --format=v7. --pax-option=keyword[[:]=wartosc][,keyword[[:]=wartosc]]... Kontroluje slowa kluczowe pax przy tworzeniu archiwow PAX (-H pax). Opcja odpowiada opcji -o narzedzia pax(1). --posix Rownowazne --format=posix. -V, --label=TEKST Tworzy archiwum z nazwa czesci TEKST. Przy wypisywaniu/rozpakowywaniu uzywa TEKSTU jako wzorca maski do nazwy czesci. Opcje kompresji -a, --auto-compress Uzywa przyrostka archiwum do okreslenia programu kompresujacego. -I, --use-compress-program=POLECENIE Filtruje dane poprzez POLECENIE. Musi ono akceptowac opcje -d sluzaca do rozpakowywania. Argument moze posiadac opcje wiersza polecen. -j, --bzip2 Filtruje archiwum programem bzip2(1). -J, --xz Filtruje archiwum programem xz(1). --lzip Filtruje archiwum programem lzip(1). --lzma Filtruje archiwum programem lzma(1). --lzop Filtruje archiwum programem lzop(1). --no-auto-compress Nie uzywa przyrostka archiwum do okreslenia programu kompresujacego. -z, --gzip, --gunzip, --ungzip Filtruje archiwum programem gzip(1). -Z, --compress, --uncompress Filtruje archiwum programem compress(1). --zstd Filtruje archiwum programem zstd(1). Wybor lokalnego pliku --add-file=PLIK Dodaje PLIK do archiwum (przydatne jesli nazwa zaczyna sie minusem). --backup[=METODA] Wykonuje kopie zapasowa przed usunieciem. Argument METODA, jesli sie go poda, reguluje sposob dokonywania kopii. Jego prawidlowe wartosci to: none, off Nigdy nie tworzy kopii zapasowych. t, numbered Tworzy kopie numerowane. nil, existing Tworzy kopie numerowane, jesli takie juz istnieja, w innym przypadku tworzy kopie proste. never, simple Zawsze tworzy proste kopie zapasowe. Jesli nie poda sie METODY, wartosc jest pobierana ze zmiennej srodowiskowej VERSION_CONTROL. Jesli nie jest ustawiona, przyjmowana jest wartosc existing. -C, --directory=KATALOG Przechodzi do KATALOGU przed dokonywaniem jakichkolwiek dzialan. Opcja jest zalezna od kolejnosci tj. wplywa na wszystkie opcje za nia. --exclude=WZORZEC Wylacza pliki pasujace do WZORCA, ktory jest wieloznacznikiem w stylu glob(3). --exclude-backups Wylacza pliki kopii zapasowej i blokady. --exclude-caches Wylacza zawartosc katalogow zawierajacych CACHEDIR.TAG, z wylaczeniem samego pliku tag. --exclude-caches-all Wylacza katalogi zawierajace CACHEDIR.TAG i sam ten plik. --exclude-caches-under Wylacza wszystko w katalogach zawierajacych CACHEDIR.TAG --exclude-ignore=PLIK Przed zrzuceniem katalogu sprawdza, czy zawiera on PLIK. Jesli plik wystepuje, odczytuje z niego wzorce wykluczajace. Wzorce maja wplyw tylko na katalog pliku. --exclude-ignore-recursive=PLIK Jak --exclude-ignore, tyle ze wzorce z PLIKU maja wplyw na jego katalog wraz z wszystkimi podkatalogami. --exclude-tag=PLIK Wylacza zawartosc katalogow zawierajacych PLIK, z wyjatkiem samego PLIKU. --exclude-tag-all=PLIK Wylacza katalogi zawierajace PLIK. --exclude-tag-under=PLIK Wylacza wszystko w katalogach zawierajacych PLIK. --exclude-vcs Wylacza katalogi systemu kontroli wersji. --exclude-vcs-ignores Wylacza pliki pasujace do wzorcow odczytanych z zaleznych od systemu kontroli wersji plikow ignorowania. Obslugiwane sa pliki: .cvsignore, .gitignore, .bzrignore i .hgignore. -h, --dereference Podaza za dowiazaniami symbolicznymi; archiwizuje pliki, na ktore one wskazuja. --hard-dereference Podaza za dowiazaniami zwyklymi (twardymi); archiwizuje i zrzuca pliki do ktorych sie one odnosza. -K, --starting-file=SKLADOWA Zaczyna od podanej skladowej archiwum. --newer-mtime=DATA Pracuje na plikach, ktorych data ulegla zmianie po podanej DACIE. Jesli DATA zaczyna sie od / lub . uznaje sie ja za nazwe pliku; wowczas rozwazana jest data modyfikacji tego pliku (mtime). --no-null Odwoluje dzialanie opcji --null. --no-recursion Zapobiega automatycznemu zaglebianiu sie w katalogi. --no-unquote Nie usuwa znakow cytowania z plikow wejsciowych lub nazw skladowych. --no-verbatim-files-from Traktuje kazdy wiersz odczytany z listy plikow, jak gdyby byl podany w wierszu polecenia. Oznacza to, ze poczatkowe i koncowe odstepy sa usuwane, a jesli powstaly w ten sposob lancuch zaczyna sie od kreski, jest traktowany jako opcja wiersza polecenia tar. Jest to zachowanie domyslne. Opcja --no-verbatim-files-from sluzy do przywrocenia tego zachowania po podaniu opcji --verbatim-files-from. Jest to opcja pozycyjna: ma wplyw na wszystkie opcje --files-from, ktore zostana podane po niej, do momentu napotkania opcji --verbatim-files-from lub osiagniecia konca wiersza, w zaleznosci od tego co nastapi wczesniej. Jest wymuszona przez opcje --no-null. --null Nakazuje kolejnym opcjom -T na doslowny odczyt nazw rozdzielonych znakiem null (wylacza specjalna obsluge nazw rozpoczynajacych sie od kreski). Zob. tez --verbatim-files-from. -N, --newer=DATA, --after-date=DATA Przechowuje tylko pliki nowsze od DATY. Jesli DATA zaczyna sie od / lub . uznaje sie ja za nazwe pliku; wowczas rozwazana jest data modyfikacji tego pliku (mtime). --one-file-system Archiwizuje pliki tylko z biezacego systemu plikow. -P, --absolute-names Przy tworzeniu archiwow, nie usuwa z nazw plikow poczatkowych ukosnikow. --recursion Obsluguje katalogi rekurencyjnie (domyslnie). --suffix=LANCUCH Przed usunieciem wykonuje kopie zapasowa, przeslaniajac zwykly przyrostek. Domyslnym przyrostkiem jest ~, chyba ze zostal przesloniety przez zmienna srodowiskowa SIMPLE_BACKUP_SUFFIX. -T, --files-from=PLIK Nazwy plikow do rozpakowania lub archiwizacji sa pobierane z PLIKU. O ile nie okresli sie inaczej, PLIK musi zawierac liste nazw rozdzielonych znakiem LF ASCII (tj. po jednej nazwie na wiersz). Odczytywane nazwy sa traktowane w ten sam sposob jak argumenty w wierszu polecenia. Usuwane sa cudzyslowy i dokonywany jest podzial na slowa, a kazdy lancuch rozpoczynajacy sie od znaku - jest traktowany jako opcja wiersza polecenia tar. Jesli takie zachowanie jest niepozadane, mozna je wylaczyc opcja --verbatim-files-from. Opcja --null informuje tar, ze nazwy w PLIKU sa rozdzielone znakiem NUL ASCII, a nie znakiem LF. Przydatne, gdy liste wygenerowano wskazaniem -print0 programu find(1). --unquote Usuwa znaki cytowania z plikow wejsciowych lub nazw skladowych (domyslne). --verbatim-files-from Traktuje kazdy wiersz pozyskany z listy plikow jako nazwe pliku nawet, jesli zaczyna sie od kreski. Listy plikow podaje sie opcja --files-from (-T). Domyslnym zachowaniem jest traktowanie nazw podanych w liscie plikow jak gdyby byly wpisane w wierszu polecenia tj. nazwy rozpoczynajace sie od kreski sa przyjmowane jako opcje tar. Opcja --verbatim-files-from wylacza to zachowanie. Opcja wplywa na wszystkie opcje --files-from, ktore zostana podane po niej w wierszu polecenia. Jej efekt mozna odwrocic opcja --no-verbatim-files-from. Opcja jest wymuszona przez opcje --null. Zob. tez --add-file. -X, --exclude-from=PLIK Wylacza pliki o nazwach wymienionych w PLIKU. Przeksztalcenia nazwy plikow --strip-components=LICZBA Usuwa LICZBE poczatkowych czesci z nazw plikow podczas wypakowania. --transform=WYRAZENIE, --xform=WYRAZENIE Uzywa WYRAZENIA zamieniajacego programu sed do przetworzenia nazw plikow. Opcje dopasowujace nazwy plikow Opcje wplywaja na wzorce wlaczania i wylaczania. --anchored Wzorzec dopasowuje poczatek nazwy pliku. --ignore-case Ignoruje wielkosc znakow. --no-anchored Wzorzec dopasowuje po dowolnym / (domyslne przy wylaczeniu). --no-ignore-case Dopasowanie zwracajace uwage na wielkosc znakow (domyslne). --no-wildcards Doslowne dopasowanie lancuchow. --no-wildcards-match-slash Wieloznacznik nie dopasowuje /. --wildcards Uzywa wieloznacznika (domyslne przy wylaczeniach). --wildcards-match-slash Wieloznacznik dopasowuje / (domyslne przy wylaczeniach). Wyjscie informacyjne --checkpoint[=LICZBA] Wyswietla informacje o postepie co LICZBA rekord (domyslnie 10). --checkpoint-action=AKCJA Wykonuje AKCJE po kazdym checkpoincie. --clamp-mtime Ustawia czas tylko, jesli plik jest nowszy niz to, co podano opcja --mtime. --full-time Wypisuje czas pliku do jego pelnej rozdzielczosci. --index-file=PLIK Wypisuje szczegolowe informacje do PLIKU. -l, --check-links Wypisuje komunikat, jesli nie wszystkie dowiazania sa zrzucone. --no-quote-chars=LANCUCH Wylacza dodatkowe znaki cytowania do LANCUCHA. --quote-chars=LANCUCH Dodatkowe znaki cytowania do LANCUCHA. --quoting-style=STYL Ustawia styl cytowania plikow i nazw skladowych. Prawidlowe wartosci STYLU to: literal, shell, shell-always, c, c-maybe, escape, locale, clocale. -R, --block-number Wypisuje numer rekordu wewnatrz archiwum przy kazdym komunikacie. --show-omitted-dirs Podczas wypisywania lub wypakowywania, wypisuje kazdy katalog niepasujacy do kryteriow wyszukiwania. --show-transformed-names, --show-stored-names Pokazuje nazwy pliku lub archiwum po przeksztalceniu opcjami --strip i --transform. --totals[=SYGNAL] Wypisuje sume bajtow po przetworzeniu archiwum. Jesli poda sie SYGNAL, wypisuje sume bajtow w momencie jego otrzymania. Dozwolone sygnaly to: SIGHUP, SIGQUIT, SIGINT, SIGUSR1 i SIGUSR2. W nazwach sygnalow mozna pominac przedrostek SIG. --utc Wypisuje czasy modyfikacji pliku w UTC. -v, --verbose Szczegolowo wypisuje przetwarzane pliki. Kazde wystapienie tej opcji w wierszu polecenia zwieksza poziom szczegolowosci o jeden. Maksymalny wynosi 3. Dokladny opis wplywu roznych poziomow szczegolowosci na wyjscie programu tar opisano w Podreczniku GNU Tar, w podrozdziale 2.5.2 "The '--verbose' Option". --warning=SLOWO-KLUCZOWE Wlacza lub wylacza ostrzezenia identyfikowane SLOWEM-KLUCZOWYM. Komunikaty sa wylaczane, jesli SLOWO-KLUCZOWE poprzedzi sie przedrostkiem no- i wlaczane w przeciwnym przypadku. Opcje --warning podane wielokrotnie lacza sie. Slowa kluczowe kontrolujace ogolne dzialanie tar: all Wlacza wszystkie ostrzezenia. Tak jest domyslnie. none Wylacza wszystkie ostrzezenia. filename-with-nuls "%s: przeczytana nazwa pliku zawiera znak NUL" alone-zero-block "Samotny blok zerowy przy %s" Slowa kluczowe wlasciwe poleceniu tar --create: cachedir ""%s: zawiera znacznik katalogu pamieci podrecznej %s; %s" file-shrank "%s: Plik skurczyl sie o %s bajtow; jest dopelniany zerami" xdev "%s: plik w innym systemie plikow; nie zostal zapisany" file-ignored "%s: Nieznany typ pliku; plik zignorowany" "%s: zignorowane gniazdo z nazwa" "%s: zignorowany plik door" file-unchanged "%s: plik jest niezmieniony; nie zostal zapisany" ignore-archive "%s: archiwum nie moze zawierac samego siebie; nie zostalo zapisane" file-removed "%s: Plik usuniety zanim zostal przeczytany" file-changed "%s: plik zmienil sie w trakcie czytania" failed-read Wylacza ostrzezenia o nieodczytywalnych plikach lub katalogach. To slowo kluczowe dziala tylko lacznie z opcja --ignore-failed-read. Slowa kluczowe wlasciwe poleceniu tar --extract: existing-file "%s: pominiecie istniejacego pliku" timestamp "%s: niemozliwie stara data %s" "%s: znacznik czasowy %s jest przesuniety o %s s w przyszlosc" contiguous-cast "Wypakowywanie ciaglych plikow jako zwyklych plikow" symlink-cast "Proba wypakowania dowiazan symbolicznych jako dowiazan zwyklych" unknown-cast "%s: Nieznany typ pliku ,,%c", odtworzony jako plik zwykly" ignore-newer "Aktualny %s jest nowszy albo w tym samym wieku" unknown-keyword "Zignorowane nieznane slowo kluczowe naglowka rozszerzonego ,,%s"" decompress-program Kontroluje szczegolowe opisy niepowodzen przy probie uruchomienia alternatywnych programow rozpakowujacych. To ostrzezenie jest domyslnie wylaczone (chyba, ze podano --verbose). Popularnym przykladem tego, co mozna otrzymac za pomoca tego ostrzezenia jest: $ tar --warning=decompress-program -x -f archive.Z tar (child): Nie mozna uruchomic compress: Nie ma takiego pliku ani katalogu tar (child): probuje gzip Oznacza to, ze tar pierwotnie sprobowal rozpakowac archive.Z za pomoca compress, a gdy to sie nie powiodlo, przelaczyc sie na gzip. record-size "Rozmiar rekordu = %lu blokow" Slowa kluczowe kontrolujace wypakowanie przyrostowe: rename-directory "%s: Nazwa katalogu zostala zmieniona z %s" "%s: Nazwa katalogu zostala zmieniona" new-directory "%s: Katalog jest nowy" xdev "%s: katalog na innym urzadzeniu: bez skasowania" bad-dumpdir "Zly format katalogu zrzutow: nigdy nie uzyte ,,X"" -w, --interactive, --confirmation Pyta o zgode na kazde dzialanie. Opcje kompatybilnosci -o Przy tworzeniu, odpowiednik --old-archive. Przy wypakowywaniu, odpowiednik --no-same-owner. Przyrostki oznaczajace rozmiar Przyr. Jednostki Liczba bajtow b Bloki ROZMIAR x 512 B Kilobajty ROZMIAR x 1024 c Bajty ROZMIAR G Gigabajty ROZMIAR x 1024^3 K Kilobajty ROZMIAR x 1024 k Kilobajty ROZMIAR x 1024 M Megabajty ROZMIAR x 1024^2 P Petabajty ROZMIAR x 1024^5 T Terabajty ROZMIAR x 1024^4 w Slowa ROZMIAR x 2 WARTOSC ZWRACANA Kod zakonczenia programu tar wskazuje, czy udalo mu sie pomyslnie zakonczyc nakazane dzialanie, a jesli nie, jakiego typu blad wystapil. 0 Prawidlowe zakonczenie. 1 Jakies pliki roznia sie. Jesli wywolano tar z opcja wiersza polecenia --compare (--diff, -d) oznacza to, ze niektore pliki w archiwum roznia sie od ich odpowiednikow na dysku. Jesli tar podano opcje --create, --append lub --update, ten kod zakonczenia oznacza, ze niektore pliki zostaly zmienione przy archiwizacji, zatem wynikowe archiwum nie zawiera dokladnej kopii zestawu plikow. 2 Blad krytyczny. Oznacza wystapienie jakiegos nieodwracalnego bledu krytycznego. Jesli podproces wywolany przez tar wyszedl z niezerowym kodem wyjscia, tar rowniez wyjdzie z tym kodem. Moze sie to zdarzyc gdy, na przyklad, podano opcje kompresowania (np. -z), a zewnetrzny program kompresujacy zawiodl. Inny przykladem jest niepowodzenie programu rmt przy tworzeniu kopii zapasowej na zdalnym urzadzeniu. ZOBACZ TAKZE bzip2(1), compress(1), gzip(1), lzma(1), lzop(1), rmt(8), symlink(7), xz(1), zstd(1). Pelny podrecznik tar: uruchomi go polecenie info tar lub tryb info edytora emacs(1). Kopie dokumentacji GNU tar w roznych formatach mozna znalezc pod adresem: https://www.gnu.org/software/tar/manual ZGLOSZENIA BLEDOW Raporty o bledach mozna wysylac na adres . PRAWA AUTORSKIE Copyright (C) 2023 Free Software Foundation, Inc. Licencja GPLv3+: GNU GPL w wersji 3 lub pozniejszej . Jest to wolne oprogramowanie: mozna je zmieniac i rozpowszechniac. Nie ma ZADNEJ GWARANCJI, w granicach okreslonych przez prawo. TLUMACZENIE Tlumaczenie niniejszej strony podrecznika: Lukasz Kowalczyk , Andrzej Krzysztofowicz , Michal Kulach i Kuba Basiura Niniejsze tlumaczenie jest wolna dokumentacja. Blizsze informacje o warunkach licencji mozna uzyskac zapoznajac sie z GNU General Public License w wersji 3 lub nowszej. Nie przyjmuje sie ZADNEJ ODPOWIEDZIALNOSCI. Bledy w tlumaczeniu strony podrecznika prosimy zglaszac na adres listy dyskusyjnej . TAR 11 lipca 2022 r. TAR(1)