mirrors/cdt
1
0
Fork 0
mirror of https://github.com/eclipse-cdt/cdt synced 2025-04-29 19:45:01 +02:00
Code Issues Wiki Activity
cdt/doc/org.eclipse.cdt.doc.user/reference/cdt_u_dbg_view.htm
Vivian Kong 836ed96ece minor edit in docs
2009-06-13 03:40:09 +00:00

362 lines
No EOL
17 KiB
HTML
Raw Blame History

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html lang="en">
<head>
<meta http-equiv="Content-Language" content="en-us">
<meta name="GENERATOR" content="Microsoft FrontPage 5.0">
<meta name="ProgId" content="FrontPage.Editor.Document">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Debug view</title>
<link rel="stylesheet" type="text/css" href="../help.css">
</head>
<body>
<h1>Debug view</h1>
<p>The <b>Debug</b> view shows the target debugging information in a tree hierarchy.</p>
<p><img src="../images/view_debug.png" width="529" height="252" alt="Debug view" ></p>
<p>The number beside the thread label is a reference counter, not a
thread identification number (TID).</p>
<p>The CDT displays stack frames as child elements. It displays the reason for
the suspension beside the thread, (such as end of stepping range, breakpoint
hit, and signal received). When a program exits, the exit
code is displayed.</p>
<p>The icons that appear in the Debug view include:</p>
<table border="1" cellpadding="5" cellspacing="0" style="border-collapse: collapse" bordercolor="#999999" width="600">
<tr>
<th width="76" valign="top"><center>
Icons
</center></th>
<th width="169" valign="top">Session item </th>
<th width="317" valign="top">Description </th>
</tr>
<tr>
<td width="76" valign="top"><center>
<img src="../images/icon_db_launch_instance.png" width="19" height="16" alt="Launch instance icon">
</center> </td>
<td width="169" valign="top">Launch instance </td>
<td width="317" valign="top">Launch configuration name and launch type </td>
</tr>
<tr>
<td width="76" valign="top"><center>
<img alt="Icon: Debugger" src="../images/icon_debugt_obj.gif" width="16" height="16">
&nbsp;<img src="../images/icon_db_debug.png" width="16" height="17" alt="Debugger instance icon">
</center> </td>
<td width="169" valign="top">Debugger instance </td>
<td width="317" valign="top">Debugger name and state</td>
</tr>
<tr>
<td width="76" valign="top"><center>
<img alt="Icon: Thread; suspended" src="../images/icon_thread1.gif" width="16" height="16"> &nbsp;<img alt="Icon: Thread; running" src="../images/icon_thread2.gif" width="16" height="16"> &nbsp;<img alt="Icon: Thread; stopped" src="../images/icon_thread3.gif" width="16" height="16">
</center> </td>
<td width="169" valign="top">Thread instance </td>
<td width="317" valign="top">Thread number and state</td>
</tr>
<tr>
<td width="76" valign="top"><center>
<img src="../images/icon_db_stack_frame.png" alt="Stack frame instance icon" width="16" height="15">
</center> </td>
<td width="169" valign="top">Stack frame instance </td>
<td width="317" valign="top">Stack frame number, function, file name, and file line number </td>
</tr>
</table>
<p>In addition to controlling the individual stepping of your programs, you can
also control the debug session. You can perform actions such as terminating the
session and stopping the program by using the debug launch controls available
from Debug view.</p>
<table border="1" cellpadding="5" cellspacing="0" style="border-collapse: collapse" bordercolor="#999999" width="600">
<tr>
<th width="45" align="left"><center>
Icons
</center></th>
<th align="left" valign="bottom" width="211">Action</th>
<th align="left" width="638">Description</th>
</tr>
<tr>
<td align="left" valign="top"> <center>
<img src="../images/icon_db_terminate_all.png" width="21" height="20" alt="Remove all Terminated launches icon">
</center> </td>
<td align="left" valign="top"><b>Remove All Terminated Launches </b></td>
<td align="left" valign="top">Clears all terminated processes in Debug view</td>
</tr>
<tr>
<td align="left" valign="top"> <center>
<img src="../images/icon_db_restart.png" width="20" height="18" alt="Restart icon">
</center> </td>
<td align="left" valign="top"><b>Restart</b></td>
<td align="left" valign="top">Starts a new debug session for the selected process</td>
</tr>
<tr>
<td align="left" valign="top"><center>
<img src="../images/icon_db_resume.png" width="19" height="14" alt="Resume icon">
</center> </td>
<td align="left" valign="top"><b>Resume</b></td>
<td align="left" valign="top">Select the Resume command to resume execution of the currently suspended debug target.</td>
</tr>
<tr>
<td align="left" valign="top"><center>
<img src="../images/icon_db_suspend.png" width="17" height="17" alt="Suspend icon">
</center> </td>
<td align="left" valign="top"><b>Suspend</b></td>
<td align="left" valign="top">Select the Suspend command to halt execution of the currently selected thread in a debug target.</td>
</tr>
<tr>
<td width="45" align="left" valign="top"> <center>
<img src="../images/icon_db_terminate.png" width="17" height="15" alt="Terminate icon">
</center> </td>
<td width="211" align="left" valign="top"><b>Terminate </b></td>
<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>
</tr>
<tr>
<td width="45" align="left" valign="top"> <center>
<img border="0" src="../images/icon_disconnect.gif" width="16" height="16" alt="Disconnect icon">
</center> </td>
<td width="211" align="left" valign="top"><b>Disconnect</b></td>
<td width="638" align="left" valign="top">Detaches the debugger from the selected process (useful for
debugging attached processes).</td>
</tr>
<tr>
<td align="left" valign="top"><center>
<img src="../images/icon_db_stepinto.png" width="18" height="14" alt="Step Into icon">
</center> </td>
<td align="left" valign="top"><b>Step Into </b></td>
<td>Select to execute the current line, including any routines, and proceed to the next statement.</td>
</tr>
<tr>
<td align="left" valign="top"><center>
<img src="../images/icon_db_stepover.png" width="19" height="14" alt="Step Over icon">
</center> </td>
<td align="left" valign="top"><b>Step Over </b></td>
<td>Select to execute the current line, following execution inside a routine.</td>
</tr>
<tr>
<td align="left" valign="top"><center>
<img src="../images/icon_db_stepreturn.png" width="17" height="14" alt="Step Return icon">
</center> </td>
<td align="left" valign="top"><b>Step Return </b></td>
<td>Select to continue execution to the end of the current routine, then follow execution to the routine&rsquo;s caller.</td>
</tr>
<tr>
<td align="left" valign="top"><center>
<img src="../images/icon_db_drop_to_frame.png" width="18" height="17" alt="Drop to Frame icon">
</center> </td>
<td align="left" valign="top"><b>Drop to Frame </b></td>
<td align="left" valign="top">Select the Drop to Frame command to re-enter the selected stack frame in the Debug view.</td>
</tr>
<tr>
<td align="left" valign="top"><center>
<img src="../images/icon_db_step_mode.png" width="19" height="14" alt="Instruction Stepping Mode icon">
</center> </td>
<td align="left" valign="top"><b>Instruction Stepping Mode </b></td>
<td align="left" valign="top">Activate to enable instruction stepping mode to examine a program as it steps into disassembled code. </td>
</tr>
<tr>
<td align="left" valign="top"><center>
<img src="../images/icon_db_use_step_filters.png" width="18" height="17" alt="Use Step Filters icon">
</center> </td>
<td align="left" valign="top"><b>Use Step Filters </b></td>
<td align="left" valign="top">Select the Use Step Filters command to change whether step filters should be used in the Debug view.</td>
</tr>
<tr>
<td align="left" valign="top"><center>
</center> </td>
<td align="left" valign="top"><b>Menu</b></td>
<td align="left" valign="top"><p>Use the Debug view menu to:</p>
<ul>
<li>change the layout of debug view (tree vs. breadcrumb)</li>
<li>alternate showing of full or no paths on source files</li>
<li>control how views are managed</li>
<li>activate or deactivate the child elements shown in the Debug view </li>
</ul></td>
</tr>
</table>
<h3>Debug view context menu commands </h3>
<p>The Debug view context menu commands include:</p>
<table border="1" cellpadding="5" cellspacing="0" style="border-collapse: collapse" bordercolor="#999999" width="600">
<tr>
<td align="center"><b>Icons</b></td>
<td align="center"><b>Name</b></td>
<td align="center"><b>Description</b></td>
</tr>
<tr>
<td align="left"><center>
<img src="../images/icon_db_copy_stack.png" width="20" height="19" alt="Copy Stack icon">
</center> </td>
<td><b>Copy Stack </b></td>
<td>Copies the selected stack of suspended threads as well as the state of the running threads to the clipboard. </td>
</tr>
<tr>
<td align="left"><center>
</center> </td>
<td><b>Find...</b></td>
<td>Opens the debug view element searching dialog.</td>
</tr>
<tr>
<td align="left"><center>
<img src="../images/icon_db_drop_to_frame.png" width="18" height="17" alt="Drop to Frame icon">
</center> </td>
<td><b>Drop To Frame </b></td>
<td>Select the Drop to Frame command to re-enter the selected stack frame in the Debug view.</td>
</tr>
<tr>
<td align="left" valign="top"> <center>
<img src="../images/icon_db_restart.png" width="20" height="18" alt="Restart icon">
</center> </td>
<td align="left" valign="top"><b>Restart</b></td>
<td align="left" valign="top">Starts a new debug session for the selected process</td>
</tr>
<tr>
<td align="left" valign="top"> <center>
<img src="../images/icon_db_stepinto.png" width="18" height="14" alt="Step Into icon">
</center> </td>
<td align="left" valign="top"><b>Step Into </b></td>
<td>Select to execute the current line, including any routines, and proceed to the next statement.</td>
</tr>
<tr>
<td align="left" valign="top"> <center>
<img src="../images/icon_db_stepover.png" width="19" height="14" alt="Step Over icon">
</center> </td>
<td align="left" valign="top"><b>Step Over </b></td>
<td>Select to execute the current line, following execution inside a routine.</td>
</tr>
<tr>
<td align="left" valign="top"> <center>
<img src="../images/icon_db_stepreturn.png" width="17" height="14" alt="Step Return icon">
</center> </td>
<td align="left" valign="top"><b>Step Return </b></td>
<td>Select to continue execution to the end of the current routine, then follow execution to the routine&rsquo;s caller.</td>
</tr>
<tr>
<td align="left" valign="top"> <center>
<img src="../images/icon_db_step_mode.png" width="19" height="14" alt="Instruction Stepping Mode icon">
</center> </td>
<td align="left" valign="top"><b>Instruction Stepping Mode </b></td>
<td align="left" valign="top">Activate to enable instruction stepping mode to examine a program as it steps into disassembled code. </td>
</tr>
<tr>
<td align="left" valign="top"> <center>
<img src="../images/icon_db_use_step_filters.png" width="18" height="17" alt="Use Step Filters icon">
</center> </td>
<td align="left" valign="top"><b>Use Step Filters </b></td>
<td align="left" valign="top">Toggles step filters on/off. When on, all step functions apply step filters.</td>
</tr>
<tr>
<td align="left"><center>
<img src="../images/icon_resume_signal.png" width="17" height="15" alt="Resume without signal icon">
</center> </td>
<td><b>Resume Without Signal </b></td>
<td valign="top">Resume program execution after receiving the signal. </td>
</tr>
<tr>
<td align="left" valign="top"> <center>
<img src="../images/icon_db_resume.png" width="19" height="14" alt="Resume icon">
</center> </td>
<td align="left" valign="top"><b>Resume</b></td>
<td align="left" valign="top">Select the Resume command to resume execution of the currently suspended debug target.</td>
</tr>
<tr>
<td align="left" valign="top"> <center>
<img src="../images/icon_db_suspend.png" width="17" height="17" alt="Suspend icon">
</center> </td>
<td align="left" valign="top"><b>Suspend</b></td>
<td align="left" valign="top">Select the Suspend command to halt execution of the currently selected thread in a debug target.</td>
</tr>
<tr>
<td align="left" valign="top"> <center>
<img src="../images/icon_db_terminate.png" width="17" height="15" alt="Terminate icon">
</center> </td>
<td align="left" valign="top"><b>Terminate </b></td>
<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>
</tr>
<tr>
<td align="left"><center>
<img src="../images/icon_db_terminate_relaunch.png" width="19" height="17" alt="Terminate and Relaunch icon">
</center> </td>
<td><b>Terminate and Relaunch </b></td>
<td>Select the Terminate and Relaunch command to terminate the selected debug target and then relaunch it.</td>
</tr>
<tr>
<td align="left" valign="top"> <center>
<img border="0" src="../images/icon_disconnect.gif" width="16" height="16" alt="Disconnect icon">
</center> </td>
<td align="left" valign="top"><b>Disconnect</b></td>
<td align="left" valign="top">Detaches the debugger from the selected process (useful for
debugging attached processes)</td>
</tr>
<tr>
<td align="left" valign="top"> <center>
<img src="../images/icon_db_terminate_all.png" width="21" height="20" alt="Remote all Terminated icon">
</center> </td>
<td align="left" valign="top"><b>Remove All Terminated </b></td>
<td align="left" valign="top">Clears all terminated processes in Debug view</td>
</tr>
<tr>
<td align="left"><center>
<img src="../images/icon_db_relaunch.png" width="21" height="19" alt="Relaunch icon">
</center> </td>
<td><b>Relaunch</b></td>
<td>This command relaunches the selected debug target. </td>
</tr>
<tr>
<td align="left"><center>
</center> </td>
<td><b>Edit...</b></td>
<td>Opens the launch configuration dialog, allowing you to make changes. </td>
</tr>
<tr>
<td align="left"><center>
<img src="../images/icon_db_edit_src_lookup.png" width="20" height="18" alt="Edit Source Lookup icon">
</center> </td>
<td><b>Edit Source Lookup... </b></td>
<td valign="top">Opens the source lookup dialog, allowing you to make changes. </td>
</tr>
<tr>
<td align="left"><center>
</center> </td>
<td><b>Lookup Source </b></td>
<td>Select to force a source lookup to take place. </td>
</tr>
<tr>
<td align="left"><center>
<img src="../images/icon_db_terminate_remove.png" width="19" height="17" alt="Terminate and Remove icon">
</center> </td>
<td><b>Terminate and Remove </b></td>
<td>Terminates the selected debug target and removes it from the view. </td>
</tr>
<tr>
<td align="left"><center>
<img src="../images/icon_db_terminate_all2.png" width="19" height="18" alt="Terminate all icon">
</center> </td>
<td><b>Terminate All </b></td>
<td>Terminates all active launches in the view. </td>
</tr>
<tr>
<td align="left"><center>
</center> </td>
<td><b>Properties</b></td>
<td>Opens the <b>Properties for</b> window showing the process properties. </td>
</tr>
</table>
<p><img border="0" src="../images/ngconcepts.gif" ALT="Related concepts" width="143" height="21">
<br>
<a href="../concepts/cdt_c_over_dbg.htm">Debug overview</a><br>
<a href="../concepts/cdt_c_dbg_info.htm">Debug information</a></p>
<p><img border="0" src="../images/ngtasks.gif" ALT="Related tasks" width="143" height="21">
<br>
<a href="../tasks/cdt_o_debug.htm">Debugging</a></p>
<p><img border="0" src="../images/ngref.gif" ALT="Related reference" width="143" height="21">
<br>
<a href="cdt_o_run_dbg_pages.htm">Run and Debug dialog box</a></p>
<a href="cdt_u_dbg_breadcrumb.htm">Debug Breadcrumb</a></p>
<img src="../images/nokia2007Copyright.png" alt="Nokia Copyright Statement"><br>
<img src="../images/ng00_04a.gif" ALT="IBM Copyright Statement" >
</body>
</html>
Reference in a new issue View git blame Copy permalink