TAR(1) Handbuch zu GNU TAR TAR(1)

tar - ein Archivierungswerkzeug

ÜBERSICHT

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

tar -A [OPTIONEN] -f ARCHIV ARCHIV …

tar -c [-f ARCHIV] [OPTIONEN] [DATEI …]

tar -d [-f ARCHIV] [OPTIONEN] [DATEI …]

tar -r [-f ARCHIV] [OPTIONEN] [DATEI …]

tar -t [-f ARCHIV] [OPTIONEN] [ELEMENT …]

tar -u [-f ARCHIV] [OPTIONEN] [DATEI …]

tar -x [-f ARCHIV] [OPTIONEN] [ELEMENT …]

tar {--catenate|--concatenate} [OPTIONEN] --file ARCHIV ARCHIV …

tar --create [--file ARCHIV] [OPTIONEN] [DATEI …]

tar {--diff|--compare} [--file ARCHIV] [OPTIONEN] [DATEI ]

tar --delete [--file ARCHIV] [OPTIONEN] [ELEMENT …]

tar --append [--file ARCHIV] [OPTIONEN] [DATEI …]

tar --list [--file ARCHIV] [OPTIONEN] [ELEMENT …]

tar --test-label [--file ARCHIV] [OPTIONEN] [BEZEICHNUNG …]

tar --update [--file ARCHIV] [OPTIONEN] [DATEI …]

tar {--extract|--get} [--file ARCHIV] [OPTIONEN] [ELEMENT …]

Diese Handbuchseite ist eine Kurzbeschreibung von GNU tar. Detailliertere Erläuterungen einschließlich Beispielen und Empfehlungen für Befehlsaufrufe finden Sie im GNU Tar Manual im Texinfo-Format. Wenn das Anzeigeprogramm info(1) und die Dokumentation zu Tar auf Ihrem System korrekt installiert sind, können Sie mit dem Befehl

info tar

auf das vollständige Handbuch zugreifen.

Sie können das Handbuch auch im Info-Modus in emacs(1) betrachten. Weiterhin finden Sie verschiedene Formate online auf

https://www.gnu.org/software/tar/manual

Falls Sie in dieser Handbuchseite und dem GNU Tar Manual unterschiedliche Aussagen entdecken, sollte Letzteres als Referenzquelle anerkannt werden.

GNU tar ist ein Archivprogramm, das mit dem Ziel entwickelt wird, mehrere Dateien in einer einzigen Datei zu speichern (einem Archiv) sowie diese Dateien zu bearbeiten. Das Archiv kann entweder eine reguläre Datei oder ein Gerät sein (zum Beispiel ein Bandlaufwerk, woraus der Name des Programms abgeleitet wurde, der für tape archiver steht), das sich auf einem lokalen Rechner oder auch einem Rechner im Netz befinden kann.

Die Optionen können an tar auf drei verschiedene Arten übergeben werden. Im traditionellen Stil ist das erste Argument eine Aneinanderreihung von Optionsbuchstaben und alle darauf folgenden Argumente übergeben wiederum Argumente an die Optionen, wo sie notwendig sind. Die Argumente werden in der gleichen Reihenfolge wie die Optionsbuchstaben ausgewertet. Alle Wörter in der Befehlszeile, die nach den Optionen verbleiben, werden als Nicht-Options-Argumente verarbeitet: Namen von Dateien oder Archivelementen.

Beispielsweise erfordert die Option c die Erstellung eines Archives, die Option v ausführliche Ausgaben, und die Option f erwartet ein Argument, das den Namen des Archivs angibt, das verarbeitet werden soll. Der folgende Befehl im traditionellen Stil weist tar an, alle Dateien aus dem Verzeichnis /etc in die Archivdatei etc.tar zu packen, wobei die archivierten Dateien ausführlich aufgelistet werden:

tar cfv etc.tar /etc

Im UNIX oder Kurzoptions-Stil wird jedem Optionsbuchstaben ein einzelnes Minuszeichen vorangestellt, so wie in anderen Befehlszeilenwerkzeugen auch. Wenn eine Option ein Argument akzeptiert, folgt es danach, entweder als separates Wort in der Befehlszeile oder unmittelbar nach der Option. Wenn jedoch die Option ein optionales Argument akzeptiert, muss das Argument ohne Leerzeichen direkt auf den Optionsbuchstaben folgen, zum Beispiel wie in -g/tmp/snar.db.

Eine beliebige Anzahl von Optionen, die keine Argumente akzeptieren, können nach einem einzelnen Minuszeichen zusammengefasst werden, zum Beispiel -vkp. Eine Option, die ein Argument akzeptiert (egal ob obligatorisch oder optional), kann am Ende angehängt werden, zum Beispiel -vkpf a.tar.

Der obige Beispielbefehl könnte im Kurzoptions-Stil folgendermaßen aussehen:

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

Im GNU oder Langoptions-Stil beginnt jede Option mit einem doppelten Minuszeichen und hat einen aussagekräftigen Namen, der aus Kleinbuchstaben und Minuszeichen besteht. Die Langoption kann mit ihren Anfangsbuchstaben abgekürzt werden, sofern dadurch kein Zweideutigkeiten verursacht werden. Argumente zu Langoptionen werden entweder als separates Wort in der Befehlszeile unmittelbar nach der Option übergeben, oder durch ein Gleichheitszeichen von der Option getrennt, ohne eingefügte Leerzeichen. Optionale Argumente müssen stets auf die letztgenannte Weise übergeben werden.

Nachfolgend finden Sie verschiedene Möglichkeiten des Beispielbefehls in diesem Stil:

