summaryrefslogtreecommitdiff
path: root/tools/findbugs/doc/sysprops.html
blob: ad556221b832392a26a175a0f102ae6506ea3ae6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
<html>
<head>
<title>FindBugs Optional System Properties</title>
<link rel="stylesheet" type="text/css" href="findbugs.css">
</head>
<body>

<table width="100%"><tr>


<td bgcolor="#b9b9fe" valign="top" align="left" width="20%"> 
<table width="100%" cellspacing="0" border="0"> 
<tr><td><a class="sidebar" href="index.html"><img src="umdFindbugs.png" alt="FindBugs"></a></td></tr> 

<tr><td>&nbsp;</td></tr>

<tr><td><b>Docs and Info</b></td></tr> 
<tr><td><font size="-1"><a class="sidebar" href="findbugs2.html">FindBugs 2.0</a></font></td></tr> 
<tr><td><font size="-1"><a class="sidebar" href="demo.html">Demo and data</a></font></td></tr> 
<tr><td><font size="-1"><a class="sidebar" href="users.html">Users and supporters</a></font></td></tr> 
<tr><td><font size="-1"><a class="sidebar" href="http://findbugs.blogspot.com/">FindBugs blog</a></font></td></tr> 
<tr><td><font size="-1"><a class="sidebar" href="factSheet.html">Fact sheet</a></font></td></tr> 
<tr><td><font size="-1"><a class="sidebar" href="manual/index.html">Manual</a></font></td></tr> 
<tr><td><font size="-1"><a class="sidebar" href="ja/manual/index.html">Manual(ja/&#26085;&#26412;&#35486;)</a></font></td></tr> 
<tr><td><font size="-1"><a class="sidebar" href="FAQ.html">FAQ</a></font></td></tr> 
<tr><td><font size="-1"><a class="sidebar" href="bugDescriptions.html">Bug descriptions</a></font></td></tr> 
<tr><td><font size="-1"><a class="sidebar" href="mailingLists.html">Mailing lists</a></font></td></tr> 
<tr><td><font size="-1"><a class="sidebar" href="publications.html">Documents and Publications</a></font></td></tr> 
<tr><td><font size="-1"><a class="sidebar" href="links.html">Links</a></font></td></tr> 

<tr><td>&nbsp;</td></tr>

<tr><td><a class="sidebar" href="downloads.html"><b>Downloads</b></a></td></tr> 

<tr><td>&nbsp;</td></tr>

<tr><td><a class="sidebar" href="http://www.cafeshops.com/findbugs"><b>FindBugs Swag</b></a></td></tr>

<tr><td>&nbsp;</td></tr>

<tr><td><b>Development</b></td></tr> 
<tr><td><font size="-1"><a class="sidebar" href="http://sourceforge.net/tracker/?group_id=96405">Open bugs</a></font></td></tr> 
<tr><td><font size="-1"><a class="sidebar" href="reportingBugs.html">Reporting bugs</a></font></td></tr> 
<tr><td><font size="-1"><a class="sidebar" href="contributing.html">Contributing</a></font></td></tr> 
<tr><td><font size="-1"><a class="sidebar" href="team.html">Dev team</a></font></td></tr> 
<tr><td><font size="-1"><a class="sidebar" href="api/index.html">API</a> <a class="sidebar" href="api/overview-summary.html">[no frames]</a></font></td></tr> 
<tr><td><font size="-1"><a class="sidebar" href="Changes.html">Change log</a></font></td></tr> 
<tr><td><font size="-1"><a class="sidebar" href="http://sourceforge.net/projects/findbugs">SF project page</a></font></td></tr> 
<tr><td><font size="-1"><a class="sidebar" href="http://code.google.com/p/findbugs/source/browse/">Browse source</a></font></td></tr> 
<tr><td><font size="-1"><a class="sidebar" href="http://code.google.com/p/findbugs/source/list">Latest code changes</a></font></td></tr> 
</table> 
</td>

<td align="left" valign="top">

<h1>FindBugs Optional System Properties</h1>

<p> These system properties can be added to the command line to alter the way
findbugs works. These options should be considered experimental. The description
gives information if the field is set to true.
</p>

<table width="100%" border="1">
	<tr bgColor="#F0F0F0"><th>System Property</th><th>Description</th></tr>
	
	<tr>
		<td>findbugs.assertionmethods</td>
		<td>methods supplied by user that have assertions</td>
	</tr>
	<tr>
		<td>findbugs.checkreturn.loadtraining
			<br/>findbugs.checkreturn.savetraining</td>
		<td>file name to read/write list of methods whose return values must be checked</td>
	</tr>
	<tr>
		<td>findbugs.de.comment</td>
		<td>Don't report empty catch blocks if a source comment is found in the block.</td>
	</tr>
	<tr>
		<td>findbugs.dls.exclusions</td>
		<td>local variables that will be excluded from Dead Local Store</td>
	</tr>
	<tr>
		<td>findbugs.fis.unsyncFactor</td>
		<td>Default value is 2.0, which means that we report a bug if more than 1/3 of accesses are unsynchronized.</td>
	</tr>
	<tr>
		<td>findbugs.fis.writeBias</td>
		<td>Default value is 2.0. The idea is that this should be above 1.0, because unsynchronized writes are more dangerous than unsynchronized reads.</td>
	</tr>
	<tr>
		<td>fundbugs.gui.bugCount</td>
		<td>?</td>
	</tr>
	<tr>
		<td>findbugs.maskedfields.locals</td>
		<td>Report on local variables that mask fields.</td>
	</tr>
	<tr>
		<td>findbugs.nullderef.assumensp</td>
		<td>sets value for IsNullValueAnalysisFeatures.UNKNOWN_VALUES_ARE_NSP, but is not used by FindBugs</td>
	</tr>
	<tr>
		<td>findbugs.refcomp.reportAll</td>
		<td>?</td>
	</tr>
	<tr>
		<td>findbugs.report.SummaryHTML</td>
		<td>emit SummaryHTML element</td>
	</tr>
	<tr>
		<td>findbugs.sf.comment</td>
		<td>Ignore switch fall thru bugs if a comment is found with 'fall' or 'nobreak'
	</tr>
	<tr>
		<td>ba.checkAssertions</td>
		<td>throw excptions on certain illegal class type signatures</td>
	</tr>
	<tr>
		<td>ba.verifyIntegrity</td>
		<td>enable data structure integrity checks</td>
	</tr>
	<tr>
		<td>BCPMethodReturnCheck.java</td>
		<td>Add methods to the list requiring a check. (format: "class:method:sig|...")</td>
	</tr>
	<tr>
		<td>dataflow.stackonly</td>
		<td>?</td>
	</tr>
	<tr>
		<td>fis.eval</td>
		<td>?</td>
	</tr>
	<tr>
		<td>fis.noAdjustSubclass</td>
		<td>Adjust field so its class name is the same as the type of reference it is accessed through.</td>
	</tr>
	<tr>
		<td>fos.allowWUS</td>
		<td>Ignore wrapping streams that are wrapping uninteresting streams (like in memory streams).</td>
	</tr>
	<tr>
		<td>ic.createInstance</td>
		<td>?</td>
	</tr>
	<tr>
		<td>inva.ncpExtraBranch</td>
		<td>?</td>
	</tr>
	<tr>
		<td>inva.noAssertHack</td>
		<td>?</td>
	</tr>
	<tr>
		<td>inva.noSplitDowngradeNSP</td>
		<td>?</td>
	</tr>
	<tr>
		<td>inva.noSwitchDefaultAsException</td>
		<td>Don't consider switch default cases as exception paths.</td>
	</tr>
	<tr>
		<td>lineNumberBug</td>
		<td>Disable the workaround for the bug in BCEL 5.0's LineNumberTable class.</td>
	</tr>
	<tr>
		<td>ma.ugly</td>
		<td>Report method signature with method class and name.</td>
	</tr>
	<tr>
		<td>mrc.checkall</td>
		<td>Check for 1.5-specific method return values being ignored even if runtime Java predates 1.5.</td>
	</tr>
	<tr>
		<td>ta.accurateExceptions</td>
		<td>?</td>
	</tr>
	<tr>
		<td>vna.noRLE</td>
		<td>Perform redundant load elimination and forward substitution (but not in a correctness-preserving way).</td>
	</tr>

</table>


<hr> <p> 
<script language="JavaScript" type="text/javascript"> 
<!---//hide script from old browsers 
document.write( "Last updated "+ document.lastModified + "." ); 
//end hiding contents ---> 
</script> 
<p> Send comments to <a class="sidebar" href="mailto:findbugs@cs.umd.edu">findbugs@cs.umd.edu</a> 
<p> 
<A href="http://sourceforge.net"><IMG src="http://sourceforge.net/sflogo.php?group_id=96405&amp;type=5" width="210" height="62" border="0" alt="SourceForge.net Logo" /></A>

</td>

</tr></table>

</body>
</html>