This text is a work in progress—highly subject to change—and may not accurately describe any released version of the Apache™ Subversion® software. Bookmarking or otherwise referring others to this page is probably not such a smart idea. Please visit http://www.svnbook.com/ for stable versions of this book.

Nom

svnadmin dump — Décharger le contenu du système de fichiers vers stdout.

Synopsis

svnadmin dump CHEMIN_DÉPÔT [-r BAS[:HAUT]] [--incremental] [--deltas]

Description

Décharger le contenu du système de fichiers vers stdout dans le format portable « dump », L'avancement de l'opération est envoyé vers stderr. Les révisions de BAS jusqu'à HAUT sont déchargées. Si aucune révision n'est spécifiée, toutes les révisions sont déchargées. Si seule BAS est spécifiée, décharge uniquement cette révision. Reportez-vous à la section intitulée « Migration des données d'un dépôt » pour la description pratique de l'utilisation de cette commande.

Par défaut, le flux dump Subversion ne contient qu'une seule révision (la première dans l'intervalle demandé) dans laquelle tous les fichiers et les répertoires sont indiqués comme ayant été ajoutés d'un seul coup ; les autres révisions (spécifiées par l'intervalle de révisions) ne contiennent que les fichiers et les répertoires qui ont été modifiés par ces révisions. Pour un fichier modifié, le contenu entier du fichier (en représentation plein-texte), ainsi que ses propriétés, est présent dans le fichier dump. Pour un répertoire, toutes les propriétés sont présentes.

Deux options modifient le comportement par défaut du générateur de flux dump. La première est l'option --incremental qui force la première révision à ne contenir que les fichiers et répertoires modifiés lors de cette révision (au lieu de l'ensemble de l'arborescence) au même format que les autres révisions d'un flux dump. Cette option est utile pour générer un fichier dump relativement petit pour être chargé dans un autre dépôt qui est déjà au courant des révisions précédentes du dépôt original.

L'autre option est --deltas. Cette option indique à svnadmin dump de, au lieu de générer des représentations en plein-texte du contenu des fichiers et la liste des propriétés, générer uniquement le delta des éléments concernés par rapport à leur version antérieure. Cette option réduit (drastiquement dans certains cas) la taille du fichier dump produit par svnadmin dump. Il y a cependant des inconvénients à utiliser cette option : la production de fichiers dump delta est plus consommatrice de puissance CPU, ces fichiers ne peuvent pas être traités par svndumpfilter et ils se révèlent être moins facilement compressés par des outils tiers tels que gzip ou bzip2.

[Astuce] Astuce

À partir de Subversion 1.8, svndumpfilter peut traiter les flux « deltifiés ». Avant cette version, svndumpfilter ne pouvait pas traiter les flux dump générés en utilisant l'option --deltas.

Options

Exemples

Décharger complètement le dépôt :

$ svnadmin dump /var/svn/depot > depot-complet.dump
* Révision 0 déchargée.
* Révision 1 déchargée.
* Révision 2 déchargée.
…

Décharger seulement l'incrément d'une seule révision du dépôt :

$ svnadmin dump /var/svn/depot -r 21 --incremental > increment.dump
* Révision 21 déchargée.