tar --create --file etc.tar --verbose /etc
oder (durch Abkürzung einiger Optionen): 
tar --cre --file=etc.tar --verb /etc

Die Optionen in allen drei Stilen können miteinander gemischt werden. Dies wird mit alten Optionen jedoch nicht empfohlen.

Die in der nachfolgenden Tabelle aufgelisteten Optionen weisen tar an, welche Aktion ausgeführt werden soll. Exakt eine davon muss angegeben werden. Die Bedeutung der Nicht-Options-Argumente hängt davon ab, welcher Aktionsmodus angefordert wird.

hängt Archive an das Ende eines anderen Archivs an. Die Argumente werden als die Namen der anzuhängenden Archive aufgefasst. Alle Archive müssen im gleichen Format des Archivs vorliegen, an das sie angehängt werden sollen. Anderenfalls wäre das Archiv mit Nicht-GNU-Implementationen von tar nicht verwendbar. Beachten Sie auch, dass bei Angabe von mehr als einem Archiv jene Elemente, die nicht aus dem ersten Archiv stammen, im sich ergebenden Archiv nur dann verfügbar sein werden, wenn die Option -i (--ignore-zeros) angegeben wird.

Komprimierte Archive können nicht verkettet werden.

erstellt ein neues Archiv. Argumente werden als Namen der zu archivierenden Dateien aufgefasst. Verzeichnisse werden rekursiv archiviert, außer wenn die Option --no-recursion angegeben ist.
findet Unterschiede zwischen Archiv und Dateisystem. Die Argumente sind optional und geben die zu vergleichenden Archivelemente an. Falls nichts angegeben ist, wird das aktuelle Arbeitsverzeichnis angenommen.
löscht Elemente aus dem Archiv. Die übergebenen Argumente sind Namen der zu löschenden Elemente. Es muss mindestens ein Argument angegeben werden.

Diese Option funktioniert nicht mit gepackten Archiven. Außerdem gibt es keine entsprechende kurze Option.

hängt Dateien am Ende eines Archivs an. Die Argumente sind gleichbedeutend mit jenen für -c (--create).
listet den Inhalt eines Archivs auf. Argumente sind optional. Wenn angegeben, bezeichnen diese die Namen der aufzulistenden Argumente.
testet die Datenträgerbezeichnung des Archivs und beendet das Programm. Wenn es ohne Argumente aufgerufen wird, wird die Datenträgerbezeichnung aufgerufen (sofern vorhanden) und das Programm mit dem Status 0 beendet. Wenn eines oder mehrere Befehlszeilenargumente angegeben sind, vergleicht tar die Datenträgerbezeichnung mit jedem Argument. Es wird mit dem Exit-Code 0 beendet, falls eine Übereinstimmung gefunden wird, anderenfalls mit 1. Es erfolgt nur dann eine Ausgabe, wenn die Option -v (--verbose) übergeben wurde.

Für diese Option gibt es keine entsprechende kurze Option.

hängt Dateien, die neuer als die entsprechende Kopie in dem Archiv sind, an. Die Argumente haben die gleiche Bedeutung wie bei den Optionen -c und -r. Beachten Sie, dass neuere Dateien nicht ihre älteren Archivkopien ersetzen, sondern stattdessen an das Ende des Archivs angehängt werden. Das entstandende Archiv kann daher mehrere Mitglieder mit dem gleichen Namen enthalten, entsprechend mehrerer Versionen der gleichen Datei.
entpackt Dateien aus einem Archiv. Argumente sind optional. Wenn angegeben, bezeichnen sie die Namen der Elemente, die aus dem Archiv entpackt werden sollen.
zeigt die eingebauten Voreinstellungen für verschiedene Optionen von tar an und beendet das Programm.
-?, --help
zeigt eine kurze Zusammenfassung der Optionen an und beendet das Programm.
zeigt eine Liste der verfügbaren Optionen an und beendet das Programm.
zeigt Versions- und Urheberrechtsinformationen an und beendet das Programm.

überprüft Gerätenummern, wenn inkrementelle Archive erstellt werden (Voreinstellung).
verarbeitet inkrementelle Sicherungen im neuen GNU-Format. DATEI ist der Name einer Schnappschuss-Datei, wo tar zusätzliche Informationen speichert. Diese werden zur Entscheidung darüber herangezogen, welche Dateien sich seit der letzten inkrementellen Sicherung geändert haben und daher nicht erneut gespeichert werden müssen. Wenn diese DATEI bei der Erstellung eines Archivs nicht existiert, wird sie angelegt und alle Dateien zum sich ergebenden Archiv hinzugefügt werden (die Speicherung der Stufe 0). Um inkrementelle Archive der von Null verschiedenen Stufe N zu erzeugen, erstellen Sie eine Kopie der Schnappschuss-Datei während der Stufe N-1 und verwenden Sie diese als DATEI.

Beim Auflisten oder Entpacken wird der tatsächliche Inhalt der DATEI nicht untersucht, es ist nur aus syntaktischen Erfordernissen nötig. Daher wird häufig /dev/null verwendet.

