1<html><head> 2 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> 3 <title>Chapter 11. Using rejarForAnalysis</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="FindBugs™ Manual"><link rel="up" href="index.html" title="FindBugs™ Manual"><link rel="prev" href="annotations.html" title="Chapter 10. Annotations"><link rel="next" href="datamining.html" title="Chapter 12. Data mining of bugs with FindBugs™"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 11. Using rejarForAnalysis</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="annotations.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="datamining.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 11. Using rejarForAnalysis"><div class="titlepage"><div><div><h2 class="title"><a name="rejarForAnalysis"></a>Chapter 11. Using rejarForAnalysis</h2></div></div></div><p> 4If your project consists of many jarfiles or the jarfiles are scattered 5over many directories, you may wish to use the <span class="command"><strong>rejarForAnalysis 6</strong></span> script to make 7FindBugs invocation easier. The script collects many jarfiles and combines them 8into a single, large jarfile that can then be easily passed to FindBugs for 9analysis. This can be particularly useful in combination with the 'find' command 10on unix systems; e.g. <span class="command"><strong>find . -name '*.jar' | xargs rejarForAnalysis 11</strong></span>. 12</p><p> 13The <span class="command"><strong>rejarForAnalysis</strong></span> script 14can also be used to split a very large project up into a set of jarfiles with 15the project classfiles evenly divided between them. This is useful when running 16FindBugs on the entire project is not practical due to time or memory consumption. 17Instead of running FindBugs on the entire project, you may use <span class="command"><strong> 18rejarForAnalysis</strong></span> build one large, all-inclusive jarfile 19containing all classes, invoke <span class="command"><strong>rejarForAnalysis</strong></span> 20again to split the project into multiple jarfiles, then run FindBugs 21on each divided jarfiles in turn, specifying the the all-inclusive jarfile in 22the <span class="command"><strong>-auxclasspath</strong></span>. 23</p><p> 24These are the options accepted by the <span class="command"><strong>rejarForAnalysis</strong></span> script: 25</p><div class="variablelist"><dl><dt><span class="term"><span class="command"><strong>-maxAge</strong></span> <em class="replaceable"><code>days</code></em></span></dt><dd><p> 26 Maximum age in days (ignore jar files older than this). 27 </p></dd><dt><span class="term"><span class="command"><strong>-inputFileList</strong></span> <em class="replaceable"><code>filename</code></em></span></dt><dd><p> 28 Text file containing names of jar files. 29 </p></dd><dt><span class="term"><span class="command"><strong>-maxClasses</strong></span> <em class="replaceable"><code>num</code></em></span></dt><dd><p> 30 Maximum number of classes per analysis*.jar file. 31 </p></dd><dt><span class="term"><span class="command"><strong>-prefix</strong></span> <em class="replaceable"><code>class name prefix</code></em></span></dt><dd><p> 32 Prefix of class names that should be analyzed (e.g., edu.umd.cs.). 33 </p></dd></dl></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="annotations.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="datamining.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 10. Annotations </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 12. Data mining of bugs with <span class="application">FindBugs</span>™</td></tr></table></div></body></html>