Mercurial Mercurial > oss > FCL > sftools > dev > ide > carbidecpp / annotate
summary | shortlog | changelog | graph | tags | bookmarks | branches | files | changeset | file | latest | revisions | annotate | diff | comparison | raw | help
Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
core/com.nokia.carbide.cpp.doc.user/html/projects/views/view_executables.htm
author fturovic <frank.turovich@nokia.com>
Wed, 06 Oct 2010 14:30:50 -0500
changeset 2136 f0b706fa897d
parent 2131 ff0156b93599
child 2137 0a2167a80b64
permissions -rw-r--r--
all instances of PLUGINS_ROOT preceded by any path had the path removed (incorrect syntax)
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" />
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
     7
 
<title>Executables view</title>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
     8
 
<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 
     9
 
</head>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    10
 
<body >
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    11
 
<h2>Executables view </h2>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    12
 
<p>  The <b>Executables</b> view provides a dynamic list of executables and their related source files. The Executables view makes it easy to:</p>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    13
 
<ul>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    14
 
  <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 
    15
 
  <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 
    16
 
  <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 
    17
 
  <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 
    18
 
  <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 
    19
 
  <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 
    20
 
  <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 
    21
 
  <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 
    22
 
  <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 
    23
 
</ul>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    24
 
<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 
    25
 
<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 
    26
 
<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 
    27
 
<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 
    28
 
<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 
    29
 
<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 
    30
 
<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 
    31
 
  <tr>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    32
 
    <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 
    33
 
    <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 
    34
 
  </tr>
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
 
    <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 
    37
 
    <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 
    38
 
      <ul>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    39
 
        <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 
    40
 
        <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 
    41
 
        <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 
    42
 
        <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 
    43
 
        <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 
    44
 
        <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 
    45
 
      </ul>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    46
 
      <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 
    47
 
  </tr>
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
 
    <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 
    50
 
    <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 
    51
 
      <ul>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    52
 
        <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 
    53
 
        <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 
    54
 
        <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 
    55
 
        <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 
    56
 
        <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 
    57
 
        <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 
    58
 
      </ul>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    59
 
      <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 
    60
 
      <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 
    61
 
  </tr>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    62
 
</table>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    63
 
<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 
    64
 
<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 
    65
 
<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 
    66
 
<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 
    67
 
  <tr>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    68
 
      <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 
    69
 
      <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 
    70
 
      <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 
    71
 
  </tr>
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
 
      <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 
    74
 
      <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 
    75
 
      <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 
    76
 
    </tr>
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
 
      <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 
    79
 
      <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 
    80
 
      <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 
    81
 
    </tr>
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
 
      <td><center>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    84
 
        <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 
    85
 
      </center>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    86
 
      </td>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    87
 
      <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 
    88
 
      <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 
    89
 
    </tr>
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
 
      <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 
    92
 
      <td>Columns</td>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    93
 
      <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 
    94
 
    </tr>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    95
 
</table>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    96
 
<h5>Other references</h5>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    97
 
<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 
    98
 
  <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 
    99
 
  <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 
   100
 
  <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 
   101
 
</ul>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
   102
 
<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 
   103
 












ff0156b93599
moved inf, mmp, remote conn, and views to project folder



fturovic <frank.turovich@nokia.com>


parents: 

diff
changeset




   104


</body>













ff0156b93599
moved inf, mmp, remote conn, and views to project folder



fturovic <frank.turovich@nokia.com>


parents: 

diff
changeset




   105


</html>















FCL/sftools/dev/ide/carbidecpp