verwendet die angegebene METHODE zum Finden von Lücken in Sparse-Dateien. Diese Option impliziert --sparse. Gültige Werte für METHODE sind seek and raw. In der Voreinstellung wird seek benutzt, anderenfalls wird auf raw ausgewichen, wenn seek nicht anwendbar ist.
verwendet das alte GNU-Format für inkrementelle Sicherheitskopien.
beendet bei nicht lesbaren Dateien nicht mit einem Rückgabewert ungleich Null.
legt die Speicherstufe für erzeugte »listed-incremental«-Archive fest. Gegenwärtig ist nur --level=0 von Bedeutung: Es weist tar an, den Schnappschuss vor der Ausgabe zu kürzen, wobei die Stufe 0 erzwungen wird.
nimmt an, dass das Archiv durchsuchbar ist. Normalerweise ermittelt tar automatisch, ob ein Archiv durchsucht werden kann oder nicht. Diese Option ist für jene Fälle gedacht, in denen die automatische Erkennung nicht funktioniert. Sie ist nur wirksam, wenn das Archiv zum Lesen geöffnet ist (zum Beispiel mit den Optionen --list oder --extract).
überprüft Gerätenummern nicht, wenn inkrementelle Archive erstellt werden.
nimmt an, dass das Archiv nicht durchsuchbar ist.
verarbeitet nur jedes N-te Vorkommen jeder Datei im Archiv. Diese Option ist nur in Verbindung mit einem der Unterbefehle --delete, --diff, --extract oder --list gültig, und wenn eine Liste von Dateien entweder in der Befehlszeile oder mit der Option -T angegeben ist. Die Vorgabe für N ist 1.
schaltet die Verwendung von einigen potenziell schädlichen Optionen aus.
legt die Version des zu verwendenden Sparse-Formats fest. Diese Option impliziert --sparse. Zulässige Werte für Argumente sind 0.0, 0.1 und 1.0. Detaillierte Erläuterungen zu den Sparse-Formaten finden Sie im GNU Tar Manual, Anhang D, »Sparse Formats«. Mit dem Anzeigeprogramm info können Sie es mit dem folgenden Befehl aufrufen: info tar 'Sparse Formats'.
verarbeitet Sparse-Dateien effizient. Einige Dateien im Dateisystem können Abschnitte enthalten, in die tatsächlich nie geschrieben wurde (oft sind es von Systemen wie DBM angelegte Datenbankdateien). Wenn diese Option angegeben ist, versucht tar vor dem Archivieren zu bestimmen, ob es sich um eine Sparse-Datei handelt. Sollte das der Fall sein, wird versucht, die Größe des Archivs zu verringern, indem leere Teile der Datei nicht mit archiviert werden.

Diese Optionen regeln das Verhalten von tar beim Entpacken einer Datei über eine vorhandene Kopie auf einem Datenträger.

ersetzt existierende Dateien beim Entpacken nicht.
ersetzt existierende Dateien nicht, die neuer als ihre Kopie im Archiv sind.
ersetzt existierende Symlinks auf Verzeichnisse beim Entpacken nicht.
behält die Metadaten von existierenden Verzeichnissen.
entpackt alle Dateien in VERZ, oder wenn es ohne Argument angegeben wird, in ein Unterverzeichnis, das nach dem Basisnamen des Archivs benannt wird (ohne die Standard-Kompressionserweiterungen, die von --auto-compress erkannt werden können).
überschreibt existierende Dateien beim Entpacken.
überschreibt Metadaten von existierenden Verzeichnissen beim Entpacken (Voreinstellung).
löscht alle Dateien im Verzeichnis vor dem Entpacken rekursiv.
löscht Dateien vom Datenträger, nachdem sie zum Archiv hinzugefügt wurden.
ersetzt existierende Dateien beim Entpacken nicht, sie werden ohne Meldung übersprungen.
löscht jede Datei, bevor sie beim Entpacken überschrieben wird.
überprüft das Archiv nach dem Schreiben.

ignoriert die Exit-Codes von Unterprozessen.
behandelt Rückgabewerte ungleich Null von Kindprozessen als Fehler (Voreinstellung).
entpackt Dateien in die Standardausgabe.
leitet die entpackten Dateien an BEFEHL weiter. Das Argument ist der Pfadname eines externen Programms, optional mit Befehlszeilenargumenten. Das Programm wird aufgerufen und der Inhalt der entpackten Datei in die Standardausgabe übergeben. Zusätzliche Daten werden über die folgenden Umgebungsvariablen übergeben:
Der Dateityp ist ein einzelner Buchstabe folgender Bedeutung: 
f	Reguläre Datei
d	Verzeichnis
l	Symbolischer Link
h	Hardlink
b	Blockorientiertes Gerät
c	Zeichenorientiertes Gerät

Gegenwärtig werden nur reguläre Dateien unterstützt.

Der Dateimodus als Oktalzahl.
Der Name der Datei.
Der Name der Datei, so wie sie im Archiv gespeichert ist.
Name des Besitzers der Datei.
Name der Gruppe des Besitzers der Datei.
Zeit des letzten Zugriffs. Es ist eine Dezimalzahl, die die Sekunden seit Beginn der Unix-Zeitrechnung darstellt. Wenn das Archiv Zeitangaben mit Nanosekunden-Präzision enthält, werden die Nanosekunden nach einem Dezimaltrenner an den Zeitstempel angehängt.
Zeitpunkt der letzten Änderung.
Zeitpunkt der letzten Statusänderung.
Größe der Datei.
UID (Benutzerkennung) des Besitzers der Datei.
GID (Gruppenkennung) des Besitzers der Datei.

Zusätzlich enthalten die folgenden Variablen Informationen über den Aktionsmodus von tar und das zu verarbeitende Archiv:

Versionsnummer von GNU tar.
Der Name des Archivs, das von tar verarbeitet wird.
Aktueller Block-Faktor, also die Anzahl der 512-Byte-Blöcke in einem Datensatz.
Ordnungszahl des Datenträgers, der von tar verarbeitet wird (wird gesetzt, wenn ein aus mehreren Datenträgern bestehendes Archiv gelesen wird).
Format des verarbeiteten Archivs: gnu, oldgnu, posix, ustar oder v7.
Eine Kurzoption (mit vorangestelltem Minuszeichen), welche die von tar ausgeführte Aktion beschreibt.

