Składnia tradycyjna¶

tar {A|c|d|r|t|u|x}[GnSkUWOmpsMBiajJzZhPlRvwo] [ARG...]

Składnia uniksowa¶

tar -A [OPTIONS] ARCHIVE ARCHIVE

tar -c [-f ARCHIWUM] [OPCJE] [PLIK...]

tar -d [-f ARCHIWUM] [OPCJE] [PLIK...]

tar -t [-f ARCHIWUM] [OPCJE] [SKŁADOWA...]

tar -r [-f ARCHIWUM] [OPCJE] [PLIK...]

tar -u [-f ARCHIWUM] [OPCJE] [PLIK...]

tar -x [-f ARCHIWUM] [OPCJE] [SKŁADOWA...]

Składnia GNU¶

tar {--catenate|--concatenate} [OPTIONS] ARCHIVE ARCHIVE

tar --create [--file ARCHIWUM] [OPCJE] [PLIK...]

tar {--diff|--compare} [--file ARCHIWUM] [OPCJE] [PLIK...]

tar --delete [--file ARCHIWUM] [OPCJE] [SKŁADOWA...]

tar --append [-f ARCHIVE] [OPTIONS] [FILE...]

tar --list [-f ARCHIVE] [OPTIONS] [MEMBER...]

tar --test-label [--file ARCHIWUM] [OPCJE] [ETYKIETA...]

tar --update [--file ARCHIWUM] [OPCJE] [PLIK...]

tar --update [-f ARCHIVE] [OPTIONS] [FILE...]

tar {--extract|--get} [-f ARCHIVE] [OPTIONS] [MEMBER...]

Style składni opcji¶

Options to GNU tar can be given in three different styles. In traditional style, the first argument is a cluster of option letters and all subsequent arguments supply arguments to those options that require them. The arguments are read in the same order as the option letters. Any command line words that remain after all options has been processed are treated as non-optional arguments: file or archive member names.

For example, the c option requires creating the archive, the v option requests the verbose operation, and the f option takes an argument that sets the name of the archive to operate upon. The following command, written in the traditional style, instructs tar to store all files from the directory /etc into the archive file etc.tar verbosely listing the files being archived:

tar cfv etc.tar /etc

In UNIX or short-option style, each option letter is prefixed with a single dash, as in other command line utilities. If an option takes argument, the argument follows it, either as a separate command line word, or immediately following the option. However, if the option takes an optional argument, the argument must follow the option letter without any intervening whitespace, as in -g/tmp/snar.db.

Any number of options not taking arguments can be clustered together after a single dash, e.g. -vkp. Options that take arguments (whether mandatory or optional), can appear at the end of such a cluster, e.g. -vkpf a.tar.

Przykład podany wyżej, wyglądałby następująco w składni z krótkimi opcjami:

tar -cvf etc.tar /etc

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

E składni GNU lub składni z długimi opcjami, każda opcja zaczyna się od dwóch kresek i ma znaczącą nazwę, składającą się z małych liter i kresek. Długą opcję można skrócić do początkowych liter, o ile dany skrót nie będzie wieloznaczny. Argumenty do długich opcji podaje się albo jako osobne słowa wiersza poleceń, występujące zaraz za opcją lub rozdzielając go od opcji znakiem równości, bez dodatkowych spacji. Argumenty opcjonalne można podawać tylko w ten ostatni sposób.

Oto kilka możliwości zapisania polecenia przykładowego w tej składni:

tar --create --file etc.tar --verbose /etc

tar --cre --file=etc.tar --verb /etc

Można łączyć jednoczesne korzystanie ze wszystkich składni, choć nie zaleca się tego w przypadku starych opcji.

Tryb operacji:¶

The options listed in the table below tell GNU tar what operation it is to perform. Exactly one of them must be given. Meaning of non-optional arguments depends on the operation mode requested.

-A, --catenate, --concatenate

Append archive to the end of another archive. The arguments are treated as the names of archives to append. All archives must be of the same format as the archive they are appended to, otherwise the resulting archive might be unusable with non-GNU implementations of tar. Notice also that when more than one archive is given, the members from archives other than the first one will be accessible in the resulting archive only if using the -i (--ignore-zeros) option.

Nie można łączyć ze sobą archiwów skompresowanych.

-c, --create

