<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
<script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js"></script>
<title>Disassembly view</title>
<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
<style type="text/css">
<!--
.style1 {
	color: #FF0000;
	font-weight: bold;
}
-->
</style>
</head>
<body >
<h2>Disassembly view</h2>
<p>When debugging your application, the <img src="../../images/command_link.png" border="0" alt="" /> <a href='javascript:executeCommand("org.eclipse.ui.views.showView(org.eclipse.ui.views.showView.viewId=org.eclipse.cdt.dsf.debug.ui.disassembly.view)")' class="command-link"><b>Disassembly</b></a> view shows the loaded program as assembler instructions. When using the Disassembly view, you can do the following:</p>
<ul>
  <li>Step through the disassembly instructions of your program using the <b>Instruction Stepping Mode</b> (<img src="../../reference/images/icon_instr_stepping_mode.png" width="18" height="16" align="absmiddle">) icon in the <a href="../debug/viewing_debug.htm">Debug</a> view (Figure 1). </li>
  <li>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.</li>
  <li>Set breakpoints at the start of any assembler instruction by right-clicking the left hand column to view the context menu options </li>
</ul>
<p>Figure 1 shows the <b>Dissassembly</b> view stopped at a breakpoint.</p>
<p align="center"><img src="../images/view_disassembly.png" alt="Disassembly view" width="500" height="237"></p>
<p class="figure">Figure 1 - Disassembly view</p>
<div class="step">
    <h4>Opening the Disassembly view </h4>
    <ul>
        <li>Select Window &gt; Show View &gt; Disassembly menu option</li>
    </ul>
    <blockquote>
        <p>OR</p>
    </blockquote>
    <ul>
        <li>Click the Instruction Stepping Mode (<img src="../../reference/images/icon_instr_stepping_mode.png" alt="" width="18" height="16" align="absmiddle">) icon in the <a href="../debug/viewing_debug.htm">Debug</a> view
            <p>A <b>Disassembly</b> view appears in the current perspective.</p>
        </li>
    </ul>
</div>
<h2>Disassembly view toolbar options</h2>
<p>The following toolbar options are available in the <b>Disassembly</b> view:</p>
<h5>Table 1. Disassembly view toolbar options</h5>
<table width="88%"  border="0" cellpadding="2" cellspacing="0">
    <tr>
        <th width="30%" scope="col">Item</th>
        <th width="9%" scope="col">Icon</th>
        <th width="61%" scope="col">Explanation</th>
    </tr>
    <tr>
        <td><b>Enter location here</b></td>
        <td>&nbsp;</td>
        <td>Enter the memory address to show in the disassembler view.</td>
    </tr>
    <tr>
        <td><b>Refresh View</b></td>
        <td>            <div align="center"><img src="../images/icon_refresh.png" alt="Refresh icon" width="17" height="16"></div></td>
        <td>Click to refresh the current disassembly view.</td>
    </tr>
    <tr>
        <td><b>Goto Current Program Counter (Home)</b></td>
        <td><div align="center"><img src="../images/icon_home.png" alt="Home icon" width="17" height="18"></div></td>
        <td>Click to move to the current program counter location.</td>
    </tr>
    <tr>
        <td><b>Show Source</b></td>
        <td><div align="center"></div></td>
        <td>Click to open the source file associated with the selected disassembly view.</td>
    </tr>
    <tr>
        <td><b>View Menu</b></td>
        <td><div align="center"><img src="../images/icon_menu_white.png" alt="View Menu icon" width="12" height="12"></div></td>
        <td><p>Displays a dropdown list with the following options:</p>
            <ul>
                <li>Find in current document</li>
                <li>Go to  Program Counter</li>
                <li>Go to Memory Address...</li>
                <li>Show Source</li>
        </ul></td>
    </tr>
</table>
<h2>Disassembly view context menu options</h2>
<p>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.</p>
<p class="figure"><img src="../images/menu_disassembly.png" alt="Disassembly context menu" width="207" height="197"></p>
<p class="figure">Figure 2 - Disassembly pane context menu</p>
<h5>Table 2. Disassembly pane &mdash; context menu</h5>
<table width="88%"  border="0" cellpadding="2" cellspacing="0">
  <tr>
    <th width="26%" scope="col">Item</th>
    <th width="66%" scope="col">Explanation</th>
  </tr>
  <tr>
      <td><b>Copy </b></td>
      <td>Click to copy the selected contents in the Disassembly view to the clipboard.</td>
  </tr>
  <tr>
      <td><b>Select All</b></td>
      <td>Click to select the contents of the Disassembly view.</td>
  </tr>
  <tr>
      <td><b>Show Source</b></td>
      <td>Click to open the source file associated with the selected disassembly line.</td>
  </tr>
  <tr>
      <td><b>Show Symbols</b></td>
      <td>Click to toggle the display of symbols in the Disassembly view.</td>
  </tr>
  <tr>
      <td><b>Preferences...</b></td>
      <td><p>Opens the <b>Disassembly</b> preference panel.</p>
        <p><img src="../images/pref_disassembly.png" alt="Disassembly preference panel" width="635" height="241"></p></td>
  </tr>
  <tr>
    <td><b>Run to Line </b></td>
    <td>Select <b>Run to Line</b> to execute the program from the currently executed line (the green line) to the selected line (the blue line).</td>
  </tr>
  <tr>
    <td><b>Move to Line</b></td>
    <td><p>Select <b>Move to Line</b> 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.</p>
        <p class="note"><span class="style1">WARNING</span> Using this command can leave a program in an unstable state. Use at your own risk.</p></td>
  </tr>
  <tr>
    <td><b>Resume at Line </b></td>
    <td><p>Select <b>Resume at Line</b> to begin program execution at the selected line   (the blue line), skipping all lines between it and the currently executed line  (the green line). </p>
        <p class="note"><span class="style1">WARNING</span> Using this command can leave a program in an unstable state. Use at your own risk.</p></td>
  </tr>
</table>
<h5>Related reference</h5>
<ul><li><a href="../../concepts/breakpoints.htm">Breakpoints</a></li>
  <li><a href="../debug/cmds_reposition_pc.htm">Repositioning the Program Counter</a></li>
</ul>
<div id="footer">Copyright &copy; 2010 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
</body>
</html>
