Provided by: manpages-fr_4.18.1-1_all bug

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] ARCHIVE ARCHIVE

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

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

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

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

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

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

   Utilisation de style GNU
       tar {--catenate|--concatenate} [OPTIONS] ARCHIVE ARCHIVE

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

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

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

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

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

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

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

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

       tar {--extract|--get} [-f ARCHIVE] [OPTIONS] [MEMBRE...]

NOTE

       Cette page de manuel est une courte description de GNU tar. Pour une explication détaillée
       comprenant des exemples et des recommandations d’utilisation,  veuillez  vous  référer  au
       manuel  de  GNU Tar disponible au format texinfo. Si le programme info et la documentation
       de tar sont correctement installés sur votre système, la commande

           info tar

       devrait vous donner accès 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

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

       Si des divergences entre ce manuel et le manuel de GNU Tar apparaissaient, ce dernier doit
       être considéré comme faisant autorité.

DESCRIPTION

       GNU tar est un programme d’archivage conçu pour stocker plusieurs fichiers  dans  un  seul
       (une  archive)  et  pour manipuler de telles archives. L’archive peut être soit un fichier
       normal, soit un périphérique (par exemple, un lecteur de bande — tape drive — d’où le  nom
       signifiant tape archiver), qui peut être situé sur une machine locale ou distante.

   Styles des options
       Les  options  pour  GNU  tar  peuvent  être indiquées de trois façons différentes. Dans le
       « style traditionnel », le premier argument est un groupe de lettres d’option et tous  les
       arguments suivants fournissent les arguments nécessaires à ces options. Les arguments sont
       lus dans le même ordre que les lettres d’option. Chaque mot de la ligne  de  commande  qui
       subsiste  après que toutes les options aient été traitées, est considéré comme un argument
       non optionnel : un nom de membre de fichier ou d’archive.

       Par exemple, l’option c demande la création d’une archive, l’option v demande  l’opération
       verbosité  et  l’option f prend un argument qui détermine le nom de l’archive sur laquelle
       agir. La commande suivante, écrite dans le style traditionnel, ordonne à  tar  de  stocker
       tous les fichiers du répertoire /etc dans le fichier d’archive etc.tar de manière verbeuse
       en listant tous les fichiers archivés :

       tar cfv etc.tar /etc

       Dans UNIX ou avec le style option courte, chaque lettre  d’option  est  préfixée  avec  un
       tiret  unique, comme dans les autres utilitaires en ligne de commande. Si une option prend
       un argument, celui-ci la suit, soit comme un mot  séparé  de  la  ligne  de  commande,  ou
       immédiatement après cette option. Cependant, si cette option prend un argument facultatif,
       celui-ci doit suivre la lettre d’option  sans  espace  intermédiaire,  comme  par  exemple
       -g/tmp/snar.db.

       N’importe quel nombre d’options ne prenant pas d’argument peuvent être regroupées après un
       seul tiret, par exemple, -vkp. Les  options  prenant  un  argument  (soit  obligatoire  ou
       facultatif) peuvent figurer à la fin d’un tel groupement, par exemple, -vkpf a.tar.

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

       tar -cvf etc.tar /etc
       ou
       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
       ou (en abrégeant quelques options) :
       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
       Les options listées dans l’énumération ci-dessous indiquent à GNU tar quelle opération est
       à réaliser. Exactement,  une  d’entre  elles  doit  être  fournie.  La  signification  des
       arguments non facultatifs dépend du mode d’opération demandé.

       -A, --catenate, --concatenate
              Joindre  une archive à la fin d’une autre archive. Les arguments sont traités comme
              des noms d’archive à ajouter. Toutes les archives doivent être du même  format  que
              l’archive  à  laquelle elles sont ajoutées, autrement l’archive résultante pourrait
              ne pas être utilisable par les implémentations non GNU de tar. Il est  à  remarquer
              que  si  plus  d’une  archive  est  fournie, les membres de l’archive autres que le
              premier seront accessibles dans  l’archive  résultante  seulement  si  l’option  -i
              (--ignore-zeros) est utilisée.

              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
              Joindre des fichiers plus récents que leurs copies correspondantes dans  l’archive.
              Les  arguments  ont  la  même  signification qu’avec les options -c et -r. Il est à
              remarquer que les nouveaux fichiers ne remplacent par  les  anciennes  copies  dans
              l’archive, mais sont plutôt ajoutés à la fin de celle-ci. L’archive résultante peut
              par conséquent contenir plusieurs membres du même nom, correspondant  aux  diverses
              versions du même fichier.

       -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
              Afficher les valeurs internes par défaut pour les différentes  options  de  tar  et
              quitter. Aucun argument n’est permis

       -?, --help
              Afficher  un  aide-mémoire  des  options  courtes  et quitter. Aucun argument n’est
              permis.

       --usage
              Afficher une liste des options disponibles et quitter. Aucun argument n’est permis.

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

