[svnbook] r4861 committed - Translation: svnrdump--Remote Subversion Repository Data Migration (in...
svnbook at googlecode.com
svnbook at googlecode.com
Tue Jul 22 01:48:10 CDT 2014
Revision: 4861
Author: jmfelderhoff at gmx.eu
Date: Tue Jul 22 06:47:53 2014 UTC
Log: Translation: svnrdump--Remote Subversion Repository Data
Migration (intro)
http://code.google.com/p/svnbook/source/detail?r=4861
Modified:
/branches/1.7/de/book/ch09-reference.xml
=======================================
--- /branches/1.7/de/book/ch09-reference.xml Mon Jul 21 11:53:10 2014 UTC
+++ /branches/1.7/de/book/ch09-reference.xml Tue Jul 22 06:47:53 2014 UTC
@@ -16003,6 +16003,363 @@
</sect1>
+ <!-- =================================================================
-->
+ <!-- =================================================================
-->
+ <!-- =================================================================
-->
+ <sect1 id="svn.ref.svnrdump">
+<!--
+ <title>svnrdump—Remote Subversion Repository Data
Migration</title>
+-->
+ <title>svnrdump – Datenmigration von entfernten Subversion
Projektarchiven</title>
+
+<!--
+ <para><command>svnrdump</command> joined the Subversion tool chain
+ in the Subversion 1.7 release. It is best described as a
+ network-aware version of the <command>svnadmin dump</command>
+ and <command>svnadmin load</command> commands, paired together
+ and released as a separate standalone program. We discuss the
+ process of dumping and loading repository data—using
+ both <command>svnadmin</command>
+ and <command>svnrdump</command>— in
+ <xref linkend="svn.reposadmin.maint.migrate" />.</para>
+-->
+ <para><command>svnrdump</command> wurde den Subversion Werkzeugen
+ in der Subversion 1.7 hinzugefügt. Es lässt sich am besten
+ beschreiben als eine Version der Befehle <command>svnadmin
+ dump</command> und <command>svnadmin load</command>, die über
+ das Netz arbeiten können und zusammengefasst als ein separates,
+ eigenständiges Programm herausgegeben wurde. Wir erörtern den
+ Prozess des Herausschreibens und Einlesens von
+ Projektarchiv-Daten – unter Verwendung von sowohl
+ <command>svnadmin</command> als auch
+ <command>svnrdump</command>— in
+ <xref linkend="svn.reposadmin.maint.migrate" />.</para>
+
+ <!-- ===============================================================
-->
+ <sect2 id="svn.ref.svnrdump.sw">
+ <title>svnrdump Options</title>
+
+ <para>Options in <command>svnrdump</command> are global, just
+ as they are in <command>svn</command> and
+ <command>svnadmin</command>:</para>
+
+ <variablelist>
+
+ <varlistentry id="svn.ref.svnrdump.sw.config_dir">
+ <term><option>--config-dir</option>
<replaceable>DIR</replaceable></term>
+ <listitem>
+ <para>Instructs Subversion to read configuration
+ information from the specified directory instead of the
+ default location (<filename>.subversion</filename> in
+ the user's home directory).</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="svn.ref.svnrdump.sw.config_option">
+ <term><option>--config-option</option>
<replaceable>FILE</replaceable>:<replaceable>SECTION</replaceable>:<replaceable>OPTION</replaceable>=[<replaceable>VALUE</replaceable>]</term>
+ <listitem>
+ <para>Sets, for the duration of the command, the value of
+ a runtime configuration
+ option. <replaceable>FILE</replaceable>
+ and <replaceable>SECTION</replaceable> are the runtime
+ configuration file (either <literal>config</literal>
+ or <literal>servers</literal>) and the section thereof,
+ respectively, which contain the option whose value you
+ wish to change. <replaceable>OPTION</replaceable> is,
+ of course, the option itself,
+ and <replaceable>VALUE</replaceable> the value (if any)
+ you wish to assign to the option. For example, to
+ temporarily disable the use of the automatic property
+ setting feature,
+ use
<option>--config-option=servers:global:http-library=serf</option>.
+ You can use this option multiple times to change
+ multiple option values simultaneously.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="svn.ref.svnrdump.sw.incremental">
+ <term><option>--incremental</option></term>
+ <listitem>
+ <para>Dump a revision or revision range only as a diff
+ against the previous revision, instead of the default,
+ which is begin a dumped revision range with a complete
+ expansion of all contents of the repository as of that
+ revision.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="svn.ref.svnrdump.sw.no_auth_cache">
+ <term><option>--no-auth-cache</option></term>
+ <listitem>
+ <para>Prevents caching of authentication information
+ (e.g., username and password) in the Subversion
+ runtime configuration directories.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="svn.ref.svnrdump.sw.non_interactive">
+ <term><option>--non-interactive</option></term>
+ <listitem>
+ <para>In the case of an authentication failure or
+ insufficient credentials, prevents prompting for
+ credentials (e.g., username or password). This is useful
+ if you're running Subversion inside an automated
+ script and it's more appropriate to have Subversion fail
+ than to prompt for more information.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="svn.ref.svnrdump.sw.password">
+ <term><option>--password</option>
<replaceable>PASSWD</replaceable></term>
+ <listitem>
+ <para>Specifies the password to use when authenticating
+ against a Subversion server. If not provided, or if
+ incorrect, Subversion will prompt you for this
+ information as needed.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="svn.ref.svnrdump.sw.quiet">
+ <term><option>--quiet</option> (<option>-q</option>)</term>
+ <listitem>
+ <para>Requests that the client print only essential
+ information while performing an operation.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="svn.ref.svnrdump.sw.revision">
+ <term><option>--revision</option> (<option>-r</option>)
<replaceable>ARG</replaceable></term>
+ <listitem>
+ <para>Used by <command>svnsync copy-revprops</command> to
+ specify a particular revision or revision range on which
+ to operate.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="svn.ref.svnrdump.sw.trust_server_cert">
+ <term><option>--trust-server-cert</option></term>
+ <listitem>
+ <para>Used with <option>--non-interactive</option> to accept
+ any unknown SSL server certificates without prompting.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="svn.ref.svnrdump.sw.username">
+ <term><option>--username</option>
<replaceable>NAME</replaceable></term>
+ <listitem>
+ <para>Specifies the username to use when authenticating
+ against a Subversion server. If not provided, or if
+ incorrect, Subversion will prompt you for this
+ information as needed.</para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ </sect2>
+
+ <!-- ===============================================================
-->
+ <sect2 id="svn.ref.svnrdump.c">
+ <title>svnrdump Subcommands</title>
+
+ <para>Here are the various subcommands
+ for the <command>svnrdump</command> program.</para>
+
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
+ <refentry id="svn.ref.svnrdump.c.dump">
+
+ <indexterm>
+ <primary>svnrdump</primary>
+ <secondary>subcommands</secondary>
+ <tertiary>dump</tertiary>
+ </indexterm>
+
+ <refnamediv>
+ <refname>svnrdump dump</refname>
+ <refpurpose></refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Synopsis</title>
+ <para><literal>svnrdump dump SOURCE_URL</literal></para>
+ </refsect1>
+ <refsect1>
+ <title>Description</title>
+
+ <para>Dump—that is, generate a repository dump stream
+ of—revisions of the repository item located
+ at <replaceable>SOURCE_URL</replaceable>, printing the
+ information to standard output. By default, the entire
+ history will be included in the dump stream, but the scope
+ of the operation can be limited via the use of
+ the <option>--revision</option> (<option>-r</option>)
+ option.</para>
+
+ </refsect1>
+
+ <refsect1>
+ <title>Options</title>
+
+ <informalexample>
+ <screen>
+<xref linkend="svn.ref.svnrdump.sw.config_dir" />
+<xref linkend="svn.ref.svnrdump.sw.config_option" />
+<xref linkend="svn.ref.svnrdump.sw.incremental" />
+<xref linkend="svn.ref.svnrdump.sw.no_auth_cache" />
+<xref linkend="svn.ref.svnrdump.sw.non_interactive" />
+<xref linkend="svn.ref.svnrdump.sw.password" />
+<xref linkend="svn.ref.svnrdump.sw.quiet" />
+<xref linkend="svn.ref.svnrdump.sw.revision" />
+<xref linkend="svn.ref.svnrdump.sw.trust_server_cert" />
+<xref linkend="svn.ref.svnrdump.sw.username" />
+</screen>
+ </informalexample>
+ </refsect1>
+
+ <refsect1>
+ <title>Examples</title>
+
+ <para>Generate a dump stream of the full history of a remote
+ repository (assuming that the user as who this runs has
+ authorization to read all paths in the repository).</para>
+
+ <informalexample>
+ <screen>
+$ svnrdump dump http://svn.example.com/repos/calc > full.dump
+* Dumped revision 0.
+* Dumped revision 1.
+* Dumped revision 2.
+…
+</screen>
+ </informalexample>
+
+ <para>Incrementally dump a single revision from that same
+ repository:</para>
+
+ <informalexample>
+ <screen>
+$ svnrdump dump http://svn.example.com/repos/calc \
+ -r 21 --incremental > inc.dump
+* Dumped revision 21.
+$
+</screen>
+ </informalexample>
+
+ </refsect1>
+ </refentry>
+
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
+ <refentry id="svn.ref.svnrdump.c.help">
+
+ <indexterm>
+ <primary>svnrdump</primary>
+ <secondary>subcommands</secondary>
+ <tertiary>help</tertiary>
+ </indexterm>
+
+ <refnamediv>
+ <refname>svnrdump help</refname>
+ <refpurpose>Help!</refpurpose>
+ </refnamediv>
+ <refsect1>
+
+ <title>Synopsis</title>
+ <para><literal>svnrdump help</literal></para>
+ </refsect1>
+ <refsect1>
+ <title>Description</title>
+
+ <para>Use this to get help. Well, certain kinds of help.
+ Need white lab coat and straightjackets kind of help?
+ There's a whole different protocol for that sort of
+ thing.</para>
+
+ </refsect1>
+
+ <refsect1>
+ <title>Options</title>
+ <para>None</para>
+ </refsect1>
+
+ </refentry>
+
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
+ <refentry id="svn.ref.svnrdump.c.load">
+
+ <indexterm>
+ <primary>svnrdump</primary>
+ <secondary>subcommands</secondary>
+ <tertiary>load</tertiary>
+ </indexterm>
+
+ <refnamediv>
+ <refname>svnrdump load</refname>
+ <refpurpose></refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Synopsis</title>
+ <para><literal>svnrdump load DEST_URL</literal></para>
+ </refsect1>
+ <refsect1>
+ <title>Description</title>
+
+ <para>Read from standard input revision information
+ described in a Subversion repository dump stream, and load
+ that information into the repository located
+ at <replaceable>DEST_URL</replaceable>.</para>
+
+ </refsect1>
+
+ <refsect1>
+ <title>Options</title>
+
+ <informalexample>
+ <screen>
+<xref linkend="svn.ref.svnrdump.sw.config_dir" />
+<xref linkend="svn.ref.svnrdump.sw.config_option" />
+<xref linkend="svn.ref.svnrdump.sw.no_auth_cache" />
+<xref linkend="svn.ref.svnrdump.sw.non_interactive" />
+<xref linkend="svn.ref.svnrdump.sw.password" />
+<xref linkend="svn.ref.svnrdump.sw.quiet" />
+<xref linkend="svn.ref.svnrdump.sw.trust_server_cert" />
+<xref linkend="svn.ref.svnrdump.sw.username" />
+</screen>
+ </informalexample>
+ </refsect1>
+
+ <refsect1>
+ <title>Examples</title>
+
+ <para>Dump the contents of a local repository, and
+ use <command>svnrdump load</command> to transfer that
+ revision information into an existing remote
+ repository:</para>
+
+ <informalexample>
+ <screen>
+$ svnadmin dump -q /var/svn/repos/new-project | \
+ svnrdump load http://svn.example.com/repos/new-project
+* Loaded revision 0
+* Loaded revision 1.
+* Loaded revision 2.
+…
+</screen>
+ </informalexample>
+
+ <note>
+ <para>To operate properly <command>svnrdump load</command>
+ requires that the target repository have revision
+ property modification enabled via the pre-revprop-change
+ hook. For details about that hook, see
+ <xref linkend="svn.ref.reposhooks.pre-revprop-change"
+ />.</para>
+ </note>
+
+ </refsect1>
+ </refentry>
+
+ </sect2>
+ </sect1>
+
<!-- =================================================================
-->
<!-- =================================================================
-->
<!-- =================================================================
-->
More information about the svnbook-dev
mailing list