SKŁADNIA

OPIS

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.

FUNKCJE LITEROWE

-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

INNE OPCJE

-[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

PRZYKŁADY

tar -cf archive.tar foo bar

tar -tvf archive.tar

tar -xf archive.tar

HISTORIA

TŁUMACZENIE