Provided by: manpages-fr-extra_20111118_all bug

NOM

     tar — Version GNU de l'utilitaire tar de gestion d'archives

SYNOPSIS

     tar [-] A --catenate --concatenate | c --create | d --diff --compare |
         --delete | r --append | t --list | --test-label | u --update | x
         --extract --get [options] [chemin ...]

DESCRIPTION

     Tar stocke et extrait des fichiers d'une archive de bande ou de disque.

     Le premier argument de tar doit être une fonction ; soit une des lettres
     Acdrtux, soit un des noms longs de fonction. Une lettre de fonction ne
     doit pas être préfixée par « - » et peut être combinée avec d'autres
     options lettre. Une fonction longue doit être préfixée par --. Certaines
     options prennent des paramètres ; avec la forme lettre ils doivent être
     précisés comme arguments séparés. Avec la forme longue ils peuvent être
     précisés en ajoutant =valeur à l'option.

CHOIX DE L'ACTION

     Mode d'opération principal :

     -A, --catenate, --concatenate
           Met bout-à-bout plusieurs fichiers d'archive.

     -c, --create
           Crée une nouvelle archive.

     -d, --diff, --compare
           Cherche les différences entre les fichiers indiqués et ceux
           contenus dans le fichier archive.

     --delete
           Supprime du contenu de l'archive. Cette option ne doit pas être
           utilisée avec les lecteurs de bandes !

     -r, --append
           Sauvegarde les fichiers indiqués à la fin d'une archive.

     -t, --list
           Affiche la liste des fichiers contenus dans une archive.

     --test-label
           Teste l'étiquette du volume de l'archive et quitte.

     -u, --update
           N'ajoute que les fichiers plus récents que ceux de même nom déjà
           présents dans l'archive.

     -x, --extract, --get
           Extrait les fichiers contenus dans une archive.

