<?xml version="1.0" encoding="utf-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>svnadmin load</title>
<link rel="stylesheet" type="text/css" href="styles.css" />
<meta name="generator" content="DocBook XSL Stylesheets V1.79.1" />
<style type="text/css">
body { background-image: url('images/draft.png');
background-repeat: no-repeat;
background-position: top left;
/* The following properties make the watermark "fixed" on the page. */
/* I think that's just a bit too distracting for the reader... */
/* background-attachment: fixed; */
/* background-position: center center; */
}</style>
<link rel="home" href="index.html" title="Version Control with Subversion [DRAFT]" />
<link rel="up" href="svn.ref.svnadmin.html" title="svnadmin Reference—Subversion Repository Administration" />
<link rel="prev" href="svn.ref.svnadmin.c.list-unused-dblogs.html" title="svnadmin list-unused-dblogs" />
<link rel="next" href="svn.ref.svnadmin.c.lock.html" title="svnadmin lock" />
</head>
<body>
<div xmlns="" id="vcws-version-notice">
<p>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
<a href="http://www.svnbook.com/">http://www.svnbook.com/</a>
for stable versions of this book.</p>
</div>
<div class="navheader">
<table width="100%" summary="Navigation header">
<tr>
<th colspan="3" align="center">svnadmin load</th>
</tr>
<tr>
<td width="20%" align="left"><a accesskey="p" href="svn.ref.svnadmin.c.list-unused-dblogs.html">Prev</a> </td>
<th width="60%" align="center">svnadmin Reference—Subversion Repository Administration</th>
<td width="20%" align="right"> <a accesskey="n" href="svn.ref.svnadmin.c.lock.html">Next</a></td>
</tr>
</table>
<hr />
</div>
<div class="refentry">
<a id="svn.ref.svnadmin.c.load"></a>
<div class="titlepage"></div>
<a id="idm13813" class="indexterm"></a>
<div class="refnamediv">
<h2>Name</h2>
<p>svnadmin load — Read a
repository dump stream from
<code class="filename">stdin</code>.</p>
</div>
<div class="refsynopsisdiv">
<h2>Synopsis</h2>
<p>
<code class="literal">svnadmin load REPOS_PATH [-r LOWER[:UPPER]]</code>
</p>
</div>
<div class="refsect1">
<a id="idm13824"></a>
<h2>Description</h2>
<p>Read a repository dump stream from
<code class="filename">stdin</code>, committing new revisions
into the repository's filesystem. Progress
feedback is sent to <code class="filename">stdout</code>. If
no revisions are given, read and commit all revisions. But
if <code class="option">--revision</code> is provided, read and commit
revisions <em class="replaceable"><code>LOWER</code></em> rev through
<em class="replaceable"><code>UPPER</code></em> rev only. If only
<em class="replaceable"><code>LOWER</code></em> is given, load that one
revision.</p>
<p>Prior to Subversion 1.8, <span class="command"><strong>svnadmin load</strong></span>
was limited to reading all revisions that the dump stream
contains, but now <span class="command"><strong>svnadmin load</strong></span> accepts
<code class="option">--revision</code> option that acts as a filter for
dump stream revisions. This allows you to incrementally load
only a range of revisions from a single dump stream making
some repository maintenance and reorganization tasks much
easier.</p>
</div>
<div class="refsect1">
<a id="idm13837"></a>
<h2>Options</h2>
<div class="informalexample">
<pre class="screen">
<a class="xref" href="svn.ref.svnadmin.html#svn.ref.svnadmin.sw.bypass_prop_validation"><code class="option">--bypass-prop-validation</code></a>
<a class="xref" href="svn.ref.svnadmin.html#svn.ref.svnadmin.sw.force_uuid"><code class="option">--force-uuid</code></a>
<a class="xref" href="svn.ref.svnadmin.html#svn.ref.svnadmin.sw.ignore_uuid"><code class="option">--ignore-uuid</code></a>
<a class="xref" href="svn.ref.svnadmin.html#svn.ref.svnadmin.sw.memory_cache_size"><code class="option">--memory-cache-size</code> (<code class="option">-M</code>) <em class="replaceable"><code>ARG</code></em></a>
<a class="xref" href="svn.ref.svnadmin.html#svn.ref.svnadmin.sw.parent_dir"><code class="option">--parent-dir</code> <em class="replaceable"><code>DIR</code></em></a>
<a class="xref" href="svn.ref.svnadmin.html#svn.ref.svnadmin.sw.quiet"><code class="option">--quiet</code> (<code class="option">-q</code>)</a>
<a class="xref" href="svn.ref.svnadmin.html#svn.ref.svnadmin.sw.revision"><code class="option">--revision</code> (<code class="option">-r</code>) <em class="replaceable"><code>ARG</code></em></a>
<a class="xref" href="svn.ref.svnadmin.html#svn.ref.svnadmin.sw.use_post_commit_hook"><code class="option">--use-post-commit-hook</code></a>
<a class="xref" href="svn.ref.svnadmin.html#svn.ref.svnadmin.sw.use_pre_commit_hook"><code class="option">--use-pre-commit-hook</code></a>
</pre>
</div>
</div>
<div class="refsect1">
<a id="idm13850"></a>
<h2>Examples</h2>
<p>This shows the beginning of loading a repository from
a backup file (made, of course, with <span class="command"><strong>svnadmin
dump</strong></span>):</p>
<div class="informalexample">
<pre class="screen">
$ svnadmin load /var/svn/restored < repos-backup
<<< Started new txn, based on original revision 1
* adding path : test ... done.
* adding path : test/a ... done.
…
</pre>
</div>
<p>Or if you want to load into a subdirectory:</p>
<div class="informalexample">
<pre class="screen">
$ svnadmin load --parent-dir new/subdir/for/project \
/var/svn/restored < repos-backup
<<< Started new txn, based on original revision 1
* adding path : test ... done.
* adding path : test/a ... done.
…
</pre>
</div>
<p>Newer versions of Subversion have grown more strict
regarding the format of the values of Subversion's own
built-in properties. Of course, properties created with
older versions of Subversion wouldn't have benefitted from
that strictness, and as such might be improperly
formatted. Dump streams carry property values as-is, so
using Subversion 1.7 to load dump streams created from
repositories with ill-formatted property values will, by
default, trigger a validation error. There are several
workaround for this problem. First, you can manually
repair the problematic property values in the source
repository and recreate the dump stream. Or, you can
manually tweak the dump stream itself to fix those
property values. Finally, if you'd rather not deal with
the problem right now, use the
<code class="option">--bypass-prop-validation</code> option
with <span class="command"><strong>svnadmin load</strong></span>.</p>
</div>
</div>
<div class="navfooter">
<hr />
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left"><a accesskey="p" href="svn.ref.svnadmin.c.list-unused-dblogs.html">Prev</a> </td>
<td width="20%" align="center">
<a accesskey="u" href="svn.ref.svnadmin.html">Up</a>
</td>
<td width="40%" align="right"> <a accesskey="n" href="svn.ref.svnadmin.c.lock.html">Next</a></td>
</tr>
<tr>
<td width="40%" align="left" valign="top">svnadmin list-unused-dblogs </td>
<td width="20%" align="center">
<a accesskey="h" href="index.html">Home</a>
</td>
<td width="40%" align="right" valign="top"> svnadmin lock</td>
</tr>
</table>
</div>
<div xmlns="" id="vcws-footer">
<hr />
<img src="images/cc-by.png" style="float: right;" />
<p>You are reading <em>Version Control with Subversion</em> (for
Subversion 1.8), by Ben Collins-Sussman, Brian W. Fitzpatrick,
and C. Michael Pilato.</p>
<p>This work is licensed under
the <a href="http://creativecommons.org/licenses/by/2.0/">Creative Commons Attribution License v2.0</a>.</p>
<p>To submit comments, corrections, or other contributions to the
text, please visit <a href="http://www.svnbook.com/">http://www.svnbook.com/</a>.</p>
</div>
</body>
</html>
