This documentation was written to describe the 1.7.x series of Apache™ Subversion®. If you are running a different version of Subversion, you are strongly encouraged to visit http://www.svnbook.com/ and instead consult the version of this documentation appropriate for your version of Subversion.
svndumpfilter is a command-line utility for removing history from a Subversion dump file by either excluding or including paths beginning with one or more named prefixes. For details, see the section called “svndumpfilter”.
Options in svndumpfilter are global, just as they are in svn and svnadmin:
--drop-empty-revs
If filtering causes any revision to be empty (i.e., causes no change to the repository), removes these revisions from the final dump file.
--pattern
Treat the path prefixes provided to the filtering commands as file glob patterns rather than explicit path substrings.
--renumber-revs
Renumbers revisions that remain after filtering.
--skip-missing-merge-sources
Skips merge sources that have been removed as part of the filtering. Without this option, svndumpfilter will exit with an error if the merge source for a retained path is removed by filtering.
--preserve-revprops
If all nodes in a revision are removed by filtering
and --drop-empty-revs
is not passed,
the default behavior of svndumpfilter
is to remove all revision properties except for the date
and the log message (which will merely indicate that the
revision is empty). Passing this option will preserve
existing revision properties (which may or may not make
sense since the related content is no longer present in
the dump file).
--targets
FILENAME
Instructs svndumpfilter to read
additional path prefixes—one per line—from
the file located at FILENAME
.
This is especially useful for complex filtering
operations which require more prefixes than the
operating system allows to be specified on a single
command line.
--quiet
Does not display filtering statistics.