diff --git a/doc/org.eclipse.cdt.doc.user/images/icon_db_copy_stack.png b/doc/org.eclipse.cdt.doc.user/images/icon_db_copy_stack.png new file mode 100644 index 00000000000..4c018d1ed10 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/images/icon_db_copy_stack.png differ diff --git a/doc/org.eclipse.cdt.doc.user/images/icon_db_debug.png b/doc/org.eclipse.cdt.doc.user/images/icon_db_debug.png new file mode 100644 index 00000000000..2637d2a1976 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/images/icon_db_debug.png differ diff --git a/doc/org.eclipse.cdt.doc.user/images/icon_db_disconnect.png b/doc/org.eclipse.cdt.doc.user/images/icon_db_disconnect.png new file mode 100644 index 00000000000..7730ac838d6 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/images/icon_db_disconnect.png differ diff --git a/doc/org.eclipse.cdt.doc.user/images/icon_db_drop_to_frame.png b/doc/org.eclipse.cdt.doc.user/images/icon_db_drop_to_frame.png new file mode 100644 index 00000000000..d5c9d707fda Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/images/icon_db_drop_to_frame.png differ diff --git a/doc/org.eclipse.cdt.doc.user/images/icon_db_edit_src_lookup.png b/doc/org.eclipse.cdt.doc.user/images/icon_db_edit_src_lookup.png new file mode 100644 index 00000000000..648406e7b95 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/images/icon_db_edit_src_lookup.png differ diff --git a/doc/org.eclipse.cdt.doc.user/images/icon_db_launch_instance.png b/doc/org.eclipse.cdt.doc.user/images/icon_db_launch_instance.png new file mode 100644 index 00000000000..1c3b22f55eb Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/images/icon_db_launch_instance.png differ diff --git a/doc/org.eclipse.cdt.doc.user/images/icon_db_relaunch.png b/doc/org.eclipse.cdt.doc.user/images/icon_db_relaunch.png new file mode 100644 index 00000000000..61bbf2425f4 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/images/icon_db_relaunch.png differ diff --git a/doc/org.eclipse.cdt.doc.user/images/icon_db_restart.png b/doc/org.eclipse.cdt.doc.user/images/icon_db_restart.png new file mode 100644 index 00000000000..6af462ebb80 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/images/icon_db_restart.png differ diff --git a/doc/org.eclipse.cdt.doc.user/images/icon_db_resume.png b/doc/org.eclipse.cdt.doc.user/images/icon_db_resume.png new file mode 100644 index 00000000000..2b2372eba58 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/images/icon_db_resume.png differ diff --git a/doc/org.eclipse.cdt.doc.user/images/icon_db_stack_frame.png b/doc/org.eclipse.cdt.doc.user/images/icon_db_stack_frame.png new file mode 100644 index 00000000000..e5ffd063e9e Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/images/icon_db_stack_frame.png differ diff --git a/doc/org.eclipse.cdt.doc.user/images/icon_db_step_mode.png b/doc/org.eclipse.cdt.doc.user/images/icon_db_step_mode.png new file mode 100644 index 00000000000..23104c5795b Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/images/icon_db_step_mode.png differ diff --git a/doc/org.eclipse.cdt.doc.user/images/icon_db_stepinto.png b/doc/org.eclipse.cdt.doc.user/images/icon_db_stepinto.png new file mode 100644 index 00000000000..839bd1f2ee9 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/images/icon_db_stepinto.png differ diff --git a/doc/org.eclipse.cdt.doc.user/images/icon_db_stepover.png b/doc/org.eclipse.cdt.doc.user/images/icon_db_stepover.png new file mode 100644 index 00000000000..4498b2f4d1d Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/images/icon_db_stepover.png differ diff --git a/doc/org.eclipse.cdt.doc.user/images/icon_db_stepreturn.png b/doc/org.eclipse.cdt.doc.user/images/icon_db_stepreturn.png new file mode 100644 index 00000000000..ae4e0428fda Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/images/icon_db_stepreturn.png differ diff --git a/doc/org.eclipse.cdt.doc.user/images/icon_db_suspend.png b/doc/org.eclipse.cdt.doc.user/images/icon_db_suspend.png new file mode 100644 index 00000000000..882c8c4a44f Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/images/icon_db_suspend.png differ diff --git a/doc/org.eclipse.cdt.doc.user/images/icon_db_terminate.png b/doc/org.eclipse.cdt.doc.user/images/icon_db_terminate.png new file mode 100644 index 00000000000..4679b93757a Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/images/icon_db_terminate.png differ diff --git a/doc/org.eclipse.cdt.doc.user/images/icon_db_terminate_all.png b/doc/org.eclipse.cdt.doc.user/images/icon_db_terminate_all.png new file mode 100644 index 00000000000..ae8f92c79b8 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/images/icon_db_terminate_all.png differ diff --git a/doc/org.eclipse.cdt.doc.user/images/icon_db_terminate_all2.png b/doc/org.eclipse.cdt.doc.user/images/icon_db_terminate_all2.png new file mode 100644 index 00000000000..b10ae9d3ca5 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/images/icon_db_terminate_all2.png differ diff --git a/doc/org.eclipse.cdt.doc.user/images/icon_db_terminate_relaunch.png b/doc/org.eclipse.cdt.doc.user/images/icon_db_terminate_relaunch.png new file mode 100644 index 00000000000..88712aa9e72 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/images/icon_db_terminate_relaunch.png differ diff --git a/doc/org.eclipse.cdt.doc.user/images/icon_db_terminate_remove.png b/doc/org.eclipse.cdt.doc.user/images/icon_db_terminate_remove.png new file mode 100644 index 00000000000..592ae953956 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/images/icon_db_terminate_remove.png differ diff --git a/doc/org.eclipse.cdt.doc.user/images/icon_db_use_step_filters.png b/doc/org.eclipse.cdt.doc.user/images/icon_db_use_step_filters.png new file mode 100644 index 00000000000..7940cd9a65b Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/images/icon_db_use_step_filters.png differ diff --git a/doc/org.eclipse.cdt.doc.user/images/view_debug.png b/doc/org.eclipse.cdt.doc.user/images/view_debug.png new file mode 100644 index 00000000000..e5774869f08 Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/images/view_debug.png differ diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_dbg_view.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_dbg_view.htm index 667458ec3c7..2e4e2972a6e 100644 --- a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_dbg_view.htm +++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_dbg_view.htm @@ -14,97 +14,333 @@

