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> 4 If your project consists of many jarfiles or the jarfiles are scattered 5 over many directories, you may wish to use the <span class="command"><strong>rejarForAnalysis 6 </strong></span> script to make 7 FindBugs invocation easier. The script collects many jarfiles and combines them 8 into a single, large jarfile that can then be easily passed to FindBugs for 9 analysis. This can be particularly useful in combination with the 'find' command 10 on unix systems; e.g. <span class="command"><strong>find . -name '*.jar' | xargs rejarForAnalysis 11 </strong></span>. 12 </p><p> 13 The <span class="command"><strong>rejarForAnalysis</strong></span> script 14 can also be used to split a very large project up into a set of jarfiles with 15 the project classfiles evenly divided between them. This is useful when running 16 FindBugs on the entire project is not practical due to time or memory consumption. 17 Instead of running FindBugs on the entire project, you may use <span class="command"><strong> 18 rejarForAnalysis</strong></span> build one large, all-inclusive jarfile 19 containing all classes, invoke <span class="command"><strong>rejarForAnalysis</strong></span> 20 again to split the project into multiple jarfiles, then run FindBugs 21 on each divided jarfiles in turn, specifying the the all-inclusive jarfile in 22 the <span class="command"><strong>-auxclasspath</strong></span>. 23 </p><p> 24 These 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>