erhält Zugriffszeiten für ausgegebene Dateien, entweder durch Wiederherstellen der Zeiten nach dem Lesen (METHODE=replace; Vorgabe) oder durch Nicht-Setzen der Zeiten (METHODE=system).
verzögert das Setzen der Änderungszeiten und Rechte der entpackten Verzeichnisse bis zum Ende des Entpackvorgangs. Verwenden Sie diese Option, wenn Sie aus einem Archiv entpacken, das eine unübliche Anordnung der Elemente aufweist.
erzwingt NAME als Gruppenname für hinzugefügte Dateien. Wenn GID nicht angegeben ist, kann NAME entweder ein Benutzername oder eine numerische GID sein. In diesem Fall wird der fehlende Teil (GID oder Name) aus der aktuellen Gruppen-Datenbank des Rechners abgeleitet.

Wenn dies zusammen mit --group-map=DATEI verwendet wird, wirkt es sich nur auf jene Dateien aus, deren Gruppe nicht in DATEI aufgelistet ist.

liest die Übersetzung der Gruppenzuordnung aus DATEI. Leerzeilen werden dabei ignoriert. Kommentare werden mit einem #-Zeichen eingeleitet und erstrecken sich bis zum Ende der Zeile. Jede nicht-leere Zeile in DATEI definiert die Übersetzung für eine einzelne Gruppe. Sie muss aus zwei Feldern bestehen, die durch eine beliebige Anzahl Leerzeichen getrennt sind: 
ALTEGRUPPE NEUEGRUPPE[:NEUEGID]

ALTEGRUPPE ist entweder ein gültiger Gruppenname oder eine GID, der ein + vorangestellt ist. Außer wenn NEUEGID angegeben ist, muss NEUEGRUPPE auch entweder ein gültiger Gruppenname oder ein +GID sein. Anderenfalls müssen sowohl NEUEGRUPPE als auch NEUEGID nicht in der Gruppendatenbank des Systems enthalten sein.

Daraufhin wird jede Eingabedatei mit der Besitzergruppe OLDGRP im Archiv mit der Besitzergruppe NEUEGRUPPE und der GID NEUEGID gespeichert.

erzwingt die (symbolischen) ÄNDERUNGEN des Modus für hinzugefügte Dateien.
setzt die mtime für hinzugefügte Dateien. DATUM-ODER-DATEI ist entweder Datum/Zeit in einem beinahe willkürlichen Format oder der Name einer existierenden Datei. In letzterem Fall wird die mtime dieser Datei verwendet.
entpackt nicht die Dateiänderungszeit.
hebt die Auswirkung der Option --delay-directory-restore auf.
entpackt Dateien mit dem aufrufenden Benutzer als Besitzer (Voreinstellung für normale Benutzer).
wendet die umask des Benutzers an, wenn Dateirechte aus dem Archiv entpackt werden (Voreinstellung für normale Benutzer).
verwendet immer Zahlen für Benutzer-/Gruppennamen.
erzwingt NAME als Besitzer der hinzugefügten Dateien. Wenn keine UID angegeben ist, kann NAME entweder ein Benutzername oder eine numerische UID sein. In diesem Fall wird der fehlende Teil (UID oder Name) aus der Benutzerdatenbank des aktuellen Rechners ermittelt.

Wenn dies zusammen mit --owner-map=DATEI verwendet wird, wirkt es sich nur auf die Dateien aus, deren Eigentümer nicht in DATEI aufgelistet ist.

liest die Eigentümerabbildungstabelle aus DATEI. Leere Zeilen werden ignoriert. Kommentare werden mit dem Zeichen # eingeleitet und gehen bis zum Zeilenende. Jede nicht leere Zeile in DATEI definiert eine Abbildung für eine einzelne UID. Sie muss aus zwei Feldern bestehen, die mit einer beliebigen Anzahl von Leerraumzeichen getrennt werden: 
ALTERBENUTZER NEUERBENUTZER[:NEUE_UID]

ALTERBENUTZER ist entweder ein gültiger Benutzername oder eine UID, der + vorangestellt ist. Außer wenn NEUE_UID angegeben ist, muss NEUERBENUTZER auch ein gültiger Benutzername oder eine +UID sein. Anderenfalls müssen sowohl ALTERBENUTZER als auch NEUERBENUTZER nicht in der Benutzerdatenbank des Systems enthalten sein.

Im Ergebnis wird jede Eingabedatei, deren Eigentümer ALTERBENUTZER ist, im Archiv mit dem Eigentümer NEUERBENUTZER und der UID NEUE_UID gespeichert.

setzt die Zugriffsrechte der entpackten Dateien genauso, wie sie im Archiv existieren (Voreinstellung für den Administrator).
versucht, Dateien mit denselben Besitzern zu entpacken, wie sie im Archiv existieren (Voreinstellung für den Administrator).
teilt tar mit, dass die Liste der Namen der zu verarbeitenden Dateien auf die gleiche Weise wie die Dateien im Archiv sortiert ist.
sortiert Verzeichniseinträge beim Erstellen eines Archivs anhand der angegebenen REIHENFOLGE, die none, name oder inode sein kann.

Die Voreinstellung ist --sort=none, wobei Archivelemente in der gleichen Reihenfolge gespeichert werden, wie es das Betriebssystem vorgibt.

Die Verwendung von --sort=name stellt sicher, dass die Anordnung der Elemente im erstellten Archiv einheitlich und reproduzierbar ist.

Die Angabe von --sort=inode vermindert beim Erstellen des Archivs die Anzahl von Suchvorgängen auf dem Datenträger und kann so die Archivierung merklich beschleunigen. Diese Reihenfolge wird nur unterstützt, wenn das zugrunde liegende System die erforderlichen Informationen bereitstellt.