Debug view

-

The Debug view shows the target information in a tree hierarchy shown -below with a sample of the possible icons:

- - - - - - - - - - - - - - - - - - - - - - - - - - -
Session item Description Icons
Launch instance Launch configuration name and launch type Icon: Debug executable - Icon: Run executable
Debugger instance Debugger name and stateIcon: Debugger
Thread instance Thread number and stateIcon: Thread; suspended - Icon: Thread; running - Icon: Thread; stopped
Stack frame instance Stack frame number, function, file name, and file line number Icon: Stackframe - Icon: Stack frame; running
+

The Debug view shows the target debugging information in a tree hierarchy.

+

Debug view

The number beside the thread label is a reference counter, not a thread identification number (TID).

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.

- + 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.

+

The icons that appear in the Debug view include:

+ + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Icons +
Session item Description
+ +
Launch instance Launch configuration name and launch type
+ Icon: Debugger +   +
Debugger instance Debugger name and state
+ Icon: Thread; suspended  Icon: Thread; running  Icon: Thread; stopped +
Thread instance Thread number and state
+ +
Stack frame instance Stack frame number, function, file name, and file line number

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.

- +
+ - - - - + + + - - - + + + - - - + + + - - - + + + - - - + + + - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Icons +
ActionIcon Description
Terminate - 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.
+ +
Remove All Terminated Launches Clears all terminated processes in Debug view
Disconnect - Detaches the debugger from the selected process (useful for -debugging attached processes)
+ +
RestartStarts a new debug session for the selected process
Remove All Terminated - Clears all terminated processes in Debug view
+ +
ResumeSelect the Resume command to resume execution of the currently suspended debug target.
Terminate and Remove - Ends the selected debug session and removes it from Debug - view
+ +
SuspendSelect the Suspend command to halt execution of the currently selected thread in a debug target.
Relaunch - Starts a new debug session for the selected process
+ +
Terminate 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.
Terminate All - Ends all active debug sessions in Debug view
+ +
DisconnectDetaches the debugger from the selected process (useful for +debugging attached processes).
+ +
Step Into Select to execute the current line, including any routines, and proceed to the next statement.
+ +
Step Over Select to execute the current line, following execution inside a routine.
+ +
Step Return Select to continue execution to the end of the current routine, then follow execution to the routine’s caller.
+ +
Drop to Frame Select the Drop to Frame command to re-enter the selected stack frame in the Debug view.
+ +
Instruction Stepping Mode Activate to enable instruction stepping mode to examine a program as it steps into disassembled code.
+ +
Use Step Filters Select the Use Step Filters command to change whether step filters should be used in the Debug view.
+
Menu