AUTRES OPTIONS

     Modificateur d'opération :

     -[0-7][lmh]
           Précise le lecteur et la densité.

     -a, --auto-compress
           Utilise le suffixe de l'archive pour déterminer le logiciel de
           compression.

     --add-file=FICHIER
           Ajoute le FICHIER précisé à l'archive (utile si son nom commence
           par un tiret).

     --anchored
           Les motifs de recherche correspondants au début du nom de fichier.

     --no-anchored
           Les motifs de recherche correspondent après n'importe quel « / »
           (c'est le comportement par défaut pour les exclusions).

     --atime-preserve[=MTHODE]
           Préserve la date d'accès des fichiers archivés, soit en la
           restaurant après lecture (MTHODE = « replace » par défaut), soit
           en ne définissant pas les dates initialement (MTHODE =
           « system »).

     --no-auto-compress
           N'utilise pas le suffixe de l'archive pour déterminer le logiciel
           de compression.

     -b, --blocking-factor BLOCS
           Utilise BLOCS x 512 octets par enregistrement.

     -B, --read-full-records
           Reconstitue des blocs valides (pour les tuyaux (pipes) BSD 4.2).

     --backup[=CONTRLE]
           Faire une copie de sauvegarde avant suppression, choisir le
           CONTRLE de version.

     -C, --directory DOSSIER
           Exécute la commande à partir du répertoire DOSSIER.

     --check-device
           Vérifie les numéros de périphérique lors de la création d'archives
           incrémentielles. C'est le comportement par défaut.

     --no-check-device
           Ne vérifie pas les numéros de périphérique lors de la création
           d'archives incrémentielles.

     --checkpoint[=NOMBRE]
           Affiche des messages de progression tous les NOMBRE enregistrements
           (10 par défaut).

     --checkpoint-action=ACTION
           Exécute ACTION à chaque point de vérification.

     --delay-directory-restore
           Reporte à la fin de l'extraction le changement des dates de
           modification et des permissions des répertoires extraits.

     --no-delay-directory-restore
           Annule l'effet de l'option --delay-directory-restore.

     --exclude=MOTIF
           Exclut du traitement les fichiers qui correspondent au MOTIF.

     --exclude-backups
           Exclut du traitement les fichiers verrouillés et de sauvegarde.

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

     --exclude-caches-all
           Exclut du traitement les dossiers contenant CACHEDIR.TAG.

     --exclude-caches-under
           Exclut du traitement tout dans les dossiers contenant CACHEDIR.TAG.

     --exclude-tag=FICHIER
           Exclut le contenu des répertoires contenant le FICHIER, sauf le
           FICHIER lui-même.

     --exclude-tag-all=FICHIER
           Exclut du traitement les dossiers contenant FICHIER.

     --exclude-tag-under=FICHIER
           Exclut du traitement tout dans les dossiers contenant FICHIER.

     --exclude-vcs
           Exclut du traitement les dossiers utilisés par les système de
           gestion de versions.

     -f, --file ARCHIVE
           Utilise le fichier d'archive ou le périphérique ARCHIVE.

     -F, --info-script, --new-volume-script NOM
           Exécute un script à la fin de chaque bande (implique l'option -M).

     --force-local
           Impose que le fichier d'archive soit sur le système de fichiers
           local même si le nom contient un signe deux-points.

     --full-time
           Affiche la date des fichiers avec le maximum de précision.

     -g, --listed-incremental FICHIER
           Gère les sauvegardes incrémentielles dans le nouveau format GNU.

     -G, --incremental
           Gère les sauvegardes incrémentielles dans l'ancien format GNU.

     --group=NOM
           Force NOM comme groupe pour les fichiers ajoutés.

     -h, --dereference
           Suit les liens symboliques ; sauvegarde et restaure les fichiers
           pointés.

     -H, --format FORMAT
           Créer une archive du format précisé. FORMAT peut être l'une des
           possibilités suivantes :

           --format=gnu
                 format GNU tar 1.13.x ;

           --format=oldgnu
                 format GNU pour les versions de tar <= 1.12 ;

           --format=pax
                 format POSIX 1003.1-2001 (pax) ;

           --format=posix
                 identique à pax ;

           --format=ustar
                 format POSIX 1003.1-1988 (ustar) ;

           --format=v7
                 ancien format tar V7.

     --hard-dereference
           Suit les liens matériels ; sauvegarde et restaure les fichiers
           pointés.

     -i, --ignore-zeros
           Ignore, dans l'archive, les blocs de zéros (correspondant à des fin
           de fichier (« EOF »)).

     -I, --use-compress-program PROG
           Traite l'archive avec le programme PROG (qui doit accepter l'option
           -d pour la décompresser).

     --ignore-case
           Ignore la casse.

     --no-ignore-case
           Tient compte de la casse dans les recherches. C'est le comportement
           par défaut.

     --ignore-command-error
           Ignore les codes de retour des fils.

     --no-ignore-command-error
           Considère les codes de sortie non nuls des enfants comme des
           erreurs.

     --ignore-failed-read
           N'arrête pas l'exécution en renvoyant un code de retour non nul, si
           un fichier est illisible.

     --index-file=FICHIER
           Écrit la sortie détaillée dans FICHIER.

     -j, --bzip2

     -J, --xz

     -k, --keep-old-files
           Ne pas remplacer les fichiers existants lors de l'extraction.

     -K, --starting-file NOM-DU-MEMBRE
           Commence l'extraction à partir du membre NOM-DU-MEMBRE dans
           l'archive.

     --keep-newer-files
           Ne remplace pas les fichiers existants si leur version est plus
           récente que leur copie dans l'archive.

     -l, --check-links
           Affiche un message si tous les liens n'ont pas pu être explorés.

     -L, --tape-length NOMBRE
           Change la bande (la cassette, la disquette, le support) après avoir
           écrit NOMBRE x 1024 octets.

     --level=NOMBRE
           Affiche le niveau lors de la création d'une archive incrémentielle
           listée.

     --lzip

     --lzma

     --lzop

     -m, --touch
           Ne restaure pas la date de modification du fichier extrait.

     -M, --multi-volume
           Crée, liste ou extrait les archives multi-volumes.

     --mode=CHANGEMENTS
           Force (symboliquement) les droits CHANGEMENTS pour les fichiers
           ajoutés.

     --mtime=DATE-OU-FICHIER
           Définit la date de modification pour les fichiers ajoutés à
           DATE-OU-FICHIER.

     -n, --seek
           Active le positionnement dans l'archive.

     -N, --newer, --after-date DATE-OU-FICHIER
           Ne sauvegarde que les fichiers plus récents que DATE-OU-FICHIER.

     --newer-mtime=DATE
           Ne compare que la date et l'heure de modification des données.

     --null
           -T lit les noms terminés par un caractère nul, désactive -C.

     --no-null
           Annule l'effet de l'option --null précédente.

     --numeric-owner
           Utilise systématiquement des nombres pour les noms d'utilisateur ou
           de groupe.

     -O, --to-stdout
           Extrait les fichiers vers la sortie standard.

     --occurrence[=NOMBRE]
           Traite seulement la NOMBREiè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. NOMBRE vaut 1 par défaut.

     --old-archive, --portability
           Identique à --format=v7.

     --one-file-system
           Reste dans le système de fichiers local lors de la création de
           l'archive.

     --overwrite
           Écrase les fichiers existants lors de l'extraction.

     --overwrite-dir
           Écrase les méta-données des dossiers existants lors de
           l'extraction. C'est le comportement par défaut.

     --no-overwrite-dir
           Préserve les méta-données des dossiers existants.

     --owner=NOM
           Force l'affectation des fichiers ajoutés à NOM.

     -p, --preserve-permissions, --same-permissions
           Extrait les informations sur les permissions de fichiers. C'est la
           valeur par défaut pour le superutilisateur.

     -P, --absolute-names
           N'enlève pas les « / » des noms de fichiers.

     --pax-option=cl[[:]=valeur][,cl[[:]=valeur]]...
           Contrôle les mots clés pax.

     --posix
           Identique à --format=posix.

     --preserve
           Identique à -p et -s à la fois.

     --quote-chars=CHANE
           Ajoute un niveau de commentaire pour les caractères de CHANE.

     --no-quote-chars=CHANE
           Décommente les caractères de CHANE.

     --quoting-style=STYLE
           Définit le style de commentaire ; voir ci-dessous pour la liste des
           valeurs de STYLE.

     -R, --block-number
           Ajoute, à chaque message, le numéro de bloc au sein de l'archive.

     --record-size=NOMBRE
           NOMBRE d'octets par enregistrement, multiple de 512.

     --recursion
           Explore récursivement les sous-répertoires. C'est le comportement
           par défaut.

     --no-recursion
           Empêche de descendre automatiquement dans les sous-répertoires.

     --recursive-unlink
           Vide la hiérarchie de répertoires avant d'extraire un dossier.

     --remove-files
           Supprime les fichiers après les avoir sauvegardés dans l'archive.

     --restrict
           Désactive l'utilisation d'options potentiellement dangereuses.

     --rmt-command=COMMANDE
           Utilise la COMMANDE rmt donnée au lieu de rmt.

     --rsh-command=COMMANDE
           Utilise la COMMANDE distante au lieu de rsh.

     -s, --preserve-order, --same-order
           La liste des fichiers à restaurer est triée suivant l'ordre de
           l'archive.

     -S, --sparse
           Traite efficacement les fichiers discontinus.

     --same-owner
           Affecte les fichiers extraits à leur propriétaire lors de la
           sauvegarde. C'est le comportement par défaut pour le
           superutilisateur.

     --no-same-owner
           Affecte les fichiers extraits à l'utilisateur actuel. C'est la
           valeur par défaut sauf pour le superutilisateur.

     --no-same-permissions
           Applique le masque de droits de l'utilisateur aux fichiers
           extraits. C'est la valeur par défaut sauf pour le superutilisateur.

     --no-seek
           Désactive le positionnement dans l'archive.

     --show-defaults
           Affiche les options par défaut de tar.

     --show-omitted-dirs
           Liste chaque dossier qui ne correspond pas au critère de recherche
           lors de l'exploration ou de l'extraction de l'archive.

     --show-transformed-names, --show-stored-names
           Affiche le nom des fichiers ou des archives après transformation.

     --sparse-version=MAJEUR[.MINEUR]
           Définit la version du format de fichier discontinu à utiliser
           (implique --sparse).

     --strip-components=NOMBRE
           Enlève NOMBRE niveaux de hiérarchie des noms de fichiers lors de
           l'extraction.

     --suffix=CHANE
           Sauvegarde avant suppression, en ajoutant le préfixe habituel
           (« ~ » à moins qu'il n'ait été modifié à l'aide de la variable
           d'environnement SIMPLE_BACKUP_SUFFIX).

     -T, --files-from FICHIER
           Obtient la liste des fichiers à extraire ou à créer depuis FICHIER.

     --to-command=COMMANDE
           Envoie les fichiers extraits vers la sortie standard.

     --totals[=SIGNAL]
           Affiche le nombre total d'octets après traitement de l'archive.
           Avec un argument, affiche ce nombre si le SIGNAL est émis. Les
           signaux permis sont : SIGHUP, SIGQUIT, SIGINT, SIGUSR1 et SIGUSR2.
           Les noms sans préfixe « SIG » sont aussi acceptés.

     --transform, --xform EXPRESSION
           Utilise « sed replace EXPRESSION » pour transformer les noms de
           fichier.

     -U, --unlink-first
           Supprime chaque fichier avant d'extraire par dessus.

     --unquote
           Décommente les noms de fichier lus avec -T. C'est le comportement
           par défaut.

     --no-unquote
           Ne décommente pas les noms de fichier lus avec -T.

     --utc
           Affiche les dates de modification des fichiers à l'heure
           universelle (UTC).

     -v, --verbose
           Affiche la liste détaillée des fichiers traités. NdT : le
           doublement de cette option (-vv) produit un affichage encore plus
           détaillé.

     -V, --label TEXTE
           Crée une archive avec comme nom de volume TEXTE ; lors de
           l'exploration ou de l'extraction, utilise TEXTE comme motif global
           pour le nom de volume.

     --volno-file=FICHIER
           Utilise ou met à jour le numéro de volume dans FICHIER.

     -w, --interactive, --confirmation
           Demande une confirmation pour chaque action.

     -W, --verify
           Tente de vérifier l'archive après l'avoir écrite.

     --warning=NOM
           Contrôle d'avertissement.

     --wildcards
           Utilise les caractères de substitution. C'est le comportement par
           défaut lors de l'exclusion.

     --wildcards-match-slash
           Permet aux caractères de substitution de remplacer des « / ». C'est
           le comportement par défaut lors de l'exclusion.

     --no-wildcards-match-slash
           Ne permet pas aux caractères de substitution de remplacer des
           « / ».

     --no-wildcards
           Recherche textuelle des chaînes.

     -X, --exclude-from FICHIER
           Motifs d'exclusion listés dans FICHIER.

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

     -Z, --compress, --uncompress

ENVIRONNEMENT

     Le comportement de tar est contrôlé par les variables d'environnement
     suivantes, parmi d'autres :

     SIMPLE_BACKUP_SUFFIX
             Préfixe de sauvegarde à utiliser lors de l'extraction si --suffix
             n'est pas précisé. Le suffixe de sauvegarde par défaut est « ~ »
             si ni préfixe ni suffixe n'est spécifié.

     TAR_OPTIONS
             Options à ajouter avant celles indiquées dans la ligne de
             commande, séparées par des espaces. Les barres obliques inversées
             (« backslash ») peuvent être utilisées pour protéger des espaces
             ou d'autres barres obliques inversées, et ce sans option
             particulière.

     TAPE    Périphérique ou fichier à utiliser pour l'archive si l'option
             --file n'est pas utilisée. Si cette variable d'environnement
             n'est pas spécifiée, stdin et stdout sont utilisés à la place.

     TAR_LONGLINK_100

EXEMPLES

     Crée l'archive.tar à partir des fichiers truc et bidule.
           tar -cf archive.tar truc bidule
     Affiche la liste détaillée des fichiers de archive.tar.
           tar -tvf archive.tar
     Extrait tous les fichiers contenus dans archive.tar.
           tar -xf archive.tar

VOIR AUSSI

     tar(5), symlink(7), rmt(8)

HISTORIQUE

     La commande tar apparaît dans Version 7 AT&T UNIX.

BOGUES

     Généralement, les gens du projet GNU détestent écrire des pages de manuel
     et créent à la place des documents « info ». Malheureusement le document
     « info » qui décrit tar est sous licence GFDL et comporte des parties non
     modifiables, ce qui rend impossible d'inclure tout texte de ce document
     dans cette page de manuel. La majeure partie du texte de ce document a
     été extraite automatiquement des message d'utilisation à partir du code
     source. Il peut ne pas décrire complètement toutes les possibilités du
     programme.

TRADUCTION

     Cette page de manuel a été traduite par Jérome Signouret en 2000 et mise
     à jour par Christophe Blaess en 2003. Elle a également été relue par
     Gérard Delafond. Elle a ensuite été maintenue par Valéry Perrin
     <valery.perrin.debian@free.fr>, Thomas Huriaux
     <thomas.huriaux@gmail.com>, et Florentin Duneau <fduneau@gmail.com>.

     Elle est dorénavant maintenue par Thomas Blein <tblein@tblein.eu> et les
     membres de la liste <debian-l10n-french@lists.debian.org>. Veuillez
     signaler toute erreur de traduction par un rapport de bogue sur le paquet
     manpages-fr-extra.