aktiviert die POSIX-ACL-Unterstützung.
deaktiviert die POSIX-ACL-Unterstützung.
aktiviert die Unterstützung für SELinux-Kontext.
deaktiviert die Unterstützung für SELinux-Kontext.
aktiviert die Unterstützung für erweiterte Attribute.
deaktiviert die Unterstützung für erweiterte Attribute.
gibt das Ausschlussmuster für Xattr-Schlüssel an. MUSTER ist ein Suchmuster, zum Beispiel schließt --xattrs-exclude='user.*' nur Attribute aus dem Namensraum des Benutzers ein.
gibt das Einbeziehungsmuster für Xattr-Schlüssel an. MUSTER ist ein Suchmuster.

verwendet Archivdatei oder Geräte-ARCHIV. Falls diese Option nicht angegeben ist, wird tar zuerst die Umgebungsvariable »TAPE« prüfen. Falls diese gesetzt ist, wird ihr Wert als Archivname genutzt. Andernfalls wird tar die einkompilierte Vorgabe annehmen. Die Vorgabe kann entweder mit der Option --show-defaults oder am Ende der Ausgabe von tar --help eingesehen werden.

Ein Archivname, der einen Doppelpunkt enthält, bezeichnet eine Datei oder ein Gerät auf einem Rechner in der Ferne. Der Teil vor dem Doppelpunkt ist der Rechnername oder dessen IP-Adresse, der Teil danach ist der Pfad zur Datei oder zum Gerät, zum Beispiel:

--file=remotehost:/dev/sr0

Ein optionaler Benutzername kann dem Rechnernamen vorangestellt werden, wobei ein @ dazwischengesetzt werden muss.

In der Voreinstellung erfolgt der Zugriff auf den Rechner in der Ferne über den Befehl rsh(1). Heutzutage ist es jedoch üblich, stattdessen ssh(1) zu verwenden. Sie erreichen dies mit der folgenden Befehlszeilenoption:

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

Auf der Maschine in der Ferne sollte der Befehl rmt(8) installiert sein. Falls deren Pfadname nicht auf die Vorgabe von tar passt, können sie den korrekten Pfadnamen mit der Option --rmt-command übergeben.

gibt an, dass die Archivdatei lokal ist, selbst wenn sie einen Doppelpunkt enthält.
führt BEFEHL am Ende jedes Bandes aus (impliziert -M). Der Befehl kann Argumente enthalten. Beim Start wird die Umgebung von tar und die zusätzlichen folgenden Variablen geerbt:
Versionsnummer von GNU tar.
Der Name des Archivs, das von tar verarbeitet wird.
Aktueller Block-Faktor, also die Anzahl der 512-Byte-Blöcke in einem Datensatz.
Ordnungszahl des Datenträgers, der von tar verarbeitet wird (wird gesetzt, wenn ein aus mehreren Datenträgern bestehendes Archiv gelesen wird).
Format des verarbeiteten Archivs: gnu, oldgnu, posix, ustar oder v7.
Eine Kurzoption (mit vorangestelltem Minuszeichen), welche die von tar ausgeführte Aktion beschreibt.
Ein Dateideskriptor, der zur Übergabe des neuen Datenträgernamens an tar verwendet werden kann.

Falls das Info-Skript fehlschlägt, beendet sich tar. Anderenfalls beginnt es das Schreiben des nächsten Datenträgers.

Das Band muss nach dem Schreiben von Nx1024 Bytes gewechselt werden. Falls auf N eine Größen-Endung folgt (siehe den Unterabschnitt Größen-Endungen unten), gibt die Endung den multiplikativen Faktor an, der statt 1024 verwendet werden soll.

Diese Option impliziert -M.

erstellt datenträgerüberspannende Archive, listet diese auf oder liest sie aus.
verwendet BEFEHL anstelle von rmt beim Zugriff auf Archive in der Ferne. Siehe die obige Beschreibung der Option -f.
verwendet BEFEHL anstelle von rsh beim Zugriff auf Archive in der Ferne. Siehe die obige Beschreibung der Option -f.
Wird diese Option zusammen mit --multi-volume verwendet, wird tar in DATEI nachverfolgen, an welchem Datenträger eines datenträgerüberspannenden Archivs es gerade arbeitet.

setzt die Datensatzgröße auf BLÖCKEx512 Bytes.
Beim Auflisten oder Auslesen werden unvollständige Eingabedatensätze hinter der Markierung für das Dateiende akzeptiert.
ignoriert genullte Blöcke im Archiv. Normalerweise bedeuten zwei aufeinanderfolgende 512-Blöcke, die mit Nullen gefüllt sind, EOF (Ende der Datei) und tar beendet das Lesen, nachdem es sie angetroffen hat. Diese Option weist es an, weiter zu lesen und ist nützlich, falls Archive mit der Option -A erstellt wurden.
setzt die Datensatzgröße. ZAHL ist die Anzahl der Bytes pro Datensatz. Sie muss ein Vielfaches von 512 sein. Sie kann eine Größenendung angehängt bekommen, z.B. --record-size=10K für 10 Kilobyte. Siehe den Unterabschnitt Größenendungen für eine Liste der gültigen Endungen.

erstellt ein Archiv im angegebenen Format. FORMAT ist eines der folgenden:
GNU Tar 1.13.x-Format
GNU-Format entsprechend Tar <= 1.12
POSIX 1003.1-2001-(Pax)-Format
POSIX 1003.1-1988-(Ustar)-Format
Altes V7-Tar-Format
ist gleichbedeutend mit --format=v7.
steuert beim Erstellen von PAX-Archiven PAX-Schlüsselwörter. Diese Option entspricht der Option -o des pax(1)-Hilfswerkzeugs.
Gleichbedeutend mit --format=posix.
erstellt ein Archiv mit dem Datenträgernamen TEXT. Beim Auflisten oder Entpacken wird TEXT als Suchmuster für den Datenträgernamen verwendet.

