<?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 include</title> <link rel="stylesheet" type="text/css" href="styles.css" /> <meta name="generator" content="DocBook XSL Stylesheets V1.79.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.svndumpfilter.html" title="svndumpfilter Reference—Subversion History Filtering" /> <link rel="prev" href="svn.ref.svndumpfilter.commands.c.exclude.html" title="svndumpfilter exclude" /> <link rel="next" href="svn.ref.svndumpfilter.commands.c.help.html" title="svndumpfilter help" /> </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 include</th> </tr> <tr> <td width="20%" align="left"><a accesskey="p" href="svn.ref.svndumpfilter.commands.c.exclude.html">Prev</a> </td> <th width="60%" align="center">svndumpfilter Reference—Subversion History Filtering</th> <td width="20%" align="right"> <a accesskey="n" href="svn.ref.svndumpfilter.commands.c.help.html">Next</a></td> </tr> </table> <hr /> </div> <div class="refentry"> <a id="svn.ref.svndumpfilter.commands.c.include"></a> <div class="titlepage"></div> <a id="idm15826" class="indexterm"></a> <div class="refnamediv"> <h2>Name</h2> <p>svndumpfilter include — Filter out nodes without given prefixes from dump stream.</p> </div> <div class="refsynopsisdiv"> <h2>Synopsis</h2> <p> <code class="literal">svndumpfilter include PATH_PREFIX...</code> </p> </div> <div class="refsect1"> <a id="idm15836"></a> <h2>Description</h2> <p>Can be used to include nodes that begin with one or more <em class="replaceable"><code>PATH_PREFIX</code></em>es in a filtered dump file (thus excluding all other paths).</p> </div> <div class="refsect1"> <a id="idm15840"></a> <h2>Options</h2> <div class="informalexample"> <pre class="screen"> <a class="xref" href="svn.ref.svndumpfilter.html#svn.ref.svndumpfilter.sw.drop_empty_revs"><code class="option">--drop-empty-revs</code></a> <a class="xref" href="svn.ref.svndumpfilter.html#svn.ref.svndumpfilter.sw.drop_all_empty_revs"><code class="option">--drop-all-empty-revs</code></a> <a class="xref" href="svn.ref.svndumpfilter.html#svn.ref.svndumpfilter.sw.pattern"><code class="option">--pattern</code></a> <a class="xref" href="svn.ref.svndumpfilter.html#svn.ref.svndumpfilter.sw.preserve_revprops"><code class="option">--preserve-revprops</code></a> <a class="xref" href="svn.ref.svndumpfilter.html#svn.ref.svndumpfilter.sw.quiet"><code class="option">--quiet</code></a> <a class="xref" href="svn.ref.svndumpfilter.html#svn.ref.svndumpfilter.sw.renumber_revs"><code class="option">--renumber-revs</code></a> <a class="xref" href="svn.ref.svndumpfilter.html#svn.ref.svndumpfilter.sw.skip_missing_merge_sources"><code class="option">--skip-missing-merge-sources</code></a> <a class="xref" href="svn.ref.svndumpfilter.html#svn.ref.svndumpfilter.sw.targets"><code class="option">--targets</code> <em class="replaceable"><code>FILENAME</code></em></a> </pre> </div> </div> <div class="refsect1"> <a id="idm15852"></a> <h2>Example</h2> <p>If we have a dump file from a repository with a number of different picnic-related directories in it, but want to keep only the <code class="filename">sandwiches</code> part of the repository, we'll include only that path:</p> <div class="informalexample"> <pre class="screen"> $ svndumpfilter include sandwiches < dumpfile > filtered-dumpfile Including prefixes: '/sandwiches' Revision 0 committed as 0. Revision 1 committed as 1. Revision 2 committed as 2. Revision 3 committed as 3. Revision 4 committed as 4. Dropped 12 node(s): '/condiments' '/condiments/pepper' '/condiments/pepper.OLD' '/condiments/salt' '/condiments/salt.OLD' '/drinks' '/snacks' '/supplies' '/toppings' '/toppings/cheese' '/toppings/cheese.OLD' '/toppings/lettuce' $ </pre> </div> <p>Beginning in Subversion 1.7, <span class="command"><strong>svndumpfilter</strong></span> can optionally treat the <em class="replaceable"><code>PATH_PREFIX</code></em>s not merely as explicit substrings, but as file patterns instead. So, for example, if you wished to include only paths which ended with <code class="filename">ks</code>, you would do the following:</p> <div class="informalexample"> <pre class="screen"> $ svndumpfilter include --pattern "*ks" < dumpfile > filtered-dumpfile Including prefix patterns: '/*ks' Revision 0 committed as 0. Revision 1 committed as 1. Revision 2 committed as 2. Revision 3 committed as 3. Revision 4 committed as 4. Dropped 11 node(s): '/condiments' '/condiments/pepper' '/condiments/pepper.OLD' '/condiments/salt' '/condiments/salt.OLD' '/sandwiches' '/supplies' '/toppings' '/toppings/cheese' '/toppings/cheese.OLD' '/toppings/lettuce' $ </pre> </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.svndumpfilter.commands.c.exclude.html">Prev</a> </td> <td width="20%" align="center"> <a accesskey="u" href="svn.ref.svndumpfilter.html">Up</a> </td> <td width="40%" align="right"> <a accesskey="n" href="svn.ref.svndumpfilter.commands.c.help.html">Next</a></td> </tr> <tr> <td width="40%" align="left" valign="top">svndumpfilter exclude </td> <td width="20%" align="center"> <a accesskey="h" href="index.html">Home</a> </td> <td width="40%" align="right" valign="top"> svndumpfilter help</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>