| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> |
| <html lang="en"> |
| |
| <head> |
| <meta http-equiv="Content-Language" content="en-us"> |
| <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> |
| <title>Debug view</title> |
| <link rel="stylesheet" type="text/css" href="../help.css"> |
| <script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js"></script> |
| </head> |
| |
| <body> |
| |
| <div role="main"><h1>Debug view</h1> |
| |
| <p>The <img src="../images/command_link.png" alt="" > <a class="command-link" href='javascript:executeCommand("org.eclipse.ui.views.showView(org.eclipse.ui.views.showView.viewId=org.eclipse.debug.ui.DebugView)")'>Debug</a> 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="#DDDDDD" width="600"> |
| <tr> |
| <th style="width: 76" valign="top" id="icon"> |
| Icons |
| </th> |
| <th style="width:169" valign="top" id="session">Session item </th> |
| <th style="width:317" valign="top" id="description">Description </th> |
| </tr> |
| <tr> |
| <td style="width:76" valign="top" headers="icon"> |
| <img src="../images/icon_db_launch_instance.png" width="19" height="16" alt="Launch instance icon"> |
| </td> |
| <td style="width:169" valign="top" headers="session">Launch instance </td> |
| <td style="width:317" valign="top" headers="description">Launch configuration name and launch type </td> |
| </tr> |
| <tr> |
| <td style="width:76" valign="top" headers="icon"> |
| <img alt="Icon: Debugger" src="../images/icon_debugt_obj.gif" width="16" height="16"> |
| <img src="../images/icon_db_debug.png" width="16" height="17" alt="Debugger instance icon"> |
| </td> |
| <td style="width:169" valign="top" headers="session">Debugger instance </td> |
| <td style="width:317" valign="top" headers="description">Debugger name and state</td> |
| </tr> |
| <tr> |
| <td style="width:76" valign="top" headers="icon"> |
| <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"> |
| </td> |
| <td style="width:169" valign="top" headers="session">Thread instance </td> |
| <td style="width:317" valign="top" headers="description">Thread number and state</td> |
| </tr> |
| <tr> |
| <td style="width:76" valign="top" headers="icon"> |
| <img src="../images/icon_db_stack_frame.png" alt="Stack frame instance icon" width="16" height="15"> |
| </td> |
| <td style="width:169" valign="top" headers="session">Stack frame instance </td> |
| <td style="width:317" valign="top" headers="description">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> |
| |
| <h2>Debug view toolbar options</h2> |
| <p>The table below lists the toolbar options displayed in the Debug view.</p> |
| |
| <table border="1" cellpadding="5" cellspacing="0" style="border-collapse: collapse" bordercolor="#DDDDDD" width="600"> |
| <tr> |
| <th style="width:45" style="text-align:left" id="icon2"> |
| Icons |
| </th> |
| <th style="text-align:left" style="width:211" id="action">Action</th> |
| <th style="text-align:left" style="width:638" id="description2">Description</th> |
| </tr> |
| <tr> |
| <td style="text-align:left" valign="top" headers="icon2"> |
| <img src="../images/icon_db_terminate_all.png" width="21" height="20" alt="Remove all Terminated launches icon"> |
| </td> |
| <td style="text-align:left" valign="top" headers="action"><strong>Remove All Terminated Launches </strong></td> |
| <td style="text-align:left" valign="top" headers="description2">Clears all terminated processes in Debug view</td> |
| </tr> |
| <tr> |
| <td style="text-align:left" valign="top" headers="icon2"> </td> |
| <td style="text-align:left" valign="top" headers="action"><strong>Connect to a Process</strong></td> |
| <td style="text-align:left" valign="top" headers="description2">Enables the selection of a running process to debug.</td> |
| </tr> |
| <tr> |
| <td style="text-align:left" valign="top" headers="icon2"> |
| <img src="../images/icon_db_restart.png" width="20" height="18" alt="Restart icon"> |
| </td> |
| <td style="text-align:left" valign="top" headers="action"><strong>Restart</strong></td> |
| <td style="text-align:left" valign="top" headers="description2">Starts a new debug session for the selected process</td> |
| </tr> |
| <tr> |
| <td style="text-align:left" valign="top" headers="icon2"> |
| <img src="../images/icon_db_resume.png" width="19" height="14" alt="Resume icon"> |
| </td> |
| <td style="text-align:left" valign="top" headers="action"><strong>Resume</strong></td> |
| <td style="text-align:left" valign="top" headers="description2">Select the Resume command to resume execution of the currently suspended debug target.</td> |
| </tr> |
| <tr> |
| <td style="text-align:left" valign="top" headers="icon2"> |
| <img src="../images/icon_db_suspend.png" width="17" height="17" alt="Suspend icon"> |
| </td> |
| <td style="text-align:left" valign="top" headers="action"><strong>Suspend</strong></td> |
| <td style="text-align:left" valign="top" headers="description2">Select the Suspend command to halt execution of the currently selected thread in a debug target.</td> |
| </tr> |
| <tr> |
| <td style="width:45" style="text-align:left" valign="top" headers="icon2"> |
| <img src="../images/icon_db_terminate.png" width="17" height="15" alt="Terminate icon"> |
| </td> |
| <td style="width:211" style="text-align:left" valign="top" headers="action"><strong>Terminate </strong></td> |
| <td style="width:638" style="text-align:left" valign="top" headers="description2">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 style="width:45" style="text-align:left" valign="top" headers="icon2"> |
| <img src="../images/icon_disconnect.gif" width="16" height="16" alt="Disconnect icon"> |
| </td> |
| <td style="width:211" style="text-align:left" valign="top" headers="action"><strong>Disconnect</strong></td> |
| <td style="width:638" style="text-align:left" valign="top" headers="description2">Detaches the debugger from the selected process (useful for |
| debugging attached processes).</td> |
| </tr> |
| <tr> |
| <td style="text-align:left" valign="top" headers="icon2"> |
| <img src="../images/icon_db_stepinto.png" width="18" height="14" alt="Step Into icon"> |
| </td> |
| <td style="text-align:left" valign="top" headers="action"><strong>Step Into </strong></td> |
| <td headers="description2">Select to execute the current line, including any routines, and proceed to the next statement.</td> |
| </tr> |
| <tr> |
| <td style="text-align:left" valign="top" headers="icon2"> |
| <img src="../images/icon_db_stepover.png" width="19" height="14" alt="Step Over icon"> |
| </td> |
| <td style="text-align:left" valign="top" headers="action"><strong>Step Over </strong></td> |
| <td headers="description2">Select to execute the current line, following execution inside a routine.</td> |
| </tr> |
| <tr> |
| <td style="text-align:left" valign="top" headers="icon2"> |
| <img src="../images/icon_db_stepreturn.png" width="17" height="14" alt="Step Return icon"> |
| </td> |
| <td style="text-align:left" valign="top" headers="action"><strong>Step Return </strong></td> |
| <td headers="description2">Select to continue execution to the end of the current routine, then follow execution to the routine's caller.</td> |
| </tr> |
| <tr> |
| <td style="text-align:left" valign="top" headers="icon2"> |
| <img src="../images/icon_db_drop_to_frame.png" width="18" height="17" alt="Drop to Frame icon"> |
| </td> |
| <td style="text-align:left" valign="top" headers="action"><strong>Drop to Frame </strong></td> |
| <td style="text-align:left" valign="top" headers="description2">Select the Drop to Frame command to re-enter the selected stack frame in the Debug view.</td> |
| </tr> |
| <tr> |
| <td style="text-align:left" valign="top" headers="icon2"> |
| <img src="../images/icon_db_step_mode.png" width="19" height="14" alt="Instruction Stepping Mode icon"> |
| </td> |
| <td style="text-align:left" valign="top" headers="action"><strong>Instruction Stepping Mode </strong></td> |
| <td style="text-align:left" valign="top" headers="description2">Activate to enable instruction stepping mode to examine a program as it steps into disassembled code. </td> |
| </tr> |
| <tr> |
| <td style="text-align:left" valign="top" headers="icon2"> |
| <img src="../images/icon_db_use_step_filters.png" width="18" height="17" alt="Use Step Filters icon"> |
| </td> |
| <td style="text-align:left" valign="top" headers="action"><strong>Use Step Filters </strong></td> |
| <td style="text-align:left" valign="top" headers="description2">Select the Use Step Filters command to change whether step filters should be used in the Debug view.</td> |
| </tr> |
| <tr> |
| <td style="text-align:left" valign="top" headers="icon2"> |
| </td> |
| <td style="text-align:left" valign="top" headers="action"><strong>Menu</strong></td> |
| <td style="text-align:left" valign="top" headers="description2"><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> |
| |
| <h2>Debug view context menu commands </h2> |
| <p>The Debug view context menu commands include:</p> |
| |
| <table border="1" cellpadding="5" cellspacing="0" style="border-collapse: collapse" bordercolor="#DDDDDD" width="600"> |
| <tr> |
| <th style="text-align:center;" id="icon3"><strong>Icons</strong></th> |
| <th style="text-align:center;" id="name"><strong>Name</strong></th> |
| <th style="text-align:center;" id="description3"><strong>Description</strong></th> |
| </tr> |
| <tr> |
| <td style="text-align:left" headers="icon3"> |
| <img src="../images/icon_db_copy_stack.png" width="20" height="19" alt="Copy Stack icon"> |
| </td> |
| <td headers="name"><strong>Copy Stack </strong></td> |
| <td valign="top" headers="description3">Copies the selected stack of suspended threads as well as the state of the running threads to the clipboard. </td> |
| </tr> |
| <tr> |
| <td style="text-align:left" headers="icon3"> |
| </td> |
| <td headers="name"><strong>Find...</strong></td> |
| <td valign="top" headers="description3">Opens the debug view element searching dialog.</td> |
| </tr> |
| <tr> |
| <td style="text-align:left" headers="icon3"> |
| <img src="../images/icon_db_drop_to_frame.png" width="18" height="17" alt="Drop to Frame icon"> |
| </td> |
| <td headers="name"><strong>Drop To Frame </strong></td> |
| <td valign="top" headers="description3">Select the Drop to Frame command to re-enter the selected stack frame in the Debug view.</td> |
| </tr> |
| <tr> |
| <td style="text-align:left" valign="top" headers="icon3"> |
| <img src="../images/icon_db_stepinto.png" width="18" height="14" alt="Step Into icon"> |
| </td> |
| <td style="text-align:left" valign="top" headers="name"><strong>Step Into </strong></td> |
| <td valign="top" headers="description3">Select to execute the current line, including any routines, and proceed to the next statement.</td> |
| </tr> |
| <tr> |
| <td style="text-align:left" valign="top" headers="icon3"> |
| <img src="../images/icon_db_stepover.png" width="19" height="14" alt="Step Over icon"> |
| </td> |
| <td style="text-align:left" valign="top" headers="name"><strong>Step Over </strong></td> |
| <td valign="top" headers="description3">Select to execute the current line, following execution inside a routine.</td> |
| </tr> |
| <tr> |
| <td style="text-align:left" valign="top" headers="icon3"> |
| <img src="../images/icon_db_stepreturn.png" width="17" height="14" alt="Step Return icon"> |
| </td> |
| <td style="text-align:left" valign="top" headers="name"><strong>Step Return </strong></td> |
| <td valign="top" headers="description3">Select to continue execution to the end of the current routine, then follow execution to the routine's caller.</td> |
| </tr> |
| <tr> |
| <td style="text-align:left" valign="top" headers="icon3"> |
| <img src="../images/icon_db_step_mode.png" width="19" height="14" alt="Instruction Stepping Mode icon"> |
| </td> |
| <td style="text-align:left" valign="top" headers="name"><strong>Instruction Stepping Mode </strong></td> |
| <td style="text-align:left" valign="top" headers="description3">Activate to enable instruction stepping mode to examine a program as it steps into disassembled code. </td> |
| </tr> |
| <tr> |
| <td style="text-align:left" valign="top" headers="icon3"> |
| <img src="../images/icon_db_use_step_filters.png" width="18" height="17" alt="Use Step Filters icon"> |
| </td> |
| <td style="text-align:left" valign="top" headers="name"><strong>Use Step Filters </strong></td> |
| <td style="text-align:left" valign="top" headers="description3">Toggles step filters on/off. When on, all step functions apply step filters.</td> |
| </tr> |
| <tr> |
| <td style="text-align:left" headers="icon3"> |
| <img src="../images/icon_resume_signal.png" width="17" height="15" alt="Resume without signal icon"> |
| </td> |
| <td headers="name"><strong>Resume Without Signal </strong></td> |
| <td valign="top" headers="description3">Resume program execution after receiving the signal. </td> |
| </tr> |
| <tr> |
| <td style="text-align:left" valign="top" headers="icon3"> |
| <img src="../images/icon_db_resume.png" width="19" height="14" alt="Resume icon"> |
| </td> |
| <td style="text-align:left" valign="top" headers="name"><strong>Resume</strong></td> |
| <td style="text-align:left" valign="top" headers="description3">Select the Resume command to resume execution of the currently suspended debug target.</td> |
| </tr> |
| <tr> |
| <td style="text-align:left" valign="top" headers="icon3"> |
| <img src="../images/icon_db_suspend.png" width="17" height="17" alt="Suspend icon"> |
| </td> |
| <td style="text-align:left" valign="top" headers="name"><strong>Suspend</strong></td> |
| <td style="text-align:left" valign="top" headers="description3">Select the Suspend command to halt execution of the currently selected thread in a debug target.</td> |
| </tr> |
| <tr> |
| <td style="text-align:left" valign="top" headers="icon3"> |
| <img src="../images/icon_db_terminate.png" width="17" height="15" alt="Terminate icon"> |
| </td> |
| <td style="text-align:left" valign="top" headers="name"><strong>Terminate </strong></td> |
| <td style="text-align:left" valign="top" headers="description3">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 style="text-align:left" headers="icon3"> |
| <img src="../images/icon_db_terminate_relaunch.png" width="19" height="17" alt="Terminate and Relaunch icon"> |
| </td> |
| <td headers="name"><strong>Terminate and Relaunch </strong></td> |
| <td valign="top" headers="description3">Select the Terminate and Relaunch command to terminate the selected debug target and then relaunch it.</td> |
| </tr> |
| <tr> |
| <td style="text-align:left" valign="top" headers="icon3"> |
| <img src="../images/icon_disconnect.gif" width="16" height="16" alt="Disconnect icon"> |
| </td> |
| <td style="text-align:left" valign="top" headers="name"><strong>Disconnect</strong></td> |
| <td style="text-align:left" valign="top" headers="description3">Detaches the debugger from the selected process (useful for |
| debugging attached processes)</td> |
| </tr> |
| <tr> |
| <td style="text-align:left" valign="top" headers="icon3"> |
| <img src="../images/icon_db_terminate_all.png" width="21" height="20" alt="Remote all Terminated icon"> |
| </td> |
| <td style="text-align:left" valign="top" headers="name"><strong>Remove All Terminated </strong></td> |
| <td style="text-align:left" valign="top" headers="description3">Clears all terminated processes in Debug view</td> |
| </tr> |
| <tr> |
| <td style="text-align:left" headers="icon3"> |
| <img src="../images/icon_db_terminate_remove.png" width="19" height="17" alt="Terminate and Remove icon"> |
| </td> |
| <td headers="name"><strong>Terminate and Remove </strong></td> |
| <td valign="top" headers="description3">Terminates the selected debug target and removes it from the view. </td> |
| </tr> |
| <tr> |
| <td style="text-align:left" headers="icon3"> |
| <img src="../images/icon_db_terminate_all2.png" width="19" height="18" alt="Terminate all icon"> |
| </td> |
| <td headers="name"><strong>Terminate/Disconnect All </strong></td> |
| <td valign="top" headers="description3">Terminates or disconnects all active launches in the view. </td> |
| </tr> |
| <tr> |
| <td style="text-align:left" headers="icon3"> |
| </td> |
| <td headers="name"><strong>Properties</strong></td> |
| <td valign="top" headers="description3">Opens the <strong>Properties for</strong> window showing the process properties. </td> |
| </tr> |
| </table> |
| |
| <p><img 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 src="../images/ngtasks.gif" ALT="Related tasks" width="143" height="21"> |
| <br> |
| <a href="../tasks/cdt_o_debug.htm">Debugging</a></p> |
| <p><img 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><br> |
| <a href="cdt_u_dbg_breadcrumb.htm">Debug Breadcrumb</a><br> |
| <a href="../reference/cdt_o_views.htm">C/C++ Views</a></p> |
| |
| <hr > |
| <img src="../images/nokiaCopyright.png" alt="Nokia Copyright Statement"><br> |
| <img src="../images/ng00_04a.gif" ALT="IBM Copyright Statement" > |
| |
| </div></body> |
| |
| </html> |