Tworzy nowe archiwum. Argumenty dostarczają nazwy plików do zarchiwizowania. Katalogi są archiwizowane rekurencyjnie, chyba że podano opcję --no-recursion.

-d, --diff, --compare

Znajduje różnice pomiędzy archiwum i systemem plików. Argumenty są opcjonalne i podają składowe archiwum do porównania. Jeśli nie poda się argumentu, przyjmowany jest bieżący katalog roboczy.

--delete

Usuwa z archiwum. Argumenty dostarczają nazwy składowe archiwum do usunięcia. Należy podać co najmniej jeden argument.

Opcja nie działa na archiwach skompresowanych. Jest dostępna tylko w składni długich opcji.

-r, --append

Dołącza pliki na końcu archiwum. Argumenty mają takie samo znaczenie jak w opcji -c (--create).

-t, --list

Wypisuje zawartość archiwum. Argumenty są opcjonalne. Gdy występują, określają nazwy składowych do wypisania.

--test-label

Sprawdza etykietę archiwum i wychodzi. Przy użyciu bez argumentów, wypisuje etykietę archiwum (jeśli występuje) i wychodzi ze statusem 0. Jeśli poda się jeden lub więcej argumentów w wierszu polecenia, tar porównuje etykietę z każdym argumentem. Wychodzi z kodem 0 jeśli znajdzie dopasowanie lub z kodem 1 w przeciwnym przypadku. Nie jest wypisywane żadne wyjście, chyba że poda się jednocześnie opcję -v (--verbose).

Nie występuje krótki odpowiednik tej opcji.

-u, --update

Append files which are newer than the corresponding copy in the archive. Arguments have the same meaning as with -c and -r options. Notice, that newer files don't replace their old archive copies, but instead are appended to the end of archive. The resulting archive can thus contain several members of the same name, corresponding to various versions of the same file.

-x, --extract, --get

Rozpakowuje pliki z archiwum. Argumenty są opcjonalne. Gdy się je poda, określają nazwy składowych archiwum do wypakowania.

--show-defaults

Show built-in defaults for various tar options and exit. No arguments are allowed.

-?, --help

Display a short option summary and exit. No arguments allowed.

--usage

Display a list of available options and exit. No arguments allowed.

--version

Wypisuje wersję programu oraz informacje o prawach autorskich i wychodzi.

Modyfikatory operacji¶

--check-device

Sprawdza numer urządzenia przy tworzeniu archiwów przyrostowych (domyślnie).

-g, --listed-incremental=PLIK

Handle new GNU-format incremental backups. FILE is the name of a snapshot file, where tar stores additional information which is used to decide which files changed since the previous incremental dump and, consequently, must be dumped again. If FILE does not exist when creating an archive, it will be created and all files will be added to the resulting archive (the level 0 dump). To create incremental archives of non-zero level N, create a copy of the snapshot file created during the level N-1, and use it as FILE.

When listing or extracting, the actual contents of FILE is not inspected, it is needed only due to syntactical requirements. It is therefore common practice to use /dev/null in its place.

--hole-detection=METODA

Używa METODY do wykrywania dziur w rzadkich plikach. Opcja wymusza --sparse. Prawidłowymi wartościami METODY są seek i raw. Domyślną jest seek, natomiast tam, gdzie nie ma zastosowania, korzysta się z raw.

-G, --incremental

Obsługuje archiwum przyrostowe w starym formacie GNU.

--ignore-failed-read

Zakazuje kończenia działania programu z niezerowym kodem wyjścia po napotkaniu plików, które nie dają się odczytać.

--level=LICZBA

Set dump level for created listed-incremental archive. Currently only --level=0 is meaningful: it instructs tar to truncate the snapshot file before dumping, thereby forcing a level 0 dump.

-n, --seek

Zakłada, że archiwum jest przeszukiwalne. Zwykle tar automatycznie określa, czy archiwum da się przeszukać, czy nie. Opcja ta jest przeznaczona do stosowania w przypadkach, gdy to wykrycie zawiedzie. Działa tylko wtedy, gdy archiwum jest otwarte do odczytu (np. z opcjami --list lub --extract).

--no-check-device

Nie sprawdza numerów urządzenia przy tworzeniu archiwów przyrostowych.

--no-seek

Zakłada, że archiwum jest nieprzeszukiwalne.

--occurrence[=N]