verwendet die Archiv-Endung, um das Kompressionsprogramm herauszufinden.
filtert Daten durch BEFEHL. Er muss die Option -d zur Dekompression akzeptieren. Das Argument kann Befehlszeilenoptionen enthalten.
filtert das Archiv mit bzip2(1).
filtert das Archiv mit xz(1).
filtert das Archiv mit lzip(1).
filtert das Archiv mit lzma(1).
filtert das Archiv mit lzop(1).
verwendet nicht die Archiv-Endung, um das Kompressionsprogramm herauszufinden.
filtert das Archiv mit gzip(1).
filtert das Archiv mit compress(1).
filtert das Archiv mit zstd(1).

fügt DATEI zum Archiv hinzu (sinnvoll, wenn der Name mit einem Minuszeichen beginnt).
erstellt Sicherungskopien vor dem Löschen. Falls das Argument CONTROL angegeben ist, steuert es die Sicherung. Zulässige Werte sind:
erstellt niemals Sicherungskopien.
erstellt nummerierte Sicherheitskopien.
nummeriert, wenn bereits nummerierte Sicherheitskopien existieren, sonst einfach.
erstellt immer einfache Sicherheitskopien.

Falls CONTROL nicht angegeben wurde, wird der Wert der Umgebungsvariable VERSION_CONTROL genommen. Falls sie nicht gesetzt ist, wird existing angenommen.

wechselt in VERZ, bevor irgendwelche Operationen ausgeführt werden. Diese Option ist positionsgebunden, das heißt, sie beeinflusst alle Optionen, die darauf folgen.
schließt Dateien aus, die dem MUSTER entsprechen, das ein Platzhalter-Muster im glob(3)-Stil ist.
schließt Sicherungs- und Sperrdateien aus.
schließt den Inhalt von Verzeichnissen aus, die eine Datei namens CACHEDIR.TAG enthalten, mit Ausnahme der Markierungsdatei selbst.
schließt den Inhalt von Verzeichnissen aus, die eine Datei namens CACHEDIR.TAG enthalten, einschließlich der Markierungsdatei selbst.
schließt alles unterhalb von Verzeichnissen aus, die eine Datei namens CACHEDIR.TAG enthalten.
sieht vor der Ausgabe eines Verzeichnisses nach, ob sie DATEI enthält. Ist dies der Fall, werden aus dieser Datei ausschließende Muster gelesen. Die Muster betreffen nur das Verzeichnis selbst.
ist gleichbedeutend mit --exclude-ignore, außer dass die Muster aus DATEI im Verzeichnis selbst und auch allen Unterverzeichnissen gesucht wird.
schließt den Inhalt von Verzeichnissen aus, welche DATEI enthalten, außer DATEI selbst.
schließt Verzeichnisse aus, die die DATEI enthalten.
schließt alles unterhalb des Verzeichnisses aus, das DATEI enthält.
schließt unter Versionsverwaltung stehende Verzeichnisse aus.
schließt Dateien aus, die auf die Muster von den aus Versionsverwaltungssystemen bekannten »ignore«-Dateien passen. Die Dateien .cvsignore, .gitignore, .bzrignore und .hgignore werden unterstützt.
folgt symbolischen Links, archiviert die Dateien und gibt sie aus, auf die sie zeigen.
folgt harten Links, archiviert die Dateien und gibt sie aus, auf die sie sich beziehen.
beginnt beim angegebenen Element im Archiv.
arbeitet mit Dateien, deren Daten nach dem Datum geändert wurden. Falls Datum mit einem / oder . beginnt, wird es als Dateiname genommen. Die Mtime dieser Datei wird als Datum benutzt.
deaktiviert den Effekt der vorherigen Option --null.
verhindert das automatische Hinabsteigen in Verzeichnisstrukturen.
entfernt keine Maskierungen von Eingabedateien oder Elementnamen.
betrachtet jede aus dieser Datei gelesene Zeile so, als sei sie auf der Befehlszeile angegeben worden. Das heißt, führende oder anhängende Leerzeichen werden entfernt, und falls die Zeichenkette mit einem Bindestrich beginnt, wird sie als tar-Befehlszeilenoption angesehen.

Dies ist das Standardverhalten. Die Option --no-verbatim-files-from wird als Möglichkeit zur Wiederherstellung nach der Option --verbatim-files-from bereitgestellt.

Diese Option ist positionsgebunden: Sie betrifft alle --files-from-Optionen, die danach vorkommen, bis entweder die Option --verbatim-files-from oder das Zeilenende erreicht werden.

Dies ist in der Option --no-null impliziert.

weist nachfolgende -T-Optionen an, null-terminierte Namen wortgetreu zu lesen (schaltet die Sonderbehandlung von Namen aus, die mit einem Bindestrich beginnen).

Siehe auch --verbatim-files-from.

speichert nur Dateien, die neuer als DATUM sind. Falls DATUM mit einem / oder . beginnt, wird es als Dateiname genommen. Die Mtime dieser Datei wird als Datum benutzt.
bleibt im lokalen Dateisystem, wenn ein Archiv erstellt wird.
entfernt führende »/« von Dateinamen beim Erstellen von Archiven nicht.
steigt in Verzeichnisstrukturen hinab (Voreinstellung).
legt eine Sicherheitskopie vor dem Löschen an, wobei die übliche Endung überschrieben wird (»~«, sofern nicht von der Umgebungsvariablen SIMPLE_BACKUP_SUFFIX überschrieben).
Ermittelt die auszulesenden oder zu erstellenden Namen aus DATEI.

