[svnbook] r5007 committed - * en/book/ref-svnadmin.xml...
svnbook at googlecode.com
svnbook at googlecode.com
Wed Mar 11 10:50:56 CDT 2015
Revision: 5007
Author: cmpilato at gmail.com
Date: Wed Mar 11 15:50:35 2015 UTC
Log: * en/book/ref-svnadmin.xml
Add `svnadmin freeze` subcommand to `svnadmin` command line reference.
- http://subversion.apache.org/docs/release-notes/1.8.html#svnadmin-freeze
- http://svn.apache.org/viewvc?view=revision&revision=1376228
Patch by: pavel.lyalyakin{_AT_}visualsvn.com
https://code.google.com/p/svnbook/source/detail?r=5007
Modified:
/trunk/en/book/ref-svnadmin.xml
=======================================
--- /trunk/en/book/ref-svnadmin.xml Mon Feb 23 18:22:28 2015 UTC
+++ /trunk/en/book/ref-svnadmin.xml Wed Mar 11 15:50:35 2015 UTC
@@ -85,6 +85,14 @@
</listitem>
</varlistentry>
+ <varlistentry id="svn.ref.svnadmin.sw.file">
+ <term><option>--file</option> (<option>-F</option>)
<replaceable>FILENAME</replaceable></term>
+ <listitem>
+ <para>Uses the contents of the named file for the
+ specified subcommand.</para>
+ </listitem>
+ </varlistentry>
+
<varlistentry id="svn.ref.svnadmin.sw.fs_type">
<term><option>--fs-type</option>
<replaceable>ARG</replaceable></term>
<listitem>
@@ -574,6 +582,74 @@
<!-- =================================================================
-->
<!-- =================================================================
-->
<!-- =================================================================
-->
+ <refentry id="svn.ref.svnadmin.c.freeze">
+
+ <indexterm>
+ <primary>svnadmin</primary>
+ <secondary>subcommands</secondary>
+ <tertiary>freeze</tertiary>
+ </indexterm>
+
+ <refnamediv>
+ <refname>svnadmin freeze</refname>
+ <refpurpose>Prevent commits to the repository while running an
arbitary program.</refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv>
+ <para><literal>svnadmin freeze REPOS_PATH PROGRAM
[ARG...]</literal></para>
+ <para><literal>svnadmin freeze --file FILENAME PROGRAM
[ARG...]</literal></para>
+ </refsynopsisdiv>
+
+ <!-- ===============================================================
-->
+ <refsect1>
+ <title>Description</title>
+
+ <para>This subcommand prevents concurrent commits to the repository
+ <replaceable>REPOS_PATH</replaceable> (i.e. it freezes the
+ repository) while running <replaceable>PROGRAM</replaceable> with
+ <replaceable>ARG</replaceable> arguments. Clients trying to
+ commit concurrently will wait until the repository becomes
+ available again. The subcommand is intended for backup purposes so
+ that third-party backup tools such as <command>rsync</command> can
+ be safely used on a live repository.</para>
+
+ <para>If <option>--file</option> option is used, then all
repositories
+ listed in <replaceable>FILENAME</replaceable> will froze. The
+ file format is a list of <replaceable>REPOS_PATH</replaceable>
+ separated by newlines. Repositories freeze in the
+ same order as they are listed in the file.</para>
+ </refsect1>
+
+ <!-- ===============================================================
-->
+ <refsect1>
+ <title>Options</title>
+
+ <informalexample>
+ <screen>
+<xref linkend="svn.ref.svnadmin.sw.file" />
+</screen>
+ </informalexample>
+ </refsect1>
+ <!-- ===============================================================
-->
+ <refsect1>
+ <title>Examples</title>
+
+ <para>Freeze the repository and run <command>rsync</command> to
+ make its backup:</para>
+
+ <informalexample>
+ <screen>
+$ svnadmin freeze /var/svn/repos -- rsync -av /var/svn/repos /backup/repos
+</screen>
+ </informalexample>
+
+ </refsect1>
+ </refentry>
+
+ <!-- =================================================================
-->
+ <!-- =================================================================
-->
+ <!-- =================================================================
-->
+
<refentry id="svn.ref.svnadmin.c.help">
<indexterm>
More information about the svnbook-dev
mailing list