Przetwarza tylko N-te wystąpienie każdego pliku w archiwum. Opcja ta jest prawidłowa tylko w połączeniu z jednym z podpoleceń: --delete, --diff, --extract lub --list i gdy lista plików została podana albo w wierszu poleceń albo opcją -T. Domyślnym N jest 1.

--restrict

Wyłącza część potencjalnie szkodliwych opcji.

--sparse-version=GŁÓWNY[.POBOCZNY]

Set version of the sparse format to use (implies --sparse). This option implies --sparse. Valid argument values are 0.0, 0.1, and 1.0. For a detailed discussion of sparse formats, refer to the GNU Tar Manual, appendix D, "Sparse Formats". Using info reader, it can be accessed running the following command: info tar 'Sparse Formats'.

-S, --sparse

Wydajnie obsługuje pliki rzadkie. Niektóre pliki w systemie plików mogą posiadać segmenty, które faktycznie nigdy nie były zapisane (często zdarza się tak z plikami baz danych tworzonymi w systemach takich jak DBM). Po podaniu tej opcji, tar postara się ustalić czy plik jest rzadki zanim go zarchiwizuje, a jeśli tak jest, zmniejszy wynikowy rozmiar archiwum tak, aby nie zrzucać pustych części pliku.

Sterowanie zamazywaniem¶

Opcje regulują działanie tar przy wypakowywaniu plików nad istniejącą kopią na dysku.

-k, --keep-old-files

Nie zastępuje istniejących plików podczas wypakowywania.

--keep-newer-files

Nie zastępuje istniejących plików, które są nowsze niż egzemplarze w archiwum.

--keep-directory-symlink

Nie zastępuje istniejących dowiązań symbolicznych przy wypakowywaniu.

--no-overwrite-dir

Zachowuje metadane istniejących katalogów.

--one-top-level[=KATALOG]

Wypakowuje wszystkie pliki do KATALOGU lub, jeśli nie poda się argumentu, do podkatalogu nazwanego nazwą bazową (basename) archiwum (po usunięciu z nazwy standardowych przyrostków kompresji rozpoznawalnych przez --auto-compress).

--overwrite

Nadpisuje istniejące pliki podczas wypakowywania.

--overwrite-dir

Nadpisuje metadane istniejących katalogów podczas wypakowywania (domyślne).

--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 zastępuje istniejących plików podczas wypakowywania, po chichu je pomija.

-U, --unlink-first

Usuwa każdy plik przed wypakowaniem do niego.

-W, --verify

Weryfikuje archiwum po jego utworzeniu.

Wybór strumienia wyjściowego¶

--ignore-command-error

Ignoruje kody zakończenia podprocesów.

--no-ignore-command-error

Traktuje niezerowe kody zakończenia procesów potomnych jako błąd (domyślne).

-O, --to-stdout

Wypakowuje pliki na standardowe wyjście.

--to-command=POLECENIE

Przekazuje pliki potokiem do POLECENIA. Argument jest ścieżką programu zewnętrznego, opcjonalnie z argumentami wiersza poleceń. Program ten zostanie wywołany, a zawartość wypakowywanego pliku przekazana mu na standardowe wejście. Dodatkowe dane zostaną przekazane przez następujące zmienne środowiskowe:

Obsługa atrybutów plików¶

--atime-preserve[=METODA]

Preserve access times on dumped files, either by restoring the times after reading (METHOD=replace, this is the default) or by not setting the times in the first place (METHOD=system)

--delay-directory-restore

Opóźnia ustawianie czasów modyfikacji i opóźnień rozpakowanych katalogów aż do końca rozpakowywania. Z opcji tej należy korzystać, gdy archiwum ma nietypową kolejność składowych.

--group=NAZWA[:ID-GRUPY]

Wymusza NAZWĘ jako grupę dodanych plików. Jeśli nie poda się ID-GRUPY, NAZWĄ może być nazwa użytkownika lub numeryczny identyfikator grupy. W takim przypadku, brakująca część (identyfikator grupy lub nazwa) zostaną pobrane z bazy danych grup bieżącej stacji.

Przy łącznym stosowaniu z --group-map=PLIK, opcja ma wpływ tylko na pliki, których grupy właścicielskiej nie wypisano w PLIKU.

--group-map=PLIK

