-
Notifications
You must be signed in to change notification settings - Fork 69
/
ref-debug.htm
360 lines (335 loc) · 13.4 KB
/
ref-debug.htm
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
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="en" xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<meta name="copyright" content=
"Copyright (c) IBM Corporation and others 2000, 2018. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<link rel="stylesheet" href="../../../../book.css" charset="ISO-8859-1"
type="text/css" />
<title>
Java Debug Preferences
</title>
<script language="JavaScript" src=
"PLUGINS_ROOT/org.eclipse.help/livehelp.js" type="text/javascript">
</script>
</head>
<body>
<h1>
Java Debug Preferences
</h1>
<p>
The following preferences can be set using the <a class="command-link"
href=
'javascript:executeCommand("org.eclipse.ui.window.preferences(preferencePageId=org.eclipse.jdt.debug.ui.JavaDebugPreferencePage)")'>
<img src="PLUGINS_ROOT/org.eclipse.help/command_link.svg" alt=
"Opens the Java Debug preference page" /> <b>Java > Debug</b></a>
preference page.
</p>
<p>
These options apply to java specific debuggers and have to do with
suspending options and hot code replace.
</p>
<table border="1" cellspacing="0" cellpadding="5">
<thead>
<tr>
<th rowspan="1" colspan="1">
<p>
Option
</p>
</th>
<th rowspan="1" colspan="1">
<p>
Description
</p>
</th>
<th rowspan="1" colspan="1">
<p>
Default
</p>
</th>
</tr>
</thead>
<tbody>
<tr>
<td colspan="1" valign="top" align="left">
Suspend execution on uncaught exceptions
</td>
<td colspan="1" valign="top" align="left">
This option controls if a program will suspend if an uncaught
exception is thrown.
<p>
For example if you try to call a method on a null object and a
NullPointerException is thrown, with this option on your program
will suspend at the location the exception was thrown
</p>
</td>
<td colspan="1" valign="top" align="left">
On
</td>
</tr>
<tr>
<td colspan="1" valign="top" align="left">
Suspend execution on compilation errors
</td>
<td colspan="1" valign="top" align="left">
This option controls if a program will suspend when a compilation
error is encountered
</td>
<td colspan="1" valign="top" align="left">
On
</td>
</tr>
<tr>
<td colspan="1" valign="top" align="left">
Suspend for breakpoints during evaluations
</td>
<td colspan="1" valign="top" align="left">
This option controls if breakpoints will suspend during an
evaluation of code containing a breakpoint. For more information
about evaluations go <a href=
"../../../../tasks/task-evaluating_expressions.htm">here</a>
</td>
<td colspan="1" valign="top" align="left">
On
</td>
</tr>
<tr>
<td colspan="1" valign="top" align="left">
Open popup when suspended on exception
</td>
<td colspan="1" valign="top" align="left">
This option controls if a popup window will be displayed when
execution of a program stops on an exception. The exception the
program suspended on is made available for inspection in the popup
</td>
<td colspan="1" valign="top" align="left">
Off
</td>
</tr>
<tr>
<td colspan="1" valign="top" align="left">
Default suspend policy for new breakpoints
</td>
<td colspan="1" valign="top" align="left">
This option allows the default suspend policy to be set for new
breakpoints. The suspend policy is used by breakpoints to tell the
VM what to suspend, in this case either the thread the breakpoint
is active in or the entire running VM
</td>
<td colspan="1" valign="top" align="left">
Suspend Thread
</td>
</tr>
<tr>
<td colspan="1" valign="top" align="left">
Default suspend policy for new watchpoints
</td>
<td colspan="1" valign="top" align="left">
This option allows the default suspend policy to be set for new
watchpoints. The suspend policy is used by watchpoints to tell the
VM what kind of field actions to suspend on - in this case either access and modification (both), access only or modification only
</td>
<td colspan="1" valign="top" align="left">
Suspend Thread
</td>
</tr>
<tr>
<td colspan="1" valign="top" align="left">
Enable hot code replace
</td>
<td colspan="1" valign="top" align="left">
This option controls if hot code replacement will be supported
</td>
<td colspan="1" valign="top" align="left">
On
</td>
</tr>
<tr>
<td colspan="1" valign="top" align="left">
Show error when hot code replace fails
</td>
<td colspan="1" valign="top" align="left">
This option controls if you will be presented with an error
dialog when a hot code replace fails
</td>
<td colspan="1" valign="top" align="left">
On
</td>
</tr>
<tr>
<td colspan="1" valign="top" align="left">
Show error when hot code replace is not supported
</td>
<td colspan="1" valign="top" align="left">
This option controls if you will be presented with an error
dialog when hot code replace is not supported. This can happen after you have
made and saved changes to currently running code.
</td>
<td colspan="1" valign="top" align="left">
On
</td>
</tr>
<tr>
<td colspan="1" valign="top" align="left">
Show error when obsolete methods remain after hot code replace
</td>
<td colspan="1" valign="top" align="left">
This option controls if you will be presented with an error
dialog when a hot code replace completed, but there were obsolete
methods left over
</td>
<td colspan="1" valign="top" align="left">
On
</td>
</tr>
<tr>
<td colspan="1" valign="top" align="left">
Replace class files containing compilation errors
</td>
<td colspan="1" valign="top" align="left">
This option controls is class files containing compilation errors
will be replaced
</td>
<td colspan="1" valign="top" align="left">
On
</td>
</tr>
<tr>
<td colspan="1" valign="top" align="left">
Debugger timeout
</td>
<td colspan="1" valign="top" align="left">
This option describes the length of time (in milliseconds) the
debugger will wait trying to communicate with a running VM before
giving up and disconnecting
</td>
<td colspan="1" valign="top" align="left">
3000
</td>
</tr>
<tr>
<td colspan="1" valign="top" align="left">
Launch timeout
</td>
<td colspan="1" valign="top" align="left">
This option describes the length of time (in milliseconds) that a
launch will wait to complete the launching process before giving up
and terminating. This option has no bearing on the length of time a
program will run, only how long the process of <em>trying</em> to
run a program will wait
</td>
<td colspan="1" valign="top" align="left">
20000
</td>
</tr>
<tr>
<td colspan="1" valign="top" align="left">
Warn when unable to install breakpoint due to missing line number
attributes
</td>
<td colspan="1" valign="top" align="left">
This option controls if you will be notified when you try to
set a line breakpoint on a line that has invalid line information
</td>
<td colspan="1" valign="top" align="left">
On
</td>
</tr>
<tr>
<td colspan="1" valign="top" align="left">
Prompt for confirmation when deleting a conditional breakpoint from editor
</td>
<td colspan="1" valign="top" align="left">
This option controls if you should be asked whether you really want to remove a breakpoint with a condition from the editor
</td>
<td colspan="1" valign="top" align="left">
On
</td>
</tr>
<tr>
<td colspan="1" valign="top" align="left">
Do not install breakpoints from unrelated projects
</td>
<td colspan="1" valign="top" align="left">
Multiple versions of the same Java type can be available in a workspace, and each version can
have breakpoints configured at different source locations. When debugging, JDT tries to
determine the "right" set of breakpoints to install in the target VM. This analysis
now uses Java project dependencies by default.
<p>
To always install all enabled breakpoints, you can disable this option.
</p>
<p>
Note that not all projects use explicit Java project dependencies. E.g. OSGi bundles
typically use a dynamically computed classpath where project dependencies are computed
by PDE.
</p>
</td>
<td colspan="1" valign="top" align="left">
On
</td>
</tr>
<tr>
<td colspan="1" valign="top" align="left">
Only include exported classpath entries when launching
</td>
<td colspan="1" valign="top" align="left">
This option controls if only classpath entries marked as exported should be included in the classpath used for launching
</td>
<td colspan="1" valign="top" align="left">
Off
</td>
</tr>
<tr>
<td colspan="1" valign="top" align="left">
Use advanced source lookup
</td>
<td colspan="1" valign="top" align="left">
This option controls if the debugger will use advanced source lookup implementation in addition to standard source lookup heuristics.
Advanced source lookup is a reliable source lookup when multiple versions of the same Java type are present in the target application and when Java types loaded by the application are not fully known in advance. It also enables on-demand sources download by JDT-based tools like M2E (on demand sources download requires explicit support by the tool).
Advanced source lookup is only available for applications running locally.
</td>
<td colspan="1" valign="top" align="left">
On
</td>
</tr>
</tbody>
</table>
<h3 class="related">Related concepts</h3>
<a href="../../../../concepts/cdebugger.htm">Debugger</a><br />
<a href="../../../../concepts/concept-java-perspective.htm">Java
perspectives</a><br />
<a href="../../../../concepts/concept-java-views.htm">Java
views</a><br />
<a href="../../../../concepts/clocdbug.htm">Local debugging</a><br />
<a href="../../../../concepts/cremdbug.htm">Remote debugging</a>
<h3 class="related">Related tasks</h3>
<a href="../../../../tasks/task-launching_java_program.htm">Launching a
Java program</a><br />
<a href="../../../../tasks/task-running_and_debugging.htm">Running and
debugging</a>
<h3 class="related">Related reference</h3>
<a href=
"../../../../reference/preferences/java/debug/ref-detail_formatters.htm">Detail
Formatters Preferences</a><br />
<a href=
"../../../../reference/preferences/java/debug/ref-heap_walking.htm">Heap
Walking Preferences</a><br />
<a href=
"../../../../reference/preferences/java/debug/ref-installed_jres.htm">Installed
JREs Preferences</a><br />
<a href=
"../../../../reference/preferences/java/debug/ref-logical_structures.htm">
Logical Structures Preferences</a><br />
<a href=
"../../../../reference/preferences/java/debug/ref-primitive_display_options.htm">
Primitive Display Preferences</a><br />
<a href=
"../../../../reference/preferences/run-debug/ref-run_debug.htm">Run/Debug
Preferences</a><br />
<a href=
"../../../../reference/preferences/java/debug/ref-step_filtering.htm">Step
Filtering Preferences</a>
</body>
</html>