|
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> |
|
2 <html lang="en"> |
|
3 |
|
4 <head> |
|
5 <meta http-equiv="Content-Language" content="en-us"> |
|
6 <meta name="GENERATOR" content="Microsoft FrontPage 5.0"> |
|
7 <meta name="ProgId" content="FrontPage.Editor.Document"> |
|
8 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> |
|
9 <title>Debug view</title> |
|
10 <link rel="stylesheet" type="text/css" href="../help.css"> |
|
11 </head> |
|
12 |
|
13 <body> |
|
14 |
|
15 <h1>Debug view</h1> |
|
16 |
|
17 <p>The <b>Debug</b> view shows the target debugging information in a tree hierarchy.</p> |
|
18 <p><img src="../images/view_debug.png" width="529" height="252" alt="Debug view" ></p> |
|
19 <p>The number beside the thread label is a reference counter, not a |
|
20 thread identification number (TID).</p> |
|
21 <p>The CDT displays stack frames as child elements. It displays the reason for |
|
22 the suspension beside the thread, (such as end of stepping range, breakpoint |
|
23 hit, and signal received). When a program exits, the exit |
|
24 code is displayed.</p> |
|
25 <p>The icons that appear in the Debug view include:</p> |
|
26 <table border="1" cellpadding="5" cellspacing="0" style="border-collapse: collapse" bordercolor="#999999" width="600"> |
|
27 <tr> |
|
28 <th width="76" valign="top"><center> |
|
29 Icons |
|
30 </center></th> |
|
31 <th width="169" valign="top">Session item </th> |
|
32 <th width="317" valign="top">Description </th> |
|
33 </tr> |
|
34 <tr> |
|
35 <td width="76" valign="top"><center> |
|
36 <img src="../images/icon_db_launch_instance.png" width="19" height="16" alt="Launch instance icon"> |
|
37 </center> </td> |
|
38 <td width="169" valign="top">Launch instance </td> |
|
39 <td width="317" valign="top">Launch configuration name and launch type </td> |
|
40 </tr> |
|
41 <tr> |
|
42 <td width="76" valign="top"><center> |
|
43 <img alt="Icon: Debugger" src="../images/icon_debugt_obj.gif" width="16" height="16"> |
|
44 <img src="../images/icon_db_debug.png" width="16" height="17" alt="Debugger instance icon"> |
|
45 </center> </td> |
|
46 <td width="169" valign="top">Debugger instance </td> |
|
47 <td width="317" valign="top">Debugger name and state</td> |
|
48 </tr> |
|
49 <tr> |
|
50 <td width="76" valign="top"><center> |
|
51 <img alt="Icon: Thread; suspended" src="../images/icon_thread1.gif" width="16" height="16"> <img alt="Icon: Thread; running" src="../images/icon_thread2.gif" width="16" height="16"> <img alt="Icon: Thread; stopped" src="../images/icon_thread3.gif" width="16" height="16"> |
|
52 </center> </td> |
|
53 <td width="169" valign="top">Thread instance </td> |
|
54 <td width="317" valign="top">Thread number and state</td> |
|
55 </tr> |
|
56 <tr> |
|
57 <td width="76" valign="top"><center> |
|
58 <img src="../images/icon_db_stack_frame.png" alt="Stack frame instance icon" width="16" height="15"> |
|
59 </center> </td> |
|
60 <td width="169" valign="top">Stack frame instance </td> |
|
61 <td width="317" valign="top">Stack frame number, function, file name, and file line number </td> |
|
62 </tr> |
|
63 </table> |
|
64 <p>In addition to controlling the individual stepping of your programs, you can |
|
65 also control the debug session. You can perform actions such as terminating the |
|
66 session and stopping the program by using the debug launch controls available |
|
67 from Debug view.</p> |
|
68 |
|
69 <table border="1" cellpadding="5" cellspacing="0" style="border-collapse: collapse" bordercolor="#999999" width="600"> |
|
70 <tr> |
|
71 <th width="45" align="left"><center> |
|
72 Icons |
|
73 </center></th> |
|
74 <th align="left" valign="bottom" width="211">Action</th> |
|
75 <th align="left" width="638">Description</th> |
|
76 </tr> |
|
77 <tr> |
|
78 <td align="left" valign="top"> <center> |
|
79 <img src="../images/icon_db_terminate_all.png" width="21" height="20" alt="Remove all Terminated launches icon"> |
|
80 </center> </td> |
|
81 <td align="left" valign="top"><b>Remove All Terminated Launches </b></td> |
|
82 <td align="left" valign="top">Clears all terminated processes in Debug view</td> |
|
83 </tr> |
|
84 <tr> |
|
85 <td align="left" valign="top"> <center> |
|
86 <img src="../images/icon_db_restart.png" width="20" height="18" alt="Restart icon"> |
|
87 </center> </td> |
|
88 <td align="left" valign="top"><b>Restart</b></td> |
|
89 <td align="left" valign="top">Starts a new debug session for the selected process</td> |
|
90 </tr> |
|
91 <tr> |
|
92 <td align="left" valign="top"><center> |
|
93 <img src="../images/icon_db_resume.png" width="19" height="14" alt="Resume icon"> |
|
94 </center> </td> |
|
95 <td align="left" valign="top"><b>Resume</b></td> |
|
96 <td align="left" valign="top">Select the Resume command to resume execution of the currently suspended debug target.</td> |
|
97 </tr> |
|
98 <tr> |
|
99 <td align="left" valign="top"><center> |
|
100 <img src="../images/icon_db_suspend.png" width="17" height="17" alt="Suspend icon"> |
|
101 </center> </td> |
|
102 <td align="left" valign="top"><b>Suspend</b></td> |
|
103 <td align="left" valign="top">Select the Suspend command to halt execution of the currently selected thread in a debug target.</td> |
|
104 </tr> |
|
105 <tr> |
|
106 <td width="45" align="left" valign="top"> <center> |
|
107 <img src="../images/icon_db_terminate.png" width="17" height="15" alt="Terminate icon"> |
|
108 </center> </td> |
|
109 <td width="211" align="left" valign="top"><b>Terminate </b></td> |
|
110 <td width="638" align="left" valign="top">Ends the selected debug session and/or process. The impact of this action depends on the type of the item selected in the Debug view.</td> |
|
111 </tr> |
|
112 <tr> |
|
113 <td width="45" align="left" valign="top"> <center> |
|
114 <img border="0" src="../images/icon_disconnect.gif" width="16" height="16" alt="Disconnect icon"> |
|
115 </center> </td> |
|
116 <td width="211" align="left" valign="top"><b>Disconnect</b></td> |
|
117 <td width="638" align="left" valign="top">Detaches the debugger from the selected process (useful for |
|
118 debugging attached processes).</td> |
|
119 </tr> |
|
120 <tr> |
|
121 <td align="left" valign="top"><center> |
|
122 <img src="../images/icon_db_stepinto.png" width="18" height="14" alt="Step Into icon"> |
|
123 </center> </td> |
|
124 <td align="left" valign="top"><b>Step Into </b></td> |
|
125 <td>Select to execute the current line, including any routines, and proceed to the next statement.</td> |
|
126 </tr> |
|
127 <tr> |
|
128 <td align="left" valign="top"><center> |
|
129 <img src="../images/icon_db_stepover.png" width="19" height="14" alt="Step Over icon"> |
|
130 </center> </td> |
|
131 <td align="left" valign="top"><b>Step Over </b></td> |
|
132 <td>Select to execute the current line, following execution inside a routine.</td> |
|
133 </tr> |
|
134 <tr> |
|
135 <td align="left" valign="top"><center> |
|
136 <img src="../images/icon_db_stepreturn.png" width="17" height="14" alt="Step Return icon"> |
|
137 </center> </td> |
|
138 <td align="left" valign="top"><b>Step Return </b></td> |
|
139 <td>Select to continue execution to the end of the current routine, then follow execution to the routine’s caller.</td> |
|
140 </tr> |
|
141 <tr> |
|
142 <td align="left" valign="top"><center> |
|
143 <img src="../images/icon_db_drop_to_frame.png" width="18" height="17" alt="Drop to Frame icon"> |
|
144 </center> </td> |
|
145 <td align="left" valign="top"><b>Drop to Frame </b></td> |
|
146 <td align="left" valign="top">Select the Drop to Frame command to re-enter the selected stack frame in the Debug view.</td> |
|
147 </tr> |
|
148 <tr> |
|
149 <td align="left" valign="top"><center> |
|
150 <img src="../images/icon_db_step_mode.png" width="19" height="14" alt="Instruction Stepping Mode icon"> |
|
151 </center> </td> |
|
152 <td align="left" valign="top"><b>Instruction Stepping Mode </b></td> |
|
153 <td align="left" valign="top">Activate to enable instruction stepping mode to examine a program as it steps into disassembled code. </td> |
|
154 </tr> |
|
155 <tr> |
|
156 <td align="left" valign="top"><center> |
|
157 <img src="../images/icon_db_use_step_filters.png" width="18" height="17" alt="Use Step Filters icon"> |
|
158 </center> </td> |
|
159 <td align="left" valign="top"><b>Use Step Filters </b></td> |
|
160 <td align="left" valign="top">Select the Use Step Filters command to change whether step filters should be used in the Debug view.</td> |
|
161 </tr> |
|
162 <tr> |
|
163 <td align="left" valign="top"><center> |
|
164 </center> </td> |
|
165 <td align="left" valign="top"><b>Menu</b></td> |
|
166 <td align="left" valign="top"><p>Use the Debug view menu to:</p> |
|
167 <ul> |
|
168 <li>change the layout of debug view (tree vs. breadcrumb)</li> |
|
169 <li>alternate showing of full or no paths on source files</li> |
|
170 <li>control how views are managed</li> |
|
171 <li>activate or deactivate the child elements shown in the Debug view </li> |
|
172 </ul></td> |
|
173 </tr> |
|
174 </table> |
|
175 |
|
176 <h3>Debug view context menu commands </h3> |
|
177 |
|
178 <p>The Debug view context menu commands include:</p> |
|
179 <table border="1" cellpadding="5" cellspacing="0" style="border-collapse: collapse" bordercolor="#999999" width="600"> |
|
180 <tr> |
|
181 <td align="center"><b>Icons</b></td> |
|
182 <td align="center"><b>Name</b></td> |
|
183 <td align="center"><b>Description</b></td> |
|
184 </tr> |
|
185 <tr> |
|
186 <td align="left"><center> |
|
187 <img src="../images/icon_db_copy_stack.png" width="20" height="19" alt="Copy Stack icon"> |
|
188 </center> </td> |
|
189 <td><b>Copy Stack </b></td> |
|
190 <td>Copies the selected stack of suspended threads as well as the state of the running threads to the clipboard. </td> |
|
191 </tr> |
|
192 <tr> |
|
193 <td align="left"><center> |
|
194 </center> </td> |
|
195 <td><b>Find...</b></td> |
|
196 <td>Opens the debug view element searching dialog.</td> |
|
197 </tr> |
|
198 <tr> |
|
199 <td align="left"><center> |
|
200 <img src="../images/icon_db_drop_to_frame.png" width="18" height="17" alt="Drop to Frame icon"> |
|
201 </center> </td> |
|
202 <td><b>Drop To Frame </b></td> |
|
203 <td>Select the Drop to Frame command to re-enter the selected stack frame in the Debug view.</td> |
|
204 </tr> |
|
205 <tr> |
|
206 <td align="left" valign="top"> <center> |
|
207 <img src="../images/icon_db_restart.png" width="20" height="18" alt="Restart icon"> |
|
208 </center> </td> |
|
209 <td align="left" valign="top"><b>Restart</b></td> |
|
210 <td align="left" valign="top">Starts a new debug session for the selected process</td> |
|
211 </tr> |
|
212 <tr> |
|
213 <td align="left" valign="top"> <center> |
|
214 <img src="../images/icon_db_stepinto.png" width="18" height="14" alt="Step Into icon"> |
|
215 </center> </td> |
|
216 <td align="left" valign="top"><b>Step Into </b></td> |
|
217 <td>Select to execute the current line, including any routines, and proceed to the next statement.</td> |
|
218 </tr> |
|
219 <tr> |
|
220 <td align="left" valign="top"> <center> |
|
221 <img src="../images/icon_db_stepover.png" width="19" height="14" alt="Step Over icon"> |
|
222 </center> </td> |
|
223 <td align="left" valign="top"><b>Step Over </b></td> |
|
224 <td>Select to execute the current line, following execution inside a routine.</td> |
|
225 </tr> |
|
226 <tr> |
|
227 <td align="left" valign="top"> <center> |
|
228 <img src="../images/icon_db_stepreturn.png" width="17" height="14" alt="Step Return icon"> |
|
229 </center> </td> |
|
230 <td align="left" valign="top"><b>Step Return </b></td> |
|
231 <td>Select to continue execution to the end of the current routine, then follow execution to the routine’s caller.</td> |
|
232 </tr> |
|
233 <tr> |
|
234 <td align="left" valign="top"> <center> |
|
235 <img src="../images/icon_db_step_mode.png" width="19" height="14" alt="Instruction Stepping Mode icon"> |
|
236 </center> </td> |
|
237 <td align="left" valign="top"><b>Instruction Stepping Mode </b></td> |
|
238 <td align="left" valign="top">Activate to enable instruction stepping mode to examine a program as it steps into disassembled code. </td> |
|
239 </tr> |
|
240 <tr> |
|
241 <td align="left" valign="top"> <center> |
|
242 <img src="../images/icon_db_use_step_filters.png" width="18" height="17" alt="Use Step Filters icon"> |
|
243 </center> </td> |
|
244 <td align="left" valign="top"><b>Use Step Filters </b></td> |
|
245 <td align="left" valign="top">Toggles step filters on/off. When on, all step functions apply step filters.</td> |
|
246 </tr> |
|
247 <tr> |
|
248 <td align="left"><center> |
|
249 <img src="../images/icon_resume_signal.png" width="17" height="15" alt="Resume without signal icon"> |
|
250 </center> </td> |
|
251 <td><b>Resume Without Signal </b></td> |
|
252 <td valign="top">Resume program execution after receiving the signal. </td> |
|
253 </tr> |
|
254 <tr> |
|
255 <td align="left" valign="top"> <center> |
|
256 <img src="../images/icon_db_resume.png" width="19" height="14" alt="Resume icon"> |
|
257 </center> </td> |
|
258 <td align="left" valign="top"><b>Resume</b></td> |
|
259 <td align="left" valign="top">Select the Resume command to resume execution of the currently suspended debug target.</td> |
|
260 </tr> |
|
261 <tr> |
|
262 <td align="left" valign="top"> <center> |
|
263 <img src="../images/icon_db_suspend.png" width="17" height="17" alt="Suspend icon"> |
|
264 </center> </td> |
|
265 <td align="left" valign="top"><b>Suspend</b></td> |
|
266 <td align="left" valign="top">Select the Suspend command to halt execution of the currently selected thread in a debug target.</td> |
|
267 </tr> |
|
268 <tr> |
|
269 <td align="left" valign="top"> <center> |
|
270 <img src="../images/icon_db_terminate.png" width="17" height="15" alt="Terminate icon"> |
|
271 </center> </td> |
|
272 <td align="left" valign="top"><b>Terminate </b></td> |
|
273 <td align="left" valign="top">Ends the selected debug session and/or process. The impact of this action depends on the type of the item selected in the Debug view.</td> |
|
274 </tr> |
|
275 <tr> |
|
276 <td align="left"><center> |
|
277 <img src="../images/icon_db_terminate_relaunch.png" width="19" height="17" alt="Terminate and Relaunch icon"> |
|
278 </center> </td> |
|
279 <td><b>Terminate and Relaunch </b></td> |
|
280 <td>Select the Terminate and Relaunch command to terminate the selected debug target and then relaunch it.</td> |
|
281 </tr> |
|
282 <tr> |
|
283 <td align="left" valign="top"> <center> |
|
284 <img border="0" src="../images/icon_disconnect.gif" width="16" height="16" alt="Disconnect icon"> |
|
285 </center> </td> |
|
286 <td align="left" valign="top"><b>Disconnect</b></td> |
|
287 <td align="left" valign="top">Detaches the debugger from the selected process (useful for |
|
288 debugging attached processes)</td> |
|
289 </tr> |
|
290 <tr> |
|
291 <td align="left" valign="top"> <center> |
|
292 <img src="../images/icon_db_terminate_all.png" width="21" height="20" alt="Remote all Terminated icon"> |
|
293 </center> </td> |
|
294 <td align="left" valign="top"><b>Remove All Terminated </b></td> |
|
295 <td align="left" valign="top">Clears all terminated processes in Debug view</td> |
|
296 </tr> |
|
297 <tr> |
|
298 <td align="left"><center> |
|
299 <img src="../images/icon_db_relaunch.png" width="21" height="19" alt="Relaunch icon"> |
|
300 </center> </td> |
|
301 <td><b>Relaunch</b></td> |
|
302 <td>This command relaunches the selected debug target. </td> |
|
303 </tr> |
|
304 <tr> |
|
305 <td align="left"><center> |
|
306 </center> </td> |
|
307 <td><b>Edit...</b></td> |
|
308 <td>Opens the launch configuration dialog, allowing you to make changes. </td> |
|
309 </tr> |
|
310 <tr> |
|
311 <td align="left"><center> |
|
312 <img src="../images/icon_db_edit_src_lookup.png" width="20" height="18" alt="Edit Source Lookup icon"> |
|
313 </center> </td> |
|
314 <td><b>Edit Source Lookup... </b></td> |
|
315 <td valign="top">Opens the source lookup dialog, allowing you to make changes. </td> |
|
316 </tr> |
|
317 <tr> |
|
318 <td align="left"><center> |
|
319 </center> </td> |
|
320 <td><b>Lookup Source </b></td> |
|
321 <td>Select to force a source lookup to take place. </td> |
|
322 </tr> |
|
323 <tr> |
|
324 <td align="left"><center> |
|
325 <img src="../images/icon_db_terminate_remove.png" width="19" height="17" alt="Terminate and Remove icon"> |
|
326 </center> </td> |
|
327 <td><b>Terminate and Remove </b></td> |
|
328 <td>Terminates the selected debug target and removes it from the view. </td> |
|
329 </tr> |
|
330 <tr> |
|
331 <td align="left"><center> |
|
332 <img src="../images/icon_db_terminate_all2.png" width="19" height="18" alt="Terminate all icon"> |
|
333 </center> </td> |
|
334 <td><b>Terminate All </b></td> |
|
335 <td>Terminates all active launches in the view. </td> |
|
336 </tr> |
|
337 <tr> |
|
338 <td align="left"><center> |
|
339 </center> </td> |
|
340 <td><b>Properties</b></td> |
|
341 <td>Opens the <b>Properties for</b> window showing the process properties. </td> |
|
342 </tr> |
|
343 </table> |
|
344 |
|
345 <p><img border="0" src="../images/ngconcepts.gif" ALT="Related concepts" width="143" height="21"> |
|
346 <br> |
|
347 <a href="../concepts/cdt_c_over_dbg.htm">Debug overview</a><br> |
|
348 <a href="../concepts/cdt_c_dbg_info.htm">Debug information</a></p> |
|
349 <p><img border="0" src="../images/ngtasks.gif" ALT="Related tasks" width="143" height="21"> |
|
350 <br> |
|
351 <a href="../tasks/cdt_o_debug.htm">Debugging</a></p> |
|
352 <p><img border="0" src="../images/ngref.gif" ALT="Related reference" width="143" height="21"> |
|
353 <br> |
|
354 <a href="cdt_o_run_dbg_pages.htm">Run and Debug dialog box</a></p> |
|
355 <a href="cdt_u_dbg_breadcrumb.htm">Debug Breadcrumb</a></p> |
|
356 |
|
357 <img src="../images/nokia2007Copyright.png" alt="Nokia Copyright Statement"><br> |
|
358 <img src="../images/ng00_04a.gif" ALT="IBM Copyright Statement" > |
|
359 |
|
360 </body> |
|
361 |
|
362 </html> |