Odczytuje mapę translacji grup z PLIKU. Puste wiersze są ignorowane. Komentarze wprowadza znak #, kończą się z końcem wiersza. Każdy niepusty wiersz w PLIKU określa tłumaczenie pojedynczej grupy. Musi składać się z dwóch pól, rozdzielonych dowolną liczbą odstępów:

STARA-GRUPA NOWA-GRUPA[:NOWY-ID-GRUPY]
    

STARA-GRUPA jest albo prawidłową nazwą grupy, albo identyfikatorem grupy poprzedzonym znakiem +. Jeśli nie podano NOWEGO-ID-GRUPY, NOWA-GRUPA również musi być albo prawidłową nazwą grupy, albo +ID-GRUPY. W innym przypadku, NOWA-GRUPA i NOWY-ID-GRUPY nie muszą być umieszczone w systemowej bazie danych grup

Efektem końcowym jest sytuacja, gdzie każdy plik wejściowy z własnością grupy STARA-GRUPA zostanie przechowany w archiwum z własnością grupy NOWA-GRUPA i GID NOWY-ID-GRUPY.

--mode=ZMIANY

Wymusza ZMIANY trybu (symbolicznego) dodanych plików.

--mtime=DATA-lub-PLIK

Ustawia czas modyfikacji (mtime) dodawanych plików. DATA-lub-PLIK jest albo datą/czasem w niemal dowolnym formacie, albo nazwą istniejącego pliku. W tym drugim przypadku zostanie użyty czas modyfikacji podanego pliku.

-m, --touch

Nie dearchiwizuje czasu modyfikacji plików.

--no-delay-directory-restore

Odwołuje działanie wcześniejszej opcji --delay-directory-restore.

--no-same-owner

Wypakowuje pliki jako użytkownik uruchamiający program tar (domyślne dla zwykłych użytkowników).

--no-same-permissions

Stosuje umask użytkownika przy wypakowywaniu uprawnień z archiwum (domyślne dla zwykłych użytkowników).

--numeric-owner

Posługuje się numerami użytkowników i grup, zamiast ich nazw.

--owner=NAZWA[:UID]

Wymusza NAZWĘ jako właściciela dodanych plików. Jeśli nie poda się ID-UŻYTKOWNIKA, NAZWĄ może być nazwa użytkownika lub numeryczny identyfikator użytkownika. W takim przypadku, brakująca część (identyfikator użytkownika lub nazwa) zostaną pobrane z bazy danych użytkowników bieżącej stacji.

Przy łącznym stosowaniu z --owner-map=PLIK, opcja ma wpływ tylko na pliki, których właściciela nie wypisano w PLIKU.

--owner-map=PLIK

Odczytuje mapę translacji użytkowników z PLIKU. Puste wiersze są ignorowane. Komentarze wprowadza znak #, kończą się z końcem wiersza. Każdy niepusty wiersz w PLIKU określa tłumaczenie pojedynczego użytkownika. Musi składać się z dwóch pól, rozdzielonych dowolną liczbą odstępów:

STARY-UŻYTKOWNIK NOWY-UŻYTKOWNIK[:NOWY-ID-UŻYTKOWNIKA]
    

STARY-UŻYTKOWNIK jest albo prawidłową nazwą użytkownika, albo identyfikatorem użytkownika poprzedzonym znakiem +. Jeśli nie podano NOWEGO-ID-UŻYTKOWNIKA, NOWY-UŻYTKOWNIK również musi być albo prawidłową nazwą użytkownika, albo +ID-UŻYTKOWNIKA. W innym przypadku, NOWY-UŻYTKOWNIK i NOWY-ID-UŻYTKOWNIKA nie muszą być umieszczone w systemowej bazie danych użytkowników.

Efektem końcowym jest sytuacja, gdzie każdy plik wejściowy z właścicielem STARY-UŻYTKOWNIK zostanie przechowany w archiwum z właścicielem NOWY-UŻYTKOWNIK i UID NOWY-ID-UŻYTKOWNIKA.

-p, --preserve-permissions, --same-permissions

wyodrębnia informacje o uprawnieniach pliku (domyślne dla superużytkownika)

--same-owner

Próbuje wypakować pliki z tymi samymi właścicielami jak w archiwum (domyślne dla superużytkownika).

-s, --preserve-order, --same-order

Lista nazw plików do dearchiwizacji jest sortowana, by pasować do archiwum.

