svn-backup-dumps(1) General Commands Manual svn-backup-dumps(1)
NAME
svn-backup-dumps - Create dumpfiles to backup a subversion repository.
SYNOPSIS
svn-backup-dumps <repos> <dumpdir>
DESCRIPTION
svn-backup-dumps creates dumpfiles from a subversion repository. It is
intended for use in cron jobs and post-commit hooks.
The basic modes of operation are:
• Create a full dump (revisions 0 to HEAD)
• Create incremental dump containing at most N revisions.
• Create incremental single-revision dumps (for use in post-com-
mit).
Dumpfiles are named in the format basename.rev.svndmp or base-
name.rev.rev.svndmp, where basename is the repository directory name,
and the rev arguments are the first and last revision numbers repre-
sented in the dumpfile, zero-padded to 6 digits.
Optionally, svn-backup-dumps can compress dumpfiles with gzip or bzip2,
and can transfer them to another host using FTP or SMB (using smb-
client).
OPTIONS
--version
Show program's version number and exit.
-h, --help
Show this help message and exit.
-b Compress the dump using bzip2.
--deltas
This is passed through to svnadmin dump.
-c count
Maximum number of revisions per dumpfile.
-o Overwrite files.
-O Overwrite all files.
-q Quiet.
-r rev Specify a single-revision dumpfile.
-t ftp:host:user:password:path
-t smb:share:user:password:path
Transfer dumps to another machine using the FTP or SMB proto-
cols. path is where to store the dumpfiles on the remote
server; any occurrence of %r in the path is replaced by the
repository name. Support for "smb:" requires the smbclient pro-
gram.
-z Compress the dump using gzip.
EXAMPLES
To create a full dump of all revisions of a repository /srv/svn/foo in
the directory /var/backup/svn:
svn-backup-dumps /srv/svn/foo /var/backup/svn
The dumpfile will be named src.000000-NNNNNN.svndmp.gz where NNNNNN is
the head revision number.
To create incremental dumps containing at most 1000 revisions:
svn-backup-dumps --deltas -z -c 1000 /srv/svn/foo /var/backup/svn
If the youngest revision is 2923, it creates the following files:
foo.000000-000999.svndmp.gz
foo.001000-001999.svndmp.gz
foo.002000-002923.svndmp.gz
If run again, later, when the youngest revision is 3045, it creates
these two files:
foo.002000-002999.svndmp.gz
foo.003000-003045.svndmp.gz
Note that it does not remove the redundant file
foo.002000-002923.svndmp.gz.
To create incremental single-revision dumps from a post-commit hook:
svn-backup-dumps -r $rev $repos /var/backups/svn
where $rev and $repos are variables previously set in the post-commit
script from its command line. The dumpfile name will be in the form
foo.000352.svndmp.
To send the dumpfiles to the SMB share \\ERNEST\BACKUPS in a directory
\svn\foo with user svnuser and password w0rth1ng:
svn-backup-dumps -t "smb://ERNEST/BACK-
UPS:svnuser:w0rth1ng:svn/%r /srv/svn/foo /tmp/tmpbackup
Note that the %r in the path is replaced by the repository name foo.
Note also that a local backup directory is required, at present, even
when using the -t option.
AUTHOR
Voluntary contributions made by many individuals. Copyright © 2006
CollabNet.
2006-11-09 svn-backup-dumps(1)
Generated by dwww version 1.14 on Mon Feb 3 08:34:20 CET 2025.