Use the Debug view menu to:

+
    +
  • alternate showing of full or no paths on source files
  • +
  • control how views are managed
  • +
  • activate or deactivate the child elements shown in the Debug view
  • +
+

Debug view context menu commands

+
+

The Debug view context menu commands include:

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
IconsNameDescription
+ +
Copy Stack Copies the selected stack of suspended threads as well as the state of the running threads to the clipboard.
+
Find...Opens the debug view element searching dialog.
+ +
Drop To Frame Select the Drop to Frame command to re-enter the selected stack frame in the Debug view.
+ +
RestartStarts a new debug session for the selected process
+ +
Step Into Select to execute the current line, including any routines, and proceed to the next statement.
+ +
Step Over Select to execute the current line, following execution inside a routine.
+ +
Step Return Select to continue execution to the end of the current routine, then follow execution to the routine’s caller.
+ +
Instruction Stepping Mode Activate to enable instruction stepping mode to examine a program as it steps into disassembled code.
+ +
Use Step Filters Toggles step filters on/off. When on, all step functions apply step filters.
+ +
Resume Without Signal Resume program execution after receiving the signal.
+ +
ResumeSelect the Resume command to resume execution of the currently suspended debug target.
+ +
SuspendSelect the Suspend command to halt execution of the currently selected thread in a debug target.
+ +
Terminate 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.
+ +
Terminate and Relaunch Select the Terminate and Relaunch command to terminate the selected debug target and then relaunch it.
+ +
DisconnectDetaches the debugger from the selected process (useful for + debugging attached processes)
+ +
Remove All Terminated Clears all terminated processes in Debug view
+ +
RelaunchThis command relaunches the selected debug target.
+
Edit...Opens the launch configuration dialog, allowing you to make changes.
+ +
Edit Source Lookup... Opens the source lookup dialog, allowing you to make changes.
+
Lookup Source Select to force a source lookup to take place.
+ +
Terminate and Remove Terminates the selected debug target and removes it from the view.
+ +
Terminate All Terminates all active launches in the view.
+
PropertiesOpens the Properties for window showing the process properties.
+

Related concepts
Debug overview
@@ -116,6 +352,7 @@ debugging attached processes)
Run and Debug dialog box

+Nokia Copyright Statement
IBM Copyright Statement diff --git a/doc/org.eclipse.cdt.doc.user/topics_Reference.xml b/doc/org.eclipse.cdt.doc.user/topics_Reference.xml index 400b2efb588..3fbb745e7dd 100644 --- a/doc/org.eclipse.cdt.doc.user/topics_Reference.xml +++ b/doc/org.eclipse.cdt.doc.user/topics_Reference.xml @@ -18,7 +18,7 @@ - +