mirror of
https://github.com/eclipse-cdt/cdt
synced 2025-04-22 14:12:10 +02:00
6acb6dbc70
- add org.eclipse.cdt.debug.application plugin which supports running CDT debugger as Eclipse application - add org.eclipse.cdt.debug.application.docs plugin which is the modified CDT docs - add org.eclipse.cdt.debug.standalone-feature which bundles the two aforementioned plugins - add org.eclipse.cdt.debug.standlone.source-feature Change-Id: I1a1ae855ab3912e678b7d9e3465e2fbbfe949e13 Reviewed-on: https://git.eclipse.org/r/25845 Reviewed-by: Jeff Johnston <jjohnstn@redhat.com> Tested-by: Jeff Johnston <jjohnstn@redhat.com>
338 lines
No EOL
19 KiB
HTML
338 lines
No EOL
19 KiB
HTML
<!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> |