--sort=KOLEJNOŚĆ

Przy tworzeniu archiwum, sortuje wpisy katalogów zgodnie z KOLEJNOŚCIĄ, którą może być none, name albo inode.

Domyślnym ustawieniem jest --sort=none, przechowujące składowe archiwum w tej samej kolejności, jaką zwróci system operacyjny.

Opcja --sort=name zapewnia, że kolejność w tworzonym archiwum jest jednolita i odtwarzalna.

Opcja --sort=inode ogranicza liczbę przeszukiwań na dysku przy tworzeniu archiwum, co może znacznie skrócić czas archiwizacji. Ta kolejność sortowania jest obsługiwana tylko wtedy, jeśli dany system zapewnia wymagane informacje.

Atrybuty rozszerzone plików¶

--acls

Włącza obsługę ACL POSIX.

--no-acls

Wyłącza obsługę ACL POSIX.

--selinux

Włącza obsługę kontekstu SELinux.

--no-selinux

Wyłącza obsługę kontekstu SELinux.

--xattrs

Włącza obsługę atrybutów rozszerzonych.

--no-xattrs

Wyłącza obsługę atrybutów rozszerzonych.

--xattrs-exclude=WZORZEC

Specify the exclude pattern for xattr keys. PATTERN is a POSIX regular expression, e.g. --xattrs-exclude='^user.', to exclude attributes from the user namespace.

--xattrs-include=WZORZEC

Specify the include pattern for xattr keys. PATTERN is a POSIX regular expression.

Wybór i przełączanie między urządzeniami¶

-f, --file=ARCHIWUM

Używa urządzenia lub pliku archiwum ARCHIWUM. Jeśli nie poda się tej opcji, tar na początku sprawdzi wartość zmiennej środowiskowej "TAPE". Jeśli będzie ustawiona, jej wartość zostanie użyta jako nazwa archiwum. W przeciwnym przypadku, tar przyjmie wbudowaną wartość domyślną. Można ją sprawdzić opcją --show-defaults, zostanie również wypisana na końcu wyniku polecenia tar --help.

Nazwa archiwum posiadająca dwukropek określa plik lub urządzenie na stacji zdalnej. Część przed dwukropkiem stanowi nazwę lub adres IP stacji, a część po dwukropku jest ścieżką pliku lub urządzenia np.:

--file=remotehost:/dev/sr0
    

Przed nazwą stacji można podać opcjonalną nazwę użytkownika, rozdzielając je znakiem @.

Domyślnie, dostęp do zdalnej stacji następuje poprzez polecenie rsh(1). Obecnie często korzysta się w zamian z ssh(1). Można to uczynić za pomocą następującej opcji wiersza polecenia:

--rsh-command=/usr/bin/ssh
    

Zdalna stacja powinna mieć zainstalowane polecenie rmt(8). Jeśli jego ścieżka nie jest taka jak domyślna wartość tar, można przekazać programowi tar prawidłową ścieżkę opcją --rmt-command.

--force-local

Plik z archiwum jest lokalny nawet, jeżeli w jego nazwie występuje dwukropek.

-F, --info-script=POLECENIE, --new-volume-script=POLECENIE

Uruchamia COMMAND po osiągnięciu końca każdej taśmy (wymusza -M). Polecenie może mieć argumenty. Przy uruchomieniu, odziedziczy ono środowisko tar oraz następujące zmienne:

-L, --tape-length=N

Zmienia taśmę po zapisaniu Nx1024 bajtów. Jeśli po N poda się przyrostek oznaczający rozmiar (zob. rozdział Przyrostki oznaczające rozmiar poniżej), przyrostek określa mnożnik zamiast 1024.

Opcja wymusza -M.

-M, --multi-volume

Tworzy/wypisuje zawartość/wypakowuje archiwum wieloczęściowe.

--rmt-command=POLECENIE

Używa POLECENIA zamiast rmt przy uzyskiwaniu dostępu do archiwów zdalnych. Zob. opis opcji -f, powyżej.

--rsh-command=POLECENIE

Używa POLECENIA zamiast rsh przy uzyskiwaniu dostępu do archiwów zdalnych. Zob. opis opcji -f, powyżej.

--volno-file=PLIK

Przy łącznym stosowaniu z --multi-volume, tar będzie pilnował tego, nad którą częścią archiwum wieloczęściowego w PLIKU pracuje program.

