Utilisation traditionnelle

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

Utilisation de style UNIX

tar -A [OPTIONS] -f ARCHIVE ARCHIVE...

tar -c [-f ARCHIVE] [OPTIONS] [FICHIER...]

tar -d [-f ARCHIVE] [OPTIONS] [FICHIER...]

tar -r [-f ARCHIVE] [OPTIONS] [FICHIER...]

tar -t [-f ARCHIVE] [OPTIONS] [MEMBRE...]

tar -u [-f ARCHIVE] [OPTIONS] [FICHIER...]

tar -x [-f ARCHIVE] [OPTIONS] [MEMBRE...]

Utilisation de style GNU

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

tar --create [--file ARCHIVE] [OPTIONS] [FICHIER...]

tar {--diff|--compare} [--file ARCHIVE] [OPTIONS] [FICHIER...]

tar --delete [--file ARCHIVE] [OPTIONS] [MEMBRE...]

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

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

tar --test-label [--file ARCHIVE] [OPTIONS] [ÉTIQUETTE...]

tar --update [--file ARCHIVE] [OPTIONS] [FICHIER...]

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

Styles des options

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

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

tar cfv etc.tar /etc

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

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

L’exemple de commande ci-dessous écrit dans le style court peut apparaître ainsi :

tar -cvf etc.tar /etc

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

Dans GNU ou le style option longue, chaque option débute par deux tirets et possède un nom significatif, constitué de lettres minuscules et de tirets. Lorsqu’utilisée, une option longue peut être abrégée à ses initiales, pourvu que cela ne crée pas d’ambiguïté. Les arguments des options longues sont fournis soit comme mot séparé de la ligne de commande, immédiatement après l’option, ou comme mot séparé par un signe égal sans espace intermédiaire. Les arguments facultatifs doivent toujours utiliser la dernière méthode.

Voici plusieurs façons d’écrire un exemple de commande de ce style :

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

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

Les options des trois styles peuvent être mélangées, quoique que le faire avec les vieilles options ne soit pas préconisé.

Mode d'opération

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

-A, --catenate, --concatenate

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

Les archives compressées ne peuvent être concaténées

-c, --create

Créer une nouvelle archive. Les arguments fournissent le nom des fichiers à archiver. Les répertoires sont archivés de manière récursive, à moins que l’option --no-recursion soit fournie.

-d, --diff, --compare

Trouver les différences entre l’archive et le système de fichiers. Les arguments sont facultatifs et indiquent les membres de l’archive à comparer. S’ils ne sont pas fournis, le répertoire de travail utilisé est présumé.

--delete

Supprimer de l’archive. Les arguments fournissent les noms des membres de l’archive à supprimer. Au moins un argument doit être fourni.

Cette option est inopérante pour les archives compressées. Il n’existe pas d’option courte équivalente.

-r, --append

Joindre des fichiers à la fin d’une archive. Les arguments ont la même signification que pour -c (--create).

-t, --list

Lister le contenu d’une archive. Les arguments sont facultatifs. Lorsqu’ils sont fournis, ils précisent le nom des membres à lister.

--test-label

Tester l’étiquette du volume de l’archive et quitter. Lorsque cette option est utilisée sans argument, elle affiche l’étiquette du volume (si elle existe) et quitte avec comme état 0. Quand un ou plusieurs arguments de ligne de commande sont fournis, tar compare l’étiquette avec chaque argument. Il termine avec un état 0 si une correspondance est trouvée et avec le code 1 autrement. Aucune sortie n’est affichée à moins d’une utilisation de l’option -v (--verbose) option.

Il n’existe pas d’option courte équivalente.

-u, --update

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

-x, --extract, --get

Extraire les fichiers d’une archive. Les arguments sont facultatifs. Lorsqu’ils sont fournis, ils précisent les membres de l’archive à extraire.

--show-defaults

Show built-in defaults for various tar options and exit.

-?, --help

Display a short option summary and exit.

--usage

Display a list of available options and exit.

--version

Afficher la version du programme et l’information de droits d’auteur et quitter.

Modificateurs d'opération