OPTIONS

   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
              Gérer  les sauvegardes incrémentales au nouveau format GNU. FICHIER est le nom d’un
              fichier d’instantané où tar stocke les informations complémentaires utilisées  pour
              déterminer  quels  fichiers  ont changé depuis la dernier vidage (dump) incrémental
              et, par conséquent, doivent être copiés de nouveau. Si FICHIER n’existe pas lors de
              la  création  de  l’archive,  il  sera  créé  et tous les fichiers seront ajoutés à
              l’archive résultante (le vidage de level 0). Pour créer des archives  incrémentales
              de niveau N différent de zéro, il faut créer une copie du fichier d’instantané créé
              durant le niveau N-1 et l’utiliser comme FICHIER.

              Lors du listage ou de l’extraction,  le  contenu  effectif  de  FICHIER  n’est  pas
              inspecté.  Celui-ci  est  nécessaire uniquement pour des besoins syntaxiques. C’est
              pourquoi une pratique courante est d’utiliser /dev/null à sa 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
              Définir  le  niveau  de  vidage  pour  créer des archives incrémentales à l’aide de
              listes. Actuellement seulement --level=0 est valable. Il ordonne à tar de  tronquer
              le fichier d’instantané avant le vidage, donc obligeant à un vidage de niveau 0.

       -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]
              Définir  la  version du format « creux » (sparse) à utiliser. Cette option implique
              --sparse. Les valeurs d’argument valables sont 0.0, 0.1 et 1.0. Pour de plus amples
              détails, veuillez vous référer au manuel de GNU Tar, annexe D, "Sparse Formats". En
              utilisant l’afficheur info, ce manuel est consultable avec la commande :  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 :

              TAR_FILETYPE
                     Type du fichier. Il s’agit  d’une  seule  lettre  ayant  les  significations
                     suivantes :

                             f           Regular file (fichier normal)
                             d           Directory (répertoire)
                             l           Symbolic link (lien symbolique)
                             h           Hard link (lien physique)
                             b           Block device (périphérique bloc)
                             c           Character device (périphérique caractère)

                     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 stocké dans l’archive.

              TAR_UNAME
                     Nom du propriétaire du fichier.

              TAR_GNAME
                     Nom du groupe propriétaire du fichier.

              TAR_ATIME
                     Heure  du  dernier  accès. C’est un nombre décimal représentant le nombre de
                     secondes depuis « l’Époque ». Si l’archive fournit une précision de  l’ordre
                     des  nanosecondes,  celles-ci  sont  ajoutées  à l’horodatage après un point
                     décimal.

              TAR_MTIME
                     Date de la dernière modification.

              TAR_CTIME
                     Date du dernier changement d’état

              TAR_SIZE
                     Taille du fichier.

              TAR_UID
                     UID du propriétaire du fichier.

              TAR_GID
                     GID du propriétaire du fichier.

              De  plus,  les  variables  suivantes  contiennent  des  informations  sur  le  mode
              d’opération de tar et de l’archive traitée :

              TAR_VERSION
                     Numéro de version de GNU tar.

              TAR_ARCHIVE
                     Le nom de l’archive traitée par tar.

              TAR_BLOCKING_FACTOR
                     Coefficient de blocs en cours, c'est-à-dire le nombre de blocs de 512 octets
                     dans un enregistrement.

              TAR_VOLUME
                     Nombre ordinal du volume que tar traite (précisé si une archive multi-volume
                     est lue).

              TAR_FORMAT
                     Format  de l’archive traitée. Une des valeurs : gnu, oldgnu, posix, ustar ou
                     v7.

              TAR_SUBCOMMAND
                     Option courte (précédée d’un tiret) décrivant l’opération que tar exécute.

   Gestion des attributs de fichier
       --atime-preserve[=MÉTHODE]
              Conserver les dates d'accès des fichiers archivés, soit  en  les  restaurant  après
              lecture  (MÉTHODE=replace  par  défaut),  soit  en  ne  définissant  pas  les dates
              initialement MÉTHODE=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
              Extraire les informations sur les permissions de fichiers (comportement par  défaut
              pour le superutilisateur).

       --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
              Trier les noms pour extraire en correspondance avec l'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
              Préciser le motif d’exclusion pour les clés de  xattr.  MOTIF  est  une  expression
              rationnelle POSIX normale, par exemple, --xattrs-exclude='^user.', pour exclure des
              noms d’attribut de l’espace de noms de l’utilisateur.

       --xattrs-include=MOTIF
              Préciser le motif d'inclusion pour les clés de  xattr.  MOTIF  est  une  expression
              rationnelle POSIX normale.

   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 :

              TAR_VERSION
                     Numéro de version de GNU tar.

              TAR_ARCHIVE
                     Le nom de l’archive traitée par tar.

              TAR_BLOCKING_FACTOR
                     Coefficient de blocs en cours, c'est-à-dire le nombre de blocs de 512 octets
                     dans un enregistrement.

              TAR_VOLUME
                     Nombre ordinal du volume que tar traite (précisé si une archive multi-volume
                     est lue).

              TAR_FORMAT
                     Format  de l’archive traitée. Une des valeurs : gnu, oldgnu, posix, ustar ou
                     v7.

              TAR_SUBCOMMAND
                     Option courte (précédée d’un tiret) décrivant l’opération que tar exécute.

              TAR_FD Descripteur de fichier pouvant être utilisé pour transmettre le nouveau  nom
                     de volume à tar.

              Si  le  script  d’information  échoue,  tar  quitte.  Sinon il commence à écrire le
              prochain volume.

       -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
              Ignorer les blocs constitués de zéros dans l’archive. Normalement,  deux  blocs  de
              512 octets  consécutifs  remplis  de  zéros  signifient EOF et tar cesse sa lecture
              après leur rencontre. Cette option commande de lire plus loin et est utile lors  de
              la lecture d’archives créées avec l’option -A.

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

              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 à --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 :

              none, off
                     Ne jamais réaliser de sauvegarde.

              t, numbered
                     Faire des sauvegardes numérotées.

              nil, existing
                     Faire  des  sauvegardes  numérotées  s’il  en existe ou autrement de simples
                     sauvegardes.

              never, simple
                     Toujours réaliser des sauvegardes simples.

              Si  CONTROLE  n’est  pas  fourni,  la  valeur  est  déterminée  par   la   variable
              d’environnement VERSION_CONTROL. Si elle n’est pas définie, existing est adopté.

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

              Cette option affecte toutes les options --files-from qui  apparaissent  après  elle
              sur    la    ligne    de   commande.   Cet   effet   est   inversé   par   l’option
              --no-verbatim-files-from.

              Cette option est implicite à l’option --null.

              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
              Définir  la  date uniquement si la création du fichier est plus récente que la date
              donnée avec --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
              Lister de manière verbeuse les fichiers traités. Chaque instance  de  cette  option
              sur  la  ligne de commande augmente le niveau de verbosité de un. Le niveau maximal
              est trois. Pour des explications détaillées  sur  la  façon  dont  les  niveaux  de
              verbosité  affectent  la sortie de tar, veuillez vous référer au manuel de GNU Tar,
              sous-section 2.5.1 "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.

              Plusieurs messages --warning peuvent s’ajouter.

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

              all    Activer tous les messages d’avertissement. C’est le comportement par défaut.

              none   Désactiver tous les messages d’avertissement.

              filename-with-nuls
                     "%s: nom de fichier lu contenant un caractère NULL"

              alone-zero-block
                     "bloc de zéros isolé dans %s"

              Mots-clés applicables pour tar --create :

              cachedir
                     "%s: étiquette incluse de répertoire de cache %s; %s"

              file-shrank
                     "%s: fichier réduit de %s octets, remplissage avec des zéros"

              xdev   "%s: fichier sur un système de fichiers différent, non copié"

              file-ignored
                     "%s: type de fichier inconnu, fichier ignoré"
                     "%s: socket ignoré"
                     "%s: appel door ignoré"

              file-unchanged
                     "%s: file non modifié, non copié"

              ignore-archive
                     "%s: le fichier est l’archive, non copié"

              file-removed
                     "%s: fichier supprimé avant sa lecture"

              file-changed
                     "%s: fichier modifié en cours de lecture"

              failed-read
                     Suppression  des  avertissements  à  propos  des fichiers ou répertoires non
                     lisibles. Ce mot-clé s’applique uniquement s’il  est  utilisé  conjointement
                     avec l’option --ignore-failed-read.

              Mots-clés applicables pour tar --extract :

              existing-file
                     "%s: fichier existant ignoré"

              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 récent ou du même âge"

              unknown-keyword
                     "Mot-clé d’en-tête étendu inconnu non pris en compte '%s'"

              decompress-program
                     Contrôler  la  description  verbeuse  des échecs lors d’essai d’exécution de
                     programmes alternatifs de décompression. Cet avertissement est désactivé par
                     défaut  (sauf  si  --verbose est utilisé). Un exemple courant de ce qui peut
                     être 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 décompresser archive.Z en  utilisant
                     compress, et, lors d’un échec, d’utiliser gzip.

              record-size
                     "Taille d’enregistrement = %lu blocs"

              Mots-clés contrôlant l’extraction incrémentale :

              rename-directory
                     "%s: répertoire renommé depuis %s"
                     "%s: répertoire renommé"

              new-directory
                     "%s: nouveau répertoire"

              xdev   "%s: répertoire sur un périphérique différent, pas de purge"

              bad-dumpdir
                     "répertoire de vidage mal formé, « X » jamais utilisé"

       -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

