tar
— tar - wersja
GNU programu archiwizującego tar
tar
[-
]
A
--catenate
--concatenate
| c
--create
| d
--diff
--compare
|
--delete
| r
--append
| t
--list
|
--test-label
| u
--update
| x
--extract
--get
[opcje]
[nazwa ścieżki ...]
Tar
przechowuje i wyodrębnia pliki
z archiwum z taśmy lub dysku.
Pierwszym argumentem do tara powinna być funkcja: albo
jedna z liter Acdrtux
, albo jedna z długich
nazw funkcji. Litera funkcji nie musi być poprzedzona "-" i
może był połączona z innymi opcjami pojedynczych
liter. Długa nazwa funkcji musi być poprzedzona
--
. Część opcji przyjmuje
parametr; przy postaci jednoliterowej muszą być one podane
jako oddzielne argumenty. W długiej postaci mogą być
podane przez dołączenie
=
wartość do
opcji.
Główny tryb pracy:
-A
,
--catenate
,
--concatenate
- dołączenie istniejących plików .tar do
archiwum
-c
,
--create
- utworzenie nowego archiwum
-d
,
--diff
, --compare
- znalezienie różnic między archiwum, a systemem
plików
--delete
- usunięcie plików z archiwum (opcji nie można
użyć na taśmach magnetycznych!)
-r
,
--append
- dołączenie plików do archiwum na jego
końcu
-t
,
--list
- wypisanie zawartości archiwum
--test-label
- sprawdzenie etykiety woluminu archiwum i wyjście
-u
,
--update
- dołączenie tylko tych plików, które są
nowsze niż egzemplarze w archiwum
-x
,
--extract
, --get
- ekstrakcja plików z archiwum
Modyfikatory operacji:
- -[0-7][lmh]
- określenie napędu i gęstości
-a
,
--auto-compress
- używa przyrostka archiwum do określenia programu
kompresującego
--acls
- Włącza obsługę ACL POSIX
--no-acls
- Wyłącza obsługę ACL POSIX
--add-file
=PLIK
- dodaje podany PLIK do archiwum (przydatne jeśli nazwa zaczyna
się minusem)
--anchored
- wzorzec dopasowuje początek nazwy pliku
--no-anchored
- wzorzec dopasowuje po dowolnym "/" (domyślne przy
wyłączeniu)
--atime-preserve
- zachowuje czasy dostępu zrzucanych plików, albo przez
przywrócenie czasów po odczycie (METODA="replace",
domyślnie), albo przez nieustawianie czasów w pierwszym
miejscu (METODA="system")
--no-auto-compress
- nie używa przyrostka archiwum do określenia programu
kompresującego
-b
,
--blocking-factor
BLOKI
- BLOKI x 512 bajtów na rekord
-B
,
--read-full-records
- zmienia rozmiar bloku podczas czytania archiwum (do używania z
nazwanymi potokami 4.2BSD)
--backup
- przed usunięciem wykonuje kopię zapasową, kontroluje
wybór wersji
-C
,
--directory
KATALOG
- zmienia katalog na KATALOG
--check-device
- sprawdza numer urządzenia przy tworzeniu archiwów
przyrostowych (domyślnie)
--no-check-device
- nie sprawdza numerów urządzenia przy tworzeniu
archiwów przyrostowych
--checkpoint
- wyświetla informacje o postępie co LICZBA rekord
(domyślnie 10)
--checkpoint-action
=AKCJA
- wykonuje AKCJĘ po każdym checkpoincie
--delay-directory-restore
- opóźnia ustawianie czasów modyfikacji i
opóźnień rozpakowanych katalogów aż do
końca rozpakowywania
--no-delay-directory-restore
- odwołuje działanie opcji --delay-directory-restore
--exclude
=WZORZEC
- wyłącza pliki podane jako WZORZEC
--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
--exclude-caches-under
- wyłącza wszystko w katalogach zawierających
CACHEDIR.TAG
--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
-f
,
--file
ARCHIWUM
- używa pliku archiwum lub urządzenia ARCHIWUM
-F
,
--info-script
,
--new-volume-script
NAZWA
- na końcu każdej taśmy uruchamia podany skrypt
(implikuje funkcjonalność opcji -M)
--force-local
- plik z archiwum jest lokalny nawet, jeżeli w jego nazwie
występuje dwukropek
--full-time
- wypisuje czas pliku do jego pełnej rozdzielczości
-g
,
--listed-incremental
PLIK
- obsługuje archiwum przyrostowe w nowym formacie GNU
-G
,
--incremental
- obsługuje archiwum przyrostowe w starym formacie GNU
--group
=NAZWA
- wymusza NAZWĘ jako grupę dodanych plików
-h
,
--dereference
- podąża za dowiązaniami symbolicznymi; archiwizuje
pliki, na które one wskazują
-H
,
--format
FORMAT
- tworzy archiwum w podanym FORMACIE, który jest jednym z
poniższych:
--format=gnu
- format GNU tar 1.13.x
--format=oldgnu
- format GNU w programie tar <= 1.12
--format=pax
- format POSIX 1003.1-2001 (pax)
--format=posix
- równoważne pax
--format=ustar
- format POSIX 1003.1-1988 (ustar)
--format=v7
- stary format tar V7
--hard-dereference
- podąża za dowiązaniami zwykłymi (twardymi);
archiwizuje i zrzuca pliki do których się one
odnoszą
-i
,
--ignore-zeros
- ignoruje bloki zawierające same zera (normalnie taki blok w
archiwum oznacza koniec pliku)
-I
,
--use-compress-program
PROGRAM
- filtruje archiwum programem PROGRAM (który musi akceptować
opcję -d oznaczającą dekompresję)
--ignore-case
- ignoruje wielkość znaków
--no-ignore-case
- dopasowanie zwracające uwagę na wielkość
znaków (domyślne)
--ignore-command-error
- ignoruje kody zakończenia procesów potomnych
--no-ignore-command-error
- traktuje niezerowe kody zakończenia procesów potomnych jako
błąd
--ignore-failed-read
- zakazuje kończenia działania programu z niezerowym kodem
wyjścia po napotkaniu plików, które nie dają
się odczytać
--index-file
=PLIK
- wypisuje szczegółowe informacje do PLIKU
-j
,
--bzip2
-
-J
,
--xz
-
-k
,
--keep-old-files
- nie zastępuje istniejących plików podczas
wypakowywania, traktuje je jako błędy
-K
,
--starting-file
NAZWA-CZĘŚCI
- zaczyna od części NAZWA-CZĘŚCI przy
odczytywaniu archiwum
--keep-directory-symlink
- zachowuje istniejące dowiązania symboliczne przy
wypakowywaniu
--keep-newer-files
- nie zastępuje istniejących plików, które
są nowsze niż egzemplarze w archiwum
-l
,
--check-links
- wypisuje komunikat, jeśli nie wszystkie dowiązania są
zrzucone
-L
,
--tape-length
LICZBA
- zmiana taśmy po zapisaniu LICZBA x 1024 bajtów
--level
=LICZBA
- zrzuca poziom do tworzenia archiwum przyrostowego
--lzip
-
--lzma
-
--lzop
-
-m
,
--touch
- nie dearchiwizuje czasu modyfikacji plików
-M
,
--multi-volume
- tworzy/wypisuje zawartość/dearchiwizuje archiwum
wieloczęściowe
--mode
=ZMIANY
- wymusza ZMIANY trybu (symbolicznego) dodanych plików
--mtime
=DATA-lub-PLIK
- ustawia mtime dodawanych plików na DATA-lub-PLIK
-n
,
--seek
- archiwum jest przeszukiwalne
-N
,
--newer
, --after-date
DATA-lub-PLIK
- archiwizuje wyłącznie pliki nowsze, niż
DATA-lub-PLIK
--newer-mtime
=DATA
- porównuje datę i czas gdy zmieniła się tylko
data
--null
- opcja -T odczytuje nazwy plików zakończone znakiem '\0',
opcja -C wówczas nie działa
--no-null
- odwołuje działanie opcji --null
--numeric-owner
- posługiwanie się numerami użytkowników i grup,
zamiast ich nazw
-O
,
--to-stdout
- dearchiwizuje pliki na standardowe wyjście
--occurrence
- przetwarza tylko 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; WYSTĄPIENIE domyślnie wynosi 1.
--old-archive
,
--portability
- równoważne --format=v7
--one-file-system
- archiwizuje pliki tylko z bieżącego systemu
plików
--overwrite
- nadpisuje istniejące pliki podczas wypakowywania
--overwrite-dir
- nadpisuje metadane istniejących katalogów podczas
wypakowywania (domyślne)
--no-overwrite-dir
- zachowuje metadane istniejących katalogów
--owner
=NAZWA
- wymusza NAZWĘ jako właściciela dodanych
plików
-p
,
--preserve-permissions
,
--same-permissions
- wyodrębnia informacje o uprawnieniach pliku (domyślne dla
superużytkownika)
-P
,
--absolute-names
- nie usuwa z nazw plików początkowych znaków
"/"
--pax-option
=keyword[[:]=wartość][,keyword[[:]=wartość]]...
- kontroluje słowa kluczowe pax
--posix
- równoważne --format=posix
--preserve
- równoważne -p i -s
--quote-chars
=ŁAŃCUCH
- dodatkowe znaki cytowania do ŁAŃCUCHA
--no-quote-chars
=ŁAŃCUCH
- wyłącza dodatkowe znaki cytowania do
ŁAŃCUCHA
--quoting-style
=STYL
- ustawia styl cytowania nazw; patrz niżej, aby poznać
prawidłowe wartości STYLU
-R
,
--block-number
- wypisywanie numeru rekordu wewnątrz archiwum przy każdym
komunikacie
--record-size
=LICZBA
- LICZBA bajtów na rekord, wielokrotność 512
--recursion
- obsługuje katalogi rekurencyjnie (domyślnie)
--no-recursion
- zapobiega automatycznemu zagłębianiu się w
katalogi
--recursive-unlink
- oczyszcza hierarchię w stosunku do wypakowywanego katalogu
--remove-files
- usuwa pliki po dodaniu ich do archiwum
--restrict
- wyłącza część potencjalnie szkodliwych
opcji
--rmt-command
=POLECENIE
- używa podanego POLECENIA rmt zamiast rmt
--rsh-command
=POLECENIE
- używa podanego zdalnego POLECENIA zamiast rsh
-s
,
--preserve-order
,
--same-order
- przy wypisywaniu zachowywana jest kolejność
części taka jak plików w archiwum
-S
,
--sparse
- efektywna obsługa plików rozrzedzonych (z
"dziurami")
--same-owner
- próbuje wypakować pliki z tymi samymi
właścicielami jak w archiwum (domyślne dla
superużytkownika)
--no-same-owner
- wypakowuje pliki jako użytkownik uruchamiający program tar
(domyślne dla zwykłych użytkownik)
--no-same-permissions
- stosuje umask użytkownika przy wypakowywaniu uprawnień z
archiwum (domyślne dla zwykłych
użytkowników)
--no-seek
- archiwum jest nieprzeszukiwalne
--selinux
- Włącza obsługę kontekstu SELinux
--no-selinux
- Wyłącza obsługę kontekstu SELinux
--show-defaults
- pokazuje domyślne ustawienia tar
--show-omitted-dirs
- podczas wypisywania lub wypakowywania, wypisuje każdy katalog
niepasujący do kryteriów wyszukiwania
--show-snapshot-field-ranges
- pokazuje prawidłowe zakresy pól do
plików-migawek
--show-transformed-names
,
--show-stored-names
- pokazuje nazwy pliku lub archiwum po przetworzeniu
--skip-old-files
- nie zastępuje istniejących plików podczas
wypakowywania, po chichu je pomija
--sparse-version
=GŁÓWNY[.POBOCZNY]
- ustawia wersję formatu plików rzadkich ("z
dziurami") (implikuje --sparse)
--strip-components
=LICZBA
- usuwa LICZBĘ początkowych części z nazw
plików podczas wypakowania
--suffix
=ŁAŃCUCH
- przed usunięciem wykonuje kopię zapasową,
przesłania zwykły przyrostek ("~", chyba że
został przesłonięty przez zmienną
środowiskową SIMPLE_BACKUP_SUFFIX)
-T
,
--files-from
PLIK
- nazwy plików do archiwizacji lub dearchiwizacji są pobierane
z pliku PLIK
--to-command
=POLECENIE
- przesyła wyodrębnione pliki potokiem do innego programu
--totals
- wypisuje sumę bajtów po przetworzeniu archiwum; z argumentem
- wypisuje sumę bajtów po otrzymaniu danego SYGNAŁU.
Dozwolone sygnały to: SIGHUP, SIGQUIT, SIGINT, SIGUSR1 lub SIGUSR2;
nazwy bez przedrostka SIG są również dozwolone
--transform
,
--xform
WYRAŻENIE
- używa WYRAŻENIA zamieniającego seda do przetworzenia
nazw plików
-U
,
--unlink-first
- usuwa każdy plik przed wypakowaniem do niego
--unquote
- nie cytuje nazw plików odczytanych za pomocą -T
(domyślnie)
--no-unquote
- zapobiega niecytowaniu nazw plików odczytanych za pomocą
-T
--utc
- wypisuje czasy modyfikacji pliku w UTC
-v
,
--verbose
- szczegółowe wypisywanie nazw przetwarzanych
plików
-V
,
--label
TEKST
- tworzy archiwum z nazwą woluminu TEKST, przy
wypisywaniu/rozpakowywaniu używa TEKSTU jako wzorzec maski do nazwy
woluminu
--volno-file
=PLIK
- używa/aktualizuje numer woluminu w PLIKU
-w
,
--interactive
,
--confirmation
- pyta o zgodę na każdą operację
-W
,
--verify
- weryfikacja archiwum po jego utworzeniu
--warning
=SŁOWO-KLUCZOWE
- kontrola ostrzeżeń
--wildcards
- używa wieloznacznika (domyślne przy
wyłączeniach)
--wildcards-match-slash
- wieloznacznik dopasowuje "/" (domyślne przy
wyłączeniach)
--no-wildcards-match-slash
- wieloznacznik nie dopasowuje "/"
--no-wildcards
- dosłowne dopasowanie łańcuchów
-X
,
--exclude-from
PLIK
- wyłączenie z archiwizacji plików o nazwach
wymienionych w pliku PLIK
--xattrs
- Włącza obsługę atrybutów
rozszerzonych
--xattrs-exclude
=WZORZEC
- określa wzorzec wyłączenia kluczy atrybutów
rozszerzonych
--xattrs-include
=WZORZEC
- określa wzorzec włączenia kluczy atrybutów
rozszerzonych
--no-xattrs
- Wyłącza obsługę atrybutów
rozszerzonych
-z
,
--gzip
, --gunzip
--ungzip
-
-Z
,
--compress
,
--uncompress
-
ŚRODOWISKO
Zachowanie programu tar jest kontrolowane przez między
innymi przez następujące zmienne środowiskowe:
TAR_LONGLINK_100
-
PRISTINE_TAR_COMPAT
-
SIMPLE_BACKUP_SUFFIX
- Przedrostek kopii zapasowej przy wypakowaniu, jeśli nie podano
--suffix
. Jeśli nie podano żadnego z
nich, domyślnie używany jest "~".
TAR_OPTIONS
- Opcje dodawane przed opcjami podanymi w wierszu polecenia, oddzielone
spacjami. Odwrotne ukośniki mogą zostać użyte
do zacytowania spacji lub odwrotnego ukośnika w opcji.
TAPE
- Urządzenie lub plik użyty do archiwizacji, jeśli nie
podano
--file
. Jeśli ta zmienna
środowiskowa nie jest ustawiona, używane jest standardowe
wejście lub wyjście.
Tworzenie archive.tar z plików foo i bar.
tar -cf archive.tar foo bar
Szczegółowe wypisanie wszystkich plików z archive.tar.
Wypisanie wszystkich plików z archive.tar.
Polecenie tar
pojawiło się w
Version 7 AT&T UNIX.
BŁĘDY
Ludzie ze środowiska GNU zwykle nie znoszą stron
podręcznika systemowego man i tworzą w zamian dokumenty info.
Niestety, dokument info opisujący tara jest licencjonowany na
warunkach GFDL z niezmiennymi tekstami okładki, przez nie
można było wykorzystać z niego jakiegokolwiek tekstu w
niniejszej stronie podręcznika. Większość
zamieszczonego tu tekstu została wyodrębniona automatycznie, z
tekstu opisującego użycie, w źródle programu. W
związku z tym, ten podręcznik może nie być
kompletny.
TŁUMACZENIE
Autorami polskiego tłumaczenia niniejszej strony
podręcznika man są: Łukasz Kowalczyk (PTM)
<lukow@tempac.okwf.fuw.edu.pl>, Andrzej M. Krzysztofowicz (PTM)
<ankry@green.mf.pg.gda.pl> i Michał Kułach
<michal.kulach@gmail.com>.
Polskie tłumaczenie jest częścią projektu
manpages-pl; uwagi, pomoc, zgłaszanie błędów na
stronie http://sourceforge.net/projects/manpages-pl/. Jest zgodne z
wersją 1.27.1 oryginału.