core/com.nokia.carbide.cpp.doc.user/html/projects/views/view_executables.htm
author fturovic <frank.turovich@nokia.com>
Wed, 06 Oct 2010 15:57:37 -0500
changeset 2137 0a2167a80b64
parent 2136 f0b706fa897d
permissions -rw-r--r--
minor edits on view pages to make them more similar
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
2131
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
     1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
     2
<html>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
     3
<head>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
     4
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
     5
<meta http-equiv="Content-Style-Type" content="text/css" />
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
     6
<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
2137
0a2167a80b64 minor edits on view pages to make them more similar
fturovic <frank.turovich@nokia.com>
parents: 2136
diff changeset
     7
<script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js"></script>
2131
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
     8
<title>Executables view</title>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
     9
<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    10
</head>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    11
<body >
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    12
<h2>Executables view </h2>
2137
0a2167a80b64 minor edits on view pages to make them more similar
fturovic <frank.turovich@nokia.com>
parents: 2136
diff changeset
    13
<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>
2131
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    14
<ul>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    15
  <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>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    16
  <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>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    17
  <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>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    18
  <li>remove binaries when a project is closed or deleted from the workspace</li>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    19
  <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>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    20
  <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>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    21
  <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>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    22
  <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>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    23
  <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>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    24
</ul>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    25
<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>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    26
<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>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    27
<p align="center"><img src="../../reference/images/view_executables.png" width="813" height="309" /></p>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    28
<p class="figure">Figure 1 - Executables view</p>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    29
<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>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    30
<h5>Table 1. Executables view  information </h5>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    31
<table width="88%"  border="0" cellpadding="2" cellspacing="0">
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    32
  <tr>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    33
    <th width="17%" scope="col">Pane</th>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    34
    <th width="83%" scope="col">Explanation</th>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    35
  </tr>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    36
  <tr>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    37
    <td><b>Executable Name </b></td>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    38
    <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>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    39
      <ul>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    40
        <li><b>Executable Name</b> - (default) Name of the exectable file.</li>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    41
        <li><b>Executable Project</b> - (default) The project  associated with the executable.</li>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    42
        <li><b>Executable Location</b> - (default) The current location of the executable.</li>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    43
        <li><b>Executable Size</b> - The executable size shown in bytes.</li>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    44
        <li><b>Executable Date</b> - The source file&prime;s modification date.</li>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    45
        <li><b>Executable Type</b> - The executable type (.exe, etc.) </li>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    46
      </ul>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    47
      <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>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    48
  </tr>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    49
  <tr>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    50
    <td><b>Source File Name </b></td>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    51
    <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>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    52
      <ul>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    53
        <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>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    54
        <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>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    55
        <li><b>Source File Original Location </b> - (default) The original location of the source file which may be different than the current location. </li>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    56
        <li><b>Source File Size</b> - The executable size shown in bytes.</li>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    57
        <li><b>Source File </b><b>Date </b>- The source file&prime;s modification date.</li>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    58
        <li><b>Source File Type</b> - The source type (.h, .inc, etc.) </li>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    59
      </ul>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    60
      <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>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    61
      <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>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    62
  </tr>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    63
</table>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    64
<h4>Executables view toolbar icons</h4>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    65
<p>The table below lists the unique icons displayed in the <strong>Executables</strong> view toolbar. </p>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    66
<h5>Table 2. Executables view toolbar options </h5>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    67
<table width="88%"  border="0" cellpadding="2" cellspacing="0">
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    68
  <tr>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    69
      <th width="16%" scope="col">Command</th>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    70
      <th width="32%" scope="col">Name</th>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    71
      <th width="52%" scope="col">Description</th>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    72
  </tr>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    73
    <tr>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    74
      <td><div align="center"><img src="../../images/icons/btn_restart.png" width="20" height="18" /></div></td>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    75
      <td><div align="left">Refresh the list of executables</div></td>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    76
      <td>Click to refresh the executables list. </td>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    77
    </tr>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    78
    <tr>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    79
      <td><div align="center"><img src="../../images/icons/btn_import_executables.png" width="18" height="15" /></div></td>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    80
      <td>Import an executable file </td>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    81
      <td>Click to select and import an executable not in the workspace into the executables list. </td>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    82
    </tr>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    83
    <tr>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    84
      <td><center>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    85
        <img src="../../reference/images/icon_delete_launch_config.png" width="17" height="16">
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    86
      </center>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    87
      </td>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    88
      <td>Remove the selected executables</td>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    89
      <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>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    90
    </tr>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    91
    <tr>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    92
      <td><div align="center"><img src="../../images/icons/btn_columns.png" width="14" height="14" /></div></td>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    93
      <td>Columns</td>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    94
      <td>Opens the  <b>Configure Columns</b> dialog for configuring which columns  appear in the Executable and Source File panes. </td>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    95
    </tr>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    96
</table>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    97
<h5>Other references</h5>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    98
<ul>
2136
f0b706fa897d all instances of PLUGINS_ROOT preceded by any path had the path removed (incorrect syntax)
fturovic <frank.turovich@nokia.com>
parents: 2131
diff changeset
    99
  <li><a href="../../debugger/views/perspective_debug.htm">Debug perspective </a></li>
2131
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
   100
  <li><a href="../../concepts/autotargeting.htm">Auto-Targeting of Executables</a></li>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
   101
  <li><a href="../../tasks/processes/attach_to_process.htm">Attaching to a Process</a></li>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
   102
</ul>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
   103
<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>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
   104
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
   105
</body>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
   106
</html>