.\" -*- coding: UTF-8 -*-
.\" This file is part of GNU tar. -*- nroff -*-
.\" Copyright 2013-2023 Free Software Foundation, Inc.
.\"
.\" GNU tar is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 3 of the License, or
.\" (at your option) any later version.
.\"
.\" GNU tar is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program. If not, see .
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH TAR 1 "11. Juli 2022" TAR "Handbuch zu GNU TAR"
.SH BEZEICHNUNG
tar \- ein Archivierungswerkzeug
.SH ÜBERSICHT
.SS "Traditioneller Aufruf"
\fBtar\fP {\fBA\fP|\fBc\fP|\fBd\fP|\fBr\fP|\fBt\fP|\fBu\fP|\fBx\fP}[\fBGnSkUWOmpsMBiajJzZhPlRvwo\fP]
[\fIARG\fP …]
.SS "Aufruf im UNIX\-Stil"
.sp
\fBtar\fP \fB\-A\fP [\fIOPTIONEN\fP] \fB\-f\fP \fIARCHIV\fP \fIARCHIV\fP …
.sp
\fBtar\fP \fB\-c\fP [\fB\-f\fP \fIARCHIV\fP] [\fIOPTIONEN\fP] [\fIDATEI\fP …]
.sp
\fBtar\fP \fB\-d\fP [\fB\-f\fP \fIARCHIV\fP] [\fIOPTIONEN\fP] [\fIDATEI\fP …]
.sp
\fBtar\fP \fB\-r\fP [\fB\-f\fP \fIARCHIV\fP] [\fIOPTIONEN\fP] [\fIDATEI\fP …]
.sp
\fBtar\fP \fB\-t\fP [\fB\-f\fP \fIARCHIV\fP] [\fIOPTIONEN\fP] [\fIELEMENT\fP …]
.sp
\fBtar\fP \fB\-u\fP [\fB\-f\fP \fIARCHIV\fP] [\fIOPTIONEN\fP] [\fIDATEI\fP …]
.sp
\fBtar\fP \fB\-x\fP [\fB\-f\fP \fIARCHIV\fP] [\fIOPTIONEN\fP] [\fIELEMENT\fP …]
.SS "Aufruf im GNU\-Stil"
.sp
\fBtar\fP {\fB\-\-catenate\fP|\fB\-\-concatenate\fP} [\fIOPTIONEN\fP] \fB\-\-file\fP \fIARCHIV\fP
\fIARCHIV\fP …
.sp
\fBtar\fP \fB\-\-create\fP [\fB\-\-file\fP \fIARCHIV\fP] [\fIOPTIONEN\fP] [\fIDATEI\fP …]
.sp
\fBtar\fP {\fB\-\-diff\fP|\fB\-\-compare\fP} [\fB\-\-file\fP \fIARCHIV\fP] [\fIOPTIONEN\fP]
[\fIDATEI\fP ]
.sp
\fBtar\fP \fB\-\-delete\fP [\fB\-\-file\fP \fIARCHIV\fP] [\fIOPTIONEN\fP] [\fIELEMENT\fP …]
.sp
\fBtar\fP \fB\-\-append\fP [\fB\-\-file\fP \fIARCHIV\fP] [\fIOPTIONEN\fP] [\fIDATEI\fP …]
.sp
\fBtar\fP \fB\-\-list\fP [\fB\-\-file\fP \fIARCHIV\fP] [\fIOPTIONEN\fP] [\fIELEMENT\fP …]
.sp
\fBtar\fP \fB\-\-test\-label\fP [\fB\-\-file\fP \fIARCHIV\fP] [\fIOPTIONEN\fP] [\fIBEZEICHNUNG\fP
…]
.sp
\fBtar\fP \fB\-\-update\fP [\fB\-\-file\fP \fIARCHIV\fP] [\fIOPTIONEN\fP] [\fIDATEI\fP …]
.sp
\fBtar\fP {\fB\-\-extract\fP|\fB\-\-get\fP} [\fB\-\-file\fP \fIARCHIV\fP] [\fIOPTIONEN\fP]
[\fIELEMENT\fP …]
.SH ANMERKUNGEN
Diese Handbuchseite ist eine Kurzbeschreibung von GNU \fBtar\fP. Detailliertere
Erläuterungen einschließlich Beispielen und Empfehlungen für Befehlsaufrufe
finden Sie im \fBGNU Tar Manual\fP im Texinfo\-Format. Wenn das Anzeigeprogramm
\fBinfo\fP(1) und die Dokumentation zu Tar auf Ihrem System korrekt installiert
sind, können Sie mit dem Befehl
.PP
.RS +4
\fBinfo tar\fP
.RE
.PP
auf das vollständige Handbuch zugreifen.
.PP
Sie können das Handbuch auch im Info\-Modus in \fBemacs\fP(1)
betrachten. Weiterhin finden Sie verschiedene Formate online auf
.PP
.RS +4
\fBhttps://www.gnu.org/software/tar/manual\fP
.RE
.PP
Falls Sie in dieser Handbuchseite und dem \fBGNU Tar Manual\fP unterschiedliche
Aussagen entdecken, sollte Letzteres als Referenzquelle anerkannt werden.
.SH BESCHREIBUNG
GNU \fBtar\fP ist ein Archivprogramm, das mit dem Ziel entwickelt wird, mehrere
Dateien in einer einzigen Datei zu speichern (einem \fBArchiv\fP) 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 \fBt\fPape \fBar\fPchiver steht), das sich auf einem
lokalen Rechner oder auch einem Rechner im Netz befinden kann.
.PP
.SS Optionsstile
Die Optionen können an \fBtar\fP auf drei verschiedene Arten übergeben
werden. Im \fBtraditionellen Stil\fP 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.
.PP
Beispielsweise erfordert die Option \fBc\fP die Erstellung eines Archives, die
Option \fBv\fP ausführliche Ausgaben, und die Option \fBf\fP erwartet ein
Argument, das den Namen des Archivs angibt, das verarbeitet werden soll. Der
folgende Befehl im traditionellen Stil weist \fBtar\fP an, alle Dateien aus dem
Verzeichnis \fB/etc\fP in die Archivdatei \fBetc.tar\fP zu packen, wobei die
archivierten Dateien ausführlich aufgelistet werden:
.PP
.EX
tar cfv etc.tar /etc
.EE
.PP
Im \fBUNIX \fPoder\fB Kurzoptions\-Stil\fP 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 \fBoptionales\fP
Argument akzeptiert, muss das Argument ohne Leerzeichen direkt auf den
Optionsbuchstaben folgen, zum Beispiel wie in \fB\-g/tmp/snar.db\fP.
.PP
Eine beliebige Anzahl von Optionen, die keine Argumente akzeptieren, können
nach einem einzelnen Minuszeichen zusammengefasst werden, zum Beispiel
\fB\-vkp\fP. Eine Option, die ein Argument akzeptiert (egal ob obligatorisch
oder optional), kann am Ende angehängt werden, zum Beispiel \fB\-vkpf a.tar\fP.
.PP
Der obige Beispielbefehl könnte im \fBKurzoptions\-Stil\fP folgendermaßen
aussehen:
.PP
.EX
tar \-cvf etc.tar /etc
.EE
oder
.EX
tar \-c \-v \-f etc.tar /etc
.EE
.PP
Im \fBGNU \fPoder\fB Langoptions\-Stil\fP 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.
.PP
Nachfolgend finden Sie verschiedene Möglichkeiten des Beispielbefehls in
diesem Stil:
.PP
.EX
tar \-\-create \-\-file etc.tar \-\-verbose /etc
.EE
oder (durch Abkürzung einiger Optionen):
.EX
tar \-\-cre \-\-file=etc.tar \-\-verb /etc
.EE
.PP
Die Optionen in allen drei Stilen können miteinander gemischt werden. Dies
wird mit alten Optionen jedoch nicht empfohlen.
.SS Betriebsmodus
Die in der nachfolgenden Tabelle aufgelisteten Optionen weisen \fBtar\fP 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.
.TP
\fB\-A\fP, \fB\-\-catenate\fP, \fB\-\-concatenate\fP
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
\fBtar\fP 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 \fB\-i\fP
(\fB\-\-ignore\-zeros\fP) angegeben wird.
Komprimierte Archive können nicht verkettet werden.
.TP
\fB\-c\fP, \fB\-\-create\fP
erstellt ein neues Archiv. Argumente werden als Namen der zu archivierenden
Dateien aufgefasst. Verzeichnisse werden rekursiv archiviert, außer wenn die
Option \fB\-\-no\-recursion\fP angegeben ist.
.TP
\fB\-d\fP, \fB\-\-diff\fP, \fB\-\-compare\fP
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.
.TP
\fB\-\-delete\fP
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.
.TP
\fB\-r\fP, \fB\-\-append\fP
hängt Dateien am Ende eines Archivs an. Die Argumente sind gleichbedeutend
mit jenen für \fB\-c\fP (\fB\-\-create\fP).
.TP
\fB\-t\fP, \fB\-\-list\fP
listet den Inhalt eines Archivs auf. Argumente sind optional. Wenn
angegeben, bezeichnen diese die Namen der aufzulistenden Argumente.
.TP
\fB\-\-test\-label\fP
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 \fB0\fP
beendet. Wenn eines oder mehrere Befehlszeilenargumente angegeben sind,
vergleicht \fBtar\fP die Datenträgerbezeichnung mit jedem Argument. Es wird mit
dem Exit\-Code \fB0\fP beendet, falls eine Übereinstimmung gefunden wird,
anderenfalls mit \fB1\fP. Es erfolgt nur dann eine Ausgabe, wenn die Option
\fB\-v\fP (\fB\-\-verbose\fP) übergeben wurde.
Für diese Option gibt es keine entsprechende kurze Option.
.TP
\fB\-u\fP, \fB\-\-update\fP
hängt Dateien, die neuer als die entsprechende Kopie in dem Archiv sind,
an. Die Argumente haben die gleiche Bedeutung wie bei den Optionen \fB\-c\fP und
\fB\-r\fP. 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.
.TP
\fB\-x\fP, \fB\-\-extract\fP, \fB\-\-get\fP
entpackt Dateien aus einem Archiv. Argumente sind optional. Wenn angegeben,
bezeichnen sie die Namen der Elemente, die aus dem Archiv entpackt werden
sollen.
.TP
.TP
\fB\-\-show\-defaults\fP
zeigt die eingebauten Voreinstellungen für verschiedene Optionen von \fBtar\fP
an und beendet das Programm.
.TP
\fB\-?\fP, \fB\-\-help\fP
zeigt eine kurze Zusammenfassung der Optionen an und beendet das Programm.
.TP
\fB\-\-usage\fP
zeigt eine Liste der verfügbaren Optionen an und beendet das Programm.
.TP
\fB\-\-version\fP
zeigt Versions\- und Urheberrechtsinformationen an und beendet das Programm.
.SH OPTIONEN
.SS Aktionsattribute
.TP
\fB\-\-check\-device\fP
überprüft Gerätenummern, wenn inkrementelle Archive erstellt werden
(Voreinstellung).
.TP
\fB\-g\fP, \fB\-\-listed\-incremental\fP=\fIDATEI\fP
verarbeitet inkrementelle Sicherungen im neuen GNU\-Format. \fIDATEI\fP ist der
Name einer \fBSchnappschuss\-Datei\fP, wo \fBtar\fP 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 \fIDATEI\fP bei der
Erstellung eines Archivs nicht existiert, wird sie angelegt und alle Dateien
zum sich ergebenden Archiv hinzugefügt werden (die Speicherung der \fBStufe 0\fP). Um inkrementelle Archive der von Null verschiedenen Stufe \fBN\fP zu
erzeugen, erstellen Sie eine Kopie der Schnappschuss\-Datei während der Stufe
\fBN\-1\fP und verwenden Sie diese als \fIDATEI\fP.
Beim Auflisten oder Entpacken wird der tatsächliche Inhalt der \fIDATEI\fP
nicht untersucht, es ist nur aus syntaktischen Erfordernissen nötig. Daher
wird häufig \fB/dev/null\fP verwendet.
.TP
\fB\-\-hole\-detection\fP=\fIMETHODE\fP
verwendet die angegebene \fIMETHODE\fP zum Finden von Lücken in
Sparse\-Dateien. Diese Option impliziert \fB\-\-sparse\fP. Gültige Werte für
\fIMETHODE\fP sind \fBseek\fP and \fBraw\fP. In der Voreinstellung wird \fBseek\fP
benutzt, anderenfalls wird auf \fBraw\fP ausgewichen, wenn \fBseek\fP nicht
anwendbar ist.
.TP
\fB\-G\fP, \fB\-\-incremental\fP
verwendet das alte GNU\-Format für inkrementelle Sicherheitskopien.
.TP
\fB\-\-ignore\-failed\-read\fP
beendet bei nicht lesbaren Dateien nicht mit einem Rückgabewert ungleich
Null.
.TP
\fB\-\-level\fP=\fIZAHL\fP
legt die Speicherstufe für erzeugte »listed\-incremental«\-Archive
fest. Gegenwärtig ist nur \fB\-\-level=0\fP von Bedeutung: Es weist \fBtar\fP an,
den Schnappschuss vor der Ausgabe zu kürzen, wobei die Stufe 0 erzwungen
wird.
.TP
\fB\-n\fP, \fB\-\-seek\fP
nimmt an, dass das Archiv durchsuchbar ist. Normalerweise ermittelt \fBtar\fP
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 \fB\-\-list\fP oder \fB\-\-extract\fP).
.TP
\fB\-\-no\-check\-device\fP
überprüft Gerätenummern nicht, wenn inkrementelle Archive erstellt werden.
.TP
\fB\-\-no\-seek\fP
nimmt an, dass das Archiv nicht durchsuchbar ist.
.TP
\fB\-\-occurrence\fP[=\fIN\fP]
verarbeitet nur jedes \fIN\fP\-te Vorkommen jeder Datei im Archiv. Diese Option
ist nur in Verbindung mit einem der Unterbefehle \fB\-\-delete\fP, \fB\-\-diff\fP,
\fB\-\-extract\fP oder \fB\-\-list\fP gültig, und wenn eine Liste von Dateien entweder
in der Befehlszeile oder mit der Option \fB\-T\fP angegeben ist. Die Vorgabe für
\fIN\fP ist \fB1\fP.
.TP
\fB\-\-restrict\fP
schaltet die Verwendung von einigen potenziell schädlichen Optionen aus.
.TP
\fB\-\-sparse\-version\fP=\fIMAJOR\fP[.\fIMINOR\fP]
legt die Version des zu verwendenden Sparse\-Formats fest. Diese Option
impliziert \fB\-\-sparse\fP. Zulässige Werte für Argumente sind \fB0.0\fP, \fB0.1\fP
und \fB1.0\fP. Detaillierte Erläuterungen zu den Sparse\-Formaten finden Sie im
\fBGNU Tar Manual\fP, Anhang \fBD\fP, »\fBSparse Formats\fP«. Mit dem Anzeigeprogramm
\fBinfo\fP können Sie es mit dem folgenden Befehl aufrufen: \fBinfo tar 'Sparse Formats'\fP.
.TP
\fB\-S\fP, \fB\-\-sparse\fP
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 \fBDBM\fP angelegte Datenbankdateien). Wenn diese Option
angegeben ist, versucht \fBtar\fP 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.
.SS "Regeln beim Überschreiben"
Diese Optionen regeln das Verhalten von \fBtar\fP beim Entpacken einer Datei
über eine vorhandene Kopie auf einem Datenträger.
.TP
\fB\-k\fP, \fB\-\-keep\-old\-files\fP
ersetzt existierende Dateien beim Entpacken nicht.
.TP
\fB\-\-keep\-newer\-files\fP
ersetzt existierende Dateien nicht, die neuer als ihre Kopie im Archiv sind.
.TP
\fB\-\-keep\-directory\-symlink\fP
ersetzt existierende Symlinks auf Verzeichnisse beim Entpacken nicht.
.TP
\fB\-\-no\-overwrite\-dir\fP
behält die Metadaten von existierenden Verzeichnissen.
.TP
\fB\-\-one\-top\-level\fP[\fB=\fP\fIVERZ\fP]
entpackt alle Dateien in \fIVERZ\fP, oder wenn es ohne Argument angegeben wird,
in ein Unterverzeichnis, das nach dem Basisnamen des Archivs benannt wird
(ohne die Standard\-Kompressionserweiterungen, die von \fB\-\-auto\-compress\fP
erkannt werden können).
.TP
\fB\-\-overwrite\fP
überschreibt existierende Dateien beim Entpacken.
.TP
\fB\-\-overwrite\-dir\fP
überschreibt Metadaten von existierenden Verzeichnissen beim Entpacken
(Voreinstellung).
.TP
\fB\-\-recursive\-unlink\fP
löscht alle Dateien im Verzeichnis vor dem Entpacken rekursiv.
.TP
\fB\-\-remove\-files\fP
löscht Dateien vom Datenträger, nachdem sie zum Archiv hinzugefügt wurden.
.TP
\fB\-\-skip\-old\-files\fP
ersetzt existierende Dateien beim Entpacken nicht, sie werden ohne Meldung
übersprungen.
.TP
\fB\-U\fP, \fB\-\-unlink\-first\fP
löscht jede Datei, bevor sie beim Entpacken überschrieben wird.
.TP
\fB\-W\fP, \fB\-\-verify\fP
überprüft das Archiv nach dem Schreiben.
.SS "Wahl des Ausgabe\-Datenstroms"
.TP
\fB\-\-ignore\-command\-error\fP
ignoriert die Exit\-Codes von Unterprozessen.
.TP
\fB\-\-no\-ignore\-command\-error\fP
behandelt Rückgabewerte ungleich Null von Kindprozessen als Fehler
(Voreinstellung).
.TP
\fB\-O\fP, \fB\-\-to\-stdout\fP
entpackt Dateien in die Standardausgabe.
.TP
\fB\-\-to\-command\fP=\fIBEFEHL\fP
leitet die entpackten Dateien an \fIBEFEHL\fP 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:
.RS
.TP
\fBTAR_FILETYPE\fP
Der Dateityp ist ein einzelner Buchstabe folgender Bedeutung:
.sp
.nf
.ta 8n 20n
f Reguläre Datei
d Verzeichnis
l Symbolischer Link
h Hardlink
b Blockorientiertes Gerät
c Zeichenorientiertes Gerät
.fi
Gegenwärtig werden nur reguläre Dateien unterstützt.
.TP
\fBTAR_MODE\fP
Der Dateimodus als Oktalzahl.
.TP
\fBTAR_FILENAME\fP
Der Name der Datei.
.TP
\fBTAR_REALNAME\fP
Der Name der Datei, so wie sie im Archiv gespeichert ist.
.TP
\fBTAR_UNAME\fP
Name des Besitzers der Datei.
.TP
\fBTAR_GNAME\fP
Name der Gruppe des Besitzers der Datei.
.TP
\fBTAR_ATIME\fP
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.
.TP
\fBTAR_MTIME\fP
Zeitpunkt der letzten Änderung.
.TP
\fBTAR_CTIME\fP
Zeitpunkt der letzten Statusänderung.
.TP
\fBTAR_SIZE\fP
Größe der Datei.
.TP
\fBTAR_UID\fP
UID (Benutzerkennung) des Besitzers der Datei.
.TP
\fBTAR_GID\fP
GID (Gruppenkennung) des Besitzers der Datei.
.RE
.RS
Zusätzlich enthalten die folgenden Variablen Informationen über den
Aktionsmodus von \fBtar\fP und das zu verarbeitende Archiv:
.TP
\fBTAR_VERSION\fP
Versionsnummer von GNU \fBtar\fP.
.TP
\fBTAR_ARCHIVE\fP
Der Name des Archivs, das von \fBtar\fP verarbeitet wird.
.TP
\fBTAR_BLOCKING_FACTOR\fP
Aktueller Block\-Faktor, also die Anzahl der 512\-Byte\-Blöcke in einem
Datensatz.
.TP
\fBTAR_VOLUME\fP
Ordnungszahl des Datenträgers, der von \fBtar\fP verarbeitet wird (wird
gesetzt, wenn ein aus mehreren Datenträgern bestehendes Archiv gelesen
wird).
.TP
\fBTAR_FORMAT\fP
Format des verarbeiteten Archivs: \fBgnu\fP, \fBoldgnu\fP, \fBposix\fP, \fBustar\fP oder
\fBv7\fP.
.TP
\fBTAR_SUBCOMMAND\fP
Eine Kurzoption (mit vorangestelltem Minuszeichen), welche die von \fBtar\fP
ausgeführte Aktion beschreibt.
.RE
.SS "Umgang mit Dateiattributen"
.TP
\fB\-\-atime\-preserve\fP[=\fIMETHODE\fP]
erhält Zugriffszeiten für ausgegebene Dateien, entweder durch
Wiederherstellen der Zeiten nach dem Lesen (\fIMETHODE\fP=\fBreplace\fP; Vorgabe)
oder durch Nicht\-Setzen der Zeiten (\fIMETHODE\fP=\fBsystem\fP).
.TP
\fB\-\-delay\-directory\-restore\fP
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.
.TP
\fB\-\-group\fP=\fINAME\fP[:\fIGID\fP]
erzwingt \fINAME\fP als Gruppenname für hinzugefügte Dateien. Wenn \fIGID\fP nicht
angegeben ist, kann \fINAME\fP 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 \fB\-\-group\-map\fP=\fIDATEI\fP verwendet wird, wirkt es sich
nur auf jene Dateien aus, deren Gruppe nicht in \fIDATEI\fP aufgelistet ist.
.TP
\fB\-\-group\-map\fP=\fIDATEI\fP
liest die Übersetzung der Gruppenzuordnung aus \fIDATEI\fP. Leerzeilen werden
dabei ignoriert. Kommentare werden mit einem \fB#\fP\-Zeichen eingeleitet und
erstrecken sich bis zum Ende der Zeile. Jede nicht\-leere Zeile in \fIDATEI\fP
definiert die Übersetzung für eine einzelne Gruppe. Sie muss aus zwei
Feldern bestehen, die durch eine beliebige Anzahl Leerzeichen getrennt sind:
.EX
\fIALTEGRUPPE\fP \fINEUEGRUPPE\fP[\fB:\fP\fINEUEGID\fP]
.EE
\fIALTEGRUPPE\fP ist entweder ein gültiger Gruppenname oder eine GID, der ein
\fB+\fP vorangestellt ist. Außer wenn \fINEUEGID\fP angegeben ist, muss
\fINEUEGRUPPE\fP auch entweder ein gültiger Gruppenname oder ein \fB+\fP\fIGID\fP
sein. Anderenfalls müssen sowohl \fINEUEGRUPPE\fP als auch \fINEUEGID\fP nicht in
der Gruppendatenbank des Systems enthalten sein.
Daraufhin wird jede Eingabedatei mit der Besitzergruppe \fIOLDGRP\fP im Archiv
mit der Besitzergruppe \fINEUEGRUPPE\fP und der GID \fINEUEGID\fP gespeichert.
.TP
\fB\-\-mode\fP=\fIÄNDERUNGEN\fP
erzwingt die (symbolischen) \fIÄNDERUNGEN\fP des Modus für hinzugefügte
Dateien.
.TP
\fB\-\-mtime\fP=\fIDATUM\-ODER\-DATEI\fP
setzt die \fBmtime\fP für hinzugefügte Dateien. \fIDATUM\-ODER\-DATEI\fP ist
entweder Datum/Zeit in einem beinahe willkürlichen Format oder der Name
einer existierenden Datei. In letzterem Fall wird die \fBmtime\fP dieser Datei
verwendet.
.TP
\fB\-m\fP, \fB\-\-touch\fP
entpackt nicht die Dateiänderungszeit.
.TP
\fB\-\-no\-delay\-directory\-restore\fP
hebt die Auswirkung der Option \fB\-\-delay\-directory\-restore\fP auf.
.TP
\fB\-\-no\-same\-owner\fP
entpackt Dateien mit dem aufrufenden Benutzer als Besitzer (Voreinstellung
für normale Benutzer).
.TP
\fB\-\-no\-same\-permissions\fP
wendet die umask des Benutzers an, wenn Dateirechte aus dem Archiv entpackt
werden (Voreinstellung für normale Benutzer).
.TP
\fB\-\-numeric\-owner\fP
verwendet immer Zahlen für Benutzer\-/Gruppennamen.
.TP
\fB\-\-owner\fP=\fINAME\fP[:\fIUID\fP]
erzwingt \fINAME\fP als Besitzer der hinzugefügten Dateien. Wenn keine \fIUID\fP
angegeben ist, kann \fINAME\fP 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 \fB\-\-owner\-map\fP=\fIDATEI\fP verwendet wird, wirkt es sich
nur auf die Dateien aus, deren Eigentümer nicht in \fIDATEI\fP aufgelistet ist.
.TP
\fB\-\-owner\-map\fP=\fIDATEI\fP
liest die Eigentümerabbildungstabelle aus \fIDATEI\fP. Leere Zeilen werden
ignoriert. Kommentare werden mit dem Zeichen \fB#\fP eingeleitet und gehen bis
zum Zeilenende. Jede nicht leere Zeile in \fIDATEI\fP definiert eine Abbildung
für eine einzelne UID. Sie muss aus zwei Feldern bestehen, die mit einer
beliebigen Anzahl von Leerraumzeichen getrennt werden:
.EX
\fIALTERBENUTZER\fP \fINEUERBENUTZER\fP[\fB:\fP\fINEUE_UID\fP]
.EE
\fIALTERBENUTZER\fP ist entweder ein gültiger Benutzername oder eine UID, der
\fB+\fP vorangestellt ist. Außer wenn \fINEUE_UID\fP angegeben ist, muss
\fINEUERBENUTZER\fP auch ein gültiger Benutzername oder eine \fB+\fP\fIUID\fP
sein. Anderenfalls müssen sowohl \fIALTERBENUTZER\fP als auch \fINEUERBENUTZER\fP
nicht in der Benutzerdatenbank des Systems enthalten sein.
Im Ergebnis wird jede Eingabedatei, deren Eigentümer \fIALTERBENUTZER\fP ist,
im Archiv mit dem Eigentümer \fINEUERBENUTZER\fP und der UID \fINEUE_UID\fP
gespeichert.
.TP
\fB\-p\fP, \fB\-\-preserve\-permissions\fP, \fB\-\-same\-permissions\fP
setzt die Zugriffsrechte der entpackten Dateien genauso, wie sie im Archiv
existieren (Voreinstellung für den Administrator).
.TP
\fB\-\-same\-owner\fP
versucht, Dateien mit denselben Besitzern zu entpacken, wie sie im Archiv
existieren (Voreinstellung für den Administrator).
.TP
\fB\-s\fP, \fB\-\-preserve\-order\fP, \fB\-\-same\-order\fP
teilt \fBtar\fP mit, dass die Liste der Namen der zu verarbeitenden Dateien auf
die gleiche Weise wie die Dateien im Archiv sortiert ist.
.TP
\fB\-\-sort=\fP\fIREIHENFOLGE\fP
sortiert Verzeichniseinträge beim Erstellen eines Archivs anhand der
angegebenen \fIREIHENFOLGE\fP, die \fBnone\fP, \fBname\fP oder \fBinode\fP sein kann.
Die Voreinstellung ist \fB\-\-sort=none\fP, wobei Archivelemente in der gleichen
Reihenfolge gespeichert werden, wie es das Betriebssystem vorgibt.
Die Verwendung von \fB\-\-sort=name\fP stellt sicher, dass die Anordnung der
Elemente im erstellten Archiv einheitlich und reproduzierbar ist.
Die Angabe von \fB\-\-sort=inode\fP 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.
.SS "Erweiterte Dateiattribute"
.TP
\fB\-\-acls\fP
aktiviert die POSIX\-ACL\-Unterstützung.
.TP
\fB\-\-no\-acls\fP
deaktiviert die POSIX\-ACL\-Unterstützung.
.TP
\fB\-\-selinux\fP
aktiviert die Unterstützung für SELinux\-Kontext.
.TP
\fB\-\-no\-selinux\fP
deaktiviert die Unterstützung für SELinux\-Kontext.
.TP
\fB\-\-xattrs\fP
aktiviert die Unterstützung für erweiterte Attribute.
.TP
\fB\-\-no\-xattrs\fP
deaktiviert die Unterstützung für erweiterte Attribute.
.TP
\fB\-\-xattrs\-exclude=\fP\fIMUSTER\fP
gibt das Ausschlussmuster für Xattr\-Schlüssel an. \fIMUSTER\fP ist ein
Suchmuster, zum Beispiel schließt \fB\-\-xattrs\-exclude='user.*'\fP nur Attribute
aus dem Namensraum des Benutzers ein.
.TP
\fB\-\-xattrs\-include=\fP\fIMUSTER\fP
gibt das Einbeziehungsmuster für Xattr\-Schlüssel an. \fIMUSTER\fP ist ein
Suchmuster.
.SS "Geräteauswahl und \-wechsel"
.TP
\fB\-f\fP, \fB\-\-file\fP=\fIARCHIV\fP
verwendet Archivdatei oder Geräte\-\fIARCHIV\fP. Falls diese Option nicht
angegeben ist, wird \fBtar\fP zuerst die Umgebungsvariable »TAPE« prüfen. Falls
diese gesetzt ist, wird ihr Wert als Archivname genutzt. Andernfalls wird
\fBtar\fP die einkompilierte Vorgabe annehmen. Die Vorgabe kann entweder mit
der Option \fB\-\-show\-defaults\fP oder am Ende der Ausgabe von \fBtar \-\-help\fP
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:
.EX
\-\-file=remotehost:/dev/sr0
.EE
Ein optionaler Benutzername kann dem Rechnernamen vorangestellt werden,
wobei ein \fB@\fP dazwischengesetzt werden muss.
In der Voreinstellung erfolgt der Zugriff auf den Rechner in der Ferne über
den Befehl \fBrsh\fP(1). Heutzutage ist es jedoch üblich, stattdessen \fBssh\fP(1)
zu verwenden. Sie erreichen dies mit der folgenden Befehlszeilenoption:
.EX
\-\-rsh\-command=/usr/bin/ssh
.EE
Auf der Maschine in der Ferne sollte der Befehl \fBrmt\fP(8) installiert
sein. Falls deren Pfadname nicht auf die Vorgabe von \fBtar\fP passt, können
sie den korrekten Pfadnamen mit der Option \fB\-\-rmt\-command\fP übergeben.
.TP
\fB\-\-force\-local\fP
gibt an, dass die Archivdatei lokal ist, selbst wenn sie einen Doppelpunkt
enthält.
.TP
\fB\-F\fP, \fB\-\-info\-script\fP=\fIBEFEHL\fP, \fB\-\-new\-volume\-script\fP=\fIBEFEHL\fP
führt \fIBEFEHL\fP am Ende jedes Bandes aus (impliziert \fB\-M\fP). Der Befehl kann
Argumente enthalten. Beim Start wird die Umgebung von \fBtar\fP und die
zusätzlichen folgenden Variablen geerbt:
.RS
.TP
\fBTAR_VERSION\fP
Versionsnummer von GNU \fBtar\fP.
.TP
\fBTAR_ARCHIVE\fP
Der Name des Archivs, das von \fBtar\fP verarbeitet wird.
.TP
\fBTAR_BLOCKING_FACTOR\fP
Aktueller Block\-Faktor, also die Anzahl der 512\-Byte\-Blöcke in einem
Datensatz.
.TP
\fBTAR_VOLUME\fP
Ordnungszahl des Datenträgers, der von \fBtar\fP verarbeitet wird (wird
gesetzt, wenn ein aus mehreren Datenträgern bestehendes Archiv gelesen
wird).
.TP
\fBTAR_FORMAT\fP
Format des verarbeiteten Archivs: \fBgnu\fP, \fBoldgnu\fP, \fBposix\fP, \fBustar\fP oder
\fBv7\fP.
.TP
\fBTAR_SUBCOMMAND\fP
Eine Kurzoption (mit vorangestelltem Minuszeichen), welche die von \fBtar\fP
ausgeführte Aktion beschreibt.
.TP
\fBTAR_FD\fP
Ein Dateideskriptor, der zur Übergabe des neuen Datenträgernamens an \fBtar\fP
verwendet werden kann.
.RE
.RS
Falls das Info\-Skript fehlschlägt, beendet sich \fBtar\fP. Anderenfalls beginnt
es das Schreiben des nächsten Datenträgers.
.RE
.TP
\fB\-L\fP, \fB\-\-tape\-length\fP=\fIN\fP
Das Band muss nach dem Schreiben von \fIN\fPx1024 Bytes gewechselt
werden. Falls auf \fIN\fP eine Größen\-Endung folgt (siehe den Unterabschnitt
\fBGrößen\-Endungen\fP unten), gibt die Endung den multiplikativen Faktor an,
der statt 1024 verwendet werden soll.
Diese Option impliziert \fB\-M\fP.
.TP
\fB\-M\fP, \fB\-\-multi\-volume\fP
erstellt datenträgerüberspannende Archive, listet diese auf oder liest sie
aus.
.TP
\fB\-\-rmt\-command\fP=\fIBEFEHL\fP
verwendet \fIBEFEHL\fP anstelle von \fBrmt\fP beim Zugriff auf Archive in der
Ferne. Siehe die obige Beschreibung der Option \fB\-f\fP.
.TP
\fB\-\-rsh\-command\fP=\fIBEFEHL\fP
verwendet \fIBEFEHL\fP anstelle von \fBrsh\fP beim Zugriff auf Archive in der
Ferne. Siehe die obige Beschreibung der Option \fB\-f\fP.
.TP
\fB\-\-volno\-file\fP=\fIDATEI\fP
Wird diese Option zusammen mit \fB\-\-multi\-volume\fP verwendet, wird \fBtar\fP in
\fIDATEI\fP nachverfolgen, an welchem Datenträger eines
datenträgerüberspannenden Archivs es gerade arbeitet.
.SS "Blockeinteilung von Geräten"
.TP
\fB\-b\fP, \fB\-\-blocking\-factor\fP=\fIBLÖCKE\fP
setzt die Datensatzgröße auf \fIBLÖCKE\fPx\fB512\fP Bytes.
.TP
\fB\-B\fP, \fB\-\-read\-full\-records\fP
Beim Auflisten oder Auslesen werden unvollständige Eingabedatensätze hinter
der Markierung für das Dateiende akzeptiert.
.TP
\fB\-i\fP, \fB\-\-ignore\-zeros\fP
ignoriert genullte Blöcke im Archiv. Normalerweise bedeuten zwei
aufeinanderfolgende 512\-Blöcke, die mit Nullen gefüllt sind, EOF (Ende der
Datei) und \fBtar\fP 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 \fB\-A\fP erstellt wurden.
.TP
\fB\-\-record\-size\fP=\fIZAHL\fP
setzt die Datensatzgröße. \fIZAHL\fP ist die Anzahl der Bytes pro
Datensatz. Sie muss ein Vielfaches von \fB512\fP sein. Sie kann eine
\fBGrößenendung\fP angehängt bekommen, z.B. \fB\-\-record\-size=10K\fP für 10
Kilobyte. Siehe den Unterabschnitt \fBGrößenendungen\fP für eine Liste der
gültigen Endungen.
.SS "Auswahl des Archivformats"
.TP
\fB\-H\fP, \fB\-\-format\fP=\fIFORMAT\fP
erstellt ein Archiv im angegebenen Format. FORMAT ist eines der folgenden:
.RS
.TP
\fBgnu\fP
GNU Tar 1.13.x\-Format
.TP
\fBoldgnu\fP
GNU\-Format entsprechend Tar <= 1.12
.TP
\fBpax\fP, \fBposix\fP
POSIX 1003.1\-2001\-(Pax)\-Format
.TP
\fBustar\fP
POSIX 1003.1\-1988\-(Ustar)\-Format
.TP
\fBv7\fP
Altes V7\-Tar\-Format
.RE
.TP
\fB\-\-old\-archive\fP, \fB\-\-portability\fP
ist gleichbedeutend mit \fB\-\-format=v7\fP.
.TP
\fB\-\-pax\-option\fP=\fISchlüsselwort\fP[[:]=\fIWert\fP][,\fISchlüsselwort\fP[[:]=\fIWert\fP]] …
steuert beim Erstellen von \fBPAX\fP\-Archiven PAX\-Schlüsselwörter. Diese Option
entspricht der Option \fB\-o\fP des \fBpax\fP(1)\-Hilfswerkzeugs.
.TP
\fB\-\-posix\fP
Gleichbedeutend mit \fB\-\-format=posix\fP.
.TP
\fB\-V\fP, \fB\-\-label\fP=\fITEXT\fP
erstellt ein Archiv mit dem Datenträgernamen \fITEXT\fP. Beim Auflisten oder
Entpacken wird \fITEXT\fP als Suchmuster für den Datenträgernamen verwendet.
.SS Kompressionsoptionen
.TP
\fB\-a\fP, \fB\-\-auto\-compress\fP
verwendet die Archiv\-Endung, um das Kompressionsprogramm herauszufinden.
.TP
\fB\-I\fP, \fB\-\-use\-compress\-program\fP\fI=BEFEHL\fP
filtert Daten durch \fIBEFEHL\fP. Er muss die Option \fB\-d\fP zur Dekompression
akzeptieren. Das Argument kann Befehlszeilenoptionen enthalten.
.TP
\fB\-j\fP, \fB\-\-bzip2\fP
filtert das Archiv mit \fBbzip2\fP(1).
.TP
\fB\-J\fP, \fB\-\-xz\fP
filtert das Archiv mit \fBxz\fP(1).
.TP
\fB\-\-lzip\fP
filtert das Archiv mit \fBlzip\fP(1).
.TP
\fB\-\-lzma\fP
filtert das Archiv mit \fBlzma\fP(1).
.TP
\fB\-\-lzop\fP
filtert das Archiv mit \fBlzop\fP(1).
.TP
\fB\-\-no\-auto\-compress\fP
verwendet nicht die Archiv\-Endung, um das Kompressionsprogramm
herauszufinden.
.TP
\fB\-z\fP, \fB\-\-gzip\fP, \fB\-\-gunzip\fP, \fB\-\-ungzip\fP
filtert das Archiv mit \fBgzip\fP(1).
.TP
\fB\-Z\fP, \fB\-\-compress\fP, \fB\-\-uncompress\fP
filtert das Archiv mit \fBcompress\fP(1).
.TP
\fB\-\-zstd\fP
filtert das Archiv mit \fBzstd\fP(1).
.SS "Auswahl lokaler Dateien"
.TP
\fB\-\-add\-file\fP=\fIDATEI\fP
fügt \fIDATEI\fP zum Archiv hinzu (sinnvoll, wenn der Name mit einem
Minuszeichen beginnt).
.TP
\fB\-\-backup\fP[=\fICONTROL\fP]
erstellt Sicherungskopien vor dem Löschen. Falls das Argument \fICONTROL\fP
angegeben ist, steuert es die Sicherung. Zulässige Werte sind:
.RS
.TP
\fBnone\fP, \fBoff\fP
erstellt niemals Sicherungskopien.
.TP
\fBt\fP, \fBnumbered\fP
erstellt nummerierte Sicherheitskopien.
.TP
\fBnil\fP, \fBexisting\fP
nummeriert, wenn bereits nummerierte Sicherheitskopien existieren, sonst
einfach.
.TP
\fBnever\fP, \fBsimple\fP
erstellt immer einfache Sicherheitskopien.
.RS
.RE
Falls \fICONTROL\fP nicht angegeben wurde, wird der Wert der Umgebungsvariable
\fBVERSION_CONTROL\fP genommen. Falls sie nicht gesetzt ist, wird \fBexisting\fP
angenommen.
.RE
.TP
\fB\-C\fP, \fB\-\-directory\fP=\fIVERZ\fP
wechselt in \fIVERZ\fP, bevor irgendwelche Operationen ausgeführt werden. Diese
Option ist positionsgebunden, das heißt, sie beeinflusst alle Optionen, die
darauf folgen.
.TP
\fB\-\-exclude\fP=\fIMUSTER\fP
schließt Dateien aus, die dem \fIMUSTER\fP entsprechen, das ein
Platzhalter\-Muster im \fBglob\fP(3)\-Stil ist.
.TP
\fB\-\-exclude\-backups\fP
schließt Sicherungs\- und Sperrdateien aus.
.TP
\fB\-\-exclude\-caches\fP
schließt den Inhalt von Verzeichnissen aus, die eine Datei namens
\fBCACHEDIR.TAG\fP enthalten, mit Ausnahme der Markierungsdatei selbst.
.TP
\fB\-\-exclude\-caches\-all\fP
schließt den Inhalt von Verzeichnissen aus, die eine Datei namens
\fBCACHEDIR.TAG\fP enthalten, einschließlich der Markierungsdatei selbst.
.TP
\fB\-\-exclude\-caches\-under\fP
schließt alles unterhalb von Verzeichnissen aus, die eine Datei namens
\fBCACHEDIR.TAG\fP enthalten.
.TP
\fB\-\-exclude\-ignore=\fP\fIDATEI\fP
sieht vor der Ausgabe eines Verzeichnisses nach, ob sie \fIDATEI\fP
enthält. Ist dies der Fall, werden aus dieser Datei ausschließende Muster
gelesen. Die Muster betreffen nur das Verzeichnis selbst.
.TP
\fB\-\-exclude\-ignore\-recursive=\fP\fIDATEI\fP
ist gleichbedeutend mit \fB\-\-exclude\-ignore\fP, außer dass die Muster aus
\fIDATEI\fP im Verzeichnis selbst und auch allen Unterverzeichnissen gesucht
wird.
.TP
\fB\-\-exclude\-tag\fP=\fIDATEI\fP
schließt den Inhalt von Verzeichnissen aus, welche \fIDATEI\fP enthalten, außer
\fIDATEI\fP selbst.
.TP
\fB\-\-exclude\-tag\-all\fP=\fIDATEI\fP
schließt Verzeichnisse aus, die die \fIDATEI\fP enthalten.
.TP
\fB\-\-exclude\-tag\-under\fP=\fIDATEI\fP
schließt alles unterhalb des Verzeichnisses aus, das \fIDATEI\fP enthält.
.TP
\fB\-\-exclude\-vcs\fP
schließt unter Versionsverwaltung stehende Verzeichnisse aus.
.TP
\fB\-\-exclude\-vcs\-ignores\fP
schließt Dateien aus, die auf die Muster von den aus
Versionsverwaltungssystemen bekannten »ignore«\-Dateien passen. Die Dateien
\&\fB.cvsignore\fP, \fB.gitignore\fP, \fB.bzrignore\fP und \fB.hgignore\fP werden
unterstützt.
.TP
\fB\-h\fP, \fB\-\-dereference\fP
folgt symbolischen Links, archiviert die Dateien und gibt sie aus, auf die
sie zeigen.
.TP
\fB\-\-hard\-dereference\fP
folgt harten Links, archiviert die Dateien und gibt sie aus, auf die sie
sich beziehen.
.TP
\fB\-K\fP, \fB\-\-starting\-file\fP=\fIELEMENT\fP
beginnt beim angegebenen Element im Archiv.
.TP
\fB\-\-newer\-mtime\fP=\fIZEITSTEMPEL\fP
arbeitet mit Dateien, deren Daten nach dem \fIDatum\fP geändert wurden. Falls
\fIDatum\fP mit einem \fB/\fP oder \fB.\fP beginnt, wird es als Dateiname
genommen. Die Mtime dieser Datei wird als Datum benutzt.
.TP
\fB\-\-no\-null\fP
deaktiviert den Effekt der vorherigen Option \fB\-\-null\fP.
.TP
\fB\-\-no\-recursion\fP
verhindert das automatische Hinabsteigen in Verzeichnisstrukturen.
.TP
\fB\-\-no\-unquote\fP
entfernt keine Maskierungen von Eingabedateien oder Elementnamen.
.TP
\fB\-\-no\-verbatim\-files\-from\fP
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 \fBtar\fP\-Befehlszeilenoption angesehen.
Dies ist das Standardverhalten. Die Option \fB\-\-no\-verbatim\-files\-from\fP wird
als Möglichkeit zur Wiederherstellung nach der Option
\fB\-\-verbatim\-files\-from\fP bereitgestellt.
Diese Option ist positionsgebunden: Sie betrifft alle
\fB\-\-files\-from\fP\-Optionen, die danach vorkommen, bis entweder die Option
\fB\-\-verbatim\-files\-from\fP oder das Zeilenende erreicht werden.
Dies ist in der Option \fB\-\-no\-null\fP impliziert.
.TP
\fB\-\-null\fP
weist nachfolgende \fB\-T\fP\-Optionen an, null\-terminierte Namen wortgetreu zu
lesen (schaltet die Sonderbehandlung von Namen aus, die mit einem
Bindestrich beginnen).
Siehe auch \fB\-\-verbatim\-files\-from\fP.
.TP
\fB\-N\fP, \fB\-\-newer\fP=\fIZEITSTEMPEL\fP, \fB\-\-after\-date\fP=\fIZEITSTEMPEL\fP
speichert nur Dateien, die neuer als \fIDATUM\fP sind. Falls \fIDATUM\fP mit einem
\fB/\fP oder \fB.\fP beginnt, wird es als Dateiname genommen. Die Mtime dieser
Datei wird als Datum benutzt.
.TP
\fB\-\-one\-file\-system\fP
bleibt im lokalen Dateisystem, wenn ein Archiv erstellt wird.
.TP
\fB\-P\fP, \fB\-\-absolute\-names\fP
entfernt führende »/« von Dateinamen beim Erstellen von Archiven nicht.
.TP
\fB\-\-recursion\fP
steigt in Verzeichnisstrukturen hinab (Voreinstellung).
.TP
\fB\-\-suffix\fP=\fIZEICHENKETTE\fP
legt eine Sicherheitskopie vor dem Löschen an, wobei die übliche Endung
überschrieben wird (»~«, sofern nicht von der Umgebungsvariablen
SIMPLE_BACKUP_SUFFIX überschrieben).
.TP
\fB\-T\fP, \fB\-\-files\-from\fP=\fIDATEI\fP
Ermittelt die auszulesenden oder zu erstellenden Namen aus \fIDATEI\fP.
Falls nicht anders angegeben, muss \fIDATEI\fP eine durch ASCII \fBLF\fP 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 \fB\-\fP beginnt, wird als Befehlszeilenoption für \fBtar\fP behandelt.
Falls dieses Verhalten nicht gewünscht ist, kann es mit der Option
\fB\-\-verbatim\-files\-from\fP ausgeschaltet werden.
Die Option \fB\-\-null\fP weist \fBtar\fP an, dass die Namen in \fIDATEI\fP durch das
ASCII\-\fBNUL\fP\-Zeichen statt durch \fBLF\fP getrennt sind. Dies ist hilfreich,
falls die Liste mittels der Option \fB\-print0\fP von \fBfind\fP(1) erstellt wurde.
.TP
\fB\-\-unquote\fP
entfernt Maskierungszeichen für Dateien oder Elemente (Vorgabe).
.TP
\fB\-\-verbatim\-files\-from\fP
behandelt jede Zeile, die aus einer Dateiliste erhalten wurde, als
Dateiname, selbst wenn sie mit einem Bindestrich beginnt. Dateilisten werden
mit der Option \fB\-\-files\-from\fP (\fB\-T\fP) ü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 \fBtar\fP behandelt. Die Option \fB\-\-verbatim\-files\-from\fP
deaktiviert dieses Verhalten.
Diese Option betrifft alle Optionen \fB\-\-files\-from\fP, die danach in der
Befehlszeile auftreten. Sein Effekt wird mit der Option
\fB\-\-no\-verbatim\-files\-from\fP rückgängig gemacht.
Diese Option impliziert die Option \fB\-\-null\fP.
Siehe auch \fB\-\-add\-file\fP.
.TP
\fB\-X\fP, \fB\-\-exclude\-from\fP=\fIDATEI\fP
schließt Dateien aus, die auf irgendein Muster in DATEI passen.
.SS "Umwandlung von Dateinamen"
.TP
\fB\-\-strip\-components\fP=\fIANZAHL\fP
schneidet ANZAHL führende Komponenten von Dateinamen während des Entpackens
ab.
.TP
\fB\-\-transform\fP=\fIAUSDRUCK\fP, \fB\-\-xform\fP=\fIAUSDRUCK\fP
verwendet den sed\-AUSDRUCK zum Ersetzen mit, um Dateinamen zu ändern.
.SS "Optionen für Übereinstimmungen von Dateinamen"
Diese Optionen sind sowohl in Einbeziehungs\- als auch in Ausschlussmustern
wirksam.
.TP
\fB\-\-anchored\fP
Muster passen auf den Anfang des Dateinamens.
.TP
\fB\-\-ignore\-case\fP
ignoriert Groß\- oder Kleinschreibung.
.TP
\fB\-\-no\-anchored\fP
Muster passen nach jedem \fB/\fP (Vorgabe für Ausschluss).
.TP
\fB\-\-no\-ignore\-case\fP
Musterprüfung berücksichtigt Groß\-/Kleinschreibung (Vorgabe).
.TP
\fB\-\-no\-wildcards\fP
Zeichenkettenprüfung erfolgt literal.
.TP
\fB\-\-no\-wildcards\-match\-slash\fP
Metazeichen passen nicht auf \fB/\fP.
.TP
\fB\-\-wildcards\fP
Metazeichen verwenden (Vorgabe für Ausschluss).
.TP
\fB\-\-wildcards\-match\-slash\fP
Metazeichen passen auf \fB/\fP (Vorgabe für Ausschluss).
.SS "Informative Ausgabe"
.TP
\fB\-\-checkpoint\fP[=\fIN\fP]
gibt Fortschrittsmeldungen bei jedem \fIN\fPten Datensatz aus (Voreinstellung
10).
.TP
\fB\-\-checkpoint\-action\fP=\fIAKTION\fP
führt \fIAKTION\fP bei jedem Kontrollpunkt aus.
.TP
\fB\-\-clamp\-mtime\fP
setzt nur dann die Zeit, wenn diese neuer als die mit \fB\-\-mtime\fP angegebene
Zeit ist.
.TP
\fB\-\-full\-time\fP
gibt die Dateizeit in der vollen Auflösung aus.
.TP
\fB\-\-index\-file\fP=\fIDATEI\fP
lenkt die ausführliche Ausgabe in \fIDATEI\fP um.
.TP
\fB\-l\fP, \fB\-\-check\-links\fP
gibt eine Meldung aus, falls nicht alle Links ausgegeben wurden.
.TP
\fB\-\-no\-quote\-chars\fP=\fIZEICHENKETTE\fP
schaltet das Maskieren von Zeichen aus \fIZEICHENKETTE\fP aus.
.TP
\fB\-\-quote\-chars\fP=\fIZEICHENKETTE\fP
maskiert Zeichen aus \fIZEICHENKETTE\fP zusätzlich.
.TP
\fB\-\-quoting\-style\fP=\fISTIL\fP
setzt den Maskierungsstil für Datei\- und Elementnamen. Gültige Werte
für \fISTIL\fP sind \fBliteral\fP, \fBshell\fP, \fBshell\-always\fP, \fBc\fP, \fBc\-maybe\fP,
\fBescape\fP, \fBlocale\fP und \fBclocale\fP.
.TP
\fB\-R\fP, \fB\-\-block\-number\fP
zeigt die Blocknummer innerhalb des Archivs mit jeder Meldung an.
.TP
\fB\-\-show\-omitted\-dirs\fP
zeigt beim Auflisten oder Entpacken jedes Verzeichnis an, das nicht auf die
Suchkriterien passt.
.TP
\fB\-\-show\-transformed\-names\fP, \fB\-\-show\-stored\-names\fP
zeigt Datei\- oder Archivnamen nach der Umwandlung mit den Optionen
\fB\-\-strip\fP und \fB\-\-transform\fP an.
.TP
\fB\-\-totals\fP[=\fISIGNAL\fP]
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.
.TP
\fB\-\-utc\fP
gibt Dateiänderungszeiten in UTC aus.
.TP
\fB\-v\fP, \fB\-\-verbose\fP
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 \fBtar\fP
beeinflussen, lesen Sie bitte das \fBGNU Tar Manual\fP, Unterabschnitt 2.5.1
»\fBThe '\-\-verbose' Option\fP«.
.TP
\fB\-\-warning\fP=\fISCHLÜSSELWORT\fP
aktiviert oder deaktiviert durch \fISCHLÜSSELWORT\fP identifizierte
Warnungsmeldungen. Die Meldungen werden unterdrückt, falls \fBno\-\fP vor das
\fISCHLÜSSELWORT\fP gesetzt wird, ansonsten sind sie aktiviert.
Mehrere \fB\-\-warning\fP\-Optionen werden zusammengefasst.
Schlüsselwörter, die die allgemeinen Abläufe von \fBtar\fP steuern:
.RS
.TP
\fBall\fP
aktiviert sämtliche Warnmeldungen. Dies ist die Voreinstellung.
.TP
\fBnone\fP
deaktiviert sämtliche Warnmeldungen.
.TP
\fBfilename\-with\-nuls\fP
"%s: gelesener Dateiname enthält das Zeichen Nul."
.TP
\fBalone\-zero\-block\fP
"Ein einsamer Nullblock bei %s"
.HP
Für \fBtar \-\-create\fP anwendbare Schlüsselwörter:
.TP
\fBcachedir\fP
"%s: Enthält eine Zwischenspeicherverzeichnismarkierung %s: %s"
.TP
\fBfile\-shrank\fP
"%s: Datei schrumpfte um %s bytes, wird mit Nullen aufgefüllt."
.TP
\fBxdev\fP
"%s: Datei ist auf einem anderen Dateisystem; nicht ausgegeben."
.TP
\fBfile\-ignored\fP
"%s: Unbekannter Dateityp; Datei wird ignoriert"
.br
"%s: Socket wird ignoriert"
.br
"%s: Door ignoriert"
.TP
\fBfile\-unchanged\fP
"%s: Datei ist unverändert, nicht ausgegeben."
.TP
\fBignore\-archive\fP
"%s: Archiv kann sich nicht selbst enthalten; nicht gesichert."
.TP
\fBfile\-removed\fP
"%s: Die Datei wurde entfernt, bevor sie gelesen werden konnte."
.TP
\fBfile\-changed\fP
"%s: Die Datei wurde während des Lesens geändert."
.TP
\fBfailed\-read\fP
unterdrückt Warnungen über nicht lesbare Dateien oder Verzeichnisse. Dieses
Schlüsselwort gilt nur, falls es zusammen mit der Option
\fB\-\-ignore\-failed\-read\fP verwandt wird.
.HP
Für \fBtar \-\-extract\fP verfügbare Schlüsselwörter:
.TP
\fBexisting\-file\fP
"%s: Existierende Datei wird übersprungen."
.TP
\fBtimestamp\fP
"%s: Unplausibler alter Zeitstempel %s."
.br
"%s: Zeitstempel %s ist %s s in der Zukunft."
.TP
\fBcontiguous\-cast\fP
"Entpacke fortlaufende Dateien als reguläre Dateien"
.TP
\fBsymlink\-cast\fP
"versucht, symbolische Links als harte Links zu entpacken."
.TP
\fBunknown\-cast\fP
"%s: Unbekannter Dateityp »%c«, wird als normale Datei entpackt."
.TP
\fBignore\-newer\fP
"Aktuelle %s ist neuer oder gleichalt."
.TP
\fBunknown\-keyword\fP
"Unbekanntes erweitertes Kopfzeilenschlüsselwort »%s« wird ignoriert."
.TP
\fBdecompress\-program\fP
steuert die ausführliche Beschreibung von Fehlern, die beim Versuch
auftreten, alternative Entpackprogramme zu verwenden. Diese Warnung ist
standardmäßig deaktiviert (außer \fB\-\-verbose\fP wird verwendet). Ein typisches
Beispiel dafür, was Sie mit der Verwendung dieser Warnungen erhalten
könnten:
.EX
$ \fBtar \-\-warning=decompress\-program \-x \-f archive.Z tar (Kind): Kann compress nicht ausführen: Datei oder Verzeichnis nicht gefunden tar (Kind): Versuche Gzip\fP
.EE
Dies bedeutet, dass \fBtar\fP zuerst versuchte, \fBarchive.Z\fP mittels
\fBcompress\fP zu entpacken und als das fehlschlug, auf \fBgzip\fP umstellte.
.TP
\fBrecord\-size\fP
"Datensatzgröße = %lu Blöcke"
.HP
Schlüsselwörter, die die schrittweise Entpackung steuern:
.TP
\fBrename\-directory\fP
"%s: Verzeichnis wurde aus %s umbenannt"
.br
"%s: Verzeichnis wurde umbenannt"
.TP
\fBnew\-directory\fP
"%s: Verzeichnis ist neu"
.TP
\fBxdev\fP
"%s: Verzeichnis liegt auf einem anderen Dateisystem: entferne nicht."
.TP
\fBbad\-dumpdir\fP
"Fehlgeformtes Verzeichnis für Dump: „X“ nie benutzt"
.RE
.TP
\fB\-w\fP, \fB\-\-interactive\fP, \fB\-\-confirmation\fP
bittet vor jeder Aktion um eine Bestätigung.
.SS Kompatibilitätsoptionen
.TP
\fB\-o\fP
Beim Erstellen identisch zu \fB\-\-old\-archive\fP. Beim Auslesen identisch zu
\fB\-\-no\-same\-owner\fP.
.SS Größenendungen
.sp
.nf
.ta 8n 18n 42n
.ul
Endung Einheiten Byte\-Äquivalent
b Blöcke \fIGRÖSSE\fP x 512
B Kilobyte \fIGRÖSSE\fP x 1024
c Byte \fIGRÖSSE\fP
G Gigabyte \fIGRÖSSE\fP x 1024^3
K Kilobyte \fIGRÖSSE\fP x 1024
k Kilobyte \fIGRÖSSE\fP x 1024
M Megabyte \fIGRÖSSE\fP x 1024^2
P Petabyte \fIGRÖSSE\fP x 1024^5
T Terabyte \fIGRÖSSE\fP x 1024^4
w Wörter \fIGRÖSSE\fP x 2
.fi
.PP
.SH RÜCKGABEWERT
Der Exit\-Code von \fBtar\fP zeigt an, ob es die angefragte Aktion erfolgreich
durchführen konnte und falls nicht, welche Art von Fehlern aufgetreten ist.
.TP
\fB0\fP
Erfolgreich beendet.
.TP
\fB1\fP
\fIEinige Dateien unterscheiden sich.\fP Falls \fBtar\fP mit der
Befehlszeilenoption \fB\-\-compare\fP (\fB\-\-diff\fP, \fB\-d\fP) aufgerufen wurde,
bedeutet dies, dass einige Dateien in dem Archiv sich von ihren Gegenstücken
auf der Platte unterscheiden. Falls \fBtar\fP eine der Optionen \fB\-\-create\fP,
\fB\-\-append\fP oder \fB\-\-update\fP ü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.
.TP
\fB2\fP
\fIFataler Fehler.\fP Dies bedeutet, dass ein fataler, nicht
korrigierbarer Fehler auftrat.
.PP
Falls ein Unterprozess, der von \fBtar\fP aufgerufen wurde, mit einem von Null
verschiedenen Exit\-Code beendet wurde, beendet sich \fBtar\fP auch mit diesem
Code. Dies kann beispielsweise passieren, falls eine Komprimierungsoption
(z.B. \fB\-z\fP) verwendet wurde und das externe Komprimierungsprogramm
fehlschlug. Ein weiteres Beispiel ist ein Fehlschlag von \fBrmt\fP während der
Datensicherung auf ein Gerät in der Ferne.
.SH "SIEHE AUCH"
\fBbzip2\fP(1), \fBcompress\fP(1), \fBgzip\fP(1), \fBlzma\fP(1), \fBlzop\fP(1), \fBrmt\fP(8),
\fBsymlink\fP(7), \fBxz\fP(1), \fBzstd\fP(1).
.PP
Vollständiges Handbuch von \fBtar\fP: Führen Sie \fBinfo tar\fP aus oder verwenden
Sie den Info\-Modus von \fBemacs\fP(1) zum Lesen.
.PP
Online\-Versionen der Dokumentation zu \fBGNU tar\fP in verschiedenen Formaten
finden Sie hier:
.PP
.in +4
\fBhttps://www.gnu.org/software/tar/manual\fP
.SH FEHLERBERICHTE
Melden Sie Fehler (auf Englisch) an .
.SH COPYRIGHT
Copyright \(co 2023 Free Software Foundation, Inc.
.br
.na
Lizenz GPLv3+: GNU GPL Version 3 oder neuer
.
.br
.ad
Dies ist freie Software: Sie können sie verändern und weitergeben. Es gibt
KEINE GARANTIE, soweit gesetzlich zulässig.
.\" Local variables:
.\" eval: (add-hook 'write-file-hooks 'time-stamp)
.\" time-stamp-start: ".TH [A-Z_][A-Z0-9_.\-]* [0-9] \""
.\" time-stamp-format: "%:B %:d, %:y"
.\" time-stamp-end: "\""
.\" time-stamp-line-limit: 20
.\" end:
.PP
.SH ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von
Dr. Tobias Quathamer ,
Mario Blättermann
und
Helge Kreutzmann
erstellt.
.PP
Diese Übersetzung ist Freie Dokumentation; lesen Sie die
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License Version 3
.UE
oder neuer bezüglich der
Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.
.PP
Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden,
schicken Sie bitte eine E-Mail an die
.MT debian-l10n-german@lists.debian.org
Mailingliste der Übersetzer
.ME .