Parametry bloków¶

-b, --blocking-factor=BLOKI

Ustawia rozmiar rekordu na BLOKIx512 bajtów.

-B, --read-full-records

Przy wypisywaniu lub wypakowywaniu, akceptuje niepełne rekordy wejściowe po znaczniku końca pliku.

-i, --ignore-zeros

Ignore zeroed blocks in archive. Normally two consecutive 512-blocks filled with zeroes mean EOF and tar stops reading after encountering them. This option instructs it to read further and is useful when reading archives created with the -A option.

--record-size=LICZBA

Ustawia rozmiar rekordu. LICZBA jest liczbą bajtów na rekord. Musi być wielokrotnością 512. Można użyć po niej przyrostka oznaczającego rozmiar np. --record-size=10K oznacza 10 kilobajtów. Zob. podrozdział Przyrostki oznaczające rozmiar, aby zapoznać się z listą prawidłowych przyrostków.

Wybór formatu archiwum¶

-H, --format=FORMAT

Tworzy archiwum w podanym formacie. Prawidłowe formaty to:

--old-archive, --portability

Równoważne as --format=v7.

--pax-option=keyword[[:]=wartość][,keyword[[:]=wartość]]...

Kontroluje słowa kluczowe pax przy tworzeniu archiwów PAX (-H pax). Opcja odpowiada opcji -o narzędzia pax(1).

--posix

Równoważne --format=posix.

-V, --label=TEKST

Tworzy archiwum z nazwą części TEKST. Przy wypisywaniu/rozpakowywaniu używa TEKSTU jako wzorca maski do nazwy części.

Opcje kompresji¶

-a, --auto-compress

Używa przyrostka archiwum do określenia programu kompresującego.

-I, --use-compress-program=POLECENIE

Filtruje dane poprzez POLECENIE. Musi ono akceptować opcję -d służącą do rozpakowywania. Argument może posiadać opcje wiersza poleceń.

-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 używa przyrostka archiwum do określenia programu kompresującego.

-z, --gzip, --gunzip, --ungzip

Filtruje archiwum programem gzip(1).

-Z, --compress, --uncompress

Filtruje archiwum programem compress(1).

--zstd

Filtruje archiwum programem zstd(1).

Wybór lokalnego pliku¶

--add-file=PLIK

Dodaje PLIK do archiwum (przydatne jeśli nazwa zaczyna się minusem).

--backup[=METODA]

Wykonuje kopię zapasową przed usunięciem. Argument METODA, jeśli się go poda, reguluje sposób dokonywania kopii. Jego prawidłowe wartości to:

-C, --directory=KATALOG

Przechodzi do KATALOGU przed dokonywaniem jakichkolwiek działań. Opcja jest zależna od kolejności tj. wpływa na wszystkie opcje za nią.

--exclude=WZORZEC

Wyłącza pliki pasujące do WZORCA, który jest wieloznacznikiem w stylu glob(3).

--exclude-backups

Wyłącza pliki kopii zapasowej i blokady.

--exclude-caches

Wyłącza zawartość katalogów zawierających CACHEDIR.TAG, z wyłączeniem samego pliku tag.

--exclude-caches-all

Wyłącza katalogi zawierające CACHEDIR.TAG i sam ten plik.

--exclude-caches-under

Wyłącza wszystko w katalogach zawierających CACHEDIR.TAG

--exclude-ignore=PLIK

Przed zrzuceniem katalogu sprawdza, czy zawiera on PLIK. Jeśli plik występuje, odczytuje z niego wzorce wykluczające. Wzorce mają wpływ tylko na katalog pliku.

--exclude-ignore-recursive=PLIK

Jak --exclude-ignore, tyle że wzorce z PLIKU mają wpływ na jego katalog wraz z wszystkimi podkatalogami.

--exclude-tag=PLIK

Wyłącza zawartość katalogów zawierających PLIK, z wyjątkiem samego PLIKU.

--exclude-tag-all=PLIK

Wyłącza katalogi zawierające PLIK.

--exclude-tag-under=PLIK

Wyłącza wszystko w katalogach zawierających PLIK.

--exclude-vcs

Wyłącza katalogi systemu kontroli wersji.

--exclude-vcs-ignores

