<?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>svndumpfilter Reference—Subversion History Filtering</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.html" title="Part II. Subversion Command Reference" />
<link rel="prev" href="svn.ref.svnrdump.c.load.html" title="svnrdump load" />
<link rel="next" href="svn.ref.svndumpfilter.commands.c.exclude.html" title="svndumpfilter exclude" />
</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">svndumpfilter Reference—Subversion History Filtering</th>
</tr>
<tr>
<td width="20%" align="left"><a accesskey="p" href="svn.ref.svnrdump.c.load.html">Prev</a> </td>
<th width="60%" align="center">Part II. Subversion Command Reference</th>
<td width="20%" align="right"> <a accesskey="n" href="svn.ref.svndumpfilter.commands.c.exclude.html">Next</a></td>
</tr>
</table>
<hr />
</div>
<div class="reference" title="svndumpfilter Reference—Subversion History Filtering">
<div class="titlepage">
<div>
<div>
<h1 class="title"><a id="svn.ref.svndumpfilter"></a>svndumpfilter Reference—Subversion History Filtering</h1>
</div>
</div>
<hr />
</div>
<div class="partintro" title="svndumpfilter Reference—Subversion History Filtering">
<div></div>
<p><span class="command"><strong>svndumpfilter</strong></span> 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
<a class="xref" href="svn.reposadmin.maint.html#svn.reposadmin.maint.tk.svndumpfilter" title="svndumpfilter">the section called “svndumpfilter”</a>.</p>
<p>Options in <span class="command"><strong>svndumpfilter</strong></span> are global, just
as they are in <span class="command"><strong>svn</strong></span> and
<span class="command"><strong>svnadmin</strong></span>:</p>
<div class="variablelist" title="svndumpfilter Options">
<a id="svn.ref.svndumpfilter.sw"></a>
<p class="title">
<strong>svndumpfilter Options</strong>
</p>
<dl>
<dt>
<a id="svn.ref.svndumpfilter.sw.drop_empty_revs"></a>
<span class="term">
<code class="option">--drop-empty-revs</code>
</span>
</dt>
<dd>
<p>If filtering causes any revision to be empty (i.e.,
causes no change to the repository), removes these
revisions from the final dump file.</p>
</dd>
<dt>
<a id="svn.ref.svndumpfilter.sw.pattern"></a>
<span class="term">
<code class="option">--pattern</code>
</span>
</dt>
<dd>
<p>Treat the path prefixes provided to the filtering
commands as file glob patterns rather than explicit path
substrings.</p>
</dd>
<dt>
<a id="svn.ref.svndumpfilter.sw.renumber_revs"></a>
<span class="term">
<code class="option">--renumber-revs</code>
</span>
</dt>
<dd>
<p>Renumbers revisions that remain after
filtering.</p>
</dd>
<dt>
<a id="svn.ref.svndumpfilter.sw.skip_missing_merge_sources"></a>
<span class="term">
<code class="option">--skip-missing-merge-sources</code>
</span>
</dt>
<dd>
<p>Skips merge sources that have been removed as part of
the filtering. Without this
option, <span class="command"><strong>svndumpfilter</strong></span> will exit with
an error if the merge source for a retained path is
removed by filtering.</p>
</dd>
<dt>
<a id="svn.ref.svndumpfilter.sw.preserve_revprops"></a>
<span class="term">
<code class="option">--preserve-revprops</code>
</span>
</dt>
<dd>
<p>If all nodes in a revision are removed by filtering
and <code class="option">--drop-empty-revs</code> is not passed,
the default behavior of <span class="command"><strong>svndumpfilter</strong></span>
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).</p>
</dd>
<dt>
<a id="svn.ref.svndumpfilter.sw.targets"></a>
<span class="term"><code class="option">--targets</code> <em class="replaceable"><code>FILENAME</code></em></span>
</dt>
<dd>
<p>Instructs <span class="command"><strong>svndumpfilter</strong></span> to read
additional path prefixes—one per line—from
the file located at <em class="replaceable"><code>FILENAME</code></em>.
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.</p>
</dd>
<dt>
<a id="svn.ref.svndumpfilter.sw.quiet"></a>
<span class="term">
<code class="option">--quiet</code>
</span>
</dt>
<dd>
<p>Does not display filtering statistics.</p>
</dd>
</dl>
</div>
<div class="toc">
<p>
<strong>Table of Contents</strong>
</p>
<dl>
<dt>
<span class="refentrytitle">
<a href="svn.ref.svndumpfilter.commands.c.exclude.html">svndumpfilter exclude</a>
</span>
<span class="refpurpose"></span>
</dt>
<dt>
<span class="refentrytitle">
<a href="svn.ref.svndumpfilter.commands.c.include.html">svndumpfilter include</a>
</span>
<span class="refpurpose"></span>
</dt>
<dt>
<span class="refentrytitle">
<a href="svn.ref.svndumpfilter.commands.c.help.html">svndumpfilter help</a>
</span>
<span class="refpurpose"></span>
</dt>
</dl>
</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.svnrdump.c.load.html">Prev</a> </td>
<td width="20%" align="center">
<a accesskey="u" href="svn.ref.html">Up</a>
</td>
<td width="40%" align="right"> <a accesskey="n" href="svn.ref.svndumpfilter.commands.c.exclude.html">Next</a></td>
</tr>
<tr>
<td width="40%" align="left" valign="top">svnrdump load </td>
<td width="20%" align="center">
<a accesskey="h" href="index.html">Home</a>
</td>
<td width="40%" align="right" valign="top"> svndumpfilter exclude</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
>
165
