<!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>Executables view</title>
<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
</head>
<body >
<h2>Executables view </h2>
<p>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.debug.ui.executablesView)")' class="command-link"><b>Executables</b></a> view provides a dynamic list of executables and their related source files. The Executables view makes it easy to:</p>
<ul>
  <li>target all binaries for debugging because the symbolics are automatically loaded when a bld.inf is imported or a project is created from a template</li>
  <li>debug a binary that is not part of a project in the workspace by importing it into the Executables view to load the symbolics</li>
  <li> debug a process running on a device by <a href="../../tasks/processes/attach_to_process.htm">attaching</a> to the process and importing the binaries associated with the process into the Executables view to load the symbolics. For example, you to debug a library loaded by the process, you would need to import the libary and the process executable. </li>
  <li>remove binaries when a project is closed or deleted from the workspace</li>
  <li>remove  binaries  imported from outside the workspace by clicking the <b>Remove the selected executables</b> icon (<img src="../../reference/images/icon_delete_launch_config.png" width="17" height="16" align="absmiddle">) or deleting the binary from the Executables project in the <a href="view_proj_explorer.htm">Project Explorer</a> view </li>
  <li>locate and manage which source and resource files are associated with each executable. Paths shown in black text have been resolved, those in gray text cannot be found. </li>
  <li>identify and correct any path issues with missing source files (shown in gray text). Double-click the missing source file to open a <b>Locate File</b> editor view which enables you to find the missing file. </li>
  <li>view routines and header files used by the source file. Click the tree control to expand or collapse a list of included header files and routine names for fast navigation. </li>
  <li>find and set breakpoints, watchpoints, and eventpoints in source files. Double-click a source file to open it in an editor view and to review the status of its breakpoints. </li>
</ul>
<p>In addition, an <b>Executables</b> project is created in the <a href="view_proj_explorer.htm">Project Explorer</a> view. The binaries shown in the Executables project can be deleted which also removes them from the Executables view. For binaries outside the workspace you must import them into the Executables view so their symbolics can be used during the debug session. <span class="note">You can also drag and drop executables into the view. </span></p>
<p class="note"><b>NOTE</b> To debug ROM DLLs with Symbian Device or in stop mode, always specify the <a href="../launch/page_rom_log.htm">ROM Log file</a> in the project's launch configuration. </p>
<p align="center"><img src="../../reference/images/view_executables.png" width="813" height="309" /></p>
<p class="figure">Figure 1 - Executables view</p>
<p align="left">The <strong>Executables</strong> view consists of the <strong>Executable Name</strong> and <strong>Source File Name</strong> panes describled in the table below. Use the <strong>Columns</strong> button in the toolbar to show or hide specific columns in each pane. Columns can be sorted and rearranged in the order desired. </p>
<h5>Table 1. Executables view  information </h5>
<table width="88%"  border="0" cellpadding="2" cellspacing="0">
  <tr>
    <th width="17%" scope="col">Pane</th>
    <th width="83%" scope="col">Explanation</th>
  </tr>
  <tr>
    <td><b>Executable Name </b></td>
    <td><p>Displays a list of  executables in the workspace as well as other files added by the user. Select an executable to update the Source File Name pane with related files. The executable information shown  can include: </p>
      <ul>
        <li><b>Executable Name</b> - (default) Name of the exectable file.</li>
        <li><b>Executable Project</b> - (default) The project  associated with the executable.</li>
        <li><b>Executable Location</b> - (default) The current location of the executable.</li>
        <li><b>Executable Size</b> - The executable size shown in bytes.</li>
        <li><b>Executable Date</b> - The source file&prime;s modification date.</li>
        <li><b>Executable Type</b> - The executable type (.exe, etc.) </li>
      </ul>
      <p>Click the Columns icon (<img src="../../images/icons/btn_columns.png" width="14" height="14" align="absmiddle" />) to set which columns to show in this pane.</p></td>
  </tr>
  <tr>
    <td><b>Source File Name </b></td>
    <td><p>Displays a list of  source files for the selected executable as extracted from the symbol table. The source file information shown can include: </p>
      <ul>
        <li><b>Source File Name</b> - (default) Name of the source file used by the executable. If no binary files are in the project the message <b>No source files found in &lt;project_name&gt;</b> is shown. </li>
        <li><b>Source File Location</b> - (default) The current location of the source file. If the path is shown in gray text the source file was not located. To locate it, double-click to open a new editor, then click Locate File... to locate the missing file. The new path is compared to the old one and all files located in the same directory are automatically updated to use the new path.</li>
        <li><b>Source File Original Location </b> - (default) The original location of the source file which may be different than the current location. </li>
        <li><b>Source File Size</b> - The executable size shown in bytes.</li>
        <li><b>Source File </b><b>Date </b>- The source file&prime;s modification date.</li>
        <li><b>Source File Type</b> - The source type (.h, .inc, etc.) </li>
      </ul>
      <p>Expand a file&prime;s tree control to view the functions and header files used by the file. Double-click to open the source file for editing or to set breakpoints. </p>
      <p>Click the Columns icon (<img src="../../images/icons/btn_columns.png" width="14" height="14" align="absmiddle" />) to set which columns to show in this pane.</p></td>
  </tr>
</table>
<h4>Executables view toolbar icons</h4>
<p>The table below lists the unique icons displayed in the <strong>Executables</strong> view toolbar. </p>
<h5>Table 2. Executables view toolbar options </h5>
<table width="88%"  border="0" cellpadding="2" cellspacing="0">
  <tr>
      <th width="16%" scope="col">Command</th>
      <th width="32%" scope="col">Name</th>
      <th width="52%" scope="col">Description</th>
  </tr>
    <tr>
      <td><div align="center"><img src="../../images/icons/btn_restart.png" width="20" height="18" /></div></td>
      <td><div align="left">Refresh the list of executables</div></td>
      <td>Click to refresh the executables list. </td>
    </tr>
    <tr>
      <td><div align="center"><img src="../../images/icons/btn_import_executables.png" width="18" height="15" /></div></td>
      <td>Import an executable file </td>
      <td>Click to select and import an executable not in the workspace into the executables list. </td>
    </tr>
    <tr>
      <td><center>
        <img src="../../reference/images/icon_delete_launch_config.png" width="17" height="16">
      </center>
      </td>
      <td>Remove the selected executables</td>
      <td>Click to remove one or more selected executables from the executables list. You will see a alert if the executable cannot be removed.</td>
    </tr>
    <tr>
      <td><div align="center"><img src="../../images/icons/btn_columns.png" width="14" height="14" /></div></td>
      <td>Columns</td>
      <td>Opens the  <b>Configure Columns</b> dialog for configuring which columns  appear in the Executable and Source File panes. </td>
    </tr>
</table>
<h5>Other references</h5>
<ul>
  <li><a href="../../debugger/views/perspective_debug.htm">Debug perspective </a></li>
  <li><a href="../../concepts/autotargeting.htm">Auto-Targeting of Executables</a></li>
  <li><a href="../../tasks/processes/attach_to_process.htm">Attaching to a Process</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>