--check-device

Vérifier les numéros de périphérique lors de la création d'archives incrémentales (comportement par défaut).

-g, --listed-incremental=FICHIER

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

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

--hole-detection=MÉTHODE

Utiliser MÉTHODE pour détecter les trous des fichiers creux. Cette option implique --sparse. Les valeurs autorisées pour MÉTHODE sont seek et raw. La valeur par défaut est seek avec un repli sur raw si elle n’est pas applicable.

-G, --incremental

Gérer les sauvegardes incrémentales de l'ancien format GNU.

--ignore-failed-read

Ne pas quitter en renvoyant un code de retour non nul si des fichiers sont illisibles.

--level=NUMÉRO

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

-n, --seek

Présumer que l’archive est adressable. Normalement tar détermine automatiquement si l’archive peut être parcourue ou pas. Cette option est destinée à être utilisée dans le cas où une telle reconnaissance échoue. Elle prend effet si seulement l’archive est ouverte en lecture (par exemple, avec les options --list ou --extract.

--no-check-device

Ne pas vérifier les numéros de périphérique lors de la création d'archives incrémentales.

--no-seek

Présumer que l’archive n’est pas adressable.

--occurrence[=N]

Traiter seulement la Nième occurrence de chaque fichier dans l'archive. Cette option n'est valable qu’accompagnée de l'une des sous-commandes --delete, --diff, --extract ou  --list et lorsqu'une liste de fichiers est fournie soit sur la ligne de commande, soit avec l'option -T. N vaut 1 par défaut.

--restrict

Désactiver l'utilisation d'options potentiellement dommageables.

--sparse-version=MAJEUR[.MINEUR]

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

-S, --sparse

Gérer les fichiers creux de manière efficace. Certains fichiers du système de fichiers peuvent contenir des segments qui ne sont en fait jamais écrits (la plupart du temps ce sont des fichiers de base de données créés par des systèmes tel DBM). Lorsque cette option est fournie, tar tente de déterminer si le fichier est creux avant de l’archiver, et si tel est le cas, de réduire la taille de l’archive résultante en ne copiant pas les parties vides du fichier.

Contrôle d’écrasement.

Ces options contrôlent les actions de tar lors de l’extraction d’un fichier au-dessus d’une copie existante sur le disque.

-k, --keep-old-files

Ne pas remplacer les fichiers existants lors de l'extraction.

--keep-newer-files

Ne pas remplacer les fichiers existants plus récents que leurs copies dans l'archive.

--keep-directory-symlink

Préserver les liens symboliques existants vers des dossiers lors de l'extraction.

--no-overwrite-dir

Préserver les métadonnées des dossiers existants.

--one-top-level[=RÉP]

Extraire tous les fichiers dans RÉP, ou, si aucun argument n’est fourni, dans un sous-répertoire appelé selon le nom de base de l’archive (sans les suffixes de compression standard identifiables avec --auto-compress).

--overwrite

Écraser les fichiers existants lors de l'extraction.

--overwrite-dir

Écraser les métadonnées des répertoires existants lors de l'extraction (comportement par défaut).

--recursive-unlink

Supprimer récursivement tous les fichiers du répertoire avant d'extraire par-dessus.

--remove-files

Supprimer les fichiers du disque après les avoir ajoutés dans l'archive.

--skip-old-files

Ne pas remplacer les fichiers existants lors de l'extraction. Ils sont omis silencieusement.

-U, --unlink-first

Supprimer chaque fichier avant d'extraire par-dessus.

-W, --verify

Vérifier l'archive après l'avoir écrite.

Choix du flux de sortie

--ignore-command-error

Ignorer les codes renvoyés par les sous-processus.

--no-ignore-command-error

Considérer les codes de sortie non nuls des processus enfants comme des erreurs (par défaut).

-O, --to-stdout

Extraire les fichiers sur la sortie standard.

--to-command=COMMANDE

Diriger les fichiers extraits vers la COMMANDE. L’argument est le nom de chemin d’un programme externe, avec des arguments de ligne de commande facultatifs. Le programme sera appelé et le contenu du fichier extrait lui sera fourni sur son entrée standard. Des données supplémentaires seront fournies à l’aide des variables d’environnement suivantes :

Gestion des attributs de fichier

--atime-preserve[=MÉTHODE]

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

--delay-directory-restore

Reporter à la fin de l'extraction le changement des dates de modification et des permissions des répertoires extraits. Utiliser cette option lors d’une extraction à partir d’une archive ayant un ordre des membres inhabituel.

--group=NOM[:GID]

Forcer NOM comme groupe pour les fichiers ajoutés. Si GID n’est pas fourni, NOM peut être soit un nom d’utilisateur ou un GID numérique. Dans ce cas, la partie manquante (GID ou nom) sera déduite de la base de données de groupes de l’hôte actuel.

Lorsqu’utilisée avec --group-map=FICHIER, cela affecte seulement les fichiers dont le groupe propriétaire n’est pas listé dans FICHIER.

--group-map=FICHIER

Lire le carte de traduction de groupes à partir de FICHIER. Les lignes vides sont ignorées. Les commentaires débutent par un signe # et s’étendent jusqu’à la fin de la ligne. Chaque ligne non vide dans FICHIER définit la correspondance pour chaque groupe. Elle peut être constituée de deux champs délimités par n’importe quel nombre d’espaces :

ANCIENGRP NOUVEAUGRP[:NOUVEAUGID]

ANCIENGRP est soit un nom de groupe valable ou un GID préfixé par un +. À moins que NOUVEAUGID ne soit indiqué, NOUVEAUGRP doit être aussi soit un nom valable de groupe ou un +GID. Autrement, les deux NOUVEAUGRP et NOUVEAUGID n’ont pas besoin d’être listés dans la base de données de groupes du système.

De ce fait chaque fichier d’entrée avec un groupe propriétaire ANCIENGRP sera stocké dans une archive avec comme groupe propriétaire NOUVEAUGRP et un GID NOUVEAUGID.

--mode=CHANGEMENTS

Forcer le mode symbolique CHANGEMENTS pour les fichiers ajoutés.

--mtime=DATE-OU-FICHIER

Définir mtime pour les fichiers ajoutés. DATE-OU-FICHIER est soit une date/heure dans à peu près n’importe quel format ou le nom d’un fichier existant. Dans le dernier cas, le mtime de ce fichier sera utilisé.

-m, --touch

Ne pas extraire la date modifiée du fichier.

--no-delay-directory-restore

Annuler l'effet de l'option --delay-directory-restore.

--no-same-owner

Extraire les fichiers en votre nom (comportement par défaut pour un utilisateur ordinaire).

--no-same-permissions

Appliquer le masque de droits lors de l’extraction des permissions de l’archive (comportement par défaut pour un utilisateur ordinaire).

--numeric-owner

Utiliser systématiquement des nombres pour les noms d'utilisateur ou de groupe.

--owner=NOM[:UID]

Forcer NOM comme propriétaire pour les fichiers ajoutés. Si UID n’est pas précisé, NOM peut être soit un nom d’utilisateur ou un UID numérique. Dans ce cas, la partie manquante (UID ou nom) sera déduite de la base de données d’utilisateurs de l’hôte.

Lorsqu’utilisé avec --owner-map=FICHIER, cela affecte seulement les fichiers dont le propriétaire n’est pas listé dans FICHIER.

--owner-map=FICHIER

Lire la carte de traduction d’utilisateurs à partir de FICHIER. Les lignes vides sont ignorées. Les commentaires débutent par un signe # et s’étendent jusqu’à la fin de la ligne. Chaque ligne non vide dans FICHIER définit la correspondance pour un UID unique. Elle peut être constituée de deux champs délimités par n’importe quel nombre d’espaces :

ANCIENUTILISATEUR NOUVELUTILISATEUR[:NOUVELUID]

ANCIENUTILISATEUR est soit un nom d’utilisateur valable ou un UID préfixé avec +. À moins que NEWUID ne soit précisé, NOUVELUTILISATEUR doit être soit un nouveau nom d’utilisateur valable ou un +UID. Autrement, NOUVELUTILISATEUR et NOUVELUID n’ont pas besoin d’être listés dans la base de données d’utilisateurs du système.

De ce fait chaque fichier d’entrée possédé par ANCIENUTILISATEUR sera stocké dans une archive avec comme nom de propriétaire NOUVELUTILISATEUR et un UID NOUVELUID.

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

Set permissions of extracted files to those recorded in the archive (default for superuser).

--same-owner

Essayer d'extraire les fichiers avec les mêmes propriétaires que ceux dans l'archive (comportement par défaut pour le superutilisateur).

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

Tell tar that the list of file names to process is sorted in the same order as the files in the archive.

--sort=ORDRE

Lors de la création d’une archive, trier les entrées de répertoires selon ORDRE, qui est soit none, name ou inode.

La valeur par défaut est --sort=none qui stocke les membres de l’archive dans le même ordre que celui renvoyé par le système d’exploitation.

Utiliser --sort=name assure que l’ordre des membres dans l’archive créée est constant et reproductible.

Utiliser --sort=inode réduit le nombre de recherches dans le disque lors de la création de l’archive et donc augmente considérablement la vitesse d’archivage. Cet ordre de tri est seulement pris en charge si le système fournit les informations nécessaires.

Attributs étendus de fichier

--acls

Activer la prise en charge des ACL POSIX.

--no-acls

Désactiver la prise en charge des ACL POSIX.

--selinux

Activer la prise en charge du contexte SELinux.

--no-selinux

Désactiver la prise en charge du contexte SELinux.

--xattrs

Activer la prise en charge des attributs étendus.

--no-xattrs

Désactiver la prise en charge des attributs étendus.

--xattrs-exclude=MOTIF

Specify the exclude pattern for xattr keys. PATTERN is a globbing pattern, e.g. --xattrs-exclude='user.*' to include only attributes from the user namespace.

--xattrs-include=MOTIF

Specify the include pattern for xattr keys. PATTERN is a globbing pattern.

Sélection du périphérique et commutation

-f, --file=ARCHIVE

Utiliser le fichier ou le périphérique ARCHIVE. Si cette option n’est pas fournie, tar examinera d’abord la variable d’environnement TAPE. Si elle est définie, sa valeur sera utilisée comme nom d’archive. Sinon, tar adoptera la valeur interne par défaut. Celle-ci peut être consultée soit en utilisant l’option --show-defaults ou à la fin de la sortie de tar --help.

Un nom d’archive comportant un deux-points indique un fichier ou un périphérique sur une machine distante. La partie avant le deux-points est considérée comme le nom de la machine ou une adresse IP et la partie après comme le nom de chemin du fichier ou du périphérique, par exemple :

--file=hôtedistant:/dev/sr0

De manière facultative, un nom d’utilisateur peut être préfixé au nom d’hôte en plaçant un signe @.

Par défaut, l’hôte distant est atteint à l’aide de la commande rsh(1). À présent ssh(1) est plutôt utilisé couramment. Vous pouvez le faire en fournissant l’option de ligne de commande suivante :

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

La machine distante devrait avoir la commande rmt(8) installée. Si son nom de chemin ne correspond pas à la valeur de tar par défaut, vous pouvez indiquer à tar le chemin correct en utilisant l’option --rmt-command.

--force-local

Le fichier d’archive est local même si un deux-points existe.

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

Exécuter COMMANDE à la fin de chaque bande (-M sous-entendu). La commande peut comporter des arguments. Au démarrage, elle héritera de l’environnement de tar et des variables suivantes :

-L, --tape-length=N

Changer de bande après l’écriture de Nx1024 octets. Si N est suivi par un suffixe de taille (consulter la sous-section Suffixes de taille ci-dessous), celui-ci indique un facteur de multiplication à utiliser au lieu de 1024.

Cette option implique -M.

-M, --multi-volume

Créer, lister ou extraire une archive multivolume.

--rmt-command=COMMANDE

Utiliser COMMANDE au lieu de rmt pour accéder à des archives distantes. Consulter la description de l’option -f ci-dessus.

--rsh-command=COMMANDE

Utiliser COMMANDE au lieu de rsh pour accéder à des archives distantes. Consulter la description de l’option -f ci-dessus.

--volno-file=FICHIER

Quand cette option est utilisée conjointement avec --multi-volume, tar garde une trace de chaque volume d’une archive multivolume qu’il traite dans FICHIER.

Blocage de périphérique

-b, --blocking-factor=BLOCS

Définir la taille d’enregistrement à BLOCSx512 octets.

-B, --read-full-records

Lors du listage ou de l’extraction, accepter des enregistrements d’entrée incomplets après le marqueur EOF.

-i, --ignore-zeros

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

--record-size=NOMBRE

Définir la taille d’enregistrement. NOMBRE est le nombre d’octets par enregistrement. Il doit être un multiple de 512. Il peut avoir un suffixe de taille, par exemple, --record-size=10K, pour 10 kilo-octets. Consulter la sous-section Suffixes de taille pour une liste de suffixes autorisés.

Sélection du format d’archive

-H, --format=FORMAT

Créer une archive du format précisé. Les formats autorisés sont :

--old-archive, --portability

Identique à --format=v7.

--pax-option=motclé[[:]=valeur][,motclé[[:]=valeur]]...

Contrôler les mots-clés lors de la création d’archives PAX (-H pax). Cette option est équivalente à l’option -o de l’utilitaire pax(1).

--posix

Identique à --format=posix.

-V, --label=TEXTE

Créer une archive avec comme nom de volume TEXTE. Lors du listage ou de l'extraction, utiliser TEXTE comme motif avec caractères génériques pour le nom de volume.

Options de compression

-a, --auto-compress

Utiliser le suffixe de l'archive pour déterminer le logiciel de compression.

-I, --use-compress-program=COMMANDE

Traiter les données avec COMMANDE. L’option -d doit être acceptée pour la décompression. L’argument peut contenir des options de ligne de commande.

-j, --bzip2

Traiter l'archive avec bzip2(1).

-J, --xz

Traiter l'archive avec xz(1).

--lzip

Traiter l'archive avec lzip(1).

--lzma

Traiter l'archive avec lzma(1).

--lzop

Traiter l'archive avec lzop(1).

--no-auto-compress

Ne pas utiliser le suffixe de l'archive pour déterminer le logiciel de compression.

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

Traiter l'archive avec gzip(1).

-Z, --compress, --uncompress

Traiter l'archive avec compress(1).

--zstd

Traiter l'archive avec zstd(1).

Sélection des fichiers locaux

--add-file=FICHIER

Ajouter FICHIER à l'archive (utile si son nom commence par un tiret).

--backup[=CONTROLE]

Sauvegarder avant la suppression. L’argument CONTROLE, si fourni, contrôle la politique de sauvegarde. Les valeurs autorisées sont :

-C, --directory=RÉP

Changer à RÉP avant de réaliser toute opération. Cette option est sensible à l’ordre, c'est-à-dire qu’elle affecte toutes les options qui suivent.

--exclude=MOTIF

Exclure tous les fichiers correspondant au MOTIF, un motif de jokers de style glob(3).

--exclude-backups

Exclure les fichiers de verrouillage et de sauvegarde.

--exclude-caches

Exclure le contenu des répertoires contenant un fichier CACHEDIR.TAG, sauf le fichier d'étiquette lui-même.

--exclude-caches-all

Exclure le contenu des répertoires contenant un fichier CACHEDIR.TAG ainsi que le fichier d'étiquette lui-même.

--exclude-caches-under

Exclure tout le contenu des dossiers contenant CACHEDIR.TAG.

--exclude-ignore=FICHIER

Avant de copier un répertoire, rechercher s’il contient FICHIER. Auquel cas, lire les motifs d’exclusion à partir de ce fichier. Les motifs ne concernent que le répertoire lui-même.

--exclude-ignore-recursive=FICHIER

Même chose que --exclude-ignore, excepté que les motifs de FICHIER affectent le répertoire et ses sous-répertoires.

--exclude-tag=FICHIER

Exclure le contenu des répertoires contenant le FICHIER, sauf le FICHIER lui-même.

--exclude-tag-all=FICHIER

Exclure du traitement les dossiers contenant FICHIER.

--exclude-tag-under=FICHIER

Exclure du traitement tout le contenu des dossiers contenant FICHIER.

--exclude-vcs

Exclure les répertoires du système de gestion de versions.

--exclude-vcs-ignores

Exclure les fichiers correspondant aux motifs lus à partir de fichiers ignore spécifiques aux systèmes de gestion de versions. Les fichiers pris en charge sont :.cvsignore, .gitignore, .bzrignore et .hgignore.

-h, --dereference

Suivre les liens symboliques. Archiver et copier les fichiers pointés.

--hard-dereference

Suivre les liens matériels. Archiver et copier les fichiers pointés.

-K, --starting-file=MEMBRE

Commencer à partir du membre indiqué dans l'archive.

--newer-mtime=DATE

Traitement des fichiers dont les données ont changé après la DATE. Si DATE débute avec / ou ., cela est considéré comme un nom de fichier. Le mtime de ce fichier est utilisé comme date.

--no-null

Désactiver l'effet de l'option --null précédente.

--no-recursion

Empêcher le parcours automatique des sous-répertoires.

--no-unquote

Ne pas supprimer les noms des fichiers ou membres d’entrée.

--no-verbatim-files-from

Traiter chaque ligne lue sur une liste de fichiers comme si elle était fournie sur la ligne de commande. C'est-à-dire que les espaces de début ou de fin sont supprimées et, si la chaîne résultante commence par un tiret, elle est traitée comme une option de la ligne de commande de tar.

C’est le comportement par défaut. L’option --no-verbatim-files-from est fournie comme une manière de le restaurer après l’option --verbatim-files-from.

Cette option est positionnelle : elle affecte toutes les options --files-from qui apparaissent après, jusqu’à l’option --verbatim-files-from ou la fin de la ligne, peu importe ce qui arrive en premier.

Elle est sous-entendue par l’option --no-null.

--null

Commander aux options -T suivantes de lire mot pour mot les noms terminés par NULL (désactivation de la gestion spéciale de noms débutant par un tiret).

Consulter aussi --verbatim-files-from.

-N, --newer=DATE, --after-date=DATE

Stocker uniquement les fichiers plus récents que DATE. Si DATE débute par / or . il est considéré comme un nom de fichier. Le mtime de ce fichier est utilisé comme date.

--one-file-system

Ne pas quitter le système de fichiers local lors de la création de l'archive.

-P, --absolute-names

Ne pas enlever les barres obliques de début des noms de fichiers lors de la création de l’archive.

--recursion

Explorer récursivement les répertoires (comportement par défaut).

--suffix=CHAÎNE

Sauvegarder avant suppression, en écrasant le suffixe habituel. Le suffixe par défaut est ~, à moins qu'il n'ait été modifié par la variable d'environnement SIMPLE_BACKUP_SUFFIX.

-T, --files-from=FICHIER

Obtenir les noms à extraire ou à créer depuis FICHIER.

À moins d’indication contraire, le FICHIER doit contenir une liste de noms séparés par des LF ASCII (c'est-à-dire, un nom par ligne). Les noms lus sont gérés de la même manière que les arguments de ligne de commande. Ils sont soumis à la suppression des protections et au découpage de mots, et toute chaîne débutant par - est gérée comme une option de ligne de commande de tar.

Si ce comportement est indésirable, il peut être désactivé en utilisant l’option --verbatim-files-from.

L’option --null commande à tar que les noms dans FICHIER soient séparés par le caractère ASCII NUL, au lieu de LF. Cela est utile si la liste est créée par un prédicat find(1) -print0.

--unquote

Enlever les protections des noms de fichier ou de membre (comportement par défaut).

--verbatim-files-from

Traiter chaque ligne obtenue d’une liste de fichiers comme un nom de fichier, même si elle débute par un tiret. Les listes de fichiers sont fournies par l’option --files-from (-T). Le comportement par défaut est de gérer les noms fournis dans les listes de fichiers comme s’ils étaient saisis sur la ligne de commande, c'est-à-dire que tout nom commençant par un tiret est traité comme une option de tar. L’option --verbatim-files-from désactive ce comportement.

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

This option is implied by the --null option.

Consulter aussi --add-file.

-X, --exclude-from=FICHIER

Exclure les fichiers correspondants aux motifs listés dans FICHIER.

Afficher les transformations de noms.

--strip-components=NOMBRE

Supprimer les NOMBRE composants de tête des noms de fichier à extraire.

--transform=EXPRESSION, --xform=EXPRESSION

Utiliser sed remplacement EXPRESSION pour transformer les noms de fichier.

Options de correspondance de nom de fichier

Ces options affectent les motifs d’exclusion et d’inclusion.

--anchored

Motifs de recherche correspondant au début du nom de fichier.

--ignore-case

Ignorer la casse.

--no-anchored

Motifs de recherche correspondant après n'importe quel / (comportement par défaut pour les exclusions).

--no-ignore-case

Tenir compte de la casse dans les correspondances (comportement par défaut).

--no-wildcards

Rechercher des chaînes mot pour mot.

--no-wildcards-match-slash

Pas de correspondance des jokers avec /.

--wildcards

Utiliser des jokers (comportement par défaut pour les exclusions).

--wildcards-match-slash

Correspondance des jokers avec / (comportement par défaut pour les exclusions).

Sorties informatives

--checkpoint[=N]

Afficher des messages de progression tous les N enregistrements (10 par défaut).

--checkpoint-action=ACTION

Exécuter ACTION à chaque point de vérification.

--clamp-mtime

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

--full-time

Afficher la date des fichiers avec le maximum de précision.

--index-file=FICHIER

Écrire une sortie détaillée dans FICHIER.

-l, --check-links

Afficher un message si l'ensemble des liens n'a pas pu être copié.

--no-quote-chars=CHAÎNE

Désactiver la protection des caractères de CHAÎNE.

--quote-chars=CHAÎNE

Ajouter les caractères de protection de CHAÎNE.

--quoting-style=STYLE

Définir le style de protection pour les noms de fichiers et de membres. Les valeurs autorisées pour STYLE sont literal, shell, shell-always, c, c-maybe, escape, locale, clocale.

-R, --block-number

Afficher le numéro de bloc au sein de l'archive avec chaque message.

--show-omitted-dirs

Lister chaque dossier qui ne correspond pas au critère de recherche lors du listage ou de l'extraction de l'archive.

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

Afficher le nom des fichiers ou des archives après transformation par les options --strip et --transform.

--totals[=SIGNAL]

Afficher le nombre total d'octets après traitement de l'archive. Si SIGNAL est fourni, afficher ce nombre quand ce signal est émis. Les signaux permis sont : SIGHUP, SIGQUIT, SIGINT, SIGUSR1 et SIGUSR2. Le préfixe SIG peut être omis.

--utc

Afficher les dates de modification des fichiers en heure universelle (UTC).

-v, --verbose

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

--warning=MOTCLÉ

Activer ou désactiver les messages d’avertissement identifiés par MOTCLÉ. Les messages sont supprimés si MOTCLÉ est préfixé par no- et activés autrement.

Multiple --warning options accumulate.

Mots-clés contrôlant les opérations générales de tar :

-w, --interactive, --confirmation

Demander une confirmation pour chaque action.

Options de compatibilité

-o

Lors de création, identique à --old-archive, lors de l’extraction, identique --no-same-owner.

Suffixes de taille

Suffixe	Unité	Équivalence en octet
b	blocs	TAILLE x 512
B	kilooctets	TAILLE x 1024
c	octets	TAILLE
G	gigaoctets	TAILLE x 1024^3
K	kilooctets	TAILLE x 1024
k	kilooctets	TAILLE x 1024
M	mégaoctets	TAILLE x 1024^2
P	pétaoctets	TAILLE x 1024^5
T	téraoctets	TAILLE x 1024^4
w	mots	TAILLE x 2