VALEUR RENVOYÉE

       Le code de retour de tar indique s’il a pu réaliser l’opération  demandée,  et  sinon,  le
       type d’erreurs rencontrées.

       0      Achever avec succès

       1      Quelques  fichiers  diffèrent.  Si  tar  a  été  invoqué  avec l’option de ligne de
              commande --compare (--diff, -d), cela signifie que quelques fichiers dans l’archive
              ne  sont pas identiques à leurs homologues sur le disque. Si tar a reçu les options
              --create, --append ou --update, ce code de retour signifie  que  certains  fichiers
              ont  été  modifiés  durant l’archivage et donc que l’archive résultante ne contient
              pas une copie exacte de l’ensemble des fichiers.

       2      Erreur fatale. Cela signifie q’une erreur fatale et irrécupérable s’est produite.

       Si un sous-processus appelé par tar s’est terminé avec un  état  différent  de  zéro,  tar
       lui-même  se  termine avec ce même code. Cela peut se produire, par exemple, si une option
       de compression (telle que -z) était utilisée et que le programme  externe  de  compression
       échouait.  Un autre exemple est un échec de rmt lors de la sauvegarde vers un périphérique
       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,  exécutez  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 différents peuvent
       être consultées sur :

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

SIGNALEMENTS DE BOGUES

       Signaler toute erreur à <bug-tar@gnu.org>.

COPYRIGHT

       Copyright © 2013-2019 Free Software Foundation, Inc.
       Licence GPLv3+ : GNU GPL version 3 ou ultérieure <http://gnu.org/licenses/gpl.html>
       Ce programme est un logiciel libre. Vous pouvez le modifier et le redistribuer. Il  n'y  a
       AUCUNE GARANTIE dans la mesure autorisée par la loi.

TRADUCTION

       La  traduction  française  de  cette  page  de  manuel  a  été  créée  par  Valéry  Perrin
       <valery.perrin.debian@free.fr>,  Thomas  Huriaux   <thomas.huriaux@gmail.com>,   Florentin
       Duneau    <fduneau@gmail.com>,    Thomas    Blein    <tblein@tblein.eu>,    David   Prévot
       <david@tilapin.org> et Jean-Paul Guillonneau <guillonneau.jeanpaul@free.fr>

       Cette traduction est une documentation libre ; veuillez vous reporter  à  la  GNU  General
       Public   License   version 3  ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩  concernant  les
       conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

       Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un
       message à ⟨debian-l10n-french@lists.debian.org⟩.