Wyłącza pliki pasujące do wzorców odczytanych z zależnych od systemu kontroli wersji plików ignorowania. Obsługiwane są pliki: .cvsignore, .gitignore, .bzrignore i .hgignore.

-h, --dereference

Podąża za dowiązaniami symbolicznymi; archiwizuje pliki, na które one wskazują.

--hard-dereference

Podąża za dowiązaniami zwykłymi (twardymi); archiwizuje i zrzuca pliki do których się one odnoszą.

-K, --starting-file=SKŁADOWA

Zaczyna od podanej składowej archiwum.

--newer-mtime=DATA

Pracuje na plikach, których data uległa zmianie po podanej DACIE. Jeśli DATA zaczyna się od / lub . uznaje się ją za nazwę pliku; wówczas rozważana jest data modyfikacji tego pliku (mtime).

--no-null

Odwołuje działanie opcji --null.

--no-recursion

Zapobiega automatycznemu zagłębianiu się w katalogi.

--no-unquote

Nie usuwa znaków cytowania z plików wejściowych lub nazw składowych.

--no-verbatim-files-from

Traktuje każdy wiersz odczytany z listy plików, jak gdyby był podany w wierszu polecenia. Oznacza to, że początkowe i końcowe odstępy są usuwane, a jeśli powstały w ten sposób łańcuch zaczyna się od kreski, jest traktowany jako opcja wiersza polecenia tar.

Jest to zachowanie domyślne. Opcja --no-verbatim-files-from służy do przywrócenia tego zachowania po podaniu opcji --verbatim-files-from.

Jest to opcja pozycyjna: ma wpływ na wszystkie opcje --files-from, które zostaną podane po niej, do momentu napotkania opcji --verbatim-files-from lub osiągnięcia końca wiersza, w zależności od tego co nastąpi wcześniej.

Jest wymuszona przez opcję --no-null.

--null

Nakazuje kolejnym opcjom -T na dosłowny odczyt nazw rozdzielonych znakiem null (wyłącza specjalną obsługę nazw rozpoczynających się od kreski).

Zob. też --verbatim-files-from.

-N, --newer=DATA, --after-date=DATA

Przechowuje tylko pliki nowsze od DATY. Jeśli DATA zaczyna się od / lub . uznaje się ją za nazwę pliku; wówczas rozważana jest data modyfikacji tego pliku (mtime).

--one-file-system

Archiwizuje pliki tylko z bieżącego systemu plików.

-P, --absolute-names

Przy tworzeniu archiwów, nie usuwa z nazw plików początkowych ukośników.

--recursion

Obsługuje katalogi rekurencyjnie (domyślnie).

--suffix=ŁAŃCUCH

Przed usunięciem wykonuje kopię zapasową, przesłaniając zwykły przyrostek. Domyślnym przyrostkiem jest ~, chyba że został przesłonięty przez zmienną środowiskową SIMPLE_BACKUP_SUFFIX.

-T, --files-from=PLIK

Nazwy plików do rozpakowania lub archiwizacji są pobierane z PLIKU.

O ile nie określi się inaczej, PLIK musi zawierać listę nazw rozdzielonych znakiem LF ASCII (tj. po jednej nazwie na wiersz). Odczytywane nazwy są traktowane w ten sam sposób jak argumenty w wierszu polecenia. Usuwane są cudzysłowy i dokonywany jest podział na słowa, a każdy łańcuch rozpoczynający się od znaku - jest traktowany jako opcja wiersza polecenia tar.

Jeśli takie zachowanie jest niepożądane, można je wyłączyć opcją --verbatim-files-from.

Opcja --null informuje tar, że nazwy w PLIKU są rozdzielone znakiem NUL ASCII, a nie znakiem LF. Przydatne, gdy listę wygenerowano wskazaniem -print0 programu find(1).

--unquote

Usuwa znaki cytowania z plików wejściowych lub nazw składowych (domyślne).

--verbatim-files-from

Traktuje każdy wiersz pozyskany z listy plików jako nazwę pliku nawet, jeśli zaczyna się od kreski. Listy plików podaje się opcją --files-from (-T). Domyślnym zachowaniem jest traktowanie nazw podanych w liście plików jak gdyby były wpisane w wierszu polecenia tj. nazwy rozpoczynające się od kreski są przyjmowane jako opcje tar. Opcja --verbatim-files-from wyłącza to zachowanie.