Falls nicht anders angegeben, muss DATEI eine durch ASCII LF getrennte Liste von Namen enthalten (d.h. ein Name pro Zeile). Die gelesenen Namen werden genauso wie Befehlszeilenargumente behandelt. Bei ihnen werden Maskierungszeichen entfernt und Wörter getrennt und jede Zeichenkette, die mit einem - beginnt, wird als Befehlszeilenoption für tar behandelt.

Falls dieses Verhalten nicht gewünscht ist, kann es mit der Option --verbatim-files-from ausgeschaltet werden.

Die Option --null weist tar an, dass die Namen in DATEI durch das ASCII-NUL-Zeichen statt durch LF getrennt sind. Dies ist hilfreich, falls die Liste mittels der Option -print0 von find(1) erstellt wurde.

entfernt Maskierungszeichen für Dateien oder Elemente (Vorgabe).
behandelt jede Zeile, die aus einer Dateiliste erhalten wurde, als Dateiname, selbst wenn sie mit einem Bindestrich beginnt. Dateilisten werden mit der Option --files-from (-T) übergeben. Das Vorgabeverhalten ist, Namen in der Liste so zu handhaben, als ob sie in der Befehlszeile übergeben worden wären, das heißt Namen, die mit einem Bindestrich beginnen, werden als Optionen von tar behandelt. Die Option --verbatim-files-from deaktiviert dieses Verhalten.

Diese Option betrifft alle Optionen --files-from, die danach in der Befehlszeile auftreten. Sein Effekt wird mit der Option --no-verbatim-files-from rückgängig gemacht.

Diese Option impliziert die Option --null.

Siehe auch --add-file.

schließt Dateien aus, die auf irgendein Muster in DATEI passen.

schneidet ANZAHL führende Komponenten von Dateinamen während des Entpackens ab.
verwendet den sed-AUSDRUCK zum Ersetzen mit, um Dateinamen zu ändern.

Diese Optionen sind sowohl in Einbeziehungs- als auch in Ausschlussmustern wirksam.

Muster passen auf den Anfang des Dateinamens.
ignoriert Groß- oder Kleinschreibung.
Muster passen nach jedem / (Vorgabe für Ausschluss).
Musterprüfung berücksichtigt Groß-/Kleinschreibung (Vorgabe).
Zeichenkettenprüfung erfolgt literal.
Metazeichen passen nicht auf /.
Metazeichen verwenden (Vorgabe für Ausschluss).
Metazeichen passen auf / (Vorgabe für Ausschluss).

gibt Fortschrittsmeldungen bei jedem Nten Datensatz aus (Voreinstellung 10).
führt AKTION bei jedem Kontrollpunkt aus.
setzt nur dann die Zeit, wenn diese neuer als die mit --mtime angegebene Zeit ist.
gibt die Dateizeit in der vollen Auflösung aus.
lenkt die ausführliche Ausgabe in DATEI um.
gibt eine Meldung aus, falls nicht alle Links ausgegeben wurden.
schaltet das Maskieren von Zeichen aus ZEICHENKETTE aus.
maskiert Zeichen aus ZEICHENKETTE zusätzlich.
setzt den Maskierungsstil für Datei- und Elementnamen. Gültige Werte für STIL sind literal, shell, shell-always, c, c-maybe, escape, locale und clocale.
zeigt die Blocknummer innerhalb des Archivs mit jeder Meldung an.
zeigt beim Auflisten oder Entpacken jedes Verzeichnis an, das nicht auf die Suchkriterien passt.
zeigt Datei- oder Archivnamen nach der Umwandlung mit den Optionen --strip und --transform an.
Die Gesamtzahl an Bytes nach dem Verarbeiten des Archivs ausgeben, mit einem Argument - die Gesamtzahl an Bytes wird ausgegeben, wenn dieses SIGNAL geliefert wird. Erlaubte Signale sind: SIGHUP, SIGQUIT, SIGINT, SIGUSR1 und SIGUSR2. Namen ohne das Präfix SIG werden ebenfalls akzeptiert.
gibt Dateiänderungszeiten in UTC aus.
ausführlich die verarbeiteten Dateien aufführen. Jedes Vorkommen dieser Option auf der Befehlszeile erhöht die Ausführlichkeitsstufe um eins. Die maximale Ausführlichkeitsstufe ist 3. Für eine detailliertere Besprechung, wie die verschiedenen Ausführlichkeitsstufen die Ausgabe von tar beeinflussen, lesen Sie bitte das GNU Tar Manual, Unterabschnitt 2.5.1 »The '--verbose' Option«.
aktiviert oder deaktiviert durch SCHLÜSSELWORT identifizierte Warnungsmeldungen. Die Meldungen werden unterdrückt, falls no- vor das SCHLÜSSELWORT gesetzt wird, ansonsten sind sie aktiviert.

Mehrere --warning-Optionen werden zusammengefasst.

Schlüsselwörter, die die allgemeinen Abläufe von tar steuern:

aktiviert sämtliche Warnmeldungen. Dies ist die Voreinstellung.
deaktiviert sämtliche Warnmeldungen.
"%s: gelesener Dateiname enthält das Zeichen Nul."
"Ein einsamer Nullblock bei %s"

Für tar --create anwendbare Schlüsselwörter:

"%s: Enthält eine Zwischenspeicherverzeichnismarkierung %s: %s"
"%s: Datei schrumpfte um %s bytes, wird mit Nullen aufgefüllt."
"%s: Datei ist auf einem anderen Dateisystem; nicht ausgegeben."
"%s: Unbekannter Dateityp; Datei wird ignoriert"
"%s: Socket wird ignoriert"
"%s: Door ignoriert"
"%s: Datei ist unverändert, nicht ausgegeben."
"%s: Archiv kann sich nicht selbst enthalten; nicht gesichert."
"%s: Die Datei wurde entfernt, bevor sie gelesen werden konnte."
"%s: Die Datei wurde während des Lesens geändert."
unterdrückt Warnungen über nicht lesbare Dateien oder Verzeichnisse. Dieses Schlüsselwort gilt nur, falls es zusammen mit der Option --ignore-failed-read verwandt wird.

Für tar --extract verfügbare Schlüsselwörter:

"%s: Existierende Datei wird übersprungen."
"%s: Unplausibler alter Zeitstempel %s."
"%s: Zeitstempel %s ist %s s in der Zukunft."
"Entpacke fortlaufende Dateien als reguläre Dateien"
"versucht, symbolische Links als harte Links zu entpacken."
"%s: Unbekannter Dateityp »%c«, wird als normale Datei entpackt."
"Aktuelle %s ist neuer oder gleichalt."
"Unbekanntes erweitertes Kopfzeilenschlüsselwort »%s« wird ignoriert."
steuert die ausführliche Beschreibung von Fehlern, die beim Versuch auftreten, alternative Entpackprogramme zu verwenden. Diese Warnung ist standardmäßig deaktiviert (außer --verbose wird verwendet). Ein typisches Beispiel dafür, was Sie mit der Verwendung dieser Warnungen erhalten könnten: 
$ tar --warning=decompress-program -x -f archive.Z tar (Kind): Kann compress nicht ausführen: Datei oder Verzeichnis nicht gefunden tar (Kind): Versuche Gzip

Dies bedeutet, dass tar zuerst versuchte, archive.Z mittels compress zu entpacken und als das fehlschlug, auf gzip umstellte.

"Datensatzgröße = %lu Blöcke"

Schlüsselwörter, die die schrittweise Entpackung steuern:

"%s: Verzeichnis wurde aus %s umbenannt"
"%s: Verzeichnis wurde umbenannt"
"%s: Verzeichnis ist neu"
"%s: Verzeichnis liegt auf einem anderen Dateisystem: entferne nicht."
"Fehlgeformtes Verzeichnis für Dump: „X“ nie benutzt"
bittet vor jeder Aktion um eine Bestätigung.

Beim Erstellen identisch zu --old-archive. Beim Auslesen identisch zu --no-same-owner.

Endung	Einheiten	Byte-Äquivalent
b	Blöcke	GRÖSSE x 512
B	Kilobyte	GRÖSSE x 1024
c	Byte	GRÖSSE
G	Gigabyte	GRÖSSE x 1024^3
K	Kilobyte	GRÖSSE x 1024
k	Kilobyte	GRÖSSE x 1024
M	Megabyte	GRÖSSE x 1024^2
P	Petabyte	GRÖSSE x 1024^5
T	Terabyte	GRÖSSE x 1024^4
w	Wörter	GRÖSSE x 2

Der Exit-Code von tar zeigt an, ob es die angefragte Aktion erfolgreich durchführen konnte und falls nicht, welche Art von Fehlern aufgetreten ist.

0
Erfolgreich beendet.
1
Einige Dateien unterscheiden sich. Falls tar mit der Befehlszeilenoption --compare (--diff, -d) aufgerufen wurde, bedeutet dies, dass einige Dateien in dem Archiv sich von ihren Gegenstücken auf der Platte unterscheiden. Falls tar eine der Optionen --create, --append oder --update übergeben wurde, bedeutet dieser Exit-Code, dass sich einige Dateien während der Archivierung geändert haben und daher das Archiv nicht die genaue Kopie der Dateimenge enthält.
2
Fataler Fehler. Dies bedeutet, dass ein fataler, nicht korrigierbarer Fehler auftrat.

Falls ein Unterprozess, der von tar aufgerufen wurde, mit einem von Null verschiedenen Exit-Code beendet wurde, beendet sich tar auch mit diesem Code. Dies kann beispielsweise passieren, falls eine Komprimierungsoption (z.B. -z) verwendet wurde und das externe Komprimierungsprogramm fehlschlug. Ein weiteres Beispiel ist ein Fehlschlag von rmt während der Datensicherung auf ein Gerät in der Ferne.

bzip2(1), compress(1), gzip(1), lzma(1), lzop(1), rmt(8), symlink(7), xz(1), zstd(1).

Vollständiges Handbuch von tar: Führen Sie info tar aus oder verwenden Sie den Info-Modus von emacs(1) zum Lesen.

Online-Versionen der Dokumentation zu GNU tar in verschiedenen Formaten finden Sie hier:


https://www.gnu.org/software/tar/manual

Melden Sie Fehler (auf Englisch) an <bug-tar@gnu.org>.

Copyright © 2023 Free Software Foundation, Inc.
Lizenz GPLv3+: GNU GPL Version 3 oder neuer http://gnu.org/licenses/gpl.html.
Dies ist freie Software: Sie können sie verändern und weitergeben. Es gibt KEINE GARANTIE, soweit gesetzlich zulässig.

ÜBERSETZUNG

Die deutsche Übersetzung dieser Handbuchseite wurde von Dr. Tobias Quathamer <toddy@debian.org>, Mario Blättermann <mario.blaettermann@gmail.com> und Helge Kreutzmann <debian@helgefjell.de> erstellt.

Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.

Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Übersetzer.

11. Juli 2022 TAR