Diese Dokumentation wurde zur Beschreibung der Serie 1.6.x von Subversion erstellt. Falls Sie eine unterschiedliche Version von Subversion einsetzen, sei Ihnen dringend angeraten, bei http://www.svnbook.com/ vorbeizuschauen und stattdessen die zu Ihrer Version von Subversion passende Version dieser Dokumentation heranzzuiehen.

Name

svnadmin dump — Den Inhalt des Dateisystems nach stdout schreiben.

Aufruf

svnadmin dump REPOS_PATH [-r LOWER[:UPPER]] [--incremental] [--deltas]

Beschreibung

Schreibt den Inhalt des Dateisystems nach stdout, indem ein Format verwendet wird, dass portabel zu Auszugsdateien ist; Rückmeldungen werden nach stderr geschrieben. Ausgegeben werden die Revisionen LOWER bis UPPER. Wenn keine Revisionen angegeben sind, werden alle Revisionsbäume ausgegeben. Wird nur LOWER angegeben, wird nur dieser Baum ausgegeben. Siehe „Projektarchiv-Daten woanders hin verschieben“ für einen praktischen Anwendungsfall.

Standardmäßig beinhaltet der Auszugsstrom von Subversion eine einzige Revision (die erste im angegebenen Revisionsbereich) in der jede Datei und jedes Verzeichnis dieser Revision im Projektarchiv präsentiert wird, als sei der gesamte Baum auf einmal hinzugefügt worden. Es folgen die anderen Revisionen (der Rest der Revisionen aus dem angegebenen Bereich), die nur die in diesen Revisionen geänderten Dateien und Verzeichnisse umfassen. Für eine geänderte Datei werden sowohl die vollständige Textrepräsentation ihres Inhalts als auch ihre Eigenschaften in den Auszug übernommen; für ein Verzeichnis werden alle seine Eigenschaften übernommen.

Zwei nützliche Optionen beeinflussen das Verhalten der Erstellung der Auszugsdatei. Die erste Option ist --incremental, die einfach bewirkt, dass bei der ersten Revision nur die in ihr geänderten Dateien und Verzeichnisse ausgegeben werden, statt es so aussehen zu lassen, als sei ein vollständiger Baum hinzugefügt worden; die Ausgabe erfolgt somit auf dieselbe Weise wie für die anderen Revisionen. Das ist nützlich, um eine relativ kleine Auszugsdatei zu erzeugen, die in ein anderes Projektarchiv geladen werden soll, welches bereits die Dateien und Verzeichnisse aus dem Original-Projektarchiv beinhaltet.

Die zweite nützliche Option ist --deltas. Diese Option veranlasst svnadmin dump, statt Volltextrepräsentationen von Dateiinhalten und Eigenschafts-Listen nur die jeweiligen Unterschiede zu früheren Versionen auszugeben. Das verringert (in einigen Fällen erheblich) den Umfang der Auszugsdatei, die svnadmin dump erzeugt. Allerdings gibt es bei der Option auch Nachteile – deltifizierte Auszugsdateien erfordern bei der Erstellung mehr Rechenkapazität, können nicht durch svndumpfilter behandelt werden und tendieren dazu, sich mit Werkzeugen von Drittanbietern, so wie gzip oder bzip2, nicht so gut komprimieren zu lassen wie die entsprechenden undeltifizierten Auszugsdateien.

Optionen

--deltas
--incremental
--quiet (-q)
--revision (-r) REV

Beispiele

Das gesamte Projektarchiv ausgeben:

$ svnadmin dump /var/svn/repos > full.dump

* Revision 0 ausgegeben.
* Revision 1 ausgegeben.
* Revision 2 ausgegeben.
…

Eine einzelne Transaktion Ihres Projektarchivs inkrementell ausgeben:

$ svnadmin dump /var/svn/repos -r 21 --incremental > incr.dump

* Revision 21 ausgegeben.