This option affects all --files-from options that occur after it in the command line. Its effect is reverted by the --no-verbatim-files-from} option.

This option is implied by the --null option.

Zob. też --add-file.

-X, --exclude-from=PLIK

Wyłącza pliki o nazwach wymienionych w PLIKU.

Przekształcenia nazwy plików¶

--strip-components=LICZBA

Usuwa LICZBĘ początkowych części z nazw plików podczas wypakowania.

--transform=WYRAŻENIE, --xform=WYRAŻENIE

Używa WYRAŻENIA zamieniającego programu sed do przetworzenia nazw plików.

Opcje dopasowujące nazwy plików¶

Opcje wpływają na wzorce włączania i wyłączania.

--anchored

Wzorzec dopasowuje początek nazwy pliku.

--ignore-case

Ignoruje wielkość znaków.

--no-anchored

Wzorzec dopasowuje po dowolnym / (domyślne przy wyłączeniu).

--no-ignore-case

Dopasowanie zwracające uwagę na wielkość znaków (domyślne).

--no-wildcards

Dosłowne dopasowanie łańcuchów.

--no-wildcards-match-slash

Wieloznacznik nie dopasowuje /.

--wildcards

Używa wieloznacznika (domyślne przy wyłączeniach).

--wildcards-match-slash

Wieloznacznik dopasowuje / (domyślne przy wyłączeniach).

Wyjście informacyjne¶

--checkpoint[=LICZBA]

Wyświetla informacje o postępie co LICZBA rekord (domyślnie 10).

--checkpoint-action=AKCJA

Wykonuje AKCJĘ po każdym checkpoincie.

--clamp-mtime

Only set time when the file is more recent than what was given with --mtime.

--full-time

Wypisuje czas pliku do jego pełnej rozdzielczości.

--index-file=PLIK

Wypisuje szczegółowe informacje do PLIKU.

-l, --check-links

Wypisuje komunikat, jeśli nie wszystkie dowiązania są zrzucone.

--no-quote-chars=ŁAŃCUCH

Wyłącza dodatkowe znaki cytowania do ŁAŃCUCHA.

--quote-chars=ŁAŃCUCH

Dodatkowe znaki cytowania do ŁAŃCUCHA.

--quoting-style=STYL

Ustawia styl cytowania plików i nazw składowych. Prawidłowe wartości STYLU to: literal, shell, shell-always, c, c-maybe, escape, locale, clocale.

-R, --block-number

Wypisuje numer rekordu wewnątrz archiwum przy każdym komunikacie.

--show-omitted-dirs

Podczas wypisywania lub wypakowywania, wypisuje każdy katalog niepasujący do kryteriów wyszukiwania.

--show-transformed-names, --show-stored-names

Pokazuje nazwy pliku lub archiwum po przekształceniu opcjami --strip i --transform.

--totals[=SYGNAŁ]

Wypisuje sumę bajtów po przetworzeniu archiwum. Jeśli poda się SYGNAŁ, wypisuje sumę bajtów w momencie jego otrzymania. Dozwolone sygnały to: SIGHUP, SIGQUIT, SIGINT, SIGUSR1 i SIGUSR2. W nazwach sygnałów można pominąć przedrostek SIG.

--utc

Wypisuje czasy modyfikacji pliku w UTC.

-v, --verbose

Verbosely list files processed. Each instance of this option on the command line increases the verbosity level by one. The maximum verbosity level is 3. For a detailed discussion of how various verbosity levels affect tar's output, please refer to GNU Tar Manual, subsection 2.5.1 "The --verbose Option".

--warning=SŁOWO-KLUCZOWE

Włącza lub wyłącza ostrzeżenia identyfikowane SŁOWEM-KLUCZOWYM. Komunikaty są wyłączane, jeśli SŁOWO-KLUCZOWE poprzedzi się przedrostkiem no- i włączane w przeciwnym przypadku.

Multiple --warning messages accumulate.

Słowa kluczowe kontrolujące ogólne działanie tar:

-w, --interactive, --confirmation

Pyta o zgodę na każde działanie.

Opcje kompatybilności¶

-o

Przy tworzeniu, odpowiednik --old-archive. Przy wypakowywaniu, odpowiednik --no-same-owner.

Przyrostki oznaczające rozmiar¶

	Przyr.	Jednostki	Liczba bajtów
	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	Słowa	ROZMIAR x 2