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 http://www.svnbook.com/ for stable versions of this book.
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:
svndumpfilter Options
--drop-empty-revs
If the current filtering invocation causes any revision to be empty (i.e., the revision causes no change to the repository), removes these revisions from the final dump file.
--drop-all-empty-revs
Removes all empty revisions found in the dumpstream from the final dump file (except revision 0).
--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.
Table of Contents