<divclass="container"><buttonname="toc"type="button"class="toc"><spanclass="glyphicon glyphicon-list"></span></button><spanclass="logo"><ahref="http://www.perforce.com/documentation"></a></span><h1><ahref="index.html"class="title"><spanclass="brand"></span><spanclass="guide-title">P4Convert: User Guide</span><spanclass="guide-subtitle">
(April 2015)
</span></a></h1><atitle="Download a PDF version of this guide"class="pdf"href="ethel.pdf"><spanclass="glyphicon glyphicon-book"></span></a><buttonname="search"type="button"class="search"title="Search this guide"><spanclass="glyphicon glyphicon-search"></span></button></div>
<divid="progress"></div>
</div>
<divid="content"class="content"tabindex="-1">
<divclass="container">
<!---->
<divclass="section"id="setup.usage">
<divclass="titlepage">
<div>
<div>
<h2class="title"style="clear: both">Setup and Usage</h2>
</div>
</div>
</div>
<p>
Download the self-contained JAR from Perforce and check that Java SE
runtime is installed with version 1.7 or greater.
</p>
<p>
For usage details, execute the jar with no options:
</p><prelang="bash"class="programlisting">
usage: java -jar p4convert.jar
-c,--config <arg> Use configuration file
-d,--default Generate a configuration file
-E,--end <arg> End revision, for incremental (SVN)
-e,--extract <arg> Extract a revision
-i,--info Report on repository usage
-r,--repo <arg> Repository file/path
-S,--start <arg> Start revision, for incremental (SVN)
-t,--type <arg> SCM type (CVS | SVN)
--tags <arg> find tags to specified depth
--tree <arg> (with --info), display tree to specified depth
To create a default configuration file using the <emclass="parameter"><code>--default</code></em>
option. You will need to specify the SCM type using <emclass="parameter"><code>--type</code></em>
(with a value of SVN or CVS). The generated file (default.cfg) will
contain a set of default configuration options based on your platform.
Rename the <emclass="parameter"><code>default.cfg</code></em> to your own configuration.
To run a conversion using your configuration file, execute the jar with
the <emclass="parameter"><code>--config</code></em> flag specifying you config file.
For example:
</p><preclass="programlisting">
java -jar p4convert.jar --config=myFile.cfg
</pre></div>
</div>
</div>
<divid="nav"class="toc"></div>
<divid="search">
<divclass="input"><inputid="search-text"type="search"placeholder="Search this guide"/><buttonname="clear"type="button"class="clear"><spanclass="glyphicon glyphicon-remove-sign"></span></button></div>
<divclass="container"><aaccesskey="p"class="nav-prev"title="Press 'p', or left-arrow, to view the previous page"href="setup.caveats.html"><spanclass="glyphicon glyphicon-chevron-left"></span><divclass="label">Previous</div>
<divclass="title">Caveats</div></a><aaccesskey="n"class="nav-next"title="Press 'n', or right-arrow, to view the next page"href="setup.generate_dump_file.html"><spanclass="glyphicon glyphicon-chevron-right"></span><divclass="label">Next</div>
<divclass="title">Generating a Subversion Dump file</div></a></div>