<?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>svnsync initialize (init)</title>
<link rel="stylesheet" type="text/css" href="styles.css" />
<meta name="generator" content="DocBook XSL Stylesheets V1.76.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.svnsync.html" title="svnsync Reference—Subversion Repository Mirroring" />
<link rel="prev" href="svn.ref.svnsync.c.info.html" title="svnsync info" />
<link rel="next" href="svn.ref.svnsync.c.sync.html" title="svnsync synchronize (sync)" />
</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">svnsync initialize (init)</th>
</tr>
<tr>
<td width="20%" align="left"><a accesskey="p" href="svn.ref.svnsync.c.info.html">Prev</a> </td>
<th width="60%" align="center">svnsync Reference—Subversion Repository Mirroring</th>
<td width="20%" align="right"> <a accesskey="n" href="svn.ref.svnsync.c.sync.html">Next</a></td>
</tr>
</table>
<hr />
</div>
<div class="refentry" title="svnsync initialize (init)">
<a id="svn.ref.svnsync.c.init"></a>
<div class="titlepage"></div>
<a id="idp25052640" class="indexterm"></a>
<div class="refnamediv">
<h2>Name</h2>
<p>svnsync initialize (init) — Initialize a mirror repository for
synchronization from the source repository.</p>
</div>
<div class="refsynopsisdiv" title="Synopsis">
<h2>Synopsis</h2>
<p>
<code class="literal">svnsync initialize MIRROR_URL
SOURCE_URL</code>
</p>
</div>
<div class="refsect1" title="Description">
<a id="idp25057408"></a>
<h2>Description</h2>
<p><span class="command"><strong>svnsync initialize</strong></span> verifies that a
repository meets the basic requirements of a new mirror
repository and records the initial administrative
information that associates the mirror repository with the
source repository (specified
by <em class="replaceable"><code>SOURCE_URL</code></em>). This is the
first <span class="command"><strong>svnsync</strong></span> operation you run on a
would-be mirror repository.</p>
<p>Ordinarily, <em class="replaceable"><code>SOURCE_URL</code></em> is
the URL of the root directory of the Subversion repository
you wish to mirror. Subversion 1.5 and newer allow you to
use <span class="command"><strong>svnsync</strong></span> for partial repository
mirroring, though — simply specify the URL of the
source repository subdirectory you wish to mirror
as <em class="replaceable"><code>SOURCE_URL</code></em>.</p>
<p>By default, the aforementioned basic requirements of a
mirror are that it allows revision property modifications
and that it contains no version history. However, as of
Subversion 1.7, you may now optionally disable the
verification that the target repository is empty using
the <code class="option">--allow-non-empty</code> option. While the
use of this option should not become habitual (as it
bypasses a valuable safeguard mechanism), it does aid in
one very common use-case: initializing a copy of a
repository as a mirror of the original. This is
especially handy when setting up new mirrors of
repositories which contain a large amount of version
history. Rather than initialize a brand new repository as
a mirror and then syncronize all of the history into it,
administrators will find it <span class="emphasis"><em>significantly</em></span>
faster to first make a copy of the mature repository
(perhaps using <span class="command"><strong>svnadmin hotcopy</strong></span>) and
then use <span class="command"><strong>svnsync initialize
--allow-non-empty</strong></span> to initialize that copy as a
mirror which is now already up-to-date with the
original.</p>
</div>
<div class="refsect1" title="Options">
<a id="idp25067600"></a>
<h2>Options</h2>
<div class="informalexample">
<pre class="screen">
<a class="xref" href="svn.ref.svnsync.html#svn.ref.svnsync.sw.allow_non_empty"><code class="option">--allow-non-empty</code></a>
<a class="xref" href="svn.ref.svnsync.html#svn.ref.svnsync.sw.config_dir"><code class="option">--config-dir</code> <em class="replaceable"><code>DIR</code></em></a>
<a class="xref" href="svn.ref.svnsync.html#svn.ref.svnsync.sw.config_option"><code class="option">--config-option</code> <em class="replaceable"><code>CONFSPEC</code></em></a>
<a class="xref" href="svn.ref.svnsync.html#svn.ref.svnsync.sw.disable_locking"><code class="option">--disable-locking</code></a>
<a class="xref" href="svn.ref.svnsync.html#svn.ref.svnsync.sw.no_auth_cache"><code class="option">--no-auth-cache</code></a>
<a class="xref" href="svn.ref.svnsync.html#svn.ref.svnsync.sw.non_interactive"><code class="option">--non-interactive</code></a>
<a class="xref" href="svn.ref.svnsync.html#svn.ref.svnsync.sw.quiet"><code class="option">--quiet</code> (<code class="option">-q</code>)</a>
<a class="xref" href="svn.ref.svnsync.html#svn.ref.svnsync.sw.source_password"><code class="option">--source-password</code> <em class="replaceable"><code>PASSWD</code></em></a>
<a class="xref" href="svn.ref.svnsync.html#svn.ref.svnsync.sw.source_prop_encoding"><code class="option">--source-prop-encoding <em class="replaceable"><code>ARG</code></em></code></a>
<a class="xref" href="svn.ref.svnsync.html#svn.ref.svnsync.sw.source_username"><code class="option">--source-username</code> <em class="replaceable"><code>NAME</code></em></a>
<a class="xref" href="svn.ref.svnsync.html#svn.ref.svnsync.sw.steal_lock"><code class="option">--steal-lock</code></a>
<a class="xref" href="svn.ref.svnsync.html#svn.ref.svnsync.sw.sync_password"><code class="option">--sync-password</code> <em class="replaceable"><code>PASSWD</code></em></a>
<a class="xref" href="svn.ref.svnsync.html#svn.ref.svnsync.sw.sync_username"><code class="option">--sync-username</code> <em class="replaceable"><code>NAME</code></em></a>
<a class="xref" href="svn.ref.svnsync.html#svn.ref.svnsync.sw.trust_server_cert"><code class="option">--trust-server-cert</code></a>
</pre>
</div>
</div>
<div class="refsect1" title="Examples">
<a id="idp25079392"></a>
<h2>Examples</h2>
<p>Fail to initialize a mirror repository due to
inability to modify revision properties:</p>
<div class="informalexample">
<pre class="screen">
$ svnsync initialize file:///var/svn/repos-mirror \
http://svn.example.com/repos
svnsync: Repository has not been enabled to accept revision propchanges;
ask the administrator to create a pre-revprop-change hook
$
</pre>
</div>
<p>Initialize a repository as a mirror, having already
created a <code class="literal">pre-revprop-change</code> hook that
permits all revision property changes:</p>
<div class="informalexample">
<pre class="screen">
$ svnsync initialize file:///var/svn/repos-mirror \
http://svn.example.com/repos
Copied properties for revision 0.
$
</pre>
</div>
</div>
</div>
<div class="navfooter">
<hr />
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left"><a accesskey="p" href="svn.ref.svnsync.c.info.html">Prev</a> </td>
<td width="20%" align="center">
<a accesskey="u" href="svn.ref.svnsync.html">Up</a>
</td>
<td width="40%" align="right"> <a accesskey="n" href="svn.ref.svnsync.c.sync.html">Next</a></td>
</tr>
<tr>
<td width="40%" align="left" valign="top">svnsync info </td>
<td width="20%" align="center">
<a accesskey="h" href="index.html">Home</a>
</td>
<td width="40%" align="right" valign="top"> svnsync synchronize (sync)</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>
distrib
>
Mageia
>
6
>
x86_64
>
media
>
core-updates
>
by-pkgid
>
e8fe8188cee5592550f08a19b470186d
>
files
>
195
