Disassembly Window

# HG changeset patch # User fturovic # Date 1286555601 18000 # Node ID af9d211660cbd37ec277d935104cca7977c63eac # Parent 1458a474103cf7480e1d90a6a379b0ce876dd984 BUG 12320 - updated disassembly view page to match current implementation diff -r 1458a474103c -r af9d211660cb core/com.nokia.carbide.cpp.doc.user/html/debugger/images/icon_home.png Binary file core/com.nokia.carbide.cpp.doc.user/html/debugger/images/icon_home.png has changed diff -r 1458a474103c -r af9d211660cb core/com.nokia.carbide.cpp.doc.user/html/debugger/images/icon_refresh.png Binary file core/com.nokia.carbide.cpp.doc.user/html/debugger/images/icon_refresh.png has changed diff -r 1458a474103c -r af9d211660cb core/com.nokia.carbide.cpp.doc.user/html/debugger/images/menu_disassembly.png Binary file core/com.nokia.carbide.cpp.doc.user/html/debugger/images/menu_disassembly.png has changed diff -r 1458a474103c -r af9d211660cb core/com.nokia.carbide.cpp.doc.user/html/debugger/images/pref_disassembly.png Binary file core/com.nokia.carbide.cpp.doc.user/html/debugger/images/pref_disassembly.png has changed diff -r 1458a474103c -r af9d211660cb core/com.nokia.carbide.cpp.doc.user/html/debugger/images/view_disassembly.png Binary file core/com.nokia.carbide.cpp.doc.user/html/debugger/images/view_disassembly.png has changed diff -r 1458a474103c -r af9d211660cb core/com.nokia.carbide.cpp.doc.user/html/debugger/views/view_disassembly.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/debugger/views/view_disassembly.htm Thu Oct 07 15:31:31 2010 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/debugger/views/view_disassembly.htm Fri Oct 08 11:33:21 2010 -0500 @@ -5,7 +5,7 @@ -Disassembly Window +Disassembly view -

Disassembly View

When debugging your application, the Disassembly view shows the loaded program as assembler instructions. When you use the Disassembly view, you can do the following tasks:

Disassembly view

When debugging your application, the Disassembly view shows the loaded program as assembler instructions. When using the Disassembly view, you can do the following:

Step through the disassembly instructions of your program using the Instruction Stepping Mode () icon in the Debug view (Figure 1).
Reposition the PC using the various move commands (Figure 1) by first selecting the line to move to, then select the command from the context menu.
Set breakpoints at the start of any assembler instruction by right-clicking the left hand column to view the context menu options (Figure 2)
Set breakpoints at the start of any assembler instruction by right-clicking the left hand column to view the context menu options

Figure 1 shows the Dissassembly view stopped at a breakpoint.

Disassembly view

Figure 1 - Disassembly view

To open the Disassembly view

Opening the Disassembly view

Click the Window > Show View > Disassembly menu option

A Disassembly view appears.

Select Window > Show View > Disassembly menu option

+
OR
+

Click the Instruction Stepping Mode () icon in the Debug view +
A Disassembly view appears in the current perspective.
+

Disassembly view toolbar options

The following toolbar options are available in the Disassembly view:

Table 1. Disassembly view toolbar options

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Item	Icon	Explanation
Enter location here		Enter the memory address to show in the disassembler view.
Refresh View		Click to refresh the current disassembly view.
Goto Current Program Counter (Home)		Click to move to the current program counter location.
Show Source		Click to open the source file associated with the selected disassembly view.
View Menu		Displays a dropdown list with the following options: + + Find in current document + Go to Program Counter + Go to Memory Address... + Show Source +

Disassembly view context menu options

Figure 2 shows the context menu that appears when you right-click in the Dissassembly pane. Right-clicking the left border opens the breakpoint context menu in Figure 3.

Disassembly context menu

Figure 2 - Disassembly pane context menu

Table 1. Disassembly pane — context menu

Table 2. Disassembly pane — context menu

- + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Item	Icon	Explanation
Copy	Click to copy the selected contents in the Disassembly view to the clipboard.
Select All	Click to select the contents of the Disassembly view.
Show Source	Click to open the source file associated with the selected disassembly line.
Show Symbols	Click to toggle the display of symbols in the Disassembly view.
Preferences...	Opens the Disassembly preference panel. +
Run to Line	- -	Select Run to Line to execute the program from the currently executed line (the green line) to the selected line (the blue line).
Move to Line	- -	Select Move to Line to move the program counter to the selected line (the blue line) skipping all intermediate lines but not resume execution. This enables you to skip suspect code and continue stepping through your program. WARNING Using this command can leave a program in an unstable state. Use at your own risk.
Resume at Line	- -	Select Resume at Line to begin program execution at the selected line (the blue line), skipping all lines between it and the currently executed line (the green line). WARNING Using this command can leave a program in an unstable state. Use at your own risk.
ABLD		Use the ABLD menu option to invoke an specific abld command on the selected project or file.
Freeze Exports	- - -	Calls the appropriate abld command to generate a .def file.
Build All Configurations	- - -	Click Build All Configurations to build all enabled build configurations in the current project.
Toggle Breakpoint	-	Right-click in left-hand column of the Disassembly view and select this option to toggle the breakpoint state between setting and removing the breakpoint.
Disable/Enable Breakpoint	-	Right-click in left-hand column of the Disassembly view and select the breakpoint option shown as determined by the current state of the breakpoint.
Breakpoint Properties	-	Select this option to open the Breakpoint Properties dialog.