TAR(1) Manuel de GNU TAR TAR(1) NOM tar - Utilitaire d'archivage SYNOPSIS 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] [ETIQUETTE...] tar --update [--file ARCHIVE] [OPTIONS] [FICHIER...] tar {--extract|--get} [--file ARCHIVE] [OPTIONS] [MEMBER...] NOTE Cette page de manuel est une courte description de GNU tar. Pour une explication detaillee comprenant des exemples et des recommandations d'utilisation, veuillez vous referer au manuel de GNU Tar disponible au format texinfo. Si le programme info et la documentation de tar sont correctement installes sur votre systeme, la commande info tar devrait vous donner acces au manuel complet. Vous pouvez aussi consulter le manuel en utilisant le mode info dans emacs(1), ou le trouver en ligne dans divers formats sur https://www.gnu.org/software/tar/manual Si des divergences entre ce manuel et le manuel de GNU Tar apparaissaient, ce dernier doit etre considere comme faisant autorite. DESCRIPTION GNU tar est un programme d'archivage concu pour stocker plusieurs fichiers dans un seul (une archive) et pour manipuler de telles archives. L'archive peut etre soit un fichier normal, soit un peripherique (par exemple, un lecteur de bande -- tape drive -- d'ou le nom signifiant tape archiver), qui peut etre situe sur une machine locale ou distante. 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 ecrit dans le style court peut apparaitre ainsi : tar -cvf etc.tar /etc ou tar -c -v -f etc.tar /etc Dans GNU ou le style option longue, chaque option debute par deux tirets et possede un nom significatif, constitue de lettres minuscules et de tirets. Lorsqu'utilisee, une option longue peut etre abregee a ses initiales, pourvu que cela ne cree pas d'ambiguite. Les arguments des options longues sont fournis soit comme mot separe de la ligne de commande, immediatement apres l'option, ou comme mot separe par un signe egal sans espace intermediaire. Les arguments facultatifs doivent toujours utiliser la derniere methode. Voici plusieurs facons d'ecrire un exemple de commande de ce style : tar --create --file etc.tar --verbose /etc ou (en abregeant quelques options) : tar --cre --file=etc.tar --verb /etc Les options des trois styles peuvent etre melangees, quoique que le faire avec les vieilles options ne soit pas preconise. Mode d'operation 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 compressees ne peuvent etre concatenees -c, --create Creer une nouvelle archive. Les arguments fournissent le nom des fichiers a archiver. Les repertoires sont archives de maniere recursive, a moins que l'option --no-recursion soit fournie. -d, --diff, --compare Trouver les differences entre l'archive et le systeme de fichiers. Les arguments sont facultatifs et indiquent les membres de l'archive a comparer. S'ils ne sont pas fournis, le repertoire de travail utilise est presume. --delete Supprimer de l'archive. Les arguments fournissent les noms des membres de l'archive a supprimer. Au moins un argument doit etre fourni. Cette option est inoperante pour les archives compressees. Il n'existe pas d'option courte equivalente. -r, --append Joindre des fichiers a la fin d'une archive. Les arguments ont la meme signification que pour -c (--create). -t, --list Lister le contenu d'une archive. Les arguments sont facultatifs. Lorsqu'ils sont fournis, ils precisent le nom des membres a lister. --test-label Tester l'etiquette du volume de l'archive et quitter. Lorsque cette option est utilisee sans argument, elle affiche l'etiquette du volume (si elle existe) et quitte avec comme etat 0. Quand un ou plusieurs arguments de ligne de commande sont fournis, tar compare l'etiquette avec chaque argument. Il termine avec un etat 0 si une correspondance est trouvee et avec le code 1 autrement. Aucune sortie n'est affichee a moins d'une utilisation de l'option -v (--verbose) option. Il n'existe pas d'option courte equivalente. -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 precisent les membres de l'archive a 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. OPTIONS Modificateurs d'operation --check-device Verifier les numeros de peripherique lors de la creation d'archives incrementales (comportement par defaut). -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=METHODE Utiliser METHODE pour detecter les trous des fichiers creux. Cette option implique --sparse. Les valeurs autorisees pour METHODE sont seek et raw. La valeur par defaut est seek avec un repli sur raw si elle n'est pas applicable. -G, --incremental Gerer les sauvegardes incrementales 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=NUMERO 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 Presumer que l'archive est adressable. Normalement tar determine automatiquement si l'archive peut etre parcourue ou pas. Cette option est destinee a etre utilisee dans le cas ou une telle reconnaissance echoue. Elle prend effet si seulement l'archive est ouverte en lecture (par exemple, avec les options --list ou --extract. --no-check-device Ne pas verifier les numeros de peripherique lors de la creation d'archives incrementales. --no-seek Presumer que l'archive n'est pas adressable. --occurrence[=N] Traiter seulement la Nieme occurrence de chaque fichier dans l'archive. Cette option n'est valable qu'accompagnee 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 defaut. --restrict Desactiver 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 Gerer les fichiers creux de maniere efficace. Certains fichiers du systeme de fichiers peuvent contenir des segments qui ne sont en fait jamais ecrits (la plupart du temps ce sont des fichiers de base de donnees crees par des systemes tel DBM). Lorsque cette option est fournie, tar tente de determiner si le fichier est creux avant de l'archiver, et si tel est le cas, de reduire la taille de l'archive resultante en ne copiant pas les parties vides du fichier. Controle d'ecrasement. Ces options controlent 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 recents que leurs copies dans l'archive. --keep-directory-symlink Preserver les liens symboliques existants vers des dossiers lors de l'extraction. --no-overwrite-dir Preserver les metadonnees des dossiers existants. --one-top-level[=REP] Extraire tous les fichiers dans REP, ou, si aucun argument n'est fourni, dans un sous-repertoire appele selon le nom de base de l'archive (sans les suffixes de compression standard identifiables avec --auto-compress). --overwrite Ecraser les fichiers existants lors de l'extraction. --overwrite-dir Ecraser les metadonnees des repertoires existants lors de l'extraction (comportement par defaut). --recursive-unlink Supprimer recursivement tous les fichiers du repertoire avant d'extraire par-dessus. --remove-files Supprimer les fichiers du disque apres les avoir ajoutes 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 Verifier l'archive apres l'avoir ecrite. Choix du flux de sortie --ignore-command-error Ignorer les codes renvoyes par les sous-processus. --no-ignore-command-error Considerer les codes de sortie non nuls des processus enfants comme des erreurs (par defaut). -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 appele et le contenu du fichier extrait lui sera fourni sur son entree standard. Des donnees supplementaires seront fournies a l'aide des variables d'environnement suivantes : TAR_FILETYPE Type du fichier. Il s'agit d'une seule lettre ayant les significations suivantes : f Regular file (fichier normal) d Directory (repertoire) l Symbolic link (lien symbolique) h Hard link (lien physique) b Block device (peripherique bloc) c Character device (peripherique caractere) Actuellement, seuls les fichiers normaux sont pris en charge. TAR_MODE Mode de fichier, un nombre octal. TAR_FILENAME Le nom du fichier. TAR_REALNAME Nom du fichier tel qu'il est stocke dans l'archive. TAR_UNAME Nom du proprietaire du fichier. TAR_GNAME Nom du groupe proprietaire du fichier. TAR_ATIME Heure du dernier acces. C'est un nombre decimal representant le nombre de secondes depuis << l'Epoque >>. Si l'archive fournit une precision de l'ordre des nanosecondes, celles-ci sont ajoutees a l'horodatage apres un point decimal. TAR_MTIME Date de la derniere modification. TAR_CTIME Date du dernier changement d'etat TAR_SIZE Taille du fichier. TAR_UID UID du proprietaire du fichier. TAR_GID GID du proprietaire du fichier. De plus, les variables suivantes contiennent des informations sur le mode d'operation de tar et de l'archive traitee : TAR_VERSION Numero de version de GNU tar. TAR_ARCHIVE Le nom de l'archive traitee par tar. TAR_BLOCKING_FACTOR Coefficient de blocs en cours, c'est-a-dire le nombre de blocs de 512 octets dans un enregistrement. TAR_VOLUME Nombre ordinal du volume que tar traite (precise si une archive multi-volume est lue). TAR_FORMAT Format de l'archive traitee. Une des valeurs : gnu, oldgnu, posix, ustar ou v7. TAR_SUBCOMMAND Option courte (precedee d'un tiret) decrivant l'operation que tar execute. Gestion des attributs de fichier --atime-preserve[=METHODE] 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 a la fin de l'extraction le changement des dates de modification et des permissions des repertoires extraits. Utiliser cette option lors d'une extraction a partir d'une archive ayant un ordre des membres inhabituel. --group=NOM[:GID] Forcer NOM comme groupe pour les fichiers ajoutes. Si GID n'est pas fourni, NOM peut etre soit un nom d'utilisateur ou un GID numerique. Dans ce cas, la partie manquante (GID ou nom) sera deduite de la base de donnees de groupes de l'hote actuel. Lorsqu'utilisee avec --group-map=FICHIER, cela affecte seulement les fichiers dont le groupe proprietaire n'est pas liste dans FICHIER. --group-map=FICHIER Lire le carte de traduction de groupes a partir de FICHIER. Les lignes vides sont ignorees. Les commentaires debutent par un signe # et s'etendent jusqu'a la fin de la ligne. Chaque ligne non vide dans FICHIER definit la correspondance pour chaque groupe. Elle peut etre constituee de deux champs delimites par n'importe quel nombre d'espaces : ANCIENGRP NOUVEAUGRP[:NOUVEAUGID] ANCIENGRP est soit un nom de groupe valable ou un GID prefixe par un +. A moins que NOUVEAUGID ne soit indique, NOUVEAUGRP doit etre aussi soit un nom valable de groupe ou un +GID. Autrement, les deux NOUVEAUGRP et NOUVEAUGID n'ont pas besoin d'etre listes dans la base de donnees de groupes du systeme. De ce fait chaque fichier d'entree avec un groupe proprietaire ANCIENGRP sera stocke dans une archive avec comme groupe proprietaire NOUVEAUGRP et un GID NOUVEAUGID. --mode=CHANGEMENTS Forcer le mode symbolique CHANGEMENTS pour les fichiers ajoutes. --mtime=DATE-OU-FICHIER Definir mtime pour les fichiers ajoutes. DATE-OU-FICHIER est soit une date/heure dans a peu pres n'importe quel format ou le nom d'un fichier existant. Dans le dernier cas, le mtime de ce fichier sera utilise. -m, --touch Ne pas extraire la date modifiee 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 defaut pour un utilisateur ordinaire). --no-same-permissions Appliquer le masque de droits lors de l'extraction des permissions de l'archive (comportement par defaut pour un utilisateur ordinaire). --numeric-owner Utiliser systematiquement des nombres pour les noms d'utilisateur ou de groupe. --owner=NOM[:UID] Forcer NOM comme proprietaire pour les fichiers ajoutes. Si UID n'est pas precise, NOM peut etre soit un nom d'utilisateur ou un UID numerique. Dans ce cas, la partie manquante (UID ou nom) sera deduite de la base de donnees d'utilisateurs de l'hote. Lorsqu'utilise avec --owner-map=FICHIER, cela affecte seulement les fichiers dont le proprietaire n'est pas liste dans FICHIER. --owner-map=FICHIER Lire la carte de traduction d'utilisateurs a partir de FICHIER. Les lignes vides sont ignorees. Les commentaires debutent par un signe # et s'etendent jusqu'a la fin de la ligne. Chaque ligne non vide dans FICHIER definit la correspondance pour un UID unique. Elle peut etre constituee de deux champs delimites par n'importe quel nombre d'espaces : ANCIENUTILISATEUR NOUVELUTILISATEUR[:NOUVELUID] ANCIENUTILISATEUR est soit un nom d'utilisateur valable ou un UID prefixe avec +. A moins que NEWUID ne soit precise, NOUVELUTILISATEUR doit etre soit un nouveau nom d'utilisateur valable ou un +UID. Autrement, NOUVELUTILISATEUR et NOUVELUID n'ont pas besoin d'etre listes dans la base de donnees d'utilisateurs du systeme. De ce fait chaque fichier d'entree possede par ANCIENUTILISATEUR sera stocke dans une archive avec comme nom de proprietaire 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 memes proprietaires que ceux dans l'archive (comportement par defaut 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 creation d'une archive, trier les entrees de repertoires selon ORDRE, qui est soit none, name ou inode. La valeur par defaut est --sort=none qui stocke les membres de l'archive dans le meme ordre que celui renvoye par le systeme d'exploitation. Utiliser --sort=name assure que l'ordre des membres dans l'archive creee est constant et reproductible. Utiliser --sort=inode reduit le nombre de recherches dans le disque lors de la creation de l'archive et donc augmente considerablement la vitesse d'archivage. Cet ordre de tri est seulement pris en charge si le systeme fournit les informations necessaires. Attributs etendus de fichier --acls Activer la prise en charge des ACL POSIX. --no-acls Desactiver la prise en charge des ACL POSIX. --selinux Activer la prise en charge du contexte SELinux. --no-selinux Desactiver la prise en charge du contexte SELinux. --xattrs Activer la prise en charge des attributs etendus. --no-xattrs Desactiver la prise en charge des attributs etendus. --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. Selection du peripherique et commutation -f, --file=ARCHIVE Utiliser le fichier ou le peripherique ARCHIVE. Si cette option n'est pas fournie, tar examinera d'abord la variable d'environnement TAPE. Si elle est definie, sa valeur sera utilisee comme nom d'archive. Sinon, tar adoptera la valeur interne par defaut. Celle-ci peut etre consultee soit en utilisant l'option --show-defaults ou a la fin de la sortie de tar --help. Un nom d'archive comportant un deux-points indique un fichier ou un peripherique sur une machine distante. La partie avant le deux-points est consideree comme le nom de la machine ou une adresse IP et la partie apres comme le nom de chemin du fichier ou du peripherique, par exemple : --file=hotedistant:/dev/sr0 De maniere facultative, un nom d'utilisateur peut etre prefixe au nom d'hote en placant un signe @. Par defaut, l'hote distant est atteint a l'aide de la commande rsh(1). A present ssh(1) est plutot utilise 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) installee. Si son nom de chemin ne correspond pas a la valeur de tar par defaut, vous pouvez indiquer a tar le chemin correct en utilisant l'option --rmt-command. --force-local Le fichier d'archive est local meme si un deux-points existe. -F, --info-script=COMMANDE, --new-volume-script=COMMANDE Executer COMMANDE a la fin de chaque bande (-M sous-entendu). La commande peut comporter des arguments. Au demarrage, elle heritera de l'environnement de tar et des variables suivantes : TAR_VERSION Numero de version de GNU tar. TAR_ARCHIVE Le nom de l'archive traitee par tar. TAR_BLOCKING_FACTOR Coefficient de blocs en cours, c'est-a-dire le nombre de blocs de 512 octets dans un enregistrement. TAR_VOLUME Nombre ordinal du volume que tar traite (precise si une archive multi-volume est lue). TAR_FORMAT Format de l'archive traitee. Une des valeurs : gnu, oldgnu, posix, ustar ou v7. TAR_SUBCOMMAND Option courte (precedee d'un tiret) decrivant l'operation que tar execute. TAR_FD Descripteur de fichier pouvant etre utilise pour transmettre le nouveau nom de volume a tar. Si le script d'information echoue, tar quitte. Sinon il commence a ecrire le prochain volume. -L, --tape-length=N Changer de bande apres l'ecriture 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 a utiliser au lieu de 1024. Cette option implique -M. -M, --multi-volume Creer, lister ou extraire une archive multivolume. --rmt-command=COMMANDE Utiliser COMMANDE au lieu de rmt pour acceder a des archives distantes. Consulter la description de l'option -f ci-dessus. --rsh-command=COMMANDE Utiliser COMMANDE au lieu de rsh pour acceder a des archives distantes. Consulter la description de l'option -f ci-dessus. --volno-file=FICHIER Quand cette option est utilisee conjointement avec --multi-volume, tar garde une trace de chaque volume d'une archive multivolume qu'il traite dans FICHIER. Blocage de peripherique -b, --blocking-factor=BLOCS Definir la taille d'enregistrement a BLOCSx512 octets. -B, --read-full-records Lors du listage ou de l'extraction, accepter des enregistrements d'entree incomplets apres 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 Definir la taille d'enregistrement. NOMBRE est le nombre d'octets par enregistrement. Il doit etre 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 autorises. Selection du format d'archive -H, --format=FORMAT Creer une archive du format precise. Les formats autorises sont : gnu format GNU tar 1.13.x ; oldgnu format GNU pour les versions de tar <= 1.12 ; pax, posix format POSIX 1003.1-2001 (pax) ; ustar format POSIX 1003.1-1988 (ustar) ; v7 ancien format tar V7. --old-archive, --portability Identique a --format=v7. --pax-option=motcle[[:]=valeur][,motcle[[:]=valeur]]... Controler les mots-cles lors de la creation d'archives PAX (-H pax). Cette option est equivalente a l'option -o de l'utilitaire pax(1). --posix Identique a --format=posix. -V, --label=TEXTE Creer une archive avec comme nom de volume TEXTE. Lors du listage ou de l'extraction, utiliser TEXTE comme motif avec caracteres generiques pour le nom de volume. Options de compression -a, --auto-compress Utiliser le suffixe de l'archive pour determiner le logiciel de compression. -I, --use-compress-program=COMMANDE Traiter les donnees avec COMMANDE. L'option -d doit etre acceptee pour la decompression. 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 determiner 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). Selection des fichiers locaux --add-file=FICHIER Ajouter FICHIER a l'archive (utile si son nom commence par un tiret). --backup[=CONTROLE] Sauvegarder avant la suppression. L'argument CONTROLE, si fourni, controle la politique de sauvegarde. Les valeurs autorisees sont : none, off Ne jamais realiser de sauvegarde. t, numbered Faire des sauvegardes numerotees. nil, existing Faire des sauvegardes numerotees s'il en existe ou autrement de simples sauvegardes. never, simple Toujours realiser des sauvegardes simples. Si CONTROLE n'est pas fourni, la valeur est determinee par la variable d'environnement VERSION_CONTROL. Si elle n'est pas definie, existing est adopte. -C, --directory=REP Changer a REP avant de realiser toute operation. Cette option est sensible a l'ordre, c'est-a-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 repertoires contenant un fichier CACHEDIR.TAG, sauf le fichier d'etiquette lui-meme. --exclude-caches-all Exclure le contenu des repertoires contenant un fichier CACHEDIR.TAG ainsi que le fichier d'etiquette lui-meme. --exclude-caches-under Exclure tout le contenu des dossiers contenant CACHEDIR.TAG. --exclude-ignore=FICHIER Avant de copier un repertoire, rechercher s'il contient FICHIER. Auquel cas, lire les motifs d'exclusion a partir de ce fichier. Les motifs ne concernent que le repertoire lui-meme. --exclude-ignore-recursive=FICHIER Meme chose que --exclude-ignore, excepte que les motifs de FICHIER affectent le repertoire et ses sous-repertoires. --exclude-tag=FICHIER Exclure le contenu des repertoires contenant le FICHIER, sauf le FICHIER lui-meme. --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 repertoires du systeme de gestion de versions. --exclude-vcs-ignores Exclure les fichiers correspondant aux motifs lus a partir de fichiers ignore specifiques aux systemes 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 pointes. --hard-dereference Suivre les liens materiels. Archiver et copier les fichiers pointes. -K, --starting-file=MEMBRE Commencer a partir du membre indique dans l'archive. --newer-mtime=DATE Traitement des fichiers dont les donnees ont change apres la DATE. Si DATE debute avec / ou ., cela est considere comme un nom de fichier. Le mtime de ce fichier est utilise comme date. --no-null Desactiver l'effet de l'option --null precedente. --no-recursion Empecher le parcours automatique des sous-repertoires. --no-unquote Ne pas supprimer les noms des fichiers ou membres d'entree. --no-verbatim-files-from Traiter chaque ligne lue sur une liste de fichiers comme si elle etait fournie sur la ligne de commande. C'est-a-dire que les espaces de debut ou de fin sont supprimees et, si la chaine resultante commence par un tiret, elle est traitee comme une option de la ligne de commande de tar. C'est le comportement par defaut. L'option --no-verbatim-files-from est fournie comme une maniere de le restaurer apres l'option --verbatim-files-from. Cette option est positionnelle : elle affecte toutes les options --files-from qui apparaissent apres, jusqu'a 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 termines par NULL (desactivation de la gestion speciale de noms debutant par un tiret). Consulter aussi --verbatim-files-from. -N, --newer=DATE, --after-date=DATE Stocker uniquement les fichiers plus recents que DATE. Si DATE debute par / or . il est considere comme un nom de fichier. Le mtime de ce fichier est utilise comme date. --one-file-system Ne pas quitter le systeme de fichiers local lors de la creation de l'archive. -P, --absolute-names Ne pas enlever les barres obliques de debut des noms de fichiers lors de la creation de l'archive. --recursion Explorer recursivement les repertoires (comportement par defaut). --suffix=CHAINE Sauvegarder avant suppression, en ecrasant le suffixe habituel. Le suffixe par defaut est ~, a moins qu'il n'ait ete modifie par la variable d'environnement SIMPLE_BACKUP_SUFFIX. -T, --files-from=FICHIER Obtenir les noms a extraire ou a creer depuis FICHIER. A moins d'indication contraire, le FICHIER doit contenir une liste de noms separes par des LF ASCII (c'est-a-dire, un nom par ligne). Les noms lus sont geres de la meme maniere que les arguments de ligne de commande. Ils sont soumis a la suppression des protections et au decoupage de mots, et toute chaine debutant par - est geree comme une option de ligne de commande de tar. Si ce comportement est indesirable, il peut etre desactive en utilisant l'option --verbatim-files-from. L'option --null commande a tar que les noms dans FICHIER soient separes par le caractere ASCII NUL, au lieu de LF. Cela est utile si la liste est creee par un predicat find(1) -print0. --unquote Enlever les protections des noms de fichier ou de membre (comportement par defaut). --verbatim-files-from Traiter chaque ligne obtenue d'une liste de fichiers comme un nom de fichier, meme si elle debute par un tiret. Les listes de fichiers sont fournies par l'option --files-from (-T). Le comportement par defaut est de gerer les noms fournis dans les listes de fichiers comme s'ils etaient saisis sur la ligne de commande, c'est-a-dire que tout nom commencant par un tiret est traite comme une option de tar. L'option --verbatim-files-from desactive 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 listes dans FICHIER. Afficher les transformations de noms. --strip-components=NOMBRE Supprimer les NOMBRE composants de tete des noms de fichier a 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 debut du nom de fichier. --ignore-case Ignorer la casse. --no-anchored Motifs de recherche correspondant apres n'importe quel / (comportement par defaut pour les exclusions). --no-ignore-case Tenir compte de la casse dans les correspondances (comportement par defaut). --no-wildcards Rechercher des chaines mot pour mot. --no-wildcards-match-slash Pas de correspondance des jokers avec /. --wildcards Utiliser des jokers (comportement par defaut pour les exclusions). --wildcards-match-slash Correspondance des jokers avec / (comportement par defaut pour les exclusions). Sorties informatives --checkpoint[=N] Afficher des messages de progression tous les N enregistrements (10 par defaut). --checkpoint-action=ACTION Executer ACTION a chaque point de verification. --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 precision. --index-file=FICHIER Ecrire une sortie detaillee dans FICHIER. -l, --check-links Afficher un message si l'ensemble des liens n'a pas pu etre copie. --no-quote-chars=CHAINE Desactiver la protection des caracteres de CHAINE. --quote-chars=CHAINE Ajouter les caracteres de protection de CHAINE. --quoting-style=STYLE Definir le style de protection pour les noms de fichiers et de membres. Les valeurs autorisees pour STYLE sont literal, shell, shell-always, c, c-maybe, escape, locale, clocale. -R, --block-number Afficher le numero de bloc au sein de l'archive avec chaque message. --show-omitted-dirs Lister chaque dossier qui ne correspond pas au critere 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 apres transformation par les options --strip et --transform. --totals[=SIGNAL] Afficher le nombre total d'octets apres traitement de l'archive. Si SIGNAL est fourni, afficher ce nombre quand ce signal est emis. Les signaux permis sont : SIGHUP, SIGQUIT, SIGINT, SIGUSR1 et SIGUSR2. Le prefixe SIG peut etre 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=MOTCLE Activer ou desactiver les messages d'avertissement identifies par MOTCLE. Les messages sont supprimes si MOTCLE est prefixe par no- et actives autrement. Multiple --warning options accumulate. Mots-cles controlant les operations generales de tar : all Activer tous les messages d'avertissement. C'est le comportement par defaut. none Desactiver tous les messages d'avertissement. filename-with-nuls "%s: nom de fichier lu contenant un caractere NULL" alone-zero-block "bloc de zeros isole dans %s" Mots-cles applicables pour tar --create : cachedir "%s: etiquette incluse de repertoire de cache %s; %s" file-shrank "%s: fichier reduit de %s octets, remplissage avec des zeros" xdev "%s: fichier sur un systeme de fichiers different, non copie" file-ignored "%s: type de fichier inconnu, fichier ignore" "%s: socket ignore" "%s: appel door ignore" file-unchanged "%s: file non modifie, non copie" ignore-archive "%s: archive cannot contain itself; not dumped" file-removed "%s: fichier supprime avant sa lecture" file-changed "%s: fichier modifie en cours de lecture" failed-read Suppression des avertissements a propos des fichiers ou repertoires non lisibles. Ce mot-cle s'applique uniquement s'il est utilise conjointement avec l'option --ignore-failed-read. Mots-cles applicables pour tar --extract : existing-file "%s: fichier existant ignore" timestamp "%s: ancien horodatage peu plausible %s" "%s: horodatage %s de %s s dans le futur" contiguous-cast "Extraction de fichiers contigus comme des fichiers normaux" symlink-cast "Essai d'extraction de liens symboliques comme des liens physiques" unknown-cast "%s: type de fichier '%c' inconnu, extraction comme un fichier normal" ignore-newer "%s actuel est plus recent ou du meme age" unknown-keyword "Mot-cle d'en-tete etendu inconnu non pris en compte '%s'" decompress-program Controler la description verbeuse des echecs lors d'essai d'execution de programmes alternatifs de decompression. Cet avertissement est desactive par defaut (sauf si --verbose est utilise). Un exemple courant de ce qui peut etre obtenu en utilisant cet avertissement est : $ tar --warning=decompress-program -x -f archive.Z tar (child): cannot run compress: No such file or directory tar (child): trying gzip Cela signifie que tar essaie d'abord de decompresser archive.Z en utilisant compress, et, lors d'un echec, d'utiliser gzip. record-size "Taille d'enregistrement = %lu blocs" Mots-cles controlant l'extraction incrementale : rename-directory "%s: repertoire renomme depuis %s" "%s: repertoire renomme" new-directory "%s: nouveau repertoire" xdev "%s: repertoire sur un peripherique different, pas de purge" bad-dumpdir "repertoire de vidage mal forme, << X >> jamais utilise" -w, --interactive, --confirmation Demander une confirmation pour chaque action. Options de compatibilite -o Lors de creation, identique a --old-archive, lors de l'extraction, identique --no-same-owner. Suffixes de taille Suffixe Unite Equivalence 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 megaoctets TAILLE x 1024^2 P petaoctets TAILLE x 1024^5 T teraoctets TAILLE x 1024^4 w mots TAILLE x 2 VALEUR RENVOYEE Tar's exit code indicates whether it was able to successfully perform the requested operation, and if not, what kind of error occurred. 0 Achever avec succes 1 Some files differ. If tar was invoked with the --compare (--diff, -d) command line option, this means that some files in the archive differ from their disk counterparts. If tar was given one of the --create, --append or --update options, this exit code means that some files were changed while being archived and so the resulting archive does not contain the exact copy of the file set. 2 Erreur fatale. Cela signifie q'une erreur fatale et irrecuperable s'est produite. Si un sous-processus appele par tar s'est termine avec un etat different de zero, tar lui-meme se termine avec ce meme code. Cela peut se produire, par exemple, si une option de compression (telle que -z) etait utilisee et que le programme externe de compression echouait. Un autre exemple est un echec de rmt lors de la sauvegarde vers un peripherique distant. VOIR AUSSI bzip2(1), compress(1), gzip(1), lzma(1), lzop(1), rmt(8), symlink(7), xz(1), zstd(1). Pour un manuel complet de tar, executez info tar ou utilisez le mode information d'emacs(1) pour le lire. Des copies en ligne de la documentation de GNU tar dans des formats differents peuvent etre consultees sur : https://www.gnu.org/software/tar/manual SIGNALEMENTS DE BOGUES Signaler toute erreur a . COPYRIGHT Copyright (C) 2023 Free Software Foundation, Inc. Licence GPLv3+ : GNU GPL version 3 ou ulterieure Ce programme est un logiciel libre. Vous pouvez le modifier et le redistribuer. Il n'y a AUCUNE GARANTIE dans la mesure autorisee par la loi. TRADUCTION La traduction francaise de cette page de manuel a ete creee par Valery Perrin , Thomas Huriaux , Florentin Duneau , Thomas Blein , David Prevot et Jean-Paul Guillonneau Cette traduction est une documentation libre ; veuillez vous reporter a la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE. Si vous decouvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message a . TAR July 11, 2022 TAR(1)